In het kort
Maak een Script in ServerScriptService dat naar Players.PlayerAdded luistert, een Folder maakt met precies de naam leaderstats (alles in kleine letters) en die als kind van de speler instelt. Elke IntValue, NumberValue of StringValue in die map wordt een kolom in de spelerslijst.
- Maak en wijzig stats alleen op de server. Een wijziging vanuit een LocalScript ziet alleen die speler, verder niemand.
- leaderstats wordt niet opgeslagen. Laad en bewaar de waarden met een data store als ze tot de volgende sessie moeten blijven.
- Voor een ranglijst over alle spelers schrijf je elke score naar een ordered data store en toon je die op een bord in je wereld of in de Global-modus van de spelerslijst.
Op deze pagina
Hoe leaderstats werkt
Roblox toont in elke game een spelerslijst. Als een speler een kind-Folder met de naam leaderstats heeft, voegt de lijst een kolom toe voor elk value-object daarin en toont de waarde van die speler in zijn rij. De kolomkop is de Name van het value-object.
| Object | Bevat | Geschikt voor |
|---|---|---|
IntValue | Hele getallen | Munten, kills, wins, level |
NumberValue | Kommagetallen | Beste rondetijd, afstand |
StringValue | Tekst | Rang of teamtitel |
Twee regels breken bijna elk leaderboard dat niet werkt. De map moet precies leaderstats heten: Leaderstats of leaderStats worden genegeerd. En de map moet door een server-Script worden gemaakt, want alleen wijzigingen op de server worden naar alle spelers gerepliceerd. Weet je niet zeker waar code draait, lees dan eerst Script vs LocalScript vs ModuleScript (in het Engels).
Stap 1: maak het leaderstats-script
- Ga in de Explorer met de muis over ServerScriptService, klik op de knop + en voeg een Script toe.
- Hernoem het naar
Leaderstats, zodat je het later makkelijk terugvindt. - Vervang de inhoud door de code hieronder en klik op Play. Je naam verschijnt in de spelerslijst met Coins en Wins op 0.
local Players = game:GetService("Players")
local function setupLeaderstats(player: Player)
local leaderstats = Instance.new("Folder")
leaderstats.Name = "leaderstats" -- de naam moet precies zo zijn, alles in kleine letters
local coins = Instance.new("IntValue")
coins.Name = "Coins"
coins.Value = 0
coins.Parent = leaderstats
local wins = Instance.new("IntValue")
wins.Name = "Wins"
wins.Value = 0
wins.Parent = leaderstats
leaderstats.Parent = player -- de parent als laatste instellen, als de waarden er al in zitten
end
Players.PlayerAdded:Connect(setupLeaderstats)
-- In Studio kun je binnenkomen voordat dit script start, dus stel ook in wie er al is
for _, player in Players:GetPlayers() do
setupLeaderstats(player)
end
De lus aan het eind is belangrijk bij testen in Studio: de eerste speler komt soms binnen voordat PlayerAdded gekoppeld is, en zou zonder de lus geen stats hebben.
Stap 2: deel veilig punten uit
Om een stat te veranderen, zet je zijn Value vanuit een serverscript. Deze muntenplaat geeft 10 munten als een speler hem aanraakt. Touched gaat vele keren per seconde af zolang een personage op het part staat, dus het script houdt per speler een korte cooldown bij.
local Players = game:GetService("Players")
local part = script.Parent :: BasePart
local REWARD = 10
local COOLDOWN_SECONDS = 1
local lastReward: { [Player]: number } = {}
part.Touched:Connect(function(hit: BasePart)
local character = hit:FindFirstAncestorOfClass("Model")
local player = character and Players:GetPlayerFromCharacter(character)
if not player then
return
end
local now = os.clock()
local last = lastReward[player]
if last and now - last < COOLDOWN_SECONDS then
return -- Touched gaat vele keren per stap af; dit voorkomt dat één aanraking tien keer uitbetaalt
end
lastReward[player] = now
local leaderstats = player:FindFirstChild("leaderstats")
local coins = leaderstats and leaderstats:FindFirstChild("Coins")
if coins and coins:IsA("IntValue") then
coins.Value += REWARD
end
end)
Players.PlayerRemoving:Connect(function(player: Player)
lastReward[player] = nil
end)
FindFirstAncestorOfClass("Model") vindt het personage ook als het part dat raakte in een accessoire zit, terwijl een simpele controle op hit.Parent dat mist.
Worden punten gegeven voor iets wat de speler op zijn eigen scherm doet, zoals op een knop drukken, dan moet het LocalScript de server via een RemoteEvent vragen, en moet de server beslissen of er betaald wordt. Laat de client nooit het bedrag sturen. De handleiding over RemoteEvents laat dat patroon met controle zien.
Vier kant-en-klare voorbeelden: de handleiding voor je eerste game geeft 1 Coin voor elke munt die de speler op de baan aanraakt en een Win op de finishplaat na 3 munten, de handleiding voor een clicker-simulator geeft Coins voor klikken op een knop met een kliklimiet op de server, de zwaardhandleiding telt 1 op bij de Kills van wie de laatste klap gaf voordat een speler stierf, en de wapenhandleiding laat zien hoe je een kill telt als een schot de Health van het doelwit op 0 brengt.
Stap 3: sla stats op tussen sessies
leaderstats leeft alleen zolang de server leeft. Om munten en wins te bewaren, laad je ze uit een data store als de speler binnenkomt en sla je ze op als hij vertrekt. Deze versie vervangt het script uit stap 1. Ze slaat nooit een speler op van wie de data niet geladen is: precies die fout wist de voortgang in de meeste gekopieerde opslagscripts.
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
-- Wordt binnen elke pcall hieronder aangeroepen, dus een nog niet gepubliceerde place
-- (zonder toegang tot data stores) krijgt toch een leaderboard
local function statsStore(): DataStore
return DataStoreService:GetDataStore("PlayerStats_v1")
end
-- Spelers van wie de opgeslagen stats geladen zijn. Wie hier niet in staat, slaan we nooit op,
-- dus een mislukte load overschrijft echte voortgang niet met nullen.
local loaded: { [Player]: boolean } = {}
local function keyFor(player: Player): string
return "player_" .. player.UserId
end
local function onPlayerAdded(player: Player)
local leaderstats = Instance.new("Folder")
leaderstats.Name = "leaderstats"
local coins = Instance.new("IntValue")
coins.Name = "Coins"
coins.Parent = leaderstats
local wins = Instance.new("IntValue")
wins.Name = "Wins"
wins.Parent = leaderstats
local ok, data = pcall(function()
return statsStore():GetAsync(keyFor(player))
end)
if ok then
if type(data) == "table" then
coins.Value = tonumber(data.Coins) or 0
wins.Value = tonumber(data.Wins) or 0
end
loaded[player] = true
else
warn(`Could not load stats for {player.Name}: {data}`)
end
leaderstats.Parent = player
end
local function save(player: Player)
if not loaded[player] then
return
end
local leaderstats = player:FindFirstChild("leaderstats")
local coins = leaderstats and leaderstats:FindFirstChild("Coins")
local wins = leaderstats and leaderstats:FindFirstChild("Wins")
if not (coins and coins:IsA("IntValue") and wins and wins:IsA("IntValue")) then
return
end
local ok, err = pcall(function()
statsStore():SetAsync(keyFor(player), { Coins = coins.Value, Wins = wins.Value })
end)
if not ok then
warn(`Could not save stats for {player.Name}: {err}`)
end
end
Players.PlayerAdded:Connect(onPlayerAdded)
for _, player in Players:GetPlayers() do
task.spawn(onPlayerAdded, player)
end
Players.PlayerRemoving:Connect(function(player: Player)
save(player)
loaded[player] = nil
end)
-- Als de server afsluit, slaan we iedereen op voordat hij sluit
game:BindToClose(function()
local pending = 0
for _, player in Players:GetPlayers() do
pending += 1
task.spawn(function()
save(player)
pending -= 1
end)
end
while pending > 0 do
task.wait()
end
end)
Voor een kleine game is dit genoeg. Over nieuwe pogingen, UpdateAsync, aanvraaglimieten en bescherming tegen twee servers die dezelfde speler schrijven, lees je verder in de DataStore-tutorial.
Stap 4: een wereldwijde top 10
leaderstats vergelijkt alleen spelers op dezelfde server. Voor een wereldwijde ranglijst heb je een ordered data store nodig: een data store die één getal per key bewaart en keys gesorteerd op waarde kan teruggeven. Schrijf vanaf de server de score van elke speler erin en lees daarna de bovenste regels terug.
Je kunt hem op twee manieren tonen. De spelerslijst van Roblox heeft de modi Friends en Global, die een ordered data store lezen die in de Creator Hub is geregistreerd (op het moment van schrijven een bètafunctie, één actief leaderboard per game). Of je tekent de ranglijst zelf op een bord in je wereld: dat werkt in elke game en je kunt hem vormgeven zoals je wilt. Het script hieronder doet het tweede, en het schrijft de scores met de user ID van de speler als key, hetzelfde formaat dat het leaderboard in de Creator Hub verwacht.
- Voeg in Workspace een geanchord Part toe, noem het
WinsBoarden maak het zo groot als een uithangbord (bijvoorbeeld 12 bij 8 bij 1 stud), met de voorkant naar de spawn. - Voeg in ServerScriptService een Script toe met de naam
GlobalWinsBoarden de code hieronder. - Klik op Play. Het bord vult zich na de eerste verversing en wordt elke minuut bijgewerkt.
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
local winsBoard = DataStoreService:GetOrderedDataStore("GlobalWins_v1")
local TOP_N = 10
local REFRESH_SECONDS = 60
-- Het bord: een geanchord Part met de naam WinsBoard in Workspace. Het script voegt zelf
-- de SurfaceGui en de regels toe, dus je hoeft alleen het Part te bouwen.
local boardPart = workspace:WaitForChild("WinsBoard") :: BasePart
local gui = Instance.new("SurfaceGui")
gui.Face = Enum.NormalId.Front
gui.SizingMode = Enum.SurfaceGuiSizingMode.PixelsPerStud
gui.PixelsPerStud = 50
gui.Parent = boardPart
local list = Instance.new("Frame")
list.Size = UDim2.fromScale(1, 1)
list.BackgroundColor3 = Color3.fromRGB(18, 11, 31)
list.Parent = gui
local layout = Instance.new("UIListLayout")
layout.SortOrder = Enum.SortOrder.LayoutOrder
layout.Parent = list
local nameCache: { [number]: string } = {}
local function nameFor(userId: number): string
local cached = nameCache[userId]
if cached then
return cached
end
local ok, name = pcall(function()
return Players:GetNameFromUserIdAsync(userId)
end)
local result = if ok then name else "Unknown player"
nameCache[userId] = result
return result
end
local function recordWins(player: Player)
local leaderstats = player:FindFirstChild("leaderstats")
local wins = leaderstats and leaderstats:FindFirstChild("Wins")
if wins and wins:IsA("IntValue") then
local ok, err = pcall(function()
winsBoard:SetAsync(tostring(player.UserId), wins.Value)
end)
if not ok then
warn(`Could not record wins for {player.Name}: {err}`)
end
end
end
local function refresh()
local ok, pages = pcall(function()
return winsBoard:GetSortedAsync(false, TOP_N)
end)
if not ok then
warn(`Could not read the wins board: {pages}`)
return
end
for _, child in list:GetChildren() do
if child:IsA("TextLabel") then
child:Destroy()
end
end
for rank, entry in pages:GetCurrentPage() do
local label = Instance.new("TextLabel")
label.Size = UDim2.new(1, 0, 1 / TOP_N, 0)
label.BackgroundTransparency = 1
label.TextColor3 = Color3.new(1, 1, 1)
label.TextScaled = true
label.Text = `{rank}. {nameFor(tonumber(entry.key) or 0)} {entry.value}`
label.LayoutOrder = rank
label.Parent = list
end
end
while true do
for _, player in Players:GetPlayers() do
recordWins(player)
end
refresh()
task.wait(REFRESH_SECONDS)
end
GetSortedAsync(false, 10) geeft de 10 hoogste waarden eerst terug. Een ordered data store bewaart alleen hele getallen, dus sla scores op als hele getallen. Het script schrijft elke speler één keer per minuut en leest de top 10 één keer per minuut, ruim binnen de standaardlimieten per server (30 + 5 per speler per minuut voor schrijfacties naar een ordered data store en 5 + 2 per speler voor gesorteerde leesacties, volgens de documentatie op 30 september 2026).
Veelvoorkomende fouten en oplossingen
De problemen hieronder dekken de meeste klachten van het type „mijn leaderboard werkt niet”. Kijk eerst in het venster Output (open het via het menu Window in Studio of op het tabblad Script): als het script met een fout is gestopt, staat daar het regelnummer.
Het leaderboard verschijnt helemaal niet
Controleer of de map leaderstats heet in kleine letters, of de parent de Player is (niet het personage) en of de code een Script in ServerScriptService is, geen LocalScript.
Andere spelers zien de wijzigingen in mijn stat niet
De waarde is op de client veranderd. Verplaats de wijziging naar een server-Script, en als een knop of toets hem start, stuur dan een RemoteEvent en laat de server de waarde veranderen.
attempt to index nil with 'Coins'
De code probeerde player.leaderstats.Coins te lezen voordat de map er was, of de naam is anders geschreven. Gebruik op de server FindFirstChild en controleer het resultaat; gebruik in een LocalScript player:WaitForChild("leaderstats"). De handleiding over scriptfouten bespreekt deze fout uitgebreid.
Munten gaan met 10, 20 of 50 omhoog door één aanraking
Touched gaat steeds opnieuw af zolang parts elkaar overlappen. Voeg per speler een cooldown toe zoals in stap 2, of verwijder het voorwerp na het oppakken.
Stats worden bij elke keer opnieuw binnenkomen gereset
Roblox slaat leaderstats niet op. Voeg het script uit stap 3 toe. Om het opslaan in Studio te testen, publiceer je de place en zet je Studio Access to API Services aan in Experience Settings.
Bouwen met RoCode
Heb je geen zin om dit met de hand te bouwen, dan kan RoCode alles bouwen in de place die je open hebt. Het is een AI-agent die via een plugin in Roblox Studio werkt, dus hij maakt scripts en parts in je Explorer in plaats van code te geven om te plakken.
Voeg een leaderboard toe met Coins en Wins dat tussen sessies wordt opgeslagen, en een top 10-bord voor wins op een part bij de spawn.
- Kan eerst in de place zoeken naar bestaande leaderstats- of DataStore-code, om aan te vullen wat er is in plaats van een tweede leaderboard toe te voegen
- Maakt het serverscript in ServerScriptService en het part voor het bord in Workspace
- Controleert of de geschreven scripts in Studio compileren voordat hij klaar is
- Stuurt wijzigingen in batches, en elke batch wordt als undo-punt in de geschiedenis van Studio gemarkeerd
Het resultaat controleer je nog steeds zelf, en je test zelf de stats en het opslaan in de game: met plugin 3.9 of nieuwer kan RoCode een korte playtest draaien en de fouten lezen, en met plugin 3.9.11 of nieuwer een testpersonage besturen en waarden als Coins en Wins controleren, maar hij controleert alleen wat hij zelf voor de test kiest. Leaderstats is meestal het eerste van vele systemen in een game: bouw de rest van de game één systeem per verzoek op dezelfde manier. Hoe RoCode verbinding maakt met Studio.
Veelgestelde vragen
Wat is leaderstats in Roblox?
Een Folder met precies de naam leaderstats, alles in kleine letters, in de Player. Roblox toont elke IntValue, NumberValue of StringValue daarin als kolom in de spelerslijst. Maak hem vanuit een server-Script, zoals in stap 1.
Hoe maak je een wereldwijd leaderboard in Roblox?
Schrijf vanaf de server de score van elke speler naar een ordered data store, lees dan de bovenste regels terug en toon ze op een bord in je wereld. In stap 4 staat het volledige script voor een top 10.
Slaat Roblox leaderstats automatisch op?
Nee. leaderstats bestaat alleen zolang de speler op de server is. Sla de waarden op met een data store als de speler vertrekt en laad ze als hij binnenkomt, zoals in stap 3.
Kan ik een waarde verbergen voor het leaderboard?
Ja. Alleen waarden in de map leaderstats worden getoond. Bewaar verborgen data in een andere map bij de speler of in een tabel in een serverscript.
Hoe verberg ik de hele spelerslijst?
Roep vanuit een LocalScript StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, false) aan. Geef true mee om hem weer te tonen.
Kan ik een NumberValue gebruiken voor munten?
Dat kan, maar voor een valuta van hele getallen past IntValue beter, en een ordered data store accepteert alleen hele getallen als je er later een ranglijst van wilt maken.
Bronnen en verder lezen
- Roblox Creator Docs: Leaderboards (in het Engels). leaderstats, volgorde van stats en de vaste modi Friends en Global
- Roblox Creator Docs: Data stores (in het Engels). GetAsync, SetAsync, ordered data stores en limieten
Hoe de code is gecontroleerd: elk script op deze pagina doorloopt een strikte Luau-typecontrole met de Roblox API-definities (luau-lsp, 20 november 2026). De typecontrole vangt fouten in API-namen en verkeerde types op, maar geen fouten in de gamelogica, dus test alles in Studio voordat je publiceert.