Get started

Getting started

Five steps from inviting the bot to the first chat message between Minecraft and Discord.

Status, player count and displays work through your Minecraft server's address and don't need a plugin. For chat, console and whitelist you install the MC-Sync plugin or mod and connect the server to a Discord channel. This page walks you through both.

Steps

  1. Invite the bot. Open invite.mc-sync.eu, pick your Discord server and confirm.

    You should now see the bot in your Discord server's member list.

  2. Install the plugin or mod. Get the file for your server from the download page, put it into the plugins folder (Spigot, Paper, Folia) or the mods folder (Fabric, Quilt, Forge, NeoForge) and start the Minecraft server.

    You should now see the file plugins/mc-sync/config.yml or config/mc-sync.properties.

  3. Add the server and connect it to a channel.

  1. Open the dashboard, click "Sign in with Discord" and then "Manage" next to your Discord server.
  2. Open "Servers" and click "+ Add server".
  3. Enter a name and an address, for example Survival and play.example.eu, and click "Next".
  4. Pick the chat channel, accept the terms and click "Connect and create token".

You should now see a command with a code. It's valid for 15 minutes.

  1. Run the command in the Minecraft server's console.
/mcsync connect K7M2QX4P

The plugin writes the token into its config itself and connects. Forge before Minecraft 1.19 has no /mcsync, so there you put the token in by hand. The same goes if you'd rather do that anyway, see Chat sync.

You should now see "Connected" next to your server under "Servers" in the dashboard. In the game, /mcsync status shows the same.

  1. Write a chat message in the game.

    You should see it in the Discord channel after a few seconds. A reply in the channel shows up in the game.

If a step doesn't work, see Chat sync and Troubleshooting. Everything else the chat can do is on Chat sync too.

What's next