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:

Guide	Description
Getting Started Guide	Step-by-step setup from scratch
Installation Guide	Quick installation reference

Core Documentation

Document	Description
Installation Guide	Complete setup instructions
Configuration Guide	All configuration options
Commands Reference	All commands and permissions
Features Guide	Detailed feature explanations
Permissions Reference	All permission nodes
Troubleshooting	Common issues and solutions
Messages Configuration	Customize all messages
Developer API	API for developers
Database Reference	Database schema and configuration

Module Documentation

Module	Description
Chat Bridge	Minecraft-Discord chat sync
Verification	Account linking system
Server Logging	Event logging to Discord
Admin Alerts	Server health monitoring
Tickets	Support ticket system
Moderation	Ban sync, filter, reports
Server Control	Remote server management
Player Stats	Statistics tracking
Server Status	Auto-updating status embed
Booster Perks	Discord booster rewards
Bot Console	Discord console access
Announcements	Cross-platform broadcasts
Module Manager	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 [player]	View player statistics
/help	Open help menu

Admin Commands

Command	Description
/xdiscord reload	Reload configuration
/xdiscord status	Show plugin status
/xdiscord modules	List all modules
/xdiscord unlink <player>	Unlink a player from Discord
/announce <message>	Make an announcement

Discord Slash Commands

Command	Description
/verify	Get verification code
/status	Show server status
/players	List online players
/stats [player]	View player statistics
/console <command>	Execute server command

Permissions

Permission	Description	Default
xdiscord.verify	Use verification	true
xdiscord.unlink	Unlink own account	true
xdiscord.support	Create tickets	true
xdiscord.report	Report players	true
xdiscord.admin	Admin commands	op
xdiscord.console	Console access	false
xdiscord.announce	Make announcements	op
xdiscord.bypass.verification	Bypass verification	false
xdiscord.bypass.filter	Bypass chat filter	false

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