Scoreboards Documentation

Scoreboards n'a besoin que d'une poignée de permissions Discord, et un serveur aux réglages par défaut les accorde déjà. Celles qui comptent se règlent par salon — un bot peut être autorisé dans un salon et exclu du suivant —, donc quand un leaderboard cesse de se mettre à jour, c'est ici qu'il faut regarder d'abord.

Dans le salon du leaderboard

• View Channel et Read Message History — pour retrouver son propre message de leaderboard et le modifier. Sans elles, le leaderboard ne se rafraîchit que lorsque quelqu'un lance /leaderboard show : une commande slash obtient une réponse même là où le bot ne peut pas lire, une modification non.
• Send Messages — pour publier le leaderboard, et te prévenir quand quelque chose cloche.
• Embed Links et Attach Files — le leaderboard est une image avec une légende dessous. Sans Attach Files, l'image disparaît ; sans Embed Links, la légende et le tableau de secours.
• Create Private Threads et Send Messages in Threads — les fils de match des leaderboards ELO et League s'ouvrent ici.

Dans le salon de log

Le même ensemble. Les soumissions y sont publiées pour relecture et le bot les modifie quand elles sont approuvées ou rejetées ; les entrées image sont des pièces jointes. Si le salon du leaderboard ne peut pas accueillir un fil de match, il s'ouvre ici. Si le bot ne peut pas écrire dans le salon de logs, il publie dans le salon du leaderboard un court avertissement qui indique la permission manquante, avec un lien pour valider l'envoi dans le tableau de bord.

Sur tout le serveur

• Manage Roles — pour les Tier Roles, les rôles vendus dans la boutique, les rôles de rang automatiques des leaderboards ELO et le rôle de notification de la file. Le rôle Scoreboards doit aussi se trouver au-dessus de tous les rôles qu'il attribue, dans Server Settings → Roles.
• Change Nickname — seulement si tu renommes le bot dans Serveur → Identité du bot.
• Manage Channels, Connect et Move Members — seulement pour les salons vocaux du matchmaking, et seulement dans la catégorie où se trouve le salon de log.

Le lien Add to Discord demande View Channel, Send Messages, Embed Links, Attach Files, Read Message History, Create Private Threads, Manage Threads, Manage Roles et Send Messages in Threads. Tout le reste vient des réglages @everyone par défaut de ton serveur ou des rôles que tu donnes au bot — un serveur qui a verrouillé @everyone doit donc accorder ces permissions au bot lui-même, par salon ou sur son rôle.

Quand une permission manque, le bot le dit au lieu d'échouer en silence : un message dans le salon du leaderboard pour Embed Links, Attach Files et un tier role qu'il ne peut pas attribuer, et un dans le salon de log quand il n'atteint pas le leaderboard du tout.

Il y a deux chemins :

• Dans Discord, clique sur le bouton d'envoi du message du leaderboard — il s'appelle Submit score sur Classic/Highscore/Time, Submit result sur ELO et League, Submit image sur Rating. Le bot ouvre le flux qui correspond au type : une saisie de score, un sélecteur joueurs + vainqueur, un sélecteur joueurs + score, ou un nom accompagné de l'image elle-même. Sur un leaderboard en équipes, il te demande la composition complète de chaque camp au lieu d'un seul joueur, et un leaderboard free-for-all porte un bouton Report result à la place.
• Ou ouvre le leaderboard sur le site et clique sur Submit — exactement le même flux, et le seul chemin qui accepte un nom libre, pour les joueurs qui ne sont pas sur ton Discord.

La validation

1. L'envoi est posté dans le salon de logs, si tu en as défini un.
2. Un validateur ou un admin clique sur Approve ou Reject. Sur les matchs ELO et League, l'adversaire est d'abord sollicité — voir Confirmation par l'adversaire plus bas. Tout autre leaderboard sans salon de logs valide les envois immédiatement ; configure un salon de logs pour les valider d'abord.
3. En cas de refus, l'auteur reçoit un DM avec le motif.
4. En cas d'approbation, le leaderboard se met à jour immédiatement.

Confirmation par l'adversaire (ELO et League)

Quand un match est signalé sur un leaderboard ELO ou League d'un serveur, le bot ouvre un fil de match privé avec celui qui l'a signalé et l'adversaire, et y mentionne l'adversaire avec les boutons Confirmer et Contester — tous ceux qui ne sont pas du côté de celui qui a signalé, ou, si quelqu'un qui n'a pas joué l'a signalé, le camp qui a perdu (les deux camps en cas de match nul). Un coéquipier ne peut pas confirmer le résultat de sa propre équipe, et celui qui a signalé ou le staff peut le Retirer. Si personne ne répond, le match compte tout seul à l'échéance : 3 heures sur les nouveaux leaderboards. Le formulaire de signalement met d'office celui qui signale en joueur 1.

Contester envoie le match au staff : un admin, toute personne avec Manage Server, le rôle de validateur ou le rôle de permission du bot. Tout se passe dans le même fil : le rôle de validateur y est ajouté et mentionné ou, si le serveur n'en a pas, un admin tranche. Si personne ne tranche sous 48 heures, il est refusé. Les matchs des leaderboards personnels sur le site comptent toujours immédiatement.

Validation automatique

Chaque leaderboard peut approuver les envois tout seul après un certain délai : Off, Instant, 1 hour, 3 hours, 24 hours, 3 days ou 7 days. Sur ELO et League, c'est le temps dont l'adversaire dispose pour confirmer ou contester. Les nouveaux leaderboards ELO et League démarrent à 3 heures ; les anciens gardent leur réglage. Sur un leaderboard ELO ou League sans salon de logs, Off veut aussi dire 3 heures, car il n'y a aucun salon de staff d'où valider.

Annuler un score

Admins et validateurs peuvent revenir sur un score déjà approuvé : clic droit sur le message de l'envoi, puis "Cancel Review". Le score est rétabli comme avant et un motif d'annulation est demandé.

Le type de leaderboard ELO - Ranked classe les joueurs selon un rating ELO, en 1v1 ou en équipes allant jusqu'à huit joueurs par camp.

Tout ce que fait un leaderboard ELO

• Une file de matchmaking avec ready-check, un fil privé par match et un bouton Join Voice.
• Confirmation par l'adversaire : l'autre camp confirme ou conteste, et le match compte tout seul au bout de 3 heures.
• Défie un joueur directement, avec un bouton de revanche dans le fil du match après chaque 1v1.
• Équipes de 2v2 à 8v8, équipes fixes et chacun pour soi de 3 à 8 joueurs avec classement à l'arrivée.
• Facteur K et rating de départ réglables, decay optionnel et saisons.
• Rôles de rang automatiques de Bronze à Diamant, avec chaque promotion annoncée au joueur en DM.
• Une ligne de résultat dans le fil du match après chaque match, avec la variation de rating et le nouveau rang.
• Un tableau de bord web et une page par board avec les stats de chaque joueur et l'historique de rang.
• Des tournois dont les matchs comptent sur le leaderboard.

Matchs en équipe (2v2 – 8v8)

Les leaderboards ELO et League peuvent être verrouillés sur une taille d'équipe fixe — choisis-la à la création, ou change-la plus tard sous Match format dans le dashboard. Sur un leaderboard 3v3, chaque match oppose alors trois joueurs par camp, et le classement reste individuel.

En ELO, le résultat attendu d'une équipe se calcule sur son rating moyen, et l'écart obtenu s'applique à chacun de ses membres — battre plus fort que soi rapporte donc autant à tous les vainqueurs. En League, tous les joueurs du camp gagnant touchent les points de la victoire, et toute l'équipe perdante ceux de la défaite.

Queue de matchmaking (bêta)

Si le bouton de file est activé sur le leaderboard, les joueurs peuvent cliquer dessus pour rejoindre la file de matchmaking. Le système regroupe les joueurs de rating ELO proche grâce à une fenêtre de recherche qui s'élargit. Une fois apparié, tout le monde clique sur Ready et le match a son propre fil avec des boutons de vote. Si aucun match n'est trouvé en 5 minutes, l'entrée dans la file expire. Le vote se ferme au bout de 3 heures et le match est réglé d'après les votes exprimés : la réponse d'un camp, ou le résultat le plus voté. Une égalité part au staff, qui a 48 heures avant que le match soit annulé, et un match sans aucun vote est annulé. Tu ne peux pas rejoindre la file de nouveau tant que tu n'as pas voté sur ton dernier match.

Sur un leaderboard en équipes, la queue attend d'avoir de quoi remplir les deux camps — six joueurs pour un 3v3 — puis les répartit en deux équipes aux ratings moyens les plus proches possible, de sorte que les plus forts et les plus faibles se retrouvent face à face. Tout le monde doit cliquer sur Ready ; si quelqu'un ne le fait pas, il saute et les autres retournent en queue en gardant leur place.

Chaque équipe a son propre salon vocal, pour parler tactique sans que l'adversaire écoute — tu ne vois et ne rejoins que celui de ton équipe. Les deux salons disparaissent une fois le match finalisé. Un résultat n'est acté qu'à la majorité dans chaque équipe (deux sur trois en 3v3) : une équipe ne peut donc jamais s'auto-proclamer vainqueur. Tout le reste part en litige, qu'un admin ou un validateur tranche.

Le bouton de file affiche combien de joueurs attendent, par exemple Queue · 2. Appuie sur 🔔 Me prévenir quand quelqu'un rejoint la file dans le message de la file pour recevoir le rôle de notification du leaderboard : le bot le mentionne quand quelqu'un rejoint une file vide, au plus toutes les 15 minutes. Appuie à nouveau pour arrêter.

La queue n'est plus réservée à ELO : un classement League peut aussi l'activer. Comme les points de League sont un cumul et non une estimation de niveau, les boards League apparient sur les points par match — jouer davantage ne suffit donc pas à vous faire monter dans la queue.

Défi et revanche

Sur un leaderboard ELO ou League en 1v1 avec la file activée, le bouton Challenge te laisse choisir un joueur. Il reçoit le défi en DM avec Accepter et Refuser, et le défi expire au bout de 30 minutes ; s'il a fermé ses DM, tu es le seul prévenu. Un défi accepté devient un fil de match, exactement comme un match de la file. Une fois un match 1v1 réglé, son fil reçoit un bouton Rematch qui renvoie le même défi.

Rôles de rang

Un nouveau leaderboard ELO crée cinq rôles de rang à son premier match validé — Bronze, Argent, Or, Platine et Diamant — si le bot a Manage Roles. Avec le départ par défaut de 1200, les tranches sont : Bronze sous 1100, Argent 1100–1199, Or 1200–1299, Platine 1300–1399 et Diamant à partir de 1400 ; elles suivent le rating de départ du leaderboard. Chaque promotion est annoncée au joueur en DM. Modifie les rôles comme n'importe quels tier roles dans le tableau de bord ; supprimer le leaderboard avec /leaderboard delete les supprime aussi.

Ligne de résultat

Quand un match signalé, de la file ou d'un défi compte, le bot publie une ligne dans le fil du match, par exemple « ✅ A bat B · A 1216 (+16) · désormais #3 (↑2) · B 1184 (−16) ». Personne n'est mentionné. Pour un match signalé, l'avis de confirmation devient cette ligne, et pour un 1v1 de la file ou d'un défi, le bouton Rematch est juste en dessous. Un match enregistré directement, sans étape de confirmation, n'a pas de ligne. Désactive-la avec Ligne de résultat après chaque match dans le tableau de bord.

Équipes fixes

Un leaderboard ELO ou League avec taille d'équipe peut aussi tourner en mode fixed teams (à activer dans le dashboard, juste à côté de Match format). Des équipes nommées s'inscrivent une bonne fois via le bouton Team sign-up du leaderboard — un nom, puis l'effectif, qui peut compter jusqu'à deux remplaçants en plus de la taille d'équipe. Ce sont alors les équipes elles-mêmes qui sont classées : sur un board ELO, chacune a son rating et battre plus fort que soi rapporte davantage ; sur un board League, le tableau les classe aux points, exactement comme une vraie ligue. En League, les équipes fixes enregistrent leurs matchs avec le bouton Submit result du leaderboard.

Dès qu'un seul membre clique sur Queue, c'est toute l'équipe qui part en file, et chacun reçoit un DM. Le matchmaking oppose les équipes selon leur rating, et le ready-check sert en même temps de composition : les premiers de chaque effectif à cliquer sur Ready entrent sur le terrain jusqu'à remplir l'équipe, les autres sont sur le banc pour ce match. Le résultat est voté par ceux qui ont joué, avec la même règle de majorité dans chaque camp. L'effectif de chaque équipe est visible sur la page du leaderboard, sur le site : le nombre de membres figure à côté du nom de l'équipe, le survoler affiche les noms, et ouvrir l'équipe montre l'effectif complet avec le capitaine indiqué.

Le type de leaderboard League classe les joueurs aux points accumulés au fil des matchs. C'est le format du foot, du basket, du futsal, du hockey et de toute compétition, en 1v1 ou par équipes, où c'est le tableau qui fait foi.

Points par défaut

Les nouvelles ligues démarrent en 3 / 1 / 0 (la norme FIFA depuis 1994). Les trois valeurs se règlent leaderboard par leaderboard depuis le dashboard. Passe en 2 / 1 / 0 pour le hockey, 4 / 2 / 0 pour le rugby, ou invente le barème qui colle à ton sport.

Enregistrer un match

Sur le site, ouvre le leaderboard et clique sur Submit — saisis les deux camps et le score du match. Dans Discord, le bouton Submit result du leaderboard ouvre exactement la même chose. Les matchs où le même joueur figure des deux côtés et les scores négatifs sont refusés d'emblée.

Ligues par équipes

Un leaderboard League peut être verrouillé sur une taille d'équipe fixe, de 2v2 à 8v8, à la création ou plus tard sous Match format dans le dashboard. Le tableau continue de classer les joueurs un par un : tout le camp gagnant touche les points de la victoire, tout le camp perdant ceux de la défaite, et le score du match compte comme buts marqués et encaissés pour chacun d'eux.

Tu préfères un vrai tableau de ligue, où ce sont les équipes qui occupent les lignes ? Active Fixed teams à côté de Match format : des équipes nommées s'inscrivent via le bouton Team sign-up du leaderboard (jusqu'à deux remplaçants par effectif), les matchs s'enregistrent équipe contre équipe avec un score, et le tableau classe les équipes aux points. L'effectif de chaque équipe est visible sur la page du leaderboard, sur le site : le nombre de membres figure à côté du nom de l'équipe, le survoler affiche les noms, et ouvrir l'équipe montre l'effectif complet avec le capitaine indiqué.

Validation et annulation

Les matchs League suivent le même parcours que les matchs ELO : l'adversaire confirme ou conteste dans un fil de match privé, le match compte tout seul à l'échéance (3 heures sur les nouveaux leaderboards), le staff tranche les contestations, les points s'appliquent quand il compte, et un match approuvé peut être annulé plus tard (ce qui retire exactement les points attribués).

Les leaderboards ELO et League n'ont pas besoin de deux camps. Dans un match chacun pour soi, tout le monde joue pour soi — de 3 à 8 joueurs — et le résultat est la place de chacun. Active-le avec l'option ffa_players à la création du leaderboard, ou plus tard dans Match format du dashboard. Il remplace les matchs en équipe : un leaderboard chacun pour soi ne peut pas avoir en plus une taille d'équipe ou des équipes fixes, et l'activer ne vaut que pour les nouveaux matchs — tout ce qui est déjà enregistré reste exactement en l'état.

Les types de résultat

Le vainqueur seul est un mode League. Là, il ne demande rien de plus que ce qu'il dit : le vainqueur prend les points de victoire et le reste ceux de défaite. Un classement ne peut pas être aussi souple — si les perdants restent non classés, la seule chose qu'il puisse honnêtement dire d'eux, c'est qu'ils ont tous fait match nul, et alors un joueur mal classé gagne des points sur un match que son bilan compte comme une défaite. C'est pourquoi un chacun pour soi ELO demande l'ordre complet, ou un match nul général qui a vraiment eu lieu.

Signaler un résultat

Les leaderboards chacun pour soi portent un bouton Report result à la place de Submit result. Choisis d'abord tous ceux qui ont joué — exactement autant que la taille du lobby du leaderboard, donc un leaderboard à 6 joueurs en prend 6 et le formulaire refuse de partir avec 5. Le même formulaire peut porter le résultat : désigne le vainqueur et le match est signalé aussitôt ; sur un leaderboard avec un barème de places, ce champ s'élargit à tout l'ordre d'arrivée — la 1re place d'abord, puis la 2e, etc. Laisse-le vide et tu obtiens l'étape du résultat. Définis ensuite le résultat : un leaderboard League demande qui a gagné, avec Match nul pour tout le monde dans le même menu et Définir l'ordre complet si tu préfères classer tout le plateau ; un leaderboard ELO demande directement l'ordre, une place par clic, avec Annuler le dernier en cas de faux pas et un bouton Match nul pour tout le monde à côté. Envoyer reste grisé tant que le résultat n'est pas un résultat que le leaderboard sait noter. Ce bouton est le seul moyen de signaler un résultat chacun pour soi dans Discord : si ton leaderboard ne l'affiche pas, active Bouton Submit dans l'onglet Discord du leaderboard, sur le dashboard, ou enregistre le match depuis la page du leaderboard sur le site.

Ensuite, un chacun pour soi est un match signalé comme un autre. Les autres joueurs sont invités à confirmer ou contester dans un fil de match privé, il compte tout seul à l'échéance (ou quand le staff le valide), les classements et les points bougent quand il compte, et annuler un match approuvé rend à chaque joueur exactement ce qu'il lui avait donné.

Comment le classement est calculé

Un chacun pour soi ELO est noté comme l'ensemble de ses confrontations directes d'un seul coup. Chaque paire de joueurs est comparée — la meilleure place bat la moins bonne, une place identique est un nul entre eux — et chacun de ces mini-résultats est calculé avec la même formule de score attendu qu'un 1v1. Finir devant des joueurs classés bien au-dessus de toi rapporte donc beaucoup plus que finir devant le bas du plateau. Le facteur K est ensuite divisé par le nombre d'adversaires, et c'est ce qui maintient un chacun pour soi à environ un match de mouvement de classement plutôt qu'aux sept duels que tu as techniquement joués.

L'ensemble est à somme nulle exacte : ce que le plateau perd est ce que les autres gagnent, au point près. Six joueurs de même niveau à K=32 repartent avec +16, +10, +3, −3, −10, −16. Le bilan suit la place — la première, même partagée, compte comme une victoire, tout ce qui est en dessous comme une défaite, et le match nul général comme un nul pour tout le plateau.

Points de place sur les leaderboards League

Un chacun pour soi League peut récompenser tout le plateau avec une table de points de place, façon F1 : tant de points pour le premier, tant pour le deuxième, et ainsi de suite jusqu'au bas du lobby. Tu l'édites dans le dashboard, sous les points de victoire, de nul et de défaite, sur tout leaderboard League qui joue en chacun pour soi. Les joueurs à égalité prennent chacun les points de la place qu'ils partagent, et ceux qui finissent au-delà de la fin de la table continuent de marquer sa dernière valeur.

La table ne s'applique qu'à un classement complet. S'il reste quelqu'un sans place — un signalement vainqueur seul, ou un ordre que tu as laissé à moitié — elle ne s'applique pas du tout : la première place prend les points de victoire du leaderboard et tous les autres ceux de défaite. C'est aussi ce que tu obtiens sans aucune table configurée, la table est donc optionnelle. Un match nul général verse les points de nul à tout le monde, quoi que dise la table.

Le chacun pour soi dans la file de matchmaking

Avec le bouton de file activé, un leaderboard chacun pour soi met des joueurs seuls en attente et se déclenche dès qu'il a exactement la taille du lobby — six joueurs sur un leaderboard à 6, jamais cinq ni sept. Il n'y a pas de camps à équilibrer, donc le plateau est simplement le groupe aux classements les plus proches que la file peut réunir. Tout le monde doit quand même cliquer sur Ready, et le match reçoit un seul salon vocal partagé : dans un chacun pour soi, il n'y a pas de coéquipiers à qui cacher quoi que ce soit.

Le résultat est signalé plutôt que voté — trois boutons de vote ne peuvent pas exprimer un ordre d'arrivée à huit joueurs. N'importe quel joueur du plateau définit le résultat sur le message du match et les autres cliquent sur Confirmer ; c'est acté dès qu'une majorité du plateau est d'accord (deux sur trois, cinq sur huit), celui qui a signalé comptant comme le premier d'entre eux. Contester confie le match à un admin ou un validateur, qui définit le bon résultat et le confirme lui-même. Au bout de 3 heures, un résultat signalé est acté, et un match sans signalement est annulé. Un match de la file se règle dans son propre fil, il ne passe donc pas par la file de validation.

Le type de leaderboard Rating laisse les membres envoyer des images et donner des étoiles à celles des autres.

Noter depuis le site

Sur le site, le leaderboard affiche les participations sous forme de galerie de leurs images, chacune avec son rang, sa moyenne, ses votes, qui l'a envoyée et ton propre vote ; les images sont visibles par les membres du serveur connectés. Le bouton à côté de la recherche (sur téléphone, à côté du titre) transforme la galerie en liste, et le site retient ton choix. Clique sur n'importe quelle participation pour ouvrir son image avec sa moyenne, son nombre de votes, son rang, qui l'a envoyée et quand, et mets tes étoiles avec les boutons ; les flèches parcourent les participations dans l'ordre du board. Tes votes sont retenus d'une visite à l'autre. La Recent Activity du leaderboard liste les nouvelles participations et les votes. Par défaut, un vote s'affiche sans le nom du votant ("Someone rated Sunset 8/10") ; avec Votes anonymes désactivé dans le dashboard, les votes donnés à partir de là affichent le nom du votant, et les votants en sont prévenus avant de voter. Sur un board en vote à l'aveugle, la note elle-même n'est jamais affichée.

Un leaderboard Levels (BETA) classe les membres de ton serveur selon leur XP. Personne ne soumet rien : les membres gagnent de l'XP en écrivant et en parlant dans les salons vocaux, le bot compte tout seul, et le niveau de chaque membre découle de son XP. Un serveur a un seul leaderboard Levels (BETA) à la fois, et c'est toujours un leaderboard de serveur — un leaderboard personnel ne peut pas en être un.

Chacun de ces nombres est un réglage dans les paramètres Levels (BETA) du leaderboard, sur le dashboard : la fourchette d'XP par message, le délai entre deux messages et l'XP par minute en vocal (0 coupe l'XP vocale).

De l'XP au niveau

Le niveau d'un membre est calculé à partir de son XP à chaque affichage, il n'est donc jamais stocké. La courbe standard est celle qu'utilisent la plupart des bots de niveaux sur Discord : passer du niveau L au suivant coûte 5L² + 50L + 100 XP. La courbe linéaire coûte 100L + 75 XP par niveau : elle démarre un peu plus raide et atteint les hauts niveaux bien plus tôt. L'XP totale nécessaire pour atteindre un niveau :

Changer de courbe garde l'XP de tout le monde et ne change que le niveau qui en découle.

Salons et rôles sans XP

Choisis des salons où les messages et le temps en vocal ne rapportent rien — les fils comptent comme faisant partie de leur salon — et des rôles dont les membres ne gagnent jamais d'XP, par exemple un rôle pour les membres réduits au silence.

Messages de passage de niveau

Quand un membre atteint un nouveau niveau, le bot publie un message qui le mentionne. Par défaut, il va dans le salon où le membre vient d'écrire ; tu peux l'envoyer plutôt dans un salon fixe, ou le désactiver. Tu peux écrire ton propre texte, jusqu'à 200 caractères, où {user}, {level} et {board} sont remplis. Le message ne mentionne que le membre qui a atteint le niveau, même si le texte contient @everyone, et quand plus de trois membres atteignent un nouveau niveau dans le même salon au même moment, ils partagent un seul message. Le bot doit avoir le droit d'envoyer des messages dans ce salon.

Rôles par niveau

Sur un leaderboard Levels (BETA), les rôles de tier ont un quatrième mode, niveau : un rôle dès le niveau 5, un autre dès le niveau 10, et ainsi de suite. Avec Garder les rôles de tier inférieurs activé, les membres gardent tous les rôles atteints ; désactive-le et ils ne gardent que le plus haut. Les rôles changent peu après qu'un membre a atteint un nouveau niveau.

Monnaie par niveau

Si ton serveur utilise l'économie, tu peux payer de la monnaie pour les niveaux : un montant fixe chaque fois qu'un membre atteint un nouveau niveau, versé une seule fois par niveau. Il compte dans le même plafond quotidien que tous les autres gains, et la même règle d'ancienneté du compte s'applique. Les messages et les minutes en vocal ne rapportent pas de monnaie à eux seuls.

Seasons

À la fin d'une season, le leaderboard gèle : l'XP ne compte plus et le classement reste tel qu'il a fini. Le dégeler reprend avec la même XP. Pour repartir de zéro, crée un nouveau leaderboard Levels (BETA) et laisse le leaderboard gelé comme archive — un leaderboard gelé ne compte pas dans la limite d'un par serveur.

Importer et fixer l'XP

Tu viens d'un autre bot de niveaux ? Importe l'XP depuis un fichier CSV, un name,xp par ligne, avec Importer depuis un CSV sur le dashboard, comme expliqué dans Import et migration. Utilise l'identifiant Discord de chaque membre comme nom : la ligne est alors rattachée au membre, et l'XP qu'il gagne ensuite s'y ajoute. Une ligne avec un autre nom devient une entrée libre, à laquelle l'activité de personne ne s'ajoute.

Pour fixer l'XP à la main, utilise /score sur Discord, ou Set XP et Adjust XP dans le menu d'un joueur sur le site. Un import ou une modification à la main ne publie aucun message de passage de niveau et ne verse aucune récompense de niveau ; les rôles de tier suivent au prochain redessin du leaderboard.

Passer de MEE6 ou d'un autre bot de niveaux

Scoreboards n'importe pas automatiquement depuis MEE6 : les conditions d'utilisation de MEE6 n'autorisent pas l'accès automatisé à leur service, donc le bot ne lit jamais le leaderboard d'un autre bot à ta place. Tu peux en revanche rapatrier toi-même l'XP de tes membres — ce sont les données de ton propre serveur — avec un fichier CSV :

1. Copie l'XP totale de chaque membre depuis le leaderboard de ton serveur sur MEE6 ou sur l'autre bot. Copie l'XP, pas le niveau : le niveau découle de l'XP. Si MEE6 affiche un chiffre arrondi comme 12.5k, écris le nombre complet (12500) ; l'XP peut alors être légèrement décalée.
2. Copie l'identifiant Discord de chaque membre : active Developer Mode dans Discord (Settings → Advanced), puis fais un clic droit sur le membre et choisis Copy User ID.
3. Écris un name,xp par ligne, avec l'identifiant comme nom et l'XP en chiffres seulement : 12500, pas 12,500 ni 12.500. Une ligne écrite ainsi est ignorée et signalée avec son numéro, pour que tu puisses la corriger et réimporter.
4. Sur le dashboard, ouvre le leaderboard Levels (BETA) et utilise Importer depuis un CSV. Chaque ligne remplace l'XP du membre au lieu de s'y ajouter, donc importe avant que les membres aient beaucoup gagné ici. Tu peux réimporter un fichier corrigé à tout moment, et un fichier contient jusqu'à 500 lignes.

name,xp
123456789012345678,4675
234567890123456789,23850

Seul un identifiant relie une ligne à un membre : un nom de 17 à 20 chiffres est lu comme un identifiant Discord, et l'XP que ce membre gagne ensuite s'y ajoute. Un pseudo ou tout autre nom n'est rattaché à personne ; il devient une entrée libre, à laquelle l'activité de personne ne s'ajoute.

La courbe standard est celle de MEE6, donc la même XP donne le même niveau : 4 675 XP, c'est le niveau 10 des deux côtés. L'import ne publie aucun message de passage de niveau et ne verse aucune récompense de niveau. Les rôles en récompense ne suivent pas : reconfigure-les comme rôles de tier en mode niveau, et les membres les reçoivent au prochain redessin du leaderboard. Désactive ensuite les niveaux dans l'autre bot, pour que personne ne reçoive deux messages de passage de niveau.

À quelle fréquence le leaderboard se met à jour

Le message du leaderboard sur Discord est redessiné quand quelqu'un atteint un nouveau niveau ou que l'ordre des places affichées change — au plus une fois par minute — et sinon environ toutes les 15 minutes tant que des membres gagnent de l'XP. Un leaderboard où personne n'est actif n'est pas redessiné. La ligne Dernière mise à jour en dessous indique quand il a été dessiné. Mon rank et le leaderboard sur le site affichent l'XP en quelques secondes.

Confidentialité

Le bot ne lit jamais ce que les membres écrivent. Il n'utilise pas l'intent Message Content de Discord, et ne lit ni ne stocke jamais le texte d'un message. Pour chaque membre qui gagne de l'XP, il stocke son identifiant Discord et son pseudo affiché, l'XP totale, combien de ses messages ont rapporté de l'XP, combien de minutes en vocal en ont rapporté et le moment où de l'XP a été gagnée pour la dernière fois, plus un instantané nocturne de son rang pour le graphique d'historique des rangs. Rien n'est stocké par message. Les données sont supprimées avec le leaderboard, et avec le reste des données du serveur quand le bot est retiré. Si l'économie du serveur paie de la monnaie pour les niveaux, chaque niveau atteint ajoute aussi une entrée au journal de monnaie du membre, conservée avec le reste de ses données de monnaie. La Politique de confidentialité donne les détails.

Tu décides qui voit tes leaderboards sur le site Scoreboards :

Attribue automatiquement des rôles Discord aux joueurs selon leur place au classement. Tu peux par exemple donner un rôle « Champion » au top 3, un rôle « Vétéran » aux rangs 4 à 10, et ainsi de suite.

• Les tiers se configurent depuis le dashboard web, dans les réglages de chaque leaderboard.
• Choisis comment chaque tier se définit : par rank (les rangs 1 à 3), par percentile (les 10 % du haut) ou par score (tous ceux à 2000 points et plus). Un leaderboard Levels (BETA) peut aussi utiliser le niveau (tous ceux au niveau 10 ou plus). Chaque tier a son propre mode, donc un même leaderboard peut les mélanger.
• Associe à chaque tier n'importe quel rôle Discord existant.
• Les rôles sont donnés et retirés automatiquement à mesure que le classement bouge. Le bot les modifie petit à petit, au rythme que Discord autorise : sur un grand serveur, un changement peut mettre quelques minutes à atteindre tout le monde.
• Le rôle Scoreboards doit se trouver au-dessus de tous les rôles qu'il attribue, dans Server Settings → Roles. Discord interdit aux bots de gérer les rôles situés à leur niveau ou plus haut, et le bot postera un avertissement dans le salon du leaderboard s'il tombe dessus.

Tu fais déjà tourner une compétition ailleurs ? Un fichier CSV peut remplir tout un leaderboard d'un coup, pour t'éviter de tout retaper.

Ouvre le dashboard, sélectionne un leaderboard et utilise Importer depuis un CSV. C'est le même chemin pour un leaderboard de serveur et pour un leaderboard personnel, qui ne dépend d'aucun serveur Discord. Le fichier, lui, est le même dans les deux cas — un name,score par ligne :

name,score
Alex,120
"Cooney, EM",95
Sam,88

• Une ligne d'en-tête est repérée et ignorée automatiquement.
• Virgule, point-virgule et tabulation font tous office de séparateur — prends ce que ton tableur exporte.
• Les noms qui contiennent une virgule passent s'ils sont entre guillemets, comme "Cooney, EM".
• Si le nom est un identifiant Discord, la ligne est rattachée au membre et affiche son pseudo. Tout le reste devient une entrée libre.
• Le même nom deux fois garde la dernière valeur : tu peux réimporter un fichier corrigé par-dessus.
• Les lignes illisibles sont sautées et listées avec leur numéro — le reste passe quand même, tu corriges deux ou trois lignes et tu relances.

Les temps acceptent mm:ss, hh:mm:ss et éventuellement une fraction : 1:30, 1:12:44.081. Un nombre seul est lu comme des millisecondes. Attention : trois nombres séparés par des deux-points valent heures:minutes:secondes, donc la précision sous la seconde s'écrit après un point.

Les leaderboards Levels (BETA) prennent name,xp avec l'identifiant Discord de chaque membre comme nom — un pseudo devient une entrée à part qui ne gagne jamais d'XP. Le nombre est l'XP totale du membre, et il remplace l'XP qu'il avait. Un import ne publie aucun message de passage de niveau et ne verse aucune récompense de niveau.

Limites : 500 lignes et 100 Ko par fichier — découpe les exports plus gros et importe-les en plusieurs fois. Les leaderboards Image Rating ne s'importent pas : leurs entrées sont des images envoyées, pas des scores.

Les seasons permettent de clore une compétition sans rien perdre. Programme une fin (ou termine depuis le dashboard) et le board gèle : un podium est publié et le classement reste exactement tel quel.

• Rien n'est réinitialisé ni supprimé — le board gelé est l'archive permanente de la season, visible par tous.
• Un board gelé n'accepte plus d'envois, de matchs ni de votes ; un admin peut le dégeler à tout moment.
• Tous les types de board peuvent avoir des seasons — y compris Rating, où geler un board à vote à l'aveugle révèle aussi les résultats.
• Envie d'une nouvelle season ? Crée un nouveau board et laisse le board gelé comme archive.

Les récaps hebdomadaires postent chaque lundi un petit bilan dans le salon du leaderboard : le top 3, la plus grosse progression de la semaine, et le volume de parties. Seuls les boards avec au moins trois scores dans la semaine en reçoivent un — un leaderboard calme a le droit de rester calme. Tu peux couper les récaps leaderboard par leaderboard depuis le dashboard du site.

Une économie transforme les résultats en une monnaie que les membres dépensent dans la boutique du serveur. Elle reste désactivée tant qu'un admin ne l'a pas configurée et lancée depuis le dashboard, sous Monnaie — ensuite, chaque résultat validé par ton serveur paie les joueurs. Un gain, c'est un socle fixe plus une part d'une cagnotte variable : une partie de la cagnotte suit le résultat, l'autre la surprise, donc battre quelqu'un bien mieux classé vaut plus que battre quelqu'un en dessous. Sur un board Classic, Highscore ou Time, il n'y a pas d'adversaire : c'est ta place au classement qui joue ce rôle. C'est un solde par membre pour tout le serveur, partagé par tous ses leaderboards.

• Une série de victoires ajoute 2 % par victoire, jusqu'au plafond que tu fixes.
• Affronter le même adversaire encore et encore rapporte moins sur une semaine glissante : les deux premiers matchs sont payés plein pot, puis chaque match suivant rapporte moins, jusqu'à un dixième.
• Un plafond quotidien limite ce qu'un membre emporte en une journée, et par défaut un compte Discord doit avoir 7 jours avant de gagner quoi que ce soit.
• Annuler, modifier ou supprimer un résultat reprend le gain, exactement tel qu'il a été versé — si la monnaie a déjà été dépensée, le solde peut passer en négatif. Chaque ligne est visible sur la page boutique du serveur.
• Les boards Image Rating ne paient rien — il n'y a pas de résultat à tarifer.
• Les leaderboards Levels (BETA) paient plutôt par niveau : un montant fixe chaque fois qu'un membre atteint un nouveau niveau, réglé dans les paramètres Levels (BETA) du leaderboard et compté dans le plafond quotidien.

Les membres la dépensent sur la page boutique du serveur. Cette page est réservée aux membres du serveur : ils se connectent avec Discord pour voir leur solde, acheter, choisir ce qu'ils portent et déplier n'importe quel gain pour voir exactement comment il a été calculé. Le bouton Shop sous un leaderboard dans Discord les y emmène directement. Le lancement de l'économie peut l'ajouter sous tous les leaderboards d'un coup, et chaque leaderboard a son propre interrupteur dans son onglet Discord, sur le dashboard.

Cette page se trouve sur scoreboards.dev/shop/ton-serveur, une par serveur, et les pages de leaderboards du serveur y renvoient aussi. Elle vend cinq sortes de produits. Les rôles Discord sont attribués dès l'achat, pour toujours ou, avec les locations activées, pour une durée déterminée, après quoi le rôle est retiré et le membre peut le racheter. Scoreboards doit se trouver au-dessus de chaque rôle qu'il vend dans Paramètres du serveur → Rôles, et le dashboard grise un rôle qu'il ne peut pas attribuer en expliquant pourquoi. Les emojis de leaderboard s'affichent à côté du nom de l'acheteur sur les leaderboards du serveur, sur le site comme dans Discord. Les noms eux-mêmes sont débarrassés de leurs emojis sur les boards, donc un emoji acheté ne peut pas être imité en se renommant. Les couleurs de nom colorent le nom de l'acheteur sur le site et sur les leaderboards en image dans Discord, mais pas sur les boards publiés en embed texte. Les anneaux de rang — seize looks, du feu à la galaxie — sont tracés autour du numéro de rang de l'acheteur, et les styles de ligne, que l'admin compose avec une couleur, un contour et un remplissage, se placent derrière toute la ligne de l'acheteur ; les deux s'affichent là où s'affichent les couleurs de nom. Un membre peut porter à la fois un emoji, une couleur, un anneau et un style de ligne. Quatre autres anneaux appartiennent à une fête : des citrouilles pour Halloween, du givre pour Noël, des confettis pour le Nouvel An et des œufs pour Pâques. Un admin peut les mettre en boutique à tout moment, mais les membres ne peuvent les acheter que le jour de leur fête (selon la date UTC, le même jour partout) ; le reste de l'année, la boutique les affiche comme limités, et qui en a acheté un le porte toute l'année. Dès que quelqu'un achète ou équipe quelque chose, les leaderboards Discord où il figure sont redessinés pour l'afficher.

Un serveur peut avoir des saisons de monnaie, distinctes de ses saisons de leaderboards. Quand une se termine — selon la durée fixée dans le dashboard, ou quand un admin la termine là-bas — la suivante commence aussitôt, et avec la division par deux activée, chaque solde de 2 ou plus est d'abord divisé par deux. Les rôles et objets achetés sont conservés. Les membres voient la date de fin à l'avance sur la page de la boutique, et la fin est publiée dans le salon de logs.

Avec le prestige activé, un membre dont le solde atteint le seuil fixé par l'admin peut le brûler entièrement sur la page de la boutique pour le niveau de prestige suivant. Le niveau de prestige s'affiche sous forme d'étoile et de chiffre à côté de son nom sur le leaderboard du site et la carte Discord, survit à chaque fin de saison et est annoncé dans le salon de logs.

Avec le stock tournant activé, chaque objet de la boutique peut avoir une date de début et de fin, fixées quand tu ajoutes ou modifies le produit. Avant le début, la page de la boutique l'affiche comme à venir ; à la fin, il quitte le rayon et ne peut plus être acheté.

Avec les enchères activées, un admin met un rôle ou un cosmétique aux enchères depuis le dashboard et les membres enchérissent sur la page de la boutique. Une offre est débitée quand elle est faite et rendue dès que quelqu'un enchérit plus haut, et une offre dans les cinq dernières minutes repousse la clôture. À la clôture, l'offre gagnante est détruite, le lot remis et le résultat publié dans le salon de logs.

La configuration se fait en quatre étapes sur le dashboard, sous Monnaie, en mode Simple : nomme la monnaie ; choisis comment les membres gagnent parmi trois rythmes, chacun indiquant à peu près ce qu'un membre actif gagne en une semaine ; remplis la boutique, avec un pack de départ en un clic de six couleurs de nom et six emojis de leaderboard au prix adapté à ce rythme (cette étape peut être passée) ; et lance, avec un bouton Shop sous chaque leaderboard coché par défaut. Les produits s'ajoutent et se modifient dans Monnaie → Boutique, en trois courtes étapes avec des prix suggérés et un aperçu. Le mode Avancé ajoute les montants des gains, qui peut gagner, le salon de logs, les saisons, les locations, le prestige, le stock tournant et les enchères. Les admins donnent de la monnaie et la reprennent depuis le site — via le menu contextuel d'un joueur sur un leaderboard, ou dans Monnaie → Soldes pour un membre qui n'est sur aucun board ; les deux sont annoncés dans le salon de logs que tu choisis, pour que personne n'ait à croire un modérateur sur parole. Cette monnaie n'est pas de l'argent : elle n'a aucune valeur réelle, elle ne quitte pas le serveur où elle a été gagnée, et elle peut être remise à zéro à tout moment.

Un espace personnel peut aussi avoir une économie. Ses membres gagnent avec leurs résultats et les prix de tournoi, et dépensent sur la page boutique de l'espace — seulement en couleurs de pseudo, emojis de classement, anneaux de rang et styles de ligne, puisqu'un espace n'a pas de rôles Discord. Les invités ajoutés par leur nom n'ont pas de porte-monnaie. Toute connexion marche, et quelqu'un qui se connecte avec Discord et avec Google n'a qu'un seul compte dès qu'il relie les deux dans Compte.

Un tournoi fait tourner un arbre complet sur ton serveur : élimination directe (avec exempts et petite finale en option), poules + élimination directe ou double élimination avec grande finale et remise à zéro de l'arbre en option, pour des joueurs ou des équipes. Le bot publie un message par tournoi dans son salon, avec les boutons d'inscription et de check-in, et l'arbre en direct a sa propre page sur le site.

• Les inscriptions se font par ordre d'arrivée avec un plafond et une liste d'attente, ou en auto : l'arbre s'adapte aux inscrits à la clôture. Un check-in optionnel retire au départ ceux qui ne se sont pas enregistrés.
• Chaque match a un fil privé dès que les deux camps sont connus. Les deux camps déclarent le résultat ; s'ils ne sont pas d'accord, les organisateurs sont mentionnés et tranchent. Les organisateurs peuvent trancher n'importe quel match à tout moment, depuis le fil, le dashboard ou /tournament report.
• Les matchs ont une date limite. Un match non joué est réglé selon la règle du tournoi : une déclaration unique fait foi, la meilleure tête de série passe, ou les deux camps sont éliminés.
• En option, relie un leaderboard pour placer les têtes de série selon ses ratings et faire compter les matchs dessus, et — avec la monnaie activée — verse de la monnaie par match gagné (plus à chaque tour) et pour les places finales, hors plafond quotidien.
• Les joueurs peuvent aussi déclarer le résultat sur la page du tournoi sur le site : choisis le résultat, et l'autre camp le confirme ou le conteste là-bas ou dans le fil. C'est la même déclaration dans les deux cas.

Les tournois tournent aussi dans un espace personnel, sans Discord. Les membres rejoignent via un lien et s'inscrivent avec n'importe quelle connexion, Discord ou Google. L'organisateur peut ajouter des invités par leur nom pour ceux qui ne se connectent jamais, et décide de leurs matchs. Il n'y a ni salons, ni fils, ni rôles : tout se passe sur le site, et ce sont le propriétaire et les admins de l'espace qui organisent.

Configure-en un sur le dashboard, sous Tournois (Bêta), ou lance un brouillon rapide avec /tournament create dans Discord.