Skip to content
MCBridge
Docs

Getting started

Quick start

You need Manage Server in your Discord and access to your Minecraft server's files and console. The server must run Paper or a Paper fork (e.g. Purpur) on 1.21.x with Java 21.

Steps

  1. Add the bot

    Add MCBridge to your Discord. The invite asks for the permissions the bot needs (permission number 805424208).

  2. Run /setup

    In any channel, run /setup with a name for your server. You get a link code that works once and expires after 10 minutes.

    /setup name:Survival SMP
  3. Install the plugin

    Download the plugin, put the jar in your server's plugins folder and restart the server.

  4. Link the server

    In the server console, run the command with your code. In-game, ops can run it with a leading slash.

    Server console
    mcbridge link <code>
  5. Open settings

    MCBridge posts a “linked” message with an Open settings button. Click it (or run /settings) to pick channels for alerts, the chat bridge, the player feed and whitelist requests, and a role to ping.

  6. Try a live status

    In the channel where you want it, run:

    /status live:True

    The message updates itself every minute.

What next