?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
Faga's Discord Bridge

Faga's Discord Bridge

MC Discord Bridge is a server-side NeoForge mod that links Minecraft 1.21.x and Discord with event logs, /mc chat relay, account linking, and leaderboards.

119
5
119
5

Compatibility

Minecraft: Java Edition

1.21.x

Platforms

Supported environments

Dedicated servers only

Links

Report issues View source

Tags

Creators

Details

Licensed MIT
Published last month

Features

  • Minecraft -> Discord bridge for server lifecycle, player join/leave, deaths, advancements, and day milestone announcements
  • Discord -> Minecraft chat relay via /mc slash command in the configured channel (with mention sanitization)
  • /mc relays to Minecraft and echoes plain text back to Discord (**name:** message)
  • /mc uses linked Minecraft nickname when the Discord user is linked
  • Rich Discord embeds with per-event colors, timestamps, optional player head thumbnails, and plain-text fallback
  • Bot activity rotation with configurable activity list, interval, and type (PLAYING, WATCHING, LISTENING, COMPETING)
  • Admin logging channel with command redaction and structured admin embeds
  • Discord config slash command for admins: /config to update chat/admin channels and whitelist guild
  • Discord/Minecraft account linking via /link (ephemeral one-time code) and in-game /bridge link <code>
  • /leaderboard slash command with categories, pagination, and visibility (private default, optional public)
  • Leaderboards include online and offline players with saved stats
  • Linked players are shown as Discord mentions (<@discordUserId>) in leaderboard and embeds
  • Bot activity rotation includes a built-in online/max players status entry
  • Resilient startup/runtime behavior: Discord failures are logged, startup messages are queued until JDA is ready

Discord Bot Permissions

Bot permissions:

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

Configuration

First run creates config/mcdiscordbridge-common.toml.

# Discord bot token or env:DISCORD_BOT_TOKEN
discordApiKey = "env:DISCORD_BOT_TOKEN"

# Only messages from this guild are accepted
whitelistGuildId = "123456789012345678"

# Discord channel for chat bridge
chatChannelId = "123456789012345678"

# Discord channel for admin logs
adminLogChannelId = "123456789012345678"

# Legacy toggle for text-message relay mode (slash command `/mc` does not require this)
enableMessageContentIntent = false

# Send Discord embeds for richer event logs
enableEmbeds = true

# Hex color for embeds, for example #57A5FF
embedColorHex = "#57A5FF"

# Include player head thumbnail in embeds when UUID is available
includePlayerHeadInEmbeds = true

# URL template with %uuid% placeholder
playerHeadUrlTemplate = "https://crafatar.com/avatars/%uuid%?size=128&overlay"

# Rotate bot activity text from botActivities
enableBotActivityRotation = true
botActivities = ["Watching the server", "Bridging chat", "Tracking events"]
botActivityRotateSeconds = 20

# PLAYING, WATCHING, LISTENING, COMPETING
botActivityType = "WATCHING"

# Send day milestone message every N minecraft days (0 disables)
dayMilestoneGap = 10

# Enable Discord account linking to Minecraft players
enableAccountLinking = true

# How long link codes remain valid
linkCodeExpirySeconds = 600

# Length of one-time account link code
linkCodeLength = 6

Token via environment variable

Set:

export DISCORD_BOT_TOKEN="your_token"

Then set in config:

discordApiKey = "env:DISCORD_BOT_TOKEN"

Setup

In your whitelisted Discord server, run /config with one or more of:

  • chat_channel_id
  • admin_channel_id
  • whitelist_guild_id

Only Discord admins can run /config.

Account Linking

  • On Discord, run slash command: /link
  • The bot replies ephemerally with a one-time code
  • In Minecraft, run: /bridge link <code>
  • linkCodeExpirySeconds controls how long the code remains valid

Discord to Minecraft Relay

  • On Discord in the configured chat channel, run: /mc <message>
  • The message is relayed to Minecraft chat as [Discord] <name> message
  • The same message is echoed in Discord as plain text: **name:** message
  • If the Discord account is linked, name uses the linked Minecraft nickname

Leaderboard

  • On Discord, run: /leaderboard <category>
  • Optional page: /leaderboard <category> <page>
  • Optional visibility: /leaderboard <category> <page> <visibility> where visibility is private (default) or public
  • Linked players are shown with Discord mention tags (<@discordUserId>)
  • Categories: playtime, deaths, player_kills, mob_kills, mined_blocks, distance_walked
  • Leaderboard responses are ephemeral by default

Notes

  • This is server-only. Do not install on clients.
  • Discord failures are logged and do not intentionally crash server startup.
  • Avoid logging secrets in command usage; redaction is enabled by default.