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
🚀 Installation
- Download the latest version of LevelDC from Modrinth
- Place the JAR file in your server's
plugins folder
- Start your server to generate the default configuration
- Configure the plugin (see Configuration section)
- Restart your server
⚙️ Configuration
Discord Bot Setup
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
Configure Bot Permissions:
- Enable the following Privileged Gateway Intents:
GUILD_MEMBERSMESSAGE_CONTENT
- Generate an invite URL with these permissions:
- Manage Roles
- Manage Nicknames
- Send Messages
- Embed Links
- Read Message History
- Use Slash Commands
Invite the Bot to your Discord server using the generated URL
