diff --git a/docs/scnx/intro.md b/docs/scnx/intro.md index 9bbeeb65..82f1f055 100644 --- a/docs/scnx/intro.md +++ b/docs/scnx/intro.md @@ -37,8 +37,6 @@ detailed [frequently asked questions](/docs/scnx/guilds/faq) section about serve the [toolbox documentation](/docs/scnx/account-and-billing/toolbox). * SCNX Ads: Advertise your server or product on SCNX. You can open the [Ads on SCNX documentation](/docs/scnx/account-and-billing/ads). -* SCNX Referrals: Earn a commission for purchased plans on SCNX. You can open - the [Referrals documentation](/docs/scnx/account-and-billing/referrals). * SCNX File Storage: Host images and more for your Discord servers and embed them directly on SCNX. * SC Network Memberships (outdated): *More information will be made available shortly*. @@ -51,8 +49,7 @@ questions you might have. [ScootKit](https://scootkit.net) is a German-based company running SCNX and other service-as-a-service products. ::: -* [ScootKit Merch Store](https://scnx.app/user/merch): Purchase physical SCNX Merch. -* [Feature Board](https://features.sc-network.net): Suggest new features for SCNX Products. +* [Feature Board](https://featureboard.net/): Suggest new features for SCNX Products. * SCNX Marketplace: A system for third-parties to integrate new and existing products into SCNX. * [SCNX Documentation](/): This documentation aimed to explain as many features of SCNX in detail as possible. * [SCNX FAQ](https://faq.scnx.app): Legacy articles about a few topics on SCNX (mostly used for legal stuff). Previously @@ -67,7 +64,5 @@ questions you might have. * [SCNX Helper Program](https://scnx.app/user/helper-application): A program to allow involved community members with technical knowledge about SCNX to receive recognition and perks based as an "SCNX Helper" on our [Discord server](https://scootk.it/dc). -* [ScootKit Moderator](https://scnx.app/user/moderator-application): Program designed to allow community members to - moderate, organize events and more on our [Discord server](https://scootk.it/dc). * ScootKit RSS Hub: System designed to handle traffic and notifications for CustomBot Notification-Modules. -* and more… :wink: \ No newline at end of file +* and more… :wink: diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/login-as-bot.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/login-as-bot.md new file mode 100644 index 00000000..3f0935a9 --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/login-as-bot.md @@ -0,0 +1,119 @@ +# Versende Nachrichten / Embeds, Self-Rollen und mehr + +Sende Nachrichten, Embeds und Forenposts über deinen Bot – direkt aus dem SCNX-Dashboard. Du kannst diese Funktion auch nutzen, um Selbst-Rollen-Nachrichten mit Knöpfen zu erstellen. + + + +## Übersicht {#overview} + +Als Bot anmelden ermöglicht es dir, die Nachrichten deines Bots direkt über das Dashboard zu steuern, ohne Discord auf deinem Gerät geöffnet haben zu müssen. Folgende Optionen stehen dir zur Verfügung: + +* Verschicke Nachrichten und formatierte Embeds in sämtliche Kanäle, auf die dein Bot Zugriff hat. +* Bearbeite bereits gesendete Bot-Nachrichten. +* Hänge Dateien an Nachrichten an. +* Füge interaktive Komponenten wie Knöpfe und Auswahlmenüs hinzu (einschließlich Selbst-Rollen-Knöpfe). +* Erstelle Forenposts in Foren-Kanälen. +* Sieh dir den Audit-Log aller über das Dashboard gesendeten Nachrichten an. + +## Einrichtung {#setup} + +1. Öffne die Seite [Als Bot anmelden](https://scnx.app/de/glink?page=bot/login) auf deinem SCNX-Dashboard. +2. Stelle sicher, dass dein Bot **online** ist — Als Bot anmelden setzt voraus, dass dein Bot ohne kritische Fehler läuft. +3. Dein Bot benötigt die Berechtigungen **Kanal anzeigen** und **Nachrichten senden** in jedem Kanal, in den du Nachrichten verschicken möchtest. + +:::caution +Falls dein Bot offline ist oder kritische Probleme aufweist, kannst du Als Bot anmelden nicht nutzen. Sieh dir die [Fehlerbehebungs Dokumentation](/de/docs/custom-bot/troubleshooting/) an, falls dein Bot nicht startet. +::: + +## Versenden einer Nachricht {#send-message} + +1. Öffne die Seite [Als Bot anmelden](https://scnx.app/de/glink?page=bot/login) auf deinem SCNX-Dashboard. +2. Wähle den Kanal, in den du die Nachricht senden möchtest, aus der Kanalliste auf der linken Seite aus. +3. Verfasse deine Nachricht mit dem Nachrichten-Editor. Folgende Optionen stehen dir zur Verfügung: + * Schreibe reinen Text in das Nachrichtenfeld. + * Füge ein oder mehrere Embeds mit benutzerdefiniertem Titel, Beschreibung, Farbe, Feldern, Bildern, Fußzeile und mehr hinzu. + * Füge Dateien hinzu. + * Füge Komponenten hinzu (siehe [Komponenten hinzufügen](#components)). +4. Klicke zum Absenden auf „Nachricht senden“. + +:::tip +Nutze die Vorschau im Nachrichten-Editor, um zu sehen, wie deine Nachricht vor dem Absenden aussehen wird. +::: + +## Editing a message {#edit-message} + +You can edit messages that were previously sent by your bot (including messages sent via Bot Log-In). + +1. Öffne die Seite [Als Bot anmelden](https://scnx.app/de/glink?page=bot/login) auf deinem SCNX-Dashboard. +2. Wähle den Kanal, in den du die Nachricht senden möchtest, aus der Kanalliste auf der linken Seite aus. +3. Suche die Nachricht in der Kanalansicht und klicke auf „Nachricht bearbeiten“. +4. Passe den Nachrichteninhalt, die Embeds oder die Komponenten mit dem Nachrichten-Editor an. +5. Klicke auf „Nachricht bearbeiten“, um deine Änderungen zu übernehmen. + +## Komponenten hinzufügen {#components} + +Du kannst Nachrichten, die über Als Bot anmelden gesendet werden, interaktive Komponenten hinzufügen: + +* **Eigene Befehl Knöpfe hinzufügen** — Knöpfe, die deine [Eigenen Befehle](/de/docs/custom-bot/custom-commands/) auslösen, wenn sie angeklickt werden. Konfiguriere diese im Bereich „Komponenten“ des Nachrichten-Editors und verknüpfe sie mit einem Eigenen Befehl, der einen Knopf-Trigger nutzt. +* **Selbst-Rollen-Knopf hinzufügen** — Knöpfe, die beim Anklicken eine Rolle hinzufügen oder entfernen und es Mitgliedern so ermöglichen, sich selbst Rollen zuzuweisen. Dies ist eine moderne, übersichtlichere Alternative zu den herkömmlichen „Reaction Roles“. +* **Select-Menüs** — Auswahlmenüs, mit denen Nutzer aus einer Liste von Optionen wählen können. Diese können ebenfalls mit Eigenen Befehlen verknüpft werden. + +:::info +Um einen Eigene Befehl Knopf zu verwenden, musst du zuerst einen [Eigenen Befehl erstellen](/de/docs/custom-bot/custom-commands/), der einen Knopf-Trigger nutzt. Diesen kannst du dann beim Hinzufügen eines Eigenen Befehl Knopfes im Nachrichten-Editor auswählen. +::: + +## Einen Forenpost erstellen {#forum-post} + +Wenn der ausgewählte Kanal ein Foren-Kanal ist, kannst du einen neuen Post erstellen: + +1. Öffne die Seite [Als Bot anmelden](https://scnx.app/de/glink?page=bot/login) auf deinem SCNX-Dashboard. +2. Wähle einen Foren-Kanal aus. +3. Klicke auf **„Post erstellen“**. +4. Gib den Namen des Posts ein und verfasse die erste Nachricht. +5. Wähle optional Tags aus, die dem Beitrag zugewiesen werden sollen. +6. Klicke auf **„Post erstellen“**, um ihn zu veröffentlichen. + +## Audit-Log für gesendete Nachrichten {#audit-log} + +Als Bot anmelden führt ein Protokoll über alle Nachrichten, die über das Dashboard gesendet wurden. Klicke auf „Gesendete Nachrichten“, um den Audit-Log aufzurufen, der folgende Informationen anzeigt: + +* Den Kanal, in den jede Nachricht gesendet wurde. +* Wer die Nachricht über das Dashboard gesendet hat. +* Ob die Nachricht **zugestellt** oder **nicht zugestellt** wurde. +* Das Nachrichtenformat. + +Diese Funktion ist hilfreich, um den Überblick über gesendete Inhalte zu behalten und Fehler bei fehlgeschlagenen Zustellungen zu beheben. + +## Fehlerbehebung {#troubleshooting} + +
+ Als Bot anmelden zeigt „Bot ist offline“ an + + Dein Bot muss online sein und darf keine kritischen Probleme aufweisen. Überprüfe das + Bot-Dashboard nach Fehlermeldungen und schaue dir die + Fehlerbehebungs-Dokumentation an. +
+ +
+ Ich kann keine Kanäle sehen / Fehler: „No text channels“ + + Dein Bot benötigt die Berechtigungen Kanal anzeigen und Nachrichten senden. Bitte einen Server-Administrator, die Kanalberechtigungen des Bots zu überprüfen. +
+ +
+ Nachricht konnte nicht gesendet werden / „Nicht zugestellt“ + +
+ +
+ Ich kann eine Nachricht nicht bearbeiten + +
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/status-roles.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/status-roles.md new file mode 100644 index 00000000..61a657c4 --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/status-roles.md @@ -0,0 +1,45 @@ +# Status-Roles + +Ein einfaches Modul, um Nutzer mit Rollen zu belohnen, die bestimmte Wörter in ihrem benutzerdefinierten Discord-Status haben. + + + +## Funktionen {#features} + +* Weise Nutzern automatisch Rollen zu, die bestimmte Wörter oder Phrasen in ihrem benutzerdefinierten Discord-Status haben. +* Entferne automatisch die zugewiesenen Rollen, wenn ein Nutzer seinen Status ändert und die erforderlichen Wörter nicht mehr enthalten sind. +* Entferne optional alle anderen (nicht verwalteten) Rollen von Nutzern, wenn sie die Status-Kriterien erfüllen. +* Option, Offline-Nutzer zu ignorieren, um das Entfernen von Rollen beim Ausloggen zu verhindern (empfohlen für größere Server). + +## Einrichtung {#setup} + +1. [Aktiviere das Modul](https://scnx.app/de/glink?page=bot/modules?query=status-roles) auf deinem Server. +2. Öffne die [Modul-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=status-roles%7Cconfig) und füge die Wörter, die Nutzer in ihrem Status haben sollten, in das Feld „Wörter“ ein. +3. Füge die Rollen, die entsprechenden Nutzern zugewiesen werden sollen, im Feld „Rollen“ hinzu. +4. Stelle sicher, dass der Bot über die Berechtigung **Rollen verwalten** verfügt und dass die höchste Rolle des Bots über den Rollen steht, die du zuweisen möchtest. +5. Der Bot benötigt außerdem den **Presence Intent**, um Statusänderungen zu erkennen. Dieser ist bei SCNX standardmäßig aktiviert. +6. Wenn dein Server mehr als 500 Mitglieder hat, wird empfohlen, die Option „Rollen von offline Nutzern nicht entfernen“ zu aktivieren, um einen fehlerhaften Rollenentzug zu verhindern. + +## Nutzung {#usage} + +* Einmal konfiguriert, arbeitet das Modul automatisch. Wenn ein Nutzer seinen benutzerdefinierten Discord-Status aktualisiert, prüft der Bot, ob eines der konfigurierten Wörter darin vorkommt. +* Wenn eine Übereinstimmung gefunden wird, werden dem Nutzer die konfigurierten Rollen zugewiesen. +* Wenn der Nutzer seinen Status ändert und die Wörter nicht mehr vorhanden sind, werden die Rollen entfernt (es sei denn, der Nutzer ist offline und die Option „Rollen von offline Nutzern nicht entfernen“ ist aktiviert). +* Bei der Wortübereinstimmung wird nicht zwischen Groß- und Kleinschreibung unterschieden. + +## Konfiguration {#configuration} + +Dies ist die Konfigurationsdatei für das Modul. Öffne sie in deinem [Dashboard](https://scnx.app/de/glink?page=bot/configuration?file=status-roles%7Cconfig). + +| Feld | Beschreibung | +|-------|-------------| +| Statusinhalt | Wörter, die Nutzer in ihrem benutzerdefinierten Status haben sollten. Der Bot prüft, ob eines dieser Wörter im Status des Nutzers vorkommt (Groß-/Kleinschreibung wird nicht berücksichtigt). | +| Rollen | Rollen, die Nutzern zugewiesen werden, wenn eines der konfigurierten Wörter in ihrem Status vorkommt. | +| Entferne alle anderen Rollen | Falls aktiviert, werden alle anderen (nicht vom Modul verwalteten) Rollen vom Nutzer entfernt, sobald dieser die Status-Kriterien erfüllt. | +| Rollen von offline Nutzern nicht entfernen | Falls aktiviert, werden die Status-Rollen nicht von Nutzern entfernt, die offline sind. Empfohlen für Server mit mehr als 500 Mitgliedern. | + +## Fehlerbehebung {#troubleshooting} + +* **Rollen werden nicht zugewiesen**:Stelle sicher, dass der Bot über die Berechtigung „Rollen verwalten“ verfügt und dass die höchste Rolle des Bots über den Rollen steht, die du zuweisen möchtest. Überprüfe außerdem, ob die Wörter in der Konfiguration mit denen übereinstimmen, die Nutzer in ihrem benutzerdefinierten Status haben. +* **Rollen werden entfernt, wenn Nutzer offline gehen**: Aktiviere die Option „Rollen von Offline-Nutzern nicht entfernen“ in der Konfiguration. Wenn Nutzer offline gehen, entfernt Discord deren Statusinformationen, was den Bot zu der Annahme führt, dass die Bedingungen nicht mehr erfüllt sind. +* **Das Modul scheint keine Statusänderungen zu erkennen**: Stelle sicher, dass der „Presence Intent“ für deinen Bot aktiviert ist. Auf SCNX ist dieser standardmäßig aktiviert. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/anonymous-chat.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/anonymous-chat.md new file mode 100644 index 00000000..74c40af4 --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/anonymous-chat.md @@ -0,0 +1,98 @@ +# Anonymer Chat + +Lasse deine Nutzer ihre Erfahrungen anonym teilen, während du gleichzeitig die volle Kontrolle über die Moderation deines Chats behältst. + + + +## Funktionen {#features} + +* Nutzer können über einen Slash-Befehl anonyme Nachrichten an einen festgelegten Kanal senden. +* Jedem Nutzer wird für seine anonyme Identität ein eindeutiger, zufällig generierter Anzeigename und ein Avatar zugewiesen. +* Moderatoren können Nutzer anhand ihres Anzeigenamens für den anonymen Chat sperren, während die Anonymität dennoch gewahrt bleibt. +* Moderatoren können anonyme Nachrichten löschen. +* Ermögliche es Nutzern optional, ihre anonyme Identität zurückzusetzen. +* Unterstütze optional Webhook-basierte Nachrichten für ein natürlicheres Chat-Erscheinungsbild. +* Ermögliche es Nutzern optional, anonyme Nachrichten durch direktes Tippen im Kanal zu senden (weniger sicher). + +## Einrichtung {#setup} + +1. Erstelle einen Textkanal für anonyme Nachrichten und konfiguriere diesen in der [Modul-Konfiguration](#configuration). +2. Stelle sicher, dass der Bot im anonymen Chat-Kanal über die Berechtigungen `Kanal anzeigen`, `Nachrichten senden`, `Links einbetten` und `Nachrichten verwalten` verfügt. +3. Bei der Verwendung von Webhooks benötigt der Bot zusätzlich die Berechtigung `WebHooks verwalten`. +4. Richte die [Berechtigungen für Slash-Befehle](/de/docs/custom-bot/slash-commands/) für `/moderate-anonymous-channel` so ein, dass dieser Befehl auf Moderatoren beschränkt ist. + +## Nutzung {#usage} + +Nutzer können anonyme Nachrichten über `/anonymous-message` senden. Bei der ersten Verwendung wird ihnen automatisch ein zufällig generierter Anzeigename und ein Avatar zugewiesen. Falls das Zurücksetzen der Identität aktiviert ist, können Nutzer beim Senden einer neuen Nachricht wählen, ob sie ihre Identität zurücksetzen möchten. + +Moderatoren können den anonymen Chat über `/moderate-anonymous-channel` verwalten: + +* **Einen Nutzer sperren**: Verwende `disable` zusammen mit dem anonymen Anzeigenamen des Nutzers. Dies funktioniert auch mit früheren Anzeigenamen, falls der Nutzer seine Identität zurückgesetzt hat. +* **Einen Nutzer entsperren**: Verwende `enable` zusammen mit dem aktuellen anonymen Anzeigenamen des Nutzers. +* **Eine Nachricht löschen**: Verwende d`elete-message`, um eine anonyme Nachricht zu entfernen. Die Autovervollständigung hilft dir dabei, die Nachricht zu finden. + +Falls das Senden von Nachrichten in den Chat aktiviert ist, können Nutzer auch direkt in den anonymen Chat-Kanal schreiben – ihre Nachricht wird gelöscht und anonym neu gepostet. Beachte, dass Bots zur Nachrichtenprotokollierung (Logging-Bots) die ursprüngliche Nachricht dennoch erfassen könnten. Daher wird diese Methode für wirklich anonyme Chats nicht empfohlen. + +## Befehle {#commands} + + + +| Befehl | Beschreibung | +|---------|-------------| +| `/anonymous-message message: [reset-identity:]` | Sende eine anonyme Nachricht in den konfigurierten Kanal. Setze optional deine anonyme Identität vor dem Senden zurück (nur verfügbar, wenn das Zurücksetzen der Identität in der Konfiguration aktiviert ist). | +| `/moderate-anonymous-channel disable display-name: [reason:]` | Sperre einen Nutzer anhand seines anonymen Anzeigenamens für das Senden anonymer Nachrichten. Optional kann ein Grund angegeben werden. Erfordert die Berechtigung Mitglieder moderieren. | +| `/moderate-anonymous-channel enable display-name:` | Hebe die Sperre eines zuvor blockierten Nutzers anhand seines anonymen Anzeigenamens auf. Erfordert die Berechtigung Mitglieder moderieren. | +| `/moderate-anonymous-channel delete-message message:` | Lösche eine anonyme Nachricht. Der Nachrichten-Parameter unterstützt die Autovervollständigung, um nach Inhalt oder ID zu suchen. Erfordert die Berechtigung Mitglieder moderieren. | + +## Konfiguration {#configuration} + +In dieser Konfigurationsdatei kannst du das Modul konfigurieren. Öffne sie in deinem [Dashboard](https://scnx.app/de/glink?page=bot/configuration?file=anonymous-chat%7Cconfig). + +| Feld | Beschreibung | +|-------|-------------| +| Kanal | Der Kanal, in den die anonymen Nachrichten gesendet werden. | +| Webhook-Nachrichten verwenden? | Falls aktiviert, werden Nachrichten über Webhooks mit dem anonymen Anzeigenamen und Avatar des Nutzers gesendet, was ein natürlicheres Chat-Erlebnis ermöglicht. Dies deaktiviert die individuelle Nachrichtenanpassung. | +| Anonyme Nachrichten | Passe das Erscheinungsbild anonymer Nachrichten an (wird nur verwendet, wenn Webhooks deaktiviert sind). Unterstützt Parameter für Anzeigenamen, Avatar und Nachrichteninhalt. | +| Bestätigung des Nachrichtenversands | Die Bestätigungsnachricht, die dem Nutzer angezeigt wird, nachdem seine anonyme Nachricht gesendet wurde. | +| Blockiert-Nachricht | Die Nachricht, die gesperrten Nutzern angezeigt wird, wenn sie versuchen, eine anonyme Nachricht zu senden. | +| Nutzern erlauben, ihre Identität zurückzusetzen? | Falls aktiviert, können Nutzer ihren anonymen Anzeigenamen und Avatar beim Senden einer Nachricht zurücksetzen. Moderatoren können Nutzer weiterhin über jeden ihrer früheren anonymen Anzeigenamen sperren, selbst nach einem Reset. | +| Nutzern erlauben, anonyme Nachrichten durch Senden von Nachrichten in den Kanal zu erstellen? (unsicher) | Falls aktiviert, können Nutzer direkt in den anonymen Kanal schreiben, um anonyme Nachrichten zu erstellen. Dies wird für wirklich anonyme Chats nicht empfohlen, da Bots zur Nachrichtenprotokollierung den ursprünglichen Verfasser erfassen können. | + +## Fehlerbehebung {#troubleshooting} + +
+ Anonyme Nachrichten werden nicht angezeigt +
    +
  • Stelle sicher, dass der konfigurierte Kanal existiert und der Bot über die erforderlichen Berechtigungen verfügt.
    • +
  • Falls Webhooks verwendet werden, stelle sicher, dass der Bot über die Berechtigung Webhooks verwalten WebHooks verwalten verfügt.
    • +
+
+ +
+ Ein Nutzer, dessen Identität zurückgesetzt wurde, kann nicht blockiert werden + +Wenn ein Nutzer seine Identität zurücksetzt, kannst du ihn weiterhin über seinen alten Anzeigenamen sperren – das Modul verfolgt frühere Anzeigenamen und findet so die aktuelle Identität des Nutzers. +
+ +## Gespeicherte Daten {#data-usage} + +Die folgenden Daten werden gespeichert: + +Für jeden anonymen Nutzer: +* Die Discord-Nutzer-ID +* Der zufällig generierte anonyme Anzeigename und die Avatar-URL +* Ob der Nutzer gesperrt ist und der Grund für die Sperrung (falls vorhanden) +* Metadaten zum Eintrag (Erstellungsdatum und Datum der letzten Aktualisierung) + +Für jede anonyme Nachricht: +* Die Nachrichten-ID und Kanal-ID +* Der Nachrichteninhalt +* Ob die Nachricht gelöscht wurde +* Metadaten zum Eintrag (Erstellungsdatum und Datum der letzten Aktualisierung) + +Für jedes Zurücksetzen der Identität: +* Die Discord-Nutzer-ID +* Der vorherige anonyme Anzeigename +* Metadaten zum Eintrag (Erstellungsdatum und Datum der letzten Aktualisierung) + +Um alle von diesem Modul gespeicherten Daten zu entfernen, [lösche die Modul-Datenbank](/de/docs/custom-bot/additional-features/#reset-module-database). 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..897286f8 --- /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 im Bereich [Modulspezifische Fehlerbehebung](#module-troubleshooting) weiter unten. + +## Allgemeine Probleme {#general} + +### Der Bot wird als offline angezeigt {#bot-offline} + +
+ 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 {#not-responding} + +
+ 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 {#missing-commands} + +
+ 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 {#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: +
    +
  • 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. +
  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 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 {#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 +
    +
  • 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 {#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 Handlung | Ü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/de/glink?page=bot/manage). + +1. Öffne dein [Dashboard](https://scnx.app/de/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](/de/docs/custom-bot/modules/administration/admin-tools/#troubleshooting) - Verschieben von Kanälen/Rollen, Importieren von Emojis, temporäre Rollen +* [Automatisches Löschen](/de/docs/custom-bot/modules/administration/auto-delete/#troubleshooting) - Automatisches Löschen von Nachrichten +* [Kanal-Statistiken](/de/docs/custom-bot/modules/administration/channel-stats/#troubleshooting) - Statistik-Kanäle +* [Fortgeschrittenes Logging](/de/docs/custom-bot/modules/administration/logging/#troubleshooting) - Protokollierung von Serveränderungen +* [Partner-Liste](/de/docs/custom-bot/modules/administration/partner-list/#troubleshooting) - Partner-Liste +* [Status-Rollen](/de/docs/custom-bot/modules/administration/status-roles/#troubleshooting) - Rollen basierend auf dem Discord-Status +* [Vorschläge](/de/docs/custom-bot/modules/administration/suggestions/#troubleshooting) - Vorschlags-System +* [Teammitglieder-Ziele](/de/docs/custom-bot/modules/administration/team-goals/#troubleshooting) - Wöchentliche Nachrichtenziele für Teammitglieder +* [Teammitglieder-Liste](/de/docs/custom-bot/modules/administration/team-list/#troubleshooting) - Automatisch aktualisierendes Team-Embed +* [Willkommen und Boosts](/de/docs/custom-bot/modules/administration/welcomer/#troubleshooting) - Willkommens-, Abschieds- und Boost-Nachrichten + +### Bot-Module + +* [Betterstatus](/de/docs/custom-bot/modules/bot/betterstatus/#troubleshooting) - Benutzerdefinierter Bot-Status +* [Reaction Roles](/de/docs/custom-bot/modules/bot/reaction-roles/#troubleshooting) - Selbstzuweisbare Rollen via Reaktionen + +### Community-Module + +* [Aktivitäts-Streaks](/de/docs/custom-bot/modules/community/activity-streak/#troubleshooting) - Verfolgung von Aktivitäts-Streaks +* [Anonymer Chat](/de/docs/custom-bot/modules/community/anonymous-chat/#troubleshooting) - Anonyme Nachrichten +* [Geburtstags-Kalender](/de/docs/custom-bot/modules/community/birthday/#troubleshooting) - Verfolgung von Geburtstagen +* [Color me](/de/docs/custom-bot/modules/community/color-me/#troubleshooting) - Benutzerdefinierte Farbrollen +* [Economy](/de/docs/custom-bot/modules/community/economy-system/#troubleshooting) - Virtuelles Economy-System +* [Gewinnspiele](/de/docs/custom-bot/modules/community/giveaways/#troubleshooting) - Gewinnspiele-System +* [Sammel die Codes](/de/docs/custom-bot/modules/community/hunt-the-code/#troubleshooting) - Code-Suche Spiel +* [Level-System](/de/docs/custom-bot/modules/community/levels/#troubleshooting) - XP und Leveling +* [Live-Nachrichten](/de/docs/custom-bot/modules/community/live-messages/#troubleshooting) - Dynamische Statistik-Nachrichten +* [Rollen-Nicknamen](/de/docs/custom-bot/modules/community/nicknames/#troubleshooting) - Rollen-basierte Nicknames +* [Umfragen](/de/docs/custom-bot/modules/community/polls/#troubleshooting) - Umfragen-System +* [Erinnerungen](/de/docs/custom-bot/modules/community/reminders/#troubleshooting) - Erinnerungen-System +* [Serverinformationen](/de/docs/custom-bot/modules/community/serverinfo/#troubleshooting) - Kanal mit Serverinformationen +* [Starboard](/de/docs/custom-bot/modules/community/starboard/#troubleshooting) - Nachrichten Starboard +* [Sticky-Nachrichten](/de/docs/custom-bot/modules/community/sticky-messages/#troubleshooting) - Sticky-Nachrichten +* [Temporäre Channel](/de/docs/custom-bot/modules/community/temp-channels/#troubleshooting) - Temporäre Voice-Channel + +### Spiele & Spaß-Module + +* [Automatisches Reagieren](/de/docs/custom-bot/modules/fun/auto-react/#troubleshooting) - Automatisches Reagieren +* [Zähl-Spiel](/de/docs/custom-bot/modules/fun/counter/#troubleshooting) - Zähl-Spiel +* [Duel](/de/docs/custom-bot/modules/fun/duel/#troubleshooting) - Duell-Spiel +* [Emoji-Quiz](/de/docs/custom-bot/modules/fun/emoji-quiz/#troubleshooting) - Emoji-Quiz +* [Errate die Flagge!](/de/docs/custom-bot/modules/fun/flag-quiz/#troubleshooting) - Flaggen-Quiz +* [Fun-Befehle](/de/docs/custom-bot/modules/fun/#troubleshooting) - Soziale Interaktions-Befehle +* [Errate die Nummer](/de/docs/custom-bot/modules/fun/guess-the-number/#troubleshooting) - Errate die Nummer-Spiel +* [Winterliche Feiertage](/de/docs/custom-bot/modules/fun/holidays/#troubleshooting) - Feiertage Feature +* [Quiz-Modul](/de/docs/custom-bot/modules/fun/quiz/#troubleshooting) - Quiz +* [Schere Stein Papier](/de/docs/custom-bot/modules/fun/rock-paper-scissors/#troubleshooting) - Schere Stein Papier Spiel +* [Tic-Tac-Toe](/de/docs/custom-bot/modules/fun/tic-tak-toe/#troubleshooting) - Tic-Tac-Toe Spiel +* [UNO](/de/docs/custom-bot/modules/fun/uno/#troubleshooting) - UNO Spiel + +### Integrationen-Module + +* [Minecraft Server Status](/de/docs/custom-bot/modules/integrations/minecraft-status/#troubleshooting) - Minecraft Server Status +* [Reddit-Benachrichtigungen](/de/docs/custom-bot/modules/integrations/reddit-notifications/#troubleshooting) - Reddit-Benachrichtigungen +* [RSS-Benachrichtigungen](/de/docs/custom-bot/modules/integrations/rss-notifications/#troubleshooting) - Benachrichtigungen bei RSS-Beiträgen +* [Threads-Benachrichtigungen](/de/docs/custom-bot/modules/integrations/threads-notifications/#troubleshooting) - Benachrichtigungen bei Thread-Beiträgen +* [TikTok-Benachrichtigungen](/de/docs/custom-bot/modules/integrations/tiktok-notifications/#troubleshooting) - TikTok-Video-Benachrichtigungen +* [Twitch-Benachrichtigungen](/de/docs/custom-bot/modules/integrations/twitch-notifications/#troubleshooting) - Twitch-Stream-Benachrichtigungen +* [YouTube-Benachrichtigungen](/de/docs/custom-bot/modules/integrations/youtube-notifications/#troubleshooting) - YouTube-Video/Stream-Benachrichtigungen + +### Moderation-Module + +* [Anti-Ghostping](/de/docs/custom-bot/modules/moderation/anti-ghostping/#troubleshooting) - Ghost-Ping Erkennung +* [Info-Befehle](/de/docs/custom-bot/modules/moderation/info-commands/#troubleshooting) - Info-Befehle +* [Invite-Tracking](/de/docs/custom-bot/modules/moderation/invite-tracking/#troubleshooting) - Invite-Tracking +* [Moderation & Sicherheit](/de/docs/custom-bot/modules/moderation/#troubleshooting) - Umfassendes Moderations-System +* [Ping-Schutz](/de/docs/custom-bot/modules/moderation/ping-protection/#troubleshooting) - Ping-Schutz + +### Support-Module + +* [Bewerbungen](/de/docs/custom-bot/modules/support/applications/#troubleshooting) - Bewerbungs-System +* [Forum Support](/de/docs/custom-bot/modules/support/forum-support/#troubleshooting) - Foren-basierter Support +* [Sprachkanal-Aktionen](/de/docs/custom-bot/modules/support/ping-on-vc-join/#troubleshooting) - Sprachkanal-Beitrittsmeldungen +* [Ticket-System](/de/docs/custom-bot/modules/support/tickets/#troubleshooting) - Ticket-System + +### Werkzeug-Module + +* [AFK-System](/de/docs/custom-bot/modules/tools/afk-system/#troubleshooting) - AFK-Status-System +* [Automatische Nachrichten](/de/docs/custom-bot/modules/tools/auto-messager/#troubleshooting) - Automatisierte Nachrichten +* [Automatische Veröffentlichung](/de/docs/custom-bot/modules/tools/auto-publisher/#troubleshooting) - Automatische Veröffentlichung +* [Automatisches Thread-Erstellen](/de/docs/custom-bot/modules/tools/auto-thread/#troubleshooting) - Automatisches Thread-Erstellen +* [Massrole](/de/docs/custom-bot/modules/tools/massrole/#troubleshooting) - Massen-Rollen-Zuweisung +* [Namenslisten Cleaner](/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/de/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. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/scnx/intro.md b/i18n/de/docusaurus-plugin-content-docs/current/scnx/intro.md index 72c15011..f9fe2bc4 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/scnx/intro.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/scnx/intro.md @@ -41,8 +41,6 @@ Außerdem haben wir noch eine detaillierte Seite mit [häufig gestellten Fragen] Du kannst die [Werkzeuge-Dokumentation](/docs/scnx/account-and-billing/toolbox) öffnen. * SCNX Werbung: Bewerbe deinen Server oder dein Produkt auf SCNX. Du kannst die [Werbung-auf-SCNX-Dokumentation](/docs/scnx/account-and-billing/ads) öffnen. -* SCNX Empfehlungen: Verdiene für jeden Plan, den ein Server, der mit deinem Link hinzugefügt wurde, einen Plan kauft, - eine Kommission. Du kannst die [Empfehlungen-Dokumentation](/docs/scnx/account-and-billing/referrals) öffnen. * SCNX Dateien-Speicher: Hoste Bilder und mehr für deine Discord Server und füge sie direkt in SCNX ein. * SC Network Mitgliedschaften (outdated): *Mehr Informationen werden bald verfügbar sein*. @@ -56,8 +54,7 @@ damit du immer Antworten auf deine Fragen bekommst. anbietet. ::: -* [ScootKit Merch Store](https://scnx.app/de/user/merch): Kaufe dir SCNX-Merch. -* [Featureboard](https://features.sc-network.net): Hier kannst du neue Funktionen für SCNX vorschlagen und über andere +* [Featureboard](https://featureboard.net/): Hier kannst du neue Funktionen für SCNX vorschlagen und über andere Vorschläge abstimmen. * SCNX Marketplace: Ein System für Dritte, um ihre neuen und bereits vorhandenen Produkte in SCNX zu integrieren. * [SCNX-Dokumentation](/): Diese Dokumentation - gebaut, um so viele Funktionen von SCNX so ausführlich wie möglich zu @@ -74,8 +71,6 @@ anbietet. * [SCNX Helper Program](https://scnx.app/de/user/helper-application): Ein Programm, dass es uns erlaubt, involvierte Mitglieder unserer Community mit Hintergrundwissen über SCNX auszuzeichnen und Vorteile als "SCNX Helfer" auf unserem [Discord-Server](https://scootk.it/dc) zu geben. -* [ScootKit Moderator](https://scnx.app/de/user/moderator-application): Ein Programm, dass unseren Community-Mitgliedern - erlaubt, auf unserem [Discord-Server](https://scootk.it/dc) zu moderieren, Veranstaltungen zu organisieren und mehr. * ScootKit RSS-Hub: Ein System, dass Datenverkehr und Benachrichtigungen für Benachrichtigungs-Module auf SCNX sicherstellt -* und mehr… :wink: \ No newline at end of file +* und mehr… :wink: