How to Set Up DiscordSRV

DiscordSRV is the standard plugin for two-way Discord integration on Minecraft servers , chat, console, account linking, role sync. This guide gets you a working bridge in 10 minutes.

1. Create the bot

1. Go to Discord Developer Portal and create an application.
2. "Bot" tab , "Add Bot". Copy the token.
3. Enable Privileged Gateway Intents: Server Members, Message Content.
4. OAuth2 , URL Generator , scopes: bot, permissions: Manage Roles, Manage Channels, Read/Send Messages, Manage Webhooks, Read Message History.
5. Open the generated URL, invite to your server.

2. Install

Drop DiscordSRV.jar into plugins/ and restart. The plugin generates plugins/DiscordSRV/config.yml.

3. Configure the bot token

Open config.yml:

BotToken: "PASTE_YOUR_TOKEN_HERE"

Restart. Run /discord in-game , you should get a link.

4. Link channels

Find your global channel ID in Discord (enable Developer Mode in Discord settings, then right-click the channel and "Copy ID"):

Channels: {global: "1234567890"}

Save and reload with /discord reload.

5. Account linking

Players DM the bot link <code> after running /discord link in-game. Once linked, you can sync roles to permissions groups (next section).

6. Group sync (Discord role ↔ LuckPerms group)

In config.yml:

GroupRoleSynchronizationGroupsAndRolesToSync:
  vip: "111222333444555666"
  donor: "222333444555666777"

Now anyone with the Discord role VIP automatically gets the LuckPerms group vip , and vice versa.

7. Console relay

Add a private staff channel for console output and command input:

DiscordConsoleChannelId: "999888777666555444"

Restrict its visibility to staff only in Discord. Anyone with access there can run server commands.

8. Common pitfalls

• Bot can't see message content , you forgot the Message Content intent in the Dev Portal.
• Group sync not firing , LuckPerms must be installed and the bot must have a higher role than the synced roles.
• Webhooks failing , make sure "Manage Webhooks" is granted on the channel.

Want to see all this in action? Astroworld MC runs a custom-built economy survival server with custom bosses, eternal enchants, crates and an auction house. Join at astroworldmc.com , IP play.astroworldmc.com, Java + Bedrock crossplay.