Commands

이 문서는 MusicBot에 사용되는 명령어를 설명해놓았습니다. Private message로 MusicBot에게 명령어를 보내면 정상적으로 작동하지 않습니다. 모든 명령어는 사용자가 설정한 문자로 시작합니다. 이 페이지는 해당 문자가 기본 설정인 !라고 가정하고 설명하고 있습니다. 반드시 필요한 파라미터는 <> 로 감싸여 있고 선택적인 파라미터는 []로 감싸여져 있습니다.

기본

• !help [command] - 명령어의 목록이나 특정 명령어의 정보를 출력합니다.
• !play <URL/query> - 특정한 URL에서 음악을 재생하거나 YouTube에서 검색어를 검색하고 첫 번째 결과를 대기열에 넣습니다.
• !queue - 재생 목록을 표시합니다.
• !np - 현재 재생중인 음악을 표시합니다.
• !skip - 현재 재생중인 음악을 스킵할 지 투표합니다. 필요한 찬성 비율은 config 파일에서 설정할 수 있습니다. 봇의 주인은 !skip f로 즉시 스킵할 수 있습니다.
• !search [service] [#] <query> - <query>에 대해 특정 서비스 (기본값 : YT)를 검색하고 처음 몇 개의 결과를 반환합니다.(기본값은 3개이고 최대 10개의 결과까지 반환합니다) 그 후 유저는 결과값의 일부를 큐에 추가할 수 있습니다.
• !shuffle - 재생 목록을 섞습니다.
• !clear - 재생 목록을 초기화합니다.
• !pause - 현재 음악을 일시정지합니다.
• !resume - 현재 음악을 다시 재생합니다.
• !volume [number] - 봇의 볼륨을 세팅합니다. number는 1부터 100까지 선택할 수 있습니다. 상대적인 숫자(예를 들어, +10) 도 입력 가능하며 현재 볼륨에 해당 숫자를 더하거나 뺀 수치로 변경됩니다. 파라미터가 없으면 현재 볼륨을 표시합니다.
• !summon - 봇을 현재 보이스 채널에 연결시킵니다. 이 명령어를 실행하려면 권한이 있어야 합니다.
• !clean <number> - number만큼 봇이 보낸 메시지를 삭제하여 효과적으로 채널을 정리합니다. 봇에 서버에서 메시지 관리가 있으면! play와 같은 사용자 명령 메시지도 삭제됩니다.
• !blacklist <status> <@user1>... - 블랙리스트에 유저를 추가하거나 제거합니다. 블랙리스트에 있는 사용자는 봇을 컨트롤 할 수 없습니다. 사용 권한 파일에 설정된 권한은 무시됩니다. 소유자는 블랙리스트에 올릴 수 없으며 명령에 여러 사용자를 지정할 수 있습니다. 사용자는 @유저네임 형식으로 지정되어야 합니다, 상태는 +,-,add,remove가 될 수 있습니다.
• !perms - 유저에게 봇의 권한을 포함한 메세지를 보냅니다.
• !stream <url> - URL을 스트리밍합니다. URL은 트위치나 유튜브 등의 라이브 스트리밍 사이트가 될 수 있습니다. 이 명령어는 실험중임으로 약간의 문제가 있을 수 있습니다.
• !save - 현재 음악을 오토 플레이 리스트에 저장합니다.
• !karaoke - 서버에서 karaoke 모드를 킵니다. karaoke 모드 중에는 BypassKaraokeMode 권한을 가진 유저만이 음악을 플레이 할 수 있습니다.

관리

• !joinserver - 다른 서버에 봇을 추가하는 데 사용할 수있는 URL을 생성합니다. 이 명령은 봇의 소유자만 사용 가능합니다.
• !pldump <playlist> - YouTube 재생 목록 또는 Soundcloud 세트에서 URL을 수집하여 자동 재생 목록에 복사 할 수있는 텍스트 파일로 덤프합니다.
• !setavatar [url] - 봇의 아바타를 지정된 URL 또는 업로드 된 이미지로 변경합니다. 명령을 메시지 (주석)로 사용하여 이미지를 업로드하는 경우 URL을 지정할 필요가 없습니다.
• !setname <name> - 봇의 디스코드 이름을 바꿉니다.(닉네임을 바꾸지는 않습니다).디스코드는 이 변경을 2시간에 한번으로 제한해 놨습니다.
• !setnick <nick> - 서버에서의 봇의 닉네임을 바꿉니다. 이 명령어를 실행하기 위해 권한이 필요합니다.
• !disconnect - 보이스 채널로부터 봇을 추방시킵니다.
• !restart - 봇을 재시작합니다.
• !shutdown - 봇을 종료합니다.
• !option <option> <y/n> - 봇을 종료하지 않고 설정 옵션을 변경합니다. 자세한 정보는 !help를 입력해서 볼 수 있습니다.
• !remove <number> - number위치에 있는 음악을 재생목록에서 제거합니다. 음악의 위치는 !queue를 입력하여 볼 수 있습니다.

개발자

이 명령은 파이썬이 어떻게 작동하는지 알고 있는 사람과 봇 개발자를 위한 것입니다. 따라서 이 명령어를 사용하기 위해서는 옵션 파일에서 추가 권한을 부여해야 합니다. 매우 위험할 수 있으므로 수행중인 작업과 잠재적인 결과를 확신하지 않는 한 이 명령을 실행하지 마십시오.

• !breakpoint - 디버깅 breakpoint를 활성화합니다.
• !objgraph [func] - 오브젝트 그래프를 리턴합니다.
• !debug - 임의의 코드를 평가합니다. 이 명령어는 굉장히 위험한 명령어이니 사용에 주의하십시오.