Comando de barra do Discord: como funcionam e por que os bots os usam
Um comando de barra é um comando de bot que você inicia digitando / na caixa de mensagem e escolhendo entre um menu que o Discord mostra. Como o Discord lista as opções e verifica as entradas, os comandos de barra substituem a maioria dos antigos comandos de prefixo e não precisam de permissão especial para ler mensagens.
Como os comandos de barra funcionam
Um bot registra os seus comandos no Discord pela API. Cada comando tem um nome, uma descrição e entradas opcionais, como um usuário, um canal, um número ou uma lista de escolhas. Quando você digita /, o Discord mostra o menu, valida o que você digitou e então envia ao bot uma interação. O bot tem três segundos para confirmá-la, e pode continuar respondendo por quinze minutos.
O bot nunca precisa ler o seu chat. Ele só vê o comando que você escolheu executar.
Comandos globais versus de servidor
- Comandos globais aparecem em todo servidor em que o bot está, inclusive em mensagens diretas, se o bot permitir. As atualizações podem levar um tempo para aparecer em todos os lugares.
- Comandos de servidor (guild) existem apenas em um servidor e são atualizados na hora. Desenvolvedores os usam para testes.
Os comandos podem ter subcomandos e grupos, como /ticket close, então um bot pode encaixar muitos recursos sob poucos nomes.
Quem pode usá-los
Cada comando tem permissões padrão definidas pelo desenvolvedor. Administradores do servidor podem alterá-las em Configurações do Servidor, Integrações, escolhendo quais cargos ou canais podem executar cada comando. Se um comando não aparece no menu, a causa costuma ser uma substituição de permissão ou uma restrição de canal.
Barra versus prefixo
Bots mais antigos escutavam textos como !play. Isso exige o intent privilegiado de conteúdo de mensagens e não oferece preenchimento automático. Os comandos de barra evitam os dois problemas. Veja comandos de prefixo para o outro lado, e a comparação completa.
Comandos de barra no Noxyr
Todo recurso do Noxyr está disponível como comando de barra, e os mesmos comandos também funcionam como mensagens de prefixo simples, como $help, com as mesmas permissões. Veja a lista completa na página de comandos. Administradores podem renomear comandos para o próprio servidor com comandos personalizados (documentação) e decidir quais comandos cada cargo vê com a visibilidade de comandos. Se o menu parecer vazio, siga o guia de comandos ausentes.
Dicas para membros
Digite a barra e comece a escrever o nome de um comando para filtrar a lista. Pressione Tab para passar entre as opções. Se algo estiver faltando, reinicie o Discord, já que o app guarda a lista de comandos em cache, e confira se você está no canal certo.
Perguntas frequentes
Por que meus comandos de barra não aparecem?
Normalmente o bot foi convidado sem o escopo applications.commands, ou uma substituição de permissão os oculta. Confira em Configurações do Servidor, Integrações.
Comandos de barra precisam do intent de conteúdo de mensagens?
Não. Essa é uma das vantagens deles. O bot só recebe o comando que você executa.
Posso renomear comandos de barra?
Não no próprio Discord. O Noxyr oferece comandos personalizados, que dão aos seus comandos novos nomes no seu servidor.