DiscordSRV

The most powerful and fully customizable open-source bridge plugin between Discord and Minecraft.

Supports all Minecraft versions from 1.7.9 to 1.21.x

We provide support only for the latest releases and dev builds; please update the plugin before seeking help

Main Features

Create seamless connectivity between your game server and Discord community:

• Two-way chat - communication between Minecraft players and Discord members
• Console forwarding - sending server console messages to a Discord text channel
• Voice proximity - realistic voice communication considering distance between players (configured via voice.yml)
• Account linking - requiring Discord account linking to play on the server (configured via linking.yml)
• Automatic notifications - alerts about various game events
• Flexible configuration - numerous configuration options for any needs

Compatibility with Other Plugins

Chat Systems

Integration with popular chat plugins: Herochat, LegendChat, LunaChat, TownyChat, VentureChat

Vanish Systems

Support for player hiding plugins: Essentials, PhantomAdmin, SuperVanish, VanishNoPacket

Other Systems

• Multiverse - support for multiverses
• Vault - integration with economic systems
• LuckPerms - working with permission systems
• PlaceholderAPI - using placeholders

Practical Application

DiscordSRV allows players to communicate between Minecraft and Discord, which is especially useful for those who temporarily cannot access the game server. Remote console enables monitoring and managing the server through Discord, while different access levels can be configured for various roles.

All chat and console functions can be enabled/disabled through configuration files. Some settings can be reloaded using the /discordsrv reload command.

Discord Bot Permissions

Server-level Permissions

• Manage Roles - role synchronization and adding roles to linked players
• Manage Channels - updating channel topics and voice module operation
• Ban Members - ban synchronization between Discord and Minecraft
• Manage Nicknames - synchronization of game names
• Manage Webhooks - using experimental webhook functionality

Channel-level Permissions

• Read and Send Messages - basic permissions for core functions
• Manage Messages - deleting messages with player list and console commands
• Embed Links - for displaying links and embed messages
• Mention @everyone - for mass notifications
• Add Reactions - for notifications about truncated messages
• Manage Members - for voice module operation

Installation

Detailed instructions for installing and configuring DiscordSRV are available in the official documentation.

For Developers

To integrate with DiscordSRV, add the Maven dependency or plugin jar file (version 1.18.0+) to your project. Usage examples can be found in the DiscordSRV-ApiTest repository. Don't forget to add "DiscordSRV" to your plugin's dependency list in plugin.yml.

Maven

<repository>
    <id>Scarsz-Nexus</id>
    <url>https://nexus.scarsz.me/content/groups/public/&lt;/url&gt;
</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 Collection

DiscordSRV collects anonymous usage statistics displayed on bstats.org. This information is used only for analytics and doesn't contain server private data. Statistics collection can be disabled by setting the MetricsDisabled parameter to true in the config.yml file.

Update Checking

The plugin automatically checks for updates via GitHub API and ensures security through the minimum version system. Update checking can be disabled by setting UpdateCheckDisabled to true, but this may leave the server vulnerable if security issues are discovered.