LevelDC

A comprehensive Discord integration plugin for Minecraft servers that seamlessly connects your Discord community with your Minecraft server. Link player accounts, sync ranks, bridge chat, and more!

✨ Features

🔗 Account Linking

• Easy Linking Process: Players can link their Discord and Minecraft accounts with a simple command
• Secure Code System: Time-limited verification codes (5 minutes) ensure security
• Link Rewards: Automatically reward players for linking their accounts
• Link Reminders: Configurable reminders for unlinked players

👑 Rank Synchronization

• LuckPerms Integration: Automatically sync Minecraft ranks to Discord roles
• Bidirectional Sync: Keeps Discord roles in sync with player ranks
• Custom Mapping: Fully configurable rank-to-role mapping
• Linked Role: Assign a special role to all linked players

🎭 Nickname Sync

• Auto-Update: Discord nicknames automatically match Minecraft usernames
• Real-time: Updates when players join or change their name

💬 Chat Bridge

• Minecraft → Discord: Send in-game chat to a Discord channel
• Formatted Messages: Customizable message formatting
• Smart Filtering: Ignore staff chat and other special channels

🚀 Server Booster Rewards

• Auto-Detection: Automatically detect Discord server boosters
• Group Assignment: Give boosters special in-game perks via LuckPerms
• Real-time Sync: Instantly add/remove perks when boost status changes

📊 Stats Commands

• Discord Integration: View Minecraft stats directly in Discord
• PlaceholderAPI Support: Display any statistic with PlaceholderAPI
• Beautiful Embeds: Stats displayed in clean, formatted embeds

🛠️ Admin Tools

• Force Link/Unlink: Administrators can manually manage player links
• Player Info: View detailed linking information
• Debug Mode: Built-in debugging tools for troubleshooting
• Reload Command: Hot-reload configuration without restarting

📋 Requirements

• Minecraft Server: Purpur/Paper/Spigot 1.21.4+ (or any fork)
• Java: Java 21 or higher
• Discord Bot: A Discord bot token (see setup guide)

Optional Dependencies

• LuckPerms - Required for rank synchronization
• PlaceholderAPI - Required for stats feature

🚀 Installation

1. Download the latest version of LevelDC from Modrinth
2. Place the JAR file in your server's plugins folder
3. Start your server to generate the default configuration
4. Configure the plugin (see Configuration section)
5. Restart your server

⚙️ Configuration

Discord Bot Setup

1. Create a Discord Application:

   • Go to Discord Developer Portal
   • Click "New Application" and give it a name
   • Go to the "Bot" tab and click "Add Bot"
   • Copy the bot token

2. Configure Bot Permissions:

   • Enable the following Privileged Gateway Intents:
     • GUILD_MEMBERS
     • MESSAGE_CONTENT
   • Generate an invite URL with these permissions:
     • Manage Roles
     • Manage Nicknames
     • Send Messages
     • Embed Links
     • Read Message History
     • Use Slash Commands

3. Invite the Bot to your Discord server using the generated URL