테마
음성 노드 확인 · 변경
봇의 음성 재생은 음성 노드라는 별도의 서버가 담당합니다. /서버 음성노드_확인 으로 지금 상태를 보고, /서버 음성노드_변경 으로 재생 중인 연결을 다른 노드로 옮길 수 있습니다.
두 명령 모두 서버 관리자만 쓸 수 있고, 변경은 일시적인 조치입니다. 이 페이지는 화면 읽는 법과 변경이 거절되는 경우, 그리고 노드가 자동으로 바뀌었을 때 오는 알림을 설명합니다.
음성 노드가 무엇인가요
봇이 목소리를 실제로 내보내는 서버입니다. 노드 이름은 kr-0, jp-1 처럼 리전 이름 + 번호로 되어 있습니다. kr 은 한국, jp 는 일본에 있는 노드라는 뜻입니다.
봇은 음성 채널에 들어갈 때마다 여유가 있는 노드를 자동으로 고릅니다. 평소에는 관리자가 신경 쓸 일이 없습니다.
노드 목록 자체는 바꿀 수 없습니다
어떤 노드가 있는지는 봇 운영진이 관리합니다. 서버 관리자가 노드를 새로 추가하거나 지울 수는 없고, 있는 노드 중에서 고르는 것만 가능합니다.
/서버 음성노드_확인
현재 활성화된 음성 노드 상태를 확인해요 라는 설명이 붙은 명령입니다. 결과는 실행한 사람에게만 보입니다.
노드가 하나도 없으면 노드 정보를 가져올 수 없어요 만 나옵니다.
화면 읽는 법
노드마다 항목이 하나씩 나옵니다.
text
🟢 kr-0 ◀ 현재
리전: kr
접속한 채널 수: 128 / ∞
🔴 jp-1
리전: jp
접속한 채널 수: 0 / 300| 표시 | 의미 |
|---|---|
| 이름 앞의 초록색 원 | 지금 쓸 수 있는 노드입니다 |
| 이름 앞의 빨간색 원 | 지금 연결되어 있지 않아 쓸 수 없는 노드입니다 |
◀ 현재 | 우리 서버가 지금 쓰고 있는 노드입니다 |
접속한 채널 수 | 그 노드가 지금 담당하는 음성 채널 수 / 최대치 (∞ 는 제한 없음) |
'접속한 채널 수' 는 우리 서버 수가 아닙니다
이 숫자는 그 노드를 함께 쓰는 모든 서버의 음성 채널을 합한 값입니다. 우리 서버가 몇 개 붙어 있는지를 알려주지 않습니다. 또 노드가 주기적으로 보고하는 값이라 실시간이 아닙니다. 봇이 막 재시작된 직후에는 0 으로 보이다가 잠시 뒤 제 숫자로 채워집니다.
/서버 음성노드_변경
활성화된 음성 노드 중 하나로 변경해요 라는 설명이 붙은 명령입니다. node 칸에 옮겨갈 노드 이름을 넣습니다.
자동완성
node 칸을 누르면 고를 수 있는 노드가 이런 형태로 나옵니다.
text
🟢 kr-0 [kr] 128/∞ ◀- 입력한 글자가 이름에 들어 있는 노드만 남습니다. 대소문자는 구분하지 않습니다.
- 최대 25개까지 보입니다.
- 맨 뒤의
◀는 지금 우리 서버가 쓰고 있는 노드라는 표시입니다.
거절되는 네 가지 경우
| 상황 | 응답 문구 |
|---|---|
| 그 이름의 노드가 없음 | '{이름}' 노드를 찾을 수 없거나 온라인이 아니에요 |
| 노드가 지금 쓸 수 없는 상태 | `{이름}` 노드가 현재 사용 불가 상태예요 |
| 봇이 음성 채널에 들어가 있지 않음 | 현재 재생 중인 플레이어가 없어요 |
| 이미 그 노드를 쓰는 중 | 이미 `{이름}` 노드를 사용 중이에요 |
모두 통과하면 노드 전환 완료 / '이전노드' → '새노드' (리전: '리전') 가 나옵니다.
"플레이어가 없어요" 가 가장 흔합니다
이 명령은 봇이 이미 음성 채널에 들어가 있을 때만 쓸 수 있습니다. 먼저 /들어와 로 봇을 부르거나 채팅으로 한 번 읽게 한 뒤에 실행해 주세요. 노드를 미리 정해 두는 기능은 없습니다.
변경 결과는 채널에 그대로 남습니다
/서버 음성노드_확인 은 실행한 사람에게만 보이지만, /서버 음성노드_변경 의 결과 메시지는 채널에 공개로 남습니다. 노드 이름과 리전이 보여도 괜찮은 채널에서 실행해 주세요.
변경은 일시적입니다
봇이 나갔다 들어오면 원래대로 돌아갑니다
바뀐 노드는 지금 연결에만 적용됩니다. 봇이 음성 채널을 나갔다가 다시 들어오면 노드는 다시 자동으로 선택됩니다. 특정 서버를 특정 노드에 고정하는 설정은 없습니다. 계속 같은 노드가 필요하다면 봇 운영진에게 문의해 주세요.
노드에 문제가 생기면 자동으로 옮겨집니다
쓰고 있던 노드에 연결 문제가 생기면, 봇이 알아서 살아 있는 다른 노드로 옮겨갑니다. 옮기고 나면 그 서버의 TTS가 켜져 있는 채널로 안내가 하나 갑니다.
text
⚠️ 음성 노드 자동 이전
**kr-0** 노드에 연결 문제가 발생했어요.
자동으로 **jp-1** 노드(`jp`)로 이전했어요.문구는 서버 언어에 맞춰 나옵니다.
이 알림을 받아도 관리자가 할 일은 없습니다
이전은 이미 끝난 상태이고 음성 연결도 유지됩니다. 읽던 문장 하나가 끊길 수 있지만 다음 문장부터는 정상입니다. 같은 알림이 반복해서 온다면 노드 자체가 불안정한 것이므로 봇 운영진에게 알려주세요.
알림이 없었다고 이전이 없었던 건 아닙니다
안내는 봇이 들어올 때 TTS가 활성화된 텍스트 채널로만 갑니다. 그 채널을 찾을 수 없으면 이전은 정상적으로 되고 안내만 생략됩니다. 실제로 어느 노드를 쓰는지는 /서버 음성노드_확인 의 ◀ 현재 표시로 확인해 주세요.
증상별 대조표
| 증상 | 확인할 것 |
|---|---|
노드 정보를 가져올 수 없어요 | 잠시 뒤 다시 실행해 보고, 계속 그러면 봇 운영진에게 문의해 주세요 |
| 모든 노드가 빨간색 | 봇 운영진에게 문의가 필요한 상태입니다 |
접속한 채널 수 가 0 인데 소리는 잘 남 | 봇이 막 재시작된 직후입니다. 잠시 뒤 다시 확인해 주세요 |
현재 재생 중인 플레이어가 없어요 | 봇을 먼저 음성 채널에 불러주세요 |
| 노드를 바꿔도 소리가 안 남 | 다른 노드로 한 번 더 바꿔보고, 그래도 안 되면 봇 운영진에게 문의해 주세요 |
| 바꿔놨는데 원래 노드로 돌아감 | 정상 동작입니다. 봇이 나갔다 들어오면 다시 자동 선택됩니다 |