테마
처음 초대했다면 — 5분 설정 가이드
연홍 봇은 초대 직후에도 대부분의 기능이 기본값 그대로 동작합니다. 설정을 하나도 건드리지 않았다고 해서 봇이 아무 반응을 안 하는 일은 거의 없습니다.
이 페이지는 서버 그룹의 진입 문서 입니다. 위에서부터 순서대로 따라가면 필수 설정이 끝나고, 각 단계마다 더 깊이 들어갈 문서로 이어집니다.
체크리스트 한눈에 보기
| 단계 | 자세한 문서 | |
|---|---|---|
| ☐ | 1. 봇 권한이 있는지 확인합니다 | 아래 1단계 |
| ☐ | 2. /서버 언어동기화 로 서버 언어와 봇 이름을 정합니다 | 실시간 번역 · 서버 언어 · 봇 이름 동기화 |
| ☐ | 3. /서버 설정 을 열어 화면을 익힙니다 | /서버 설정 대시보드 전체 안내 |
| ☐ | 4. 기본 목소리와 볼륨을 확인합니다 | 서버 기본 목소리 · 볼륨 · 피치 · 속도 · 도배 제한 |
| ☐ | 5. 켜고 끌 기능을 훑어봅니다 | 기능 토글 전체 해설 |
| ☐ | 6. /들어와 로 동작을 확인합니다 | 음성 채널 명령어 — /들어와 · /나가 · /스킵 |
여기까지가 필수입니다. 아래는 필요할 때만 하면 되는 선택 단계입니다.
| 선택 단계 | 자세한 문서 | |
|---|---|---|
| ☐ | 읽을 채널을 좁힙니다 | 채팅 채널 · 음성 채널 허용 목록 |
| ☐ | 단어에 효과음을 붙입니다 | 사운드보드 등록 · 삭제 |
| ☐ | ㅎㄱ → 합격 같은 규칙을 만듭니다 | 초성 변환 규칙 관리 |
| ☐ | 특정 멤버의 메시지를 읽지 않게 합니다 | TTS 블랙리스트 |
| ☐ | 번역을 일반 멤버에게 열어줍니다 | /서버 권한 — 일반 멤버에게 기능 열어주기 |
| ☐ | 소리가 끊길 때 재생 서버를 옮깁니다 | 음성 노드 확인 · 변경 |
관리자 명령을 쓸 수 있는 사람
/서버 로 시작하는 명령은 아래 둘 중 하나에 해당해야 실행됩니다.
- 이 서버에서 관리자 권한을 가진 멤버
- 스튜디오 연홍의 디렉터 로 등록된 계정
둘 다 아니면 권한이 없다는 응답이 돌아옵니다. 역할에 관리자 권한만 있으면 되고, 서버 소유자일 필요는 없습니다.
NOTE
예외가 둘 있습니다. /서버 사운드보드_목록 은 서버의 아무 멤버나 실행할 수 있고, /서버 번역 은 번역 위임을 켜 두면 일반 멤버도 쓸 수 있습니다.
초대 직후 자동으로 일어나는 일
자동으로 처리되는 것은 봇 별명 한 가지뿐 입니다. 채널을 새로 만들거나 역할을 건드리는 동작은 없습니다.
| 시점 | 무슨 일이 일어나나 |
|---|---|
| 봇이 서버에 들어온 순간 | 디스코드 서버 언어를 보고 별명을 연홍 · ヨンホン · Yeonhong 중 하나로 바꿉니다 |
| 서버 언어가 한국어·일본어가 아닐 때 | 서버 이름 에 한글이 있으면 한국어, 가나가 있으면 일본어, 둘 다 없으면 영어로 추정합니다 |
| 이 서버에서 슬래시 명령이 처음 실행될 때 | 명령을 실행한 그 사람의 디스코드 앱 언어 에 맞춰 별명을 한 번 더 바꿉니다 |
WARNING
봇 이름이 엉뚱한 언어로 굳을 수 있습니다. 초대 직후의 별명은 서버 언어로 정해지지만, 그다음에 처음 슬래시 명령을 쓴 사람의 개인 언어 설정이 이를 덮어씁니다. 한국어 서버라도 앱 언어를 영어로 쓰는 관리자가 첫 명령을 실행하면 봇 이름이 Yeonhong 으로 남습니다. 알아채는 법은 간단합니다 — 멤버 목록에서 봇 이름을 보면 됩니다. 고치는 방법은 아래 2단계에 있습니다.
NOTE
봇에게 별명 변경 권한이 없으면 이름은 바뀌지 않습니다. 봇 이름은 한국어·영어·일본어 세 가지만 지원합니다.
아무것도 설정하지 않아도 되는 것
아래는 기본값 그대로 두어도 되는 항목입니다.
| 항목 | 기본값 | 의미 |
|---|---|---|
| 기본 목소리 (한국어/영어/일본어) | 여성-1 / woman-1 / Nanami | 개인 설정이 없으면 이 목소리로 읽습니다 |
| 볼륨 | 0.0 dB | 줄이지 않은 상태입니다. 이 값이 최대치입니다 |
| 피치 · 속도 | 0.0 · 1.0 | 목소리 고정이 꺼져 있으면 개인 설정이 우선합니다 |
| 도배 제한 | 5 글자 | 같은 글자가 5회를 넘으면 5회로 줄여서 읽습니다 |
| 채팅 · 음성 허용 채널 | 비어 있음 | 비어 있으면 모든 채널 허용 입니다 |
| 도배보호 · 초성변환 · 기본초성사전 · 사운드보드 · 외부유저읽기 | 켜짐 | 나머지 토글은 전부 꺼져 있습니다 |
각 토글의 기본값과 효과는 기능 토글 전체 해설에 정리돼 있습니다.
TIP
헷갈리는 기본값 하나만 기억하면 됩니다 — 자동접속은 꺼져 있습니다. 초대만 해서는 봇이 스스로 음성 채널에 들어가지 않습니다. 누군가 /들어와 를 실행해야 읽기 시작합니다.
1단계. 봇 권한을 먼저 확인합니다
서버 설정에서 봇 역할에 아래 권한이 있는지 봅니다.
- 별명 변경 — 없으면 봇 이름이
연홍으로 정리되지 않습니다. - 음성 채널 연결 / 말하기 — 없으면
/들어와가 실패합니다. - 메시지 보기 / 메시지 기록 보기 — 읽을 채팅을 못 보면 TTS 가 동작하지 않습니다.
여기서 빠진 권한이 있으면 뒤 단계가 전부 실패하므로 가장 먼저 확인합니다.
2단계. /서버 언어동기화 로 서버 언어를 정합니다
가장 먼저 실행할 명령입니다. 현재 언어를 뺀 나머지 두 언어 버튼이 뜨고, 누르면 두 가지가 동시에 일어납니다.
- 이 서버의 언어가 한국어 · 영어 · 일본어 중 하나로 저장됩니다.
- 봇 별명이 그 언어에 맞는 이름으로 즉시 바뀝니다.
여기서 정한 언어는 봇이 음성 채널에 들어갈 때 보내는 안내 메시지, 그리고 입·퇴장 안내 문구의 언어를 결정합니다. 따로 정하지 않으면 디스코드 서버 언어를 따르고, 그것이 한국어·영어·일본어가 아니면 안내를 영어 로 읽습니다.
언어를 바꿨는데도 봇 이름이 그대로라면 /서버 이름동기화 를 한 번 더 실행하세요. 세 명령의 차이와 번역 기능은 실시간 번역 · 서버 언어 · 봇 이름 동기화에 있습니다.
NOTE
이 화면의 버튼은 120초 뒤에 비활성화됩니다. 시간이 지났으면 명령을 다시 실행하세요.
3단계. /서버 설정 을 열어 화면을 익힙니다
/서버 설정 은 이 서버의 TTS 설정 전부를 한 장에 모아 보여 주는 대시보드입니다. 앞으로의 설정은 대부분 이 화면 안에서 끝납니다.
- 위쪽 텍스트에 현재 값이 전부 적혀 있습니다.
- 아래 세 줄이 조작 영역입니다 — 토글 셀렉트 메뉴 하나, 수치·목소리 버튼 다섯 개, 채널·초성 버튼 세 개.
- 화면은 180초 뒤 잠깁니다. 회색으로 죽은 버튼이 보이면 명령을 다시 실행하세요.
영역별로 무엇이 표시되는지, 두 관리자가 동시에 만졌을 때 무엇이 어긋나는지는 /서버 설정 대시보드 전체 안내에서 다룹니다.
4단계. 기본 목소리와 볼륨을 확인합니다
같은 화면에서 볼 곳은 두 군데입니다.
- 기본 목소리 —
[목소리 변경 🎙️]로 언어별 서버 기본 목소리를 고릅니다. 고를 수 있는 목록은 서버 멤버십 등급에 따라 달라집니다. - 수치 설정 — 볼륨은 여기서만 정할 수 있고 항상 적용됩니다. 피치·속도는 목소리 고정을 켰을 때만 의미가 있습니다.
IMPORTANT
목소리고정 이 꺼져 있으면 서버 기본 목소리는 사실상 적용되지 않습니다. 목소리는 멤버 개인 설정이 우선이기 때문입니다. 서버 전체를 하나의 목소리로 통일하려면 5단계에서 목소리고정 을 켜세요.
값의 범위와 "바꿨는데 왜 안 바뀌지?" 의 답은 서버 기본 목소리 · 볼륨 · 피치 · 속도 · 도배 제한에 있습니다.
5단계. 켜고 끌 기능을 훑어봅니다
/서버 설정 첫 줄의 셀렉트 메뉴에서 토글 13종을 켜고 끕니다. 고르는 즉시 반대로 바뀌어 저장되고, 저장 버튼은 없습니다.
첫 설정에서 판단할 것은 대개 이 셋입니다.
| 토글 | 켤지 판단하는 기준 |
|---|---|
| 자동접속 | 켜면 유저가 음성 채널에 있는 상태로 채팅만 쳐도 봇이 들어옵니다. 끄면(기본) /들어와 로만 들어옵니다 |
| 목소리고정 | 서버 전체를 한 목소리로 통일하고 싶을 때만 켭니다 |
| 입장알림 · 퇴장알림 | 음성 채널을 드나드는 사람을 소리로 알리고 싶을 때 켭니다 |
나머지 열 종의 동작과 서로 영향을 주는 조합은 기능 토글 전체 해설에 정리돼 있습니다.
TIP
자동접속을 켤 계획이라면 아래 선택 단계의 채널 지정을 함께 검토하는 편이 좋습니다. 지정하지 않으면 모든 채팅 채널이 자동 입장 트리거가 됩니다.
6단계. 동작을 확인합니다
- 음성 채널에 들어갑니다.
- 아무 텍스트 채널에서
/들어와를 실행합니다. - 그 채널에 안내 메시지가 오면 정상입니다.
- 같은 채널에 아무 문장이나 써 봅니다.
봇은 /들어와 를 실행한 채널 에서만 읽습니다. 다른 채널에 쓰면 조용히 넘어갑니다. 또 // 로 시작하는 메시지는 일부러 읽지 않습니다.
부르고 내보내고 건너뛰는 세 명령은 음성 채널 명령어 — /들어와 · /나가 · /스킵에 있습니다.
여기까지 소리가 났다면 필수 설정은 끝났습니다.
선택 1. 읽을 채널을 좁힙니다
[채팅 채널 💬] 과 [음성 채널 🎙️] 버튼에서 각각 지정합니다. 두 목록 모두 비어 있으면 전체 허용 이라는 점이 핵심입니다. 채널을 딱 하나 넣으면 나머지 채널에서는 TTS 가 멈춥니다.
WARNING
/들어와 로 부른 경우에는 두 허용 목록을 전부 무시 하고 봇이 들어온 채널을 읽습니다. "채널을 지정했는데 왜 다른 채널이 읽히지?" 의 답이 대부분 이것입니다. /나가 로 봇을 내보내면 원래 규칙으로 돌아옵니다.
자세한 규칙과 함정은 채팅 채널 · 음성 채널 허용 목록에 있습니다.
선택 2. 단어에 효과음을 붙입니다
/서버 사운드보드_추가 name:<이름> file:<첨부파일> 로 mp3 · ogg · wav 파일을 올리면, 그 단어가 채팅에 나올 때 소리가 재생되고 그 메시지는 읽지 않습니다. 이름은 공백 없는 한 단어로 짓고, ㅋ 이나 네 같은 흔한 단어는 피하세요.
등록·삭제 절차와 소리가 나지 않을 때 확인할 것은 사운드보드 등록 · 삭제에 있습니다.
선택 3. 초성 변환 규칙을 만듭니다
/서버 설정 의 [초성변환 📝] 버튼에서 이 서버 전용 치환 규칙을 등록합니다. ㅎㄱ 을 합격 으로 읽게 하는 식입니다. 기본 사전과의 적용 순서, 규칙끼리 겹칠 때의 주의점은 초성 변환 규칙 관리에 있습니다.
선택 4. 문제 유저를 차단합니다
/서버 블랙리스트 추가 user:<멤버> 로 특정 유저의 메시지를 TTS 에서 제외합니다. 차단된 유저는 자동접속 트리거도 만들지 못합니다. 자세한 내용은 TTS 블랙리스트를 보세요.
선택 5. 번역을 일반 멤버에게 열어줍니다
/서버 번역 은 기본적으로 관리자 전용입니다. /서버 권한 에서 번역 위임을 켜면 일반 멤버도 켜고 끌 수 있습니다. 다만 아무 멤버나 바꿀 수 있게 된다는 점을 먼저 확인하세요 — /서버 권한 — 일반 멤버에게 기능 열어주기.
선택 6. 소리가 끊길 때 재생 서버를 옮깁니다
봇의 음성 재생은 음성 노드라는 별도의 서버가 담당하고, 평소에는 자동으로 골라집니다. 특정 시점에 소리가 계속 끊긴다면 /서버 음성노드_확인 으로 상태를 보고 /서버 음성노드_변경 으로 다른 노드로 옮길 수 있습니다 — 음성 노드 확인 · 변경.
설정은 언제 반영되나요
/서버 설정 의 값은 버튼을 누르는 즉시 저장되고, 다음 메시지부터 바로 반영됩니다. 봇을 재시작하거나 다시 초대할 필요는 없습니다.
굳이 하지 않아도 되는 것
- 봇을 다시 초대해 설정 초기화하기 — 초기화되지 않습니다. 봇이 서버에서 나갔다가 다시 들어와도 예전 설정이 그대로 살아 있습니다.
/서버 번역을 미리 켜 두기 — 봇이 재시작되면 이 설정은 초기화됩니다. 재시작 뒤 다시 켜 주세요. 자세한 내용은 실시간 번역 · 서버 언어 · 봇 이름 동기화를 보세요.