Monnaie de serveur (Multi-Monnaies)

Description

Guide Utilisateur

Créez une ou plusieurs monnaies propres à votre serveur, que les membres gagnent en discutant et en vocal, puis dépensent dans une boutique, un casino ou les mini-jeux. Pour les administrateurs qui veulent une économie sur mesure, avec plusieurs devises convertibles entre elles.

Ce que ça fait

• Crée autant de monnaies que vous voulez, chacune avec son nom et son emoji.
• Distribue des gains à l'activité : par message, par temps passé en vocal, ou les deux.
• Restreint les gains à certains salons ou catégories, et pose une limite de gain.
• Publie des panneaux interactifs dans Discord : solde, boutique, inventaire, casino, conversion.
• Ouvre une boutique par monnaie (prix, stock, date d'expiration).
• Propose un casino simple par monnaie (mise fixe ou libre, chance paramétrable, cooldown).
• Lie les monnaies entre elles avec un taux de conversion (monnaie dérivée → monnaie principale).
• Affiche un classement des plus riches.

Démarrage rapide (Admin)

1. Créez la monnaie : /monnaie creer id:gold nom:Or emoji:💰 (l'identifiant doit être en minuscules, lettres et chiffres uniquement).
2. Réglez les gains : /monnaie config_gain — choisissez la méthode (message, vocal, les deux), le gain, l'intervalle et le seuil de caractères.
3. Facultatif : limitez les gains à quelques salons avec /monnaie restriction.
4. Remplissez la boutique : /monnaie boutique_objet, ou l'onglet Boutique du dashboard.
5. Facultatif : configurez le casino avec /monnaie casino, et désignez un rôle de gestion avec /monnaie staff_role.
6. Publiez les panneaux dans un salon : /monnaie panneau type:👤 Panneau Utilisateur pour les membres, et type:🛠 Panneau Staff dans un salon réservé à l'équipe.

Commandes

Pour les membres

Commande	Description
/monnaie liste	Affiche toutes les monnaies configurées sur le serveur.
/monnaie classement	Classement des membres les plus riches d'une monnaie.
/monnaie conversions	Affiche les monnaies liées et leur taux de conversion.
/monnaie convertir	Convertit une monnaie dérivée vers sa monnaie principale.

Le solde, la boutique, l'inventaire et le casino ne passent pas par des commandes : ils s'utilisent depuis les boutons du panneau utilisateur.

Pour les administrateurs

Commande	Description
/monnaie creer	Créer une monnaie (identifiant, nom, emoji).
/monnaie config_gain	Régler les gains : méthode, montant, intervalle, seuil de caractères, limite.
/monnaie restriction	Restreindre les gains à un salon ou une catégorie.
/monnaie boutique_objet	Ajouter un objet à la boutique d'une monnaie.
/monnaie casino	Configurer le casino d'une monnaie (mode, mise, gain, chance, cooldown).
/monnaie staff_role	Désigner le rôle autorisé à utiliser le panneau staff.
/monnaie lier	Lier une monnaie dérivée à une monnaie principale avec un taux.
/monnaie panneau	Publier un panneau interactif (utilisateur ou staff) dans un salon.

Réglages depuis le dashboard

Le module « Multi-Monnaies » propose quatre onglets :

• Monnaies — création et modification complète d'une monnaie : nom, emoji, méthode de gain, gain et intervalle par message, seuil de caractères, limite quotidienne, gain et intervalle en vocal, salons et catégories autorisés, réglages casino (mode, cooldown, mise, gain, chance sous forme de numérateur/dénominateur) et lien de conversion vers une monnaie principale.
• Boutique — objets d'une monnaie donnée : nom, description, emoji, prix, stock (vide = illimité), date d'expiration.
• Soldes — les cent plus gros soldes d'une monnaie, avec possibilité d'ajuster un solde membre par membre (remplacer une valeur, ou ajouter/retirer un montant).
• Paramètres — le rôle staff autorisé à utiliser les boutons du panneau staff.

La publication des panneaux Discord reste une opération à faire depuis Discord avec /monnaie panneau : le dashboard ne poste pas de message à votre place.

Lien avec la boutique

Attention à ne pas confondre deux systèmes distincts :

• La boutique de ce module est intégrée : chaque monnaie a sa propre liste d'objets, l'achat se fait au bouton « 🛒 Boutique » du panneau utilisateur, le prix est débité immédiatement et l'objet part dans l'inventaire du membre. Il n'y a ni ticket ni validation.
• Le module « ShopDiscord » est un système séparé, avec sa propre monnaie appelée « points », ses rôles bonus, ses boosts et une validation par ticket à chaque achat. Si vous cherchez ce fonctionnement-là, allez voir la page ShopDiscord (Boutique & Points) de cette documentation.

Les deux peuvent coexister sur un même serveur, mais leurs soldes ne communiquent pas. Choisissez-en un pour votre économie principale, sinon vos membres ne sauront plus quelle monnaie sert à quoi.

Les monnaies de ce module alimentent aussi les mini-jeux de l'Activity et le module Défis & Cartes.

Bon à savoir

• Le dashboard affiche un avertissement « Module instable — en cours de développement ». Testez vos réglages avant de lancer une économie sur laquelle vos membres vont compter.
• Sans seuil de caractères, aucun gain par message n'est versé. Le calcul utilise ce seuil comme diviseur : un message de la longueur du seuil rapporte le gain complet, un message plus long rapporte proportionnellement plus, un message plus court proportionnellement moins. Si le seuil vaut 0, le gain vaut toujours 0. Mettez-y une valeur réaliste (par exemple 20 caractères).
• La « limite quotidienne » se compare au solde courant, pas aux gains du jour : au-delà de cette valeur, le membre ne gagne plus rien pour cette monnaie. Elle se comporte donc comme un plafond de solde. Laissez-la à 0 si vous ne voulez aucun plafond.
• L'intervalle est un anti-spam : un membre ne gagne au maximum qu'une fois par intervalle (en minutes), par monnaie. Ce compteur est gardé en mémoire et repart à zéro si le bot redémarre.
• Les gains vocaux sont vérifiés une fois par minute. Un gain vocal ne se déclenche que si le montant et l'intervalle vocal sont tous les deux renseignés.
• L'identifiant d'une monnaie n'est plus modifiable après création (le nom et l'emoji, oui). Choisissez-le court et parlant : il apparaît dans les sélecteurs de tous les autres modules.
• Supprimer une monnaie supprime tout ce qui va avec : soldes des membres, objets de boutique, historique de casino. C'est irréversible.
• Le casino doit être configuré monnaie par monnaie, sinon les membres reçoivent un message leur demandant de contacter un administrateur. En mode « fixe », la mise est imposée et obligatoire ; en mode « libre », le joueur choisit son montant.
• La conversion ne va que dans un sens : d'une monnaie dérivée vers sa monnaie principale. Une monnaie ne peut pas être liée à elle-même.
• Le panneau staff donne accès à l'ajout et au retrait de monnaie. Publiez-le dans un salon fermé, et n'attribuez le rôle staff qu'à des personnes de confiance : les administrateurs y ont accès de toute façon.
• Les objets de boutique dont la date d'expiration est passée sont supprimés automatiquement (vérification toutes les dix minutes).