Syncing Chat with DiscordSRV

Want your Minecraft chat to show up in Discord? DiscordSRV is the bridge that makes it happen. it links your server and your community together, syncing everything from chat messages and player deaths to custom achievements. It's the best way to keep your Discord active even when nobody is playing.

1. Setting Up Your Bot

To get started, you need to tell Discord that your Minecraft server is allowed to "talk" to it.

Head over to the Discord Developer Portal and create a new application (call it your server name).
Go to the Bot tab and enable Server Members Intent and Message Content Intent. This lets the bot see who is talking and what they’re saying.
Copy your Bot Token. Think of this as the bot's password; keep it secret! [image - External > Discord Developer Portal | Bot Settings | Screenshot of the Bot Token area and the required 'Gateway Privileged Intents' toggles]
Paste that token into the config.yml file in your plugins/DiscordSRV folder.

2. Linking the Channels

You need to tell the bot which Discord channel should receive the Minecraft chat.

In Discord, right-click a channel and select Copy ID.
In your config.yml, find the Channels section and paste the ID:
- Channels: {"global": "1234567890"}
Pro Tip: You can also link a "Console" channel that lets you run server commands directly from Discord. Just be very careful with who has access to that channel!

3. Making it Look Professional (Webhooks)

By default, the bot sends all Minecraft messages under its own name. If you enable Webhooks, the bot will automatically change its icon and name to match the Minecraft player who is currently talking. [image - External > Discord App | Chat Integration | Screenshot of a Discord channel showing in-game chat with player head avatars via Webhooks]

4. Syncing Ranks and Roles

If you use LuckPerms, you can sync your ranks. For example, if someone buys a "VIP" rank on your server, DiscordSRV can automatically give them the "VIP" role in your Discord server. It’s a great way to automate your community management.

Having trouble getting the bot to come online? Check out the DiscordSRV Help Center for a deep dive into every single setting.