테마
컨트롤러 메시지 채널 고정 · 통합
연희는 재생을 시작하면 그 채널에 컨트롤러 메시지(재생 중인 곡, 조작 버튼, 대기열 버튼, 대시보드 링크)를 보냅니다. 기본값은 "명령을 쓴 채널을 따라다니기"인데, 이걸 특정 채널에 못 박는 것이 컨트롤러 설정입니다.
설정 위치는 대시보드 설정 → 컨트롤러 섹션이고, 서버 관리자만 열 수 있습니다. 접근 조건은 누가 대시보드를 쓸 수 있나를 보세요.
화면에 있는 항목
| 항목 | 뜻 | 기본값 |
|---|---|---|
| 현재 재생중 메시지 고정 | 채널 고정 기능 자체의 on/off | 꺼짐 |
| 채널 통합 | 모든 봇이 채널 하나를 공유할지 | 꺼짐 |
| 고정 채널 (공통) | 통합 모드에서 쓰는 채널 하나 | 없음 |
| 봇별 고정 채널 | 봇마다 따로 지정하는 채널 | 비어 있음 |
처음 초대한 서버는 고정도 통합도 꺼진 상태로 시작합니다.
어느 채널에 뜨는지 — 3단 우선순위
- 고정이 꺼져 있으면 재생을 시작한 채널에 뜹니다. 슬래시 명령을 쓴 채널이고, 대시보드로 시작했다면 봇이 이미 쓰고 있던 채널입니다.
- 고정이 켜져 있고 통합도 켜져 있으면 공통 고정 채널 하나에만 뜹니다. 공통 채널이 비어 있으면 1번으로 내려갑니다.
- 고정이 켜져 있고 통합이 꺼져 있으면 그 봇에 지정된 채널 → 공통 채널 → 재생을 시작한 채널 순으로, 처음 찾은 곳에 뜹니다.
3번의 의미가 중요합니다. 봇별 분리 모드에서도 봇에 지정된 채널이 없으면 공통 채널로 떨어집니다. 서브 봇 채널을 지정하지 않고 분리 모드만 켜면 결국 모든 봇이 공통 채널에 모입니다.
통합 모드와 봇별 분리 모드
| 채널 통합 ON | 채널 통합 OFF (기본) | |
|---|---|---|
| 화면 | 채널 선택 하나 | 봇마다 선택 한 줄씩 |
| 결과 | 모든 봇의 컨트롤러가 같은 채널에 쌓임 | 봇마다 다른 채널에 하나씩 |
| 적합한 상황 | 메인 봇만 쓰는 서버 | 서브 봇으로 여러 채널을 동시에 트는 서버 |
봇 목록에는 지금 켜져 있는 봇만 나옵니다. 꺼져 있는 서브 봇은 목록에 보이지 않습니다.
NOTE
"채널 통합"과 "봇별 고정 채널"은 고정이 켜져 있을 때만 조작할 수 있습니다. 고정이 꺼져 있으면 두 항목이 흐리게 표시됩니다. 고정을 끄고 저장하면 공통 채널 값이 지워지지만, 봇별 채널 값은 그대로 남습니다. 고정을 다시 켜면 예전 봇별 지정이 되살아납니다.
선택할 수 있는 채널
목록에는 텍스트 채널과 음성 채널이 모두 나옵니다. 음성 채널 안의 채팅도 컨트롤러를 놓을 수 있는 자리이기 때문입니다. 항목 앞에 텍스트 · / 음성 · 접두사가 붙고, 텍스트 채널이 먼저 나옵니다.
WARNING
저장할 때 controller channel is invalid 오류가 나오면, 고른 채널이 그 사이 삭제됐거나 봇이 그 채널을 볼 수 없는 경우입니다. 설정 화면을 새로고침해 목록을 다시 받은 뒤 채널을 다시 골라 주세요. 목록에 원하는 채널이 아예 없다면 봇에게 그 채널의 보기 권한을 먼저 주셔야 합니다.
서브 봇 채널 지정은 프리미엄 서버만
봇별 분리 모드에서 메인 봇이 아닌 줄은, 프리미엄이 아닌 서버에서는 프리미엄 배지와 함께 잠깁니다. 프리미엄이 아닌 서버에는 서브 봇이 배정되지 않으므로 값을 넣어도 쓰이지 않습니다. 프리미엄 여부는 프리미엄(서브 봇) 켜기에서 확인하세요.
저장하면 컨트롤러가 새로 만들어집니다
컨트롤러 설정을 저장하면 순서가 이렇습니다.
- 대상 채널에 컨트롤러 메시지를 새로 보냅니다.
- 그 채널에 있던 기존 컨트롤러 메시지를 지웁니다.
- 직전 컨트롤러가 다른 채널에 있었다면 그것도 지웁니다.
결과적으로 채널을 바꿔 저장하면 이전 채널의 컨트롤러는 사라지고 새 채널 맨 아래에 새 메시지가 뜹니다.
NOTE
아무것도 재생하고 있지 않으면 저장해도 메시지가 움직이지 않습니다. 설정은 정상적으로 저장돼 있고, 다음에 봇이 음성 채널에 들어갈 때 새 채널에 컨트롤러가 생깁니다.
컨트롤러 메시지는 한 채널에 하나만 남도록 봇이 알아서 정리합니다. 봇을 재시작한 직후에는 잠깐 여러 개로 보일 수 있는데, 정리가 아직 그 채널에 닿지 않은 것이므로 잠시 기다리면 하나만 남습니다.
컨트롤러 버튼과 권한
| 버튼 | 필요한 권한 |
|---|---|
| 이전 곡 | 이전 곡 |
| 일시정지·재생 | 일시정지/재생 |
| 정지 | 정지 |
| 다음 곡 | 다음 곡 |
| 볼륨 | 볼륨 조절 (누르면 입력 창이 뜹니다) |
| 대기열 | 없음 (본인에게만 보이는 목록) |
권한 레벨의 뜻은 DJ 역할과 조작별 권한에 있습니다. 버튼은 음성 채널에 들어가 있지 않아도 눌립니다 — 권한 레벨만 통과하면 됩니다. 그래서 아무나 들어오는 채널에 컨트롤러를 두면 조작이 잦아질 수 있습니다.
컨트롤러 아래 대시보드 링크 버튼의 라벨이 영문으로 보일 수 있습니다. 링크 자체는 정상 동작합니다.
서브 봇이 보낸 컨트롤러의 버튼은 그 서브 봇이 처리합니다. 봇별 분리 모드에서 채널이 서로 다르면 채널마다 담당 봇이 다르다는 뜻입니다.