What DiscordSRV works with.
| Platform | Java Edition |
|---|---|
| Loaders | Bukkit, Folia, Paper, Purpur, Spigot |
| Minecraft versions | 1.8.9, 1.12.2, 1.16.5, 1.20.1, 1.21.1, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2 |
DiscordSRV mirrors chat between a Minecraft server and a Discord channel. Type a message in-game and it shows up in Discord, type one in Discord and it shows up in-game. It runs on Paper, Spigot, Purpur, Folia, and Bukkit, and connects through a Discord bot that the server owner creates and controls. DiscordSRV is open source under the GPL 3.0 license and has passed 497,812 downloads on Modrinth.
What the DiscordSRV plugin links
Chat relay is the core of the DiscordSRV plugin, but it also links a server's Discord presence to what happens in-game. Console output can route to a dedicated Discord channel, so admins can watch or run server commands without opening a terminal. Player accounts can link Minecraft to Discord, which lets DiscordSRV sync Discord roles with in-game permission groups when a permissions plugin is present.
- Two-way chat relay between a Minecraft channel and a Discord text channel
- A console channel for server output and remote commands
- Minecraft to Discord account linking
- Discord role sync with an installed permissions plugin
- Join, leave, and death message broadcasts to Discord
Setting up DiscordSRV
Installing the jar follows the same path as any other plugin on a Paper or Spigot server. Setup after that involves work on both sides of the bridge, since DiscordSRV needs a bot to act on your Discord server's behalf. In broad strokes, setup covers:
- Creating a Discord bot application and generating its bot token
- Inviting the bot to your Discord server with the permissions DiscordSRV's own docs list
- Pasting the bot token into DiscordSRV's config.yml on your Minecraft server
- Setting the Discord channel IDs DiscordSRV should bridge, such as chat and console
- Restarting the server so the new config loads
DiscordSRV on Paper, Spigot, and other server software
The same jar covers most of the Bukkit-derived server ecosystem. Modrinth lists DiscordSRV as compatible with Bukkit, Folia, Paper, Purpur, and Spigot, so a Paper or Spigot server owner installs it the same way a Folia or Purpur owner does, with no separate build to track down.
- Bukkit
- Folia
- Paper
- Purpur
- Spigot
DiscordSRV setup walkthrough
Questions about DiscordSRV.
5 questions
What does DiscordSRV do?
DiscordSRV bridges chat between a Minecraft server and a Discord channel, so in-game messages appear in Discord and Discord messages appear in-game. It also supports Minecraft to Discord account linking, Discord role sync through a permissions plugin, and a console channel for server commands, all through its own Discord bot.
How do I install DiscordSRV?
Drop the DiscordSRV jar into your server's plugins folder and restart it, the same as any other Paper or Spigot plugin. After that, create a Discord bot, paste its token into DiscordSRV's config.yml on your server, and set the channel IDs you want DiscordSRV to bridge.
Does DiscordSRV work with Paper and Spigot?
Yes. DiscordSRV supports Paper, Spigot, Purpur, Folia, and Bukkit from the same jar file, so there is no separate build to pick between them.
Which Minecraft version does DiscordSRV support?
DiscordSRV's current release covers Minecraft versions back to 1.7.10 through the 26.1 and 26.2 year.drop updates. That range is unusually wide for a maintained plugin, so it fits both long-running legacy servers and current ones.
Is DiscordSRV safe to use on a multiplayer server?
DiscordSRV is open source under the GPL 3.0 license, with its source and issue tracker public on GitHub. It runs server-side only, so players connecting to your server do not need to install anything themselves.
