About Discord Role Sync
From SpigotMCA Minecraft plugin for syncing Discord roles to Minecraft permission groups and whitelist
Discord Role Sync
DiscordRoleSync is a Minecraft plugin for syncing Discord roles and Minecraft permissions. This syncs Discord to Minecraft only, it is not both ways.
A list of managed Discord roles can be configured and linked o Minecraft groups. If a Discord user gets a role added, they will get added to the Minecraft group. If the user gets the role removed, they will be removed from the Minecraft group.
This can use both SQLite (automatically created, no setup needed) or MySQL. MySQL is recommended for stability on large servers.
This plugin has been tested on Minecraft versions 1.8.8 to 1.21.
Features
Some features are optional and can be opted in or out from the config file.
- Sync roles from Discord to Minecraft groups. Users will be added/removed from Minecraft groups based on the Discord roles they have
- Add a Discord role to users that have been linked
- Control who can access your server (whitelist) using a Discord role
- Update user's Discord nicknames based on their Minecraft username
- Integration with PlaceholderAPI
You should first install Vault as this plugin will not work without it. You should also install a permissions plugin such as LuckPerms or another alternative compatible with Vault.
This plugin targets Java 11, however it has been reported working with Java 8. No support is provided with Java versions below 11.
Just copy the .jar to the plugins folder and run the server once to generate the config files. The plugin will error out due to no config, but that's expected on the first run. Go to the config.yml file and add your Discord bot token. To get one:
- Go to https://discord.com/developers/applications
- Click "new application" and put a name for your bot
- In the left sidebar, click "Bot"
- Click "add bot" and confirm
- In this page, you can change your bot's picture and username.
- Turn on "Server Members Intent" - it won't work without this as the bot needs to work with the member list
- Click copy token and paste it in the config file. Anyone with your token can log in as your bot, so you should keep it secret as if it were a password.
- Go back to the Discord developer website and on the left sidebar, click "OAuth2"
- Select "bot" as a scope then copy the link
- Go to the link you just copied to add the bot to your server
How it Works
It's pretty simple: all your users should use the /link command in Discord to link their Minecraft account:
/link myMCusername
As soon as they do this, their roles will keep synchronized while they are in the server. When your users get the Discord role, they will automatically get the permission plugin group. Updates are instant.
Staff can also use the /admlink command to force link a user:
/admlink discordID mcUsername
The Discord ID of the user is a 17 to 20-digit number.
The /info and /unlink commands are available for staff use. Both accept Discord IDs or Minecraft usernames. By default, these three admin commands are available for everyone that has the MANAGE ROLES Discord permission. This can be modified in your Discord server.
The users need to remain in the Discord server to keep their roles. If they leave the server or are unlinked with the /unlink command, they are removed from the whitelist and every role is removed from them.
If verification is enabled ( requireVerification: true on the config), users will either get the code when they are kicked by whitelist (if whitelist management is enabled) or by typing /drs verify in the Minecraft chat. This code then needs to be sent in Discord using /verify <code>.
Languages and Translation
Currently, the languages supported (and bundled with the plugin) are:
- English (en_US)
- Portuguese (pt_BR)
- Italian (it_IT)
- French (fr_FR)
- Spanish (es_ES)
- Turkish (tr_TR)
- German (de_DE)
- Japanese (ja_JP)
- Russian (ru_RU)
As updates to this plugin are released, only English and Portuguese are updated (as those are the languages I speak). Other languages might get out of date and will use English as a default. Please let me know if you'd like to help update these languages!
Permission Plugins
This plugin should work with every permission plugin that supports Vault.
Tested and confirmed working:
- LuckPerms (recommended)
- Ultra Permissions
Highlights
From source dataGame versions
Supports 15 Minecraft versions, the newest being 1.21.
Loaders
Runs on Spigot and Paper.
Footprint
Rated a light load on a server.
Discord Role Sync on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Minecraft servers, for Paper servers. We download it from SpigotMC, place it, and restart the server.
- Server side
- Required on the server
- Server type needed
- Spigot, Paper
- Server load
- light
- Smallest plan we suggest
- Minecraft — 1.5 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 2.3.3, released 2025-07-10
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| Paper | 1.8 to 1.21 (15 versions) | 1.21 |
| Spigot | 1.8 to 1.21 (15 versions) | 1.21 |
From 10 recorded builds of Discord Role Sync.
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| 2.3.3 | 2025-07-10 | 1.8 to 1.21 (15 versions) | Spigot, Paper |
| 2.3.2 | 2025-04-22 | n/a | Spigot, Paper |
| 2.3.1 | 2025-04-22 | n/a | Spigot, Paper |
| 2.3.0 | 2024-12-27 | n/a | Spigot, Paper |
| 2.2.4 | 2024-12-12 | n/a | Spigot, Paper |
| 2.2.3 | 2024-12-12 | n/a | Spigot, Paper |
Run Discord Role Sync on a Minecraft server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogAdmin & protection
Permissions, moderation, anti-cheat and land protection for the people running the server.
Runs on your server
From source side supportSpigotMC lists Discord Role Sync as required on the server. Check its SpigotMC page to see whether players need it too.
Compatibility
- Game
- Minecraft
- Loaders
- SpigotPaper
- Runs on
- Serverrequired on the server
- Game versions
- 1.21 and 14 earlier
- Requires
- One-click install needs a Paper server.
Verified at the source
- ✓SpigotMCOfficial listing, checked 2026-10-16Open ↗
- ✓AuthorNichoGX, as published on SpigotMC
- ✓LicenseNot published by the sourceFree










