Getting started
MCBridge documentation
MCBridge connects your Minecraft server to Discord. A Paper plugin runs inside your server and talks to a bot we host, so Discord sees real TPS, crashes, chat and players, not just a ping.
How it works
The plugin opens one secure WebSocket out to the MCBridge bot. The bot talks to Discord. You don't host anything, and your server needs no open ports or port forwarding.
events, heartbeats →← commands wss:// · outbound only · no open ports
You link the two with a one-time code: /setup in Discord gives you the code, and mcbridge link <code> in the server console uses it.
Start here
Features
- Status & graphsLive TPS, MSPT, memory and players in Discord, with a graph of the last hour and a self-updating status message.
- Alerts & crash detectionCrash vs clean stop, lag alerts with diagnostics, back-online notices and role pings.
- Lag diagnosticsFind the chunks and entities slowing your server down, with coordinates.
- Chat bridgeTwo-way chat between Discord and Minecraft, with player names and skin heads.
- Player feed & filtersJoins, leaves, deaths and advancements in a Discord channel, and how to turn each one off.
- Whitelist requestsMembers ask from Discord, staff approve or deny with one button, and the player gets a DM.
- Stats & daily recapPlayer playtime, Minecraft statistics, leaderboards and a daily summary of your server.
- Account linkingLink Discord members to their Minecraft accounts, with an automatic role.
- Role syncKeep LuckPerms or Vault groups and Discord roles in step for linked players.
- Console channelStream the server console into Discord and run commands from it.
- Stat channelA voice channel whose name shows your server's status and player count.
- ModerationKick, ban, op and change game modes from Discord, and manage the whitelist.
Channels
Everything is set with menus in /settings. These are the channels you can pick:
| Channel | What goes there |
|---|---|
| Alerts | Crashes, clean stops, lag (with diagnostics), back online, plugin disconnected, the daily recap, the “linked” message. |
| Chat bridge | Two-way chat. Minecraft messages show with each player's name and skin head (needs Manage Webhooks). |
| Player feed | Joins, leaves, deaths and advancements. Falls back to the chat channel. Each event type can be turned off. |
| Whitelist requests | Requests with Approve/Deny buttons. Falls back to the alerts channel. |
| Console | The live server console, in batches. Admins can type commands straight into it. IP addresses are hidden. Needs allow.console. |
| Stat channel | A voice channel whose name shows the server status and player count, e.g. 🟢 12/50 online. Updated about every 10 minutes (Discord's rename limit). |
Get help
Ask in the MCBridge Discord, or see Troubleshooting.