XDiscordUltimate

# XDiscordUltimate The most comprehensive Discord integration plugin for Minecraft servers. Features modern slash commands, chat bridge, verification system, tickets, moderation, and much more. !(https://img.shields.io/badge/version-1.2.0-blue) !(https://img.shields.io/badge/minecraft-1.16.5+-green) !(https://img.shields.io/badge/java-17+-orange) !(https://img.shields.io/badge/discord-JDA_5.0-7289da) !(https://img.shields.io/badge/license-MIT-purple) ## What's New in 1.2.0 - **`/unlink` command** — players can unlink their Discord account; admins can unlink anyone via `/xdiscord unlink <player>` (removes Discord role, LuckPerms group, and DB link). - **Hardened verification codes** — `SecureRandom` generation, configurable failed-attempt cooldown + max-attempts lockout, and consistent code expiry (the `code-expiry-minutes` config is now honored exactly). - **Fixed config/code default mismatches** — `one-time-only`, `kick-after-minutes`, and `verify-cooldown-seconds` now align with `config.yml`. - **Fixed a `ConcurrentModificationException`** in the message/localization system that could throw on a player's first localized message. - **Discord nickname re-sync** — linked members' stored Discord name stays fresh when they change their nickname. ## Features - **Chat Bridge** - Seamless chat sync between Minecraft and Discord - **Verification System** - Secure account linking with verification codes, self/admin unlink, brute-force lockout, and Discord nickname sync - **Support Tickets** - Full ticket system with Discord integration - **Player Stats** - Track and display player statistics - **Server Status** - Auto-updating status embed in Discord - **Moderation** - Ban sync, chat filtering, and report system - **Admin Console** - Execute server commands from Discord - **Announcements** - Broadcast to both Discord and Minecraft - **Booster Perks** - Reward Discord server boosters - **Admin Alerts** - Server health monitoring - **Server Logging** - Log all events to Discord ## Quick Start 1. Download the latest release 2. Place in your `plugins` folder 3. Start server to generate config 4. Configure `config.yml` with your bot token and guild ID 5. Restart server ```yaml discord: bot-token: "YOUR_BOT_TOKEN" guild-id: "YOUR_GUILD_ID" channels: chat: "CHANNEL_ID" logs: "CHANNEL_ID" ``` ## Documentation ### Getting Started **New to XDiscordUltimate?** Start here: | Guide | Description | |-------|-------------| | (docs/GETTING-STARTED.md) | Step-by-step setup from scratch | | (docs/INSTALLATION.md) | Quick installation reference | ### Core Documentation | Document | Description | |----------|-------------| | (docs/INSTALLATION.md) | Complete setup instructions | | (docs/CONFIGURATION.md) | All configuration options | | (docs/COMMANDS.md) | All commands and permissions | | (docs/FEATURES.md) | Detailed feature explanations | | (docs/PERMISSIONS.md) | All permission nodes | | (docs/TROUBLESHOOTING.md) | Common issues and solutions | | (docs/MESSAGES.md) | Customize all messages | | (docs/API.md) | API for developers | | (docs/DATABASE.md) | Database schema and configuration | ### Module Documentation | Module | Description | |--------|-------------| | (https://docs.xreatlabs.space) | Minecraft-Discord chat sync | | (docs/modules/VERIFICATION.md) | Account linking system | | (docs/modules/SERVER-LOGGING.md) | Event logging to Discord | | (docs/modules/ADMIN-ALERTS.md) | Server health monitoring | | (docs/modules/TICKETS.md) | Support ticket system | | (docs/modules/MODERATION.md) | Ban sync, filter, reports | | (docs/modules/SERVER-CONTROL.md) | Remote server management | | (docs/modules/PLAYER-STATS.md) | Statistics tracking | | (docs/modules/SERVER-STATUS.md) | Auto-updating status embed | | (docs/modules/BOOSTER-PERKS.md) | Discord booster rewards | | (docs/modules/BOT-CONSOLE.md) | Discord console access | | (docs/modules/ANNOUNCEMENTS.md) | Cross-platform broadcasts | | (docs/modules/MODULE-MANAGER.md) | Managing modules | ## Commands ### Player Commands | Command | Description | |---------|-------------| | `/verify <code>` | Link your Discord account | | `/unlink` | Unlink your Discord account | | `/support <message>` | Create a support ticket | | `/report <player> <reason>` | Report a player | | `/stats ` | View player statistics | | `/help` | Open help menu | ### Admin Commands | Command | Description | |---------|-------------| | `/xdiscord reload` | Reload configuration | | `/xdiscord status` | Show plugin status | | `/xdiscord m