Skip to content
MCBridge
Docs

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.

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

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

Channels

Everything is set with menus in /settings. These are the channels you can pick:

Channels you can set in /settings
ChannelWhat goes there
AlertsCrashes, clean stops, lag (with diagnostics), back online, plugin disconnected, the daily recap, the “linked” message.
Chat bridgeTwo-way chat. Minecraft messages show with each player's name and skin head (needs Manage Webhooks).
Player feedJoins, leaves, deaths and advancements. Falls back to the chat channel. Each event type can be turned off.
Whitelist requestsRequests with Approve/Deny buttons. Falls back to the alerts channel.
ConsoleThe live server console, in batches. Admins can type commands straight into it. IP addresses are hidden. Needs allow.console.
Stat channelA 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.