Skip to content
Aridro Chatterjee edited this page Nov 15, 2026 · 1 revision

Frequently Asked Questions

General

What is MineBridge?

MineBridge is a Minecraft plugin that connects your Minecraft server with Discord. It provides chat integration and announcements for various in-game events.

Is MineBridge free?

Check the GitHub repository for the current license and distribution details.

Where can I download MineBridge?

You can find MineBridge on:

Installation and Setup

Which Minecraft server software does MineBridge support?

MineBridge is designed for Bukkit-compatible Minecraft servers. It has been tested on Paper and Purpur.

Compatibility with other server software may vary.

Where is the configuration file?

After starting the server with MineBridge installed, find the configuration file at:

plugins/MineBridge/config.yml

How do I connect my Discord bot?

  1. Create a Discord application in the Discord Developer Portal.
  2. Add a bot to your application.
  3. Copy the bot token.
  4. Add the token to the MineBridge configuration.
  5. Set the Discord channel ID.
  6. Restart your Minecraft server.

For better security, use the MINEBRIDGE_BOT_TOKEN environment variable instead of putting your token directly in the configuration file.

Do I need to restart the server after changing the configuration?

A restart is the safest way to ensure configuration changes are applied. Check the command documentation before relying on a reload.

Features

Can MineBridge relay Minecraft chat to Discord?

The configuration includes a chat-relay feature toggle. Enable it in config.yml to use the configured chat-relay functionality.

Can MineBridge announce player deaths?

Yes. The configuration includes death-message settings for Minecraft and Discord, with separate categories for different causes of death.

Does MineBridge support advancement announcements?

Yes. MineBridge includes advancement and challenge announcement settings, including category controls.

Can I use different Discord channels for different events?

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.

Can I customize announcement messages?

Yes. The configuration supports customizable message formats and placeholders. Check the comments in config.yml for the placeholders available to each message.

Commands and Permissions

What is the main command?

The plugin declares:

/minebridge

It also provides the alias:

/mb

What permission does MineBridge use?

The declared administrative permission is:

minebridge.admin

Its default permission level is operator.

Troubleshooting

Why is my Discord bot not connecting?

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.

Why are announcements not appearing?

Check that the relevant feature is enabled and that the Discord bot has the required channel permissions.

Also check your server console for errors.

Where can I report bugs?

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

Security

Is it safe to share my bot token?

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.

Clone this wiki locally