테마
/재생 · /검색 · /다음재생
연희에서 가장 많이 쓰는 명령 세 개예요. 셋 다 하는 일은 같습니다 — 곡을 찾아서 대기열에 넣는 것. 다른 점은 딱 두 가지입니다. 후보를 보여주느냐, 그리고 대기열 어디에 넣느냐.
세 명령 모두 검색어 칸이 필수이고, 소스 칸은 비워 둘 수 있어요.
먼저 음성 채널에 들어가세요
세 명령 모두 내가 음성 채널에 들어가 있어야 동작합니다. 봇이 이미 채널에 있든 없든 상관없이, 명령을 쓰는 사람이 음성 채널 밖에 있으면 아무것도 하지 않고 이 문구만 돌아와요.
text
먼저 음성 채널에 들어가주세요봇을 미리 불러 둘 필요는 없습니다. 음성 채널에 들어간 상태에서 /재생 을 쓰면 봇이 알아서 따라 들어와요.
셋 중 무엇을 쓸까
| 명령 | 후보를 보여주나 | 어디에 들어가나 | 이럴 때 |
|---|---|---|---|
/재생 | 아니오 | 대기열 맨 뒤 | 곡 제목이 확실하거나 링크가 있을 때 |
/검색 | 예 (최대 10곡) | 대기열 맨 뒤 | 같은 제목의 곡이 여럿이라 눈으로 고르고 싶을 때 |
/다음재생 | 아니오 | 대기열 맨 앞 | 지금 곡이 끝나면 바로 이 곡을 틀고 싶을 때 |
지금 아무것도 재생 중이 아니라면 셋 다 결과가 같아요. 넣은 곡이 곧바로 재생됩니다. 차이가 드러나는 건 이미 대기열에 곡이 쌓여 있을 때예요.
/재생
가장 기본이 되는 명령이에요. 후보를 보여주지 않고 가장 잘 맞는 결과를 곧바로 대기열 맨 뒤에 넣습니다.
text
/재생 검색어: 아이유 밤편지
→ ✅ `밤편지 - IU`을(를) 대기열에 추가했어요- 지금 재생 중인 곡이 없으면 넣자마자 재생이 시작되고, 명령을 쓴 텍스트 채널에 컨트롤러 카드가 뜹니다.
- 이미 재생 중이면 대기열 맨 뒤에 쌓여요. 현재 곡은 끊기지 않습니다.
검색어칸에는 곡 제목을 써도 되고 주소를 붙여 넣어도 됩니다.
재생목록 링크를 넣었을 때
재생목록 주소를 넣으면 곡 하나가 아니라 목록 전체가 들어갑니다. 응답 문구도 달라져요.
text
✅ `내 플레이리스트`에서 12곡을 대기열에 추가했어요몇 곡이 들어갔는지가 숫자로 나오니, 넣은 곡 수와 다르면 중간에 빠진 곡이 있다는 뜻이에요. 빠지는 이유와 한 번에 들어가는 곡 수 상한은 검색과 소스 고르기에 정리돼 있습니다.
/다음재생
쓰는 법은 /재생 과 완전히 같고, 들어가는 자리만 달라요. 대기열 맨 앞에 끼워 넣습니다. 지금 재생 중인 곡이 끝나면 다음으로 나오는 곡이 이 곡이 돼요.
text
/다음재생 검색어: 아이유 밤편지
→ ✅ `밤편지 - IU`을(를) 다음 곡으로 추가했어요응답 문구가 대기열에 추가했어요 가 아니라 다음 곡으로 추가했어요 로 나오면 제대로 들어간 거예요.
NOTE
지금 재생 중인 곡은 건드리지 않아요. /다음재생 은 현재 곡을 끊고 바로 틀어 주는 명령이 아닙니다. 지금 당장 듣고 싶다면 /다음재생 으로 넣은 다음 /스킵 을 쓰세요.
CAUTION
/다음재생 을 연달아 여러 번 쓰면 나중에 넣은 곡이 앞으로 갑니다. 세 곡을 순서대로 넣었다면 실제 재생 순서는 넣은 순서의 반대가 돼요. 여러 곡을 원하는 순서대로 예약하고 싶다면 첫 곡만 /다음재생 으로 넣고 나머지는 /재생 으로 이어 붙이는 편이 안전합니다.
재생목록 주소를 /다음재생 에 넣으면 목록 전체가 맨 앞으로 들어갑니다. 곡 수가 많으면 대기열에 원래 있던 곡들이 한참 뒤로 밀리니 주의하세요.
/검색
제목만으로는 어느 음원인지 알기 어려울 때 쓰는 명령이에요. 후보를 목록으로 보여주고, 내가 고른 것만 들어갑니다.
/검색 검색어: (곡 제목)을 실행합니다. 원하면소스도 같이 고를 수 있어요.(검색어) 검색 결과예요. 재생할 곡을 선택해주세요와 함께 선택 메뉴가 뜹니다.- 메뉴를 열면 후보가 줄줄이 나와요. 각 줄에 제목, 그 아래 작은 글씨로 아티스트와 길이가 붙습니다.
- 하나를 고르면 그 곡만 대기열에 들어가고, 메뉴는 사라지면서
✅ ...을(를) 대기열에 추가했어요로 바뀝니다.
메뉴에 뜨는 안내 문구는 재생할 곡을 선택해요 예요.
선택 메뉴의 규칙
| 규칙 | 내용 |
|---|---|
| 최대 10곡 | 검색 결과가 아무리 많아도 앞에서 10곡까지만 보여줍니다 |
| 60초 | 메뉴가 뜬 지 60초가 지나면 만료됩니다 |
| 실행한 사람만 | /검색 을 쓴 본인만 고를 수 있습니다 |
| 한 번만 | 하나를 고르면 그 메뉴는 끝납니다. 두 곡을 넣으려면 다시 검색하세요 |
| 맨 뒤로 | 고른 곡은 대기열 맨 뒤에 들어갑니다. 맨 앞이 아니에요 |
고르지 않고 그냥 두면
아무것도 고르지 않고 두면 60초 뒤에 그대로 만료돼요. 따로 취소할 필요는 없습니다. 메뉴는 화면에 남아 있지만, 만료된 뒤에 누르면 아래 문구가 나오고 아무 일도 일어나지 않아요.
text
⚠️ 검색 선택 시간이 만료되었어요. 다시 검색해주세요한참 전에 띄워 둔 메뉴, 봇이 다시 켜지기 전에 띄워 둔 메뉴도 마찬가지입니다. 그냥 /검색 을 다시 쓰면 돼요.
NOTE
다른 사람이 띄운 검색 메뉴는 눌러도 고를 수 없어요. 검색을 실행한 본인만 사용할 수 있다는 안내가 나옵니다. 내가 고르고 싶으면 /검색 을 직접 실행하세요.
WARNING
프리미엄 서버에서 내가 있는 음성 채널에 두 번째 봇이 붙어 있으면 /검색 이 제대로 동작하지 않습니다 지원 안 함. 그 채널에서는 /재생 을 쓰거나 주소를 직접 붙여 넣어 주세요. 어떤 상황인지는 여러 채널에서 동시에 듣기(프리미엄)에 있어요.
소스 옵션
세 명령 모두 소스 칸을 하나씩 갖고 있어요. 직접 입력하는 칸이 아니라 아래 넷 중에서 고르는 선택지입니다.
YouTubeYouTube MusicSoundCloudSpotify
비워 두는 것이 기본이고, 대부분은 비워 두는 게 낫습니다. 비워 두면 알아서 찾아 주고, 주소를 붙여 넣은 경우에는 소스 를 골라도 그 주소가 우선이라 사실상 의미가 없어요.
각 선택지가 실제로 무엇을 하는지, 왜 Spotify 를 고르면 다른 곡이 나올 수 있는지는 검색과 소스 고르기 — 지원 링크에서 자세히 다룹니다. 붙여 넣을 수 있는 주소 목록도 같은 페이지에 있어요.
입력하는 도중에는 후보가 안 떠요
검색어 칸에는 자동완성이 없습니다. 글자를 치는 도중에 곡 후보가 내려오지 않아요. 다 입력하고 엔터를 눌러야 그때부터 곡을 찾기 시작합니다. 후보를 보고 싶으면 /검색 을 쓰세요.
답은 나에게만 보여요
세 명령의 응답은 전부 나에게만 보이는 메시지로 옵니다. 곡을 넣어도 채널에는 흔적이 남지 않아요. 다른 사람 눈에 보이는 건 재생이 시작되면서 뜨는 컨트롤러 카드뿐입니다.
무엇이 들어갔는지 확인하려면 /대기열 을 쓰거나 컨트롤러 카드의 📜 버튼을 누르세요 — 대기열 · 반복 · 섞기에서 다룹니다.
잘 안 될 때
| 나오는 문구 | 뜻과 대처 |
|---|---|
먼저 음성 채널에 들어가주세요 | 음성 채널에 들어간 뒤 다시 실행하세요 |
❌ (검색어)에 맞는 곡을 찾지 못했어요 | 검색은 됐는데 결과가 없었어요. 아티스트 이름을 붙여 다시 해 보세요 |
❌ 이 곡은 너무 길어요 | 기본 설정에서 10분이 넘는 곡은 재생하지 않아요 |
YouTube, Spotify, SoundCloud 공식 링크만 사용할 수 있어요 | 받지 않는 주소예요. 넣을 수 있는 주소는 소스 페이지에 있습니다 |
결과가 안 나올 때는 소스 를 골라 뒀는지부터 확인해 보세요. 특정 소스를 지정하면 그 소스에 없는 곡은 아예 찾지 못합니다. 비우고 다시 실행하면 걸리는 경우가 많아요.
누가 쓸 수 있나
/재생 /검색 /다음재생 은 음성 채널에 들어가 있는 사람이면 누구나 쓸 수 있어요. DJ 역할이나 관리자 권한이 필요하지 않습니다.
곡을 넣는 것과 달리 정지·스킵·볼륨 같은 조작은 권한이 갈려요. 기본값은 슬래시 명령어 전체 목록의 권한 표에 정리돼 있습니다.