🎉 Giveaways
Description
Guide Utilisateur
Lance des tirages, gère plusieurs lots, exige des rôles/points, reroll des gagnants et affiche les participants — sans prise de tête.
🔎 Ce que ça fait
- Crée des giveaways en 1 ou plusieurs lots.
- Boutons de participation persistants (le compteur se met à jour).
- Conditions d’entrée : rôles requis, points (optionnel).
- Poids des chances : cumul de rôles + rôles bonus.
- Fin automatique ⏱️, tirage des gagnants 🏆, reroll facile.
🚀 Démarrage rapide
- Lance un tirage simple (lot unique) :
/giveaway duration:1h winners:1 role_1:@Membre cumul_roles:Non plusieurs_items:Non gain_multiple:Non - Ou un tirage multi‑lots : le bot te demandera la liste des lots (un par ligne).
- (Option) Exiger/consommer des points :
required_points:100•consume_points:Oui
🧩 Options importantes
| Option | Description |
|---|---|
duration | ex. 10m, 2h, 3d1h10m. |
winners | nb de gagnants par lot. |
role_1 | rôle obligatoire. role_2 facultatif. |
cumul_roles | additionne role_1 + role_2 pour plus de chances. |
bonus_roles | rôles donnant un bonus de chances. |
plusieurs_items | activer les multi‑lots (le bot te demandera la liste). |
gain_multiple | la même personne peut‑elle gagner plusieurs lots ? |
required_points | exiger des points pour participer. |
consume_points | déduire des points pour participer. |
message_id | réutiliser un embed existant (une section “⏰ Fin” est ajoutée automatiquement). |
🧰 Gestion rapide (Admin)
| Commande | Description |
|---|---|
/giveaway | Créer (lot unique ou multi‑lots). |
/giveaway_lister | Voir les giveaways actifs. |
/giveaway_participants | Lister les inscrits par lot. |
/giveaway_terminer | Terminer maintenant et tirer. |
/giveaway_annuler | Annuler sans tirage. |
/giveaway_relancer | Prolonger/modifier la durée. |
/giveaway_reroll | Reroll (un ou plusieurs lots). |
👥 Participation côté membre
- Cliquer sur le bouton 🎉 Participer ou sur le bouton du lot voulu.
- Si tu es déjà inscrit, un mini menu te propose de te désinscrire (remboursement des points si applicable 💸).
- Le label
📊 Participants (N)se met à jour tout seul.
🛟 Dépannage
- 🚫 Impossible de participer : rôle requis manquant, ou pas assez de points.
- 🧮 Compteur bloqué : patiente 1–2 s, il se met à jour après écriture en base.
- 🎛️ Multi‑lots : chaque lot a son propre bouton et sa propre liste de participants.
- 🔁 Reroll : si “gagnants multiples” désactivé, un gagnant ne peut pas remporter deux lots.
❓ FAQ
Questions Fréquentes
Peut‑on réutiliser un embed déjà posté ?
Oui : passe message_id et (option) channel. Le bot ajoute la ligne ⏰ Fin.
Les points sont remboursés si je me désinscris ? Oui, si l’option “consommer des points” était active, le remboursement est automatique lors de la désinscription.
Comment écrire la durée ?
Enchaîne les unités : 3d1h10m (jours/heures/minutes).