커스텀 명령어 | Noxyr 문서

커스텀 명령어란

커스텀 명령어는 Noxyr에 이미 있는 명령어에 붙이는 새 이름이에요. $store는 $shop을, $done은 $ticket close를, $gnitro는 상품을 Discord Nitro로 미리 채운 $giveaway create를 실행할 수 있어요. 멤버는 서버 접두사를 붙여 새 이름을 메시지로 입력하고, 봇은 실제 명령어를 실행해요.

새로운 동작을 추가하지는 않아요. 실제 명령어는 자체 권한, 모듈 스위치, 쿨다운을 그대로 따르므로, 커스텀 이름으로 원래 없던 권한을 얻을 수는 없어요. 원래 이름도 새 이름과 함께 계속 작동해요.

만들어 보기

대시보드를 열고 서버를 고른 뒤, 제어 → 커스텀 명령어로 이동하세요.
새 커스텀 명령어를 누르거나, 템플릿을 열어 하나를 클릭하면 완성된 명령어가 바로 추가돼요.
트리거 칸에 새 이름을 입력하세요. 예: store.
명령어 칸에서 실행할 명령어를 고르고, 그 명령어에 여러 동작이 있다면 동작을 고르세요(티켓에는 닫기, 담당, 이름 변경 등이 있어요).
선택 사항으로 값을 연결해 옵션을 미리 채울 수 있어요. 예: prize를 Discord Nitro로 설정.
편집을 멈추고 약 1초 뒤 자동으로 저장돼요. 저장 버튼 옆의 상태 표시에서 저장 여부를 확인할 수 있어요.

커스텀 명령어는 접두사 명령어예요. / 메뉴가 아니라 $store 같은 메시지로 작동해요. Discord는 봇이 자신의 슬래시 명령어만 등록하도록 허용하며, 서버마다 따로 등록할 수는 없어요.

그래프 보기와 간단한 목록 보기

이 페이지에는 같은 목록을 보는 두 가지 방식이 있어요. 그래프 보기는 각 커스텀 명령어를 명령어에 연결된 트리거로 보여 주고, 값은 옵션에 연결해서 보여 줘요. 점을 다른 점에 끌어다 놓으면 연결되고, 선을 클릭하면 끊어지고, 상자는 제목을 드래그해서 옮길 수 있어요. 정리 버튼은 모든 선을 다시 정렬해요.

간단한 목록 보기는 같은 내용을 이름, 명령어 선택, 미리 설정된 값이 있는 일반 행으로 보여 줘요. 원하는 쪽을 쓰면 되고, 보기를 바꿔도 설정은 바뀌지 않아요.

왼쪽 패널에는 모든 커스텀 명령어가 이전 이름 → 새 이름 형식으로 나열돼요. 각 항목에는 켜기/끄기 스위치가 있어서 이름을 삭제하지 않고 일시 정지할 수 있고, 삭제 버튼도 있어요.

템플릿

템플릿을 누르면 완성된 커스텀 명령어가 한 번에 추가돼요. 이미 사용 중인 이름의 템플릿은 회색으로 표시돼요.

음악: $p(재생), $np(재생 중), $s(건너뛰기), $q(대기열), $dc(나가기), $vol(볼륨), $repeat(대기열 반복), $bass(베이스 부스트 필터), $247(24/7 재생)
티켓: $done(티켓 닫기), $claim(티켓 담당), $faqs(티켓 FAQ 목록)
상점: $store(shop), $vouch(리뷰 제출)
커뮤니티: $gnitro(기브어웨이 생성, 상품 Discord Nitro), $apply(지원서 제출), $lb(리더보드)
관리: $purge(clear)

미리 설정된 값과 입력 옵션

미리 설정된 값은 커스텀 명령어가 실행될 때마다 자동으로 채워져요. 멤버가 이름 뒤에 입력한 값은 그 뒤에 추가되므로, 상품이 이미 설정되어 있어도 $gnitro 1h 1은 여전히 작동해요. 멤버가 같은 옵션을 이름으로 입력하면(prize:"Gift card") 멤버가 입력한 값이 미리 설정된 값보다 우선해요.

값: 최대 200자이며, 큰따옴표나 줄바꿈은 사용할 수 없어요.
선택지: 반복 모드나 필터처럼 고정된 목록이 있는 옵션은 그 목록에 있는 값만 받아요.
숫자: 정수와 숫자 옵션은 숫자만 받아요. 예/아니요 옵션은 yes, no, on, off, true, false를 받아요.
파일: 파일 옵션은 미리 설정할 수 없어요.

이름 규칙

사용 가능한 문자: 문자, 숫자, -, _를 사용할 수 있으며 최대 32자예요. 입력할 때 공백은 하이픈으로 바뀌고, 이름은 소문자로 저장돼요.
실제 명령어 이름: 커스텀 명령어는 실제 Noxyr 명령어의 이름을 사용할 수 없어요. 실제 이름이 항상 우선해요.
고유성: 각 이름은 서버마다 한 번만 사용할 수 있어요.
제한: 서버마다 커스텀 명령어를 최대 100개까지 만들 수 있어요.

저장을 막는 문제가 있으면 편집기 위쪽에 목록으로 표시돼요. 문제를 클릭하면 고쳐야 할 칸으로 바로 이동해요.

접두사 바꾸기

왼쪽 패널 아래의 접두사 칸은 서버 전체의 접두사를 바꿔요. 커스텀 명령어와 모든 일반 명령어에 적용돼요. 공백 없이 최대 5자까지 입력하세요. 예: !, ?, ., n!. 입력한 뒤 저장을 누르세요. 비워 두면 기본값인 $가 사용돼요. 페이지의 모든 이름이 바로 새 접두사로 바뀌어요.

같은 설정은 설정 페이지에도 있으며, Discord에서는 /prefix set으로 바꿀 수 있어요.

커스텀 봇

서버가 Noxyr 커스텀 봇을 쓰고 있다면, 그 봇도 같은 접두사로 같은 커스텀 명령어에 답해요. 두 번 설정할 필요는 없어요.