同步 Discord 身份组与服务器权限组

角色关联是 DiscordSRV 最主要的实用功能：购买头衔后自动获得 Discord 角色。

配置

plugins/DiscordSRV/synchronization.yml：

GroupRoleSynchronizationGroupsAndRolesToSync:
  'vip': '123456789012345678'
  'premium': '234567890123456789'
GroupRoleSynchronizationOneWay: false
GroupRoleSynchronizationCycleTime: 5

左侧是 LuckPerms 权限组，右侧是 Discord 角色 ID（开启开发者模式后右键点击角色即可复制）。

账户关联

/discord link

玩家会收到一个验证码，通过私信发送给机器人即可。未完成关联就无法同步。

双向模式

OneWay: false 表示 Discord 角色也会反过来授予服务器上的权限组。方便，但很危险：在 Discord 里发放角色的人，实际上就等于在服务器上发放头衔。对于赞助组，单向模式（服务器 → Discord）更安全。

机器人权限

机器人的角色在 Discord 角色列表中必须高于它所管理的角色，否则无法分配这些角色。90% 的“同步不生效”都是这个原因。

检查

/discordsrv link Nick
/discordsrv debug

日志会显示机器人正在尝试分配哪些角色，以及失败的原因。