Minecraft plugin DiscordSRV

🔌 About DiscordSRV

DiscordSRV is a Minecraft plugin that links a Minecraft server and a Discord server. It forwards in-game chat to Discord (and Discord messages to the game), supports account linking between Minecraft and Discord accounts, and provides synchronization hooks for roles/groups and several server events.

🎯 Purpose

DiscordSRV's core purpose is to provide a reliable, configurable bridge between a Minecraft server and Discord so communities can communicate across both platforms, keep staff informed, and synchronize membership/role information when configured.

⚙️ Features

• Two-way chat synchronization between Minecraft and Discord channels (configurable per-channel).
• Minecraft <-> Discord account linking for players.
• Role/group synchronization hooks (integration points for permission plugins such as LuckPerms).
• Broadcast and staff messaging from Minecraft to Discord.
• Commands for linking, checking link status, and administrative actions (reload, resync, debug).
• Multiple configuration files for channel mapping, language/messages, synchronization, and voice features.
• Open-source code with a public issue tracker and releases.

🧩 Who It Is For

• Server owners and admins who want to unify community chat across Minecraft and Discord.
• Moderation teams who need server event visibility in Discord.
• Networks using permissions plugins that want role or group synchronization with Discord.

🏗️ Example Use Cases

• Forwarding global or per-channel Minecraft chat to specific Discord channels so off-server users follow conversations.
• Linking player accounts to Discord IDs to grant Discord roles or verify users across platforms.
• Sending server join/leave/console logs to a Discord moderation channel.

⌨️ Commands

Player subcommands:

Staff commands:

(Deprecated commands related to the old subscription system are documented in history but removed from current operation.)

🔐 Permissions

⚙️ Installation

📥 Setup

• Download the official DiscordSRV .jar from an official distribution (project page / catalog / releases).
• Place the jar into your server plugins/ folder for a Bukkit/Spigot-compatible server.
• Restart the server and check console logs to confirm DiscordSRV loaded.
• Complete initial configuration (bot token, channel mappings, linking options) using the generated configuration files.

📦 Configuration files

DiscordSRV uses multiple configuration files; confirmed filenames include:

• config.yml
• messages.yml
• linking.yml
• synchronization.yml
• voice.yml
• alerts.yml

Edit the appropriate files to set the Discord bot token, channel mappings, and synchronization settings. Some features (role/group sync, voice integration) require additional configuration.

🧠 Technical Notes

• Source code and releases are maintained on a public repository.
• The project is published under GPL-3.0.
• Confirmed optional integrations include LuckPerms (contexts/group sync) and PlaceholderAPI (placeholders).
• Commands and permissions are documented in the official documentation; administrative operations like resync and reload exist and may require operator privileges.

🤝 When This Plugin Is Useful

If you need consistent, configurable two-way chat and account linking between a Minecraft server and a Discord community, DiscordSRV provides the bridge, integration hooks, and configuration files to operate those features while integrating with common server plugins.