Niveaux avec AllBot

Le système est gratuit et désactivé par défaut. Un responsable du serveur l’active dans la catégorie Niveaux du dashboard. Tant qu’il est désactivé, ses réglages sont masqués et aucun nouveau point n’est gagné. Les réglages enregistrés sont appliqués par le bot sous 10 secondes.

Par défaut, chaque caractère Unicode du texte d’un nouveau message humain rapporte 1 XP, espaces et retours à la ligne compris. Vous pouvez choisir un autre ratio ou un montant fixe par message. Les messages privés, bots, webhooks et messages système sont toujours exclus. Modifier un message ne donne pas d’XP et le supprimer n’en retire pas. Il n’y a pas de délai entre les gains. Des récompenses de rôles peuvent être ajoutées aux niveaux de votre choix.

On commence au niveau 0. Il faut 100 XP pour atteindre le niveau 1, puis 200 XP supplémentaires pour atteindre le niveau 2, 400 pour le niveau 3, 800 pour le niveau 4, etc. Les seuils cumulés sont donc 100, 300, 700, 1 500… Le surplus d’XP est conservé et un même message peut faire gagner plusieurs niveaux.

L’XP est propre à chaque serveur et conservée après redémarrage du bot. Désactiver le module arrête les gains et les commandes de niveaux, sans supprimer l’XP déjà gagnée ; réactiver le module permet de reprendre la progression. Les nouveaux réglages ne recalculent pas les points passés.

Affiche dans un embed la mention et le niveau d’un membre humain du serveur. Une carte verticale de 600 × 800 pixels, bleue et blanche et utilisant la police Poppins des bannières AllBot, présente de haut en bas son avatar centré, son pseudo, sa position au format Rang #12, son niveau dans un médaillon encadré de lauriers, puis l’XP du palier, la barre de progression et l’XP restante avant le niveau suivant. L’XP totale figure en bas de la carte. Le libellé Votre progression, le nom du serveur et le pied de l’embed sont omis pour alléger l’affichage. Sans argument, la commande affiche votre propre progression.

Exemple : au niveau 3 avec 40 XP dans ce palier, la carte indique 40 / 800 XP et 760 XP avant le niveau 4.

Le rang est calculé parmi les membres humains encore présents sur le serveur, selon l’XP totale décroissante. À XP égale, l’identifiant du membre départage les positions comme dans /niveaux-classement. Les membres sans XP sont placés après ceux ayant gagné des points. Si le classement est momentanément indisponible, l’XP reste consultable et la carte indique Rang indisponible.

La commande est disponible uniquement sur un serveur ayant activé le module. Un membre sans XP est au niveau 0. Le résultat est publié dans le salon où la commande est utilisée et peut être consulté par les personnes ayant accès à ce salon. Une erreur de génération d’image conserve les informations écrites ; si les embeds sont interdits, le bot répond en texte.

Affiche un embed avec les dix membres humains présents sur le serveur ayant le plus d’XP, du premier au dixième. Chaque ligne affiche directement la mention du membre, puis son niveau et son total d’XP. À niveau égal, la progression dans le palier départage les membres ; à XP identique, l’identifiant du membre fixe un ordre stable.

Les bots et membres ayant quitté le serveur sont écartés. Le classement reste propre au serveur et n’affiche que les membres ayant gagné de l’XP. S’il y en a moins de dix, tous sont affichés. Aucun membre n’est notifié par le classement.

Choisissez entre Désactivée (aucun message, l’XP continue de progresser), Dans un salon personnalisé (sélectionnez un salon textuel ou d’annonces du serveur) et Dans le salon concerné (salon ou fil où le message déclencheur a été envoyé). Un message qui franchit plusieurs niveaux génère une seule annonce pour le niveau final.

Le message personnalisé apparaît au-dessus d’un embed contenant uniquement le titre Félicitations ! et une carte verticale de 600 × 800 pixels : avatar centré en haut, pseudo du membre, félicitations accompagnées de sa position Rang #12 et niveau atteint dans un médaillon encadré de lauriers. L’embed n’ajoute ni description ni pied de message et la carte n’affiche pas le nom du serveur. La carte reprend les couleurs configurées pour cette annonce. La prévisualisation occupe la moitié droite de la zone d’annonce sur ordinateur et toute la largeur en dessous des réglages sur mobile. L’image de cet aperçu est limitée à 280 pixels de haut et conserve ses proportions. Elle utilise votre profil Discord, un niveau et un rang de démonstration, sans publier de message. Si le bot ou l’image est indisponible, les réglages restent modifiables. Le bot conserve le résultat écrit si l’image ne peut pas être générée, avec le rang lorsqu’il est disponible. Les permissions Intégrer des liens et Joindre des fichiers sont nécessaires pour l’affichage complet.

Deux sélecteurs de couleur permettent de personnaliser séparément la bordure gauche de l’embed et le fond de la bannière. Sur ordinateur, ils sont côte à côte dans la colonne gauche, chacun sur la moitié de cette colonne. Choisissez une couleur dans la palette ou saisissez son code hexadécimal. L’aperçu se met à jour avant l’enregistrement ; Réinitialiser les couleurs rétablit la bordure bleue et l’image bleue d’origine. Le bouton Voir les variables ouvre les explications sans répéter leur liste sous le message. Ces réglages sont distincts de ceux des récompenses et des invitations.

Le message accepte les variables {member.mention}, {member.username}, {member.name}, {member.id}, {level}, {xp}, {xp.required}, {xp.remaining} et {server.name}. Les trois variables d’XP correspondent au palier courant, après le passage de niveau. Un message vide utilise le texte par défaut.

AllBot doit pouvoir voir le salon et y envoyer des messages ; dans un fil, il doit disposer de la permission d’y écrire et le fil doit être ouvert. Une annonce impossible à envoyer ne retire pas l’XP gagnée. Seul le membre concerné peut être notifié, même si le texte contient @everyone ou une mention de rôle. Le message envoyé est limité à 2 000 caractères Discord après remplacement des variables.

Le système conserve les identifiants du serveur et du membre ainsi que le total d’XP. Le contenu des messages est lu pour être compté, sans être archivé par ce module. Des reçus techniques contenant uniquement le serveur et l’identifiant du message empêchent les doubles gains et sont purgés après sept jours lors de la maintenance du bot.

Le mode Selon le nombre de caractères permet de régler deux facteurs : le nombre de caractères et la quantité d’XP correspondante. Le gain est proportionnel à la longueur du texte et arrondi à l’entier inférieur pour chaque message. Par exemple, 3 caractères avec un ratio de 2 caractères pour 3 XP rapportent 4 XP ; les fractions ne sont pas reportées au message suivant.

Le mode Montant fixe par message attribue le montant choisi à chaque nouveau message humain admissible, qu’il contienne 20 ou 2 000 caractères. Les messages contenant uniquement une pièce jointe comptent aussi dans ce mode ; sans texte, ils ne rapportent rien dans le mode par caractères.

La quantité d’XP doit être un entier de 1 à 1 000 000. Le nombre de caractères doit être un entier de 1 à 10 000. Les filtres de rôles et de salons s’appliquent dans les deux modes. Les seuils des niveaux restent 100, 200, 400, 800 XP supplémentaires, etc.

Chaque liste accepte jusqu’à 100 rôles ou salons du serveur. Une liste vide ne crée aucune restriction, quel que soit l’état de son bouton.

Les sélecteurs Rôles avec / sans gain d’expérience et Salons avec / sans gain d’expérience sont côte à côte sur ordinateur et empilés sur mobile. Chaque interrupteur est placé près du titre ; le mot actif est mis en gras et l’autre atténué.

Pour les rôles, le mode avec réserve les gains aux membres possédant au moins un des rôles sélectionnés. Le mode sans empêche les membres possédant au moins un de ces rôles de gagner de l’XP.

Pour les salons, le mode avec réserve les gains aux salons sélectionnés ; le mode sans y interdit l’XP. Les fils d’un salon ou d’un forum sélectionné suivent le même réglage.

Les deux filtres se cumulent : le membre et le salon doivent tous les deux être admissibles. Quand les rôles nécessaires ne peuvent pas être vérifiés, le bot ne crédite pas d’XP pour le message concerné. Ces filtres concernent les gains ; ils ne masquent pas les commandes de consultation.

Créez jusqu’à 50 récompenses gratuites par serveur. Dans l’éditeur, choisissez le niveau requis, le rôle, une éventuelle durée et la manière de le conserver aux prochains paliers. Ajoutez la règle à la liste, puis enregistrez la configuration générale du serveur. Chaque rôle ne peut être utilisé que dans une seule règle. Avec les seuils et la capacité d’XP actuels, les niveaux de récompense vont de 1 à 57.

En complément : le membre conserve ce rôle avec ses autres récompenses, jusqu’à son éventuelle expiration. Progression par paliers : une progression commune remplace les précédents rôles de paliers accordés par le module. Un seul rôle par niveau est accepté dans cette progression. Lorsqu’un message franchit plusieurs paliers, seul le plus élevé est attribué dans cette progression ; les récompenses En complément déjà accessibles sont toutes accordées.

Un rôle à durée limitée accepte de 1 minute à 365 jours, en minutes, heures ou jours. Le bot suit son échéance après redémarrage et continue les retraits prévus même si le module Niveaux est ensuite désactivé. Chaque récompense ne se gagne qu’une fois par membre : son expiration ne la rend pas de nouveau disponible.

Les membres ayant déjà le niveau requis reçoivent les nouvelles récompenses à leur prochain message autorisé par les filtres de rôles et de salons, même sans passage de niveau. Modifier une règle ne réattribue pas une récompense déjà obtenue. Supprimer une règle ne retire pas les rôles déjà accordés ; les durées déjà engagées restent suivies. Supprimer puis recréer une règle crée une nouvelle récompense.

AllBot doit posséder Gérer les rôles et son rôle le plus élevé doit être placé au-dessus du rôle à offrir. Les rôles gérés par Discord, les intégrations et les rôles inaccessibles ne sont pas sélectionnables. Un rôle que le membre possédait déjà avant la récompense est conservé. Lorsqu’un nouveau rôle ne peut pas être ajouté, l’ancien palier reste en place ; un retrait empêché par les permissions est retenté.

Les annonces de récompenses se règlent séparément des annonces de niveaux : désactivées, dans le salon du message déclencheur ou dans un salon personnalisé, avec un texte personnalisable. Leur carte verticale de 600 × 800 pixels présente l’avatar en haut, puis le pseudo, le niveau requis pour la récompense dans un médaillon encadré de lauriers et le rôle obtenu, avec les couleurs configurées pour les récompenses et sans nom de serveur. Seul le membre concerné peut être notifié ; le rôle affiché ne notifie pas ses membres. Une annonce indisponible n’annule pas le rôle obtenu.

Les cartes affichent le rôle dans sa couleur Discord, avec Configurer à gauche de Retirer, à droite sur ordinateur. Les annonces de récompenses disposent de leurs propres couleurs de bordure d’embed et de fond de bannière, ainsi que d’un aperçu sous la liste des récompenses, dans la colonne droite sur ordinateur. Cet aperçu utilise la première récompense configurée. Les symboles Unicode et les émojis, y compris les séquences composées, sont rendus à l’aide de polices intégrées au bot. Réinitialiser les couleurs retrouve le style bleu d’origine. Enregistrez la configuration pour appliquer ces changements.

Le message accepte les variables de niveaux et {reward.role} (mention du rôle), {reward.name}, {reward.level} (niveau requis), {reward.duration} et {reward.expires} (échéance relative ou Sans échéance).