테마
슬래시 명령어 전체 목록
연희가 모든 서버에 등록하는 슬래시 명령어는 18개예요. 여기 없는 이름은 쓸 수 없는 명령입니다. /음악 재생 처럼 두 단계로 들어가는 명령은 없고, 전부 한 단계로 바로 실행됩니다.
한눈에 보기
| 명령어 | 옵션 | 하는 일 |
|---|---|---|
/재생 | 검색어(필수), 소스 | 곡 또는 재생목록을 대기열 뒤에 추가하고, 멈춰 있으면 바로 재생을 시작합니다 |
/검색 | 검색어(필수), 소스 | 결과 최대 10곡을 선택 메뉴로 보여주고 고른 것만 대기열에 넣습니다 |
/다음재생 | 검색어(필수), 소스 | /재생 과 같지만 대기열 맨 앞에 끼워 넣습니다 |
/현재곡 | — | 지금 곡의 제목·아티스트·경과 시간·소스·볼륨·반복 모드를 보여줍니다 |
/대기열 | — | 지금 곡과 다음 곡 목록을 보여줍니다 |
/일시정지 | — | 재생을 멈춥니다 |
/다시재생 | — | 멈춘 재생을 이어서 다시 시작합니다 |
/정지 | — | 재생을 멈추고 대기열을 전부 비웁니다 |
/스킵 | — | 현재 곡을 건너뜁니다 |
/들어와 | — | 내가 있는 음성 채널로 봇을 부릅니다(곡은 넣지 않음) |
/나가 | — | 봇을 음성 채널에서 내보냅니다 |
/반복 | 모드(필수) | 반복 모드를 바꿉니다 |
/섞기 | — | 대기열에 남은 곡의 순서를 무작위로 섞습니다 |
/볼륨 | 값 | 값을 주면 볼륨을 바꾸고, 비우면 현재 볼륨만 알려줍니다 |
/탐색 | 시간(필수) | 현재 곡의 특정 위치로 이동합니다 |
/음악노드_확인 | — | 음악 재생 서버의 연결 상태를 보여줍니다 |
/cmd_dashboard_name | — | 웹 대시보드로 가는 링크 버튼을 띄웁니다(아래 참고) |
/정보 | — | 봇 전체 상태와 응답 속도, 이 서버의 재생 상황을 보여줍니다 |
응답은 전부 나에게만 보이는 메시지로 와요. 대기열에 곡을 넣어도 채널에는 아무것도 남지 않습니다.
옵션 상세
| 옵션 이름 | 쓰이는 명령 | 필수 | 입력 형태 |
|---|---|---|---|
검색어 | /재생 /검색 /다음재생 | 예 | 자유 입력. 곡 제목이나 공식 링크 |
소스 | /재생 /검색 /다음재생 | 아니오 | 고정 선택지 4개 |
모드 | /반복 | 예 | 고정 선택지 3개 |
값 | /볼륨 | 아니오 | 정수 0 ~ 100 |
시간 | /탐색 | 예 | 자유 입력. 시간 형식 문자열 |
옵션에 자동완성은 없어요. 검색어 를 치는 도중에 후보가 뜨거나 하지 않고, 다 입력한 뒤 엔터를 눌러야 검색이 시작됩니다.
소스 선택지
YouTube · YouTube Music · SoundCloud · Spotify 네 개예요. 비워 두면 링크가 아닌 이상 YouTube 검색으로 갑니다. 각 소스가 실제로 어떻게 다른지는 검색과 소스 고르기에서 다뤄요.
모드 선택지
꺼짐 · 현재 곡 · 대기열 세 개예요. 각 모드가 무슨 뜻인지는 대기열 · 반복 · 섞기에 있습니다.
시간 입력
1:23, 1:02:03, 90s, 2m, 1h, 500ms, 그리고 숫자만 쓰면 초로 읽어요. 알아듣지 못하면 아래 메시지가 나옵니다.
text
❌ 시간을 이해하지 못했어요. `1:23`, `90s`, `2m`처럼 입력해주세요자세한 규칙은 /탐색 시간 입력 형식을 보세요.
응답 예시
| 상황 | 봇이 보내는 문구 |
|---|---|
| 곡 한 개 추가 | ✅ (곡 제목 - 아티스트)을(를) 대기열에 추가했어요 |
/다음재생 으로 추가 | ✅ (곡 제목 - 아티스트)을(를) 다음 곡으로 추가했어요 |
| 재생목록 추가 | ✅ (목록 이름)에서 12곡을 대기열에 추가했어요 |
/일시정지 | ⏸️ 재생을 일시정지했어요 |
/다시재생 | ▶️ 음악을 다시 재생해요 |
/정지 | ⏹️ 재생을 정지하고 대기열을 비웠어요 |
/스킵 | ⏭️ 현재 곡을 건너뛰었어요 |
/섞기 | ✅ 대기열을 섞었어요 |
/반복 | 🔁 반복 모드가 (모드 이름)(으)로 변경되었어요 |
/볼륨 (값 없이) | 현재 볼륨: 60% |
/볼륨 값: 60 | 🔊 볼륨을 60%로 설정했어요 |
/탐색 성공 | 🎛️ 1:23 위치로 이동했어요 |
/들어와 | (채널 이름)에 연결했어요! |
/나가 | 음성 채널에서 나갔어요 |
누가 무엇을 쓸 수 있나
명령마다 필요한 권한이 달라요. 아래가 서버 설정을 건드리지 않았을 때의 기본값입니다.
| 조작 | 기본 권한 | 해당 명령 |
|---|---|---|
| 일시정지 / 다시재생 | 누구나 | /일시정지 /다시재생 |
| 스킵 | 그 곡을 넣은 사람 또는 DJ | /스킵 |
| 이전 곡 | 그 곡을 넣은 사람 또는 DJ | 컨트롤러 ⏮️ 버튼 |
| 볼륨 | DJ | /볼륨 |
| 정지 | DJ | /정지 |
| 탐색 | DJ | /탐색 |
| 반복 | DJ | /반복 |
| 섞기 | DJ | /섞기 |
- 서버 관리자 권한을 가진 사람은 위 표와 관계없이 전부 쓸 수 있어요.
- "DJ" 는 서버 관리자가 지정한 DJ 역할을 가진 사람을 뜻합니다. 지정된 역할이 없으면 관리자 외에는 DJ 조작을 쓸 수 없어요.
- 권한이 없으면
이 조작을 사용할 권한이 없어요가 나옵니다. - 위 표에 없는 명령(
/재생/검색/다음재생/들어와/나가/현재곡/대기열/정보/음악노드_확인)은 누구나 쓸 수 있어요. 이 중/재생/검색/다음재생/들어와/나가는 음성 채널에 들어가 있어야 하고,/현재곡/대기열/정보/음악노드_확인은 음성 채널 밖에서도 그냥 됩니다. /볼륨은 값을 줄 때만 권한을 봐요. 값 없이 현재 볼륨만 물어보는 것은 누구나 할 수 있습니다.
WARNING
/나가 도 누구나 쓸 수 있어요. 같은 음성 채널에 있는 사람이면 재생 중인 음악을 끊고 봇을 내보낼 수 있고, 누가 그랬는지는 봇이 알려주지 않습니다. 이게 곤란한 서버라면 디스코드 서버 설정의 통합(Integrations) 화면에서 연희의 /나가 명령을 특정 역할·채널로 제한해 두세요.
알아 둘 만한 차이
/정지 와 /나가
/정지 는 재생을 멈추고 대기열을 비우지만 봇은 음성 채널에 남아요. 컨트롤러 카드는 빈 카드로 바뀝니다. 바로 내보내려면 /나가 를 쓰세요. 그대로 두면 얼마 뒤 봇이 알아서 나갑니다 — 자세한 조건은 봇이 저절로 멈추거나 나가는 경우에 있어요.
/스킵 과 컨트롤러 ⏭️ 버튼
같은 동작이지만 확인 절차가 달라요. 컨트롤러의 ⏭️ 버튼은 대기열에 다음 곡이 없으면 대기열에 다음 곡이 없어요 라고 미리 알려주고 아무것도 하지 않습니다. /스킵 에는 그 확인이 없어요.
/음악노드_확인 과 /정보
둘 다 상태를 보는 명령이고 누구나 쓸 수 있어요. /음악노드_확인 은 음악 재생 서버가 정상 연결돼 있는지, 지금 몇 곳에서 재생 중인지를 보여줍니다. /정보 는 봇 전체 상황(재생 중인 서버 수, 켜져 있던 시간), 응답 속도, 그리고 이 서버의 현재 곡·대기열·볼륨·반복 모드를 보여줘요. 소리가 끊기거나 재생이 안 될 때 /음악노드_확인 부터 눌러 보면 봇 문제인지 알기 쉽습니다.
대시보드 링크 명령
웹 대시보드로 가는 링크 버튼을 띄우는 명령이 하나 있어요.
NOTE
현재 이 명령은 /cmd_dashboard_name 이라는 이름으로 보입니다. 명령 목록에서 /대시보드 를 찾으면 나오지 않으니 /cmd_dashboard_name 을 찾으세요. 응답에 뜨는 링크 버튼은 정상적으로 대시보드로 연결됩니다.
명령을 쓰지 않고 대시보드에 들어가는 방법도 있어요.
- 브라우저 주소창에 대시보드 주소를 직접 입력합니다. 주소는 서버 관리자에게 물어보면 알려 줍니다.
- 재생 중이라면 컨트롤러 카드 아래쪽의 링크 버튼을 눌러도 같은 곳으로 갑니다.
들어간 다음에 무엇을 할 수 있는지는 웹 대시보드 시작하기에 있어요. 플레이리스트, 가사, 재생 기록, 대기열 편집처럼 디스코드 명령에는 없는 기능은 대시보드에서 씁니다 — 대시보드 화면 둘러보기를 보세요.