Serverwährung (Multi-Währungen)

Beschreibung

Benutzerhandbuch

Erstellen Sie eine oder mehrere eigene Währungen für Ihren Server, die die Mitglieder durch Chatten und im Sprachkanal verdienen und dann in einem Shop, einem Casino oder den Minispielen ausgeben. Für Administratoren, die eine maßgeschneiderte Wirtschaft mit mehreren untereinander konvertierbaren Währungen wollen.

Was es tut

• Erstellt so viele Währungen, wie Sie möchten, jede mit eigenem Namen und Emoji.
• Verteilt Gewinne für Aktivität: pro Nachricht, nach im Sprachkanal verbrachter Zeit oder beides.
• Beschränkt die Gewinne auf bestimmte Kanäle oder Kategorien und setzt eine Gewinngrenze.
• Veröffentlicht interaktive Panels in Discord: Guthaben, Shop, Inventar, Casino, Umrechnung.
• Eröffnet einen Shop pro Währung (Preis, Bestand, Ablaufdatum).
• Bietet ein einfaches Casino pro Währung (fester oder freier Einsatz, einstellbare Gewinnchance, Cooldown).
• Verknüpft die Währungen untereinander mit einem Umrechnungskurs (abgeleitete Währung → Hauptwährung).
• Zeigt eine Rangliste der Reichsten an.

Schnellstart (Admin)

1. Währung erstellen: /monnaie creer id:gold nom:Gold emoji:💰 (die Kennung muss aus Kleinbuchstaben und Ziffern bestehen).
2. Gewinne einstellen: /monnaie config_gain — wählen Sie die Methode (Nachricht, Sprachkanal, beides), den Gewinn, das Intervall und die Zeichenschwelle.
3. Optional: Beschränken Sie die Gewinne mit /monnaie restriction auf einige Kanäle.
4. Füllen Sie den Shop: /monnaie boutique_objet oder den Tab Shop im Dashboard.
5. Optional: Konfigurieren Sie das Casino mit /monnaie casino und bestimmen Sie mit /monnaie staff_role eine Verwaltungsrolle.
6. Veröffentlichen Sie die Panels in einem Kanal: /monnaie panneau type:👤 Panneau Utilisateur für die Mitglieder und type:🛠 Panneau Staff in einem dem Team vorbehaltenen Kanal.

Befehle

Für die Mitglieder

Befehl	Beschreibung
/monnaie liste	Zeigt alle auf dem Server konfigurierten Währungen an.
/monnaie classement	Rangliste der reichsten Mitglieder einer Währung.
/monnaie conversions	Zeigt die verknüpften Währungen und ihren Umrechnungskurs an.
/monnaie convertir	Wandelt eine abgeleitete Währung in ihre Hauptwährung um.

Guthaben, Shop, Inventar und Casino laufen nicht über Befehle: Sie werden über die Schaltflächen des Benutzer-Panels genutzt.

Für die Administratoren

Befehl	Beschreibung
/monnaie creer	Eine Währung erstellen (Kennung, Name, Emoji).
/monnaie config_gain	Gewinne einstellen: Methode, Betrag, Intervall, Zeichenschwelle, Grenze.
/monnaie restriction	Die Gewinne auf einen Kanal oder eine Kategorie beschränken.
/monnaie boutique_objet	Einen Gegenstand zum Shop einer Währung hinzufügen.
/monnaie casino	Das Casino einer Währung konfigurieren (Modus, Einsatz, Gewinn, Chance, Cooldown).
/monnaie staff_role	Die Rolle bestimmen, die das Staff-Panel nutzen darf.
/monnaie lier	Eine abgeleitete Währung mit einem Kurs an eine Hauptwährung binden.
/monnaie panneau	Ein interaktives Panel (Benutzer oder Staff) in einem Kanal veröffentlichen.

Einstellungen im Dashboard

Das Modul „Multi-Währungen" bietet vier Tabs:

• Währungen — Erstellung und vollständige Bearbeitung einer Währung: Name, Emoji, Gewinnmethode, Gewinn und Intervall pro Nachricht, Zeichenschwelle, Tagesgrenze, Gewinn und Intervall im Sprachkanal, erlaubte Kanäle und Kategorien, Casino-Einstellungen (Modus, Cooldown, Einsatz, Gewinn, Chance als Zähler/Nenner) und Umrechnungsbindung an eine Hauptwährung.
• Shop — Gegenstände einer bestimmten Währung: Name, Beschreibung, Emoji, Preis, Bestand (leer = unbegrenzt), Ablaufdatum.
• Guthaben — die hundert größten Guthaben einer Währung, mit der Möglichkeit, ein Guthaben Mitglied für Mitglied anzupassen (einen Wert ersetzen oder einen Betrag hinzufügen/abziehen).
• Einstellungen — die Staff-Rolle, die die Schaltflächen des Staff-Panels nutzen darf.

Das Veröffentlichen der Discord-Panels bleibt ein Vorgang, der von Discord aus mit /monnaie panneau erledigt wird: Das Dashboard postet keine Nachricht an Ihrer Stelle.

Verhältnis zum Shop

Achten Sie darauf, zwei getrennte Systeme nicht zu verwechseln:

• Der Shop dieses Moduls ist integriert: Jede Währung hat ihre eigene Gegenstandsliste, der Kauf erfolgt über die Schaltfläche „🛒 Shop" des Benutzer-Panels, der Preis wird sofort abgebucht und der Gegenstand landet im Inventar des Mitglieds. Es gibt weder Ticket noch Bestätigung.
• Das Modul „ShopDiscord" ist ein eigenes System mit seiner eigenen Währung namens „Punkte", seinen Bonusrollen, seinen Boosts und einer Bestätigung per Ticket bei jedem Kauf. Wenn Sie diese Funktionsweise suchen, sehen Sie sich die Seite Discord Shop (Shop & Punkte) dieser Dokumentation an.

Beide können auf demselben Server bestehen, ihre Guthaben kommunizieren jedoch nicht. Entscheiden Sie sich für eines als Ihre Hauptwirtschaft, sonst wissen Ihre Mitglieder nicht mehr, welche Währung wofür gut ist.

Die Währungen dieses Moduls versorgen außerdem die Minispiele der Activity und das Modul Herausforderungen & Karten.

Gut zu wissen

• Das Dashboard zeigt die Warnung „Instabiles Modul — in Entwicklung" an. Testen Sie Ihre Einstellungen, bevor Sie eine Wirtschaft starten, auf die Ihre Mitglieder sich verlassen werden.
• Ohne Zeichenschwelle wird kein Gewinn pro Nachricht ausgezahlt. Die Berechnung nutzt diese Schwelle als Divisor: Eine Nachricht mit der Länge der Schwelle bringt den vollen Gewinn, eine längere Nachricht anteilig mehr, eine kürzere anteilig weniger. Ist die Schwelle 0, ist der Gewinn immer 0. Setzen Sie einen realistischen Wert ein (zum Beispiel 20 Zeichen).
• Die „Tagesgrenze" wird mit dem aktuellen Guthaben verglichen, nicht mit den Gewinnen des Tages: Oberhalb dieses Werts gewinnt das Mitglied für diese Währung nichts mehr. Sie verhält sich also wie eine Guthaben-Obergrenze. Lassen Sie sie auf 0, wenn Sie keine Obergrenze wollen.
• Das Intervall ist ein Spam-Schutz: Ein Mitglied gewinnt höchstens einmal pro Intervall (in Minuten) und Währung. Dieser Zähler wird im Arbeitsspeicher gehalten und beginnt bei einem Neustart des Bots wieder bei Null.
• Die Gewinne im Sprachkanal werden einmal pro Minute geprüft. Ein Sprachgewinn wird nur ausgelöst, wenn Betrag und Sprachintervall beide angegeben sind.
• Die Kennung einer Währung lässt sich nach der Erstellung nicht mehr ändern (Name und Emoji hingegen schon). Wählen Sie sie kurz und aussagekräftig: Sie erscheint in den Auswahlfeldern aller anderen Module.
• Eine Währung zu löschen löscht alles, was dazugehört: Guthaben der Mitglieder, Shop-Gegenstände, Casino-Verlauf. Das ist unumkehrbar.
• Das Casino muss für jede Währung einzeln konfiguriert werden, sonst erhalten die Mitglieder die Aufforderung, einen Administrator zu kontaktieren. Im Modus „fest" ist der Einsatz vorgegeben und verpflichtend; im Modus „frei" wählt der Spieler seinen Betrag.
• Die Umrechnung funktioniert nur in eine Richtung: von einer abgeleiteten Währung zu ihrer Hauptwährung. Eine Währung kann nicht mit sich selbst verknüpft werden.
• Das Staff-Panel gibt Zugriff auf das Hinzufügen und Abziehen von Währung. Veröffentlichen Sie es in einem geschlossenen Kanal und vergeben Sie die Staff-Rolle nur an vertrauenswürdige Personen: Administratoren haben ohnehin Zugriff.
• Shop-Gegenstände, deren Ablaufdatum überschritten ist, werden automatisch gelöscht (Prüfung alle zehn Minuten).