Plugins · 8 min read

How to Set Up DiscordSRV

Connect your Minecraft server to Discord with DiscordSRV, bot setup, channel linking, account linking, console relay and tips.

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

Go to Discord Developer Portal and create an application.
"Bot" tab , "Add Bot". Copy the token.
Enable Privileged Gateway Intents: Server Members, Message Content.
OAuth2 , URL Generator , scopes: bot, permissions: Manage Roles, Manage Channels, Read/Send Messages, Manage Webhooks, Read Message History.
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.