테마
사운드보드 등록 · 삭제
사운드보드는 채팅에 특정 단어가 나오면 미리 올려 둔 소리를 음성 채널에 재생하는 기능입니다. 등록과 삭제는 /서버 사운드보드_* 명령어로 하고, 켜고 끄는 것은 /서버 설정 의 사운드보드 토글로 합니다.
이 페이지는 관리자가 파일을 올리고 지우는 절차와, 등록한 뒤에 자주 겪는 문제를 다룹니다. 멤버 입장의 사용법은 사운드보드 사용자 가이드 에 있습니다.
명령어 세 개
| 명령어 | 입력값 | 쓸 수 있는 사람 |
|---|---|---|
/서버 사운드보드_추가 | name (이름), file (첨부파일) | 서버 관리자 |
/서버 사운드보드_목록 | 없음 | 모든 멤버 |
/서버 사운드보드_제거 | name (이름) | 서버 관리자 |
세 명령 모두 응답은 실행한 사람에게만 보입니다.
파일 조건
/서버 사운드보드_추가 는 파일을 받기 전에 두 가지를 확인합니다.
| 조건 | 값 | 어길 때 나오는 응답 |
|---|---|---|
| 확장자 | .mp3 · .ogg · .wav | mp3, ogg, wav 파일만 업로드할 수 있어요 |
| 크기 | 8MB 이하 | 파일 크기는 8MB 이하여야 해요 |
확장자는 파일 이름의 마지막 확장자 로만 판단합니다. 실제 형식이 다른데 이름만 .mp3 로 바꾼 파일은 이 검사를 통과한 뒤 등록 도중 실패합니다.
이름 짓기
이름은 공백 없는 한 단어 로 지으세요. 재생 여부는 메시지를 공백으로 나눈 각 단어가 등록한 이름과 정확히 같은지로 판단합니다. 내 소리 처럼 공백이 든 이름은 어떤 단어와도 같아질 수 없어 영영 재생되지 않습니다.
- 대문자와 소문자는 다른 이름으로 봅니다.
- 앞뒤에 문장부호가 붙으면 일치하지 않습니다.
짠!이라고 쓰면짠은 걸리지 않습니다. - 이름은 100자 이내로 지으세요. 더 길면 등록에 실패할 수 있습니다.
WARNING
흔한 단어를 이름으로 쓰지 마세요. 등록 단어가 하나라도 걸리면 그 메시지는 소리만 재생되고 문장은 읽지 않습니다. ㅋ 나 네 같은 흔한 단어를 등록하면 사실상 읽기가 멈춘 것처럼 보입니다. 특정 단어가 든 메시지만 읽히지 않는다면 /서버 사운드보드_목록 으로 그 단어가 등록돼 있는지 확인하고, 흔하지 않은 이름으로 다시 등록하세요.
같은 이름으로 다시 올릴 때
지원 안 함
같은 이름으로 다른 파일을 올리면 사운드보드에 '이름'이(가) 추가되었어요 라는 성공 응답이 나오지만, 재생되는 소리는 처음 올린 파일 그대로입니다.
소리를 바꾸려면 다른 이름으로 새로 등록하세요. 예전 이름은 /서버 사운드보드_제거 로 지우면 됩니다.
제거
/서버 사운드보드_제거 name:<이름> 을 실행하면 '이름' 사운드보드가 제거되었어요 라는 응답이 나옵니다.
WARNING
없는 이름을 넣어도 같은 성공 메시지가 나옵니다. 이름에 오타가 있어도 '오타이름' 사운드보드가 제거되었어요 라고 응답하고, 지우려던 것은 그대로 남습니다. 제거한 직후에 /서버 사운드보드_목록 을 실행해 실제로 사라졌는지 확인하세요. 이름은 대소문자까지 정확히 입력해야 합니다.
소리가 나기까지 필요한 조건
등록이 끝났다고 바로 소리가 나는 것은 아닙니다. 아래가 전부 맞아야 재생됩니다.
- 봇이 음성 채널에 들어와 있고, 메시지가 봇이 읽고 있는 채널에 올라왔을 것
/서버 설정의사운드보드토글이 켜져 있을 것 — 기본값은 켜짐입니다- 메시지를 공백으로 나눈 단어 중 하나가 등록한 이름과 정확히 같을 것
서버 볼륨 설정은 사운드보드에 적용되지 않습니다
/서버 설정 의 볼륨(dB)은 봇이 읽어주는 목소리에만 적용됩니다. 사운드보드 소리에는 영향을 주지 않으므로, 재생되는 크기는 올린 파일 자체의 음량 으로 정해집니다.
너무 크거나 작다면 파일을 직접 편집해 다시 올려야 합니다. 이때 같은 이름으로 올리면 소리가 바뀌지 않으니 새 이름으로 등록하세요.
오류 응답 대조표
| 응답 | 원인 |
|---|---|
mp3, ogg, wav 파일만 업로드할 수 있어요 | 확장자가 셋 중 하나가 아님 |
파일 크기는 8MB 이하여야 해요 | 파일이 8MB를 넘음 |
파일 처리 중 오류가 발생했어요 | 파일을 처리하지 못함. 확장자만 바꾼 파일이거나 내용이 비어 있는 경우가 많습니다 |
API 연결에 실패했어요 | 잠시 뒤 다시 시도하고, 계속 그렇다면 스튜디오 연홍에 문의하세요 |
등록된 사운드보드가 없어요 | 이 서버에 등록된 사운드보드가 하나도 없음 |
증상별 대조표
| 증상 | 확인할 것 |
|---|---|
| 등록은 됐는데 소리가 안 남 | 사운드보드 토글, 봇이 음성 채널에 있는지, 이름이 공백 없는 한 단어인지 |
| 이름을 정확히 쳤는데도 반응 없음 | 대소문자, 그리고 앞뒤에 문장부호가 붙지 않았는지 |
| 파일을 바꿔 올렸는데 예전 소리가 남 | 같은 이름으로는 소리가 바뀌지 않습니다. 새 이름으로 등록하세요 |
| 지웠는데 목록에 그대로 | 이름 오타. 제거는 실패해도 성공 메시지가 나옵니다 |
| 특정 단어가 든 메시지만 읽히지 않음 | 그 단어가 사운드보드 이름으로 등록돼 있는지 |
| 소리가 너무 크거나 작음 | 파일 자체의 음량을 조절해 새 이름으로 다시 등록하세요 |