Le système de niveaux récompense l'activité : chaque message et chaque minute passée en vocal rapportent de l'XP, l'XP fait monter de niveau, chaque niveau peut débloquer un rôle, et le bot annonce les passages de niveau avec une carte. Les règles et les réglages sont exactement ceux de la version Discord.
Les réglages se font sur la page Niveaux du tableau de bord ; les commandes sont décrites dans Niveaux et classements.
Activer le système de niveaux
Le système est désactivé à l'arrivée du bot. Active-le sur la page Niveaux du tableau de bord : l'XP se compte dès l'activation, et !rank, !top, !modify-xp et !reset-levels deviennent utilisables. Désactiver le système arrête le comptage ; l'XP des membres est conservée.
Gagner de l'XP en écrivant
Les conditions, le calcul et le délai entre deux messages.
Chaque message envoyé dans un salon de la communauté peut rapporter de l'XP. Les messages privés ne comptent pas. Pour chaque message, le bot applique ces règles dans l'ordre :
- Système actif : sinon, rien n'est compté.
- Qui : les bots, les webhooks et les comptes blacklistés de Dispatch.IO ne gagnent rien, ni un message bloqué par l'anti-raid.
- Délai de 2 secondes entre deux messages qui rapportent de l'XP.
- Contenu : le bot retire les mentions, les liens et les emojis. S'il ne reste rien, le message ne rapporte rien.
- Calcul : un nombre entier d'XP au hasard entre l'XP textuelle min et l'XP textuelle max (5 et 15 par défaut).
- Message court : moins de 5 mots ou moins de 20 caractères, l'XP est divisée par deux.
Gagner de l'XP en vocal
Un membre gagne l'XP vocale (20 par défaut) pour chaque minute passée dans un salon vocal de la communauté, salons vocaux temporaires compris. Changer de salon relance le compteur ; quitter le vocal l'arrête. Quand le bot redémarre, il reprend le comptage des membres déjà en vocal. Les bots et les comptes blacklistés ne gagnent rien.
La courbe des niveaux
La formule et les paliers d'XP.
Le niveau dépend de l'XP totale (messages + vocal) : il faut 100 × niveau² XP pour atteindre un niveau.
| Niveau | XP totale | Niveau | XP totale |
|---|---|---|---|
| 1 | 100 | 10 | 10 000 |
| 2 | 400 | 15 | 22 500 |
| 3 | 900 | 20 | 40 000 |
| 5 | 2 500 | 30 | 90 000 |
| 7 | 4 900 | 50 | 250 000 |
L'annonce de passage de niveau
Le message et la carte publiés quand un membre monte de niveau.
Un passage de niveau est détecté après un message, une minute de vocal ou un giveaway qui offre de l'XP. Le bot donne d'abord les rôles récompenses, puis publie l'annonce dans le salon de notifications, dans la langue de la communauté :
- « Bravo à @Alex, qui a atteint le niveau 12 ! » (ou « Nouveau rôle débloqué pour @Alex : Niveau 10 » quand une récompense existe pour ce niveau) ;
- la carte de niveau : avatar, « LEVEL UP », XP totale, barre de progression vers le niveau suivant, trophée avec le niveau ;
- le lien Afficher le profil, vers la page publique du membre sur le site (sur Discord, c'est un bouton).
Le fond de la carte est le premier disponible parmi : le fond personnel du membre (offre Individuel), l'image de niveau de la communauté, son image de bienvenue, puis l'image par défaut. Sans salon de notifications, aucune annonce n'est publiée, mais l'XP et les rôles fonctionnent.
Les récompenses de rôles
Donner un rôle à un niveau donné, de façon permanente ou provisoire.
Une récompense associe un rôle à un niveau (de 1 à 999, un seul rôle par niveau). À chaque passage de niveau, le bot passe en revue toutes les récompenses :
- Récompense normale : le rôle est donné si le nouveau niveau est supérieur ou égal au sien. Les rôles s'additionnent et ne sont jamais retirés automatiquement.
- Récompense provisoire (communauté Basic ou Ultimate) : le rôle est donné en atteignant ce niveau précis, puis retiré au niveau suivant.
Les récompenses ne sont vérifiées qu'aux passages de niveau
Une récompense ajoutée pour le niveau 5 alors qu'Alex est déjà niveau 8 lui sera donnée à son prochain passage de niveau. Il en va de même après !modify-xp. Supprimer une récompense ne retire pas le rôle à ceux qui l'ont.
Pour donner un rôle, le bot a besoin de Gérer les rôles et le rôle doit être placé sous le rôle du bot (à position égale, le plus ancien l'emporte).
Classements et suivi de l'XP
| Outil | Ce qu'il montre ou permet |
|---|---|
!rank | La carte de rang d'un membre : position, niveau, XP |
!top | Le classement de la communauté, 10 membres par page |
| Classement public du site | Le classement sur le site, et la page de profil de chaque membre (Classements et cartes de rang) |
!modify-xp, !reset-levels | Corriger ou remettre à zéro l'XP (administrateurs) |
| Page Membres & XP du site | La liste des membres classés par XP, avec modification et remise à zéro |
Réglages, valeurs par défaut et Premium
| Réglage | Par défaut | Valeurs |
|---|---|---|
| Activer les niveaux | Désactivé | Actif ou inactif |
| Salon de notifications | Aucun | Un salon textuel |
| XP vocale | 20 | 1 à 50 par minute |
| XP textuelle min — max | 5 — 15 | 1 à 50, max strictement supérieur au min |
| Récompenses de rôles | Aucune | Un rôle par niveau, niveaux 1 à 999 |
| Rôle provisoire | Non | Communauté Dispatch.IO Basic ou Ultimate |
| Image de niveau | Aucune | PNG, JPG, WEBP ou GIF |
Problèmes fréquents
| Problème | Cause probable et solution |
|---|---|
!rank répond que les niveaux sont désactivés | Active le système sur le tableau de bord. |
| Aucune annonce de niveau | Pas de salon de notifications, ou permissions du bot manquantes dans ce salon (Envoyer des messages, Joindre des fichiers). |
| Un membre n'a pas reçu son rôle | Rôle au-dessus du rôle du bot, Gérer les rôles absente, ou récompense ajoutée après son passage de niveau. |
| Un membre spamme mais gagne peu | Normal : un message toutes les 2 secondes au maximum compte, et les messages courts sont divisés par deux. |
Après !modify-xp, rien n'a été annoncé | Les modifications manuelles ne déclenchent ni annonce ni rôles. |