Hardware FixRecommendedDevice not working? Your driver may be the problemCheck updates for common hardware issues.Fix DriversHalloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix Now×
Skip to content
VGSources
Blog

How to Set Up DiscordSRV on a Minecraft Server

A complete DiscordSRV setup guide covering plugin installation, Discord bot configuration, channel mapping, account linking, mandatory linking and troubleshooting.
Length10 min Posted Quest giverVGSources Team
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

DiscordSRV connects a Bukkit-compatible Minecraft server to a Discord bot. Install the server-side plugin, create and configure a Discord application, map Minecraft channels to Discord channel IDs, then test the bridge. Account linking is optional unless you enable it in linking.yml; enabling that file can require players to link before they join.

What DiscordSRV is and what you need

DiscordSRV is a server-side Minecraft plugin, not a client-side mod. It runs on software that implements the Bukkit API, including Paper, Spigot and CraftBukkit. Every player can continue using a normal Minecraft client; the integration operates from the server and Discord bot.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Before installing, make sure you have all three forms of access below:

Requirement Why it matters
Bukkit-compatible server software DiscordSRV’s documented initial setup targets Paper, Spigot, CraftBukkit and other software based on the Bukkit API.
Server file access You must place a JAR in the server’s plugins directory and edit generated YAML files.
Server log access and reliable restarts The startup log confirms whether the plugin loaded, while several configuration changes take effect only after a restart.
Permission to manage a Discord application and server You must create the bot, enable its required privileged Gateway Intents, add it to the Discord server and grant the documented read and send permissions.

If your Minecraft software is not Bukkit-based, this setup is not the appropriate installation path. If your host does not let you read logs, edit files or restart reliably, ask the host whether those capabilities can be enabled before proceeding.

#1 Best Overall
Sale
Gaoye Blue Light Blocking Glasses | Anti UV Ray, For Computers & Gaming, Square Frame, Eyewear for Men and Women
  • BLUE LIGHT BLOCKING GLASSES: Our blue light glasses for women boast UV400 protection, blocking harmful blue rays from computer screens. With these bluelight glasses women, you can enjoy gaming, reading, or watching TV with no worries of eye strain.
  • EYE RELIEF: Our blue light glasses are engineered to reduce blurry vision or strain caused by prolonged screen time. These womens blue light glasses aid in better sleep by preventing blue light from disrupting your natural sleep cycle, helping you fall asleep faster and enjoy a more restful night's sleep, making them the perfect christmas present.
  • COMFORTABLE: Crafted from durable material, our trendy blue light glasses for woman or blue light glasses men ensure long-lasting comfort. The high-transmittance lenses accessories, gamer gifts for men, help keep your eyes relaxed. Perfect stocking stuffers, gifts for gamers men, christmas gifts for men, halloween costumes.
  • LIGHTWEIGHT: These clear blue light glasses feature a lightweight frame, meaning they’ll stay comfy for long-term wear. Perfect as blue blockers glasses for women or mens blue light glasses, these non-prescription fake glasses for men can be worn throughout the day. The blue light blocking glasses women feature polycarbonate HD lenses, which are anti-reflective and restore true color.
  • WORRY-FREE PURCHASE: If you experience any issues, our support team is ready to assist you quickly. These are the perfect costume glasses for cosplay dressing up.

Install the DiscordSRV plugin

1. Put the JAR in the correct directory

  1. Obtain the DiscordSRV plugin JAR identified by the filename pattern DiscordSRV-Build-VERSION_NUMBER.jar.
  2. Open the server’s main directory and locate plugins. This is the plugins directory for the server instance that actually runs your world, not a client-side mods folder.
  3. Copy the DiscordSRV JAR into that plugins directory.
  4. Restart the Minecraft server.

The first successful startup creates a DiscordSRV directory inside plugins. That directory contains the configuration files used by the integration.

2. Open the generated configuration

After the restart, open plugins/DiscordSRV/config.yml in a text editor. Keep the YAML indentation intact: a misplaced space can change the meaning of a setting or prevent the file from loading. Make one logical change at a time when diagnosing a problem, so the next startup log identifies the setting that caused it.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Do not assume that installing the JAR alone creates a working bridge. The Discord application, bot, intents, channel IDs and permissions are configured separately in Discord and in this YAML file.

Create the Discord application and bot

1. Create an application

  1. Open the Discord Developer Portal and create a new application for the server integration.
  2. Use the application’s bot settings to create the bot user that DiscordSRV will operate.
  3. In the application’s Installation tab, disable User Install.
  4. Set Install Link to None. This keeps the installation intended for adding the bot to a server rather than installing it for individual users.

2. Enable the required Gateway Intents

DiscordSRV’s setup documentation identifies privileged Gateway Intents that must be enabled for the integration. Turn on every privileged intent specified by the current DiscordSRV instructions before inviting the bot. If an intent is left disabled, the bot may appear online while message events, member information or synchronization features fail.

Intent settings are separate from channel permissions. Enabling an intent does not automatically let the bot read or send messages, and granting a channel permission does not replace an intent that the bot requires.

Rank #2
Windex Gaming Cleaning Wipes, Pre-Moistened Wipes to Instantly Clean all Gaming Gear and Electronics, Resealable Packaging for a Freshness Lock, 25 count (Pack of 1)
  • WINDEX GAMING WIPES: effortlessly clean all your gaming gear and gaming electronics in one easy step with our new Windex Gaming Wipes
  • AMMONIA FREE: our ammonia-free formula is safe to use on all of your favorite gaming equipment like consoles, headsets, controllers, screens, keyboards, and more
  • PRE-MOISTENED WIPES: each wipe instantly removes dust, dirt, and stubborn smudges and fingerprints leaving a streak-free shine
  • ANTI-STATIC: great for cleaning and wiping down your gaming gear and electronics leaving behind no visible residue
  • COMPACT RESEALABLE PACKAGE: store your pack of Windex Gaming Wipes anywhere in your home for whenever a quick and easy wipedown is needed

3. Add the bot and grant permissions

  1. Use the application’s installation flow to add the bot to the Discord server where the Minecraft channels will live.
  2. Grant the read and send permissions documented for DiscordSRV. Apply them to the channels that the plugin will use, or through an appropriate role and category arrangement.
  3. Check for overriding channel-specific denies. A server-level or role-level allow can still be defeated by a channel permission that denies the bot access.

The exact permission arrangement depends on your Discord server’s role and category structure. The important test is practical: the bot must be able to receive the events DiscordSRV needs and send messages in each mapped destination channel.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Map Minecraft channels to Discord channels

Turn on Developer Mode and copy IDs

  1. In Discord, enable Developer Mode in the user settings.
  2. Right-click the Discord channel that should receive a Minecraft channel’s messages.
  3. Choose Copy ID.
  4. Repeat for every Discord channel you intend to map, keeping a record of which ID belongs to which channel.

A Discord channel ID is a numeric identifier. Do not enter the visible Discord channel name in its place.

Edit the Channels mapping

In plugins/DiscordSRV/config.yml, find the Channels setting. The value on the left is the Minecraft channel name; the value on the right is the numeric Discord channel ID. The documented format looks like this:

Channels: {"global": "219559668236681216", "admin": "221419146028646401"}

In this example, Minecraft’s global channel is sent to Discord channel ID 219559668236681216, while admin is sent to 221419146028646401. Preserve the quotation marks and the mapping structure used by the generated file.

The first channel pair is the main channel. Decide which Minecraft channel should be the primary public conversation before editing the list. Add additional pairs only when you have copied the corresponding Discord IDs and granted the bot access to those destinations.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Sale
LISEN Cell Phone Stand Phone Holder for Desk, Office Decor Gadgets for Men
  • Ergonomic & Adjustable Design: Fight "text neck" and improve your posture. Designed for comfort, it offers an adjustable height (7.1in-8.5in) (1.4in adjustable range) and angle (5°-85°) Please note: cell phone stand is only 9 inches tall—the length of a standard pencil
  • Without blocking subtitles Perfect for office desk Tiktok Face Time Zoom video—this is the ultimate kitchen desk essential for phones! Perfect viewing experience while reducing neck back strain, A must-have for gamers streamers desk, and anyone who values both style and support!
  • Sleek & Stable Design fits Otterbox Case: Say goodbye to bent cables, tangles, and tip-overs! LISEN’s stylish adjustable desk phone holder features a built-in charging hole and smart cable management, keeping your phone secure and your workspace clutter-free cool gadgets for men
  • ANTI-SLIP DESIGN free hands: The under 10.00 items easy gadgets back and the bottom of this kitchen essentials for women are fully covered by anti-skid silicone, which LISEN stand up desk decor can provide maximum protection device from any scratches and slides
  • Your Perfect Viewing Companion:If your product arrives damaged or breaks within 365 days, reach out to LISEN for a quick and hassle-free solution. Struggling with assembly, like tightening the screw? We’ve got your back! Your experience matters to us. (Product including: phone Holder stand*1, screw*1, hexagon screwdriver*1, specification*1)

Set the invite and verify basic commands

Configure an invite link if you want one displayed

DiscordSRV provides a DiscordInviteLink setting. Enter your server’s chosen invite there if you want DiscordSRV’s invite-related output to point players to a particular Discord invitation. Leave the setting according to the generated configuration when you do not need an invite displayed.

Use the player commands

Once the bot and channel mapping are in place, use the plugin’s commands from Minecraft:

Command Purpose Who typically uses it
/discord Shows the Discord integration entry point, including the configured invite when applicable. Players
/discordsrv Opens the DiscordSRV command interface. Players and staff, depending on subcommand permissions
/discordsrv link Displays instructions for linking a Minecraft account to Discord. Players who want to link
/discordsrv linked Checks whether the current Minecraft account is linked. Players
/discordsrv resync Requests a synchronization operation when staff need to bring integration state back into alignment. Staff
/discordsrv reload Reloads settings that support a live reload. Staff
/discordsrv debugger Starts diagnostic output for relevant message, group, presence or voice behavior. Staff diagnosing a fault

Give staff access to the administrative commands through your server’s permission system. Do not treat /discordsrv reload as a universal replacement for restarting: settings documented as restart-dependent still require a full server restart.

Link a Minecraft account to Discord

Player-initiated linking

Account linking is optional in a default DiscordSRV installation. A player can run /discordsrv link in Minecraft to receive the current linking instructions. The process uses a code that the player sends to the DiscordSRV bot, associating the Minecraft account with the player’s Discord account.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

After completing the process, run /discordsrv linked in Minecraft to check the account’s status. If the command does not show the expected state, check that the player sent the code to the correct bot and then inspect the server log and Discord permissions before attempting another link.

Rank #4
Ledagic IC+RGBW USB Powered Led Light Bar with App & Remote Control, 2 Pack
  • Easy Installation: Our gaming lights have been designed to enhance your entertainment experience. Simply position the led light bar next to your TV or game console to create a game room environment with ease. They come with USB power and a 60 inch cord for direct mounting and mobility
  • Audio Syncing & Extensive Mode: The built-in high-sensitivity music sensor allows you to sync the TV led lights to your favorite music. Lights react and move to the beat of music, film and game audio, creating an incredible immersive sound and light experience – and all without the need for an additional hub. You can choose from 64+ patterns, including strobe, illusion, jump, energy, gradient, running, chasing, fluttering mode etc. Each mode can be applied to different scenes
  • 64+ Chasing IC+RGB & W Effect: The independent control design of IC+RGB and white all-in-one multifunctional rgbw led bar lights monitor backlight allows you to easily switch the led lights for desk between IC+RGB and white to enjoy a variety of lighting effects, you can choose white lighting mode with high brightness for better illumination when working, etc. Choose IC+RGB lighting mode when you need to create an entertaining atmosphere for the light show, 16 million colours of Color changing rgb light bar let you dance to the beat and create a dynamic party atmosphere
  • Dynamic and Dimmable Lights: 1%-full brightness free brightness adjustment gives you the flexibility to adjust dimmable led light bar for room decorations or a variety of occasions
  • USB Powered: USB light bars for room can be powered by powernank, usb charger, TV, Monitor, laptop PC mainframe, making behind TV led lighting bar easy to install in any location.TV led lights are powered by the TV usb interface / PC mainframe, can be turned on/off synchronously with TV / PC

What linking enables

Linking gives DiscordSRV a verified relationship between a Minecraft account and a Discord account. That relationship is the basis for features that need to identify the same person in both communities. It also allows the server owner to make linking a condition of entry rather than merely an optional convenience.

Require Discord linking before players can join

Enable the join requirement

  1. Open plugins/DiscordSRV/linking.yml.
  2. Set Enabled: true.
  3. Save the file.
  4. Restart the Minecraft server, because this setting is applied through the restart-dependent configuration path.

When an unlinked player tries to join after this feature is enabled, DiscordSRV kicks that player with a message containing instructions and a code to send to the bot. The player must complete the link and then attempt to join again.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Add Discord membership or role conditions when appropriate

The linking feature can also require a linked player to belong to selected Discord servers and/or hold specified subscriber roles. Use those conditions only when Discord membership is genuinely part of your server’s access policy. A player who links an account but does not satisfy an additional server or role condition will not meet the full entry requirement.

Explain the requirement to your community before turning it on. Otherwise, the kick message may be the first time a player learns that a Discord account, a particular server membership or a role is required.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Choose an installation environment

The plugin setup is the same in principle whether you administer a home server or rent managed Minecraft hosting, but the practical risk is different. Use this comparison before you commit to an environment.

Best Value
Sale
HUANUO FlowLift™ Dual Monitor Stand, Fully Adjustable Gaming Monitor Desk Mount for 13–32″ Computer Screens, Full Motion VESA 75x75/100x100 with C-Clamp & Grommet Base, Each Arm Holds 4.4 to 19.8 lbs
  • Compatible with Wide Screens - To ensure compatibility with the dual monitor mount, your each monitor must meet three conditions at the same time: First, computer screens size range: 13 to 32 inches. Second, screen weight range: 4.4 to 19.8 lbs. Third, the back of the monitor screen must have VESA mounting holes with a pitch of 75x75mm or 100x100mm.
  • Regarding the compatibility with desks - Your desk must meet three conditions at the same time: First, desk material: Only wooden desks are recommended, plastic or glass desks cannot be used. Second, desk thickness range: 0.59" - 3.54". Third, the bottom of the desk should not have any cross beams or panels, as this will interfere with installation. We recommend carefully checking that your desk and monitors meets all above conditions before purchasing.
  • Dual C-Clamp Hold - Worried your dual monitors might wobble or slip? Our upgraded base uses a larger platform plus a dual C-clamp structure to lock the dual monitor arm firmly to your desk. Each arm safely keeps your screens steady while you type, click and game—no shaking, no sliding, just a clean and secure setup you can trust every day. It also provides Grommet Mounting installation choice, both options ensure stable and secure fixation for your 0.59" - 3.54" desk.
  • Full-Motion Adjustment For Comfortable View - Pull the screen closer when you’re deep in a spreadsheet, push it back to watch videos, or rotate to portrait for coding — moving everything smoothly with just one hand. The monitor stand offers +85°/-50° tilt, ±90° swivel and 360° rotation. Raise your monitor up to 15.75″ to support a healthy sitting posture. Whether you’re working from home, gaming through the night, or switching between video calls and documents, getting the screens to your natural line of sight helps relieve neck, shoulder and back strain so you can stay focused longer with less fatigue.
  • Keep Your Desk Organized: By lifting both screens off the desktop, this dual monitor stand opens up valuable space for your keyboard, notebook, docking station or a simple, clutter-free work area. Built-in cable management guides wires along the arms, keeping cords out of sight and out of the way. Enjoy a tidy, modern workstation that looks as good as it feels to use.
Decision factor Self-managed server Managed host
Platform compatibility You select and maintain Paper, Spigot, CraftBukkit or another Bukkit-compatible platform. Confirm that the host offers a Bukkit-compatible server type rather than a platform that cannot load plugins.
File access You normally control the plugins directory and YAML files. Verify that the control panel or file transfer method allows uploading the JAR and editing generated files.
Log access You can inspect the console or log files directly. Confirm that startup logs are visible; without them, diagnosing failed loading or permissions is slower.
Restart reliability You decide when to stop and start the process. Check that restarts are available and complete cleanly, since some settings do not apply through reload.
Discord permission model You configure the application, intents and channel permissions yourself. The host does not replace Discord administration; you still need control of the Discord application and server.
Channel mapping You edit config.yml directly. You need the same file access, even if the host supplies a web editor.
Account-link policy You decide whether linking is optional or enforced in linking.yml. The host must allow the configuration and restart needed to enforce the policy.

Troubleshoot a DiscordSRV installation

The plugin does not appear to load

  • Confirm that the JAR is in the active server instance’s plugins directory, not in a similarly named folder for another server.
  • Restart rather than relying on a reload.
  • Read the startup log immediately after the restart and look for the DiscordSRV load result or a configuration error.
  • Verify that the server platform is Bukkit-compatible.

The bot is online but messages do not bridge

  • Recheck the privileged Gateway Intents required by the DiscordSRV documentation in the Developer Portal.
  • Check the bot’s read and send permissions in every mapped Discord channel, including category and channel-level overrides.
  • Confirm that Channels uses Minecraft channel names on the left and numeric Discord IDs on the right.
  • Check that the ID was copied from the intended channel after enabling Developer Mode.

The mapping looks correct but output goes to the wrong place

Read the mapping literally. A visible Discord name such as #general is not a valid substitute for its numeric channel ID. Compare each left-hand Minecraft name with the channel that Minecraft actually uses, then compare each right-hand value with the ID copied from Discord. Remember that the first pair is the main channel.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Linking commands or codes fail

  • Run /discordsrv link again to obtain the current instructions rather than reusing an old code.
  • Send the code to the DiscordSRV bot account specified by those instructions.
  • Use /discordsrv linked to check the result from Minecraft.
  • If linking is enforced, verify that the player also belongs to any required Discord server and holds any required subscriber role.
  • Inspect the server log and Discord permissions if the bot cannot receive the linking message.

Reload appears to do nothing

/discordsrv reload only affects settings that support reloading. For a change documented as restart-dependent, stop and restart the server, then verify the result in the startup log. This distinction is especially important after changing the join requirement in linking.yml.

Use the debugger for message-flow problems

When ordinary checks do not identify the fault, use /discordsrv debugger with the relevant debug categories. Select categories that match the symptom: message flow for chat delivery, group synchronization for role or group state, presence for online-status behavior, and voice for voice-related behavior. Capture the resulting information alongside the time of the test and the channel involved so staff can correlate it with the server log.

Pre-launch checklist

  • The server runs Paper, Spigot, CraftBukkit or another Bukkit-API implementation.
  • The DiscordSRV JAR is in the active server’s plugins directory.
  • A restart created plugins/DiscordSRV and its configuration files.
  • The Discord application has User Install disabled and Install Link set to None.
  • The privileged Gateway Intents required by DiscordSRV are enabled.
  • The bot is in the intended Discord server and can read and send in each mapped channel.
  • config.yml maps Minecraft channel names to numeric Discord channel IDs.
  • The main channel is the first channel pair in the mapping.
  • /discord, /discordsrv link and /discordsrv linked produce the expected responses.
  • If linking is mandatory, linking.yml contains Enabled: true and the server has been restarted.
  • Staff can use the administrative commands they need, including the debugger, without giving ordinary players unnecessary access.

What a successful setup looks like

A complete installation has four working layers: the plugin loads from the server’s plugins directory; the Discord bot connects with its required intents; each Minecraft channel points to a numeric Discord channel ID where the bot can read and send; and players can complete the optional or required account-link flow. Test all four layers with a real message and a test player before announcing the integration to the wider community.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More quests from Patch Notes

  1. How to Set Up a RedM (RDR2) Server in 2026: License Key, txAdmin and server.cfg, Step by StepBlog11min
  2. Best RedM (RDR2) Server Hosting in 2026: Comparing Four Hosts on Slots, Memory and PriceBlog10min
  3. How to Host a Mindustry Server in 2026: server-release.jar, Port 6567 and the Commands That MatterBlog7min
Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.