Quick start

Link your Minecraft server with Discord in three steps. It takes about a minute.

What you need

  • A Discord server where you have the Manage Server permission (to add the bot) and Administrator (to run /connect).
  • A Minecraft Java server where you can install plugins or mods, and OP rights or console access on it.

1. Add the bot to Discord

Add MC Linker to your server, pick the Discord server you want to link and confirm. You can also find MC Linker in the App Directory or on Top.gg.

MC Linker posts a short welcome message in your server once it joins.

2. Install the plugin

Download Discord-Linker for your server software and put the file into the plugins folder (Paper, Spigot, Purpur) or the mods folder (Fabric, Forge, NeoForge). Then restart the server.

Server softwareMinecraft versionsDownload
Paper, Spigot, Purpur1.8 – latestModrinth · Hangar · SpigotMC · CurseForge
Fabric1.16.5 – 26.2Modrinth · CurseForge
NeoForge1.21.1 – 26.2Modrinth · CurseForge
Forge1.16.5 – 1.20.xModrinth · CurseForge

Fabric, Forge and NeoForge also need the Architectury API mod (and Fabric also needs Fabric API).

On Aternos, add Discord-Linker from the plugin list. More details: Installing the plugin.

3. Connect

Run /connect in your Discord server. The bot replies with a command for Minecraft:

Install the Discord-Linker plugin on your Minecraft server.
Then join your server as an operator and execute the following command: /linker connect 803412896432:a8f3cYou have 3 minutes to run the command.

Join your server as an operator and run that exact command in chat:

The message in Discord changes to:

Successfully connected to the plugin.

Running it from the console?

Leave out the slash: linker connect 803412896432:a8f3c.

That's it, your server is linked. If the code doesn't work, see Troubleshooting.

What's next