테마
서버 설정 — 관리자가 정하는 것
연희 봇에는 서버 설정용 슬래시 명령이 없습니다. 서버 관리자가 만지는 설정은 전부 웹 대시보드의 설정 화면에 있습니다.
이 페이지는 그 설정 화면에 들어가는 방법과, DJ 권한과 기본 권한 두 섹션을 자세히 다룹니다. 나머지 항목은 각각 따로 문서가 있습니다.
무엇을 정할 수 있나
| 정할 수 있는 것 | 어디서 정하나 | 자세한 내용 |
|---|---|---|
| DJ로 인정할 역할 | 대시보드 설정 화면 | 이 페이지 아래 |
| 조작 8종의 권한 등급 | 대시보드 설정 화면 | 이 페이지 아래 |
| 컨트롤러 메시지가 뜰 채널 | 대시보드 설정 화면 | 컨트롤러 메시지 채널 고정 · 통합 |
| 서버 볼륨과 볼륨 동기화 | 재생 화면·명령, 동기화는 운영팀 | 볼륨 정책과 볼륨 동기화 |
| 프리미엄(서브 봇) 사용 여부 | 운영팀에 요청 | 프리미엄(서브 봇) 켜기 |
| 누가 대시보드를 열 수 있나 | 디스코드 역할 | 누가 대시보드를 쓸 수 있나 |
명령별 사용 자체를 특정 역할에게만 열고 싶다면, 그것은 연희 설정이 아니라 디스코드의 서버 설정 → 연동(통합) → 연희에서 합니다.
설정 화면으로 가는 길
- 대시보드에 디스코드 계정으로 로그인합니다.
- 왼쪽 사이드바에서 설정할 서버를 고릅니다.
- 헤더 오른쪽 아바타를 눌러 사용자 메뉴를 열고 설정을 선택합니다.
설정 항목은 사이드바에 없고 사용자 메뉴에만 있습니다. 그리고 그 서버에서 관리자(Administrator) 권한이 없으면 메뉴 항목 자체가 보이지 않습니다. 설정 화면을 열어둔 채 관리자가 아닌 서버로 바꾸면 화면이 자동으로 "지금 재생"으로 돌아갑니다.
TIP
"설정 메뉴가 안 보입니다"라는 문의는 대부분 서버 관리(ManageGuild) 권한만 가진 경우입니다. 연희 설정 화면은 서버 관리가 아니라 관리자 권한을 요구합니다. 자세한 접근 조건은 누가 대시보드를 쓸 수 있나를 보세요.
조작 8종 × 권한 4단계
기본 권한 섹션은 8개 조작 각각에 4단계 중 하나를 지정하는 격자입니다. 화면 라벨과 초기값은 다음과 같습니다.
| 화면 라벨 | 초기값 | 설명 |
|---|---|---|
| 볼륨 조절 | DJ 이상 | 서버 전체 음량 변경 |
| 다음 곡 | 신청자 이상 | 현재 곡 건너뛰기 |
| 이전 곡 | 신청자 이상 | 직전 곡으로 돌아가기 |
| 일시정지/재생 | 모두 | 재생 상태 전환 |
| 정지 | DJ 이상 | 재생 중단과 대기열 정리 |
| 탐색 | DJ 이상 | 재생 위치 이동 |
| 반복 모드 | DJ 이상 | 한 곡/대기열 반복 전환 |
| 셔플 | DJ 이상 | 대기열 순서 섞기 |
한 번도 건드리지 않은 서버는 위 초기값으로 동작합니다. 볼륨과 탐색을 쓰는 쪽에서 어떻게 보이는지는 /볼륨 · /탐색에 정리돼 있습니다.
4단계가 실제로 어떻게 판정되나
위에서부터 순서대로 판정합니다.
- 관리자 권한이 있으면 설정과 무관하게 통과합니다. 관리자를 "관리자만"으로 막을 수는 없습니다.
- 레벨이 모두면 통과합니다.
- 레벨이 DJ 이상이면 DJ 역할을 하나라도 가지고 있어야 합니다.
- 레벨이 신청자 이상이면 DJ 역할이 있거나, 지금 재생 중인 곡을 신청한 본인이어야 합니다.
- 레벨이 관리자만이면 1번에서 통과하지 못한 사람은 전부 거절됩니다.
여기서 "신청자"의 기준은 조작하려는 시점에 재생 중인 곡의 신청자입니다. 대기열에 있는 다른 곡을 내가 넣었더라도, 지금 나오는 곡이 남의 곡이면 "신청자 이상"으로 설정된 조작은 쓸 수 없습니다.
TIP
"관리자만"은 사실상 "관리자 권한을 가진 사람만"과 같습니다. 관리자 외에 특정인만 허용하고 싶다면 그 사람에게 DJ 역할을 주고 레벨을 DJ 이상으로 두는 편이 맞습니다.
DJ 역할 등록
DJ 권한 섹션에 서버의 역할이 칩으로 나열됩니다. 눌러서 켜고 끄면 됩니다. 여러 개를 동시에 지정할 수 있고, 그중 하나만 가지고 있어도 DJ로 인정됩니다.
목록에 나오지 않는 역할이 두 종류 있습니다.
@everyone- 다른 봇이나 연동이 자동으로 만든 역할 — 니트로 부스터 역할, 다른 봇의 전용 역할이 여기에 해당합니다.
WARNING
DJ 역할을 지정했는데 아무도 DJ로 인정되지 않는다면, 지정한 역할이 그 사이 삭제됐을 가능성이 큽니다. 설정 화면을 다시 열었을 때 켜져 있던 칩이 사라져 있으면 그 역할은 이미 서버에 없는 것입니다. 새 역할을 만들어 다시 지정해 주세요.
이 설정은 디스코드와 대시보드에 똑같이 적용됩니다
권한 설정은 대시보드 전용이 아닙니다. 슬래시 명령, 컨트롤러 버튼, 대시보드 버튼이 모두 같은 기준으로 판정됩니다.
대시보드의 대기열 조작에는 따로 항목이 없고 기존 8종에 묶여 있습니다.
| 대시보드 동작 | 필요한 권한 |
|---|---|
| 대기열 전체 지우기 | 정지 |
| 대기열에서 한 곡 제거 | 다음 곡 |
| 대기열 순서 변경 | 다음 곡 |
| 특정 곡으로 점프 | 다음 곡 |
권한 설정으로 막을 수 없는 조작
기본 권한 8종은 이미 재생 중인 음악을 조작하는 동작만 다룹니다. 봇을 부르고 내보내는 동작과 곡을 추가하는 동작에는 설정 항목이 없습니다.
WARNING
/들어와 · /나가 · /재생 · /검색 · /다음재생 은 권한 설정의 영향을 받지 않습니다. 지원 안 함 그래서 "정지"를 DJ 이상으로 두어도, 같은 음성 채널에 있는 사람이 /나가 로 봇을 내보낼 수 있습니다. 이 명령들을 특정 역할에게만 열고 싶다면 디스코드 서버 설정 → 연동(통합) → 연희에서 명령별 사용 권한을 제한해 주세요.
조작 경로마다 다른 추가 조건
권한 레벨을 통과해도 경로에 따라 조건이 하나 더 붙습니다. 이 차이 때문에 "디스코드에서는 되는데 대시보드에서는 안 된다"는 문의가 생깁니다.
| 경로 | 음성 채널에 있어야 하나 | 봇과 같은 방이어야 하나 |
|---|---|---|
| 슬래시 명령 | 필요 | 내가 있는 채널 기준으로 대상 봇을 고릅니다 |
| 컨트롤러 버튼 | 불필요 | 불필요 |
| 대시보드 조작 | 필요 | 필요 |
TIP
컨트롤러 메시지는 음성 채널 밖에서도 눌립니다. 아무나 들어오는 채널에 컨트롤러가 있으면 "정지"가 계속 눌리는 일이 생깁니다. 컨트롤러를 특정 채널에 고정하고 그 채널의 보기 권한을 제한하는 것이 실질적인 대책입니다. 컨트롤러 메시지 채널 고정 · 통합을 보세요.
저장 버튼을 눌러야 반영됩니다
칩과 버튼을 눌러도 그 순간에는 화면 안에서만 바뀝니다. 오른쪽 위에 저장되지 않음이 뜨고, 저장 버튼을 눌러야 실제로 적용됩니다.
저장하면 컨트롤러 메시지가 지워졌다가 다시 만들어집니다. 권한만 바꿔도 컨트롤러가 채널 맨 아래로 다시 올라오므로 놀랄 일은 아닙니다.
WARNING
저장하지 않은 변경은 서버를 바꾸는 순간 경고 없이 사라집니다. 사이드바에서 다른 서버를 고르거나, 내가 음성 채널을 옮겨 대시보드가 서버를 자동으로 따라갈 때 모두 초기화됩니다. 증상은 "칩을 몇 개 눌러 두고 다른 서버를 봤다가 돌아왔더니 저장됨으로 돌아와 있다"입니다. 헤더 오른쪽에 저장되지 않음이 떠 있는 동안에는 서버를 바꾸지 말고 저장을 먼저 눌러 주세요.