How to Setup DiscordSRV on Your Minecraft Server

What is DiscordSRV?

DiscordSRV is a powerful plugin that can sync your in-game Minecraft chat with a channel on your Discord server, in addition to a wealth of other features such as:

  • Linking Discord and Minecraft accounts and syncing nicknames/roles.
  • Voice proximity chat.
  • Managing your Minecraft console remotely through Discord.

This guide will only cover the very basics – how to link your chats together – however once completing this guide, you can configure the additional features using their official installation guide.


These instructions are adapted from the official DiscordSRV installation guide. If you’d like to customise your setup or require further guidance, please see their GitHub Wiki Page.

Note: You must have the Manage Server permission on your Discord Server to add the bot

Installing the Plugin

  1. Download the plugin from the DiscordSRV Spigot Page.
  2. Install the plugin using our guide here.
  3. Restart your server to generate the needed configuration files.

Creating the Discord Bot

  1. Create a new Discord Application by going to the Discord Developer Portal and clicking New Application. Pick a name and assign it to your personal team.
  2. Add a Bot to your new Application by navigating to the Bot page and clicking Add Bot.
    Image of bot creation step 1.
  3. Enable the Server Members Intent and click Save Changes. If you’d like, you can also change the bot icon and username on this page.
    Image of bot creation step 3.
  4. Copy the Token by clicking the Copy button.
    Image of bot creation step 4.
  5. Copy your Application ID by going back to the General Information page and clicking Copy.
    Image of bot creation step 5.
  6. Go to and copy your numeric Application ID to the end of the link.
  7. Select your server from the list and click Continue then Authorise.
    Image of bot creation step 7.

Finding the Discord Channel ID

  1. Enable Discord Developer mode by going to User Settings > Advanced then toggling Developer Mode.
    Image of finding the Discord channel ID step 1.
  2. Right click the Discord text channel that you would like to link with your Minecraft server and click Copy ID.
    Image of finding the Discord channel ID step 2.
  3. You should then have a long number (such as 873672811208663090) in your clipboard.

Configuring the Plugin

  1. Open the DiscordSRV configuration file at plugins/DiscordSRV/config.yml.
    1. Paste your Discord bot token into the BotToken field.
      Image of configuring the plugin step 1.1.
    2. Paste your Channel ID in the Channels global field.
      Image of configuring the plugin step 1.2.
  2. Restart your server

Wrap Up

After following this guide, your Minecraft server and Discord channel should be linked up and you should receive a message such as the following:
Image of wrap up.

If you require any further assistance, please contact our support at:

Mitchell Smith

Managing Director @ Shockbyte

  • Minecraft, Discord, DiscordSRV, plugins
  • 11 Users Found This Useful
Was this answer helpful?

Related Articles

How to Configure LuckPerms on Your Server

We have a video tutorial on how to use LuckPerms:   LuckPerms is one of the more recent and...

How to Import a World Using Multiverse-Core

We have a video tutorial on how to import a world into your Minecraft server:...

How to Install Sponge Plugins

By default, Forge server type only supports mods and cannot run plugins. However, the SpongeAPI...

How to Install Sponge on a Forge Server

You may learn more about SpongeForge and the Sponge project by visiting the official Sponge...

How to Install Thermos on Your Minecraft Server

When running a Minecraft server, you'll typically have to choose between running plugins or mods...