LevelDiscord

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

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

👑 Rank Synchronization

- Linked Role: Automatically sync Minecraft ranks to Discord roles - Linked Role: Keeps Discord roles in sync with player ranks - Linked Role: Fully configurable rank-to-role mapping - Linked Role: Assign a special role to all linked players

🎭 Nickname Sync

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

💬 Chat Bridge

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

🚀 Server Booster Rewards

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

📊 Stats Commands

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

🛠️ Admin Tools

- Reload Command: Administrators can manually manage player links - Reload Command: View detailed linking information - Reload Command: Built-in debugging tools for troubleshooting - Reload Command: Hot-reload configuration without restarting

📋 Requirements

- Discord Bot: Purpur/Paper/Spigot 1.21.4+ (or any fork) - Discord Bot: 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. Restart the latest version of LevelDC from Modrinth 2. Restart the JAR file in your server's `plugins` folder 3. Restart your server to generate the default configuration 4. Restart the plugin (see Configuration section) 5. Restart your server

⚙️ Configuration

Discord Bot Setup

1. Create a Discord Application: - Go to Create a Discord Application - 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