Alle Artikel
Technik4 Min. Lesezeit

Privileged Intents erklärt: Warum dein Bot Server Members und Message Content braucht

„Used disallowed intents“ ist einer der häufigsten Fehler beim Start eines Bots. Was Intents sind, welche privilegiert sind und wie du sie aktivierst.

Intents legen fest, über welche Ereignisse Discord deinen Bot informiert, zum Beispiel neue Nachrichten, Beitritte oder Reaktionen. Der Bot fragt sie beim Start an. Drei davon sind privilegiert: Discord gibt sie nur heraus, wenn du sie im Developer Portal ausdrücklich freischaltest.

Die drei privilegierten Intents

  • Server Members: nötig für Willkommensnachrichten, automatische Rollen bei Beitritt und Mitgliederlisten.
  • Message Content: nötig, um den Inhalt von Nachrichten zu lesen, etwa für Auto-Moderation oder Level nach Nachrichten.
  • Presence: Online-Status und Aktivitäten der Mitglieder. Brauchen die wenigsten Bots.

Typischer Fehler

Fragt der Bot einen privilegierten Intent an, der im Portal nicht aktiviert ist, beendet Discord die Verbindung sofort. In der Konsole steht dann:

Error: Used disallowed intents

So aktivierst du sie

  • Öffne discord.com/developers/applications und wähle deine Anwendung.
  • Geh zum Reiter Bot und scroll zu Privileged Gateway Intents.
  • Aktiviere die Intents, die in der README deines Bots stehen, und speichere.
  • Starte den Bot neu.

Ab 100 Servern wird es strenger

Ist ein Bot auf 100 oder mehr Servern, muss er von Discord verifiziert werden. Privilegierte Intents gibt es dann nur noch mit Begründung und Freigabe durch Discord. Für einen eigenen Bot auf deinem Server spielt das keine Rolle: Dort reicht der Schalter im Portal.