테마
연희 봇 시작하기
연희는 디스코드 음성 채널에서 음악을 틀어 주는 봇이에요. 조작은 슬래시 명령어와, 채널에 뜨는 컨트롤러 카드의 버튼으로 합니다. 이 페이지는 봇이 이미 서버에 들어와 있다는 전제로, 첫 곡을 트는 데 필요한 최소한만 설명해요.
30초 안에 첫 곡 틀기
- 음성 채널에 먼저 들어가세요. 이게 빠지면 재생·조작 명령(
/재생/검색/다음재생/들어와/나가/일시정지등)이 전부먼저 음성 채널에 들어가주세요만 돌려줘요. 확인용 명령(/현재곡/대기열/정보/음악노드_확인)은 음성 채널 밖에서도 됩니다. - 아무 텍스트 채널에서
/재생을 입력하고검색어칸에 곡 제목이나 링크를 넣습니다. - 봇이 음성 채널에 들어와 재생을 시작하고, 명령을 쓴 텍스트 채널에 컨트롤러 카드를 하나 띄웁니다.
- 그다음부터는 명령어를 다시 칠 필요 없이 카드의 버튼으로 조작하면 돼요.
text
/재생 검색어: 아이유 밤편지
→ ✅ `밤편지 - IU`을(를) 대기열에 추가했어요곡을 더 넣고 싶으면 /재생 을 계속 쓰면 됩니다. 이미 재생 중이면 대기열 뒤에 쌓이고, 지금 곡 바로 다음에 끼워 넣고 싶으면 /다음재생 을 쓰세요.
TIP
검색 결과를 직접 골라서 넣고 싶으면 /재생 대신 /검색 을 써 보세요. 최대 10곡이 선택 메뉴로 나오고, 그중 하나를 고르면 대기열에 들어갑니다. 자세한 건 검색과 소스 고르기에 있어요.
명령어는 슬래시로만 씁니다
!재생, y!play 같은 접두어 명령은 없어요. 연희는 채팅창에 친 글을 읽지 않고, 슬래시 명령어와 버튼·선택 메뉴·입력창으로만 조작합니다.
그래서 명령어를 찾는 방법은 하나예요. 채팅창에 / 를 치고 연희 아이콘을 고르면 쓸 수 있는 명령이 전부 나옵니다.
봇의 답은 나에게만 보여요
명령어에 대한 응답은 거의 전부 나에게만 보이는 메시지(디스코드가 "회원님만 볼 수 있어요" 라고 표시하는 그것)로 옵니다. /재생 으로 곡을 넣어도 다른 사람 화면에는 아무것도 뜨지 않고, /현재곡 /대기열 /정보 같은 확인용 명령도 마찬가지예요.
채널에 남아서 모두가 보는 것은 두 가지입니다.
- 컨트롤러 카드 — 서버당 한 개만 유지되는 재생 카드예요. 곡이 바뀌면 카드 내용이 갱신됩니다.
- 재생 오류 알림 — 곡을 트는 데 실패하면
⚠️ (곡 이름) 재생 중 오류가 발생했어요가 채널에 올라옵니다.
NOTE
"내가 곡을 넣었는데 채널에 아무 흔적이 없다"는 건 정상이에요. 대기열에 잘 들어갔는지 확인하려면 /대기열 을 쓰거나 컨트롤러 카드의 📜 버튼을 눌러 보세요.
처음 쓸 때 자주 걸리는 것
소리가 너무 작아요
새로 추가된 서버의 시작 볼륨은 8% 입니다. 고장이 아니라 기본값이에요. /볼륨 값: 60 처럼 올려서 쓰세요. 값의 범위는 0에서 100까지이고, 한 번 바꾼 볼륨은 그 서버에 저장돼 다음에도 유지됩니다.
볼륨 조절은 기본적으로 DJ 역할이 있어야 해요. 권한 기본값은 슬래시 명령어 전체 목록의 권한 표에 정리해 뒀습니다.
곡이 너무 길다고 거절당해요
기본 설정에서 10분을 넘는 곡은 재생하지 않습니다. 아래 메시지가 나오면 이 제한에 걸린 거예요.
text
❌ 이 곡은 너무 길어요. 최대 `10:00`까지 재생할 수 있어요다만 라이브 방송처럼 길이가 정해지지 않은 항목은 이 제한을 받지 않습니다.
링크를 넣었는데 거절당해요
아무 링크나 되는 건 아니에요. YouTube, Spotify, SoundCloud 공식 주소만 받습니다. 그 밖의 주소는 YouTube, Spotify, SoundCloud 공식 링크만 사용할 수 있어요 로 막혀요. 넣을 수 있는 주소 목록은 검색과 소스 고르기에 있습니다.