Aller au contenu
— —
  • Débutant
  • 20 min
  • 5 étapes
  • Gratuit

Comment faire un leaderboard sur Roblox

Le leaderboard, c’est le tableau des scores en haut à droite de l’écran, avec le nom de chaque joueur et ses points. Roblox le crée tout seul, à condition de lui donner un dossier au bon nom. Voici comment, puis comment aller jusqu’au classement mondial.

Simulateur : ton jeu de pets

Il existe deux sortes de classements sur Roblox :

  • Le classement du serveur, en haut à droite : il montre les joueurs présents en ce moment dans ta partie. Il est intégré à Roblox, il suffit de quelques lignes.
  • Le classement mondial : un panneau dans ton jeu avec les meilleurs scores de tous les temps, même des joueurs déconnectés. Il demande une sauvegarde.

On commence par le premier.

1Le dossier leaderstats

Roblox affiche automatiquement en haut à droite toutes les valeurs rangées dans un dossier nommé exactement leaderstats, à l’intérieur de chaque joueur. Il faut donc créer ce dossier quand un joueur arrive, avec l’événement PlayerAdded.

Ajoute un Script dans ServerScriptService :

Script dans ServerScriptService
local Players = game:GetService("Players")
Players.PlayerAdded:Connect(function(joueur)
    local leaderstats = Instance.new("Folder")
    leaderstats.Name = "leaderstats" -- tout en minuscules !
    leaderstats.Parent = joueur
    local points = Instance.new("IntValue")
    points.Name = "Points"
    points.Value = 0
    points.Parent = leaderstats
end)

Lance le jeu : la colonne « Points » apparaît à côté de ton nom. Pendant la partie, l’Explorateur montre la structure créée :

Explorateur
  • Players
  • TonPseudoPlayer
  • leaderstatsFolderà créer
  • PointsIntValueà créer

Instance.new crée un objet, et le ranger dans leaderstats suffit à l’afficher. Une IntValue contient un nombre entier ; pour du texte (un rang, une équipe), utilise une StringValue.

2Plusieurs colonnes

Ajoute autant de valeurs que tu veux dans le dossier : elles s’affichent dans l’ordre de création. Le classement est trié selon la première colonne : mets la plus importante en premier.

Dans PlayerAdded, après « Points »
local victoires = Instance.new("IntValue")
victoires.Name = "Victoires"
victoires.Parent = leaderstats

Au-delà de trois ou quatre colonnes, le tableau devient illisible, surtout sur téléphone.

3Donner des points

N’importe quel Script serveur peut maintenant changer le score. Par exemple, dans une ligne d’arrivée :

Script dans la ligne d’arrivée
local Players = game:GetService("Players")
local arrivee = script.Parent
arrivee.Touched:Connect(function(autre)
    local joueur = Players:GetPlayerFromCharacter(autre.Parent)
    if joueur then
        joueur.leaderstats.Points.Value += 1
    end
end)

Attention, ce code donne un point à chaque contact, donc plusieurs par seconde. Le guide comment faire un bouton qui donne des points montre comment limiter avec un temps de recharge.

4Garder les points entre deux parties

Les leaderstats disparaissent quand le joueur quitte le jeu. Pour retrouver ses points la prochaine fois, il faut les sauvegarder avec un DataStore : tout est expliqué dans comment sauvegarder les données d’un joueur.

5Le classement mondial

Pour afficher les meilleurs joueurs de tous les temps, on enregistre chaque score dans un OrderedDataStore, un DataStore qui sait trier. Ensuite, GetSortedAsync renvoie les meilleurs :

Script dans ServerScriptService
local DataStoreService = game:GetService("DataStoreService")
local classement = DataStoreService:GetOrderedDataStore("Meilleurs")
-- À appeler quand un joueur quitte la partie, par exemple :
local function enregistrer(joueur)
    local score = joueur.leaderstats.Points.Value
    pcall(function()
        classement:SetAsync(tostring(joueur.UserId), score)
    end)
end
local function top10()
    local ok, pages = pcall(function()
        return classement:GetSortedAsync(false, 10) -- du plus grand
    end)
    if not ok then return {} end
    return pages:GetCurrentPage() -- { { key = "123", value = 42 }, … }
end

Il reste à afficher la liste sur un panneau dans le monde, avec un SurfaceGui et un TextLabel par ligne. Rafraîchis-la toutes les une à deux minutes, pas plus : les DataStores ont des limites de requêtes. La fiche classement mondial détaille l’affichage et la conversion des UserId en pseudos.

Ce guide ou la formation ?

Ce guide te donne les bases pour démarrer. Il ne remplace pas la formation complète, qui t’accompagne jusqu’à un jeu terminé.

Dans ce guide

  • 5 étapes pour comprendre le principe
  • Le code de base, à recopier et adapter
  • Tu avances seul : si ça ne marche pas, à toi de trouver pourquoi

Dans la formation « Simulateur »

  • 24 leçons en 6 modules : Le cœur du simulateur, Interface et améliorations, Œufs et pets, Zones et renaissances, Sauvegarde, classement et publication, Faire revenir les joueurs
  • Chaque exercice vérifié directement dans Roblox Studio
  • Bloxi t’aide quand tu bloques
  • Ton jeu terminé et publié sur Roblox

Questions fréquentes

Mon leaderboard ne s’affiche pas, pourquoi ?

Dans 9 cas sur 10, le dossier n’est pas nommé exactement leaderstats, tout en minuscules. Vérifie aussi que le code est dans un Script de ServerScriptService, et pas dans un LocalScript.

Peut-on afficher des nombres à virgule ?

Oui, avec une NumberValue à la place de l’IntValue. Pour de très grands nombres (1,5 M), garde un nombre entier et affiche une version raccourcie dans ta propre interface.

Le classement mondial fonctionne-t-il dans Studio ?

Seulement si le jeu est publié et que l’option « Enable Studio Access to API Services » est activée dans les paramètres du jeu (Game Settings › Security).

D’autres guides

Tous les guides

Passe du guide à ton propre jeu

Avec LearnBlox, tu crées ton jeu Roblox leçon après leçon, directement dans Roblox Studio. Le module 1 est gratuit pour essayer.

Commencer gratuitement