테마
프리미엄(서브 봇) 켜기 — /admin
연희의 "프리미엄"은 서버 단위 설정입니다. 켜면 그 서버에서 한 봇이 이미 다른 음성 채널을 쓰고 있어도 서브 봇이 배정되어 동시에 재생할 수 있습니다.
이 설정을 바꾸는 방법은 /admin 슬래시 명령 하나뿐이고, 이 명령은 운영팀 관리 서버에서만 보입니다. 일반 서버 관리자는 대시보드에서 프리미엄을 켤 수 없습니다.
NOTE
이 문서는 연희 봇 자체의 프리미엄만 다룹니다. 연홍 쪽 서버 멤버십과는 별개 체계라, 켜고 끄는 방법도 아래의 /admin 명령 하나뿐입니다.
명령어 형태
text
/admin guild_id:<서버 ID> setting:<프리미엄(서브 봇 사용)|볼륨 동기화> action:<활성화|비활성화|상태 확인>옵션 세 개 모두 필수입니다.
| 옵션 | 값 | 설명 |
|---|---|---|
guild_id | 서버 ID 문자열 | 설정을 적용할 서버 |
setting | 프리미엄(서브 봇 사용) / 볼륨 동기화 | 바꿀 설정 |
action | 활성화 / 비활성화 / 상태 확인 | 할 동작 |
옵션 이름은 영문이고 선택지 라벨만 한국어입니다. 디스코드 자동완성에 영문 이름이 보이는 것은 정상입니다.
응답은 전부 본인에게만 보이는 메시지로 돌아옵니다.
| 실행 | 응답 |
|---|---|
| 프리미엄 · 상태 확인 | 서버 `<ID>` 프리미엄(서브 봇) 상태: 활성화 또는 비활성화 |
| 프리미엄 · 활성화 | 서버 `<ID>` 프리미엄(서브 봇 사용)을 활성화했어요. |
| 볼륨 동기화 · 상태 확인 | 서버 `<ID>` 볼륨 동기화 상태: ON 또는 OFF |
| 볼륨 동기화 · 활성화 | 볼륨 동기화를 ON으로 설정했어요. (메인 봇 볼륨을 모든 봇이 따라가요) |
| 볼륨 동기화 · 비활성화 | 볼륨 동기화를 OFF으로 설정했어요. (봇마다 볼륨을 따로 저장해요) |
볼륨 동기화의 의미는 볼륨 정책과 볼륨 동기화에 있습니다.
이 명령을 쓸 수 있는 곳
/admin 은 운영팀 관리 서버에서만 쓸 수 있습니다. 다른 서버에서 호출하면 이 명령은 지정된 관리 서버에서만 사용할 수 있어요. 로 거절됩니다.
WARNING
이 명령은 대상 서버를 직접 지정해서 설정을 바꾸는 명령입니다. 관리 서버에서 서버 설정 → 연동(통합) → 연희를 열어 /admin 을 쓸 수 있는 역할을 운영자 역할로 제한해 두시길 권합니다. 채널 단위로도 제한할 수 있으니 운영자 전용 채널에서만 쓰게 두면 실수를 한 겹 더 줄일 수 있습니다.
설정한 뒤에는 운영자가 아닌 계정으로 관리 서버에서 /admin 을 입력해, 자동완성에 뜨지 않는지 직접 확인해 주세요.
TIP
관리 서버 자체를 최소 인원만 있는 별도 서버로 두는 것이 가장 확실합니다.
대상 서버 ID는 직접 확인해 주세요
guild_id 에는 서버 ID를 그대로 넣습니다. 대상 서버에서 서버 이름을 우클릭해 서버 ID 복사로 가져오는 것이 가장 안전합니다.
WARNING
서버 ID를 잘못 넣어도 성공 메시지가 나옵니다. 존재하지 않는 ID를 넣으면 그 ID로 설정만 만들어지고, 응답은 정상적으로 "활성화했어요"라고 나옵니다. 실행한 뒤에는 반드시 action:상태 확인 으로 같은 ID를 다시 조회하고, 대상 서버에서 실제로 서브 봇이 붙는지 확인해 주세요.
프리미엄을 켜면 달라지는 것
같은 서버의 여러 채널에서 동시 재생
메인 봇이 이미 그 서버의 다른 음성 채널을 쓰고 있을 때, 프리미엄이 켜져 있으면 서브 봇이 배정됩니다. 프리미엄이 꺼져 있으면 두 번째 채널의 재생 요청은 거절됩니다.
이미 어떤 봇이 잡고 있는 음성 채널의 요청은 프리미엄과 무관하게 그 봇이 그대로 처리합니다. 프리미엄이 필요한 순간은 새로운 채널에 봇이 하나 더 들어가야 할 때뿐입니다.
대시보드에서 서브 봇 채널 지정 잠금 해제
설정 화면의 봇별 컨트롤러 채널 줄에서 서브 봇 행의 잠금이 풀립니다. 자세한 내용은 컨트롤러 메시지 채널 고정 · 통합에 있습니다.
프리미엄을 켰는데 서브 봇이 안 붙을 때
action:상태 확인 이 활성화로 나오는데도 두 번째 채널에서 재생이 거절된다면 아래를 순서대로 확인해 주세요.
- 서버 ID를 제대로 넣었는지 — 대상 서버에서 서버 ID를 다시 복사해
action:상태 확인으로 조회합니다. - 서브 봇이 이미 그 서버에서 다른 채널을 쓰고 있는지 — 사이드바 서버 목록에 각 봇이 어느 음성 채널에 있는지 표시됩니다. 여유 있는 봇이 없으면 새 채널에는 배정되지 않습니다.
- 위 두 가지가 문제없는데도 계속 거절되거나, 잠시 기다린 뒤 응답 시간 초과 오류가 나오면 운영팀에 문의해 주세요.
프리미엄을 끄면
그 이후의 새 배정만 막힙니다. 이미 서브 봇이 재생 중인 채널은 즉시 끊기지 않고, 그 재생이 끝날 때까지 그대로 유지됩니다.