Niveaux
DisponibleXP au message et en vocal, classement du serveur et rôles de palier.
Comment l’XP se gagne
Chaque message rapporte un montant tiré au hasard dans un intervalle réglable, une fois par période de calme. Sans ce délai, le classement récompenserait le flood plutôt que la présence.
| Réglage | Par défaut |
|---|---|
xpPerMessage | Entre 15 et 25 XP |
cooldownSeconds | 60 secondes |
multiplier | 1, pour accélérer ou ralentir la progression |
noXpChannelIds | Aucun salon exclu |
noXpRoleIds | Aucun rôle exclu |
Le temps en vocal
Une fois activé, le bot compte le temps de chacun dans les salons vocaux, à la minute. Trois usages, chacun sur son interrupteur : de l'XP par tranche de temps, qui nourrit les mêmes niveaux et les mêmes rôles que les messages ; des rôles par palier d'heures cumulées ; et un rôle remis chaque lundi aux plus présents de la semaine, avec un podium dans le salon de votre choix.
| Réglage | Par défaut |
|---|---|
voiceTime.xpPerInterval | Entre 15 et 25 XP par tranche |
voiceTime.intervalMinutes | 5 minutes |
voiceTime.milestones | Aucun palier, par exemple 10 h, 50 h, 100 h |
voiceTime.weekly | Le top 3, le lundi à 18 h, dans le fuseau choisi |
voiceTime.minMembers | 1 : le temps compte même seul |
voiceTime.dailyCapMinutes | 0 : pas de plafond |
Par défaut, tout le temps compte. Pour les serveurs qui le veulent, quatre garde-fous existent : un minimum de personnes dans le salon, ignorer le salon AFK, ignorer la sourdine casque, et un plafond par jour. Les salons exclus et les rôles sans XP ne comptent jamais.
Avec publicLeaderboard, le classement devient une page publique à partager : axaro.net/classement/<serveur>, avec l'XP, le vocal et la semaine en cours.
La courbe
Le coût d'un niveau croît au carré : les premiers tombent vite, les suivants se méritent. La formule est figée plutôt que configurable, parce qu'en changer après coup reclasserait tout le monde. Le rythme se règle par le multiplicateur.
| Niveau | XP cumulée |
|---|---|
5 | ≈ 1 200 XP |
10 | ≈ 5 000 XP |
25 | ≈ 45 000 XP |
50 | ≈ 300 000 XP |
Les rôles de palier
Un palier associe un niveau à un rôle. La recompense peut retirer celles des paliers inférieurs, pour ceux qui veulent un seul rôle visible à la fois plutôt qu'une collection.
Tout est calculé avant d'écrire : un seul appel à Discord plutôt qu'un ajout suivi d'un retrait, donc aucun instant où le membre n'aurait ni l'ancien rôle ni le nouveau. Les rôles hors de portée du bot sont ignorés.
Les commandes
| Commande | Effet |
|---|---|
/rank | Niveau, rang, messages et barre de progression |
/leaderboard | Classement du serveur, dix par page : XP, vocal ou semaine |
/voicetime | Temps en vocal, rang, semaine et prochain palier |
/topvocal | Le top 10 du vocal en une carte : podium, qui est en vocal, ta place |
/xp give | Ajoute de l’XP à un membre |
/xp set | Fixe son XP totale |
/xp reset | Le remet à zéro |
Départs et retours
Un membre qui part sort du classement sans perdre son XP : la ligne reste, seule sa date de départ change. S'il revient, il retrouve exactement où il en était. Un classement peuplé de gens partis n'intéresse personne.
La carte de rang
/rank répond par une carte en image : l’avatar, le niveau, le rang et la barre de progression. Le réglage « /rank en image » la remplace par l’embed habituel.