Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check DriversHalloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsClean PCRecommendedOne scan can reveal what keeps slowing WindowsLook for cleanup and repair opportunities.Run Scan×
Skip to content
World desk11 min

How to Set Up DiscordSRV on a Minecraft Server

A complete DiscordSRV setup guide covering plugin installation, Discord bot intents and permissions, channel-ID mapping, account linking, mandatory linking, and troubleshooting.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

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

DiscordSRV connects a Bukkit-compatible Minecraft server to Discord through a server-side plugin and a Discord bot. To set it up, install the plugin in the server’s plugins directory, 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.

This guide follows DiscordSRV’s current setup documentation as accessed on October 14, 2026, and covers Paper, Spigot, and CraftBukkit installations, bot configuration, channel mapping, linking, mandatory linking, and troubleshooting.

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.

What DiscordSRV does—and what it requires

DiscordSRV is a server-side Minecraft plugin. It is not a client-side mod: players do not install anything in their Minecraft client. The plugin runs on Minecraft server software built around the Bukkit API and relays supported server activity through a Discord bot.

The official initial-setup requirements are:

  • A Bukkit-compatible server platform such as CraftBukkit, Spigot, or Paper.
  • Permission to read the server console and startup logs.
  • Permission to add files to the server and edit configuration files.
  • Administrative access to the Discord server and to the Discord Developer Portal.
  • A dependable way to restart the Minecraft server after plugin or configuration changes.

If your host does not expose the server’s file manager, console, or restart controls, you may not be able to complete setup yourself. Ask the host whether it supports Bukkit-compatible plugins and gives you access to the plugins directory, logs, and full restarts.

#1 Best Overall
Sale
TOZO A1 Wireless Earbuds Bluetooth 5.3 Light Weight in Ear Headphones | IPX5 Waterproof,2 Mics for AI Calls,Immersive Premium Sound Bass Headset with Charging Case,32 EQ via App Black
  • [Ultra-Lightweight Ear Buds Designed for Small Ears] Each earbud weighs only 3.7g and features a compact, ergonomic in-ear design made especially for small ears. Secure, low-profile, and comfortable for workouts, all-day wear or overnight sleeping.The ultra-slim profile sits flush in your ear with no hard edges poking or rubbing, so you can even sleep on your side without discomfort.
  • [Immersive Stereo Sound with TOZO OrigX Technology] TOZO OrigX tuning delivers clear vocals, balanced mids, and natural stereo sound for music, podcasts, and videos.
  • [Long Battery Life for Daily Use] Get up to 7 hours of playtime on a single charge, with up to 32 hours total using the charging case—ideal for workdays, commuting, and extended listening sessions.
  • [Bluetooth 5.3 & Stable Connection] Bluetooth 5.3 provides fast pairing, stable wireless performance, and reduced dropouts as you move around home or office.
  • [Deep Bass with Clear Vocals] High-performance drivers produce punchy bass while keeping vocals clean and detailed for everyday listening.

Choose the right server platform

Platform Compatibility stated by DiscordSRV setup documentation What you need to verify with a host
Paper Supported as Bukkit-API server software File access, console/log access, and reliable restarts
Spigot Supported as Bukkit-API server software File access, console/log access, and reliable restarts
CraftBukkit Supported as Bukkit-API server software File access, console/log access, and reliable restarts
Other server software Not established by the setup information here Confirm Bukkit API compatibility and DiscordSRV support before installing

Keep a copy of the original configuration files before making edits. That gives you a quick way to undo a syntax mistake and makes it easier to identify which setting changed when troubleshooting.

Install DiscordSRV on the Minecraft server

1. Stop or prepare the server safely

Use your host’s normal console or control panel to stop the server, or follow the host’s documented procedure for adding plugins while it is offline. Do not replace files while the server is writing configuration data. If you cannot stop it manually, use a controlled restart and wait for the server to finish shutting down before uploading files.

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

2. Put the plugin JAR in the correct directory

  1. Obtain the DiscordSRV plugin JAR named in the format DiscordSRV-Build-VERSION_NUMBER.jar.
  2. Open the root directory of the Minecraft server—the directory containing folders such as world and plugins.
  3. Open plugins. If the folder does not exist, the server has usually not completed its first startup; start it once, let it finish, and stop it cleanly.
  4. Upload or copy the DiscordSRV JAR directly into plugins. Do not put it in a nested folder such as plugins/DiscordSRV/.
  5. Start or restart the server.

After the first successful load, DiscordSRV creates a folder named DiscordSRV inside plugins. Its main configuration file is plugins/DiscordSRV/config.yml. Open that file with a plain-text editor rather than a word processor.

3. Check the startup log

Watch the console during the restart. A plugin that is in the wrong directory, has an incompatible server environment, or cannot be loaded will normally produce an error or stack trace. Record the first DiscordSRV-related error rather than only the final shutdown message; the first error usually identifies the cause.

Create the Discord application and bot

DiscordSRV communicates with Discord through a bot belonging to a Discord application. The Minecraft plugin cannot bridge messages until that application is created, its bot is configured, and the bot has joined your Discord server.

1. Create an application

  1. Open the Discord Developer Portal and create a new application.
  2. Use the application’s bot configuration to create or reveal its bot user and token controls.
  3. In the application’s Installation tab, disable User Install.
  4. Set Install Link to None, as required by DiscordSRV’s setup documentation.

Keep the bot token private. Treat it like a password: do not paste it into chat, publish it in a screenshot, or commit it to a public repository. If it is exposed, regenerate it in the Developer Portal and update the server configuration with the replacement token.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Sale
Smart Watch for Men Women Compatible with iPhone Samsung Android Phone 1.69 inch Full Touch Screen IP68 Waterproof Bluetooh Fitness Tracker Heart Rate/Sleep Monitor (Black)
  • 【IP68 Waterproof Multifunctinal Smart Watch】Torjalph fitness activity tracker smart watch is IP68 waterproof technology ,you can wear it when swimming,handwashing,it's rain-proof which means that you perform multiple exercise modes outside without worrying about sweat or rain corroding your fitness smart watch,and this watch equipped with a 230 mAh large capacity battery magnetic charging ,and this sports activity tracker watch can be used 5-7 days If fully charged.
  • 【Larger 1.83'' Full Screen Watch & Multi-dial Selection】1.83 inch full HD color touch screen smart watch for men / women provides excellent 240*284 resolution image quality ,This Bluetooth smart watch offers a better touch experience and remarkable immersion and ,more than 200 watch faces for you to choose from App"Da Fit ", you can change the dial style according to your mood to wear keeping the world on your wrist
  • 【Accurate Activity Tracker Smart Watch 】sports watch activity tracker uses sweat and dust resistant breathable silicone strap, our Fitness Tracker Smart Watch for Android iOS Phones supports 12 sports modes,walking,running,bicycle,swimming,badminton,basketball,football,rope skipping. This bluetooth calls smart watch for men women is lightweight and stylish, bringing more convenient and relaxing sports experience while also providing more protection.
  • 【Your 24 Hour Personal Daily Health Monitor】Fitness watch for women men full touch screen IP67 waterproof bluetooth smartwatch for Android iOS Phones with heart rate blood pressure monitor multifunction Andriod smart watch with steps counter sleep monitor sports fitness watch, monitoring blood oxygen saturation allows you to understand your physical condition in real time to track fitness progress ,to know your health status in time.
  • 【More Functions Bluetooth Call Smart Watch】This fitness activity smart watch full screen for iPhone and Android phones includes a bunch of new features including:The bluetooth smart watch can hang up the phone, receive and display WhatsAPP /Text /Facebook /Twitter /Messenger reminder.Support sedentary reminder, alarm clock, stopwatch, timer,weather information,music control, remote camera control compatible with Android 5.0 and above or iOS 9.0 and above smartphones.

2. Enable the required Gateway Intents

DiscordSRV’s documentation requires the privileged Gateway Intents used by the plugin. In the bot settings, enable every privileged intent identified by the current DiscordSRV instructions, then save the change. If an intent is missing, the bot may appear online while message bridging, member data, synchronization, or presence-related features fail.

Do not assume that an online status proves the intents are correct. Verify the toggles in the Developer Portal whenever DiscordSRV reports missing events or behaves as though it cannot read the required Discord data.

3. Add the bot to your Discord server

Use the application’s installation flow to add the bot to the Discord server where you want the bridge. Select the server deliberately: adding the bot to a different server will not make the Minecraft channel mapping work. During installation, grant the read and send permissions documented by DiscordSRV for the channels it must bridge. If you intend to synchronize additional features, grant only the extra permissions that the relevant DiscordSRV documentation calls for.

After installation, confirm that the bot is visible in the intended server and that it can access the target channels. A bot that can connect but cannot read or send in a channel will produce an apparently partial setup.

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

Map Minecraft channels to Discord channels

Channel mapping is configured in plugins/DiscordSRV/config.yml. The left side of each mapping is a Minecraft channel name; the right side is the numeric Discord channel ID. Discord channel names do not belong on the right side.

1. Turn on Discord Developer Mode

  1. Open Discord’s user settings.
  2. Find the advanced settings and enable Developer Mode.
  3. Return to the target Discord text channel.
  4. Right-click the channel and choose Copy ID.
  5. Repeat for every Discord channel you want to map.

The copied value is a long numeric string. Copy it exactly, including every digit, and do not add a channel name, hashtag, or quotation mark outside the configuration syntax.

Rank #3
New Bee Guitar Cable 10ft Electric Instrument Bass AMP Cord
  • [Low Noise High Fidelity] New bee guitar cord with 22AWG oxygen-free-copper center conductors provides enhanced signal transfer, the PVC insulation material and the high-density stranded copper double shield provide noise rejection for quiet operation
  • [Ideal for Choice] New bee 1/4 straight and right angle metal connectors, ensures a secure connection in any instrument, pedal, or amp jack. L shape great fro on stage guitar stands
  • [Wide Compatible] Suitable for mixer, power amplifier, microphone, effector, decoder, equalizer, electoronic organ, electric guitar, electric bass and other electronic equipments. Widely used in the installation of smart home, karaoke speaker, professional stage audio, etc
  • [Easy Disassemble] Making incidental repairs quick and easy! Very nice, flexible cable
  • [Dont Hesite to Order] 24 hours customer services and professional technology team are standing by

2. Edit the Channels setting

The documentation’s example format is:

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

In this example, Minecraft’s global channel maps to Discord channel ID 219559668236681216, while Minecraft’s admin channel maps to 221419146028646401. Your actual Minecraft channel names and Discord IDs will differ.

The first channel pair is the main channel. Start with the main public chat before adding administrative or specialty channels. Keep the mapping on one valid YAML line unless the version of the generated configuration explicitly shows another supported layout.

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

3. Check permissions for every mapped channel

The bot must be able to read and send in each mapped Discord channel. A server-wide role permission can still be overridden by a channel-specific deny, a category permission, or a private-channel restriction. Check the effective permissions on the exact channels whose IDs you copied.

After editing YAML, save the file without changing indentation or inserting smart quotes. Some DiscordSRV changes can be loaded with a reload, but settings documented as restart-dependent require a full server restart.

Configure the invite and test the bridge

Set an invite link (optional)

If you want DiscordSRV to show an invitation to your community, configure DiscordInviteLink in config.yml. Leave it unset if you do not want the plugin to advertise an invite. Use an invite that points to the same Discord server where the bot is installed.

Run the player-facing commands

Once the server has restarted and the bot is online, test from Minecraft:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #4
BSIMB 15.6" Digital Family Calendar & Chore Chart, No Subscription Fees
  • Digital Family Calendar: BSIMB digital calendar wall touch screen puts an end to your chaotic life. Designed for busy families, the digital calendar keeps you organised and in step with your family. Assign different colours and tasks to each family member to make family scheduling easier and more intuitive.
  • Easy Setup and Auto-Sync: Plug in, connect to WLAN and auto-syn your electric calendar in minutes. Digital wall calendar compatible with Google calendar, iCloud calendar, Outlook calendar, Cozi calendar and Yahoo calendar. Add events directly on the device or through the ecalendar app. Electronic calendar stays current whether you're at work or traveling—no manual updates needed.
  • All-In-One Home Assistant: Smart calendar builds habits and encourage independence with personalised chores. Display daily meal plan to reduce the daily ‘What's for dinner?’ stress. To-do lists keep track of everything you want. Turning chores into valuable achievements with stars and rewards, making life easier and more enjoyable.
  • Manage Anytime Anywhere: BSIMB electronic calendar for family stay connected with the powerful ecalendar app. Access and manage your digital wall calendar anytime, anywhere with free features like stars & rewards, photo screensaver, chore charts, meals plans, to-do lists etc. Electronic planner paid features like Magic Import tailor advanced tools for users with special needs.
  • Stay in Touch with Loved Ones: Share photos or videos from your phone to electronic wall calendar with app, instantly update your life moment, and keep in touch with your family, especially those who are far away; you can also surprise your smart calendar digital wall by sending him a wish card; it's also great for keeping tech-illiterate elders in touch with the youngsters.
  • /discord or /discordsrv opens DiscordSRV’s general player information or invite response.
  • /discordsrv link displays the account-linking instructions for the player.
  • /discordsrv linked checks whether the executing player is linked.

Send a normal message in the mapped Minecraft channel and verify that it appears in the mapped Discord channel. Reply in Discord and verify the reverse direction. Test with a player account that has the same ordinary permissions as your community members; an administrator can mask a missing channel permission.

Staff and diagnostic commands

Staff permissions include commands that help maintain the bridge:

  • /discordsrv resync requests a synchronization operation when Discord and Minecraft state have diverged.
  • /discordsrv reload reloads settings that support reloading without a full restart.
  • /discordsrv debugger enables diagnostic output for relevant categories, including message flow, group synchronization, presence, or voice behavior.

Grant these commands only to trusted staff. Use the debugger while reproducing a problem, capture the relevant console output, and then disable or reduce diagnostic logging when finished so routine logs remain readable.

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

Enable Minecraft-to-Discord account linking

Account linking is optional by default. Linking associates a Minecraft player with a Discord account so DiscordSRV can identify the same person across both services and apply features that depend on that association.

Let players link voluntarily

  1. Make sure the bot is online and can send messages in the Discord channel where players will receive instructions.
  2. Have the player run /discordsrv link in Minecraft.
  3. Follow the code-and-instruction flow DiscordSRV displays for that player.
  4. After completion, have the player run /discordsrv linked to confirm the status.

If the player receives no instructions, check the bot’s channel permissions, the bot token and intents, and the server console for a linking error. Linking cannot complete if the bot cannot communicate with the player through the configured Discord server.

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

Require linking before players can join

DiscordSRV can prevent unlinked players from entering the Minecraft server. This is separate from voluntary linking and should be enabled only when every player is expected to have access to the required Discord server and bot.

Enable the gate

  1. Open plugins/DiscordSRV/linking.yml.
  2. Set Enabled: true.
  3. Save the file.
  4. Restart the Minecraft server; do not rely on a reload for a setting documented as restart-dependent.

When an unlinked player tries to join, DiscordSRV kicks that player with a message containing instructions and a code to send to the bot. The player must complete the linking flow and try joining again.

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

Add Discord-server or role requirements

The linking configuration can additionally require that a linked player belong to selected Discord servers and/or hold specified subscriber roles. These checks are useful when access should be limited to members of a particular community or role group, but they add another failure point: a player can be successfully linked and still be rejected if the required server membership or role is absent.

Before enabling these restrictions, document which Discord server and roles are required, make sure the bot can inspect the relevant membership information, and test with one ordinary player account. Keep an administrator or emergency account available so staff are not locked out by a mistaken requirement.

Troubleshoot the most common failures

The plugin does not load

  • Confirm that the JAR is directly inside the server’s plugins directory, not in a subfolder.
  • Check that the filename is a complete DiscordSRV build JAR rather than a partial upload or archive.
  • Restart the server and inspect the startup log for the first DiscordSRV error.
  • Verify that the server software is CraftBukkit, Spigot, Paper, or another platform whose Bukkit API compatibility has been confirmed.

If no DiscordSRV folder is generated after a restart, focus on the startup log and file placement before editing configuration. The configuration directory is created by a successful first load.

The bot is offline or messages never arrive

  • Recheck the bot token in the generated DiscordSRV configuration.
  • Verify the required privileged Gateway Intents in the Discord Developer Portal.
  • Confirm that the bot was installed in the intended Discord server.
  • Check that the bot can read and send in the exact mapped channels.
  • Use /discordsrv debugger with the message-flow category while sending a test message.

An online bot with no bridged messages usually indicates a token, intent, channel-ID, or permission problem rather than a Minecraft client problem.

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.

Messages go to the wrong channel

  • Enable Developer Mode and copy the ID from the intended Discord channel again.
  • Check that the left side of each Channels entry uses the Minecraft channel name.
  • Check that the right side uses the numeric Discord ID, not a readable Discord channel name.
  • Confirm that the first channel pair is the one you intend to use as the main channel.
  • Save the YAML and perform the restart required for the changed setting.

Reload appears to do nothing

/discordsrv reload does not replace a full restart for settings that DiscordSRV documents as restart-dependent. If a change to channel mapping, linking enforcement, or another setting has no effect after reload, stop the server cleanly and start it again, then inspect the startup log.

Linking or mandatory linking fails

  • Confirm that the bot can send the linking instructions and receive the player’s response.
  • Have the player run /discordsrv link again and use the newly displayed code.
  • Use /discordsrv linked to distinguish an unlinked account from a completed link.
  • If server or role requirements are enabled, verify membership in every required Discord server and possession of each required role.
  • Temporarily test with the additional membership and role restrictions disabled, then re-enable them one at a time to isolate the failing requirement.

Choose an appropriate setup policy

Policy choice Best fit Operational consequence
Optional linking Public or mixed communities where Discord is helpful but not mandatory Players can join without a Discord account; linked features remain opt-in
Mandatory linking Communities that require Discord identity or moderation access Unlinked players are kicked with instructions and must complete the code flow before joining
Mandatory linking plus server or role checks Private communities with membership or subscriber-role rules A player must be linked and satisfy every configured Discord membership condition

When selecting managed Minecraft server hosting, verify DiscordSRV compatibility for the host’s Bukkit-based software and confirm that you can upload JAR files, edit config.yml and linking.yml, read logs, and perform full restarts. A host that offers only limited plugin installation or no console access will make diagnosis difficult.

Recommended first-run checklist

  1. Confirm the server runs CraftBukkit, Spigot, or Paper and that you can edit files and read logs.
  2. Place the DiscordSRV build JAR directly in plugins.
  3. Restart and verify that the plugins/DiscordSRV directory and configuration files appear.
  4. Create the Discord application and bot.
  5. Disable User Install and set Install Link to None in the application’s Installation tab.
  6. Enable the privileged Gateway Intents required by the current DiscordSRV documentation.
  7. Add the bot to the correct Discord server with the documented read and send permissions.
  8. Enable Discord Developer Mode and copy the numeric IDs of the target channels.
  9. Map Minecraft channel names to those IDs in config.yml.
  10. Configure DiscordInviteLink only if you want an invite shown.
  11. Restart, test both Minecraft-to-Discord and Discord-to-Minecraft messages, and inspect logs for errors.
  12. Test /discordsrv link and /discordsrv linked with a normal player account.
  13. If required, set Enabled: true in linking.yml, configure any membership or role checks, and restart before testing the join gate.

With those steps complete, DiscordSRV has the four pieces it needs: a Bukkit-compatible plugin installation, a working Discord bot, correctly mapped numeric channel IDs, and permissions that match the features you enabled.

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 from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Outdated Drivers Are Slowing You DownFree scan - exact matches
Windows Errors? Fix Them Before They SpreadFree repair 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.