From db735514d36a1402ce34dc9b98234683c9bda598 Mon Sep 17 00:00:00 2001 From: Melissa <153455693+melissakre97@users.noreply.github.com> Date: Mon, 9 Mar 2026 20:24:38 +0100 Subject: [PATCH 01/15] Create custom-commands.md - German translation added - Links to German pages added - Plan limits adjusted - V3 references removed --- .../current/custom-bot/custom-commands.md | 268 ++++++++++++++++++ 1 file changed, 268 insertions(+) create mode 100644 i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md new file mode 100644 index 00000000..7199d692 --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md @@ -0,0 +1,268 @@ +# Eigene Befehle + +Erstelle deine Eigenen Befehle, Knopf-Interaktionen, Dialog und nachrichtenbasierten Automatisierungen – alles über das SCNX-Dashboard, ganz ohne Programmieren. + + + +## Übersicht {#overview} + +Mit Eigenen Befehlen kannst du deine eigenen Bot-Interaktionen über einen visuellen Prozess-Editor erstellen. Jeder benutzerdefinierte Befehl besteht aus: + +* Einem **Auslöser (Trigger)** — der Auslöser, der den Befehl startet (ein Slash-Befehl, ein Knopf-Klick, eine Nachricht, das Absenden eines Dialogs oder die manuelle Ausführung durch einen anderen Befehl). +* Einem oder mehreren **Aktions-Blöcken** — Gruppen von Aktionen, die ausgeführt werden, sobald der Trigger ausgelöst wird. +* **Aktionen** — die einzelnen Aktionener Bot ausführt (antworten, eine Nachricht senden, Rollen verwalten, einen Dialog anzeigen und mehr). +* Optionale **Befehl-Rechte** — lege fest, welche Rollen ein Nutzer haben muss, um diesen Befehl auslösen zu können. + +## Einrichtung {#setup} + +1. Öffne die [Eigene Befehle Seite](https://scnx.app/de/glink?page=bot/custom-commands) auf deinem SCNX-Dashboard. +2. Stelle sicher, dass dein Bot online ist und läuft. +3. Klicke auf „Neuen Eigenen Befehl erstellen“, um zu beginnen. + +## Trigger {#triggers} + +Jeder benutzerdefinierte Befehl benötigt einen Trigger (Auslöser), der festlegt, wann er ausgeführt wird. Die folgenden Trigger-Typen stehen zur Verfügung: + +### Befehl {#trigger-command} + +Der Befehl wird ausgeführt, sobald ein Nutzer einen Befehl verwendet, zum Beispiel `/mycommand`. + +* **Slash-Befehl** — Der Name, der in Discord angezeigt wird. Muss in Kleinschreibung verfasst sein und darf keine Sonderzeichen enthalten (außer `-`). +* **Beschreibung des Slash-Befehls** — Wird unter dem Befehlsnamen im Discord-Befehlsmenü angezeigt. +* **Slash-Command-Option hinzufügen** — Füge bis zu 25 Parameter hinzu, die Nutzer beim Ausführen des Befehls ausfüllen können. Unterstützte Typen: Text Eingabe, Ganze Zahl, Richtig / Falsch, Benutzer, Kanal, Rolle, Nummer und Anhang. +* Für Text-Optionen kannst du optional `die Werte begrenzen`, indem du eine vordefinierte Liste von bis zu 25 Auswahlmöglichkeiten erstellst. + +:::Warnung +Beachte das Discord-Limit: Insgesamt sind nur 100 Slash-Commands pro Server möglich. Dies umfasst sowohl deine Eigenen Befehle als auch die Befehle aktivierter Module. +Falls diese Grenze überschritten wird, kann die Funktionalität deines Bots beeinträchtigt werden. +::: + +:::Information +Berechtigungen für Slash-Befehle werden in deinen Discord-Servereinstellungen verwaltet (Servereinstellungen → Integrationen → Bots und Apps) und nicht im SCNX-Dashboard. Siehe dir dazu gerne unsere [Berechtigungen & Slash Befehle Dokumentation](/de/docs/custom-bot/slash-commands/) für weitere Informationen an. Es kann bis zu 24 Stunden dauern, bis neue Befehle in Discord angezeigt werden. Stelle sicher, dass der Befehl zuvor aktiviert wurde. +::: + +### Knopf oder Select-Menü-Druck {#trigger-button} + +Der Befehl wird ausgeführt, wenn ein Nutzer auf eine Schaltfläche (Button) klickt oder eine Option aus einem Auswahlmenü (Select Menu) einer Nachricht auswählt. + +Um eine Nachricht mit einem Button oder einem Auswahlmenü zu senden: + +1. Nutze das [Als Bot anmelden](/de/docs/custom-bot/login-as-bot/) Feature, um eine Nachicht zu senden. +2. Erstelle im Nachrichten-Editor einen **Eigenen Befehl Knopf** oder ein **Eigene Befehl Element** und verbinde dieses direkt mit deinem Eigenen Befehl. +3. Du kannst Knöpfe auch an Nachrichten anhängen, die von anderen Eigenen Befehlen oder Modul-Konfigurationen gesendet werden. + +### Nachricht {#trigger-message} + +Der Befehl wird ausgeführt, wenn ein Nutzer eine Nachricht sendet, die einem konfigurierten Muster entspricht. Folgende Vergleichstypen stehen zur Verfügung: + +| Vergleichstyp | Beschreibung | +|---|---| +| **Nachricht beginnt mit Zeichenkette** | Die Nachricht beginnt mit dem konfigurierten Text | +| **Nachricht beinhaltet** | Die Nachricht enthält den konfigurierten Text an einer beliebigen Stelle | +| **Nachricht endet auf** | Die Nachricht endet mit dem konfigurierten Text | +| **Nachricht entspricht** | Die Nachricht entspricht exakt dem konfigurierten Text | +| **Jede gesendete Nachricht** | Wird bei jeder gesendeten Nachricht ausgelöst (mit Vorsicht zu genießen) | + +Weitere Einstellungen: + +* **Groß- und Kleinschreibung ignorieren?** — Wenn aktiviert, wird der Bot Groß- und Kleinschreibung bei Erkennung ignorieren. +* **Nachrichten nur in bestimmten Kanälen erkennen** — Wenn aktiviert, werden Nachichten nur in bestimmten Kanälen erkannt. + +### Dialog {#trigger-modal} + +Der Befehl wird ausgeführt, wenn ein Nutzer einen Dialog (Formular/Modal) absendet. Dialoge werden über die Aktion „Dialog anzeigen“ in einem anderen Eigenen Befehl aufgerufen. + +* Konfiguriere den Titel des Dialogs und die Eingabefelder (Textfelder im Kurzformat oder als Absatz). +* Die Antworten der Nutzer stehen in den Aktionen des Befehls als Parameter zur Verfügung, (z. B. `%answer1%`, `%answer2%`) und so weiter. + + +### Keine (Manuelle Ausführung) {#trigger-none} + +Der Befehl kann ausschließlich von einem anderen Eigenen Befehl über die Aktion **„Befehl ausführen“** ausgeführt werden. Das ist besonders praktisch, um wiederverwendbare Abläufe zu erstellen. + +## Aktion-Block {#action-blocks} + +Aktionen sind in **Aktions-Blöcke** organisiert. Wenn ein Befehl ausgelöst wird, führt er die Aktions-Blöcke in einem von zwei Modi aus: + +* **Alle** — Führt alle Aktionsblöcke nacheinander aus. +* **Einen (zufälligen)** — Führe einen zufällig ausgewählten Aktion-Block aus. Nützlich für Zufallsantworten. + +Jeder Aktion-Block enthält eine oder mehrere Aktionen. Du kannst einem einzelnen Befehl mehrere Aktions-Blöcke hinzufügen. + +## Aktion {#actions} + +Aktionen sind die einzelnen Arbeitsschritte, die dein Bot ausführt. Die folgenden Aktionen stehen zur Verfügung: + +| Aktion | Beschreibung | +|---|---| +| **Auf Nachricht oder Interaktion antworten** | Antworte auf die auslösende Nachricht oder Interaktion. Unterstützt private Antworten (nur für den auführenden Nutzer sichtbar) bei Slash-Befehlen und Knopf-Klicks. | +| **Nachricht in Kanal senden** | Sende eine Nachricht in einem beliebigen Kanal auf dem Server. Die Nachricht kann optional angepinnt werden. | +| **Interaktions-Nachricht editieren** | Bearbeite die Nachricht, an der die Schaltfläche (Knopf) angehängt ist (nur für Knopf-Trigger). | +| **PN an Nutzer senden** | Sende eine Private Nachricht (PN) an den ausführenden oder einen erwähnten Nutzer. Wird lautlos übersprungen, falls der Nutzer PNs deaktiviert hat. | +| **Ausführende Nachricht löschen** | Lösche die Nachricht, die den Befehl ausgelöst hat (nur für Nachrichten-Trigger) | +| **Nickname ändern** | Ändere den Nickname eines Nutzers. Leer lassen, um den Namen zurückzusetzen. | +| **Rollen verwalten** | Rollen bei einem Nutzer hinzufügen, entfernen oder umschalten | +| **Reaktion auf die ausführende Nachricht** | Reagiere mit Emojis auf die Nachricht, die den Befehl ausgelöst hat. | +| **Dialog anzeigen** | Zeige dem Nutzer einen Dialog (Modal) an. Der Dialog muss als separater Eigener Befehl mit einem Dialog-Trigger konfiguriert sein. Pro Interaktion kann nur ein einziger Dialog angezeigt werden. | + +:::Information +Manche Aktionen sind nur für bestimmte Trigger-Typen verfügbar. Beispielsweise funktioniert „Dialog anzeigen“ nur bei interaktionsbasierten Triggern (Slash-Befehlen, Knöpfen). Nicht unterstützte Aktionen werden lautlos übersprungen. +::: + +## Parameter {#parameters} + +Custom Commands unterstützen dynamische Parameter, die beim Ausführen des Befehls durch tatsächliche Werte ersetzt werden. Du kannst Parameter in jedem Textfeld innerhalb deiner Aktionen verwenden. + +### Integrierte Parameter {#built-in-parameters} + +Diese Parameter sind immer verfügbar: + +| Parameter | Beschreibung | +|---|---| +| `%userID%` | ID des Nutzers, der den Befehl ausgelöst hat | +| `%userTag%` | Tag des ausführenden Nutzers | +| `%userUsername%` | Benutzername des ausführenden Nutzers | +| `%userNickname%` | Server-Nickname des ausführenden Nutzers | +| `%userAvatarURL%` | Avatar-URL des ausführenden Nutzers | +| `%userCreatedAt%` | Zeitstempel der Accounterstellung des ausführenden Nutzers | +| `%channelID%` |ID des Kanals, in dem der Befehl ausgeführt wurde. | +| `%content%` | Der Textinhalt der Trigger-Nachricht (funktioniert nur bei Nachricht-Triggern | + +### Optionen-Parameter für Slash-Befehle {#option-parameters} + +Wenn du einen Slash-Befehl-Trigger mit Optionen verwendest, werden je nach Optionstyp zusätzliche Parameter verfügbar: + +* **User-Optionen** — `%userID-optionname%`, `%userTag-optionname%`, `%userName-optionname%`, + `%userAvatarURL-optionname%` +* **Rollen-Optionen** — `%roleName-optionname%`, `%roleColor-optionname%`, `%roleID-optionname%`, + `%rolePosition-optionname%` +* **Channel-Optionen** — `%channelName-optionname%`, `%channelID-optionname%`, `%channelType-optionname%`, + `%channelParentName-optionname%`, `%channelParentID-optionname%` +* **Attachment-Optionen** — `%attachmentURL-optionname%` +* **Text, Nummer, Ganze Zahl oder Richtig / Falsch Optionen** — `%value-optionname%` + +### Dialog-Antworten-Parameter {#modal-parameters} + +Bei Verwendung eines Dialog-Triggers sind die Antworten des Nutzers als `%answer1%`, `%answer-2%` usw. verfügbar, entsprechend der Reihenfolge der Eingabefelder im Dialog. + +### Global Parameters {#global-parameters} + +[Global Parameters](/de/docs/custom-bot/global-parameters/) (wie `%botName%`, `%guildName%`, timestamps) stehen dir darüber hinaus in jedem beliebigen Textfeld deiner Eigenen Befehle zur Verfügung. + +## Befehl-Rechte {#permissions} + +Du kannst einschränken, wer einen Eigenen Befehl verwenden darf, indem du **Rollen verlangen** aktivierst: + +1. Öffne deinen Eigenen Befehl und suche den Abschnitt **„Befehl-Rechte“**. +2. Aktiviere **"Rollen verlangen"**. +3. Füge die Rollen hinzu, die berechtigt sein sollen, den Befehl zu verwenden. +4. Passe optional die **„Fehlende Rolle Nachricht“** an – dies ist die Nachricht, die angezeigt wird, wenn ein Nutzer ohne die erforderlichen Rollen versucht, den Befehl zu verwenden. + +Besitzt ein Anwender keine der erforderlichen Rollen, wird die Ausführung des Befehls blockiert und stattdessen die „Fehlende Rolle Nachricht“ angezeigt. + +## Eigene Befehle verwalten {#managing} + +### Befehle ein- und ausschalten {#enable-disable} + +Jeder Eigene Befehl kann individuell aktiviert oder deaktiviert werden. Ein deaktivierter Befehl reagiert auf keinerlei Trigger. Um einen Befehl zu aktivieren, muss ein gültiger Trigger konfiguriert und alle erforderlichen Felder ausgefüllt sein. + +### Teilen von Eigenen Befehlen {#sharing} + +Du kannst einen Custom Command mit anderen teilen, indem du einen einzigartigen Teilen-Link erstellst: + +1. Öffne den Custom Command, den du teilen möchtest.. +2. Klicke auf **„Teilen-Link erstellen“** . +3. Kopiere die generierte URL. + +Dieser Link speichert den aktuellen Stand deines Befehls. Wenn du den Befehl später bearbeitest, wird die geteilte Version nicht automatisch aktualisiert. + +:::Vorsicht +Geteilte Eigene Befehle können Aktionen enthalten, die schädlich sein könnten. Importiere Befehle nur aus Quellen, denen du vertraust. +::: + +### Eigene Befehle importieren {#importing} + +Um einen geteilten Eigenen Befehl zu importieren: + +1. Öffne den Teilen-Link. +2. Wähle den Server aus, in den der Befehl importiert werden soll. +3. Überprüfe den Befehl und bestätige den Import.. +4. **Wichtig:** Denk daran, Rollenverweise und Kanalverknüpfungen im importierten Befehl manuell anzupassen, damit sie auf deinem Server korrekt funktionieren. +5. Vergiss nicht, deine Änderungen zu speichern.. + +### Eigene Befehle löschen {#deleting} + +Du kannst einzelne Eigene Befehle oder alle Eigenen Befehle gleichzeitig in der Befehlsliste löschen. Das Löschen kann nicht rückgängig gemacht werden. + +## Plan Limits {#plan-limits} + +Die Anzahl der gleichzeitig aktivierbaren Eigenen Befehle hängt von deinem SCNX-Plan ab: + +| Plan | Aktivierbare Eigene Befehle | +|---|---| +| Starter | Bis zu 10 | +| Professional / Unbegrenzt | Unbegrenzt | + +Du kannst jederzeit mehr Befehle erstellen, als dein Limit erlaubt, aber es kann nur die zulässige Anzahl gleichzeitig **aktiviert** sein. Deaktivierte Befehle bleiben gespeichert und können später aktiviert werden, wenn du deinen Plan upgradest oder andere Befehle deaktivierst. + +## Fehlerbehebung {#troubleshooting} + +
+ Mein Slash-Befehl wird in Discord nicht angezeigt + +
+ +
+ Mein Befehl kann nicht aktiviert werden + +
+ +
+ Mein Knopf / Select-Menü-Druck-Befehl funktioniert nicht + +
+ +
+ Parameter werden als Rohtext angezeigt (z. B. %userID%) + +
+ +
+ „Dialog anzeigen“ Aktion funktioniert nicht + +
+ +
+ Rollen verwalten-Aktion funktioniert nicht + +
From 2194696be2403909384cf45d9b3e0f5d6dfff55d Mon Sep 17 00:00:00 2001 From: Melissa <153455693+melissakre97@users.noreply.github.com> Date: Mon, 9 Mar 2026 20:29:42 +0100 Subject: [PATCH 02/15] Update custom-commands.md - forgot to change to 10 commands with the starter plan --- .../current/custom-bot/custom-commands.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md index 7199d692..2beee6e6 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md @@ -3,7 +3,7 @@ Erstelle deine Eigenen Befehle, Knopf-Interaktionen, Dialog und nachrichtenbasierten Automatisierungen – alles über das SCNX-Dashboard, ganz ohne Programmieren. From ee68b4fa2dcab804c86d28e25f5991284025650b Mon Sep 17 00:00:00 2001 From: Melissa <153455693+melissakre97@users.noreply.github.com> Date: Tue, 10 Mar 2026 09:18:58 +0100 Subject: [PATCH 03/15] Update custom-commands.md - Errors corrected --- .../current/custom-bot/custom-commands.md | 32 +++++++++---------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md index 2beee6e6..32092a89 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md @@ -13,7 +13,7 @@ Mit Eigenen Befehlen kannst du deine eigenen Bot-Interaktionen über einen visue * Einem **Auslöser (Trigger)** — der Auslöser, der den Befehl startet (ein Slash-Befehl, ein Knopf-Klick, eine Nachricht, das Absenden eines Dialogs oder die manuelle Ausführung durch einen anderen Befehl). * Einem oder mehreren **Aktions-Blöcken** — Gruppen von Aktionen, die ausgeführt werden, sobald der Trigger ausgelöst wird. -* **Aktionen** — die einzelnen Aktionener Bot ausführt (antworten, eine Nachricht senden, Rollen verwalten, einen Dialog anzeigen und mehr). +* **Aktionen** — die einzelnen Aktionen, die der Bot ausführt (antworten, eine Nachricht senden, Rollen verwalten, einen Dialog anzeigen und mehr). * Optionale **Befehl-Rechte** — lege fest, welche Rollen ein Nutzer haben muss, um diesen Befehl auslösen zu können. ## Einrichtung {#setup} @@ -35,12 +35,12 @@ Der Befehl wird ausgeführt, sobald ein Nutzer einen Befehl verwendet, zum Beisp * **Slash-Command-Option hinzufügen** — Füge bis zu 25 Parameter hinzu, die Nutzer beim Ausführen des Befehls ausfüllen können. Unterstützte Typen: Text Eingabe, Ganze Zahl, Richtig / Falsch, Benutzer, Kanal, Rolle, Nummer und Anhang. * Für Text-Optionen kannst du optional `die Werte begrenzen`, indem du eine vordefinierte Liste von bis zu 25 Auswahlmöglichkeiten erstellst. -:::Warnung +:::warning Beachte das Discord-Limit: Insgesamt sind nur 100 Slash-Commands pro Server möglich. Dies umfasst sowohl deine Eigenen Befehle als auch die Befehle aktivierter Module. Falls diese Grenze überschritten wird, kann die Funktionalität deines Bots beeinträchtigt werden. ::: -:::Information +:::info Berechtigungen für Slash-Befehle werden in deinen Discord-Servereinstellungen verwaltet (Servereinstellungen → Integrationen → Bots und Apps) und nicht im SCNX-Dashboard. Siehe dir dazu gerne unsere [Berechtigungen & Slash Befehle Dokumentation](/de/docs/custom-bot/slash-commands/) für weitere Informationen an. Es kann bis zu 24 Stunden dauern, bis neue Befehle in Discord angezeigt werden. Stelle sicher, dass der Befehl zuvor aktiviert wurde. ::: @@ -69,14 +69,14 @@ Der Befehl wird ausgeführt, wenn ein Nutzer eine Nachricht sendet, die einem ko Weitere Einstellungen: * **Groß- und Kleinschreibung ignorieren?** — Wenn aktiviert, wird der Bot Groß- und Kleinschreibung bei Erkennung ignorieren. -* **Nachrichten nur in bestimmten Kanälen erkennen** — Wenn aktiviert, werden Nachichten nur in bestimmten Kanälen erkannt. +* **Nachrichten nur in bestimmten Kanälen erkennen** — Wenn aktiviert, werden Nachrichten nur in bestimmten Kanälen erkannt. ### Dialog {#trigger-modal} Der Befehl wird ausgeführt, wenn ein Nutzer einen Dialog (Formular/Modal) absendet. Dialoge werden über die Aktion „Dialog anzeigen“ in einem anderen Eigenen Befehl aufgerufen. * Konfiguriere den Titel des Dialogs und die Eingabefelder (Textfelder im Kurzformat oder als Absatz). -* Die Antworten der Nutzer stehen in den Aktionen des Befehls als Parameter zur Verfügung, (z. B. `%answer1%`, `%answer2%`) und so weiter. +* Die Antworten der Nutzer stehen in den Aktionen des Befehls als Parameter zur Verfügung (z. B. `%answer1%`, `%answer2%`) und so weiter. ### Keine (Manuelle Ausführung) {#trigger-none} @@ -108,7 +108,7 @@ Aktionen sind die einzelnen Arbeitsschritte, die dein Bot ausführt. Die folgend | **Reaktion auf die ausführende Nachricht** | Reagiere mit Emojis auf die Nachricht, die den Befehl ausgelöst hat. | | **Dialog anzeigen** | Zeige dem Nutzer einen Dialog (Modal) an. Der Dialog muss als separater Eigener Befehl mit einem Dialog-Trigger konfiguriert sein. Pro Interaktion kann nur ein einziger Dialog angezeigt werden. | -:::Information +:::info Manche Aktionen sind nur für bestimmte Trigger-Typen verfügbar. Beispielsweise funktioniert „Dialog anzeigen“ nur bei interaktionsbasierten Triggern (Slash-Befehlen, Knöpfen). Nicht unterstützte Aktionen werden lautlos übersprungen. ::: @@ -148,9 +148,9 @@ Wenn du einen Slash-Befehl-Trigger mit Optionen verwendest, werden je nach Optio Bei Verwendung eines Dialog-Triggers sind die Antworten des Nutzers als `%answer1%`, `%answer-2%` usw. verfügbar, entsprechend der Reihenfolge der Eingabefelder im Dialog. -### Global Parameters {#global-parameters} +### Globale Parameter {#global-parameters} -[Global Parameters](/de/docs/custom-bot/global-parameters/) (wie `%botName%`, `%guildName%`, timestamps) stehen dir darüber hinaus in jedem beliebigen Textfeld deiner Eigenen Befehle zur Verfügung. +[Globale Parameter](/de/docs/custom-bot/global-parameters/) (wie `%botName%`, `%guildName%`, timestamps) stehen dir darüber hinaus in jedem beliebigen Textfeld deiner Eigenen Befehle zur Verfügung. ## Befehl-Rechte {#permissions} @@ -173,13 +173,13 @@ Jeder Eigene Befehl kann individuell aktiviert oder deaktiviert werden. Ein deak Du kannst einen Custom Command mit anderen teilen, indem du einen einzigartigen Teilen-Link erstellst: -1. Öffne den Custom Command, den du teilen möchtest.. -2. Klicke auf **„Teilen-Link erstellen“** . +1. Öffne den Custom Command, den du teilen möchtest. +2. Klicke auf **„Teilen-Link erstellen“**. 3. Kopiere die generierte URL. Dieser Link speichert den aktuellen Stand deines Befehls. Wenn du den Befehl später bearbeitest, wird die geteilte Version nicht automatisch aktualisiert. -:::Vorsicht +:::caution Geteilte Eigene Befehle können Aktionen enthalten, die schädlich sein könnten. Importiere Befehle nur aus Quellen, denen du vertraust. ::: @@ -189,9 +189,9 @@ Um einen geteilten Eigenen Befehl zu importieren: 1. Öffne den Teilen-Link. 2. Wähle den Server aus, in den der Befehl importiert werden soll. -3. Überprüfe den Befehl und bestätige den Import.. +3. Überprüfe den Befehl und bestätige den Import. 4. **Wichtig:** Denk daran, Rollenverweise und Kanalverknüpfungen im importierten Befehl manuell anzupassen, damit sie auf deinem Server korrekt funktionieren. -5. Vergiss nicht, deine Änderungen zu speichern.. +5. Vergiss nicht, deine Änderungen zu speichern. ### Eigene Befehle löschen {#deleting} @@ -233,7 +233,7 @@ Du kannst jederzeit mehr Befehle erstellen, als dein Limit erlaubt, aber es kann
Mein Knopf / Select-Menü-Druck-Befehl funktioniert nicht
    -
  • Stelle sicher, dass du das Knopf- oder Select-Menü-Druck-Element mithilfe des Nachrichten-Editors an eine Nachricht angehängt und mit dem richtigen Eigenen Befehl verknüpft hast..
    • +
  • Stelle sicher, dass du das Knopf- oder Select-Menü-Druck-Element mithilfe des Nachrichten-Editors an eine Nachricht angehängt und mit dem richtigen Eigenen Befehl verknüpft hast.
  • Stelle sicher, dass der Eigene Befehl aktiviertist.
  • Überprüfe, ob der Bot über die erforderlichen Berechtigungen im Kanal verfügt.
@@ -243,8 +243,8 @@ Du kannst jederzeit mehr Befehle erstellen, als dein Limit erlaubt, aber es kann Parameter werden als Rohtext angezeigt (z. B. %userID%)
  • Stelle sicher, dass du die korrekte Parameter-Syntax mit %, auf beiden Seiten, verwendest.
    • -
  • Überprüfe, ob der Parameter für deinen Trigger-Typ verfügbar ist (z.B., %content% funktioniert nur bei Nachrichten-Triggern.
    • -
  • Überprüfe den Parameternamen auf Tippfehler..
    • +
  • Überprüfe, ob der Parameter für deinen Trigger-Typ verfügbar ist (z.B., %content%) funktioniert nur bei Nachrichten-Triggern.
    • +
  • Überprüfe den Parameternamen auf Tippfehler.
From 2ca6958b81d3124c504164afe329aad241228c6f Mon Sep 17 00:00:00 2001 From: Melissa <153455693+melissakre97@users.noreply.github.com> Date: Tue, 10 Mar 2026 09:28:10 +0100 Subject: [PATCH 04/15] Update custom-commands.md - errors changed --- .../current/custom-bot/custom-commands.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md index 32092a89..dc8bc3ab 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md @@ -50,7 +50,7 @@ Der Befehl wird ausgeführt, wenn ein Nutzer auf eine Schaltfläche (Button) kli Um eine Nachricht mit einem Button oder einem Auswahlmenü zu senden: -1. Nutze das [Als Bot anmelden](/de/docs/custom-bot/login-as-bot/) Feature, um eine Nachicht zu senden. +1. Nutze das [Als Bot anmelden](/de/docs/custom-bot/login-as-bot/) Feature, um eine Nachricht zu senden. 2. Erstelle im Nachrichten-Editor einen **Eigenen Befehl Knopf** oder ein **Eigene Befehl Element** und verbinde dieses direkt mit deinem Eigenen Befehl. 3. Du kannst Knöpfe auch an Nachrichten anhängen, die von anderen Eigenen Befehlen oder Modul-Konfigurationen gesendet werden. @@ -98,7 +98,7 @@ Aktionen sind die einzelnen Arbeitsschritte, die dein Bot ausführt. Die folgend | Aktion | Beschreibung | |---|---| -| **Auf Nachricht oder Interaktion antworten** | Antworte auf die auslösende Nachricht oder Interaktion. Unterstützt private Antworten (nur für den auführenden Nutzer sichtbar) bei Slash-Befehlen und Knopf-Klicks. | +| **Auf Nachricht oder Interaktion antworten** | Antworte auf die auslösende Nachricht oder Interaktion. Unterstützt private Antworten (nur für den ausführenden Nutzer sichtbar) bei Slash-Befehlen und Knopf-Klicks. | | **Nachricht in Kanal senden** | Sende eine Nachricht in einem beliebigen Kanal auf dem Server. Die Nachricht kann optional angepinnt werden. | | **Interaktions-Nachricht editieren** | Bearbeite die Nachricht, an der die Schaltfläche (Knopf) angehängt ist (nur für Knopf-Trigger). | | **PN an Nutzer senden** | Sende eine Private Nachricht (PN) an den ausführenden oder einen erwähnten Nutzer. Wird lautlos übersprungen, falls der Nutzer PNs deaktiviert hat. | @@ -128,8 +128,8 @@ Diese Parameter sind immer verfügbar: | `%userNickname%` | Server-Nickname des ausführenden Nutzers | | `%userAvatarURL%` | Avatar-URL des ausführenden Nutzers | | `%userCreatedAt%` | Zeitstempel der Accounterstellung des ausführenden Nutzers | -| `%channelID%` |ID des Kanals, in dem der Befehl ausgeführt wurde. | -| `%content%` | Der Textinhalt der Trigger-Nachricht (funktioniert nur bei Nachricht-Triggern | +| `%channelID%` | ID des Kanals, in dem der Befehl ausgeführt wurde. | +| `%content%` | Der Textinhalt der Trigger-Nachricht (funktioniert nur bei Nachricht-Triggern) | ### Optionen-Parameter für Slash-Befehle {#option-parameters} @@ -146,7 +146,7 @@ Wenn du einen Slash-Befehl-Trigger mit Optionen verwendest, werden je nach Optio ### Dialog-Antworten-Parameter {#modal-parameters} -Bei Verwendung eines Dialog-Triggers sind die Antworten des Nutzers als `%answer1%`, `%answer-2%` usw. verfügbar, entsprechend der Reihenfolge der Eingabefelder im Dialog. +Bei Verwendung eines Dialog-Triggers sind die Antworten des Nutzers als `%answer1%`, `%answer2%` usw. verfügbar, entsprechend der Reihenfolge der Eingabefelder im Dialog. ### Globale Parameter {#global-parameters} @@ -213,7 +213,7 @@ Du kannst jederzeit mehr Befehle erstellen, als dein Limit erlaubt, aber es kann
Mein Slash-Befehl wird in Discord nicht angezeigt
    -
  • Stelle sicher, dass der Eigene Befehl aktiviertist.
    • +
  • Stelle sicher, dass der Eigene Befehl aktiviert ist.
  • Es kann bis zu 24 Stunden dauern, bis neue Slash-Befehle in Discord angezeigt werden.
  • Überprüfe, ob der Name des Slash-Befehls gültig ist (Kleinschreibung, keine Sonderzeichen außer -).
  • Überprüfe, ob du das Limit von 100 Slash-Befehle pro Server überschritten hast.
    • From 2bb77fef91e48aa40065eb998a41f420387b7f10 Mon Sep 17 00:00:00 2001 From: Melissa <153455693+melissakre97@users.noreply.github.com> Date: Tue, 10 Mar 2026 14:36:33 +0100 Subject: [PATCH 05/15] Update custom-commands.md Errors changed --- .../current/custom-bot/custom-commands.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md index dc8bc3ab..e0e3048a 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md @@ -78,7 +78,6 @@ Der Befehl wird ausgeführt, wenn ein Nutzer einen Dialog (Formular/Modal) absen * Konfiguriere den Titel des Dialogs und die Eingabefelder (Textfelder im Kurzformat oder als Absatz). * Die Antworten der Nutzer stehen in den Aktionen des Befehls als Parameter zur Verfügung (z. B. `%answer1%`, `%answer2%`) und so weiter. - ### Keine (Manuelle Ausführung) {#trigger-none} Der Befehl kann ausschließlich von einem anderen Eigenen Befehl über die Aktion **„Befehl ausführen“** ausgeführt werden. Das ist besonders praktisch, um wiederverwendbare Abläufe zu erstellen. @@ -252,9 +251,9 @@ Du kannst jederzeit mehr Befehle erstellen, als dein Limit erlaubt, aber es kann „Dialog anzeigen“ Aktion funktioniert nicht
    • Dialoge können nur über interaktionsbasierte Trigger (Slash-Befehle, Knöpfe) angezeigt werden. Sie können nicht über Nachrichten-Trigger ausgelöst werden.
      • -
    • Pro Interaktion kann nur ein Dialog angezeigt werden — wenn eine andere Aktion bereits einen Dialog aufgerufen hat, werden Nachfolgende übersprungen.
      • -
    • Ein Dialog kann nicht als Antwort auf das Absenden eines anderen Dialog angezeigt werden (Einschränkung von Discord).
      • -
    • Stelle sicher, dass du einen separaten Eigenen Befehl mit einem Dialog-Trigger erstellt und diesen in der Aktion „Dialog anzeigen“ ausgewählt hast
      • +
    • Pro Interaktion kann nur ein Dialog angezeigt werden — wenn eine andere Aktion bereits einen Dialog aufgerufen hat, werden nachfolgende übersprungen.
      • +
    • Ein Dialog kann nicht als Antwort auf das Absenden eines anderen Dialogs angezeigt werden (Einschränkung von Discord).
      • +
    • Stelle sicher, dass du einen separaten Eigenen Befehl mit einem Dialog-Trigger erstellt und diesen in der Aktion „Dialog anzeigen“ ausgewählt hast.
From 92acd790f9bf5592eb5fc040d2183902299d5e7b Mon Sep 17 00:00:00 2001 From: Melissa <153455693+melissakre97@users.noreply.github.com> Date: Wed, 11 Mar 2026 09:07:34 +0100 Subject: [PATCH 06/15] Create reaction-roles.md - German translation and links added - link to Bot-Log-In added --- .../custom-bot/modules/bot/reaction-roles.md | 46 +++++++++++++++++++ 1 file changed, 46 insertions(+) create mode 100644 i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/bot/reaction-roles.md diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/bot/reaction-roles.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/bot/reaction-roles.md new file mode 100644 index 00000000..e8e11d0b --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/bot/reaction-roles.md @@ -0,0 +1,46 @@ +# Reaction Roles + +Lass Nutzer sich Rollen auf die gute alte Art selbst zuweisen – ganz einfach durch das Hinzufügen und Entfernen einer Reaktion. + + + +## Funktionen {#features} + +* Ermögliche es Nutzern, sich selbst Rollen zuzuweisen, indem sie mit einem bestimmten Emoji auf eine Nachricht reagieren. +* Automatisches Entfernen von Rollen beim Entfernen der Reaktion. +* Unterstützung für die Zuweisung mehrerer Rollen pro Nachricht durch die Verwendung verschiedener Emojis. +* Unterstützung für die Zuweisung mehrerer Rollen mit einer einzigen Reaktion (kommagetrennte Rollen-IDs). +* Unterstützt sowohl Standard- als auch benutzerdefinierte Emojis. + +## Einrichtung {#setup} + +1. [Aktiviere das Modul](https://scnx.app/de/glink?page=bot/modules?query=reaction-roles) auf deinem Server. +2. Sende eine Nachricht auf deinem Server, die du für Reaction Roles nutzen möchtest (oder verwende eine bereits bestehende Nachricht). Kopiere die Nachrichten-ID. +3. Öffne die [Nachrichten-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=reaction-roles%7Cmessages) und erstelle ein neues Konfigurationselement. +4. Gib bei „Nachrichten-ID“ die ID der Nachricht ein, die für die Rollenvergabe genutzt werden soll. +5. Füge im Feld „Reaktionen“ Schlüssel-Wert-Paare hinzu, wobei der Schlüssel das Emoji ist (z. B. das Unicode-Emoji oder die Kennung eines benutzerdefinierten Emojis) und der Wert die Rollen-ID (oder mehrere, durch Kommas getrennte Rollen-IDs). +6. 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. +7. Der Bot benötigt außerdem die Berechtigungen **Kanal anzeigen** und **Nachrichtenverlauf anzeigen** in dem Kanal, in dem sich die Nachricht befindet. +8. Lasse zuerst einen Nutzer mit dem konfigurierten Emoji reagieren – der Bot wird daraufhin seine eigene Reaktion hinzufügen, um zu signalisieren, dass er aktiv ist. + +## Nutzung {#usage} + +* Nutzer reagieren einfach mit dem festgelegten Emoji auf die konfigurierte Nachricht, um die zugehörige(n) Rolle(n) zu erhalten. +* Wenn ein Nutzer seine Reaktion entfernt, werden die zugehörigen Rollen automatisch wieder entzogen. +* Der Bot fügt der Nachricht seine eigene Reaktion hinzu, sobald der erste Nutzer reagiert. Dies dient als visueller Indikator. + +## Konfiguration {#configuration} + +Dies ist die Konfigurationsdatei für das Modul. Öffne sie in deinem [Dashboard](https://scnx.app/de/glink?page=bot/configuration?file=reaction-roles%7Cmessages). + +| Feld | Beschreibung | +|-------|-------------| +| Nachrichten-ID | Die ID der Nachricht, die für die Rollenvergabe genutzt werden soll. | +| Reaktionen | Schlüssel-Wert-Paare, wobei der Schlüssel das Emoji ist (z. B. das Unicode-Emoji oder die Kennung eines benutzerdefinierten Emojis) und der Wert die Rollen-ID (oder mehrere, durch Kommas getrennte Rollen-IDs). | + +## Fehlerbehebung {#troubleshooting} + +* **Der Bot reagiert nicht auf Reaktionen**: Stelle sicher, dass der Bot im Kanal über die Berechtigungen „Kanal anzeigen“ und „Nachrichtenverlauf anzeigen“ verfügt. Überprüfe außerdem, ob die Nachrichten-ID in der Konfiguration mit der Nachricht übereinstimmt, auf die du reagierst. +* **Rollen werden nicht zugewiesen**: Stelle sicher, dass der Bot über die Berechtigung „Rollen verwalten“ verfügt und dass die höchste Rolle des Bots oberhalb der Rollen positioniert ist, die er zuweisen soll. Überprüfe zudem, ob die Rollen-IDs in der Konfiguration korrekt sind. +* **Benutzerdefinierte Emojis funktionieren nicht**: Stelle sicher, dass die Emoji-Kennung in der Konfiguration exakt dem Format entspricht, das Discord intern verwendet. Bei benutzerdefinierten Emojis ist dies normalerweise der Name und die ID im Format `Name:ID`. +* **Ziehe in Erwägung, stattdessen einen Selbst-Rollen-Knopf zu verwenden.**: Für eine bessere Benutzererfahrung solltest du die Verwendung von Selbst-Rollen-Knöpfen und Rollen-Elementen in Betracht ziehen. Diese sind über das [Als Bot anmelden](/de/docs/custom-bot/login-as-bot/) Feauture auf SCNX verfügbar und bieten eine modernere Benutzeroberfläche. From 8c1b6c877071829847baff1ede65061dd2646775 Mon Sep 17 00:00:00 2001 From: Melissa <153455693+melissakre97@users.noreply.github.com> Date: Wed, 11 Mar 2026 09:18:24 +0100 Subject: [PATCH 07/15] Update reaction-roles.md Link now really linking to the site --- .../current/custom-bot/modules/bot/reaction-roles.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/bot/reaction-roles.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/bot/reaction-roles.md index e8e11d0b..1bebf6e2 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/bot/reaction-roles.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/bot/reaction-roles.md @@ -43,4 +43,4 @@ Dies ist die Konfigurationsdatei für das Modul. Öffne sie in deinem [Dashboard * **Der Bot reagiert nicht auf Reaktionen**: Stelle sicher, dass der Bot im Kanal über die Berechtigungen „Kanal anzeigen“ und „Nachrichtenverlauf anzeigen“ verfügt. Überprüfe außerdem, ob die Nachrichten-ID in der Konfiguration mit der Nachricht übereinstimmt, auf die du reagierst. * **Rollen werden nicht zugewiesen**: Stelle sicher, dass der Bot über die Berechtigung „Rollen verwalten“ verfügt und dass die höchste Rolle des Bots oberhalb der Rollen positioniert ist, die er zuweisen soll. Überprüfe zudem, ob die Rollen-IDs in der Konfiguration korrekt sind. * **Benutzerdefinierte Emojis funktionieren nicht**: Stelle sicher, dass die Emoji-Kennung in der Konfiguration exakt dem Format entspricht, das Discord intern verwendet. Bei benutzerdefinierten Emojis ist dies normalerweise der Name und die ID im Format `Name:ID`. -* **Ziehe in Erwägung, stattdessen einen Selbst-Rollen-Knopf zu verwenden.**: Für eine bessere Benutzererfahrung solltest du die Verwendung von Selbst-Rollen-Knöpfen und Rollen-Elementen in Betracht ziehen. Diese sind über das [Als Bot anmelden](/de/docs/custom-bot/login-as-bot/) Feauture auf SCNX verfügbar und bieten eine modernere Benutzeroberfläche. +* **Ziehe in Erwägung, stattdessen einen Selbst-Rollen-Knopf zu verwenden.**: Für eine bessere Benutzererfahrung solltest du die Verwendung von Selbst-Rollen-Knöpfen und Rollen-Elementen in Betracht ziehen. Diese sind über das [Als Bot anmelden](/docs/custom-bot/login-as-bot/) Feauture auf SCNX verfügbar und bieten eine modernere Benutzeroberfläche. From 4ef425703eb8dc1ca647209e4368505acf33e10a Mon Sep 17 00:00:00 2001 From: Melissa <153455693+melissakre97@users.noreply.github.com> Date: Wed, 11 Mar 2026 12:16:57 +0100 Subject: [PATCH 08/15] Create activity-streak.md German translation and links added --- .../modules/community/activity-streak.md | 100 ++++++++++++++++++ 1 file changed, 100 insertions(+) create mode 100644 i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/activity-streak.md diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/activity-streak.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/activity-streak.md new file mode 100644 index 00000000..b38d3169 --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/activity-streak.md @@ -0,0 +1,100 @@ +# Aktivitäts-Streaks + +Belohne Nutzer für ihre tägliche, wöchentliche oder monatliche Aktivität mit einem Aktivitäts-Score, der automatisch zurückgesetzt wird, wenn sie wieder inaktiv werden. + + + +## Funktionen {#features} + +* Verfolge die Aktivitäts-Streaks von Nutzern basierend auf einem konfigurierbaren Zeitraum (täglich, wöchentlich oder monatlich). +* Streaks werden auf Null zurückgesetzt, wenn ein Nutzer für einen gesamten Zeitraum inaktiv bleibt. +* Weise automatisch Rollen als Belohnung zu, wenn Nutzer bestimmte Streak-Meilensteine erreichen. +* Zeige die aktuelle Streak-Anzahl optional im Nicknamen eines Nutzers an. +* Der „Mitarbeiter-verwaltete Streaks?“-Modus ermöglicht es Moderatoren, Streaks manuell hinzuzufügen und zurückzusetzen, anstatt des automatischen Trackings. +* Nutzer können einen verlorenen Streak einmal pro Verlust wiederherstellen (sofern aktiviert). +* Der längste Streak wird separat erfasst und niemals zurückgesetzt. + +## Einrichtung {#setup} + +1. [Aktiviere das Modul](https://scnx.app/de/glink?page=bot/modules?query=activity-streak) auf deinem Server. +2. Öffne die [Konfiguration](#configuration) und wähle den gewünschten Streak-Zeitraum aus (täglich, wöchentlich oder monatlich). +3. Wenn du Streak-Belohnungsrollen nutzen möchtest, erstelle die Rollen auf deinem Server und konfiguriere sie im Feld „Streak-Belohnungsrollen“. +4. Wenn die Streak-Anzahl auch im Nicknamen erscheinen soll, aktiviere die Option „Streak im Nicknamen anzeigen?“. Stelle sicher, dass der Bot über die Berechtigung `Nicknames verwalten` verfügt. +5. Wenn du den „Mitarbeiter-verwaltete Streaks?“-Modus anstelle der automatischen Verfolgung nutzen möchtest, aktiviere diesen und konfiguriere die entsprechenden Team-Rollen. + +## Nutzung {#usage} + +* Im automatischen Modus verfolgt der Bot die Nutzeraktivität basierend auf gesendeten Nachrichten. Wenn ein Nutzer während eines neuen Zeitraums eine Nachricht sendet, wird sein Streak erhöht. Verpasst er einen gesamten Zeitraum, wird sein Streak automatisch auf Null zurückgesetzt. +* Im „Mitarbeiter-verwaltete Streaks?“-Modus verwenden Teammitglieder den Befehl [`/streak add`](#commands), um Nutzern manuell Streak-Punkte hinzuzufügen. +* Nutzer können ihren aktuellen und ihren längsten Streak einsehen, indem sie den Befehl [`/streak view`](#commands) nutzen. +* Falls die Streak-Wiederherstellung aktiviert ist, können Nutzer, die ihren Streak verloren haben, diesen einmalig über [`/streak restore`](#commands) wiederherstellen. +* Wenn ein Nutzer eine Streak-Anzahl erreicht, die einer konfigurierten Rollenbelohnung entspricht, wird die Rolle automatisch zugewiesen. + +## Befehle {#commands} + + + +| Befehl | Beschreibung | +|---------|-------------| +| `/streak view [user:]` | Sieh dir deinen eigenen aktuellen oder längsten Streak oder den eines anderen Nutzers an. | +| `/streak add user:` | Füge einem Nutzer manuell einen Streak-Punkt hinzu. Nur im „Mitarbeiter-verwaltete Streaks?“-Modus verfügbar. Erfordert eine konfigurierte Team-Rolle. | +| `/streak reset user:` | Setze den Streak eines Nutzers auf Null zurück. Nur im „Mitarbeiter-verwaltete Streaks?“-Modus verfügbar. Erfordert eine konfigurierte Team-Rolle. | +| `/streak restore [user:]` | Stelle einen zuvor verlorenen Streak wieder her. Nur verfügbar, wenn die Streak-Wiederherstellung aktiviert ist. Kann nur einmal pro Streak-Verlust verwendet werden. | + +## Konfiguration {#configuration} + +In dieser Konfigurationsdatei kannst du das Modul einrichten. Öffne sie in deinem [Dashboard](https://scnx.app/de/glink?page=bot/configuration?file=activity-streak%7Cconfigs/config). + +| Feld | Beschreibung | +|-------|-------------| +| Streak-Zeitraum | Wie oft Nutzer aktiv sein müssen, um ihren Streak aufrechtzuerhalten: täglich, wöchentlich oder monatlich. | +| Mitarbeiter-verwaltete Streaks? | Falls aktiviert, werden Streaks manuell vom Team verwaltet, anstatt automatisch über Nachrichten erfasst zu werden. | +| Mitarbeiter-Rollen (für mitarbeiter-verwalteten Modus) | Rollen, die berechtigt sind, Streaks über die Befehle „add“ und „reset“ zu verwalten. Dies gilt nur, wenn der „Von Mitarbeiter-verwaltete Streaks?“-Modus aktiviert ist. | +| Streak im Nicknamen anzeigen? | Falls aktiviert, hängt der Bot die aktuelle Streak-Anzahl des Nutzers an dessen Nicknamen an. | +| Streak-Belohnungsrollen | Rollenbelohnungen für das Erreichen bestimmter Streak-Meilensteine. Die „Ganze Zahl“ ist die Streak-Anzahl und „Rolle wählen“ ist die zuzuweisende Rolle. | +| Streak-Anzeigungs-Nachricht | Passe das Embed an, das beim Aufrufen eines Streaks angezeigt wird. | +| Ignorierte Kanäle | Kanäle, in denen Nachrichten nicht für Streaks gezählt werden. | +| Ignorierte Rollen | Rollen, deren Mitglieder-Nachrichten nicht für Streaks zählen. | +| Streak-Wiederherstellung aktivieren? | Falls aktiviert, können Nutzer einen verlorenen Streak einmal pro Verlust wiederherstellen. | +| Rollen, die Streaks wiederherstellen dürfen | Rollen, die berechtigt sind, den Befehl „restore“ zu nutzen. Falls das Feld leer bleibt, können alle Nutzer Streaks wiederherstellen. | + +## Fehlerbehebung {#troubleshooting} + +
+ Streaks werden nicht erfasst +
    +
  • Stelle sicher, dass der „Mitarbeiter-verwaltete Streaks“-Modus deaktiviert ist, wenn du das automatische Tracking nutzen möchtest.
    • +
  • Überprüfe, ob der Nutzer in einem ignorierten Kanal postet oder eine ignorierte Rolle besitzt.
    • +
  • Streak-Updates werden einmal pro Zeitraum geprüft – ein Nutzer muss nur eine Nachricht pro Zeitraum senden.
    • +
+
+ +
+ Der Nickname wird nicht mit dem Streak-Zähler aktualisiert +
    +
  • Stelle sicher, dass „Streak im Nicknamen anzeigen?“ in der Konfiguration aktiviert ist.
    • +
  • Stelle sicher, dass der Bot über die Berechtigung Nicknames verwalten verfügt.
    • +
  • Aufgrund von Discord-Einschränkungen kann der Bot den Nicknamen des Server-Besitzers nicht ändern.
    • +
+
+ +
+ Streak-Belohnungsrollen werden nicht zugewiesen +
    +
  • Überprüfe, ob die Streak-Rollenbelohnungen korrekt mit der richtigen Streak-Anzahl und Rolle konfiguriert sind.
    • +
  • Stelle sicher, dass der Bot über die Berechtigung Rollen verwalten verfügt und seine eigene Rolle oberhalb der Belohnungsrollen platziert ist.
    • +
+
+ +## Gespeicherte Daten {#data-usage} + +Die folgenden Daten werden über jeden Nutzer mit einem aktiven oder vergangenen Streak gespeichert: + +* Die Discord-User-ID +* Die aktuelle Streak-Anzahl und die höchste erreichte Streak-Anzahl +* Datum, Woche oder Monat der letzten Aktivität (abhängig vom konfigurierten Zeitraum) +* Die vorherige Streak-Anzahl (für Wiederherstellungszwecke) +* Der Zeitstempel der letzten Wiederherstellung +* Metadaten über den Eintrag (Erstellungsdatum und Zeitpunkt der letzten Aktualisierung) + +Um alle von diesem Modul gespeicherten Daten zu löschen, [setze die Modul-Datenbank zurück](/docs/custom-bot/additional-features/#reset-module-database). From 56023aec6793f19247716a1144740b1a68e86882 Mon Sep 17 00:00:00 2001 From: Melissa <153455693+melissakre97@users.noreply.github.com> Date: Wed, 11 Mar 2026 19:27:25 +0100 Subject: [PATCH 09/15] Update activity-streak.md li-problem solved --- .../current/custom-bot/modules/community/activity-streak.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/activity-streak.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/activity-streak.md index b38d3169..5eba7c04 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/activity-streak.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/activity-streak.md @@ -63,7 +63,7 @@ In dieser Konfigurationsdatei kannst du das Modul einrichten. Öffne sie in dein
Streaks werden nicht erfasst
    -
  • Stelle sicher, dass der „Mitarbeiter-verwaltete Streaks“-Modus deaktiviert ist, wenn du das automatische Tracking nutzen möchtest.
    • +
  • Stelle sicher, dass der „Mitarbeiter-verwaltete Streaks“-Modus deaktiviert ist, wenn du das automatische Tracking nutzen möchtest.
  • Überprüfe, ob der Nutzer in einem ignorierten Kanal postet oder eine ignorierte Rolle besitzt.
  • Streak-Updates werden einmal pro Zeitraum geprüft – ein Nutzer muss nur eine Nachricht pro Zeitraum senden.
From 998c6cb0237269ba6251292f077514c4c4d0531a Mon Sep 17 00:00:00 2001 From: Melissa <153455693+melissakre97@users.noreply.github.com> Date: Fri, 13 Mar 2026 13:03:27 +0100 Subject: [PATCH 10/15] Update reaction-roles.md Spelling corrected --- .../current/custom-bot/modules/bot/reaction-roles.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/bot/reaction-roles.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/bot/reaction-roles.md index 1bebf6e2..4cd01d55 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/bot/reaction-roles.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/bot/reaction-roles.md @@ -43,4 +43,4 @@ Dies ist die Konfigurationsdatei für das Modul. Öffne sie in deinem [Dashboard * **Der Bot reagiert nicht auf Reaktionen**: Stelle sicher, dass der Bot im Kanal über die Berechtigungen „Kanal anzeigen“ und „Nachrichtenverlauf anzeigen“ verfügt. Überprüfe außerdem, ob die Nachrichten-ID in der Konfiguration mit der Nachricht übereinstimmt, auf die du reagierst. * **Rollen werden nicht zugewiesen**: Stelle sicher, dass der Bot über die Berechtigung „Rollen verwalten“ verfügt und dass die höchste Rolle des Bots oberhalb der Rollen positioniert ist, die er zuweisen soll. Überprüfe zudem, ob die Rollen-IDs in der Konfiguration korrekt sind. * **Benutzerdefinierte Emojis funktionieren nicht**: Stelle sicher, dass die Emoji-Kennung in der Konfiguration exakt dem Format entspricht, das Discord intern verwendet. Bei benutzerdefinierten Emojis ist dies normalerweise der Name und die ID im Format `Name:ID`. -* **Ziehe in Erwägung, stattdessen einen Selbst-Rollen-Knopf zu verwenden.**: Für eine bessere Benutzererfahrung solltest du die Verwendung von Selbst-Rollen-Knöpfen und Rollen-Elementen in Betracht ziehen. Diese sind über das [Als Bot anmelden](/docs/custom-bot/login-as-bot/) Feauture auf SCNX verfügbar und bieten eine modernere Benutzeroberfläche. +* **Ziehe in Erwägung, stattdessen einen Selbst-Rollen-Knopf zu verwenden.**: Für eine bessere Benutzererfahrung solltest du die Verwendung von Selbst-Rollen-Knöpfen und Rollen-Elementen in Betracht ziehen. Diese sind über das [Als Bot anmelden](/docs/custom-bot/login-as-bot/) Feature auf SCNX verfügbar und bieten eine modernere Benutzeroberfläche. From 24c550b2ac76dfa670bc79debb8118a13a810448 Mon Sep 17 00:00:00 2001 From: Melissa <153455693+melissakre97@users.noreply.github.com> Date: Fri, 13 Mar 2026 13:11:06 +0100 Subject: [PATCH 11/15] Update custom-commands.md Spelling corrected --- .../current/custom-bot/custom-commands.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md index e0e3048a..717c7d44 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md @@ -1,6 +1,6 @@ # Eigene Befehle -Erstelle deine Eigenen Befehle, Knopf-Interaktionen, Dialog und nachrichtenbasierten Automatisierungen – alles über das SCNX-Dashboard, ganz ohne Programmieren. +Erstelle deine Eigenen Befehle, Knopf-Interaktionen, Dialoge und nachrichtenbasierte Automatisierungen – alles über das SCNX-Dashboard, ganz ohne Programmieren. Mein Knopf / Select-Menü-Druck-Befehl funktioniert nicht
  • Stelle sicher, dass du das Knopf- oder Select-Menü-Druck-Element mithilfe des Nachrichten-Editors an eine Nachricht angehängt und mit dem richtigen Eigenen Befehl verknüpft hast.
    • -
  • Stelle sicher, dass der Eigene Befehl aktiviertist.
    • +
  • Stelle sicher, dass der Eigene Befehl aktiviert ist.
  • Überprüfe, ob der Bot über die erforderlichen Berechtigungen im Kanal verfügt.
From 665f58c618ad4a45520e549a40645285549aa0ec Mon Sep 17 00:00:00 2001 From: Melissa <153455693+melissakre97@users.noreply.github.com> Date: Fri, 13 Mar 2026 13:21:50 +0100 Subject: [PATCH 12/15] Update activity-streak.md Link changed and spelling corrected --- .../current/custom-bot/modules/community/activity-streak.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/activity-streak.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/activity-streak.md index 5eba7c04..b233a078 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/activity-streak.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/activity-streak.md @@ -49,7 +49,7 @@ In dieser Konfigurationsdatei kannst du das Modul einrichten. Öffne sie in dein |-------|-------------| | Streak-Zeitraum | Wie oft Nutzer aktiv sein müssen, um ihren Streak aufrechtzuerhalten: täglich, wöchentlich oder monatlich. | | Mitarbeiter-verwaltete Streaks? | Falls aktiviert, werden Streaks manuell vom Team verwaltet, anstatt automatisch über Nachrichten erfasst zu werden. | -| Mitarbeiter-Rollen (für mitarbeiter-verwalteten Modus) | Rollen, die berechtigt sind, Streaks über die Befehle „add“ und „reset“ zu verwalten. Dies gilt nur, wenn der „Von Mitarbeiter-verwaltete Streaks?“-Modus aktiviert ist. | +| Mitarbeiter-Rollen (für mitarbeiter-verwalteten Modus) | Rollen, die berechtigt sind, Streaks über die Befehle „add“ und „reset“ zu verwalten. Dies gilt nur, wenn der „Mitarbeiter-verwaltete Streaks?“-Modus aktiviert ist. | | Streak im Nicknamen anzeigen? | Falls aktiviert, hängt der Bot die aktuelle Streak-Anzahl des Nutzers an dessen Nicknamen an. | | Streak-Belohnungsrollen | Rollenbelohnungen für das Erreichen bestimmter Streak-Meilensteine. Die „Ganze Zahl“ ist die Streak-Anzahl und „Rolle wählen“ ist die zuzuweisende Rolle. | | Streak-Anzeigungs-Nachricht | Passe das Embed an, das beim Aufrufen eines Streaks angezeigt wird. | @@ -97,4 +97,4 @@ Die folgenden Daten werden über jeden Nutzer mit einem aktiven oder vergangenen * Der Zeitstempel der letzten Wiederherstellung * Metadaten über den Eintrag (Erstellungsdatum und Zeitpunkt der letzten Aktualisierung) -Um alle von diesem Modul gespeicherten Daten zu löschen, [setze die Modul-Datenbank zurück](/docs/custom-bot/additional-features/#reset-module-database). +Um alle von diesem Modul gespeicherten Daten zu löschen, [setze die Modul-Datenbank zurück](de/docs/custom-bot/additional-features/#reset-module-database). From 5965b804abff13481cd62ef1bfc5a9c955fcc23b Mon Sep 17 00:00:00 2001 From: Melissa <153455693+melissakre97@users.noreply.github.com> Date: Fri, 13 Mar 2026 14:11:58 +0100 Subject: [PATCH 13/15] Update activity-streak.md Link changed --- .../current/custom-bot/modules/community/activity-streak.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/activity-streak.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/activity-streak.md index b233a078..5279d307 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/activity-streak.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/activity-streak.md @@ -97,4 +97,4 @@ Die folgenden Daten werden über jeden Nutzer mit einem aktiven oder vergangenen * Der Zeitstempel der letzten Wiederherstellung * Metadaten über den Eintrag (Erstellungsdatum und Zeitpunkt der letzten Aktualisierung) -Um alle von diesem Modul gespeicherten Daten zu löschen, [setze die Modul-Datenbank zurück](de/docs/custom-bot/additional-features/#reset-module-database). +Um alle von diesem Modul gespeicherten Daten zu löschen, [setze die Modul-Datenbank zurück](/de/docs/custom-bot/additional-features/#reset-module-database). From 2361d16b33321cd74c0200ffebb9ca2b349fa047 Mon Sep 17 00:00:00 2001 From: Melissa <153455693+melissakre97@users.noreply.github.com> Date: Sun, 15 Mar 2026 07:50:03 +0100 Subject: [PATCH 14/15] Update custom-commands.md Added changes from the English docs --- .../current/custom-bot/custom-commands.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md index 717c7d44..d9160a49 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md @@ -44,6 +44,10 @@ Falls diese Grenze überschritten wird, kann die Funktionalität deines Bots bee Berechtigungen für Slash-Befehle werden in deinen Discord-Servereinstellungen verwaltet (Servereinstellungen → Integrationen → Bots und Apps) und nicht im SCNX-Dashboard. Siehe dir dazu gerne unsere [Berechtigungen & Slash Befehle Dokumentation](/de/docs/custom-bot/slash-commands/) für weitere Informationen an. Es kann bis zu 24 Stunden dauern, bis neue Befehle in Discord angezeigt werden. Stelle sicher, dass der Befehl zuvor aktiviert wurde. ::: +:::tip +Benutzerdefinierte Slash-Befehle werden automatisch als eigene Gruppe „Eigene Befehle“ im `/help`-Befehl angezeigt, sodass sie für deine Servermitglieder leichter zu finden sind. +::: + ### Knopf oder Select-Menü-Druck {#trigger-button} Der Befehl wird ausgeführt, wenn ein Nutzer auf eine Schaltfläche (Button) klickt oder eine Option aus einem Auswahlmenü (Select Menu) einer Nachricht auswählt. From cf85c1ca74dbb2a1ef750c9a41ce7a64aa4e4b91 Mon Sep 17 00:00:00 2001 From: Melissa <153455693+melissakre97@users.noreply.github.com> Date: Sun, 15 Mar 2026 08:07:36 +0100 Subject: [PATCH 15/15] Update activity-streak.md Added changes from the English docs --- .../custom-bot/modules/community/activity-streak.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/activity-streak.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/activity-streak.md index 5279d307..27cd8f69 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/activity-streak.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/activity-streak.md @@ -13,6 +13,8 @@ Belohne Nutzer für ihre tägliche, wöchentliche oder monatliche Aktivität mit * Der „Mitarbeiter-verwaltete Streaks?“-Modus ermöglicht es Moderatoren, Streaks manuell hinzuzufügen und zurückzusetzen, anstatt des automatischen Trackings. * Nutzer können einen verlorenen Streak einmal pro Verlust wiederherstellen (sofern aktiviert). * Der längste Streak wird separat erfasst und niemals zurückgesetzt. +* Bestenliste zeigt die 20 aktivsten Streaks auf deinem Server. +* Nutzer können deaktivieren, dass ihr Streak in ihrem Nickname angezeigt wird. ## Einrichtung {#setup} @@ -38,8 +40,12 @@ Belohne Nutzer für ihre tägliche, wöchentliche oder monatliche Aktivität mit |---------|-------------| | `/streak view [user:]` | Sieh dir deinen eigenen aktuellen oder längsten Streak oder den eines anderen Nutzers an. | | `/streak add user:` | Füge einem Nutzer manuell einen Streak-Punkt hinzu. Nur im „Mitarbeiter-verwaltete Streaks?“-Modus verfügbar. Erfordert eine konfigurierte Team-Rolle. | -| `/streak reset user:` | Setze den Streak eines Nutzers auf Null zurück. Nur im „Mitarbeiter-verwaltete Streaks?“-Modus verfügbar. Erfordert eine konfigurierte Team-Rolle. | +| `/streak remove user:` | Zieht einen Punkt vom Streak-Zähler eines Nutzers ab. Hilfreich, um Fehler zu korrigieren, ohne den Streak vollständig zurückzusetzen. Nur im „Mitarbeiter-verwaltete Streaks?“-Modus verfügbar. Erfordert eine konfigurierte Team-Rolle. | +| `/streak reset user:` | Setzt den Streak eines Nutzers vollständig zurück. Dabei werden sowohl der aktuelle Streak als auch alle gespeicherten Backups gelöscht und sämtliche streakbezogenen Rollen entfernt. Nur im „Mitarbeiter-verwaltete Streaks?“-Modus verfügbar. Erfordert eine konfigurierte Team-Rolle. | | `/streak restore [user:]` | Stelle einen zuvor verlorenen Streak wieder her. Nur verfügbar, wenn die Streak-Wiederherstellung aktiviert ist. Kann nur einmal pro Streak-Verlust verwendet werden. | +| `/streak leaderboard` | Zeigt die 20 aktivsten Streaks auf dem Server an. Verfügbar sowohl im „Mitarbeiter-verwaltete Streaks?“- als auch im automatischen Modus. | +| `/streak hide` | Schaltet die Anzeige deines Streaks in deinem Nickname an oder aus. Nur verfügbar, wenn die Nickname-Anzeige aktiviert ist und die Option „Nutzern erlauben, den Streak im Nickname auszublenden?“ eingeschaltet wurde. | + ## Konfiguration {#configuration} @@ -51,6 +57,7 @@ In dieser Konfigurationsdatei kannst du das Modul einrichten. Öffne sie in dein | Mitarbeiter-verwaltete Streaks? | Falls aktiviert, werden Streaks manuell vom Team verwaltet, anstatt automatisch über Nachrichten erfasst zu werden. | | Mitarbeiter-Rollen (für mitarbeiter-verwalteten Modus) | Rollen, die berechtigt sind, Streaks über die Befehle „add“ und „reset“ zu verwalten. Dies gilt nur, wenn der „Mitarbeiter-verwaltete Streaks?“-Modus aktiviert ist. | | Streak im Nicknamen anzeigen? | Falls aktiviert, hängt der Bot die aktuelle Streak-Anzahl des Nutzers an dessen Nicknamen an. | +| Nutzern erlauben, den Streak im Nickname auszublenden? | Falls aktiviert, können Nutzer `/streak hide` verwenden, um die Anzeige ihres Streaks in ihrem Nickname an- oder auszuschalten. Nur verfügbar, wenn „Streak im Nickname anzeigen?“ aktiviert ist. | | Streak-Belohnungsrollen | Rollenbelohnungen für das Erreichen bestimmter Streak-Meilensteine. Die „Ganze Zahl“ ist die Streak-Anzahl und „Rolle wählen“ ist die zuzuweisende Rolle. | | Streak-Anzeigungs-Nachricht | Passe das Embed an, das beim Aufrufen eines Streaks angezeigt wird. | | Ignorierte Kanäle | Kanäle, in denen Nachrichten nicht für Streaks gezählt werden. |