Un entier de permissions Discord est un seul nombre qui représente un ensemble de permissions grâce à un champ de bits. Chaque permission (Envoyer des messages, Expulser des membres, Gérer les salons, etc.) se voit attribuer une position de bit. Pour combiner plusieurs permissions, Discord utilise un OU bit à bit, si bien qu'un seul grand nombre encode toutes les permissions de votre bot d'un coup.

Comme Discord compte plus de 50 permissions, l'entier dépasse vite Number.MAX_SAFE_INTEGER, ce qui explique pourquoi les valeurs de permissions sont souvent de très grands nombres (comme 8 pour Administrateur ou 274877975552 pour un bot giveaway classique). Ce calculateur fait le calcul avec BigInt, rien n'est donc tronqué.

Vous transmettez cet entier à Discord au moment de générer un lien d'invitation OAuth2, via le paramètre permissions. Discord crée alors pour votre bot un rôle géré avec exactement ces permissions quand il rejoint un serveur.

Construire un entier de permissions à la main, c'est mémoriser des positions de bits et faire des opérations bit à bit. Un calculateur vous donne une liste visuelle à cocher, évite les fautes de frappe et vous permet de décoder n'importe quel entier existant pour voir quelles permissions un bot demande avant de l'inviter.

Il vous aide aussi à appliquer le principe du moindre privilège. Ne donnez à votre bot que les permissions dont il a besoin. Cocher Administrateur est la solution de facilité, mais si le bot est compromis ou qu'une commande a un bug, Administrateur signifie une prise de contrôle totale du serveur. Utilisez cet outil pour choisir le strict nécessaire à la place.