Inteiro de permissões do Discord: como um único número guarda permissões

Como o número funciona

O Discord tem dezenas de permissões, como Ver canais, Enviar mensagens ou Banir membros. Cada uma tem uma potência fixa de dois. Ver canais é 1024, Enviar mensagens é 2048, Gerenciar mensagens é 8192 e Administrador é 8. Para combinar permissões, você soma os números. Um cargo com Ver canais e Enviar mensagens é 1024 + 2048 = 3072.

Como cada permissão usa o próprio bit, nenhuma combinação dá o mesmo total, então a soma pode ser convertida de volta na lista exata.

Onde você vai vê-lo

• Links de convite: o valor permissions= diz quais direitos o cargo do bot recebe quando ele é adicionado. Veja escopos OAuth2.
• Cargos e substituições de canal: o Discord guarda as permissões de cada cargo e as listas de permitir e negar de cada canal como esses números.
• Ferramentas para desenvolvedores: bots leem o valor para verificar se um membro pode fazer algo.

Por que isso importa para donos

Duas permissões merecem cuidado. Administrador (8) ignora todas as substituições de canal, então um cargo que a tenha pode fazer qualquer coisa. Reserve-a para quem você confia totalmente. E quando um bot pede um inteiro grande, decodifique-o antes de aprovar, porque um número que você não consegue ler pode incluir Banir membros ou Gerenciar webhooks, que o bot não precisa. A calculadora de permissões transforma caixas de seleção em um número e um número de volta em caixas de seleção.

Os cargos também são limitados pela posição. Ter uma permissão não permite que um cargo gerencie outros acima dele; veja hierarquia de cargos.

Permissões e Noxyr

O Noxyr pede uma lista fixa de direitos em vez de Administrador. Isso inclui publicar e incorporar conteúdo, gerenciar canais e cargos para tickets e verificação, ver o registro de auditoria para o anti-nuke, e expulsar, banir e aplicar timeout para os módulos de proteção. A referência de permissões mostra cada uma e o que quebra sem ela. Administrador ainda é a escolha mais fácil em um servidor com muitas substituições de canal, porque uma substituição negada em uma categoria pode impedir a criação de tickets, mas não é obrigatório.

Para uma explicação simples de dar ao bot apenas o necessário, leia sobre privilégio mínimo para bots.

Lendo um à mão

Pegue um número como 3072. Subtraia o maior valor de permissão que cabe (2048), depois o seguinte (1024), e sobrará zero, então são Enviar mensagens mais Ver canais. A calculadora faz a mesma conta instantaneamente, e evita erros.