DiscordSRV
Minecraft-to-Discord chat bridge. Syncs chat, console and player events between your server and Discord channels.
ChatWhat is DiscordSRV?
DiscordSRV bridges your Minecraft server and a Discord server in both directions. In-game chat is mirrored to a Discord channel and Discord messages appear in game, so players in either place share one conversation. Beyond chat it can pipe the server console to a private channel, post join/leave, death and advancement messages, show the online player list, and link Minecraft accounts to Discord accounts for role-based perks. A configuration file maps channels and message formats, and add-ons extend it to sync roles to in-game ranks.
Who it's for: Community servers with an active Discord that want the two communities to feel like one — keeping players engaged in chat even when they are not logged in, and giving staff a remote console channel. It is built and maintained by Scarsz and sits in the chat category.
Key features of DiscordSRV
- Bi-directional chat sync
- Console channel
- Player list in Discord
- Discord role sync
- Join/leave messages
- Death messages
- Achievement announcements
- Account linking
- Webhook support
How to install DiscordSRV
DiscordSRV runs on Bukkit, Spigot or Paper servers. Scarsz maintains DiscordSRV for current Spigot/Paper versions; it tracks recent Minecraft releases and the Discord API together.
- 1Stop your server, or have it ready to restart. Always back up your world and plugins folder before adding a new plugin.
- 2Download DiscordSRV.jar (a build matching your server version) and place it in your server's /plugins folder.
- 3DiscordSRV has no required dependencies, so it runs on its own once the jar is in place.
- 4Start the server fully. DiscordSRV generates its configuration files on first launch — stop the server, edit them to taste, then start again.
- 5Confirm it loaded by checking the console for DiscordSRV on startup, or by running one of its commands in-game.
Note: Drop DiscordSRV.jar into /plugins and restart to generate config.yml. You must create a Discord bot application, invite it to your server, and paste its token and the target channel IDs into the config — the bridge does nothing until the bot token and a linked channel are set. Enable Message Content intent on the bot for chat to flow from Discord to Minecraft.
DiscordSRV commands and permissions
Main commands
/discord- Shows DiscordSRV status and the invite/link information.
/discord link- Starts the process of linking the player's Minecraft account to their Discord account.
/discord linked- Checks the linked status of an account (staff can query others).
Permission nodes
discordsrv.player- Base access to player-facing Discord commands such as linking.
discordsrv.admin- Access to administrative DiscordSRV commands and reloads.
discordsrv.link- Allows linking a Minecraft account to a Discord account.
DiscordSRV FAQ
How do I connect DiscordSRV to my Discord server?
Create a bot in the Discord Developer Portal, copy its token, invite it to your server, then paste the token and the channel ID for chat into DiscordSRV's config.yml. Restart or reload, and the in-game channel and the Discord channel begin mirroring each other.
Messages go from Minecraft to Discord but not the other way. Why?
Discord now requires the Message Content privileged intent for bots to read message text. Enable Message Content Intent on your bot in the Developer Portal, and make sure the bot has permission to read and send in the linked channel. Then Discord-to-Minecraft chat works.
Can I sync Discord roles with in-game ranks?
Yes. DiscordSRV supports group-role synchronisation: link a Discord role to a permission group so that linked players get the in-game rank, and optionally vice versa. Players link their accounts with /discord link first, which is what ties the two identities together.
How do I get a console channel in Discord?
DiscordSRV can stream the server console to a dedicated Discord channel and even run console commands from it. Configure the console channel ID in the config and restrict that channel tightly — anyone who can type there can run server commands if command execution is enabled.
Does DiscordSRV need a dependency?
No required Minecraft-side dependency — it ships everything it needs. The only external requirement is a Discord bot application and its token. Optional integrations like PlaceholderAPI or a permissions plugin enhance role sync but are not mandatory for basic chat bridging.
Features
- Bi-directional chat sync
- Console channel
- Player list in Discord
- Discord role sync
- Join/leave messages
- Death messages
- Achievement announcements
- Account linking
- Webhook support
Commands
/discord/discord link/discord unlink/discord linkedPermissions
discordsrv.playerdiscordsrv.admindiscordsrv.link