DiscordSRV: link Minecraft chat with your Discord server
Install DiscordSRV, create a Discord bot with the Server Members and Message Content intents, then put the bot token and channel ID in DiscordSRV's config.yml and restart.
- Difficulty:
- Intermediate
- Time:
- 15 minutes
On this page
DiscordSRV connects your Minecraft server to a Discord channel: in-game chat appears in Discord, and Discord messages appear in game. You need a Discord bot (free), its token, and the ID of the channel to use.
DiscordSRV is a plugin for Paper, Purpur and other Spigot-family servers.
Step 1: Install DiscordSRV
In the Game Panel, open your server and click Plugins.
Search for DiscordSRV, click Install, and restart the server once so it creates
plugins/DiscordSRV/config.yml.
Step 2: Create the Discord bot
Go to the Discord Developer Portal and click New Application. Give it a name.
In the bot settings, turn on both Server Members Intent and Message Content Intent. DiscordSRV does not work properly without them.
Click Reset Token and copy the token. Keep Public Bot turned off so strangers can't add your bot.
Copy the Application ID from General Information and invite the bot to your Discord server. DiscordSRV's docs provide an invite helper at scarsz.me/authorize.
The bot token is a password. Never post it in Discord, screenshots or tickets. If it leaks, reset it in the Developer Portal and update your config.
Step 3: Get the channel ID
In Discord, open User Settings → Advanced and turn on Developer Mode.
Right-click (or long-press on a phone) the channel for Minecraft chat and choose Copy Channel ID.
Step 4: Edit the config
Stop the server and open
plugins/DiscordSRV/config.ymlin Files.Paste the token into
BotTokenand the channel ID intoChannels:
BotToken: "your-bot-token"
Channels: {"global": "123456789012345678"}Optional: to see the server console in Discord, put a second channel ID in
DiscordConsoleChannelId.Save and start the server. Send a message in game and check that it appears in Discord.
Anyone who can type in the console channel can run server commands, including op and stop. Make that channel visible to owners only.
Step 5: Give the bot permissions
In Discord, create a role for the bot (for example "Bot"), give it Administrator or the individual permissions listed in the official DiscordSRV setup guide, and assign the role to the bot. Make sure it can see your chat channel. Then restart the Minecraft server.
Linking player accounts (optional)
DiscordSRV can link Minecraft accounts to Discord accounts, which allows things like role syncing. Players start linking with /discord link in game and follow the instructions it shows.
Frequently asked questions
Messages from Discord don't show in Minecraft
Usually Message Content Intent is off, or the bot can't see the channel. Turn on the intent, check the bot's role permissions, and restart.
The console says the token is invalid
The token was copied wrong or was reset. Copy a fresh token from the Developer Portal, paste it inside the quotes, and restart.
Does DiscordSRV need an extra port?
No. The bot connects out to Discord, so no extra port in Network is needed.
Can I host the bot separately?
DiscordSRV runs inside your Minecraft server, so you don't need separate bot hosting. For your own custom bots, see Which Discord bot hosting plan should I choose?
Was this article helpful?
Related articles
On an offline-mode server, install a login plugin such as AuthMe or LibreLogin so nobody can join as you, and SkinsRestorer so players get skins back with /skin.
Install Geyser and Floodgate from the Plugins tab, add a port with Create Allocation in Network, set it as Geyser's Bedrock port, and Bedrock players can join your Java server.
spark records what your server spends its time on and gives you a link to a report. Use /spark tps, /spark health and /spark profiler to find the plugin, mod or entity behind your lag.
Open Discord Link in the billing panel's user menu and connect your Discord account to get notifications on Discord and the client role in the Endercloud Discord server.
