Minecraft × Discord
Your Minecraft server, live in Discord.
A Paper plugin and a bot that actually talk to each other. Add the bot, run /setup, type the code into your server console. Then get live stats, alerts, chat and more. Nothing to host, no port forwarding.
Paper 1.21 · Java 21 · Open source (AGPL-3.0)
- TPS
- 20.0
- 5m 19.9 · 15m 19.9
- MSPT
- 13.9 ms
- 50 ms = 20 TPS limit
- Memory
- 2.2 / 6.0 GB
anyone up for the nether trip tonight? bringing extra blocks
Status bots ping your server. MCBridge runs inside it.
So it knows what's really going on. The plugin connects out to MCBridge, and MCBridge talks to Discord. Nothing to host, no port forwarding.
Everything your community asks about, answered in Discord.
Stats, alerts, chat, whitelist, recaps and more. Set up with menus, not config files.
- 01
Live status card
Real TPS, MSPT and RAM, the players online, your server icon and a graph of the last hour. One message that keeps itself up to date.
/status live - 02
Crash vs restart detection
MCBridge knows the difference between a clean restart and a crash. Lag alerts ping the role you choose, and a notice lands when you're back online.
alerts - 03
Lag diagnostics
The busiest chunks, with coordinates, and the most common entities. Attached to every lag alert and available any time with /lag.
/lag - 04
Two-way chat bridge
Discord and Minecraft chat in one place, with each player's name and skin head. Plus a feed of joins, leaves, deaths and advancements.
chat - 05
Whitelist requests
Players ask from Discord. Staff approve or deny with one button, and the player gets a DM with the result.
/whitelist-request - 06
Player stats
Playtime, sessions, deaths and last seen for anyone with /player, and a leaderboard of the most active players with /top.
/player · /top - 07
Daily recap
Peak players, uptime, average TPS, minutes of lag and a 24-hour graph, posted once a day to the channel you pick.
/recap - 08
Account linking
Players run /account link in Discord and /discord link <code> in game. Linked members get a role automatically.
/account link - 09
Setup wizard
/settings picks every channel and role with menus. No config files, no IDs to copy.
/settings - 10
Remote console
Run console commands from Discord as an admin. Off by default in the plugin, and every command is recorded in the audit log.
/console
Not another status bot.
Pinging from the outside tells you online or offline. Running inside the server tells you why.
| Feature | MCBridge | Status bots | Self-hosted chat plugins |
|---|---|---|---|
| Real TPS, MSPT and memory | ✓ | — | Some |
| Tells a crash from a restart | ✓ | — | — |
| Lag alerts with the busiest chunks | ✓ | — | — |
| Two-way chat with skin heads | ✓ | — | ✓ |
| Whitelist requests with buttons | ✓ | — | — |
| Player stats and leaderboard | ✓ | — | Some |
| Daily recap with graphs | ✓ | — | — |
| Nothing to host | ✓ | ✓ | — |
| No open ports | ✓ | — | ✓ |
| Open source | ✓ | Varies | Varies |
Three steps. About two minutes.
Add the bot, run /setup, type the code into your server console. Then you get live stats, alerts, chat and more.
- Step 1
Add the bot
Invite MCBridge to your Discord server. It asks only for the permissions it uses.
- Step 2
Run /setup
Type /setup and a name in Discord. You get a 6-character link code that works once and expires after 10 minutes.
- Step 3
Type the code
Put the plugin in your plugins folder and restart. Then run /mcbridge link with your code in the server console. That's it.
Questions, answered.
Do I need to host anything?
No. We host the bot. You only install the plugin on your Minecraft server. The plugin connects out to MCBridge over a secure WebSocket, so you don't need to open ports, set up port forwarding or have a static IP.
Which servers does it work on?
Paper 1.21 on Java 21. A Fabric version is on the roadmap.
How is this different from a status bot?
A status bot can only ping your server from the outside, so all it sees is online or offline and a player count. MCBridge runs inside the server, so it sees real TPS, MSPT and memory, knows a crash from a restart, and can find the chunks causing lag.
How does it tell a crash from a restart?
The plugin sends a heartbeat every few seconds and a stop message when the server shuts down cleanly. If the heartbeats stop without a stop message, that's a crash. MCBridge waits 30 seconds first, so a quick reconnect doesn't cause a false alert.
Is the remote console safe?
It's off by default. You have to turn it on in the plugin's config, only Discord members with the Administrator permission can use it, and every command is written to the audit log (/audit).
Can I connect more than one server?
Yes. Run /setup once for each Minecraft server. /servers lists everything linked to your Discord.
What data do you store?
Only what the features need: your server's name and settings, the channels and roles you pick, stats samples for the graphs (kept for 8 days), player names and playtime counters, linked accounts and the audit log. Chat messages are passed through, not stored. The privacy policy has the full list.
Is it free?
Yes. MCBridge is free to use, and the code is open source under AGPL-3.0, so you can also read it, change it or run it yourself.
Get started
Build the bridge.
Your players are already in Discord.
Add the bot, drop the plugin in, link them with one code. Free and open source.