![\"Paper\"](\"https:\/\/raw.githubusercontent.com\/RedSavant\/Discord-link-assets\/refs\/heads\/v3\/assets\/cozy\/supported\/paper_vector.svg\")
<\/p>\n
\n<\/p>\n
\n
<\/p>\n
![\"Purpur\"](\"https:\/\/raw.githubusercontent.com\/RedSavant\/Discord-link-assets\/refs\/heads\/v3\/assets\/cozy\/supported\/purpur_vector.svg\")
<\/p>\n
![\"Discord\"](\"https:\/\/raw.githubusercontent.com\/RedSavant\/Discord-link-assets\/refs\/heads\/v3\/assets\/cozy\/available\/modrinth_vector.svg\")
<\/p>\n
![\"Discord\"](\"https:\/\/raw.githubusercontent.com\/RedSavant\/Discord-link-assets\/refs\/heads\/v3\/assets\/cozy\/social\/discord-singular_vector.svg\")
<\/p>\n
—
\n
\n
\n# \u26d3\ufe0f\u200d\ud83d\udca5 DiscordLink \u26d3\ufe0f\u200d\ud83d\udca5 (entire in french)
\n**Connect your Minecraft server to Discord with advanced account linking and role management**<\/p>\n
## Features<\/p>\n
### Account Linking System
\n– **Automatic code generation**: Players receive a unique 6-character code when trying to connect
\n– **Discord slash commands**: Simple `\/link` command on Discord to complete the linking process
\n– **Secure verification**: Codes expire after 5 minutes for enhanced security
\n– **Mandatory linking**: Option to require Discord linking before joining the server
\n– **Bypass system**: Configure players or permissions that can skip the linking requirement<\/p>\n
<\/p>\n
### Discord Bot Integration
\n– **Automatic role management**: Assign roles when accounts are linked
\n– **Online status roles**: Grant roles to players currently connected to the server
\n– **Slash commands**: Modern Discord slash command interface
\n– **Full customization**: Configure all bot behaviors in the config file<\/p>\n
\n<\/p>\n
### Advanced Logging
\n– **Connection logs**: Track player joins with IP, UUID, username, and timestamp
\n– **Disconnection logs**: Monitor when players leave the server
\n– **Link events**: Log all account linking activities
\n– **Unlink events**: Track account unlinking operations
\n– **Custom embeds**: Fully customizable Discord embed colors and formatting<\/p>\n
<\/p>\n
### Player Management
\n– **In-game commands**: `\/link`, `\/unlink`, `\/linkinfo` for players
\n– **Admin commands**: `\/forceunlink`, `\/discordlink reload` for administrators
\n– **Database storage**: SQLite database for reliable data persistence
\n– **Auto-cleanup**: Expired codes are automatically removed<\/p>\n
—<\/p>\n
## Commands & Permissions<\/p>\n
### Player Commands
\n| Command | Description | Permission |
\n|———|————-|————|
\n| `\/link` | Generate a linking code | Default |
\n| `\/unlink` | Unlink your Discord account | `discordlink.unlink` |
\n| `\/linkinfo [player]` | View linking information | `discordlink.info` |<\/p>\n
### Admin Commands ### Aliases —<\/p>\n ## How It Works<\/p>\n ### For New Players ### For Linked Players ### Role System —<\/p>\n ## Configuration<\/p>\n The plugin is fully configurable through `config.yml`:<\/p>\n ### Discord Settings ### Role Management ### Logging System ### Link Requirements ### Link Command Settings ### Messages —<\/p>\n ## Setup Guide<\/p>\n ### Prerequisites ### Discord Bot Setup ### Plugin Installation ### Getting IDs —<\/p>\n ## Database<\/p>\n DiscordLink uses **SQLite** for data storage: —<\/p>\n ## Use Cases<\/p>\n ### Community Servers ### Whitelisted Servers ### Network Servers ### Event Servers —<\/p>\n ## Requirements<\/p>\n – **Minecraft**: 1.21.4+ (Paper\/Purpur) —<\/p>\n ## Support<\/p>\n Found a bug? Have a suggestion? —<\/p>\n **Made for the Minecraft community**<\/p>\n *Connecting players across platforms*<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":" The most complete discord linking plugin.
\n| Command | Description | Permission |
\n|———|————-|————|
\n| `\/forceunlink
\n| `\/discordlink reload` | Reload plugin configuration | `discordlink.admin` |<\/p>\n
\n– `\/dl` \u2192 `\/discordlink`<\/p>\n
\n1. Player attempts to connect to the server
\n2. If not linked, they are kicked with a unique code displayed
\n3. Player joins your Discord server
\n4. Player uses `\/link code:XXXXXX` on Discord
\n5. Account is linked and player can now join the server
\n6. Configured roles are automatically assigned<\/p>\n
\n1. Player connects to the server normally
\n2. “Online” role is automatically added on Discord
\n3. “Online” role is removed when player disconnects
\n4. Player keeps their “Linked” role permanently<\/p>\n
\n– **Linked Role**: Given when account is successfully linked (permanent)
\n– **Online Role**: Given when player is connected to the server (temporary)
\n– **Automatic management**: All roles are handled automatically by the bot<\/p>\n
\n– Bot token configuration
\n– Guild (server) ID
\n– Enable\/disable bot features<\/p>\n
\n– Configure linked account role ID
\n– Configure online player role ID
\n– Toggle automatic role assignment
\n– Control role removal on disconnect<\/p>\n
\n– Enable\/disable specific log types
\n– Configure log channel ID
\n– Customize embed colors (join, quit, link, unlink)
\n– Toggle individual log events<\/p>\n
\n– Enable\/disable mandatory linking
\n– Customize kick message with code display
\n– Configure bypass list (players\/UUIDs)
\n– Bypass permission support<\/p>\n
\n– Code expiration time (default: 5 minutes)
\n– Code length (default: 6 characters)
\n– Custom messages and formatting<\/p>\n
\n– Fully customizable plugin messages
\n– Color code support
\n– Configurable prefix
\n– Multi-language friendly<\/p>\n
\n– A Discord bot (create one at https:\/\/discord.com\/developers\/applications)
\n– Bot token
\n– Server (Guild) ID
\n– Role IDs for linked\/online roles
\n– Channel ID for logs<\/p>\n
\n1. Create a bot on Discord Developer Portal
\n2. Enable these **Privileged Gateway Intents**:
\n – Server Members Intent
\n – Message Content Intent
\n3. Invite the bot to your Discord server with these permissions:
\n – Manage Roles
\n – Send Messages
\n – Embed Links
\n4. Copy your bot token<\/p>\n
\n1. Download DiscordLink and place it in your `plugins\/` folder
\n2. Start your server to generate the config file
\n3. Stop your server and edit `plugins\/DiscordLink\/config.yml`
\n4. Fill in your Discord bot token, guild ID, role IDs, and channel ID
\n5. Configure your desired settings
\n6. Start your server<\/p>\n
\n– **Guild ID**: Enable Developer Mode in Discord, right-click your server \u2192 Copy Server ID
\n– **Role IDs**: Right-click a role \u2192 Copy Role ID
\n– **Channel ID**: Right-click a channel \u2192 Copy Channel ID<\/p>\n
\n– No external database server required
\n– Automatic database creation and management
\n– Stores player UUIDs, usernames, Discord IDs, and link timestamps
\n– File location: `plugins\/DiscordLink\/links.db`<\/p>\n
\n– Verify players are part of your Discord community
\n– Easy player identification between platforms
\n– Enhanced moderation capabilities<\/p>\n
\n– Replace traditional whitelist with Discord linking
\n– Automatic access control
\n– Easy member management<\/p>\n
\n– Unified account system across multiple servers
\n– Share linked accounts via shared database (future feature)
\n– Centralized player management<\/p>\n
\n– Require Discord linking for special events
\n– Track attendance via Discord roles
\n– Enhanced communication with participants<\/p>\n
\n– **Java**: 21+
\n– **Dependencies**: None (JDA included)<\/p>\n
\n– Open an issue on GitHub
\n– Join our Discord community
\n– Star the project if you find it useful<\/p>\n\n
\nLink players’s Minecraft account with they Discord Account.
\nA bot hosted in the plugin
\nFully customizable, you can force the player to link to join the server.
\nCustom Logs of linking in a discord channel.<\/p>\n","protected":false},"featured_media":57334,"template":"","meta":{"_minecraft_slug":"discord-link","_minecraft_project_id":"2RbnHQFK","_minecraft_author":"RedSavant","_minecraft_license":"MIT","_minecraft_downloads":309,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"discord-link.zip","_minecraft_size_bytes":47111963,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T11:41:46.831658Z","_minecraft_date_created":"2025-10-27T06:48:30.937985Z","_minecraft_date_modified":"2026-01-30T20:12:59.593374Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/discord-link","_minecraft_icon_attachment_id":57334,"_minecraft_imported_at":"2026-06-03T03:48:04+00:00","_minecraft_import_hash":"5710ceb17b4c7b4a5f084877d82af630","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,90,127,128,123,92],"mod_loader":[132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-57333","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-technology","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n