1. Accueil
  2. TennoCore
  3. 🌌 Bienvenue sur la docume...
  4. 🎉 Système de Giveaways

🎉 Système de Giveaways

Un module complet pour organiser des giveaways avec un ou plusieurs lots, des conditions d’accès, et des boutons de participation. Pensé pour être simple à utiliser, sans termes techniques !


🧾 Lancer un giveaway

Commande : /giveaway

Tu pourras personnaliser :

  • Durée (ex : 10m, 2h, 1d)
  • 🎁 Nombre de gagnants
  • 🧑‍🎓 Rôle requis pour participer
  • Rôle secondaire (facultatif)
  • 🎯 Cumul des rôles (donne plus de chances)
  • Bonus de rôles (mentionnés dans la commande)
  • 💬 Message existant (si tu veux réutiliser un embed)
  • 💸 Points requis (optionnel, intégration avec ton système de shop)
  • 📦 Mode multi-lots (plusieurs boutons de participation)
  • 🌀 Gain multiple autorisé ou non

📦 Mode multi-lots

  • Active-le avec l’option plusieurs_items
  • On te demandera d’envoyer la liste des lots dans le chat (un par ligne)
  • Chaque lot aura son propre bouton vert 🎉 avec un compteur !

✍️ Participer à un giveaway

Quand un membre clique sur un bouton :

  • Il est inscrit automatiquement
  • Si les points sont requis, ils seront vérifiés et déduits
  • Si déjà inscrit, il peut se désinscrire via un menu
  • Le poids de participation est calculé selon :
    • les rôles requis ✅
    • les rôles bonus ⭐

Le poids influence les chances de gagner 🎯


🔄 Modifier un giveaway

  • 🔁 /giveaway_relancer : prolonge un giveaway
  • /giveaway_annuler : supprime un giveaway et ses données
  • 📋 /giveaway_participants : voir la liste des inscrits (avec leurs chances)
  • 📃 /giveaway_lister : liste tous les giveaways encore en cours

🧠 Fin automatique

Toutes les 10 secondes, le bot vérifie les giveaways expirés.

À la fin :

  • Le message est mis à jour avec les gagnants 🏆
  • Les boutons sont désactivés
  • Le bot envoie un message de félicitations
  • Un utilisateur ne peut gagner qu’un seul lot (sauf si autorisé)

📊 Participants

Un bouton spécial permet d’afficher le nombre total de participants en temps réel.


📥 Désinscription possible

  • Si un membre est déjà inscrit, il voit un embed de confirmation avec deux boutons :
    • ✅ Oui → Il est retiré et ses points sont remboursés
    • ❌ Non → Il reste inscrit

⚙️ Données enregistrées

En base de données (SQLite) :

  • Les giveaways et leurs paramètres
  • Les lots de chaque giveaway
  • Les participants, avec leur poids et consommation de points

✅ Astuces

  • Tu peux utiliser un embed personnalisé ou un message existant
  • Le système gère les rôles automatiquement pour les chances
  • Les giveaways sont persistants même après redémarrage du bot