![First](https://raw.githubusercontent.com/RedSavant/Discord-link-assets-/refs/heads/v3/modrinth/discordbanner.png)

--- ![License](https://img.shields.io/badge/license-MIT-green?logo=github) ![Version](https://img.shields.io/badge/version-1.0.1-lime) # ⛓️‍💥 DiscordLink ⛓️‍💥 (entire in french) **Connect your Minecraft server to Discord with advanced account linking and role management** ## Features ### Account Linking System - **Automatic code generation**: Players receive a unique 6-character code when trying to connect - **Discord slash commands**: Simple `/link` command on Discord to complete the linking process - **Secure verification**: Codes expire after 5 minutes for enhanced security - **Mandatory linking**: Option to require Discord linking before joining the server - **Bypass system**: Configure players or permissions that can skip the linking requirement [![Kick](https://cdn.modrinth.com/data/2RbnHQFK/images/f74980cb6e354444f7ad391aec78d3cde20a5e99_350.webp)](https://modrinth.com/plugin/discord-link/gallery) ### Discord Bot Integration - **Automatic role management**: Assign roles when accounts are linked - **Online status roles**: Grant roles to players currently connected to the server - **Slash commands**: Modern Discord slash command interface - **Full customization**: Configure all bot behaviors in the config file ![Link](https://cdn.modrinth.com/data/2RbnHQFK/images/3e82a79f56f8b736397e63e01eaa083cec4368f7.png) ![ExampleBot](https://cdn.modrinth.com/data/2RbnHQFK/images/99c4568b4671cbbabd81b8db0b0caf324e8bd6c1.png) ### Advanced Logging - **Connection logs**: Track player joins with IP, UUID, username, and timestamp - **Disconnection logs**: Monitor when players leave the server - **Link events**: Log all account linking activities - **Unlink events**: Track account unlinking operations - **Custom embeds**: Fully customizable Discord embed colors and formatting ![Logs](https://cdn.modrinth.com/data/2RbnHQFK/images/1337cd53a6fd0b333833376f44cb76f7db1a735b_350.webp) ### Player Management - **In-game commands**: `/link`, `/unlink`, `/linkinfo` for players - **Admin commands**: `/forceunlink`, `/discordlink reload` for administrators - **Database storage**: SQLite database for reliable data persistence - **Auto-cleanup**: Expired codes are automatically removed --- ## Commands & Permissions ### Player Commands | Command | Description | Permission | |---------|-------------|------------| | `/link` | Generate a linking code | Default | | `/unlink` | Unlink your Discord account | `discordlink.unlink` | | `/linkinfo [player]` | View linking information | `discordlink.info` | ### Admin Commands | Command | Description | Permission | |---------|-------------|------------| | `/forceunlink ` | Force unlink a player's account | `discordlink.admin` | | `/discordlink reload` | Reload plugin configuration | `discordlink.admin` | ### Aliases - `/dl` → `/discordlink` --- ## How It Works ### For New Players 1. Player attempts to connect to the server 2. If not linked, they are kicked with a unique code displayed 3. Player joins your Discord server 4. Player uses `/link code:XXXXXX` on Discord 5. Account is linked and player can now join the server 6. Configured roles are automatically assigned ### For Linked Players 1. Player connects to the server normally 2. "Online" role is automatically added on Discord 3. "Online" role is removed when player disconnects 4. Player keeps their "Linked" role permanently ### Role System - **Linked Role**: Given when account is successfully linked (permanent) - **Online Role**: Given when player is connected to the server (temporary) - **Automatic management**: All roles are handled automatically by the bot --- ## Configuration The plugin is fully configurable through `config.yml`: ### Discord Settings - Bot token configuration - Guild (server) ID - Enable/disable bot features ### Role Management - Configure linked account role ID - Configure online player role ID - Toggle automatic role assignment - Control role removal on disconnect ### Logging System - Enable/disable specific log types - Configure log channel ID - Customize embed colors (join, quit, link, unlink) - Toggle individual log events ### Link Requirements - Enable/disable mandatory linking - Customize kick message with code display - Configure bypass list (players/UUIDs) - Bypass permission support ### Link Command Settings - Code expiration time (default: 5 minutes) - Code length (default: 6 characters) - Custom messages and formatting ### Messages - Fully customizable plugin messages - Color code support - Configurable prefix - Multi-language friendly --- ## Setup Guide ### Prerequisites - A Discord bot (create one at https://discord.com/developers/applications) - Bot token - Server (Guild) ID - Role IDs for linked/online roles - Channel ID for logs ### Discord Bot Setup 1. Create a bot on Discord Developer Portal 2. Enable these **Privileged Gateway Intents**: - Server Members Intent - Message Content Intent 3. Invite the bot to your Discord server with these permissions: - Manage Roles - Send Messages - Embed Links 4. Copy your bot token ### Plugin Installation 1. Download DiscordLink and place it in your `plugins/` folder 2. Start your server to generate the config file 3. Stop your server and edit `plugins/DiscordLink/config.yml` 4. Fill in your Discord bot token, guild ID, role IDs, and channel ID 5. Configure your desired settings 6. Start your server ### Getting IDs - **Guild ID**: Enable Developer Mode in Discord, right-click your server → Copy Server ID - **Role IDs**: Right-click a role → Copy Role ID - **Channel ID**: Right-click a channel → Copy Channel ID --- ## Database DiscordLink uses **SQLite** for data storage: - No external database server required - Automatic database creation and management - Stores player UUIDs, usernames, Discord IDs, and link timestamps - File location: `plugins/DiscordLink/links.db` --- ## Use Cases ### Community Servers - Verify players are part of your Discord community - Easy player identification between platforms - Enhanced moderation capabilities ### Whitelisted Servers - Replace traditional whitelist with Discord linking - Automatic access control - Easy member management ### Network Servers - Unified account system across multiple servers - Share linked accounts via shared database (future feature) - Centralized player management ### Event Servers - Require Discord linking for special events - Track attendance via Discord roles - Enhanced communication with participants --- ## Requirements - **Minecraft**: 1.21.4+ (Paper/Purpur) - **Java**: 21+ - **Dependencies**: None (JDA included) --- ## Support Found a bug? Have a suggestion? - Open an issue on GitHub - Join our Discord community - Star the project if you find it useful ---

**Made for the Minecraft community** *Connecting players across platforms*

Discord-Link

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details

Banner

Example-Log-FR

Kick-Message-FR

Discord-Command

Example-Bot