Défis & Cartes

Description

Guide Utilisateur

Animez votre communauté avec des défis hebdomadaires validés par le staff, des cartes à collectionner, des loot boxes, un coffre-fort à code secret et des apparitions surprises dans le chat. Destiné aux administrateurs qui veulent donner un but à leur monnaie de serveur.

Ce que ça fait

• Publie des défis hebdomadaires que les membres choisissent, puis valide leurs preuves dans un salon dédié.
• Fait collectionner des cartes (6 raretés) regroupées en collections, tirées dans des boosters payants.
• Vend des loot boxes dont le contenu est tiré au sort selon des probabilités.
• Ouvre un coffre-fort que les membres tentent de déverrouiller avec un code secret.
• Déclenche des événements réactifs : une récompense apparaît au hasard dans le chat, aux premiers qui cliquent.
• Gère le prestige, les badges et les objets rares, tous visibles sur un profil.

Démarrage rapide (Admin)

1. Créez d'abord une monnaie dans le module « Multi-Monnaies » : tout ce module s'appuie dessus (voir Monnaie de serveur).
2. Ouvrez le module Défis & Cartes dans le dashboard.
3. Onglet Défis : créez un défi (titre, critère, récompense, monnaie), puis déclarez le salon de validation de cette monnaie — c'est là que les preuves arriveront.
4. Onglet Cartes : créez une collection, puis quelques cartes ; onglet Boosters : créez un booster et réglez ses probabilités par rareté.
5. Onglet Coffres : créez un coffre-fort (code secret, essais par jour, lot).
6. Onglet Événements : réglez la chance d'apparition, la durée et la récompense — puis ajoutez au moins un salon autorisé, sinon rien n'apparaîtra jamais.
7. Annoncez aux membres /challengesystem defi liste et /challengesystem profil voir.

Commandes

Toutes les commandes vivent sous /challengesystem, suivies d'un groupe puis d'une action.

Pour les membres

Commande	Description
/challengesystem defi liste	Affiche les défis disponibles, groupés par monnaie.
/challengesystem defi choisir	Choisir un défi hebdomadaire.
/challengesystem defi soumettre_preuve	Envoyer un fichier comme preuve de réussite.
/challengesystem profil voir	Son profil complet (monnaies, badges, objets, cartes, prestige).
/challengesystem profil recompenses	Voir les récompenses paramétrées sur le serveur.
/challengesystem carte moi	Voir sa collection de cartes.
/challengesystem collection lister	Voir les collections du serveur.
/challengesystem booster ouvrir	Ouvrir un booster de cartes (payant).
/challengesystem lootbox ouvrir	Ouvrir une loot box et découvrir sa récompense.
/challengesystem lootbox voir	Voir le contenu annoncé d'une loot box.
/challengesystem coffre tenter	Tenter d'ouvrir le coffre-fort en saisissant le code.
/challengesystem coffre actif	Voir le coffre-fort en cours.
/challengesystem coffre stats	Voir ses tentatives restantes du jour.
/challengesystem prestige voir	Voir son niveau de prestige.
/challengesystem badge voir	Voir ses badges.
/challengesystem objet voir	Voir ses objets rares.

Pour le staff

Commande	Description
/challengesystem defi ajouter	Créer un défi hebdomadaire.
/challengesystem defi config_validation	Définir le salon de validation des preuves pour une monnaie.
/challengesystem carte creer · carte modifier · carte supprimer	Gérer les cartes (avec aperçu avant publication).
/challengesystem collection creer	Créer une collection de cartes.
/challengesystem booster creer · booster config_proba	Créer un booster et régler ses probabilités par rareté.
/challengesystem lootbox ajouter · lootbox ajouter_item	Créer une loot box et y placer des lots.
/challengesystem coffre creer · coffre fermer	Ouvrir ou fermer un coffre-fort.
/challengesystem prestige configurer	Définir le seuil de prestige et le rôle attribué.
/challengesystem badge ajouter	Créer un badge disponible.
/challengesystem objet ajouter	Créer un objet rare.
/challengesystem event configurer · event onoff	Régler et activer les événements réactifs.
/challengesystem event channels_add · channels_remove · channels_list	Gérer les salons où les événements peuvent apparaître.
/challengesystem event forcer	Déclencher un événement immédiatement (test).
/challengesystem chaos ajouter · chaos ajouter_effet · chaos liste · chaos ouvrir	Gérer les Coffres du Chaos et leurs effets.

Réglages depuis le dashboard

Le module se présente en dix onglets, et couvre tout ce que font les commandes de staff — en général plus confortablement (tableaux, formulaires, sélecteurs de rôles et de salons) :

• Défis — liste des défis (titre, type, critère, type et valeur de récompense, monnaie associée, preuve requise ou non) et table des salons de validation par monnaie.
• Cartes — cartes (nom, description, image par URL, rareté, collection) et collections.
• Boosters — prix, monnaie, nombre de cartes tirées (min/max) et table de tirage par type et rareté avec un poids.
• Lootbox — boîtes (prix, monnaie, stock) et leurs lots avec un poids de tirage.
• Coffres — code secret, indice, essais par jour, lot, et l'option « désactiver les autres coffres actifs ».
• Prestige — seuil (total des monnaies), rôle attribué, multiplicateur affiché sur la fiche de prestige.
• Badges — nom, emoji, image, et rôle Discord attribué avec le badge (optionnel).
• Objets rares — nom, description, emoji, image.
• Événements — chance par message (0 à 1), cooldown, nombre de gagnants, durée, récompense.
• Chaos — Coffres du Chaos et leurs effets : perte globale, boost casino, bonus global, fermeture de boutique, inversion des gains.

Bon à savoir

• Le dashboard affiche un avertissement « Module instable — en cours de développement ». Il est jeune et peut évoluer sans préavis : testez sur un salon discret avant d'annoncer un événement à tout le serveur.
• Rien ne fonctionne sans monnaie. Défis, boosters, loot boxes, coffres et événements sont tous rattachés à une monnaie du module Multi-Monnaies. Sans monnaie créée, les formulaires resteront vides.
• Les défis ne se valident pas tout seuls. Le « type » et le « critère » sont du texte libre : le bot ne mesure aucune progression. Le membre choisit le défi, envoie un fichier en preuve, et un membre du staff approuve ou refuse avec les boutons du message posté dans le salon de validation. Sans salon de validation configuré pour la monnaie du défi, la preuve n'arrive nulle part.
• Un défi ne peut être choisi qu'une fois par membre : il n'y a pas de « rejouer ».
• Le prestige remet les compteurs à zéro. Quand le total des monnaies d'un membre atteint le seuil, tous ses soldes sont remis à 0, son niveau de prestige augmente de 1 et le rôle configuré lui est donné. Annoncez-le clairement, sinon vos membres vivront ça comme une perte.
• Coffre-fort : le code est stocké sous forme chiffrée (personne ne peut le relire dans la base), les essais sont limités par jour (de 1 à 100, 5 par défaut) et remis à zéro chaque jour. Créer un coffre désactive les précédents par défaut.
• Les événements réactifs n'apparaissent que dans les salons que vous listez. Tant qu'aucun salon n'est ajouté, la chance d'apparition ne sert à rien. Le bot a aussi besoin du droit d'écrire dans ces salons.
• Les achats sont débités avant le tirage : ouvrir une loot box ou un booster vérifie le solde, réserve le stock, puis tire le lot. Un stock épuisé bloque l'ouverture.
• Toutes les commandes de staff ne sont pas protégées de la même façon. La plupart exigent « Gérer le serveur » ou « Administrateur », mais quelques commandes de création (les défis et les loot boxes notamment) ne vérifient rien côté bot. Restreignez /challengesystem à vos rôles de confiance depuis Paramètres du serveur → Intégrations.
• Le module compte plus de quarante sous-commandes : préférez le dashboard pour la configuration, et ne laissez aux membres que les commandes de consultation et de jeu.