Skip to main content

modules/luckperms-sync.yml

Maps LuckPerms groups and Discord roles in one or both directions.

See LuckPerms synchronization for setup and usage.

Before enabling​

  • Install LuckPerms.
  • Enable the Server Members intent and grant Manage Roles.
  • Place the bot role above every managed role.
  • Review all removal switches before enabling.

Source of truth​

initial-authority controls which side wins during the first reconciliation. Each mapping has an independent direction. Two-way removal can remove legitimate access if mappings or role hierarchy are wrong.

Default configuration​

plugins/CoreDSC/modules/luckperms-sync.yml
config-version: 4
generated-by-version: "2.5.2"

# CoreDSC module: luckperms-sync
# Set enabled to false to keep this module completely inactive.
enabled: false
guild-id: 0
initial-authority: minecraft
remove-discord-role-when-group-missing: true
remove-luckperms-group-when-role-missing: true
remove-discord-roles-on-unlink: true
remove-luckperms-groups-on-unlink: false
reconcile-online-seconds: 600
mappings:
- enabled: false
  group: vip
  role-id: '0'
  direction: minecraft-to-discord

Download this default file.