✨ Features

🔗 Bidirectional Chat Sync

Messages sent in-game appear on Discord, and Discord messages appear in Minecraft — instantly, with full username and prefix formatting.

🛡️ Full Sanctions Management

Bans, temporary bans, and mutes are synchronized across both platforms in real time. Unban and unmute operations are automatically propagated.

✅ Discord Verification System

Link your players' Minecraft accounts to their Discord identities with a secure 6-digit code system. Codes expire after 5 minutes. Unverified players can optionally be kicked.

🔐 LuckPerms Integration

Full support for LuckPerms permission groups — control who can ban, mute, and manage players directly from Discord or in-game.

💾 Database Persistence (MariaDB / MySQL)

All data (players, bans, mutes, chat logs, verification codes) is stored in a MariaDB/MySQL database via a HikariCP connection pool for maximum reliability and performance.

🌐 Full i18n Support

NexusBridge ships with French and English translations out of the box. Adding new languages is as simple as dropping a new file.

📋 Requirements

| Requirement | Version |
| ---------------------- | -------- |
| Minecraft Java Edition | 1.21.1 |
| NeoForge | 21.1.77+ |
| Java | 21 (LTS) |
| MariaDB or MySQL | 8.0+ |
| Discord Bot Token | — |

⚠️ Server-side only. Players do not need to install anything on their client.

🚀 Installation

1. Download & install

Download the latest JAR and drop it into your server's mods/ folder.

2. Set up the database

mysql -u root -p < setup.sql

3. Start the server once

NexusBridge will generate its configuration file at:

config/nexusbridge/config.json

4. Configure

Fill in the required fields:

{
  "serverId": "your_server_id_here",
  "discord": {
    "token": "YOUR_BOT_TOKEN",
    "guildId": 123456789,
    "chatChannelId": 987654321,
    "verificationChannelId": 987654321,
    "logsChannelId": 987654321
  },
  "database": {
    "host": "localhost",
    "port": 3306,
    "database": "nexusbridge",
    "username": "root",
    "password": "password"
  },
  "verification": {
    "enabled": true,
    "kickUnverifiedPlayers": false
  },
  "language": "en"
}

5. Restart & enjoy 🎉

🎮 Commands

Minecraft

| Command | Description | Permission |
| ------------------------------------------ | -------------------------- | -------------------- |
| /nexus_ban <player> [reason] | Ban a player | nexusbridge.ban |
| /nexus_mute <player> [duration] [reason] | Mute a player | nexusbridge.mute |
| /nexus_unban <player> | Unban a player | nexusbridge.unban |
| /nexus_unmute <player> | Unmute a player | nexusbridge.unmute |
| /nexus_verify | Get your verification link | — |

Discord

| Command | Description | Role required |
| ----------------------- | --------------------------- | ------------- |
| /verify | Get a verification code | Everyone |
| /verify <code> | Link your Minecraft account | Everyone |
| /status | Show server status | Everyone |
| /ban <user> [reason] | Ban a Discord user | Admin |
| /mute <user> [reason] | Mute a Discord user | Moderator |

🗄️ Database Schema

NexusBridge automatically creates the following tables on first start:

| Table | Purpose |
| -------------------- | ---------------------------------------------- |
| players | UUID ↔ Discord ID mapping, verification status |
| bans | Ban history (Minecraft & Discord) |
| mutes | Mute history with duration support |
| chat_logs | Full chat history from both platforms |
| verification_codes | Active codes with expiration |

⚡ Performance

• Async operations — all database queries run off the main server thread
• HikariCP pool — up to 10 connections by default (configurable up to 20 for 100+ players)
• In-memory translation cache — zero I/O overhead after startup
• Built-in Discord rate limit handling via JDA 5.2.3

💶 Licensing

NexusBridge is proprietary software distributed under the NexusBridge Business License v1.0.

| | Personal use | Commercial use |
| --------------------- | ------------ | -------------- |
| Use on your server | ✅ | ✅ |
| Modify config files | ✅ | ✅ |
| Monetize your server | ✅ | ✅ |
| Redistribute the code | ❌ | ❌ |
| Resell the mod | ❌ | ❌ |
| Use without a license | ❌ | ❌ |

🆘 Support

• 🐛 Found a bug? Open an issue on GitHub
• 📖 Full documentation available on the repository wiki

Support is provided in French and English.

🗺️ Roadmap

• [ ] Web dashboard for server management
• [x] Discord webhooks for detailed logging