From b9781d73a5dfef095d2f7b1db785854d99a29faf Mon Sep 17 00:00:00 2001 From: melissakre97 <153455693+melissakre97@users.noreply.github.com> Date: Sun, 8 Mar 2026 15:00:17 +0100 Subject: [PATCH 1/8] Create troubleshooting.md German German translation of the Troubleshooting page. --- .../current/custom-bot/troubleshooting.md | 261 ++++++++++++++++++ 1 file changed, 261 insertions(+) create mode 100644 i18n/de/docusaurus-plugin-content-docs/current/custom-bot/troubleshooting.md diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/troubleshooting.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/troubleshooting.md new file mode 100644 index 00000000..c1ab683b --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/troubleshooting.md @@ -0,0 +1,261 @@ +# 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 in den [Modulspezifische Fehlerbehebung](#module-troubleshooting) Bereich weiter unten. + +## Allgemeine Probleme {#general} + +### Der Bot wird als offline angezeigt {#bot-offline} + +
+ Der Bot wird auf Discord nicht als online angezeigt + +
+ +### Der Bot reagiert nicht auf Befehle {#not-responding} + +
+ Der Bot reagiert auf keine Slash-Commands + +
+ +### Slash-Commands werden nicht angezeigt {#missing-commands} + +
+ Slash-Commands werden in der Befehlsauswahl nicht angezeigt + +
+ +## Fehler bei den Berechtigungen {#permissions} + +### Missing Access / Missing Permissions {#missing-access} + +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. +
  2. Klicke auf den Bereich „Berechtigungen“
    3. +
  3. Füge die Rolle des Bots (oder den Bot selbst) hinzu und gewähre die Kanal anzeigen Berechtigung.
    4. +
  4. Wenn der Kanal einer Kategorie untergeordnet ist, vergewissere dich, dass der Bot auch auf die entsprechende Kategorie Zugriff hat.
    5. +
+
+ +
+ Missing Permissions to send messages + + Falls der Bot den Kanal sehen, aber nicht darin schreiben kann: Erteile dem Bot in den Kanaleinstellungen folgende Rechte: + +
+ +
+ 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. +
  2. In der Rollenhierarchie des Servers (Servereinstellungen > Rollen) muss die Rolle des Bots über den Rollen stehen, die er verwalten soll.
    3. +
  3. Der Bot kann niemals Rollen verwalten, die höher als seine eigene höchste Rolle eingestuft sind oder auf derselben Ebene liegen.
    4. +
+
+ +
+ 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 verwaltens auf deinem Server oder in den spezifischen Kanälen. +
+ +
+ Missing Permissions to moderate members + + Der Bot kann Mitglieder nicht stummschalten (Muten). Stelle sicher: + +
+ +
+ Missing Permissions to kick or ban members + + Stelle sicher, dass: + +
+ +### Der Bot kann den Nicknamen des Server-Eigentümers nicht ändern {#owner-nickname} + +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 {#configuration} + +
+ Änderungen an der Konfiguration werden nicht übernommen + +
+ +
+ Ungültige Konfigurationswerte + +
+ +## Häufige Fehlermeldungen in den Logs {#log-errors} + +Hier findest du häufige Fehler, die du im Fehler-Log deines Bots finden kannst, und deren Bedeutung: + +| Fehler | Bedeutung | Lösung | +|-------|---------|----------| +| `Missing Access` | Der Bot hat keinen Zugriff auf den Kanal. | Gewähre dem Bot im betroffenen Kanal die Berechtigung „Kanal anzeigen“. | +| `Missing Permissions` | Dem Bot fehlt eine erforderliche Berechtigung, für eine Handlun.g | Überprüfe, welche Berechtigung fehlt, und teile sie dem Bot zu. | +| `Unknown Channel` | Der in den Einstellungen hinterlegte Kanal wurde gelöscht. | Passe deine Einstellungen an und wähle einen existierenden Kanal aus. | +| `Unknown Role` | Die in den Einstellungen hinterlegte Rolle wurde gelöscht. | Passe deine Einstellungen an und wähle eine existierende Rolle aus. | +| `Unknown Message` | Die in der Konfiguration verknüpfte Nachricht ist nicht mehr vorhanden. | Konfiguriere das Modul neu oder lass den Bot die Nachricht neu erstellen. | +| `Invalid Form Body` | Eine 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](#permissions)). | +| `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 {#error-log} + +Der Fehler-Log ist dein wichtigstes Werkzeug zur Diagnose von Problemen. Du findest es in deinem [„Bot-Status“-Panel](https://scnx.app/glink?page=bot/manage). + +1. Öffne dein [Dashboard](https://scnx.app/glink?page=bot/manage) 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](https://scnx.app/help). + +## Modulspezifische Fehlerbehebung {#module-troubleshooting} + +Sollte der Fehler im Zusammenhang mit einem speziellen Modul stehen, schaue in den entsprechenden Fehlerbehebungs-Bereich für direkte Unterstützung: + +### Administration-Module + +* [Admin-Tools](https://docs.scnx.xyz/de/docs/custom-bot/modules/administration/admin-tools/#troubleshooting) - Verschieben von Kanälen/Rollen, Importieren von Emojis, temporäre Rollen +* [Automatisches Löschen](https://docs.scnx.xyz/de/docs/custom-bot/modules/administration/auto-delete/#troubleshooting) - Automatisches Löschen von Nachrichten +* [Kanal-Satistiken](https://docs.scnx.xyz/de/docs/custom-bot/modules/administration/channel-stats/#troubleshooting) - Statistik-Kanäle +* [Fortgeschrittenes Logging](https://docs.scnx.xyz/de/docs/custom-bot/modules/administration/logging/#troubleshooting) - Protokollierung von Serveränderungen +* [Partner-Liste](https://docs.scnx.xyz/de/docs/custom-bot/modules/administration/partner-list/#troubleshooting) - Partner-Liste +* [Status-Rollen](https://docs.scnx.xyz/de/docs/custom-bot/modules/administration/status-roles/#troubleshooting) - Rollen basierend auf dem Discord-Status +* [Vorschläge](https://docs.scnx.xyz/de/docs/custom-bot/modules/administration/suggestions/#troubleshooting) - Vorschlags-System +* [Teammitglieder-Ziele](https://docs.scnx.xyz/de/docs/custom-bot/modules/administration/team-goals/#troubleshooting) - Wöchentliche Nachrichtenziele für Teammitglieder +* [Teammitglieder-Liste](https://docs.scnx.xyz/de/docs/custom-bot/modules/administration/team-list/#troubleshooting) - Automatisch aktualisierendes Team-Embed +* [Willkommen und Boosts](https://docs.scnx.xyz/de/docs/custom-bot/modules/administration/welcomer/#troubleshooting) - Willkommens-, Abschieds- und Boost-Nachrichten + +### Bot-Module + +* [Betterstatus](https://docs.scnx.xyz/de/docs/custom-bot/modules/bot/betterstatus/#troubleshooting) - Benutzerdefinierter Bot-Status +* [Reaction Roles](https://docs.scnx.xyz/de/docs/custom-bot/modules/bot/reaction-roles/#troubleshooting) - Selbstzuweisbare Rollen via Reaktionen + +### Community-Module + +* [Aktivitäts-Streaks](https://docs.scnx.xyz/de/docs/custom-bot/modules/community/activity-streak/#troubleshooting) - Verfolgung von Aktivitäts-Streaks +* [Anonymer Chat](https://docs.scnx.xyz/de/docs/custom-bot/modules/community/anonymous-chat/#troubleshooting) - Anonyme Nachrichten +* [Geburtstags-Kalender](https://docs.scnx.xyz/de/docs/custom-bot/modules/community/birthday/#troubleshooting) - Verfolgung von Geburtstagen +* [Color me](https://docs.scnx.xyz/de/docs/custom-bot/modules/community/color-me/#troubleshooting) - Benutzerdefinierte Farbrollen +* [Economy](https://docs.scnx.xyz/de/docs/custom-bot/modules/community/economy-system/#troubleshooting) - Virtuelles Economy-System +* [Gewinnspiele](https://docs.scnx.xyz/de/docs/custom-bot/modules/community/giveaways/#troubleshooting) - Gewinnspiele-System +* [Sammel die Codes](https://docs.scnx.xyz/de/docs/custom-bot/modules/community/hunt-the-code/#troubleshooting) - Code-Suche Spiel +* [Level-System](https://docs.scnx.xyz/de/docs/custom-bot/modules/community/levels/#troubleshooting) - XP und Leveling +* [Live-Nachrichten](https://docs.scnx.xyz/de/docs/custom-bot/modules/community/live-messages/#troubleshooting) - Dynamische Statistik-Nachrichten +* [Rollen-Nicknamen](https://docs.scnx.xyz/de/docs/custom-bot/modules/community/nicknames/#troubleshooting) - Rollen-basierte Nicknames +* [Umfragen](https://docs.scnx.xyz/de/docs/custom-bot/modules/community/polls/#troubleshooting) - Umfragen-System +* [Erinnerungen](https://docs.scnx.xyz/de/docs/custom-bot/modules/community/reminders/#troubleshooting) - Erinnerungen-System +* [Serverinformationen](https://docs.scnx.xyz/de/docs/custom-bot/modules/community/serverinfo/#troubleshooting) - Kanal mit Serverinformationen +* [Starboard](https://docs.scnx.xyz/de/docs/custom-bot/modules/community/starboard/#troubleshooting) - Nachrichten Starboard +* [Sticky-Nachrichten](https://docs.scnx.xyz/de/docs/custom-bot/modules/community/sticky-messages/#troubleshooting) - Sticky-Nachrichten +* [Temporäre Channel](https://docs.scnx.xyz/de/docs/custom-bot/modules/community/temp-channels/#troubleshooting) - Temporäre Voice-Channel +* +### Spiele & Spaß-Module + +* [Automatisches Reagieren](https://docs.scnx.xyz/de/docs/custom-bot/modules/fun/auto-react/#troubleshooting) - Automatisches Reagieren +* [Zähl-Spiel](https://docs.scnx.xyz/de/docs/custom-bot/modules/fun/counter/#troubleshooting) - Zähl-Spiel +* [Duel](https://docs.scnx.xyz/de/docs/custom-bot/modules/fun/duel/#troubleshooting) - Duell-Spiel +* [Emoji-Quiz](https://docs.scnx.xyz/de/docs/custom-bot/modules/fun/emoji-quiz/#troubleshooting) - Emoji-Quiz +* [Errate die Flagge!](https://docs.scnx.xyz/de/docs/custom-bot/modules/fun/flag-quiz/#troubleshooting) - Flaggen-Quiz +* [Fun-Befehle](https://docs.scnx.xyz/de/docs/custom-bot/modules/fun/#troubleshooting) - Soziale Interaktions-Befehle +* [Errate die Nummer](https://docs.scnx.xyz/de/docs/custom-bot/modules/fun/guess-the-number/#troubleshooting) - Errate die Nummer-Spiel +* [Winterliche Feiertage](https://docs.scnx.xyz/de/docs/custom-bot/modules/fun/holidays/#troubleshooting) - Feiertage Feature +* [Quiz-Modul](https://docs.scnx.xyz/de/docs/custom-bot/modules/fun/quiz/#troubleshooting) - Quiz +* [Schere Stein Papier](https://docs.scnx.xyz/de/docs/custom-bot/modules/fun/rock-paper-scissors/#troubleshooting) - Schere Stein Papier Spiel +* [Tic-Tac-Toe](https://docs.scnx.xyz/de/docs/custom-bot/modules/fun/tic-tak-toe/#troubleshooting) - Tic-Tac-Toe Spiel +* [UNO](https://docs.scnx.xyz/de/docs/custom-bot/modules/fun/uno/#troubleshooting) - UNO Spiel + +### Integrationen-Module + +* [Minecraft Server Status](https://docs.scnx.xyz/de/docs/custom-bot/modules/integrations/minecraft-status/#troubleshooting) - Minecraft Server status +* [Reddit-Benachrichtigungen](https://docs.scnx.xyz/de/docs/custom-bot/modules/integrations/reddit-notifications/#troubleshooting) - Reddit-Benachrichtugungen +* [RSS-Benachrichtigungen](https://docs.scnx.xyz/de/docs/custom-bot/modules/integrations/rss-notifications/#troubleshooting) - Benachrichtigungen bei RSS-Beiträgen +* [Threads-Benachrichtigungen](https://docs.scnx.xyz/de/docs/custom-bot/modules/integrations/threads-notifications/#troubleshooting) - Benachrichtigungen bei Thread-Beiträgen +* [TikTok-Benachrichtigungen](https://docs.scnx.xyz/de/docs/custom-bot/modules/integrations/tiktok-notifications/#troubleshooting) - TikTok-Video-Benachrichtigungen +* [Twitch-Benachrichtigungen](https://docs.scnx.xyz/de/docs/custom-bot/modules/integrations/twitch-notifications/#troubleshooting) - Twitch-Stream-Benachrichtigungen +* [YouTube-Benachrichtigungen](https://docs.scnx.xyz/de/docs/custom-bot/modules/integrations/youtube-notifications/#troubleshooting) - YouTube-Video/Stream-Benachrichtigungen + +### Moderation-Module + +* [Anti-Ghostping](https://docs.scnx.xyz/de/docs/custom-bot/modules/moderation/anti-ghostping/#troubleshooting) - Ghost-Ping Erkennung +* [Info-Befehle](https://docs.scnx.xyz/de/docs/custom-bot/modules/moderation/info-commands/#troubleshooting) - Info-Befehle +* [Invite-Tracking](https://docs.scnx.xyz/de/docs/custom-bot/modules/moderation/invite-tracking/#troubleshooting) - Invite-Tracking +* [Moderation & Sicherheit](https://docs.scnx.xyz/de/docs/custom-bot/modules/moderation/#troubleshooting) - Umfassendes Moderations-System +* [Ping-Schutz](https://docs.scnx.xyz/de/docs/custom-bot/modules/moderation/ping-protection/#troubleshooting) - Ping-Schutz + +### Support-Module + +* [Bewerbungen](https://docs.scnx.xyz/de/docs/custom-bot/modules/support/applications/#troubleshooting) - Bewerbungs-System +* [Forum Support](https://docs.scnx.xyz/de/docs/custom-bot/modules/support/forum-support/#troubleshooting) - Foren-basierter Support +* [Sprachkanal-Aktionen](https://docs.scnx.xyz/de/docs/custom-bot/modules/support/ping-on-vc-join/#troubleshooting) - Sprachkanal-Beitrittsmeldungen +* [Ticket-System](https://docs.scnx.xyz/de/docs/custom-bot/modules/support/tickets/#troubleshooting) - Ticket-System + +### Werkzeug-Module + +* [AFK-System](https://docs.scnx.xyz/de/docs/custom-bot/modules/tools/afk-system/#troubleshooting) - AFK-Status-System +* [Automatische Nachrichten](https://docs.scnx.xyz/de/docs/custom-bot/modules/tools/auto-messager/#troubleshooting) - Automatisierte Nachrichten +* [Automatische Veröffentlichung](https://docs.scnx.xyz/de/docs/custom-bot/modules/tools/auto-publisher/#troubleshooting) - Automatische Veröffentlichung +* [Automatisches Thread-Erstellen](https://docs.scnx.xyz/de/docs/custom-bot/modules/tools/auto-thread/#troubleshooting) - Automatisches Thread-Erstellen +* [Massrole](https://docs.scnx.xyz/de/docs/custom-bot/modules/tools/massrole/#troubleshooting) - Massen-Rollen-Zuweisung +* [Namenslisten Cleaner](https://docs.scnx.xyz/de/docs/custom-bot/modules/tools/name-list-cleaner/#troubleshooting) - Automatische Namensbereinigung + +## Benötigst du weitere Hilfe? {#help} + +Falls keine der oben genannten Lösungen dein Problem behebt: + +1. Kontrolliere den Fehler-Log deines [Dashboards](https://scnx.app/glink?page=bot/manage) auf spezifische Fehlermeldungen. +2. Versuche, die Konfiguration deines Bots neu zu laden oder den Bot neu zu starten. +3. Kontaktiere das [SCNX Support Team](https://scnx.app/help) und teile deinen Fehler-Log, um weitere Hilfe zu erhalten. From ad2f78d4f174cad3e1777ce97834bee35bc5404c Mon Sep 17 00:00:00 2001 From: melissakre97 <153455693+melissakre97@users.noreply.github.com> Date: Mon, 9 Mar 2026 06:22:13 +0100 Subject: [PATCH 2/8] Update troubleshooting.md Links changed --- .../current/custom-bot/troubleshooting.md | 140 +++++++++--------- 1 file changed, 70 insertions(+), 70 deletions(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/troubleshooting.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/troubleshooting.md index c1ab683b..53f52970 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/troubleshooting.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/troubleshooting.md @@ -9,7 +9,7 @@ Diese Anleitung hilft dir, häufige Probleme mit deinem SCNX-Custom-Bot zu löse
Der Bot wird auf Discord nicht als online angezeigt