Skip to content
MCBridge

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)

01How it works

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.

The plugin inside your Minecraft server connects out to MCBridge, which talks to Discord.MinecraftPaper pluginMCBridgehostedDiscordyour discord
events, heartbeats →← commands wss:// · outbound only · no open ports
02Features

Everything your community asks about, answered in Discord.

Stats, alerts, chat, whitelist, recaps and more. Set up with menus, not config files.

03Compare

Not another status bot.

Pinging from the outside tells you online or offline. Running inside the server tells you why.

MCBridge compared with status bots and self-hosted chat plugins
FeatureMCBridgeStatus botsSelf-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✓VariesVaries
04Setup

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.

  1. Step 1

    Add the bot

    Invite MCBridge to your Discord server. It asks only for the permissions it uses.

  2. 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.

  3. 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.

server consolepaper 1.21
05FAQ

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.