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

Linked Roles

Linked Roles are a Discord feature: a role that members can only get by connecting an app. With MC Linker, you can make a role that only players with a linked Minecraft account can get, and MC Linker shows up under their profile's connections.

Before you start

Members need a linked Minecraft account. Any link counts, global or per-server.

Set it up (admins)

  1. Open Server Settings › Roles and create a role (or edit one), for example Verified Player.
  2. Open the Links tab of the role and click Add requirement.
  3. Choose MC Linker and the requirement Has Minecraft Account.
  4. Save.

Get the role (members)

  1. Click your server's name and choose Linked Roles.
  2. Pick the role and connect MC Linker.
  3. Authorize MC Linker in the window that opens. You'll see You have been authorized as …! You can now close this window and go back to Discord.
  4. Back in Discord, claim the role.

If you haven't linked your Minecraft account yet, run /account connect first. If you link later, MC Linker updates your connection by itself.

Linked Roles or role sync?

Linked RolesRole sync
What it checks"Has a linked Minecraft account"Membership of a Minecraft team or group
Who starts itThe member, through Discord's Linked Roles menuAutomatic
Changes MinecraftNoYes, if the direction allows it

Related

  • Account linking
  • Role sync
Edit this page on GitHub
Last Updated: 10/25/26, 11:55 PM
Contributors: Lianecx
Prev
Join requirements
Next
Direct messages