Pular para o conteúdo principal

​
Visão geral

Todo comando começa com um prefixo do servidor: ! e a palavra petto por padrão (!help e petto help funcionam). A palavra petto sempre funciona, quaisquer que sejam os prefixos que você escolher (mesmo que o servidor use só !n), e não pode ser removida. Os argumentos vão em ordem e separados por espaço; coloque entre “aspas” qualquer coisa que tenha espaços. Um servidor pode ter vários prefixos, até 10. O primeiro é o prefixo principal: a ajuda, os cartões e os exemplos mostram ele. Um servidor que escolheu um prefixo próprio mantém exatamente esse. Se você esquecer um prefixo personalizado, mencione o Petto: @Petto prefix sempre funciona e mostra o prefixo atual.
kira digita !prefix e nada acontece, depois @Petto prefix mostra que o prefixo do servidor é ?

No Discord: com um prefixo esquecido, !prefix não recebe resposta, mas uma menção ao Petto sim.

​
Vários prefixos

  • Um símbolo (!, ,, ?, p!) se escreve colado ao comando: ,help. Um espaço depois (, oi) não é um comando.
  • Uma palavra (termina em letra ou número, como petto) não diferencia maiúsculas e precisa de um espaço: petto help ou Petto help. Só inicia um comando quando a palavra seguinte é um comando real, um alias ou um comando personalizado, então petto é demais é só conversa.
  • O prefixo mais longo vai primeiro, então com ! e !! na lista, !!help é lido com !!.
  • Só o prefixo principal responde “Não conheço o comando”, e só a uma palavra escrita como comando (!oi). Os outros prefixos, os de palavra e o seu prefixo próprio ficam em silêncio quando a palavra não é um comando.
  • A vírgula não vem por padrão. Outros bots usam ,, então o Petto não responde a ela a menos que você a adicione: !prefix add ,.
  • Seu prefixo próprio (!myprefix) e os comandos personalizados que começam com o prefixo funcionam com todos os prefixos da lista.
  • Cada prefixo tem de 1 a 12 caracteres, sem espaços, sem @ nem crases, e não pode se repetir.

​
Pular um argumento opcional

Comandos com vários campos opcionais seguidos (como !ticket category edit ou !welcome setup) deixam você ir direto ao campo que quiser com --nomedocampo valor, em vez de digitar todos os campos antes dele.
liam usa !welcome setup com o canal de boas-vindas e --message, e o Petto salva o canal e a mensagem

No Discord: --message preenche a mensagem do !welcome setup sem digitar os campos de antes.

Misture à vontade: valores em ordem e --flags podem aparecer no mesmo comando. Isso só importa para campos opcionais; os obrigatórios sempre precisam de um valor simples, na ordem. Um nome com sublinhado também pode ser escrito com hífen: --window-seconds 10 é o mesmo que --window_seconds 10.
name:value (como limit:3) é como o Discord escreve as opções de um comando slash. Com o prefixo isso não é lido como um nome, então escreva --limit 3.

​
Comandos

Use !prefix sem argumento para ver a lista. !prefix add <prefix> adiciona um (até 10), !prefix remove <prefix> remove um (o último não pode ser removido) e !prefix reset volta para ! e petto. !prefix <prefix> (ou !prefix set <prefix>) deixa esse prefixo como o único, como sempre (petto e a menção do Petto continuam funcionando). Precisa de Gerenciar servidor. !help abre o navegador de todos os comandos, com botões para o painel, a documentação, a página de Comandos do site e o servidor de suporte, e !help ticket category add procura um diretamente, incluindo um subcomando específico. !prefix também funciona como !pfx, e !help como !h.
liam vê o prefixo, que é !, e @Petto que sempre funciona, e depois muda para ?

No Discord: !prefix mostra o prefixo atual, e !prefix ? muda ele.

liam tenta o prefixo petto! e o Petto diz que ele deve ter de 1 a 5 caracteres sem espaços

No Discord: um prefixo com mais de 5 caracteres é recusado.

O menu de ajuda do Petto: quantos comandos existem, quantos também funcionam com /, o idioma do servidor e um menu de categorias

No Discord: !help, com as categorias em um menu e links para o painel, a documentação e o servidor de suporte.

A categoria Configuração do !help: para que serve, quantos comandos tem, um botão para voltar ao menu e um menu com os comandos

No Discord: depois de escolher Configuração no menu, a mesma mensagem mostra os comandos dela.

O cartão de ajuda de ticket category add com aliases, parâmetros, quem pode usar, a sintaxe com prefixo e com barra e um exemplo

No Discord: um subcomando procurado diretamente, com aliases, opções e as duas formas.

shi procura tiket e o Petto sugere !help ticket, !help time e !help timer

No Discord: um comando digitado errado recebe os nomes mais parecidos.

No dashboard, o cartão Prefixos de comandos da página Geral mostra a lista e tem um botão Gerenciar prefixos. Ele abre uma janela: escreva um prefixo, aperte +, remova os que não quiser com o x e aperte Salvar. Ela diz o que está errado (longo demais, espaços, repetido, @, mais de 10) antes de salvar, e funciona no celular.
A página Configurações do servidor com o prefixo de comandos, o idioma do servidor, o cargo de silêncio e o ranking público

Dashboard → Dashboard → Configurações: os Prefixos de comandos, ao lado do idioma do servidor e do cargo de silêncio.

​
Comandos slash

Todos os comandos funcionam com o prefixo. Os do dia a dia também estão no menu / do Discord, com as mesmas respostas e as mesmas verificações, para que os membros que nunca aprenderam um prefixo também possam usá-los. A forma com prefixo continua funcionando para todos eles. São 67 comandos no total: 64 comandos slash e 3 menus de contexto. Os cartões !<module>config e algumas ferramentas da equipe continuam só com prefixo.
/help responde no canal e mostra as duas formas de um comando: a slash ao lado da sintaxe com prefixo. Os menus dele descrevem cada opção e os botões dele abrem o dashboard, esta documentação e o servidor de suporte.
sam.k usa /help ban user e recebe um cartão com a sintaxe com prefixo, a sintaxe com barra e um exemplo

No Discord: /help mostra a forma com barra ao lado da sintaxe com prefixo.

​
Quem vê cada comando slash

O Discord esconde um comando slash dos membros que não têm a permissão de que ele precisa, então o menu / só mostra o que cada pessoa pode usar: Um servidor pode mudar quem vê um comando slash em Configurações do servidor → Integrações → Petto. É assim que um cargo escolhido para um comando em !moderation também pode usá-lo pelo menu /: permita o comando para esse cargo ali, e as verificações do próprio Petto continuam valendo. Os comandos slash do dia a dia não aparecem em DMs. Veja Permissões de comandos para saber como o Petto verifica um comando.
Comandos slash novos ou alterados podem demorar um pouco para aparecer. Recarregar o Discord (Ctrl+R) costuma ajudar.