Skip to content
MCBridge
Docs

Commands

/rolesync

Links a permissions group (LuckPerms or Vault) to a Discord role, removes links and lists them.

Who can use it
Staff (Manage Server)
Works in
Text channels in a Discord server, not DMs
Needs
LuckPerms or Vault (with a permissions plugin) · allow.roles in the plugin config

Usage

/rolesync add group:vip role:@VIP direction:both
/rolesync remove group:vip
/rolesync list

Subcommands

/rolesync add

Links a permissions group (LuckPerms or Vault) to a Discord role. Directions: both, minecraft-to-discord, discord-to-minecraft.

/rolesync add group:<group> role:<role> direction:<direction>
Options for /rolesync add
OptionRequiredWhat it does
groupYesThe permission group name, e.g. vip.
roleYesThe Discord role.
directionNoWhich way changes are copied: both (default), minecraft-to-discord or discord-to-minecraft.
serverNoWhich linked Minecraft server. Only needed if this Discord has more than one.

Needs: LuckPerms or Vault, allow.roles.

/rolesync remove

Removes a role link.

/rolesync remove group:<group>
Options for /rolesync remove
OptionRequiredWhat it does
groupYesThe permission group name.
serverNoWhich linked Minecraft server. Only needed if this Discord has more than one.

/rolesync list

Shows every role link.

/rolesync list
Options for /rolesync list
OptionRequiredWhat it does
serverNoWhich linked Minecraft server. Only needed if this Discord has more than one.

Example

# staff
↳ Aoi used /rolesync list
MCBridgeApptoday at 21:04
Role links · Hinoki SMP

vip ⇄ @VIP (both) builder → @Builder (minecraft-to-discord) events ← @Event Team (discord-to-minecraft)

Illustration. Names and numbers are made up.

Good to know

  • Only roles and groups you link are ever touched.
  • MCBridge's role must be above the roles it manages in Server Settings → Roles.
  • Only players who linked their account with /account link are synced.
  • Staff commands are hidden from members by default. Server admins can change who can use any command in Server Settings → Integrations → MCBridge.