Minecraft plugin EssentialsDiscordLink

🔌 About EssentialsX Discord Link

EssentialsX Discord Link is an addon module for EssentialsX Discord that provides account linking and synchronization between Minecraft accounts and Discord roles. It is designed to extend EssentialsX's Discord integration with features focused on linking user identities and mapping Vault groups to Discord roles (and vice versa).

🎯 Purpose

Provide a simple, maintainable way to let players link their Minecraft and Discord accounts and to keep server group membership and Discord roles synchronized. It also supports restricting unlinked players from joining or interacting until they complete linking.

⚙️ Features

• Vault group -> Discord role synchronization (map Vault group names to Discord role IDs).
• Discord role -> Vault group synchronization (assign Vault groups based on Discord role IDs).
• Prevent unlinked players from joining the server.
• Prevent unlinked players from moving or sending chat messages until they link.
• In-game account linking flow that issues a short code for use in Discord.
• A small developer API to check link status, link/unlink players, and obtain linked data.

🧩 Who It Is For

• Servers using EssentialsX and the EssentialsX Discord module that need Discord account linking.
• Servers that use Vault groups and want those groups reflected as Discord roles (or vice versa).
• Survival, SMP, and community servers that require verified Discord membership or role-sync.

🏗️ Example Use Cases

• Automatically grant a Vault-based donator group when a player has a matching Discord role.
• Block unlinked players from chatting or moving until they confirm their Discord account via the in-game link code.
• Use a backend plugin or script to query whether a player is linked via the provided API.

⌨️ Commands

⚙️ Installation

📥 Setup

• Download the official EssentialsX Discord Link jar and place it in your server plugins/ directory.
• Start the server to generate the plugin folder and default configuration.
• Edit the plugin configuration at plugins/EssentialsDiscordLink/config.yml to define groups (Vault group -> Discord role ID) and roles (Discord role ID -> Vault group).
• After saving configuration, run the EssentialsX console reload command (for example ess reload) or restart the server to apply role-sync settings.

📦 Dependencies

• EssentialsX (core) — required (module is an addon to EssentialsX Discord).
• EssentialsX Discord — required (this addon extends that module).
• Vault — used for Vault group ↔ Discord role mappings (referenced in role-sync features).

🧠 Technical Notes

• The plugin exposes a small developer API (service) that lets other plugins check whether a player is linked, link/unlink players programmatically, and fetch linked data.
• Configuration uses plugins/EssentialsDiscordLink/config.yml for mappings between Vault groups and Discord role IDs.

🤝 When This Plugin Is Useful

If your server already uses EssentialsX and you need players to verify or link their Discord accounts (and/or keep Vault groups and Discord roles synchronized), EssentialsX Discord Link provides a direct, documented integration that works within the EssentialsX module ecosystem.