Ein Discord Berechtigungs-Integer ist eine einzelne Zahl, die eine Gruppe von Berechtigungen als Bitfeld darstellt. Jede Berechtigung (Nachrichten senden, Mitglieder kicken, Kanäle verwalten usw.) hat eine feste Bit-Position. Um mehrere Berechtigungen zu kombinieren, nutzt Discord ein bitweises OR, sodass eine einzige große Zahl alle Berechtigungen deines Bots auf einmal enthält.

Weil Discord mehr als 50 Berechtigungen hat, übersteigt der Integer schnell Number.MAX_SAFE_INTEGER. Deshalb werden Berechtigungswerte oft als sehr große Zahlen angezeigt (etwa 8 für Administrator oder 274877975552 für einen typischen Giveaway-Bot). Dieser Rechner rechnet mit BigInt, damit nichts abgeschnitten wird.

Diesen Integer übergibst du Discord beim Erzeugen einer OAuth2-Invite-URL über den Query-Parameter permissions. Discord legt dann beim Beitritt zu einem Server eine verwaltete Rolle für deinen Bot an, die genau diese Berechtigungen hat.

Einen Berechtigungs-Integer von Hand zu bauen heißt, Bit-Positionen auswendig zu kennen und bitweise zu rechnen. Ein Rechner gibt dir eine Checkliste, verhindert Tippfehler und lässt dich jeden vorhandenen Integer rückwärts auflösen, damit du siehst, welche Berechtigungen ein Bot verlangt, bevor du ihn einlädst.

Er hilft dir auch, dem Prinzip der minimalen Rechte zu folgen. Gib deinem Bot nur die Berechtigungen, die er für seine Aufgabe braucht. Administrator zu vergeben ist der bequeme Weg, aber wenn der Bot kompromittiert wird oder ein Befehl einen Fehler hat, bedeutet Administrator die komplette Übernahme des Servers. Nutz dieses Tool, um stattdessen das Minimum auszuwählen.