Перейти к содержимому
Mineforgian

DiscordSRV

The most powerful, configurable, open-source Discord to Minecraft bridging plugin available.

460K загрузок833 подписчиковGPL-3.0-or-laterbukkitfoliapaperpurpurspigot

Обновлён 24 апреля 2026 г. · опубликован 14 августа 2022 г.

DiscordSRV

The most powerful, configurable, open-source Discord bridge plugin out there.

Supports All Minecraft Versions from 1.7.9 to 26.2

We only give support for the latest release/dev builds; please update before asking for help

Features

  • Bridge between Minecraft and Discord chats
  • Forward your Minecraft Console to a Discord text channel and execute commands from Discord
  • Broadcast alerts based on certain events (alerts.yml)
  • Voice Proximity through the Discord Voice Chat (voice.yml)
  • Require linking accounts (or certain role/s) to play (linking.yml)
  • Link your Minecraft account to your discord account (config.yml & synchronization.yml)
    • Minecraft group <-> Discord role sync
    • Minecraft (display) name -> Discord (nick) name sync
    • Minecraft <-> Discord ban sync
    • Rewarding players (for being in the Discord server / boosting etc)
    • Knowing who's who (with /discord linked, verification)
    • Administrative purposes
  • Supports many languages
  • Chinese, Danish, Dutch, English, Estonian, French, German, Japanese, Korean, Polish, Russian, Spanish, and Ukrainian
  • Support for popular chat plugins (listed below)
  • Highly customizable

Plugins we hook into:

Plugins that use our API:

Intended usage

By using this plugin, you are able to give players the ability to chat in-game with players on your Discord server, as well as having people on the Discord server be able to chat with people in the minecraft server - This can be useful for players that still want to communicate with players in-game, but can't access the Minecraft server for whatever reason.

This plugin has a remote console feature. You can designate a text channel for the plugin to forward console messages, which also runs all messages sent into that channel as commands by the server console (You should restrict sending this channel to a developer or high ranking role only). Due to how Discord's permissions work, you can have some server roles have access to see the console, while also not allowing them to send messages in that channel, thus creating a read-only console for trusted staff members.

Both chat and console are toggleable through the configuration file. Some options can be refreshed with /discordsrv reload by an OP or a player with the discordsrv.reload permission.

Bot Permissions

Server Permissions

Permission Features
Manage Roles role synchronization and adding roles to linked players
Manage Channels channel topic updater and the voice module
Ban Members ban synchronization
Manage Nicknames nickname synchronization
Manage Webhooks experimental webhook usage
(Server-wide permission is recommended, but can be applied on a per-channel basis)

Channel Permissions

Permission Features
Read Text Channels & See Voice Channels Required for DiscordSRV's channel options (including console and voice lobby), the voice module category and any other channels you want for canned responses
and Send Messages
Manage Messages when messages are deleted by playerlist & chat channel commands
Embed Links optionally for embedding ingame-posted links and required when embed messages are used death, join/Leave
Mention @everyone, @here and All Roles for mentioning @everyone if added to allowed mentions in config.yml and mentions enabled
Add Reactions and Read Message History for when the bot reacts with "💬" and "❗" to notify a truncated message is being sent from Discord to Minecraft
Move Members, Mute Members and Manage Permissions required for the voice lobby and voice category

Installation

Visit the Installation page for clear and in-depth instructions on installing and setting up DiscordSRV.

Donations

First off, thank you from the bottom of my heart for the pizza. If you would like to donate, go to https://scarsz.me/donate. $10 is the suggested amount but you can donate however much you would like- anything is a massive thank you from me. In the note put your Discord username and if you're in DiscordSRV's server you'll be set as a donator and you'll receive some neat perks in the future. If you donated without the note, send me a PM on Discord and I'll manually check it.

Developers

If you want to interface DiscordSRV with your plugin, you can do so by adding the Maven dependency or adding the plugin jar (DiscordSRV version 1.18.0+) to your project. You also need to add the JDA repository. For an example of this, see DiscordSRV-ApiTest. Be sure to add "DiscordSRV" to your plugin's plugin.yml depends/softdepends list.

Maven

<repository>
    <id>Scarsz-Nexus</id>
    <url>https://nexus.scarsz.me/content/groups/public/</url>
</repository>  
...  
<dependency>
    <groupId>com.discordsrv</groupId>
    <artifactId>discordsrv</artifactId>
    <version>1.29.0</version>
    <scope>provided</scope>
</dependency>

Gradle

repositories {
    maven { url 'https://nexus.scarsz.me/content/groups/public/' }
}  
dependencies {
    compileOnly 'com.discordsrv:discordsrv:1.29.0'
}

Data usage

Data collection

Anything and everything shown at https://bstats.org/plugin/bukkit/DiscordSRV will be visible to the public with your server included in the statistics. This is only for statistics; no private information of your server is sent. If you don't want your server included in this, specify the config option MetricsDisabled and set it to true in the config.yml file.

Update checking

DiscordSRV checks for updates using GitHub's API, and makes sure the version is safe to use via a minimum version (security feature), you may disable update checking by setting UpdateCheckDisabled to true in the config.yml file; however this may leave your server at risk if there is a security issue/exploit and you're running a vulnerable version.

Версии

ВерсияКаналИграЗагрузчикиДатаСкачать
1.30.5Релиз26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, purpur, spigot24 апреля 2026 г..jar (10.2 МБ)
1.30.4Релиз1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, folia, paper, purpur, spigot16 января 2026 г..jar (10.1 МБ)
1.30.3Релиз1.21.7, 1.21.8, 1.21.9, 1.21.10bukkit, folia, paper, purpur, spigot2 декабря 2025 г..jar (10.1 МБ)
1.30.2Релиз1.21.7, 1.21.8, 1.21.9, 1.21.10bukkit, folia, paper, purpur, spigot27 октября 2025 г..jar (10.1 МБ)
1.30.1Релиз1.21.7, 1.21.8, 1.21.9, 1.21.10bukkit, folia, paper, purpur, spigot8 сентября 2025 г..jar (10.0 МБ)
1.30.0Релиз1.21.5, 1.21.6, 1.21.7, 1.21.8bukkit, folia, paper, purpur, spigot26 июля 2025 г..jar (10.0 МБ)
1.29.0Релиз1.21.5, 1.21.6, 1.21.7, 1.21.8bukkit, folia, paper, purpur, spigot16 ноября 2024 г..jar (9.9 МБ)
1.28.0Релиз1.20.6, 1.21, 1.21.1, 1.21.2bukkit, folia, paper, purpur, spigot3 августа 2024 г..jar (9.9 МБ)
1.27.0Релиз1.20.4, 1.20.5, 1.20.6, 1.21bukkit, folia, paper, purpur, spigot5 января 2024 г..jar (9.8 МБ)
1.26.2Релиз1.19.4, 1.20, 1.20.1, 1.20.2bukkit, paper, purpur, spigot20 марта 2023 г..jar (9.7 МБ)
1.26.1Релиз1.19, 1.19.1, 1.19.2, 1.19.3bukkit, paper, purpur, spigot20 февраля 2023 г..jar (9.7 МБ)
1.26.0Релиз1.18.2, 1.19, 1.19.1, 1.19.2bukkit, paper, purpur, spigot20 сентября 2022 г..jar (9.5 МБ)
1.25.1Релиз1.18.2, 1.19, 1.19.1, 1.19.2bukkit, paper, purpur, spigot14 августа 2022 г..jar (9.4 МБ)

Ченджлог

1.30.5Релиз26.1.1, 26.1.2, 26.2 · 24 апреля 2026 г.

Fixes

  • NMS issue with GameProfiles on MC 26.x (Thanks Prum)
1.30.4Релиз1.21.9, 1.21.10, 1.21.11 · 16 января 2026 г.

Fixes

  • Advancements not working due to 1.21.11 game rule changes (Thanks Prum)
1.30.3Релиз1.21.8, 1.21.9, 1.21.10 · 2 декабря 2025 г.

Certain PlaceholderAPI expansions that are unsafe with player input could previously cause unintended behavior. We recommend updating as soon as possible to prevent misuse.

Fixes

  • Fixes to MiniMessage formatting in Discord to Minecraft
  • Ignore cancelled PlayerDeathEvent (#1818)
1.30.2Релиз1.21.8, 1.21.9, 1.21.10 · 27 октября 2025 г.

Fixes

  • Conflict with EssentialsX custom whitelist message and required linking
  • Advancement messages showing up incorrectly on 1.21.9+
  • Non-command Bukkit event triggers not working
  • Duplicated command events when there are any non-fully qualified class names
  • Typo "it's" to "its" where you want the possessive pronoun

Developers

  • Update adventure to 4.25.0
1.30.1Релиз1.21.8, 1.21.9, 1.21.10 · 8 сентября 2025 г.

Fixes

  • Command triggers not sending in alerts.yml
  • A error when sending a message that replies to another message in a voice text channel
1.30.0Релиз1.21.6, 1.21.7, 1.21.8 · 26 июля 2025 г.

Alerts now requires fully qualified class names for event triggers. Read https://docs.discordsrv.com/alerts/migration for more information

Additions

  • Add support for MultiverseCore API v5 (Fixes errors when using MV5)
  • Translation for Norsk Bokmål (nb-NO) (Thanks OPM/Expert)
  • PlaceholderAPI placeholder for roles by id

Fixes

  • Clickable text on 1.21.5+
  • Custom emojis not being translated in webhook messages
  • NullPointerException when a player joins when the account link manager hasn't been created yet
  • Fix "Could not find org.bukkit.craftbukkit.advancement.CraftAdvancement" on 1.8.8

Changes

  • Alerts for events now need to be specified using fully qualified class names
  • Debugger: Include " /discord" lines in relevant log lines. (#1765)

Developers

  • Include author in DiscordGuildMessagePreBroadcastEvent
  • Updated to adventure 4.23.0
1.29.0Релиз1.21.6, 1.21.7, 1.21.8 · 16 ноября 2024 г.

Additions

  • Chatty v3 support (Thanks, sub-kek)
  • Discord -> Minecraft message format options now support a %userid% placeholder (Thanks, fres621)

Fixes

  • Edge case with custom hidden advancements throwing an error
  • [Paper and forks only] output from chat channel console command commands not being captured when the plugin implementing the command uses Adventure (Thanks, sub-kek)
  • Discord messages from hooked chat plugins that were broadcasted to console no longer show an unparsed %chatcolor% placeholder
  • Alerts used to not work for events that shared their HandlerList (Thanks, tangjin0418)
  • "Message blocked by harmful links filter" error spam when a user sends a harmful link through minecraft chat that is blocked by discord
  • Fix issues with 1.21.3+ sound changes (#1773)

Changes

  • Web proxy options now apply to websocket proxy settings
  • Changed the default ProxyHost value to not include a scheme in the url. This option only works when using just the domain name (example.com) or just an ip address (127.0.0.1)
We recently created a form for appealing a ban from our Discord support server. If you’ve been banned (and especially if your account was hacked) you can request an unban here: https://discordsrv.com/discord/ban-appeal
1.28.0Релиз1.21, 1.21.1, 1.21.2 · 3 августа 2024 г.

Additions

  • Web proxy support (Thanks, ItzMiracleOwO)
  • Norwegian translation (Thanks, RemixedX)
  • %discordsrv_user_boost_status% PlaceholderAPI placeholder for user boost status (Thanks, thewilloftheshadow)
  • PAPI placeholders for filtered top Role
  • Support for competing and custom bot statuses (Thanks, PadowYT2)

Fixes

  • Discord regexes not being applied to attachment URLs
  • NullPointerException when getting console channel ID
  • Advancements not being displayed in chat with their proper names
  • Formatting issue with reply messages
  • Linked accounts not being migrated to the new format on first restart
  • Advancement messages not sending on some 1.17.x-1.18.x paper versions
  • MySQL driver deprecation error on Paper
  • Potential data loss when using file for linked accounts
  • "Unknown Message" errors after deleting a message in the console channel
  • Grammatical error in French translation (Thanks, PtitLegume)
  • Errors in console on join, leave, death and advancement on 1.20.6 Minecraft
  • Issues with hover and click components
  • Fixed category option blank check in voice module (Thanks, Bermiin)
  • Fixed false error message for AvatarUrls using {texture} placeholder on offline servers
  • I/O error that would appear when shutting down the server
  • New linked accounts file format not saving correctly
  • Errors when message in link channel is deleted
  • Linked accounts not being properly removed if player's UUID started with a digit
  • Corrected a few Japanese translations (Thanks, renorari)

Changes

  • All legacy color codes are now stripped from PlaceholderAPI placeholder values
  • Improved Chinese translation (Thanks, SamLam140330)
  • Switched default avatar image provider to crafthead.net due to issues with Crafatar
  • AvatarUrl values using Crafatar will be automatically reset to defaults during config migration as Crafatar doesn't allow usage with Discord anymore
  • Improved French translation (Thanks, PtitLegume)

Removals

  • Comments with usernames in account links file
  • Removed DebugLevel option & /discord debug in favor of newer /discord debugger command

Developers

  • Stopped shading in old JetBrains annotations
  • Lombok has been removed from all API classes

Полная история изменений — на Modrinth.

Комментарии

Загружаем…