Zum Hauptinhalt springen

Fehlerbehebung

Diese Anleitung hilft dir, häufige Probleme mit deinem SCNX-Custom-Bot zu lösen. Falls dein Problem ein bestimmtes Modul betrifft, schau bitte im Bereich Modulspezifische Fehlerbehebung weiter unten.

Allgemeine Probleme​

Der Bot wird als offline angezeigt​

Der Bot wird auf Discord nicht als online angezeigt
  • Öffne dein „Bot-Status“-Panel und prüfe, ob der Bot läuft.
  • Sollte der Bot offline sein, klicke auf „Bot starten“, damit er wieder erreichbar ist.
  • Wird dein Bot als online angezeigt, ist aber in Discord noch offline? Hab ein wenig Geduld – es kann bis zu 5 Minuten dauern, bis Discord den Status übernimmt.
  • Versuche, den Bot über das „Bot-Status“-Panel neu zu starten.
  • Prüfe den Fehler-Log in deinem Dashboard auf Fehler beim Starten des Bots.

Der Bot reagiert nicht auf Befehle​

Der Bot reagiert auf keine Slash-Commands
  • Vergewissere dich, dass der Bot-Status auf „Online“ steht. (siehe Der Bot wird auf Discord nicht als online angezeigt).
  • Stelle sicher, dass der Bot mit den korrekten Berechtigungen auf deinen Server eingeladen wurde. Lade den Bot erneut über dein Dashboard ein, falls benötigt.
  • Stelle sicher, dass der Bot über die Kanäle ansehen und Nachrichten senden Berechtigungen im entsprechenden Kanal verfügt.
  • Prüfe in deinen Discord-Servereinstellungen, ob der Befehl auf bestimmte Rollen oder Kanäle beschränkt ist (Servereinstellungen > Integrations).
  • Versuche, die Konfiguration des Bots über das „Bot-Status“-Panel neu zu laden.

Slash-Commands werden nicht angezeigt​

Slash-Commands werden in der Befehlsauswahl nicht angezeigt
  • Stelle sicher, dass das Modul, welches den Befehl bereitstellt, in deinem Dashboard aktiviert ist.
  • Lade nach dem Aktivieren eines Moduls die Konfiguration deines Bots neu oder starte den Bot neu.
  • Discord kann bis zu einer Stunde benötigen, um Slash-Commands überall zu synchronisieren. Versuche, deinen Discord-Client neu zu starten.
  • Stelle sicher, dass der Bot über die applications.commands Berechtigungen verfügt. Du kannst dies überprüfen, indem du den Bot über dein Dashboard erneut einlädst.
  • Prüfe in deinen Discord-Servereinstellungen, ob der Befehl auf bestimmte Rollen oder Kanäle beschränkt ist (Servereinstellungen > Integrations > Dein Bot).

Fehler bei den Berechtigungen​

Missing Access / Missing Permissions​

Viele Probleme mit dem Custom-Bot werden durch fehlende Berechtigungen verursacht. Wenn der Bot nicht wie erwartet funktioniert, zeigt der Fehler-Log in deinem Dashboard oft Fehler wie „Missing Access“ oder „Missing Permissions“ an.

Hier findest du die häufigsten Probleme mit Berechtigungen und deren Lösungen:

Missing Access

Der Bot hat keinen Zugriff auf den Kanal, in dem er agieren soll. Um dies zu beheben:

  1. Öffne die Kanaleinstellungen in Discord.
  2. Klicke auf den Bereich „Berechtigungen“
  3. Füge die Rolle des Bots (oder den Bot selbst) hinzu und gewähre die Kanal anzeigen Berechtigung.
  4. Wenn der Kanal einer Kategorie untergeordnet ist, vergewissere dich, dass der Bot auch auf die entsprechende Kategorie Zugriff hat.
Missing Permissions to send messages

Falls der Bot den Kanal sehen, aber nicht darin schreiben kann: Erteile dem Bot in den Kanaleinstellungen folgende Rechte:

  • Nachrichten senden
  • Links einbetten (für Embeds benötigt)
  • Dateien anhängen (falls der Bot Bilder oder Dateien senden soll)
Missing Permissions to manage roles

Dem Bot fehlt die Berechtigung, Rollen zu vergeben oder zu entziehen. Zur Problemlösung:

  1. Stelle sicher, dass der Bot über die Berechtigung Rollen verwalten auf deinem Server verfügt
  2. In der Rollenhierarchie des Servers (Servereinstellungen > Rollen) muss die Rolle des Bots über den Rollen stehen, die er verwalten soll.
  3. Der Bot kann niemals Rollen verwalten, die höher als seine eigene höchste Rolle eingestuft sind oder auf derselben Ebene liegen.
Missing Permissions to manage channels

Der Bot kann die Kanaleinstellungen nicht ändern (z. B. für Kanalstatistiken, temporäre Kanäle oder zum Sperren). Gewähre dem Bot die Berechtigung Kanäle verwalten auf deinem Server oder in den spezifischen Kanälen.

Missing Permissions to moderate members

Der Bot kann Mitglieder nicht stummschalten (Muten). Stelle sicher:

  • Dass der Bot die Mitglieder in Timeout Berechtigung besitzt.
  • Die Rolle des Bots in der Rollenhierarchie über der höchsten Rolle des Zielnutzers steht.
Missing Permissions to kick or ban members

Stelle sicher, dass:

  • Der Bot über die Mitglieder kicken, annehmen oder ablehnen und/oder Mitglieder bannen Berechtigungen verfügt.
  • Die Rolle des Bots in der Rollenhierarchie über der höchsten Rolle des Zielnutzers steht.
  • Der Zielnutzer nicht der Server-Eigentümer ist (der Server-Eigentümer kann niemals gekickt oder gebannt werden).

Der Bot kann den Nicknamen des Server-Eigentümers nicht ändern​

Der Bot kann den Nicknamen des Server-Eigentümers nicht ändern. Dies ist eine Einschränkung von Discord, die für alle Bots gilt – unabhängig von deren Berechtigungen oder ihrer Position in der Rollenhierarchie. Hierfür gibt es keine Umgehungsmöglichkeit.

Fehler bei der Konfiguration​

Änderungen an der Konfiguration werden nicht übernommen
  • Nachdem du die Einstellungen im Dashboard geändert hast, musst du die Konfiguration über das „Bot-Status“-Panel neuladen.
  • Einige Änderungen (wie das Aktivieren neuer Module) erfordern möglicherweise einen vollständigen Neustart des Bots.
  • Überprüfe den Fehler-Log auf konfigurationsbezogene Fehler.
Ungültige Konfigurationswerte
  • Stelle sicher, dass alle Pflichtfelder ausgefüllt sind.
  • Stelle sicher, dass alle verwendeten IDs für Kanäle und Rollen korrekt sind und die entsprechenden Kanäle oder Rollen nicht gelöscht wurden.
  • Achte bei Embed-Konfigurationen darauf, dass du einen gültigen Hex-Farbcode verwendest (z. B. #7289DA). Siehe: Unterstützte Farbwerte.
  • Überprüfe den Fehler Log in deinem Dashboard auf spezifische Fehlermeldungen bezüglich ungültiger Konfigurationen.

Häufige Fehlermeldungen in den Logs​

Hier findest du häufige Fehler, die du im Fehler-Log deines Bots finden kannst, und deren Bedeutung:

FehlerBedeutungLösung
Missing AccessDer Bot hat keinen Zugriff auf den Kanal.Gewähre dem Bot im betroffenen Kanal die Berechtigung „Kanal anzeigen“.
Missing PermissionsDem Bot fehlt eine erforderliche Berechtigung, für eine HandlungÜberprüfe, welche Berechtigung fehlt, und teile sie dem Bot zu.
Unknown ChannelDer in den Einstellungen hinterlegte Kanal wurde gelöscht.Passe deine Einstellungen an und wähle einen existierenden Kanal aus.
Unknown RoleDie in den Einstellungen hinterlegte Rolle wurde gelöscht.Passe deine Einstellungen an und wähle eine existierende Rolle aus.
Unknown MessageDie in der Konfiguration verknüpfte Nachricht ist nicht mehr vorhanden.Konfiguriere das Modul neu oder lass den Bot die Nachricht neu erstellen.
Invalid Form BodyEine Nachricht oder ein Embed überschreitet die Zeichenlimits von Discord.Kürze deine konfigurierten Nachrichten oder den Inhalt des Embeds.
DiscordAPIError[50013]Dem Bot fehlen die Berechtigungen für diese Aktion.Überprüfe und korrigiere die Berechtigungen des Bots. (siehe Fehler bei den Berechtigungen).
DiscordAPIError[50001]Der Bot kann nicht auf die Ressource zugreifen.Gewähre dem Bot Zugriff auf den Kanal oder die Ressource.
DiscordAPIError[30005]Es gibt zu viele Rollen auf dem Server.Discord begrenzt die Anzahl der Rollen. Entferne ungenutzte Rollen.

Verwendung des Fehler-Logs​

Der Fehler-Log ist dein wichtigstes Werkzeug zur Diagnose von Problemen. Du findest es in deinem „Bot-Status“-Panel.

  1. Öffne dein Dashboard und klicke dort auf den Fehler-Log.
  2. Suche nach aktuellen Fehlermeldungen, die dem Zeitraum deines Problems entsprechen.
  3. Die Fehlermeldung enthält in der Regel den Namen des Moduls und eine Beschreibung dessen, was genau den Fehler verursacht hat
  4. Falls du das Problem nicht selbst lösen kannst, teile den Fehler-Log mit dem SCNX Support Team.

Modulspezifische Fehlerbehebung​

Sollte der Fehler im Zusammenhang mit einem speziellen Modul stehen, schaue in den entsprechenden Fehlerbehebungs-Bereich für direkte Unterstützung:

Administration-Module​

Bot-Module​

Community-Module​

Spiele & Spaß-Module​

Integrationen-Module​

Moderation-Module​

Support-Module​

Werkzeug-Module​

Benötigst du weitere Hilfe?​

Falls keine der oben genannten Lösungen dein Problem behebt:

  1. Kontrolliere den Fehler-Log deines Dashboards auf spezifische Fehlermeldungen.
  2. Versuche, die Konfiguration deines Bots neu zu laden oder den Bot neu zu starten.
  3. Kontaktiere das SCNX Support Team und teile deinen Fehler-Log, um weitere Hilfe zu erhalten.