← 문서

슬래시 명령어

애플리케이션 명령어는 Discord와 똑같이 등록합니다. 엔드포인트도, 페이로드도, 라이브러리도 같습니다. 다른 규칙은 하나뿐인데, GameVox에는 자체 기본 명령어가 있고 그 이름이 예약되어 있다는 점입니다.

등록

Discord와 달라진 점은 없습니다. 네 가지 경로가 모두 동작하며, 전역과 길드별, 생성과 일괄 덮어쓰기를 지원합니다.

POST /api/v10/applications/{application_id}/commands
PUT  /api/v10/applications/{application_id}/commands
POST /api/v10/applications/{application_id}/guilds/{guild_id}/commands
PUT  /api/v10/applications/{application_id}/guilds/{guild_id}/commands

예약된 이름

아래 명령어들은 GameVox가 직접 응답합니다. 이 이름으로 등록하면 400과 Discord 오류 코드 50035로 거부되며, 메시지에 명령어 이름이 들어가므로 배포 로그에서 원인을 바로 알 수 있습니다.

이유는 플랫폼이 아니라 사용자에게 있습니다. GameVox는 기본 명령어와 앱 명령어를 네임스페이스 없이 하나의 선택기에 보여 주기 때문에, ban이라는 이름의 명령어가 둘이면 구분할 단서 없이 똑같은 행이 두 개 뜹니다. 조정용 명령어에서는 이것이 오류보다 나쁩니다. 방금 어느 /ban을 실행했는지 고민하게 만들어서는 안 됩니다.

그룹	예약된 이름	GameVox가 하는 일
조정	ban unban kick clear slowmode	호출한 사람의 GameVox 권한으로 서버에 직접 작용합니다.
재미	8ball flip choice ascii qrcode love	채널에서 응답합니다.
정보	serverinfo userinfo avatar	호출한 사람이 UI에서 이미 볼 수 있는 내용을 보여 줍니다.
구성원	afk remindme welcome goodbye	자리 비움 메모, 알림, 서버의 입장/퇴장 메시지.
클라이언트	me poll shrug tableflip unflip lenny	서버에 도달하지 않고 GameVox 클라이언트에서 처리합니다.

대조는 대소문자와 앞뒤 공백을 무시합니다. 선택기도 같은 방식으로 이름을 대조하기 때문에 Ban은 ban과 충돌합니다.

이미 등록해 둔 경우

이름이 예약되기 전에 등록된 명령어는 데이터베이스에 남지만, 사용자의 선택기에서는 빠지고 호출해도 거부됩니다. 이름을 바꿔 다시 등록하세요. 앱의 다른 부분에는 영향이 없습니다.

예약되지 않은 이름

정확히 일치하는 이름만 예약됩니다. banish, clearall, server-info는 모두 사용할 수 있습니다. warn도 마찬가지인데, GameVox에는 경고 명령어가 없고 구성원 신고는 신고 흐름에서 처리하기 때문입니다.

예약 여부와 관계없이, 앱에 맞는 짧은 접두사를 붙여 두는 편이 좋습니다. 설치된 두 앱이 서로 충돌하지 않게 해 주는 것은 그것뿐이며, GameVox는 그 충돌을 중재하지 않습니다.

권한은 그대로 적용됩니다

이름 예약은 누가 명령어를 실행할 수 있는지와는 무관합니다. 이 부분은 그대로이며 기본은 거부입니다. 등록된 명령어는 운영자가 서버 설정 → 통합에서 그룹에 허용하기 전까지 서버 소유자만 실행할 수 있습니다. 권한을 참고하세요.