Pular para o conteúdo principal

A regra que explica a maioria dos problemas de permissão

O Discord impõe uma regra rígida para todo bot, incluindo o Petto: um bot nunca consegue agir sobre um membro cujo cargo mais alto está acima do cargo do próprio bot na lista de cargos do servidor, e nenhuma permissão ou configuração de administrador passa por cima disso. Isso vale para !ban, !kick, !mute, !role e qualquer outra coisa que mexa diretamente com um membro. O Petto usa o prefixo do servidor; ! é só o padrão.
Isso significa que o Petto também não consegue moderar membros com um cargo posicionado acima do dele, mesmo que esse membro não tenha nenhuma permissão especial: a hierarquia é só sobre a posição do cargo, não sobre o que o cargo concede.
kira tenta banir PartnerBot e o Petto diz que não pode banir esse membro porque o cargo mais alto dele está acima ou no mesmo nível do seu

No Discord: um banimento recusado porque o cargo mais alto do membro está acima do cargo do Petto.

O Petto confere o seu lugar também: você não pode usar uma sanção em alguém cujo cargo mais alto esteja na sua altura ou acima do seu, a não ser que você seja o dono do servidor.
kira tenta advertir chu, que tem o mesmo cargo de moderação, e o Petto diz que não dá para usar isso em alguém com cargo igual ou mais alto

No Discord: o seu próprio cargo também precisa estar acima do membro.

Como resolver

Configurações do servidor → Cargos, arraste o cargo do Petto para cima até ele ficar acima de todos os cargos sobre os quais você quer que ele consiga agir. Ele não precisa estar no topo, só acima dos alvos.

Permissões do bot vs. permissões de canal

Duas coisas separadas precisam ser verdadeiras ao mesmo tempo:
  1. Permissões do servidor todo: o que o cargo do Petto recebe em geral (Gerenciar cargos, Banir membros, Gerenciar canais etc.), definido uma vez em Configurações do servidor → Cargos.
  2. Substituições específicas de canal: um canal pode negar ao Petto algo que ele tem no servidor todo; as permissões sobrescritas de um canal específico sempre vencem a concessão do cargo.
kira tenta banir drama_llama e o Petto diz que precisa da permissão Banir membros para isso

No Discord: o cargo do Petto não tem Banir membros.

Um comando que falha em exatamente um canal, mas funciona em todos os outros, quase sempre é o nº 2, não o nº 1.
kira usa lock no anuncios e o Petto diz que precisa da permissão Gerenciar canais naquele canal

No Discord: o Petto tem Gerenciar canais no servidor, mas uma permissão do canal tira isso lá.

Permissões exigidas por comando

Além do que o próprio Petto precisa, a maioria dos comandos de configuração também exige que o membro que os usa tenha Gerenciar servidor (ou uma permissão mais específica, como Banir membros para !ban). Esse é o sistema de permissões do próprio Discord, verificado pelo Petto nos comandos com prefixo.
Chillet, do cargo Ajudantes, tenta banir drama_llama e o Petto diz que falta a permissão ban_members

No Discord: um Ajudante sem Banir membros tenta !ban.

Níveis de comando do Petto

A página Permissões do dashboard e o !permission oferecem uma camada extra opcional. Crie grupos do nível 0 ao 100, atribua usuários ou cargos e depois defina um nível exigido em um comando. O nível do grupo mais alto que corresponder vence. Essa camada nunca substitui as permissões nem a hierarquia do Discord; ela só adiciona uma barreira configurável para a equipe. O dono do servidor e os membros com Administrador nunca são barrados por um nível.
kira usa nuke e o Petto diz que falta o nível de permissão necessário para nuke

No Discord: nuke precisa de nível 80 e o grupo Moderadores é nível 50.

Veja Permissões de comandos para a referência completa dos comandos, que só funcionam com prefixo.

Onde isso aparece

Moderação

Todo comando de sanção está sujeito à hierarquia.

Problemas de permissão

Solução de problemas passo a passo quando algo não está funcionando.