Comandos de barra

Os comandos de aplicação são registrados exatamente como no Discord — mesmos endpoints, mesmos payloads, mesmas bibliotecas. Só uma regra muda: o GameVox traz comandos próprios, e os nomes deles são reservados.

Registro

Sem mudanças em relação ao Discord. As quatro rotas funcionam, globais e por guild, para criar e para sobrescrever em lote:

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

Nomes reservados

O GameVox responde aos comandos abaixo por conta própria. Registrar um desses nomes é recusado com 400 e o código de erro do Discord 50035; a mensagem nomeia o comando, então a falha fica evidente no seu log de deploy.

O motivo é a pessoa que usa, não a plataforma. O GameVox mostra os comandos integrados e os dos apps em um único seletor sem namespace, então dois comandos chamados ban aparecem como duas linhas idênticas, sem nada que as distinga. Para um comando de moderação isso é pior do que um erro — ninguém deveria ter que adivinhar qual /ban acabou de rodar.

Grupo	Nomes reservados	O que o GameVox faz com eles
Moderação	`ban` `unban` `kick` `clear` `slowmode`	Age direto no servidor, com as permissões do GameVox de quem chamou.
Diversão	`8ball` `flip` `choice` `ascii` `qrcode` `love`	Responde no canal.
Informações	`serverinfo` `userinfo` `avatar`	Mostra o que quem chamou já consegue ver na interface.
Integrante	`afk` `remindme` `welcome` `goodbye`	Avisos de ausência, lembretes e a mensagem de entrada/saída do servidor.
Cliente	`me` `poll` `shrug` `tableflip` `unflip` `lenny`	Tratado pelo cliente do GameVox sem chegar a um servidor.

A comparação ignora maiúsculas e espaços ao redor: Ban conflita com ban, porque o seletor compara os nomes do mesmo jeito.

Se você já registrou um

Um comando registrado antes de o nome ser reservado continua no banco, mas some do seletor e é recusado se for invocado. Renomeie e registre de novo; nada mais no seu app é afetado.

Nomes que não são reservados

Só correspondências exatas são tomadas. banish, clearall e server-info são todos seus. warn também: o GameVox não tem comando de advertência, porque denunciar alguém passa pelo fluxo de denúncias.

Prefixar seus comandos com algo curto e específico do seu app vale a pena de qualquer forma, reservado ou não — é o que evita que dois apps instalados colidam entre si, algo que o GameVox não arbitra.

As permissões continuam valendo

Reservar um nome não tem nada a ver com quem pode executar seus comandos. Isso não mudou e nega por padrão: um comando registrado só pode ser executado por quem é dono do servidor até que alguém o conceda a um grupo em Configurações do servidor → Integrações. Veja Permissões.