Link your Minecraft chat to Discord

Step 1: make a Discord bot

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.

Step 2: DiscordSRV on a plugin server

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.

On a modded server

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.

Alerts and restarts from the panel

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.

If the bot stays offline

• 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.