XDiscordUltimate

The most comprehensive Discord integration plugin for Minecraft servers. Features modern slash commands, chat bridge, verification system, tickets, moderation, and much more.

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

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:

Core Documentation

Module Documentation

Commands

Player Commands

Admin Commands

Discord Slash Commands

Permissions

Requirements

• Minecraft Server: Spigot/Paper 1.16.5 – 1.21.x (latest)
• Java: 17 or higher
• Discord Bot: With MESSAGE_CONTENT intent enabled

Optional Dependencies

• LuckPerms - For permission groups
• PlaceholderAPI - For placeholders
• Vault - For economy (future)

Configuration Example

# Admin Discord IDs
adminIDs:
  - "123456789012345678"

# Enable features
features:
  chat-bridge:
    enabled: true
    chat-channel-id: "1234567890"
    minecraft-to-discord: true
    discord-to-minecraft: true
  
  verification:
    enabled: true
    verified-role: "Verified"
    code-expiry-minutes: 5
  
  server-logging:
    enabled: true
    logs-channel-id: "1234567890"
    log-join-leave: true
    log-commands: true
  
  tickets:
    enabled: true
    auto-close-hours: 48
    save-transcript: true
  
  player-stats:
    enabled: true
  
  server-status:
    enabled: true
    channel-id: "1234567890"
    update-interval: 60
  
  moderation:
    enabled: true
    sync-bans: true
    auto-moderate: true
  
  admin-alerts:
    enabled: true
    tps-threshold: 15.0
    ram-threshold: 90
  
  booster-perks:
    enabled: true
    permission-group: "booster"

# Discord settings
discord:
  bot-token: "YOUR_TOKEN"
  guild-id: "YOUR_GUILD_ID"
  channels:
    chat: ""
    logs: ""
    tickets: ""
    moderation: ""

# Database
database:
  type: "sqlite"

Support

• Issues: GitHub Issues
• Discord: Join our Discord

License

This project is licensed under the MIT License - see the LICENSE file for details.

Made with ❤️ by XreatLabs