Ein Discord-Bot geht aus einem von wenigen vorhersehbaren Gründen offline: ein zurückgesetzter Token, ein deaktivierter privilegierter Intent, ein abgelaufenes Voting-Fenster bei einem gehosteten Bot oder der Bot wurde von dem Server entfernt, von dem er abhängt. Das Gateway von Discord zeigt über einen Close-Code an, welcher Fall vorliegt. Die Codes 4004 und 4013/4014 sieht man am häufigsten, und jeder hat eine konkrete, mechanische Lösung statt eines „Starte es einfach neu und hoffe das Beste“.

A user's bot token runs on a Noxyr node and comes online as their own branded bot. Your token Noxyr node MyBot Online

Zuerst prüfen: die wahrscheinlichste Ursache

Sortiert danach, wie oft jeder Fall tatsächlich auftritt:

  1. Der Token wurde zurückgesetzt. Jemand hat im Developer Portal auf Reset Token geklickt, absichtlich oder aus Versehen, und der alte Token, den der Bot benutzt hat, ist jetzt ungültig.
  2. Ein privilegierter Intent wurde ausgeschaltet. Server Members Intent oder Message Content Intent wurde deaktiviert, nachdem der Bot schon eingerichtet war.
  3. Ein Voting- oder Abo-Zeitraum ist abgelaufen. Bei einem gehosteten Bot wie dem Custom Bot von Noxyr ist die Laufzeit an ein Top.gg-Vote gebunden, und das Fenster samt Kulanzzeit ist abgelaufen.
  4. Der Bot wurde vom Server entfernt, oder ein Bot, von dem er abhängt, wurde entfernt. Der Custom Bot hängt speziell an der Anwesenheit von Noxyr selbst. Wird Noxyr gekickt, stoppt der Custom Bot auf diesem Server.
  5. Ein echter Ausfall. Discord selbst hat einen schlechten Tag. Das kommt selten vor, aber prüfe discordstatus.com, bevor du von deinem Setup ausgehst.

Was die Gateway-Close-Codes wirklich bedeuten

CodeBedeutungTypische Ursache
4004Authentifizierung fehlgeschlagenDer Token ist falsch oder wurde im Developer Portal zurückgesetzt
4013Ungültige IntentsDer Code des Bots hat einen Intent angefragt, den es nicht gibt, oder eine Kombination, die Discord ablehnt
4014Nicht erlaubte IntentsDer Bot hat einen privilegierten Intent (Server Members oder Message Content) angefragt, der für die Anwendung nicht eingeschaltet ist

In der Praxis treten 4013 und 4014 bei den meisten Bots aus demselben Grund auf: Ein privilegierter Intent, den der Code braucht, ist im Portal ausgeschaltet. Discord.js und ähnliche Bibliotheken melden das manchmal in den Logs als Fehler „disallowed intents“ statt mit dem nackten Zahlencode, aber es ist dasselbe Problem. Unser Leitfaden zu den privilegierten Gateway-Intents erklärt ausführlicher, was jeder Intent steuert und was ohne ihn kaputtgeht.

Jeden Fall beim Noxyr Custom Bot beheben

Gateway 4004 oder „Discord hat diesen Token abgelehnt“

Der Token, mit dem sich der Bot zuletzt angemeldet hat, existiert nicht mehr. Das passiert, wenn der Token im Developer Portal zurückgesetzt wurde, ob absichtlich (zur Rotation aus Sicherheitsgründen) oder aus Versehen (weil jemand beim Herumklicken im Tab Bot auf Reset Token gedrückt hat).

  1. Öffne das Discord Developer Portal, wähle die Anwendung aus und gehe zum Tab Bot.
  2. Drücke erneut auf Reset Token. Das erzeugt einen neuen Token. Kopiere ihn sofort, denn Discord zeigt ihn nur einmal an.
  3. Öffne die Custom-Bot-Seite im Noxyr-Dashboard und füge den neuen Token ein.
  4. Schalte den Bot wieder ein. Die Nodes von Noxyr schalten einen Bot mit ungültigem Token automatisch ab, damit er nicht in einer toten Verbindungsschleife hängen bleibt. Der Bot startet neu, sobald du einen funktionierenden Token einfügst und ihn einschaltest.

Gateway 4013/4014 oder „Discord hat die Verbindung abgelehnt“

Ein privilegierter Intent, der bei der Einrichtung eingeschaltet war, wurde später ausgeschaltet. Meist passiert das, während jemand aus einem anderen Grund im Tab Bot herumklickt.

  1. Gehe im Developer Portal zu Bot → Privileged Gateway Intents.
  2. Schalte Server Members Intent und Message Content Intent wieder ein. Beide sind nötig. Der Funktionsumfang von Noxyr (Willkommensnachrichten, Mitgliederzahlen, KI-Chat, automatische Antworten, Ticket-Transkripte) braucht beide.
  3. Speichere und schalte den Bot dann auf der Custom-Bot-Seite im Dashboard wieder ein. Discord übernimmt Intent-Änderungen erst beim nächsten Login. Ein bloßes Wiedereinschalten des Schalters reicht daher nicht, der Bot muss sich neu verbinden.

Voting-Fenster und Kulanzzeit sind abgelaufen

Der Custom Bot läuft auf Basis eines Top.gg-Votes. Ein Vote schaltet ihn für 12 Stunden frei. Danach hält eine Kulanzzeit von 74 Stunden den Bot am Laufen, während die Dashboard-Seite sperrt. Sind beide Zeiträume abgelaufen, geht der Bot offline. Dabei wird aber nichts an deinem Setup gelöscht.

  1. Stimme für Noxyr auf Top.gg ab.
  2. Kehre zur Custom-Bot-Seite zurück. Sie wird sofort entsperrt, sobald der Vote erfasst ist.
  3. Der Bot startet von selbst neu und nutzt denselben Token und dieselben Einstellungen wie zuvor.

Genau um das zu verhindern, kommt 24 Stunden nach deinem letzten Vote (12 Stunden in der Kulanzzeit) eine Erinnerungs-DM. Zeigt der Status des Bots „suspendiert“ an, sagt die Seite selbst, ob es am Vote, an der Kulanzzeit oder am nächsten unten beschriebenen Problem liegt.

Noxyr wurde vom Server entfernt

Der Custom Bot läuft mit den Einstellungen und der Datenbank von Noxyr für diesen Server. Er hängt also davon ab, dass Noxyr noch Mitglied ist. Wird Noxyr gekickt, stoppt der Custom Bot innerhalb etwa einer Minute seinen Dienst auf diesem Server. Außerdem schickt er eine DM an die Person, die Noxyr entfernt hat (und an den Bot-Besitzer, falls das jemand anderes ist), mit einem Einladungslink.

  1. Lade Noxyr über den Link aus der DM oder von der Startseite von Noxyr erneut ein.
  2. Der Custom Bot nimmt seinen Betrieb von selbst wieder auf, sobald Noxyr wieder auf dem Server ist. Token und Intents musst du nicht anfassen.

Solange er aus diesem speziellen Grund gestoppt ist, wird das Voting-Fenster angehalten statt verbraucht. Wenn du Noxyr also zügig wieder einlädst, verlierst du keine Zeit auf der Uhr.

Wenn nichts davon hilft

Prüfe zuerst die Statusmeldung auf der Custom-Bot-Seite. Die Nodes von Noxyr schreiben einen verständlichen Grund hin (ungültiger Token, ungültige Intents, suspendiert oder eine allgemeine Meldung zum erneuten Versuch für alles andere), statt nur einen nackten Fehlercode anzuzeigen. Passt die Statusmeldung zu keinem der oben genannten Fälle, oder bleibt der Bot nach einer Lösung, die eigentlich hätte funktionieren müssen, offline, ist das Support Center der schnellste Weg, den konkreten Server prüfen zu lassen. Die vollständigen Schritte zur Einrichtung und Fehlersuche stehen außerdem in der Custom-Bot-Dokumentation.

Häufige Fragen

Warum ist mein Bot offline gegangen, obwohl ich nichts gemacht habe? „Nichts“ heißt meist, dass jemand anders mit Zugriff auf das Portal oder den Server etwas geändert hat: einen Token-Reset, einen Intent-Schalter, einen Kick. Prüfe zuerst die Statusmeldung auf der Custom-Bot-Seite. Dort steht die Ursache.

Gehen Daten verloren, wenn der Bot offline ist? Nein. Token, Einstellungen, Tickets, Produkte, Rechnungen und Transkripte bleiben unabhängig vom Grund für den Stopp erhalten. Wenn du die Ursache behebst, ist alles genau so zurück, wie es war.

Kann ich den Offline-Fall durch das Voting ganz vermeiden? Ja. Stimme etwa alle dreieinhalb Tage ab, bevor das 12-Stunden-Fenster plus die 74-stündige Kulanzzeit ablaufen, dann geht der Bot aus diesem Grund nie offline.

Muss ich die Intents bei jedem Neustart des Bots wieder einschalten? Nein. Intents sind eine Einstellung der Discord-Anwendung selbst und werden nicht zurückgesetzt. Wenn beide eingeschaltet und gespeichert sind, bleiben sie an, bis jemand sie ausschaltet.

Bereit, ihn wieder online zu bringen? Behebe zuerst die Ursache von oben und starte den Bot dann über die Custom-Bot-Seite. Richtest du ihn zum ersten Mal ein, kannst du Noxyr auch kostenlos hinzufügen.