Discord-Link

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

• --
• !(https://img.shields.io/badge/license-MIT-green?logo=github)
• !(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

[!(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

!(https://cdn.modrinth.com/data/2RbnHQFK/images/3e82a79f56f8b736397e63e01eaa083cec4368f7.png) !(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

!(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 ` | 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