Help & Troubleshooting Guide

Quick solutions for common MC-Discord Bridge issues

← Back to Dashboard

Quick Navigation

Bot Shows as Offline

Problem:

Your Discord bot appears offline in the server member list or shows as disconnected in the dashboard.

Quick Fix:

This usually means the bot token is invalid or the bot hasn't been added to your server.

Step-by-Step Solution:

  1. Verify Bot Token: Go to Discord Developer Portal
  2. Select your application → Bot section
  3. Click "Reset Token" to generate a new token
  4. Copy the new token (you'll only see it once!)
  5. Update your bridge configuration with the new token
  6. Save and wait 10-15 seconds for reconnection

Pro Tip:

If you recently changed the token, it can take up to 30 seconds for the bot to reconnect. Check the dashboard for the connection status.

Messages Not Sending to Discord

Problem:

Messages from Minecraft aren't appearing in your Discord channel.

Common Causes & Solutions:

Quick Checklist:

  • Bot is online in Discord (check member list)
  • Correct channel ID in configuration
  • Bot has "Send Messages" permission
  • Bot has "Embed Links" permission
  • Channel isn't restricted (bot can see it)
  • Bridge name matches in Minecraft config

How to Get Correct Channel ID:

  1. Enable Developer Mode: Discord Settings → Advanced → Developer Mode
  2. Right-click on your channel
  3. Select "Copy Channel ID"
  4. Paste this ID in your bridge configuration

Common Mistake:

Using the channel name instead of the ID. You need the numeric ID (like 123456789012345678), not the channel name (like #general).

Not Receiving Discord Messages in Minecraft

Problem:

Discord messages aren't showing up in your Minecraft chat.

Required Bot Permissions:

  • Read Messages / View Channels
  • Read Message History
  • Send Messages

Important: Message Content Intent

Your bot MUST have the "Message Content Intent" enabled or it can't read messages!

  1. Go to Discord Developer Portal
  2. Select your application
  3. Go to "Bot" section
  4. Scroll to "Privileged Gateway Intents"
  5. Enable "MESSAGE CONTENT INTENT"
  6. Save changes

Also Check:

  • Minecraft mod is installed and configured correctly
  • Bridge name in Minecraft matches exactly (case-sensitive)
  • No firewall blocking the connection

Complete Discord Bot Setup Guide

Creating Your Bot:

  1. Create Application:
  2. Create Bot:
    • Go to "Bot" section in left menu
    • Click "Add Bot"
    • Customize username and avatar if desired
  3. Get Token:
    • Click "Reset Token"
    • Copy the token immediately (you won't see it again!)
    • Keep this token SECRET - never share it
  4. Enable Intents:
    • Scroll to "Privileged Gateway Intents"
    • Enable: MESSAGE CONTENT INTENT ✅
    • Enable: SERVER MEMBERS INTENT ✅
    • Save changes

Adding Bot to Your Server:

  1. Go to "OAuth2" → "URL Generator"
  2. Select Scopes: "bot" and "applications.commands"
  3. Select Bot Permissions:
    • Read Messages/View Channels
    • Send Messages
    • Embed Links
    • Read Message History
    • Manage Messages (for auto-delete)
    • Use Slash Commands
  4. Copy the generated URL
  5. Open URL in browser and select your server
  6. Authorize the bot

Security Warning:

NEVER share your bot token! If it gets leaked, immediately regenerate it in the Developer Portal.

Bot Permissions Issues

Required Permissions Explained:

View Channels (Read Messages)

Allows bot to see the channel and read messages from it.

Send Messages

Allows bot to send messages to the channel.

Embed Links

Required for formatted messages with colors and fields.

Read Message History

Allows bot to see previous messages in the channel.

Manage Messages

Allows bot to delete messages (used for auto-cleanup of link requests).

Use Slash Commands

Enables slash commands like /link, /unlink, /who.

How to Fix Permission Issues:

Method 1: Server Settings

  1. Go to Server Settings → Roles
  2. Find your bot's role (usually named after the bot)
  3. Enable all required permissions
  4. Save changes

Method 2: Channel Permissions

  1. Right-click your channel → Edit Channel
  2. Go to Permissions
  3. Add your bot (+ button)
  4. Grant all required permissions
  5. Save changes

Method 3: Re-invite Bot

  1. Kick the bot from your server
  2. Generate new invite link with correct permissions
  3. Re-add bot to server

Common Mistakes to Avoid

Mistake #1: Using Channel Name Instead of ID

Wrong: #general or "general"

Right: 123456789012345678 (18-digit number)

Mistake #2: Forgetting Message Content Intent

Without this intent enabled, your bot can't read message content!

Fix: Developer Portal → Bot → Enable MESSAGE CONTENT INTENT

Mistake #3: Wrong Bridge Name Case

Bridge names are case-sensitive!

Wrong: /link myserver

Right: /link MyServer

Mistake #4: Old or Invalid Token

Tokens can expire or become invalid.

Fix: Generate a new token in Developer Portal

Mistake #5: Bot in Wrong Channel

Make sure the bot can see and access your specified channel.

Fix: Check channel permissions or make channel public

Quick Diagnostics

Run through this checklist:

  • Bot shows as online in Discord member list
  • Bot has a role in your server
  • Channel ID is correct (18-digit number)
  • MESSAGE CONTENT INTENT is enabled
  • Bot has all required permissions
  • Bridge name matches exactly (case-sensitive)
  • No error messages in dashboard
  • Test message sends successfully

Still Having Issues?

Try these steps in order:

  1. Generate new bot token
  2. Update configuration with new token
  3. Wait 30 seconds for reconnection
  4. Test with a simple message
  5. Check dashboard for connection status

MC-Discord Bridge Help Guide | Back to Dashboard