Zum Hauptinhalt springen

Sammel die Codes

Verstecke Codes und lass deine Nutzer diese sammeln

Sammel die Codes
Verstecke Codes und lasse sie von deinen Nutzern sammeln
Dieses Modul ist Open-Source.
Dieses Modul speichert Daten in der Datenbank deines Bots.
Dieses Modul erstellt 2 Haupt-Slash-Befehle auf deinem Server.
Dieses Modul eine verfügbare Konfigurationsdatei.
Dieses Modul wird auf über 3600 Servern auf SCNX aktiv verwendet.
Dieses Modul ist bei jedem Plan kostenlos dabei. Mehr über Preise erfahren.

Funktionen

  • Erstelle versteckte Codes mit benutzerdefinierten Anzeigenamen, die Nutzer finden und einlösen können.
  • Nutzer können ihr Profil mit allen gefundenen Codes und ihrem Fortschritt einsehen.
  • Eine Bestenliste zeigt die erfolgreichsten Code-Jäger.
  • Erstelle Berichte mit detaillierten Statistiken über Nutzer und Codes.
  • Beende die aktuelle Code-Jagd-Sitzung, wodurch ein Abschlussbericht erstellt und alle Daten gelöscht werden.
  • Codes können automatisch generiert oder manuell festgelegt werden.

Einrichtung

  1. Richte Slash-Befehl-Berechtigungen für /hunt-the-code-admin ein, um administrative Befehle auf Moderatoren zu beschränken.
  2. Erstelle Codes mit /hunt-the-code-admin create-code und verstecke sie auf deinem Server, deiner Website oder an anderen Orten.
  3. Teile die Code-Zeichenfolgen über kreative Verstecke (z. B. in Kanalbeschreibungen, Bildern oder auf externen Seiten) mit deiner Community.

Nutzung

Administratoren verwalten die Code-Jagd:

  • Verwende /hunt-the-code-admin create-code, um neue Codes zu erstellen. Jeder Code besitzt einen Anzeigenamen und eine Code-Zeichenfolge (automatisch generiert, falls nicht anders angegeben).
  • Verwende /hunt-the-code-admin report, um einen detaillierten Bericht mit Nutzer-Ranglisten und Code-Statistiken zu erstellen.
  • Verwende /hunt-the-code-admin end, um die aktuelle Jagd-Sitzung zu beenden – dies erstellt einen Abschlussbericht und löscht alle Codes sowie den Fortschritt der Nutzer.

Nutzer nehmen an der Code-Jagd teil:

  • Verwende /hunt-the-code redeem, um einen gefundenen Code einzugeben.
  • Verwende /hunt-the-code profile, um gefundene Codes und den Gesamtfortschritt einzusehen.
  • Verwende /hunt-the-code leaderboard, um die 20 erfolgreichsten Code-Jäger zu sehen.

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
/hunt-the-code redeem code:<Text>Löse einen gefundenen Code ein. Die Groß- und Kleinschreibung spielt dabei keine Rolle.
/hunt-the-code profileSieh dir dein Profil an, das alle gefundenen Codes und deinen Fortschritt beim Finden aller verfügbaren Codes anzeigt.
/hunt-the-code leaderboardSieh dir die 20 erfolgreichsten Nutzer an, die die meisten Codes gefunden haben.
/hunt-the-code-admin create-code display-name:<Text> [code:<Text>]Erstelle einen neuen Code mit einem Anzeigenamen. Wenn keine Code-Zeichenfolge angegeben wird, wird automatisch eine generiert. Erfordert die Berechtigung Nachrichten verwalten.
/hunt-the-code-admin reportErstelle einen detaillierten Bericht der aktuellen Code-Jagd-Sitzung, einschließlich Nutzer-Ranglisten und Code-Statistiken. Der Bericht wird als temporäres Dokument hochgeladen. Erfordert die Berechtigung Nachrichten verwalten.
/hunt-the-code-admin endBeende die aktuelle Code-Jagd-Sitzung. Erstellt einen Abschlussbericht und löscht anschließend alle Codes sowie den Nutzerfortschritt. Erfordert die Berechtigung Nachrichten verwalten.

Konfiguration

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

FeldBeschreibung
Code-nicht-gefunden-NachrichtDie Nachricht, die angezeigt wird, wenn ein Nutzer versucht, einen ungültigen Code einzulösen.
Code-bereits-eingelöst-NachrichtDie Nachricht, die angezeigt wird, wenn ein Nutzer versucht, einen bereits gefundenen Code einzulösen.
Code-eingelöst-NachrichtDie Nachricht, die angezeigt wird, wenn ein Nutzer einen Code erfolgreich eingelöst hat.
Profil-NachrichtDas Embed, das angezeigt wird, wenn ein Nutzer sein Profil aufruft, um gefundene Codes und den Fortschritt einzusehen.
Leaderboard-NachrichtPasse das Erscheinungsbild des Leaderboard-Embeds an (title, color, thumbnail, image).

Fehlerbehebung

Nutzer können keine Codes einlösen
  • Stelle sicher, dass der Code erfolgreich mit /hunt-the-code-admin create-code erstellt wurde.
  • Codes unterscheiden nicht zwischen Groß- und Kleinschreibung, daher spielt die Kapitalisierung keine Rolle.
  • Überprüfe, ob der Nutzer den Code bereits eingelöst hat, indem du ihn sein Profil kontrollieren lässt.

Gespeicherte Daten

Folgende Daten werden gespeichert:

Für jeden Code:

  • Die Code-Zeichenfolge (Primärschlüssel)
  • Der Anzeigename des Codes
  • Die Anzahl der Einlösungen des Codes
  • Metadaten zum Eintrag (Erstellungs- und Änderungsdatum)

Für jeden Nutzer:

  • Die Discord-Nutzer-ID
  • Die Gesamtzahl der gefundenen Codes
  • Eine Liste aller eingelösten Code-Zeichenfolgen
  • Metadaten zum Eintrag (Erstellungsdatum und Zeitpunkt der letzten Aktualisierung)

Um alle von diesem Modul gespeicherten Daten zu löschen, setze die Modul-Datenbank zurück.