Récompenser l'activité avec les niveaux et l'XP

Tes membres discutent, passent du temps en vocal… et si ça leur rapportait quelque chose ? 🏆 Le module Levels donne de l'XP à chaque message et à chaque minute passée en vocal, fait monter les membres de niveau, annonce leurs progrès et peut leur donner des rôles automatiquement. Chacun peut afficher sa carte de rang, et un classement est disponible sur Discord comme sur le dashboard.

1. Activer le module

Sur le dashboard, choisis ton serveur puis ouvre Levels dans la rubrique Modules du menu de gauche. Active le module avec l'interrupteur en haut de la page.

2. Régler le gain d'XP

Dans la section Gain d'XP :

• XP par message : l'XP gagnée pour un message (15 par défaut).
• XP par minute vocal : l'XP gagnée pour chaque minute complète passée en vocal (5 par défaut). Elle est comptée quand le membre quitte le salon vocal.
• Cooldown messages (sec) : le délai minimum entre deux gains d'XP par message (60 secondes par défaut). Envoyer 10 messages en 10 secondes ne rapporte donc qu'une seule fois de l'XP : c'est l'anti-spam intégré.

Mets une valeur à 0 pour couper un type de gain (par exemple, 0 en vocal si tu ne veux récompenser que l'écrit).

3. Choisir la courbe d'expérience

La section Courbe d'expérience décide combien d'XP il faut pour passer chaque niveau. Trois Types de courbe :

• Constante : chaque niveau coûte exactement la même quantité d'XP.
• Linéaire : l'XP nécessaire augmente avec le niveau, la difficulté monte doucement.
• Exponentielle : chaque niveau coûte nettement plus que le précédent, idéal pour récompenser la persévérance. Un champ Exposant apparaît (1,05 minimum, 3 maximum).

Règle ensuite :

• XP de base : le coût du niveau 1, qui sert de multiplicateur pour les autres.
• Niveau maximum : le plafond de ton serveur (jusqu'à 1000). Une fois ce niveau atteint, le membre ne gagne plus d'XP.

L'Aperçu de la courbe se met à jour en direct : sers-t'en pour vérifier que les premiers niveaux restent accessibles.

4. Annoncer les passages de niveau

Dans Annonce de level-up, laisse Activer les annonces coché pour féliciter tes membres à chaque nouveau niveau.

• Annoncer dans le salon du message activé : le message part dans le salon où le membre vient d'écrire. Le Salon de repli (vocal) sert uniquement aux niveaux gagnés en vocal.
• Désactivé : toutes les annonces vont dans le Salon d'annonce que tu choisis.

Personnalise le Template du message avec ces variables :

• {user} : la mention du membre
• {username} : son pseudo, sans mention
• {level} : le niveau atteint
• {server} : le nom du serveur

Exemple :

🎉 GG {user}, tu passes niveau **{level}** sur {server} !

5. Donner des rôles en récompense

La section Récompenses de niveau donne automatiquement un rôle quand un membre atteint un palier (jusqu'à 50 récompenses) :

1. Indique le Niveau.
2. Choisis le rôle.
3. Clique sur Ajouter.

Plusieurs rôles peuvent partager le même niveau. L'option Cumuler les récompenses change le comportement :

• Activée : le membre garde les rôles de tous les paliers atteints.
• Désactivée : seul le rôle du palier le plus haut est gardé, les précédents sont retirés.

Un palier ajouté après coup est rattrapé au prochain passage de niveau du membre.

6. Exclure des salons ou des rôles

• Salons sans XP : les messages écrits dans ces salons ne rapportent rien (pratique pour un salon de spam, de commandes ou de jeux).
• Rôles sans XP : les membres qui ont un de ces rôles ne gagnent aucune XP, ni en écrit ni en vocal.

7. Carte de rang et classement

Tes membres ont deux commandes :

• /rank : affiche sa carte de rang en image (niveau, XP, progression vers le niveau suivant et position dans le classement). Ajoute l'option user pour voir celle d'un autre membre.
• /level top : affiche le classement du serveur (10 membres par défaut, entre 3 et 25 avec l'option limit).

Sur le dashboard, la page Classement XP (rubrique Général du menu) affiche tout le classement avec le niveau et l'XP de chacun.

Commandes de gestion

• /level add type:<XP ou Niveaux> montant:<nombre> membre:<membre> : ajoute de l'XP ou des niveaux à un membre. Permission Gérer le serveur.
• /level remove type:<XP ou Niveaux> montant:<nombre> membre:<membre> : en retire. Permission Gérer le serveur.
• Remplace membre par tous:True pour modifier tout le serveur d'un coup. Réservé au propriétaire et aux administrateurs, avec un bouton Confirmer à valider dans la minute. Cette action est irréversible.

Les rôles de récompense sont mis à jour automatiquement après ces modifications.

Erreurs fréquentes

• « Le module Levels est désactivé sur ce serveur » : active le module sur le dashboard.
• Un rôle de récompense n'est jamais donné : vérifie que le rôle de HurixBot est au-dessus de ce rôle.
• Pas d'XP en vocal : l'XP vocale est ajoutée quand le membre quitte le salon, et seulement pour les minutes complètes.

Pour aller plus loin : organise un concours réservé aux membres actifs avec le tutoriel Giveaways.