Zum Hauptinhalt springen

Teammitglieder-Ziele

Setze wöchentliche Nachrichtenziele für deine Teammitglieder.

Teammitglieder-Ziele
Setze wöchentliche Ziele für Teammitlgieder
Dieses Modul ist Open-Source.
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 2000 Servern auf SCNX aktiv verwendet.
Dieses Modul ist bei jedem Plan kostenlos dabei. Mehr über Preise erfahren.

Funktionen

  • Setze ein Nachrichtenziel für deine Teammitglieder.
  • Der Bot überprüft jede Woche, ob die Teammitglieder das gesetze Nachrichtenziel erreicht haben.
  • Mit Befehlen kannst du deinen aktuellen Fortschritt und deinen Zielverlauf in der Vergangenheit überprüfen.
  • Sende Nutzern ihr Ergebnis jede Woche per PN oder in einen konfigurierten Kanal.
  • Lasse Kanäle optional von den Zielen ignorieren.

Einrichtung

  1. Wähle (oder erstelle) eine Rolle. Die Aktivität von Nutzern mit dieser Rolle wird gewertet.
  2. Konfiguriere das Modul.
  3. Setze bitte Berechtigungen für Slash-Befehle, um unerlaubte Nutzung zu unterbinden.
  4. Gebe Mitgliedern, deren Aktivität ausgewertet werden soll, die Rolle.

Nutzung

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.
BefehlBeschreibung
/team-goals progress [user:<Nutzer>]Zeigt den Fortschritt (Anzahl der Nachrichten, die zum Erreichen des Ziels gebraucht werden, verbleibende Zeit, …) für das Ziel des aktuellen Bewertungszeitraums an (wenn leer, wird dein Fortschritt angezeigt).
/team-goals history [user:<Nutzer>]Zeigt den früheren Zielverlauf (Anzahl der Nachrichten, Ziel erreicht oder nicht, Prozentsatz der erreichten Ziele) der letzten 10 Wochen des angegebenen Benutzers an (wenn leer, wird dein Verlauf angezeigt).

Definition von modulspezifischen Begriffen

  • Eine Auswertung ist der Zeitpunkt, zu dem ein Nutzer ausgewertet wird. Dies geschieht einmal pro Woche. Der eigentliche Zeitpunkt ist abhängig davon, wann das Modul zum ersten mal aktiviert wurde - die erste Auswertung wird genau eine Woche später stattfinden. Bei der Auswertung vergleicht der Bot die Anzahl der im aktuellen Bewertungszeitraum gesendeten Nachrichten mit dem konfigurierten Ziel und löst die konfigurierten Nachrichten für Fehlgeschlagen / Erreicht aus. Sobald alle Benutzer ausgewertet wurden, beginnt der nächste Bewertungszeitraum.
  • Ein Bewertungszeitraum ist die Zeit zwischen der letzten und der nächsten Auswertung und ist genau eine Woche lang.

Konfiguration

Diese Konfigurationsdatei ermöglicht es dir, die Funktionsweise des Moduls und das Ziel selbst zu konfigurieren. Öffne sie in deinem Dashboard.

FeldBeschreibung
Team-RollenDiese Rollen werden jede Woche hinsichtlich ihres Fortschritts zum Ziel ausgewertet. Es werden nur die Nachrichten von Nutzern mit dieser Rolle gezählt.
Wöchentliche Nachrichten ZieleDie Anzahl der Nachrichten, die Teammitglieder in jedem Bewertungszeitraum senden müssen, um das Ziel zu erreichen.
Ziel erfüllt-NachrichtDas ist die Nachricht, die jede Auswertung für jeden Nutzer, der ausgewertet wird (jeder mit einer konfigurierten Team-Rolle) per PN oder in den konfigurierten Kanal gesendet wird, wenn das Ziel erreicht wurde.
Ziel fehlgeschlagen-NachrichtDas ist die Nachricht, die jede Auswertung für jeden Nutzer, der ausgewertet wird (jeder mit einer konfigurierten Team-Rolle) per PN oder in den konfigurierten Kanal gesendet wird, wenn das Ziel nicht erreicht wurde.
Nachrichten in Kanal statt per PN schickenWenn aktiviert, werden Teammitglieder ihre Auswertung in einem Kanal statt per PN erhalten.
Kanal, in welchen die Nachrichten gesendet werden sollenNur sichtbar, wenn "Nachrichten in Kanal statt per PN schicken" aktiviert ist.
Die Auswertung wird in diesen Kanal statt per PN gesendet.
Ignorierte KanäleNachrichten von Nutzern mit mindestens einer der Teammitglieder-Rollen werden in diesen Kanälen nicht zu ihrem Ziel hinzugerechnet.

Fehlerbehebung

Von meinem Team gesendete Nachrichten werden nicht richtig gezählt

Bitte stelle sicher, dass

  • der Bot Zugriff auf jeden Kanal hat, in welchem Nachrichten gezählt werden sollen, und dass der Kanal kein ignorierter Kanal ist.
  • der Nutzer mindestens eine der konfigurierten Teammitglieder-Rollen hat. Es werden nur Nachrichten gezählt, die von Nutzern gesendet wurden, welche während dem Senden mindestens eine Teammitglieder-Rolle besessen haben - Nachrichten, die gesendet werden, bevor ein Nutzer die Teammitglieder-Rolle hat, werden nicht gezählt.
Wie kann ich die Zeit verändern, wann Nutzer ausgewertet werden?

Es gibt keinen einfachen Weg, das zu tun. Der Auswertungszeitpunkt basiert auf dem genauen Zeitpunkt, zu dem das Modul das erste mal aktiviert wurde (die Auswertung findet jede Woche an diesem Tag zu dieser Zeit statt). Wenn du wirklich einen anderen Auswertungszeitpunkt benötigst, kannst du das Modul deaktivieren, die Modul-Datenbank löschen und warten, bis der genaue Zeitpunkt erreicht ist, zu der die Auswertung stattfinden soll, und dann das Modul wieder aktivieren.

Die Auswertung funktioniert nicht richtig (z.B. werden Auswertungsnachrichten nicht gesendet)

Bitte stelle sicher, dass

Selbst wenn keine Auswertung gesendet wurde, kannst du immer den früheren Zielverlauf mit dem Slash-Befehl /team-goals history einsehen.

Kann ich das Modul nutzen, um die Aktivität meiner Nutzer auszuwerten? / SCNX fügt einen "Missbrauch melden"-Knopf an meine Nachrichten an

Eine solche Nutzung verstößt gegen unsere Nutzungsbedingungen, da du unsere Software nutzt, um deine Nutzer mit Spam zu belästigen. Du darfst das Modul nur zum Auswerten der Aktivität deiner Teammitglieder und nur mit deren Einverständnis nutzen. Wenn du die PN-Funktion von diesem Modul nutzt und eine ungewöhnlich hohe Anzahl an Mitgliedern auf deinem Server auswertest, wird SCNX eventuell automatisch einen "Missbrauch melden"-Knopf an deine Nachrichten anhängen. Du kannst auf sc-net.work/report-mass-dm mehr darüber erfahren (das ist auch der im Knopf verlinkte Link). Die meisten unserer Nutzer sind nie davon betroffen, und du musst dir normalerweise keine Gedanken machen, wenn du das Modul wie beschrieben benutzt.

Gespeicherte Daten

Die folgenden Daten werden über jeden Nutzer mit einer konfigurierten Team-Rolle gespeichert, sobald sie eine Nachricht gesendet haben ("Nutzer-Eintrag"):

  • Die eindeutige Discord-Nutzer-ID
  • Die Anzahl der Nachrichten, die in dem aktuellen Bewertungszeitraum gesendet wurden
  • Metadaten zum Eintrag (Datum der Erstellung und der letzten Aktualisierung)

Das folgende wird bei jeder Auswertung für jeden Nutzer gespeichert, der eine der konfigurierten Team-Rollen hat ("Zielverlauf-Eintrag"):

  • Eine eindeutige Nummer zur Identifizierung des Datenbankeintrags
  • Die eindeutige Discord-Nutzer-ID
  • Die Anzahl der Nachrichten, die der Nutzer im Bewertungszeitraum gesendet hat
  • Das konfigurierte Ziel des aktuellen Bewertungszeitraums
  • Metadaten zum Eintrag (Datum der Erstellung und der letzten Aktualisierung)

Es gibt keine Möglichkeit, den Nutzer-Eintrag oder den Zielverlauf-Eintrag aus der Datenbank zu entfernen. Nachrichten, die von Nutzern ohne eine konfigurierte Team-Rolle gesendet werden, werden niemals gezählt und erstellen keinen Nutzer-Eintrag.

Um alle Daten zu löschen, lösche die Modul-Datenbank.