Niveaux et XP

Le système est désactivé sur un nouveau serveur. Active-le avec l'interrupteur Activer les niveaux de la page Niveaux du site, ou avec le bouton Activer de la catégorie Système de niveau de /config (voir Configuration du bot).

À l'activation :

• les membres commencent à gagner de l'XP ;
• les commandes /rank, /modify-xp et /reset-levels apparaissent sur le serveur.

À la désactivation, l'XP n'augmente plus, ces trois commandes disparaissent et les giveaways en cours qui offrent de l'XP sont annulés. L'XP déjà gagnée est conservée.

Chaque message envoyé dans un salon du serveur peut rapporter de l'XP : salons textuels, fils, posts de forum et discussions des salons vocaux. Les messages privés ne comptent pas. Il n'existe pas de salon ni de rôle exclu.

Pour chaque message, le bot applique ces règles dans l'ordre :

1. Système actif : si les niveaux sont désactivés, rien n'est compté.
2. Qui : les bots, les messages système et les membres blacklistés de Dispatch.IO ne gagnent rien. Un message bloqué par l'anti-raid non plus.
3. Délai de 2 secondes : après un message, il faut attendre environ 2 secondes avant qu'un nouveau message rapporte de l'XP. Le délai repart à chaque message, même s'il n'a rien rapporté.
4. Contenu : le bot retire du texte les mentions (membres, rôles, @everyone, @here), les liens et les emojis Unicode (😀). S'il ne reste rien, le message ne rapporte rien. C'est le cas d'un message composé uniquement d'emojis, de liens ou de mentions, ou d'une image sans texte.
5. Calcul : le message rapporte un nombre entier d'XP au hasard entre l'XP textuelle min et l'XP textuelle max (5 et 15 par défaut, bornes comprises).
6. Message court : si le texte restant fait moins de 5 mots ou moins de 20 caractères, l'XP est divisée par deux (arrondie à l'entier inférieur).

Exemples avec les réglages par défaut

Un membre gagne de l'XP tant qu'il est connecté à un salon vocal du serveur, y compris dans les salons vocaux temporaires :

• toutes les 60 secondes passées en vocal, il reçoit l'XP vocale (20 par défaut) ;
• la première XP arrive après une minute complète ;
• changer de salon vocal relance le compteur : la minute commencée est perdue ;
• quitter le vocal arrête le compteur ;
• la valeur d'XP vocale est celle en vigueur au moment où le membre a rejoint le vocal : si tu la modifies, le changement s'applique à sa prochaine connexion.

Le bot ne regarde pas si le membre a coupé son micro ou son casque, ni s'il est seul dans le salon. Les bots et les membres blacklistés de Dispatch.IO ne gagnent rien. Quand le bot redémarre, il reprend le comptage des membres déjà en vocal.

Le niveau dépend de l'XP totale du membre sur le serveur, c'est-à-dire son XP de messages + son XP vocale :

niveau = partie entière de √(XP totale ÷ 100)

Autrement dit, il faut 100 × N² XP au total pour atteindre le niveau N, et chaque niveau demande un peu plus que le précédent (100 × (2N + 1) XP entre le niveau N et le niveau N + 1).

Avec les réglages par défaut, le niveau 10 représente environ 1 000 messages normaux, ou 8 h 20 en vocal. L'XP de messages et l'XP vocale ne descendent jamais sous 0.

L'XP et les niveaux sont propres à chaque serveur : un membre repart de zéro sur un autre serveur.

Un passage de niveau est détecté quand l'XP totale atteint un nouveau palier après un message, une minute de vocal ou un giveaway qui offre de l'XP (voir Sondages, giveaways et suggestions). Le bot donne d'abord les rôles de récompense, puis publie l'annonce.

L'annonce est publiée dans le salon de notifications (Salon de notifications sur le site, Salon des notifications dans /config), dans la langue du serveur :

• le texte « Bravo à @Alex, qui a atteint le niveau 12 ! », qui mentionne le membre ;
• la carte de niveau ;
• un bouton Afficher le profil qui ouvre la page publique du membre sur le site (sa carte de niveau et l'historique de ses flammes).

Si une récompense de rôle est prévue pour ce niveau précis, le texte devient « Nouveau rôle débloqué pour @Alex : Niveau 10 ». Le nom du rôle est écrit en clair : le rôle lui-même n'est pas mentionné.

Si un membre gagne plusieurs niveaux d'un coup (par exemple avec un giveaway d'XP), une seule annonce est publiée, pour le niveau atteint.

La carte de niveau

La carte (1200 × 400 pixels) montre l'avatar du membre dans un polaroïd, l'étiquette « LEVEL UP », son XP totale, le titre « BIEN JOUÉ ! », une barre de progression vers le niveau suivant (pourcentage et XP qu'il reste, par exemple « 1 250 XP → NIV. 13 ») et un trophée avec le numéro du niveau.

Le fond est le premier disponible parmi : le fond personnel de carte de niveau du membre (offres personnelles, réglé dans ses préférences du site), l'Image de niveau du serveur (site uniquement), l'image de bienvenue du serveur, puis l'image par défaut de Dispatch.IO.

Une récompense associe un rôle à un niveau (de 1 à 999, un seul rôle par niveau). Elle se règle sur le site (Récompenses de rôles) ou dans /config (Récompenses).

À chaque passage de niveau, le bot passe en revue toutes les récompenses du serveur :

• Récompense normale : le rôle est donné si le nouveau niveau est supérieur ou égal au niveau de la récompense. Les rôles s'additionnent : un membre au niveau 20 garde ceux des niveaux 5, 10 et 15. Un rôle normal n'est jamais retiré automatiquement, même si l'XP du membre baisse ou est remise à zéro.
• Récompense provisoire (Rôle provisoire, réglable sur le site uniquement) : le rôle est donné uniquement en atteignant ce niveau précis, puis retiré dès que le membre atteint un niveau plus haut. Exemple : rôle provisoire au niveau 26 → donné au niveau 26, retiré au niveau 27.

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 le plus haut du bot. Dans /config, les rôles trop hauts ou gérés par une intégration sont refusés. Un rôle supprimé de Discord est ignoré.

Les modifications d'XP faites par un administrateur (/modify-xp, /reset-levels, page Membres & XP) ne déclenchent ni annonce ni changement de rôles. Une remise à zéro ne retire pas les rôles de récompense déjà obtenus.

Certaines valeurs ne se règlent pas par serveur : le délai de 2 secondes entre deux messages, le seuil des messages courts (5 mots ou 20 caractères) et l'intervalle d'une minute en vocal.

Offres Premium

Un serveur choisi comme emplacement Ultimate d'un abonnement Individuel Ultimate compte comme Ultimate. Sans offre Basic ou Ultimate, les récompenses marquées provisoires restent enregistrées mais se comportent comme des récompenses normales ; elles redeviennent provisoires au renouvellement. Il n'existe pas de bonus ou de multiplicateur d'XP. Le détail des offres est sur Offres Premium et limites.

Pour aller plus loin : Flammes (séries), l'autre module d'engagement, et Permissions et rôles.