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.

Aktivitäts-Streaks

ScootKit

Belohne Nutzer für tägliche, wöchentliche oder monatliche Aktivität mit einem Aktivitätswert, der zurückgesetzt wird, wenn sie wieder inaktiv werden.

Dieses Modul ist aktuell nur für Nutzer mit Early-Access verfügbar.

Dieses Modul speichert Daten in der Datenbank deines Bots.

Dieses Modul erstellt einen Haupt-Slash-Befehl auf deinem Server.

Dieses Modul eine verfügbare Konfigurationsdatei.

Dieses Modul wird auf über 100 Servern auf SCNX aktiv verwendet.

Dieses Modul ist bei jedem Plan kostenlos dabei. Mehr über Preise erfahren.

Modul auf SCNX aktivieren

Funktionen

• 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

1. Aktiviere das Modul auf deinem Server.
2. Öffne die Konfiguration 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

• 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, um Nutzern manuell Streak-Punkte hinzuzufügen.
• Nutzer können ihren aktuellen und ihren längsten Streak einsehen, indem sie den Befehl /streak view nutzen.
• Falls die Streak-Wiederherstellung aktiviert ist, können Nutzer, die ihren Streak verloren haben, diesen einmalig über /streak restore wiederherstellen.
• Wenn ein Nutzer eine Streak-Anzahl erreicht, die einer konfigurierten Rollenbelohnung entspricht, wird die Rolle automatisch zugewiesen.

Befehle

Dokumentation Verstehen

In dieser Dokumentation bezeichnen wir eine verpflichtende Slash-Befehl-Option mit dem Namen name und dem Typen Typ als name:<Typ>. Optionen, die nicht Pflichtfelder sind, werden als [name:<Typ>] angegeben. Wenn sich die Aktionen eines Befehls zwischen Pflichtfeldern und Nicht-Pflichtfeldern sehr unterscheiden, listen wir sie eventuell separat.

Beispiele

• /moderate ban user:<Mitglied>: Dieser Befehl (/moderate ban) hat nur eine verpflichtende Option mit dem Namen "user", die nur ein Mitglied akzeptiert.
• /moderate ban victim:<Mitglied> reason:<Text>: Dieser Befehl (/moderate ban) hat eine Option mit dem Namen "victim" als Pflichtangabe, die nur ein Mitglied akzeptiert, und ein weiteres Pflichtfeld mit dem Namen "reason", das jeglichen Text als Wert akzeptiert.
• /moderate ban victim:<Mitglied> reason:<Text> [proof:<Anhang>]: Dieser Befehl (/moderate ban) hat eine Option mit dem Namen "victim" als Pflichtangabe, die nur ein Mitglied akzeptiert, und ein weiteres Pflichtfeld mit dem Namen "reason", das jeglichen Text als Wert akzeptiert. Zusätzlich gibt es eine optionale Option mit dem Namen "proof", die einen Anhang als Wert akzeptiert.

Befehl	Beschreibung
/streak view [user:<User>]	Sieh dir deinen eigenen aktuellen oder längsten Streak oder den eines anderen Nutzers an.
/streak add user:<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:<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:<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:<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

In dieser Konfigurationsdatei kannst du das Modul einrichten. Öffne sie in deinem Dashboard.

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

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

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.