디스코드 음악 봇 기능 안내

이 음악 봇은 Discord 서버에서 안정적으로 음악을 재생할 수 있도록 개발된 고급 기능을 갖춘 봇입니다. 명령어 입력뿐 아니라 메시지 감지로도 자동 재생을 지원합니다.

---

️ 주요 명령어

/재생 <노래>

• 유튜브, 사운드클라우드 등에서 음악 검색 및 재생
• 현재 음악이 재생 중이면 대기열에 자동 추가
• 재생 정보를 임베드로 출력

/정지

• 음악 중단 및 봇 음성 채널 퇴장
• 대기열과 반복 설정 초기화

/볼륨 <0~100>

• 음악 재생 볼륨 설정
• 기본값은 20

/반복

• 현재 트랙 반복 재생 모드 ON

/반복끄기

• 반복 재생 모드 OFF

/설정노래 <채널>

• 특정 텍스트 채널을 ‘노래 명령어 전용 채널’로 설정
• 관리자만 사용 가능 (특정 사용자 예외 처리 가능)

/대기열

• 현재 대기열에 있는 음악 목록 확인

/대기열삭제 <번호>

• 대기열에서 특정 음악 제거
• /대기열 명령어로 확인한 번호 기준

---

메시지 자동 감지 재생

• 설정된 텍스트 채널에서 사용자가 노래 제목이나 링크를 입력하면 자동으로 재생 또는 대기열에 추가
• 메시지는 자동 삭제됨 (봇이 메시지 관리 권한을 가졌을 경우)
• 노래 재생 정보는 해당 채널에 임베드로 출력됨

---

자동 재생 및 대기열 처리

• 음악이 끝나면:
• 반복 재생 모드면: 같은 트랙 반복
• 대기열이 존재하면: 다음 곡 자동 재생
• 자동 재생 및 대기열 재생 시에도 /재생 명령어와 동일한 임베드 메시지 출력
• 콘솔 로그:
• [자동재생] 곡 제목
• [대기열 YYYY-MM-DD HH:MM:SS] 서버명 | 곡 제목

---

기술 사양

• Python: 3.11+
• 라이브러리:
• discord.py (2.3+)
• wavelink (3.x)
• Lavalink 서버와 연결
• Cog 모듈 기반 확장 구조
• 일부 설정은 JSON 파일에 저장됨 (music_channels.json 등)

---

향후 예정 기능

• /스킵, /일시정지, /이전곡, /가사 명령어 추가 예정
• 투표 기반 스킵 및 곡 추천 기능 개발 예정

---