역할 포털
설명
사용자 가이드
버튼이 달린 메시지를 게시하면, 여러분이 요구한 역할을 이미 보유한 멤버가 버튼을 클릭해 하나 이상의 역할을 받습니다. 첫 단계를 거친 뒤 제한된 섹션의 접근을 열어 주는 데 이상적입니다.
기능
- 원하는 채널에 버튼이 포함된 맞춤 Embed를 게시합니다.
- 역할을 부여하기 전에 필수 역할을 확인합니다.
- 스태프의 개입 없이 클릭 한 번으로 부여할 역할을 지급합니다.
- 채널 내 비공개 응답(임시 메시지)을 사용하므로, 성공이든 거부든 대화를 어지럽히지 않습니다.
- 버튼은 계속 유효합니다. 봇을 재시작한 뒤에도 작동합니다.
이 모듈은 AutoRole, Role Gate, RoleRoster와 다릅니다
역할을 다루는 모듈은 네 가지이며 각자 역할이 분명히 구분됩니다.
| 모듈 | 원리 |
|---|---|
| 역할 포털 | 조건부 버튼. 역할 A와 B를 보유한 경우에만 역할 C를 받습니다. |
| AutoRole | 누구나 자유롭게 선택하고 되돌릴 수 있는 드롭다운 메뉴 패널. 조건이 없습니다. |
| Role Gate | 입장 시 자동으로 부여되는 역할, 역할 교체, 비활동 멤버의 역할 회수. 클릭이 필요 없습니다. |
| RoleRoster | 명단 기능. 특정 역할을 가진 멤버 목록을 표시하며, 역할을 부여하지 않습니다. |
정리하면, 네 모듈 중 역할을 부여하기 전에 조건을 두는 것은 역할 포털뿐입니다.
빠른 시작(관리자)
- 대시보드 → 도구 & 스태프 카테고리 → 보안 포털을 엽니다.
- 새 포털을 클릭합니다.
- 내부 이름(Discord에는 표시되지 않음)을 입력하고 배포 채널을 선택합니다.
- 부여할 역할을 지정합니다(필수). 필요하면 필수 역할도 지정합니다.
- Embed와 버튼을 원하는 대로 설정한 뒤 저장합니다.
- 목록에서 전송 아이콘을 클릭해 채널에 패널을 게시합니다.
명령어
이 모듈에는 Discord 명령어가 없습니다. 모든 설정은 대시보드에서 이루어지며, 멤버는 패널의 버튼만 사용합니다.
대시보드 설정
포털 목록에는 각 포털의 이름, 채널, 필수 역할, 부여 역할이 표시되며, 패널 게시, 수정, 삭제 세 가지 작업을 할 수 있습니다.
구성 창은 네 개 블록으로 이루어집니다.
- 기본 정보: 내부 이름(필수)과 배포 채널(필수).
- 조건 & 보상:
- 필수 역할 — 선택 사항. 비워 두면 누구나 버튼을 클릭할 수 있습니다.
- 부여할 역할 — 필수. 하나 이상의 역할.
- 외관(Embed): 제목, 설명, 색상.
- 버튼: 표시 텍스트와 이모지(이모지 선택기 제공).
포털 개수는 프리미엄이 아닌 서버의 경우 1개로 제한됩니다(기본값이며, TennoCore 팀이 조정할 수 있습니다).
알아두면 좋은 점
- 봇에게 역할 관리하기 권한이 필요하며, 봇의 역할이 부여할 역할보다 위에 있어야 합니다. 그렇지 않으면 멤버에게 역할 서열 관련 오류 메시지가 표시됩니다.
- 필수 역할은 AND 조건으로 검사됩니다. 멤버는 나열된 역할을 모두 보유해야 합니다. 부족한 경우 봇이 어떤 역할이 없는지 정확히 알려 줍니다.
- 포털의 모든 역할을 이미 보유한 멤버에게는 안내 메시지만 표시되고 아무 변화도 없습니다.
- 포털은 역할을 회수하지 않습니다. 받기/반납 방식의 토글 동작이 필요하면 AutoRole을 사용하세요.
- 포털을 수정해도 이미 게시된 메시지는 변경되지 않습니다. 텍스트, 색상, 버튼 문구는 처음 게시한 상태로 유지됩니다. 최신 내용을 반영하려면 패널을 다시 게시한 뒤 예전 메시지를 삭제하세요.
- 같은 포털의 메시지를 여러 개 남겨 두지 마세요. 봇을 재시작하면 가장 마지막에 게시된 메시지만 다시 활성화되며, 이전 버튼은 작동하지 않습니다.
- 대시보드에서 포털을 삭제해도 Discord에 게시된 메시지는 삭제되지 않습니다. 버튼은 계속 보이지만 아무 동작도 하지 않습니다. 메시지는 직접 삭제하세요.
- 봇이 글을 쓸 수 있는 채널이어야 합니다. 그동안 채널이 삭제된 경우 게시가 실패합니다.
- 포털은 맞춤 봇에서도 작동합니다. TennoCore가 서버에 없을 때는 여러분의 봇이 버튼을 처리합니다.