Repository navigation
FAQ
MineBridge is a Minecraft plugin that connects your Minecraft server with Discord. It provides chat integration and announcements for various in-game events.
Check the GitHub repository for the current license and distribution details.
You can find MineBridge on:
MineBridge is designed for Bukkit-compatible Minecraft servers. It has been tested on Paper and Purpur.
Compatibility with other server software may vary.
After starting the server with MineBridge installed, find the configuration file at:
plugins/MineBridge/config.yml
- Create a Discord application in the Discord Developer Portal.
- Add a bot to your application.
- Copy the bot token.
- Add the token to the MineBridge configuration.
- Set the Discord channel ID.
- Restart your Minecraft server.
For better security, use the MINEBRIDGE_BOT_TOKEN environment variable instead of putting your token directly in the configuration file.
A restart is the safest way to ensure configuration changes are applied. Check the command documentation before relying on a reload.
The configuration includes a chat-relay feature toggle. Enable it in config.yml to use the configured chat-relay functionality.
Yes. The configuration includes death-message settings for Minecraft and Discord, with separate categories for different causes of death.
Yes. MineBridge includes advancement and challenge announcement settings, including category controls.
The configuration provides channel ID fields for several event groups. Leave an event-specific channel ID blank where the configuration says it will use the default Discord channel.
Yes. The configuration supports customizable message formats and placeholders. Check the comments in config.yml for the placeholders available to each message.
The plugin declares:
/minebridge
It also provides the alias:
/mb
The declared administrative permission is:
minebridge.admin
Its default permission level is operator.
Check the following:
- Your bot token is correct.
- The bot has been invited to your Discord server.
- The configured channel ID is correct.
- The bot has permission to access the channel.
- Your server has a working internet connection.
Check that the relevant feature is enabled and that the Discord bot has the required channel permissions.
Also check your server console for errors.
Open an issue on the MineBridge GitHub Issues page.
When reporting a bug, include:
- MineBridge version
- Minecraft server software and version
- Java version
- Relevant console errors
- Steps to reproduce the issue
No. Your Discord bot token is a secret credential.
Never share it publicly, upload it to GitHub, or include it in screenshots. If it becomes exposed, regenerate it through the Discord Developer Portal.
Getting Started
Documentation
Support
Developers
[GitHub Repository](https://github.com/aridrochatterjee/Minebridge)
[Modrinth Page](https://modrinth.com/plugin/minebridge)