MC Linker GuideMC Linker Guide
Quick start
Commands
Help
Home
Add to Discord
Quick start
Commands
Help
Home
Add to Discord

Links

Support serverOpens Discord in a new tabGitHubMC Linker is completely open sourceDonateOpens GitHub Sponsors in a new tabMeet the teamThe people behind MC Linker
  • Introduction
  • Getting started

    • Quick start
    • Installing the plugin
    • Connecting your server
    • Permissions
    • Disconnecting
  • Features

    • Chat bridge
    • Console channel
    • Stat channels
    • Role sync
    • Account linking
    • Join requirements
    • Linked Roles
    • Direct messages
    • Customization
    • Custom bot
  • Commands

    • All commands
    • /inventory
    • /stats
    • /advancements
    • /userinfo
    • /serverinfo
    • /command
    • /message
    • /ban and /unban
    • /kick
    • /op and /deop
    • /gamemode
    • /help
  • Plugin

    • In-game commands
    • Configuration
    • Plugin permissions
    • Integrations
  • Help

    • Troubleshooting
    • FAQ

Installing the plugin

The Discord-Linker plugin (or mod) runs on your Minecraft server and talks to the MC Linker bot. It works out of the box: there is nothing to configure before you connect.

Pick the right file

Server softwareMinecraft versionsFolder
Paper, Spigot, Purpur and other Bukkit-based servers1.8 – latestplugins
Fabric1.16.5 – 26.2mods
NeoForge1.21.1 – 26.2mods
Forge1.16.5 – 1.20.xmods
Hybrid servers (MohistMC, Magma, Arclight)Use the Forge or NeoForge build for your versionmods

Download it from Modrinth or CurseForge (the plugin for Paper and Spigot, the mod for Fabric, Forge and NeoForge). The Paper and Spigot build is also on Hangar and SpigotMC. Pick the file that matches both your server software and your Minecraft version.

Mods need Architectury API

The Fabric, Forge and NeoForge builds need the Architectury API mod. Download it from Modrinth or CurseForge, pick the file for the same loader and Minecraft version, and put it into the mods folder next to Discord-Linker. Discord-Linker lists it as a required dependency, so without it the mod loader stops the server during startup with a missing dependency error.

Fabric

The Fabric build also needs the Fabric API mod, like most Fabric mods.

Install it

  1. Stop your server.
  2. Put the downloaded .jar file into the plugins or mods folder (see the table above). On Fabric, Forge and NeoForge, also add Architectury API (and Fabric API on Fabric).
  3. Start your server again.
  4. Check that it loaded: run /linker in the console (without the slash) or in-game as an operator. If it answers with a usage message, the plugin is running.

On a server host

Most hosts let you upload the file through their file manager or install it from a plugin browser.

  • Aternos: open Plugins (or Mods), search for Discord-Linker and install it. Then restart the server.
  • Other hosts: upload the file to the plugins or mods folder with the host's file manager or FTP, then restart.

The plugin connects out to the MC Linker bot, so you don't need to open any ports.

Updating

Replace the old .jar with the new one and restart the server. Your connection stays saved: you don't need to run /connect again.

Next step

Connect your server with /connect.

Edit this page on GitHub
Last Updated: 10/25/26, 11:55 PM
Contributors: Lianecx
Prev
Quick start
Next
Connecting your server