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

로그에서 봇이 어떤 역할을 부여하려는지, 왜 실패했는지 확인할 수 있어요.