슬래시 명령어(/help)는 메뉴, 자동완성, 검증된 옵션을 제공하고, 접두사 명령어($help)는 평범한 메시지라 입력이 더 빠르며 2022년 이전부터 Discord를 써 온 사람에게 익숙합니다. 둘 중 하나를 고를 필요는 없습니다. Noxyr는 모든 명령어를 두 방식으로 받으며, 기본 접두사는 $이고 서버마다 바꿀 수 있습니다. 두 방식의 실제 차이와 각각이 유리한 경우를 아래에서 설명합니다.
간단한 역사
수년 동안 모든 봇은 접두사를 썼습니다. !play, ?ban, -help 같은 식입니다. 그 뒤 Discord가 슬래시 명령어를 도입했고, 2022년에는 대부분의 봇에서 메시지 내용 접근 권한을 없애 인증된 봇이 슬래시 명령어를 쓰도록 요구했습니다. 슬래시 명령어가 표준이 되었고, 접두사 방식을 한 번도 배우지 않은 사용자 세대가 생겼습니다. 하지만 메뉴를 스크롤하기보다 $help를 입력하는 편이 나은 서버도 여전히 많고, 모바일 키보드에서는 슬래시 메뉴가 번거롭습니다. 그래서 두 방식을 모두 지원하는 봇이 모두를 만족시킵니다.
슬래시 명령어가 더 나은 점
- 발견 가능성.
/를 입력하면 모든 명령어가 설명과 함께 나타납니다. 도움말 페이지가 필요 없습니다. - 검증. 채널 옵션은 채널만, 숫자 옵션은 숫자만 받습니다. 실수는 봇이 보기 전에 걸러집니다.
- 자동완성. 입력하는 동안 곡, 상품, 재생목록을 검색하는 기능은 슬래시 명령어에서만 작동합니다.
- 양식.
/quick catalog add나 건의함 같은 팝업 양식(모달)은 슬래시 상호작용에서만 열 수 있습니다. - 비공개 응답. 나에게만 보이는 임시(ephemeral) 응답은 슬래시 명령어의 기능입니다.
접두사 명령어가 더 나은 점
- 속도.
$skip은 키 다섯 번이면 됩니다. 메뉴도, 선택 목록이 뜨기를 기다릴 필요도 없습니다. - 어떤 클라이언트, 어떤 상황에서든. 메시지는 메시지입니다. 가장 오래된 휴대폰에서도, 다른 플랫폼에서 연결된 브리지를 통해서도 작동합니다.
- 손에 익은 습관. 10년 동안
!명령어를 쳐 온 오랜 멤버와 스태프는 새로 배우고 싶어 하지 않습니다. - 복사하여 붙여넣기. 스태프 가이드에 “
$ticket close reason:spam을 실행하세요”라고 적으면, 사람들이 그대로 붙여넣을 수 있습니다.
Noxyr가 두 방식을 함께 지원하는 방법
모든 슬래시 명령어에는 같은 이름, 같은 하위 명령어, 같은 옵션을 가진 접두사 버전이 있습니다. Noxyr는 메시지를 슬래시 명령어가 만들었을 것과 같은 형태로 분석한 뒤 같은 코드를 실행하므로, 권한과 동작이 완전히 같습니다. 알아 두면 좋은 규칙은 다음과 같습니다.
- 하위 명령어는 이름 뒤에 옵니다:
$ticket close,$music settings,$referrals link. - 옵션은
name:value형식입니다:$sticky set text:"Read the rules" delay:300. 따옴표를 쓰면 띄어쓰기가 있는 값을 하나로 묶습니다. 이름 없이 입력한 단어는 필수 옵션에 순서대로 채워지므로,$play never gonna give you up처럼 입력해도 그대로 작동합니다. - 멘션이나 이름 모두 작동합니다:
#channel,@role, 원시 ID, 또는 채널이나 역할의 일반 이름. - 예/아니요: 참/거짓 옵션은 yes/no, on/off, true/false를 모두 받습니다.
- 파일: 메시지에 이미지를 첨부하면 첨부 파일 옵션에 채워집니다.
- 비공개 응답은 DM으로 갑니다. 명령어가 나에게만 응답해야 하는 경우, 일반 메시지는 임시로 만들 수 없으므로 응답이 어느 서버에서 왔는지 알려 주는 메모와 함께 DM으로 보냅니다.
- 양식은 슬래시 전용입니다. 명령어가 팝업 양식을 열어야 하는 경우, 접두사 버전은 대신 슬래시 명령어를 실행하라고 안내합니다.
접두사 바꾸기
/prefix view는 현재 접두사를 보여 주고, /prefix set prefix:!는 접두사를 바꿉니다(1~5자, 공백 없음. 그래서 !, ?, n!, nx. 모두 가능합니다). /prefix reset은 $로 되돌립니다. 접두사는 서버마다 따로 설정되며, 커스텀 봇도 같은 접두사를 사용합니다. 같은 서버의 다른 봇이 이미 !를 쓰고 있다면, 두 봇이 같은 메시지에 응답하지 않도록 다른 접두사를 고르세요.
우리 서버는 어떤 방식을 써야 할까?
둘 다 쓰세요. 새 멤버에게는 슬래시 메뉴를 안내하세요. 메뉴가 스스로 사용법을 가르쳐 주기 때문입니다. 스태프와 단골은 접두사 명령어를 입력하게 두세요. 하나로 통일해야 할 것은 문서입니다. 내부 가이드는 한 가지 스타일로 작성해서, $와 /이 다르게 작동하는지 아무도 궁금해하지 않게 하세요. Noxyr에서는 다르게 작동하지 않습니다.
자주 묻는 질문
접두사 명령어에 메시지 내용 인텐트가 필요한가요? 네. Noxyr는 이미 그 인텐트를 가지고 있습니다. 커스텀 봇을 운영한다면, 설정할 때 켜야 하는 두 가지 인텐트 중 하나입니다.
접두사 명령어를 끌 수 있나요? 방해받지 않게 하고 싶다면 눈에 띄지 않는 접두사를 고르세요. 슬래시 명령어는 그와 상관없이 계속 작동합니다.
접두사는 서버 간에 공유되나요? 아니요. 각 서버는 자신만의 접두사를 가집니다.