Herausforderungen & Karten

Beschreibung

Benutzerhandbuch

Beleben Sie Ihre Community mit wöchentlichen Herausforderungen, die vom Staff bestätigt werden, Sammelkarten, Loot-Boxen, einem Safe mit Geheimcode und Überraschungserscheinungen im Chat. Gedacht für Administratoren, die ihrer Serverwährung ein Ziel geben wollen.

Was es tut

• Veröffentlicht wöchentliche Herausforderungen, die die Mitglieder auswählen, und bestätigt anschließend ihre Nachweise in einem eigenen Kanal.
• Lässt Karten (6 Seltenheitsstufen) sammeln, die in Sammlungen gebündelt und aus kostenpflichtigen Boostern gezogen werden.
• Verkauft Loot-Boxen, deren Inhalt nach Wahrscheinlichkeiten ausgelost wird.
• Öffnet einen Safe, den die Mitglieder mit einem Geheimcode zu entsperren versuchen.
• Löst Reaktions-Events aus: Eine Belohnung erscheint zufällig im Chat — für die Ersten, die klicken.
• Verwaltet Prestige, Abzeichen und seltene Gegenstände, alle in einem Profil sichtbar.

Schnellstart (Admin)

1. Erstellen Sie zuerst eine Währung im Modul „Multi-Währungen": Das gesamte Modul baut darauf auf (siehe Serverwährung).
2. Öffnen Sie das Modul Herausforderungen & Karten im Dashboard.
3. Tab Herausforderungen: Erstellen Sie eine Herausforderung (Titel, Kriterium, Belohnung, Währung) und legen Sie dann den Bestätigungskanal dieser Währung fest — dort landen die Nachweise.
4. Tab Karten: Erstellen Sie eine Sammlung und dann einige Karten; Tab Booster: Erstellen Sie einen Booster und stellen Sie seine Wahrscheinlichkeiten je Seltenheitsstufe ein.
5. Tab Safes: Erstellen Sie einen Safe (Geheimcode, Versuche pro Tag, Gewinn).
6. Tab Events: Stellen Sie Erscheinungswahrscheinlichkeit, Dauer und Belohnung ein — und fügen Sie mindestens einen erlaubten Kanal hinzu, sonst erscheint nie etwas.
7. Machen Sie Ihre Mitglieder auf /challengesystem defi liste und /challengesystem profil voir aufmerksam.

Befehle

Alle Befehle liegen unter /challengesystem, gefolgt von einer Gruppe und dann einer Aktion.

Für die Mitglieder

Befehl	Beschreibung
/challengesystem defi liste	Zeigt die verfügbaren Herausforderungen, nach Währung gruppiert.
/challengesystem defi choisir	Eine wöchentliche Herausforderung auswählen.
/challengesystem defi soumettre_preuve	Eine Datei als Nachweis für den Erfolg senden.
/challengesystem profil voir	Das vollständige Profil (Währungen, Abzeichen, Gegenstände, Karten, Prestige).
/challengesystem profil recompenses	Die auf dem Server eingerichteten Belohnungen ansehen.
/challengesystem carte moi	Die eigene Kartensammlung ansehen.
/challengesystem collection lister	Die Sammlungen des Servers ansehen.
/challengesystem booster ouvrir	Einen Kartenbooster öffnen (kostenpflichtig).
/challengesystem lootbox ouvrir	Eine Loot-Box öffnen und die Belohnung entdecken.
/challengesystem lootbox voir	Den angekündigten Inhalt einer Loot-Box ansehen.
/challengesystem coffre tenter	Versuchen, den Safe durch Eingabe des Codes zu öffnen.
/challengesystem coffre actif	Den laufenden Safe ansehen.
/challengesystem coffre stats	Die verbleibenden Versuche des Tages ansehen.
/challengesystem prestige voir	Die eigene Prestige-Stufe ansehen.
/challengesystem badge voir	Die eigenen Abzeichen ansehen.
/challengesystem objet voir	Die eigenen seltenen Gegenstände ansehen.

Für den Staff

Befehl	Beschreibung
/challengesystem defi ajouter	Eine wöchentliche Herausforderung erstellen.
/challengesystem defi config_validation	Den Kanal zur Bestätigung der Nachweise für eine Währung festlegen.
/challengesystem carte creer · carte modifier · carte supprimer	Karten verwalten (mit Vorschau vor der Veröffentlichung).
/challengesystem collection creer	Eine Kartensammlung erstellen.
/challengesystem booster creer · booster config_proba	Einen Booster erstellen und seine Wahrscheinlichkeiten je Seltenheitsstufe einstellen.
/challengesystem lootbox ajouter · lootbox ajouter_item	Eine Loot-Box erstellen und Gewinne darin ablegen.
/challengesystem coffre creer · coffre fermer	Einen Safe öffnen oder schließen.
/challengesystem prestige configurer	Die Prestige-Schwelle und die zugewiesene Rolle festlegen.
/challengesystem badge ajouter	Ein verfügbares Abzeichen erstellen.
/challengesystem objet ajouter	Einen seltenen Gegenstand erstellen.
/challengesystem event configurer · event onoff	Reaktions-Events einstellen und aktivieren.
/challengesystem event channels_add · channels_remove · channels_list	Die Kanäle verwalten, in denen Events erscheinen können.
/challengesystem event forcer	Ein Event sofort auslösen (Test).
/challengesystem chaos ajouter · chaos ajouter_effet · chaos liste · chaos ouvrir	Die Chaos-Truhen und ihre Effekte verwalten.

Einstellungen im Dashboard

Das Modul besteht aus zehn Tabs und deckt alles ab, was die Staff-Befehle können — in der Regel komfortabler (Tabellen, Formulare, Rollen- und Kanalauswahl):

• Herausforderungen — Liste der Herausforderungen (Titel, Typ, Kriterium, Art und Wert der Belohnung, zugehörige Währung, Nachweis erforderlich oder nicht) und Tabelle der Bestätigungskanäle je Währung.
• Karten — Karten (Name, Beschreibung, Bild per URL, Seltenheit, Sammlung) und Sammlungen.
• Booster — Preis, Währung, Anzahl der gezogenen Karten (min./max.) und Ziehungstabelle nach Typ und Seltenheit mit einer Gewichtung.
• Loot-Box — Boxen (Preis, Währung, Bestand) und ihre Gewinne mit einer Ziehungsgewichtung.
• Safes — Geheimcode, Hinweis, Versuche pro Tag, Gewinn und die Option „andere aktive Safes deaktivieren".
• Prestige — Schwelle (Summe der Währungen), zugewiesene Rolle, auf der Prestige-Karte angezeigter Multiplikator.
• Abzeichen — Name, Emoji, Bild und die mit dem Abzeichen zugewiesene Discord-Rolle (optional).
• Seltene Gegenstände — Name, Beschreibung, Emoji, Bild.
• Events — Wahrscheinlichkeit pro Nachricht (0 bis 1), Cooldown, Anzahl der Gewinner, Dauer, Belohnung.
• Chaos — Chaos-Truhen und ihre Effekte: globaler Verlust, Casino-Boost, globaler Bonus, Shop-Schließung, Umkehrung der Gewinne.

Gut zu wissen

• Das Dashboard zeigt die Warnung „Instabiles Modul — in Entwicklung" an. Es ist jung und kann sich ohne Vorankündigung ändern: Testen Sie in einem unauffälligen Kanal, bevor Sie ein Event auf dem ganzen Server ankündigen.
• Ohne Währung funktioniert nichts. Herausforderungen, Booster, Loot-Boxen, Safes und Events sind alle an eine Währung des Moduls Multi-Währungen gebunden. Ohne erstellte Währung bleiben die Formulare leer.
• Herausforderungen bestätigen sich nicht selbst. „Typ" und „Kriterium" sind freier Text: Der Bot misst keinerlei Fortschritt. Das Mitglied wählt die Herausforderung, sendet eine Datei als Nachweis, und ein Staff-Mitglied genehmigt oder lehnt ab über die Schaltflächen der Nachricht, die im Bestätigungskanal gepostet wird. Ohne konfigurierten Bestätigungskanal für die Währung der Herausforderung landet der Nachweis nirgendwo.
• Eine Herausforderung kann pro Mitglied nur einmal gewählt werden: Es gibt kein „erneut spielen".
• Prestige setzt die Zähler zurück. Erreicht die Summe der Währungen eines Mitglieds die Schwelle, werden alle seine Guthaben auf 0 zurückgesetzt, seine Prestige-Stufe steigt um 1 und die konfigurierte Rolle wird ihm zugewiesen. Kündigen Sie das deutlich an, sonst erleben Ihre Mitglieder es als Verlust.
• Safe: Der Code wird verschlüsselt gespeichert (niemand kann ihn in der Datenbank nachlesen), die Versuche sind pro Tag begrenzt (1 bis 100, standardmäßig 5) und werden täglich zurückgesetzt. Einen Safe zu erstellen deaktiviert standardmäßig die vorherigen.
• Reaktions-Events erscheinen nur in den Kanälen, die Sie auflisten. Solange kein Kanal hinzugefügt ist, nützt die Erscheinungswahrscheinlichkeit nichts. Der Bot braucht außerdem das Recht, in diesen Kanälen zu schreiben.
• Käufe werden vor der Ziehung abgebucht: Beim Öffnen einer Loot-Box oder eines Boosters wird das Guthaben geprüft, der Bestand reserviert und dann der Gewinn gezogen. Ein erschöpfter Bestand blockiert das Öffnen.
• Nicht alle Staff-Befehle sind gleich gut geschützt. Die meisten verlangen „Server verwalten" oder „Administrator", aber einige Erstellungsbefehle (insbesondere für Herausforderungen und Loot-Boxen) prüfen auf Bot-Seite nichts. Beschränken Sie /challengesystem über Servereinstellungen → Integrationen auf Ihre vertrauenswürdigen Rollen.
• Das Modul umfasst mehr als vierzig Unterbefehle: Nutzen Sie für die Konfiguration lieber das Dashboard und überlassen Sie den Mitgliedern nur die Befehle zum Ansehen und Spielen.