Link your Minecraft chat to Discord

The chat bridge talks to Discord through a bot account that you create yourself. It takes five minutes.

1. Go to the Discord Developer Portal and create a New Application. Give it your server's name.
2. Open Bot in the menu. Switch on Message Content Intent and Server Members Intent; without them the bot cannot read chat.
3. Click Reset Token and copy the token. Treat it like a password: anyone with it controls your bot.
4. Open OAuth2, tick the scope bot, give it permission to read and send messages, and open the generated link to add the bot to your Discord.

On Paper, Purpur or Spigot, DiscordSRV is the standard bridge.

1. Install DiscordSRV from the catalog in the Plugins tab and restart once, so it creates its settings folder.
2. In Discord, switch on Developer Mode (User Settings, Advanced). Right click the channel for the chat and choose Copy Channel ID.
3. In Files, open plugins/DiscordSRV/config.yml.
4. Paste the token after BotToken, and put the channel ID in the Channels line, next to global.
5. Save and restart the server. The bot comes online in Discord and posts that the server started.

Chat typed in the game now shows in the channel, and messages in the channel show in the game. Players can link their Discord and Minecraft accounts with /discord link, which is useful if you want to give Discord roles to linked players.

DiscordSRV keeps its settings in a few files in plugins/DiscordSRV. Where to look for the extras people ask about:

Restart after each change, then test it with a second account or a friend before you tell everyone.

DiscordSRV is a plugin, so it does not run on Fabric, Forge or NeoForge. There the mod Discord Integration does the same job and supports all three loaders. The steps are alike: a bot token and a channel ID in its config file, found in the config folder after the first start.

Install it in the Mods tab. It only needs to be on the server; players do not need it in their game.

Separate from the chat bridge, the panel can talk to your Discord itself. In Settings you find two options.

• Discord notifications: a message in a channel of your choice when the server starts, when it crashes and when it is back after a crash, plus alerts on words you pick in the chat or console. You hear about trouble before your players tell you.
• Discord bot: connect our bot to your Discord with a link code. Its commands show whether the server runs and what it uses, who is online, and the last seven days of uptime and players. Restarting is for admins, or for one role you choose.

These work on every server type, also on modded and Bedrock servers, because they do not run inside the game.

Most communities use the chat bridge for players and the notifications for the owner. They do not get in each other's way.

• The token is wrong or was reset. Copy a fresh one and paste it again.
• The intents are off. Messages from Discord then never reach the game.
• The channel ID is a server ID or a user ID instead. Copy it again from the channel itself.

The console prints a clear message from DiscordSRV at startup; read that first.

• The token sits in the config file of the bridge. Anyone who can open Files on your server can read it, so give file access only to people you trust; see give someone access to your server.
• Never paste the token in a Discord channel, a screenshot or a support message.
• If it leaked, click Reset Token in the Discord Developer Portal right away, paste the new token into the config and restart. The old one stops working at once.