Skip to Content
SUPREODocs
Communauté

Niveaux

Les membres gagnent de l'XP en discutant, montent de niveau et obtiennent des rôles de niveau, avec une carte de rang et un classement dans Discord et sur le web. Gratuit, avec plus de rôles de niveau et des options en Premium.

Le faire sur mon tableau de bord

Les niveaux récompensent les membres qui font vivre votre serveur. Chaque message rapporte de l'XP, l'XP s'additionne en niveaux, et les niveaux peuvent donner des rôles. Le système est désactivé tant que vous ne l'activez pas, sur la page Niveaux.

L'essentiel est gratuit : XP, niveaux, messages de passage de niveau, carte de rang, classement et sa page publique. Premium fait passer les rôles de niveau de 5 à 50 et ajoute les multiplicateurs d'XP, votre propre carte de rang et un classement qui se met à jour tout seul dans un salon.

Comment l'XP se gagne

  • Un message rapporte une quantité d'XP aléatoire dans la plage que vous réglez (15 à 25 par défaut).
  • Après un message qui rapporte de l'XP, les messages suivants du membre ne rapportent rien tant que le délai n'est pas écoulé (1 minute par défaut). Inonder le salon ne rapporte rien de plus.
  • Les bots ne gagnent jamais d'XP.

Les niveaux suivent la courbe commune à la plupart des bots de niveaux : niveau 1 à 100 XP, niveau 10 à 4 675 XP. Avec les réglages par défaut, le niveau 10 demande environ 234 messages qui rapportent de l'XP, soit environ quatre heures de discussion régulière.

Là où ça ne compte pas

  • Salons sans XP : choisissez des salons, ou une catégorie entière. Utile pour les salons de commandes, de spam ou de comptage.
  • Rôles sans XP : les membres qui ont l'un de ces rôles ne gagnent rien.

Passages de niveau

Quand un membre atteint un nouveau niveau, le bot peut l'annoncer :

Où
Là où il a écritDans le salon du message qui l'y a amené
Un seul salonTous les passages de niveau vont dans le salon choisi
En MPEn privé ; les membres aux MP fermés ne sont pas prévenus
Nulle partLes niveaux et les rôles comptent toujours, en silence

Le message est dans la langue du bot par défaut. Écrivez le vôtre avec {user} (une mention), {username}, {level} et {server}. Seul le membre est mentionné, jamais un rôle.

Rôles de niveau

Donnez un rôle quand un membre atteint un niveau : par exemple niveau 5 → Habitué, niveau 20 → Vétéran.

  • Avec Garder les rôles précédents activé, les membres gardent tous les rôles jusqu'à leur niveau. Désactivé, ils ne gardent que le plus élevé.
  • Le bot a besoin de la permission Gérer les rôles, et son propre rôle doit être au-dessus des rôles qu'il donne. Un rôle qu'il ne peut pas donner est ignoré.
  • Un membre parti puis revenu retrouve ses rôles à son prochain passage de niveau.

Multiplicateurs d'XP (Premium)

Donnez plus ou moins d'XP aux membres d'un rôle, ou dans un salon : ×0,25, ×0,5, ×1,5, ×2 ou ×3. Par exemple ×2 pour vos boosters, ou ×0,5 dans un salon de memes.

  • Un multiplicateur sur une catégorie couvre ses salons ; sur un salon, il couvre ses fils.
  • Le multiplicateur du salon et le meilleur multiplicateur de rôle du membre se combinent. Un membre qui a plusieurs bonus de rôle obtient le plus élevé, pas tous.
  • Un message rapporte toujours au moins 1 XP, et jamais plus de 500.

Votre propre carte de rang (Premium)

/rank dessine une carte avec l'avatar du membre, son rang, son niveau et sa progression. Avec Premium, vous pouvez y mettre votre propre image de fond (un lien https, environ 900 × 260), choisir sa couleur et assombrir l'image pour que le texte reste lisible. La page Niveaux affiche votre propre carte telle qu'elle apparaîtrait, avant d'enregistrer.

Classements

  • /leaderboard dans Discord, dix membres par page.
  • Page de classement publique : activez-la et toute personne qui a le lien supreo.xyz/leaderboard/<identifiant de votre serveur> voit le classement, avec les noms et avatars des membres sur le serveur. Elle est désactivée par défaut, et les moteurs de recherche ont pour consigne de ne pas l'indexer. Les serveurs gratuits affichent leur top 100 ; Premium affiche tout le monde.
  • Classement dans un salon (Premium) : choisissez un salon et le bot y tient à jour un message avec le top dix, vérifié toutes les 10 minutes et modifié quand le classement a changé. Si quelqu'un supprime le message, le bot le republie.

Commandes

CommandeQui
/rankTout le mondeVotre carte de niveau : rang, niveau et progression vers le suivant. Ajoutez un membre pour voir la sienne
/leaderboardTout le mondeLes membres les plus actifs, dix par page
/xp give, remove, set-level, resetGérer le serveurModifier l'XP d'un membre à la main ; ses rôles de niveau suivent

Vous pouvez désactiver une commande, ou ouvrir /xp à d'autres rôles, sur la page Permissions des commandes.

Importer depuis un autre bot

Sur la page Niveaux, Importer l'XP reprend les niveaux existants pour que personne ne reparte de zéro.

  • Depuis MEE6 : en un clic. Votre classement MEE6 doit être public pendant l'import (dans le tableau de bord de MEE6, section Leaderboard). MEE6 utilise les mêmes niveaux : chacun retrouve le sien, et ses récompenses de rôle peuvent être reprises comme rôles de niveau (dans la limite de votre offre). L'import lit la page de classement publique de MEE6 ; si MEE6 la modifie ou la bloque, l'import le signale et vous pouvez passer par une liste.
  • Depuis une liste : pour tout autre bot. Collez un membre par ligne, son identifiant Discord puis un nombre, séparés par une virgule, et indiquez si le nombre est de l'XP ou un niveau. Jusqu'à 20 000 lignes à la fois.

Par défaut, un membre garde la plus élevée entre son XP ici et celle importée : importer deux fois, ou après que les membres ont commencé à discuter, ne retire jamais d'XP. Activez Écraser pour la remplacer. Rien n'est annoncé pendant un import, et les rôles de niveau sont donnés au prochain passage de niveau de chaque membre.

Des giveaways pour les membres actifs

Un giveaway peut exiger un niveau minimum : les membres en dessous ne peuvent pas participer. Réglez-le dans Qui peut participer à la création du giveaway.

Repartir de zéro

Remettre l'XP de tous à zéro, sur la page Niveaux, ramène chaque membre à zéro. C'est irréversible. Les rôles déjà donnés restent sur les membres.

Bon à savoir

  • L'XP est enregistrée par lots, environ une fois par minute : /rank peut donc avoir jusqu'à une minute de retard sur un message que vous venez d'envoyer.
  • Désactiver les niveaux conserve l'XP de chacun ; les réactiver reprend là où vous en étiez.
  • L'XP d'un membre est conservée quand il quitte le serveur : un membre qui revient garde son niveau.