DiscordSRV

What it does

DiscordSRV sends Minecraft chat to a Discord channel and Discord messages back into the game. It can also post joins, leaves, deaths and server start and stop, mirror the console to a staff channel, and link players' Discord and Minecraft accounts.

1. Make a Discord bot

1. Go to the Discord Developer Portal, create a New Application and give it your server's name.
2. Open Bot and copy the token. Keep it secret: anyone with it controls your bot.
3. On the same page, turn on Server Members Intent and Message Content Intent. Without these the bot connects but can't read messages.
4. Open OAuth2, choose the bot scope with permission to read and send messages and manage webhooks, and open the link it makes to add the bot to your Discord server.

2. Install and configure

1. Put the DiscordSRV jar in plugins and restart once so it makes its config.
2. Edit plugins/DiscordSRV/config.yml:

BotToken: "your-token-here"
Channels: {"global": "123456789012345678"}

To get a channel ID, turn on Developer Mode in Discord (Settings, Advanced), right-click the channel and choose Copy Channel ID.

3. Restart the server. The console shows the bot connecting, and a message appears in the channel.

Linking accounts

Players run /discord link in game and send the code to the bot. Linking lets you sync roles and ranks between Discord and LuckPerms.

Common problems

"Disallowed intents": turn on Server Members Intent and Message Content Intent in the Developer Portal, then restart.

The bot is online but messages don't come through: check the channel ID is right and the bot can see and post in that channel.

"Invalid token": copy the token again. Reset it in the Developer Portal if you think it's leaked.

Performance

Light. Chat goes out on its own thread, so a slow Discord connection doesn't lag the game.