Entier de permissions Discord : comment un seul nombre stocke les permissions

Fonctionnement du nombre

Discord compte des dizaines de permissions, comme Voir les salons, Envoyer des messages ou Bannir des membres. Chacune a une valeur fixe, une puissance de deux. Voir les salons vaut 1024, Envoyer des messages vaut 2048, Gérer les messages vaut 8192 et Administrateur vaut 8. Pour combiner des permissions, on additionne les nombres. Un rôle avec Voir les salons et Envoyer des messages vaut 1024 + 2048 = 3072.

Comme chaque permission utilise son propre bit, aucune combinaison ne donne le même total. La somme peut donc être reconvertie en liste exacte.

Où vous le verrez

• Liens d'invitation : la valeur permissions= indique quels droits reçoit le rôle du bot lorsqu'il est ajouté. Voir scopes OAuth2.
• Rôles et exceptions de salon : Discord stocke les permissions de chaque rôle, et les listes d'autorisation et de refus de chaque salon, sous forme de ces nombres.
• Outils développeur : les bots lisent cette valeur pour vérifier si un membre peut faire une action.

Pourquoi cela compte pour les propriétaires

Deux permissions méritent une attention particulière. Administrateur (8) contourne toutes les exceptions de salon, donc un rôle qui l'a peut tout faire. Réservez-le aux personnes en qui vous avez pleinement confiance. Et lorsqu'un bot demande un grand entier, décodez-le avant d'approuver, car un nombre illisible pourrait inclure Bannir des membres ou Gérer les webhooks, dont le bot n'a pas besoin. Le calculateur de permissions transforme des cases à cocher en nombre, et un nombre en cases à cocher.

Les rôles sont aussi limités par leur position. Avoir une permission ne permet pas à un rôle de gérer ceux qui sont au-dessus de lui, voir hiérarchie des rôles.

Permissions et Noxyr

Noxyr demande une liste fixe de droits plutôt qu'Administrateur. Cela inclut la publication et l'intégration de contenu, la gestion des salons et des rôles pour les tickets et la vérification, la consultation du journal d'audit pour l'anti-nuke, et l'expulsion, le bannissement et l'exclusion temporaire pour ses modules de protection. La référence des permissions présente chacune d'elles et ce qui ne fonctionne plus sans elle. Administrateur reste le choix le plus simple sur un serveur avec de nombreuses exceptions de salon, car un seul refus sur une catégorie peut bloquer la création de tickets, mais ce n'est pas obligatoire.

Pour une explication simple de la façon de donner juste ce qu'il faut à un bot, lisez l'article sur le moindre privilège pour les bots.

Lire un nombre à la main

Prenez un nombre comme 3072. Soustrayez la plus grande valeur de permission qui y tient (2048), puis la suivante (1024), et il reste zéro : il s'agit donc d'Envoyer des messages plus Voir les salons. Le calculateur fait le même calcul instantanément et évite les erreurs.