🎉 Gewinnspiele (Giveaways)
Beschreibung
Benutzerhandbuch
Starten Sie Auslosungen, verwalten Sie mehrere Preise, fordern Sie Rollen/Punkte an, losen Sie Gewinner neu aus und zeigen Sie Teilnehmer an — ganz ohne Kopfzerbrechen.
🔎 Was es tut
- Erstellt Gewinnspiele mit 1 oder mehreren Preisen.
- Persistente Teilnahme-Buttons (der Zähler aktualisiert sich).
- Teilnahmebedingungen: erforderliche Rollen, Punkte (optional).
- Gewinnchancen-Gewichtung: Kumulation von Rollen + Bonus-Rollen.
- Automatisches Ende ⏱️, Ziehung der Gewinner 🏆, einfaches Reroll.
🚀 Schnellstart
- Starten Sie eine einfache Verlosung (einzelner Preis):
/giveaway duration:1h winners:1 role_1:@Mitglied cumul_roles:Nein varios_items:Nein gain_multiple:Nein - Oder eine Multi-Preis-Verlosung: Der Bot fragt nach der Liste der Preise (einer pro Zeile).
- (Optional) Punkte fordern/konsumieren:
required_points:100•consume_points:Ja
🧩 Wichtige Optionen
| Option | Beschreibung |
|---|---|
duration | z. B. 10m, 2h, 3d1h10m. |
winners | Anzahl der Gewinner pro Preis. |
role_1 | Pflichtrolle. role_2 optional. |
cumul_roles | Addiert role_1 + role_2 für höhere Chancen. |
bonus_roles | Rollen, die Extra-Chancen geben. |
plusieurs_items | Multi-Preise aktivieren (Bot fragt Liste ab). |
gain_multiple | Darf dieselbe Person mehrere Preise gewinnen? |
required_points | Punkte für Teilnahme erforderlich. |
consume_points | Punkte für Teilnahme abziehen. |
message_id | Existierendes Embed wiederverwenden ("⏰ Ende"-Zeile wird autom. hinzugefügt). |
🧰 Schnellverwaltung (Admin)
| Befehl | Beschreibung |
|---|---|
/giveaway | Erstellen (Einzel- oder Multi-Preis). |
/giveaway_lister | Aktive Gewinnspiele anzeigen. |
/giveaway_participants | Teilnehmer pro Preis auflisten. |
/giveaway_terminer | Jetzt beenden und auslosen. |
/giveaway_annuler | Ohne Auslosung abbrechen. |
/giveaway_relancer | Dauer verlängern/ändern. |
/giveaway_reroll | Neu auslosen (einen oder mehrere Preise). |
👥 Teilnahme (Benutzer)
- Klicken Sie auf den Button 🎉 Participer (Teilnehmen) oder auf den Button des gewünschten Preises.
- Wenn Sie bereits registriert sind, bietet ein Mini-Menü an, sich abzumelden (Rückerstattung von Punkten, falls zutreffend 💸).
- Das Label
📊 Teilnehmer (N)aktualisiert sich von selbst.
🛟 Fehlerbehebung
- 🚫 Teilnahme nicht möglich: Fehlende Pflichtrolle oder nicht genügend Punkte.
- 🧮 Zähler blockiert: Warten Sie 1–2 s, aktualisiert sich nach Datenbankeintrag.
- 🎛️ Multi-Preise: Jeder Preis hat seinen eigenen Button und seine eigene Teilnehmerliste.
- 🔁 Reroll: Wenn "mehrere Gewinner" deaktiviert ist, kann ein Gewinner keine zwei Preise erhalten.
❓ FAQ
Häufig gestellte Fragen
Kann man ein bereits gepostetes Embed wiederverwenden?
Ja: Übergeben Sie message_id und (optional) channel. Der Bot fügt die Zeile ⏰ Ende hinzu.
Werden Punkte bei Abmeldung zurückerstattet? Ja, wenn die Option "Punkte konsumieren" aktiv war, erfolgt die Rückerstattung automatisch bei Abmeldung.
Wie schreibt man die Dauer?
Reihen Sie die Einheiten aneinander: 3d1h10m (Tage/Stunden/Minuten).