MineBridge

MineBridge

Connect your Minecraft server with Discord. Bridge conversations, share gameplay events, and keep your community connected.

MineBridge is a Minecraft × Discord integration plugin designed to connect your in-game community with your Discord server through real-time communication and automated event notifications.

Features

Discord ↔ Minecraft Integration

• Two-way Minecraft and Discord chat relay.
• Configurable Discord channel filtering.
• Bot and webhook message filtering.
• Message sanitization and Discord mention suppression.
• Secure bot token configuration through environment variables.

Death Messages

• Automatic player death detection.
• Player-versus-player kill notifications.
• Mob-related death notifications.
• Environmental death detection, including lava, fire, drowning, falls and void.
• Customizable Minecraft death messages.
• Rich Discord death notification embeds.

Achievement & Advancement Announcements

• Automatic Minecraft advancement detection.
• Story, Nether, End, Adventure and Husbandry advancement classification.
• Special challenge completion announcements.
• Customizable Minecraft announcement messages.
• Rich Discord achievement embeds.
• Configurable notification categories.

Discord Notification System

• Rich Discord embeds for supported gameplay events.
• Configurable notification channels.
• Asynchronous Discord message delivery.
• Markdown escaping and mention suppression.
• Configurable event notification settings.

Administration & Reliability

• Administrative status and configuration reload commands.
• Bounded message queue and serialized Discord sends.
• Connection readiness checks.
• Improved diagnostics and shutdown handling.
• Duplicate event notification suppression.

Requirements

• Minecraft Java Edition server.
• Paper or compatible Spigot-based server.
• Java 21 or compatible runtime for the plugin build.
• Discord bot with appropriate permissions.
• Discord Message Content Intent enabled for chat relay.

Installation

1. Download MineBridge-1.2.x.jar from the Versions section.
2. Stop your Minecraft server.
3. Place the JAR inside your server's plugins directory.
4. Start the server to generate the configuration.
5. Configure your Discord bot token and notification channel IDs.
6. Use /minebridge status to verify the connection.

For better token security, configure the MINEBRIDGE_BOT_TOKEN environment variable. Never share your Discord bot token publicly.

Commands & Permissions

MineBridge provides administrative status and configuration reload commands.

Administrative access uses the minebridge.admin permission, which defaults to server operators.

Refer to the project README for detailed command usage and configuration instructions.

Compatibility & Technology

• Java 21
• Spigot API 1.20.6
• JDA 5.6.1
• Gradle build system

Security

MineBridge includes message sanitization, Discord mention suppression, and secure environment-based token configuration.

Automated dependency vulnerability scanning has not yet completed. No clean vulnerability-audit result is claimed.

Release Information

Current version: 1.2.x

Release highlights:

• Death Messages integration.
• Achievement & Advancement announcements.
• Discord gameplay event embeds.
• Improved event handling and notification reliability.

Source Code: github.com/aridrochatterjee/Minebridge