ciwie사용 가이드
음악을 함께 듣는 방법.
설정은 Discord에서. 음악도 Discord에서.
처음 시작하기
- 관리 권한이 있는 서버에 Ciwie를 초대해요.
- 음악 신청에 사용할 텍스트 채널에서
/setchannel을 실행해요. 서버 관리자만 설정할 수 있어요. - 음성 채널에 참여해요.
- 지정한 음악 채널에 노래 제목, YouTube 영상 링크 또는 플레이리스트 링크를 보내요.
음악 채널에는 재생 상태와 대기열을 보여주는 임베드 메시지가 표시돼요. 이 메시지 아래 리액션으로 음악을 제어할 수 있어요.
명령어
/setchannel- 현재 텍스트 채널을 음악 전용 채널로 설정해요.
/setdjrole- 재생을 관리할 DJ 역할을 설정해요.
/remove- 대기열에서 곡을 제거해요. Discord에서 명령어를 입력하면 필요한 옵션이 표시돼요.
임베드와 리액션
리액션은 아래 순서로 배치돼요. 페이지 이동은 대기열 표시를 바꾸며, 재생 중인 곡을 바꾸지 않아요.
| 리액션 | 기능 |
|---|---|
| ⏹️ 정지 | 재생을 끝내고 대기열을 정리해요. |
| 🔁 반복 | 반복 없음 → 전체 반복 → 한 곡 반복 순서로 전환해요. |
| 🔀 셔플 | 셔플 설정을 바꿔요. |
| ⏭️ 스킵 | 현재 곡을 넘기거나 스킵에 투표해요. |
| ⏯️ 재생·일시정지 | 음악을 잠시 멈추거나 이어서 들어요. |
| ⬅️ ➡️ 페이지 | 대기열의 이전·다음 페이지를 확인해요. |
제어 권한
관리자·DJ·봇 소유자는 재생을 관리할 수 있어요. 정지는 이 권한이 있는 사람이 음성 채널 밖에서도 사용할 수 있어요.
스킵은 관리자·DJ·봇 소유자·곡 신청자가 바로 실행할 수 있어요. 일반 참여자는 과반수 투표가 필요해요. 음성 채널을 떠난 사람의 표는 제외돼요.
문제 해결
설정 메시지가 만들어지지 않아요.
봇에게 채널 보기, 메시지 보내기, 링크 임베드, 메시지 기록 보기, 리액션 추가, 메시지 관리 권한이 있는지 확인해요. 채널별 권한 설정이 서버 역할 권한을 덮어쓸 수 있어요.
음성 채널에서 소리가 안 들려요.
연결·말하기·음성 감지 사용 권한과 서버 음소거 여부를 확인해요. Discord에서 봇의 사용자 볼륨이 0인지도 확인해주세요.
특정 영상만 재생되지 않아요.
삭제, 비공개, 연령·지역 제한 등으로 사용할 수 없는 영상일 수 있어요. 다른 공개 영상이나 검색어로 시도해주세요.
사람이 모두 나가면 어떻게 되나요?
빈 음성 채널에서는 음악이 일시정지되고, 5분 뒤 채널을 떠나요.