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..d9160a49 --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/custom-commands.md @@ -0,0 +1,271 @@ +# Eigene Befehle + +Erstelle deine Eigenen Befehle, Knopf-Interaktionen, Dialoge und nachrichtenbasierte 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 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} + +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. + +:::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. +::: + +:::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. +::: + +:::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. + +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 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. + +### 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 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. + +### 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 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. | +| **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. | + +:::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. +::: + +## 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%`, `%answer2%` usw. verfügbar, entsprechend der Reihenfolge der Eingabefelder im Dialog. + +### Globale Parameter {#global-parameters} + +[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} + +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. + +:::caution +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 + +
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..4cd01d55 --- /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](/docs/custom-bot/login-as-bot/) Feature auf SCNX verfügbar und bieten eine modernere Benutzeroberfläche. 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..27cd8f69 --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/community/activity-streak.md @@ -0,0 +1,107 @@ +# 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. +* Bestenliste zeigt die 20 aktivsten Streaks auf deinem Server. +* Nutzer können deaktivieren, dass ihr Streak in ihrem Nickname angezeigt wird. + +## 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 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} + +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 „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. | +| 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](/de/docs/custom-bot/additional-features/#reset-module-database).