음악

음악 기능은 서버의 음성 채널에서 함께 음악을 듣고 큐를 관리하는 기능이에요. 재생 명령, 공개 플레이어, DJ 권한, 음악 노드 상태를 함께 봐야 안정적으로 운영할 수 있어요.

무엇을 할 수 있나요?

기능 설명
재생 검색어나 링크로 음악을 재생해요
다음 곡 목록을 보고 순서를 관리해요
제어 일시정지, 재개, 스킵, 정지 같은 동작을 처리해요
DJ 권한 스킵이나 정지 같은 제어 권한을 역할로 나눠요
공개 플레이어 현재 곡과 큐, 제어 버튼을 채팅 채널에 보여요
가사 가능한 경우 현재 곡의 가사를 찾아 보여요

지원되는 소스와 재생 안정성은 서버의 음악 런타임과 외부 플랫폼 상태에 따라 달라질 수 있어요. 모든 음악 플랫폼의 재생을 보장한다고 쓰면 안 돼요.

처음 설정하는 순서

  1. 음악 모듈을 켜요.
  2. 음악 명령을 사용할 채팅 채널을 정해요.
  3. 음악을 들을 음성 채널과 봇 입장 권한을 확인해요.
  4. DJ 역할을 정하고 일반 멤버가 할 수 있는 제어 범위를 나눠요.
  5. 공개 플레이어를 둘 채널을 정해요.
  6. 짧은 곡으로 재생, 스킵, 정지, 큐 확인을 테스트해요.

DJ 권한을 나눠요

작은 서버에서는 모든 멤버가 기본 제어를 해도 괜찮아요. 하지만 사람이 많은 서버에서는 DJ 역할을 만들어 스킵, 정지, 반복, 큐 정리 같은 동작을 맡기는 편이 좋아요.

권한을 나누면 누군가가 실수로 재생을 멈추거나 큐를 지우는 일을 줄일 수 있어요.

공개 플레이어를 사용해요

공개 플레이어는 채팅 채널에서 현재 곡, 진행 상태, 큐, 제어 버튼을 보여 주는 메시지예요. 멤버가 명령어를 몰라도 버튼으로 기본 동작을 사용할 수 있어요.

플레이어 메시지를 수동으로 삭제하면 다시 게시해야 할 수 있어요. 버튼이 동작하지 않으면 DJ 권한, 메시지 컴포넌트 상태, 봇 권한을 함께 확인해 주세요.

음악 노드 상태를 확인해요

음악 명령은 정상인데 재생이 실패한다면 설정 문제가 아니라 음악 노드나 외부 소스 문제일 수 있어요.

확인할 항목은 이렇게 나눠요.

  • 봇이 음성 채널에 들어갈 수 있는지
  • 음악 노드가 연결되어 있는지
  • 검색 소스가 응답하는지
  • 현재 세션이 꼬이지 않았는지
  • 서버 네트워크나 외부 플랫폼 제한이 있는지

가사와 함께 쓰기

가사 기능은 재생 중인 곡 정보를 기준으로 가사를 찾아요. 곡 제목과 아티스트 정보가 정확할수록 결과가 좋아져요.

라이브 버전, 리믹스, 커버곡은 가사나 타이밍이 맞지 않을 수 있어요. 가사가 없거나 틀리면 곡 정보를 더 정확히 입력하거나 나중에 다시 시도해 주세요.

잘 안 되나요?

이런가요 이렇게 해 보세요
봇이 음성 채널에 안 들어와요 음성 채널 보기, 연결, 말하기 권한을 확인해요
재생이 시작되지 않아요 음악 노드 상태와 외부 소스 응답을 확인해요
아무나 스킵해요 DJ 역할과 제어 권한을 조정해요
플레이어 버튼이 안 돼요 공개 플레이어 메시지와 버튼 권한을 확인해요
가사가 안 나와요 곡 제목, 아티스트, 지원 여부를 확인해요

캡처 기준

캡처 보여 줄 내용
음악 설정 모듈 상태, 채널 제한, DJ 역할
공개 플레이어 현재 곡, 큐, 재생 제어 버튼
큐 화면 대기열과 요청자 정보
오류 상태 노드 연결 실패나 권한 경고