스튜디오 연홍 문서

테마

처음 쓰는 연홍 ​

연홍은 디스코드 채팅을 음성 채널에서 소리로 읽어 주는 봇입니다. 마이크를 켜지 않아도 채팅만 치면 음성 채널에 있는 사람들이 그 문장을 목소리로 들을 수 있어요.

이 페이지는 봇을 처음 부르는 방법, 나중에 "왜 안 읽지?" 하고 헤매지 않도록 알아 두면 좋은 규칙, 그리고 나머지 문서가 어디에 있는지 를 한 장에 모았습니다. 명령어 하나하나가 궁금하다면 명령어 전체 목록 을 봐 주세요.

1분 만에 첫 소리 듣기 ​

  1. 음성 채널에 먼저 들어갑니다.
  2. 소리로 읽히길 원하는 채팅 채널에서 /들어와 를 실행해 주세요.
  3. 봇이 내가 있는 음성 채널로 들어오고, 명령을 실행한 채팅 채널에 안내가 한 번 올라옵니다.
  4. /들어와 를 실행한 그 채팅 채널에 아무 말이나 써 보세요. 바로 읽힙니다.
  5. 다 썼으면 /나가 로 내보냅니다.

/들어와 를 쓰려면 먼저 음성 채널에 들어가 있어야 해요. 그렇지 않으면 봇이 먼저 음성 채널에 들어가주세요 라고 나에게만 보이는 메시지로 답합니다.

세 음성 명령의 자세한 동작과 안내 문구는 음성 채널 명령어 에 정리돼 있습니다.

무엇이 어디에 있나 ​

왼쪽 사이드바는 디스코드에서 실제로 입력하는 명령어 그룹대로 나뉘어 있어요. 찾는 내용이 어느 묶음에 있는지 먼저 고르면 빠릅니다.

묶음이런 것을 다뤄요
서버서버 전체에 적용되는 설정. 대부분 서버 관리자가 씁니다.
유저내 별명·목소리·피치·속도처럼 나에게만 적용되는 설정.
목소리어떤 목소리를 고를 수 있고, 어떤 문장이 어떻게 읽히는지.
멤버십등급이 무엇을 열어 주는지, 코드 등록과 활성화.

서버 — 서버 전체 설정 (/서버) ​

서버에 봇을 막 초대했다면 처음 초대했다면 — 5분 설정 가이드 부터 보시면 됩니다.

유저 — 나만의 설정 (/유저) ​

목소리 — 무엇을 어떻게 읽어 주나 (/커스텀보이스) ​

멤버십 — 등급과 활성화 (/멤버십) ​

어느 묶음에도 속하지 않는 명령이 넷 있어요. 봇을 부르고 내보내는 /들어와 · /나가 · /스킵 은 음성 채널 명령어 에, 봇 상태를 보는 /정보 는 /정보 — 봇 상태 확인하기 에 있습니다.

규칙 1 — 봇은 '불러온 채널'에서만 읽어요 ​

연홍은 서버의 모든 채팅을 읽지 않습니다. 음성 채널에 들어올 때 기준이 된 채팅 채널 하나만 읽어요.

봇이 들어온 방법읽는 채팅 채널
/들어와 로 불렀을 때그 명령을 실행한 채팅 채널
자동 접속으로 들어왔을 때자동 접속을 일으킨 그 메시지가 올라온 채팅 채널

WARNING

다른 채팅 채널에 아무리 써도 봇은 아무 안내 없이 그냥 넘어갑니다. 오류 메시지도, 반응 이모지도 없어서 "봇이 음성 채널에는 들어와 있는데 채팅을 안 읽는다"처럼 보여요. 읽히길 원하는 채팅 채널에서 /나가 를 한 뒤 /들어와 를 다시 실행하면 그 채널이 새 기준이 됩니다.

규칙 2 — 개인 설정은 서버마다 따로예요 ​

목소리·별명·피치·속도 같은 개인 설정은 서버마다 하나씩 따로 저장됩니다. A 서버에서 목소리를 바꿔도 B 서버의 내 목소리는 그대로예요.

새 서버에 처음 들어가면 그 서버의 내 설정은 기본값부터 시작합니다. 고장이 아니라 원래 그렇게 동작해요.

/유저 설정 에서 목소리를 바꾸면 [모든 서버에 적용] 버튼이 뜨는데, 여기에는 알아 둘 조건이 있습니다. 자세한 내용은 내 목소리 설정 에서 다룹니다.

규칙 3 — 명령어는 서버 안에서만 동작해요 ​

연홍의 슬래시 명령은 전부 서버 전용입니다. 봇에게 DM 을 보내 명령을 실행하면 이 명령어는 서버에서만 사용할 수 있어요 라는 답만 돌아와요.

봇이 점검 중일 때도 같은 방식으로 막힙니다. 이때는 현재 점검중으로 사용이 어렵습니다. 잠시 후 다시 시도해주세요. 가 뜨고, 봇이 음성 채널에서 나갑니다. 점검이 끝나면 /들어와 로 다시 불러 주세요.

자동 접속 — 부르지 않아도 따라 들어오게 하기 ​

자동접속 을 켜 두면 /들어와 없이도, 음성 채널에 있는 사람이 채팅을 치는 순간 봇이 그 음성 채널로 따라 들어옵니다.

이 기능은 기본적으로 꺼져 있고, 서버 관리자만 /서버 설정 에서 켤 수 있어요. 일반 멤버는 켤 수 없습니다.

TIP

자동 접속을 켠 서버에서는 "봇이 아직 음성 채널에 없을 때 처음 채팅을 친 사람"이 기준이 됩니다. 그 사람이 있는 음성 채널로 들어오고, 그 사람이 글을 쓴 채팅 채널이 읽기 대상 채널이 돼요.

이런 메시지는 읽지 않아요 ​

처음 쓸 때 자주 당황하는 경우만 먼저 추렸습니다. 전체 규칙은 봇이 읽어주는 문장의 규칙 에 있어요.

  • // 로 시작하는 메시지 — 일부러 읽지 않게 만드는 표시입니다. 음성 채널에 있는 사람들에게 굳이 들려주고 싶지 않은 말에 쓰면 돼요.
  • 너무 긴 메시지 — 기본 100자를 넘으면 원문 대신 너무 긴 글은 읽을 수 없어요 가 읽힙니다. 앞부분만 잘라 읽어 주는 것이 아니라 문장이 통째로 바뀝니다.
  • 사운드보드 단어가 섞인 메시지 — 등록된 단어가 공백으로 끊긴 낱말로 하나라도 들어 있으면 그 소리만 나가고 문장은 읽히지 않아요. 낱말 안에 붙어 있는 경우 (인사말 안의 인사)는 반응하지 않습니다. 사운드보드 를 참고해 주세요.
  • 블랙리스트에 오른 사람의 메시지 — 서버 관리자가 지정합니다.
  • 한꺼번에 메시지가 몰렸을 때 — 읽기 대기열이 꽉 차면 새 메시지는 안내 없이 넘어갑니다. /나가 로 대기열을 비우고 다시 /들어와 를 실행하면 정리돼요.

봇 이름은 서버 언어에 맞춰 정해져요 ​

봇이 서버에 들어오면 별명을 스스로 맞춥니다. 서버 언어가 한국어면 연홍, 일본어면 ヨンホン, 그 밖이면 Yeonhong 이 돼요. 서버 언어가 정해져 있지 않으면 서버 이름에 쓰인 글자를 보고 판단합니다.

NOTE

별명 자동 설정에는 봇에게 별명 변경(Change Nickname) 권한이 필요합니다. 권한이 없으면 이름이 바뀌지 않을 뿐 다른 기능에는 영향이 없어요. 서버 관리자가 이름을 다시 맞추고 싶으면 /서버 이름동기화 를 쓰면 됩니다.

관련 문서 ​