--- title: "Setting Up DiscordSRV: Bridging Minecraft Chat and Discord | ZCS" description: "Minecraft chat and a Discord server usually run as two disconnected conversations. DiscordSRV is the plugin that links them into one." url: "https://www.zcraftstudios.com/blog/discordsrv-chat-bridge-setup" updated: "2026-10-20T07:15:13.005688+00:00" source: "ZCraft Studios" --- > Site index for AI agents: https://www.zcraftstudios.com/llms.txt (full reference: https://www.zcraftstudios.com/llms-full.txt). Every page is available as Markdown by adding `.md` to its URL or sending `Accept: text/markdown`. 1. [Home](https://www.zcraftstudios.com/) 2. [Blog](https://www.zcraftstudios.com/blog) 3. Setting Up DiscordSRV: Bridging Minecraft Chat and Discord [ All posts](https://www.zcraftstudios.com/blog) # Setting Up DiscordSRV: Bridging Minecraft Chat and Discord ZCraft StudiosOct 3, 2026Updated Oct 20, 2026 Minecraft chat and a Discord server usually run as two disconnected conversations. DiscordSRV is the plugin that links them into one. ## In this guide - [Create a Discord Bot Application](#create-a-discord-bot-application) - [Install DiscordSRV](#install-discordsrv) - [Configuring the Bot Token and Channel](#configuring-the-bot-token-and-channel) - [Inviting the Bot to the Server](#inviting-the-bot-to-the-server) - [Testing the Bridge](#testing-the-bridge) - [Account Linking](#account-linking) - [Common Setup Issues](#common-setup-issues) - [Plan permissions and privacy before enabling the bridge](#plan-permissions-and-privacy-before-enabling-the-bridge) - [Official documentation and links](#official-documentation-and-links) - [Troubleshooting chat that travels in only one direction](#troubleshooting-chat-that-travels-in-only-one-direction) ## Setting Up DiscordSRV: Bridging Minecraft Chat and Discord _Without a bridge, in-game chat and the Discord server are two separate conversations that never see each other._ DiscordSRV links a Minecraft server's chat to a Discord channel in both directions: messages sent in-game appear in Discord, and messages sent in Discord appear in-game. It also supports account linking, role syncing, and join/leave announcements. ## Create a Discord Bot Application Before installing anything server-side, a bot application needs to exist in the [Discord Developer Portal](https://discord.com/developers/applications). Create an application, add a bot user, and copy its token. It's needed for the plugin config and should never be shared publicly. ## Install DiscordSRV [DiscordSRVThe most powerful, configurable, open-source Discord to Minecraft bridging plugin available.On Modrinth ](https://modrinth.com/plugin/discordsrv) Download DiscordSRV from the project linked above. Check the supported Minecraft version, server platform, Java requirement and dependencies for the selected release. 1. Back up the server files and any plugin database. 2. Stop the server before changing JAR files. Put the compatible plugin build and its required dependencies in the correct plugin folder. 3. Start the server and read the startup log. Resolve missing dependencies or version errors before editing the generated configuration. 4. Stop the server, make one small configuration change, then restart and test it with a non-operator account. Keep the bot token private. Verify the channel mapping and Discord permissions with a test message in each direction before enabling the bridge for everyone. ## Configuring the Bot Token and Channel In `plugins/DiscordSRV/config.yml`: ``` BotToken: "your-bot-token-here" Channels: global: "your-discord-channel-id" ``` The channel ID is found by enabling Developer Mode in Discord's settings, then right-clicking the target channel and copying its ID. ## Inviting the Bot to the Server The bot needs to actually be in the Discord server to bridge chat. Generate an OAuth2 invite link from the Developer Portal with at minimum the `bot` scope and `Send Messages`/`Read Messages` permissions, then open that link and add it to the Discord server. ## Testing the Bridge Restart the Minecraft server after configuring the token and channel. A message typed in-game should appear in the configured Discord channel, and a message typed in that Discord channel should appear in Minecraft chat. If only one direction works, double check the bot has both read and send permissions in that specific channel. ## Account Linking DiscordSRV supports linking a player's Minecraft account to their Discord account via a `/discord link` command in-game, which generates a code the player enters in Discord. Once linked, this enables role syncing: a Discord role can automatically grant (or require) an in-game permission group, and vice versa. ## Common Setup Issues - **Bot shows offline in Discord**: this usually means the token is wrong, or the bot lacks the "Message Content Intent" enabled in the Developer Portal, which is required for DiscordSRV to read message content. - **Messages bridge one way only**: check the bot's channel-specific permissions, not just its server-wide role permissions. - **Join/leave messages not appearing**: these are configured separately from the chat bridge itself, under a different config section. ## Plan permissions and privacy before enabling the bridge A chat bridge connects two communities with different moderation systems. Decide which Minecraft channels may appear in Discord, whether staff-only messages stay private, and how commands or mentions should be handled. Create a dedicated Discord channel for the bridge and give the bot only the permissions it needs. Avoid using a general-purpose admin channel or sharing sensitive console output with players. ### Test the integration in both directions 1. Send a normal Minecraft chat message and confirm the intended Discord channel receives it. 2. Send a Discord message and verify how it appears in-game. 3. Test user mentions, formatting, and unusual characters. 4. Confirm banned or muted players cannot use the bridge to bypass moderation. 5. Restart one side and confirm the bridge reconnects cleanly. If messages stop appearing, check the bot's permissions and channel identifiers, then inspect the plugin logs. Never publish a Discord bot token in screenshots or configuration examples. See the [DiscordSRV documentation](https://docs.discordsrv.com/) for current settings and supported features. ## Official documentation and links - [Official project repository](https://github.com/DiscordSRV/DiscordSRV) - [Minecraft Server Discord Integration Done Right](https://www.zcraftstudios.com/blog/minecraft-server-discord-integration) ## Troubleshooting chat that travels in only one direction If Discord messages appear in Minecraft but Minecraft messages never reach Discord, check the bot's channel permissions and the channel mapping before changing general server settings. Confirm that the bot can **view** and **send** messages to the configured channel. Then read the DiscordSRV startup log for missing permissions or a mismatched channel ID. If chat works but join or quit notices do not, treat those as separate event settings. Test with an ordinary player account and avoid using a production Discord channel for repeated test messages. ## Continue reading - [Minecraft Server Discord Integration Done Right](https://www.zcraftstudios.com/blog/minecraft-server-discord-integration) - [Setting Up LiteBans for Ban, Mute, and Kick Logging](https://www.zcraftstudios.com/blog/litebans-setup-guide) - [EternalTags Setup: Chat Tags, Menus and Permissions](https://www.zcraftstudios.com/blog/eternaltags-plugin-setup-guide) - [EssentialsX Config Guide: Messages, Chat and Modules](https://www.zcraftstudios.com/blog/essentialsx-config-guide-messages-chat) [ Previous guide Setting Up LiteBans for Ban, Mute, and Kick Logging](https://www.zcraftstudios.com/blog/litebans-setup-guide)[ Next guide Setting Up Multiverse for Multiple Worlds](https://www.zcraftstudios.com/blog/multiverse-multiple-worlds-setup)