I korthet
Skapa ett Script i ServerScriptService som lyssnar på Players.PlayerAdded, skapar en Folder som heter exakt leaderstats (bara gemener) och gör den till barn till spelaren. Varje IntValue, NumberValue eller StringValue i den mappen blir en kolumn i spelarlistan.
- Skapa och ändra statistik bara på servern. En ändring som görs av ett LocalScript syns bara för den spelaren och ingen annan.
- leaderstats sparas inte. Ladda och spara värdena med en data store om de ska finnas kvar till nästa session.
- För en rankning över alla spelare, skriv varje poäng till en ordered data store och visa den på en tavla i din värld eller i spelarlistans läge Global.
På den här sidan
Så fungerar leaderstats
Roblox visar en spelarlista i varje spel. När en spelare har ett barn av typen Folder som heter leaderstats lägger listan till en kolumn för varje värdeobjekt i den och visar spelarens värde på hens rad. Kolumnens rubrik är värdeobjektets Name.
| Objekt | Lagrar | Passar för |
|---|---|---|
IntValue | Heltal | Mynt, kills, vinster, nivå |
NumberValue | Decimaltal | Bästa varvtid, sträcka |
StringValue | Text | Rang eller lagtitel |
Två regler förstör nästan varje topplista som inte fungerar. Mappens namn måste vara exakt leaderstats: Leaderstats eller leaderStats ignoreras. Och mappen måste skapas av ett Script på servern, eftersom bara ändringar på servern replikeras till alla spelare. Om du är osäker på var koden körs, läs först Script vs LocalScript vs ModuleScript (på engelska).
Steg 1: skapa skriptet för leaderstats
- I Explorer, håll muspekaren över ServerScriptService, klicka på knappen + och infoga ett Script.
- Byt namn på det till
Leaderstatsså att det är lätt att hitta senare. - Ersätt innehållet med koden nedan och tryck på Play. Ditt namn visas i spelarlistan med Coins och Wins på 0.
local Players = game:GetService("Players")
local function setupLeaderstats(player: Player)
local leaderstats = Instance.new("Folder")
leaderstats.Name = "leaderstats" -- namnet måste vara exakt så här, bara gemener
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 -- förälder sätts sist, när värdena redan finns i mappen
end
Players.PlayerAdded:Connect(setupLeaderstats)
-- I Studio kan du gå in innan skriptet startar, så vi ställer in dem som redan är här
for _, player in Players:GetPlayers() do
setupLeaderstats(player)
end
Loopen i slutet är viktig när du testar i Studio: den första spelaren går ibland in innan PlayerAdded är kopplad och skulle utan loopen bli utan statistik.
Steg 2: dela ut poäng på ett säkert sätt
För att ändra en statistik, sätt dess Value från ett serverskript. Den här myntplattan ger 10 mynt när en spelare rör vid den. Touched utlöses många gånger per sekund medan karaktären står på parten, så skriptet har en kort nedkylning per spelare.
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 utlöses många gånger per steg; detta hindrar en beröring från att betala tio gånger
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") hittar karaktären även när parten som rörde vid plattan sitter i ett tillbehör, något som en enkel kontroll av hit.Parent missar.
Om poäng ges för något spelaren gör på sin egen skärm, till exempel ett knapptryck, ska ett LocalScript be servern via ett RemoteEvent, och servern ska avgöra om den ska betala. Låt aldrig klienten skicka beloppet. Guiden om RemoteEvents visar det mönstret med kontroll.
Fyra färdiga exempel: guiden om ditt första spel ger 1 Coin för varje mynt spelaren rör på banan och en Win på målplattan efter 3 mynt, guiden om klickersimulatorn ger Coins för knapptryck med en klickgräns på servern, guiden om svärdet lägger till 1 till Kills för den som gav sista slaget innan spelaren dog, och guiden om vapen visar hur du räknar en kill när ett skott sänker målets Health till 0.
Steg 3: spara statistiken mellan sessioner
leaderstats lever bara så länge servern lever. För att spara mynt och vinster, ladda dem från en data store när spelaren går in och spara dem när hen går ut. Den här versionen ersätter skriptet från steg 1. Den sparar aldrig en spelare vars data inte laddades: just det felet raderar framsteg i de flesta kopierade sparskript.
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
-- Anropas inuti varje pcall nedan, så en place som ännu inte är publicerad
-- (utan åtkomst till data stores) får ändå en topplista
local function statsStore(): DataStore
return DataStoreService:GetDataStore("PlayerStats_v1")
end
-- Spelare vars sparade statistik har laddats. De som inte finns här sparar vi aldrig,
-- så en misslyckad laddning skriver inte över riktiga framsteg med nollor.
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)
-- När servern stängs av sparar vi alla innan den stängs
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)
För ett litet spel räcker det här. Om nya försök, UpdateAsync, gränser för anrop och skydd mot att två servrar skriver samma spelare kan du läsa vidare i guiden om DataStore.
Steg 4: en global topp 10
leaderstats jämför bara spelare på samma server. För en global rankning behöver du en ordered data store: en data store som lagrar ett tal per nyckel och kan returnera nycklarna sorterade efter värde. Skriv varje spelares poäng till den från servern och läs sedan tillbaka de översta posterna.
Du kan visa den på två sätt. Robloxs spelarlista har lägena Friends och Global, som läser en ordered data store som är registrerad i Creator Hub (när detta skrivs är det en betafunktion, en aktiv topplista per spel). Eller så ritar du rankningen själv på en tavla i din värld: det fungerar i alla spel och låter dig utforma den hur du vill. Skriptet nedan gör det senare, och det skriver poängen med spelarens user ID som nyckel, vilket är samma format som topplistan i Creator Hub förväntar sig.
- Lägg till en förankrad Part i Workspace, kalla den
WinsBoardoch gör den lika stor som en skylt (till exempel 12 gånger 8 gånger 1 stud), med framsidan mot spawnen. - Infoga ett Script i ServerScriptService med namnet
GlobalWinsBoardoch koden nedan. - Tryck på Play. Tavlan fylls efter den första uppdateringen och uppdateras sedan varje minut.
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
local winsBoard = DataStoreService:GetOrderedDataStore("GlobalWins_v1")
local TOP_N = 10
local REFRESH_SECONDS = 60
-- Tavlan: en förankrad Part som heter WinsBoard i Workspace. Skriptet lägger själv till
-- SurfaceGui och raderna, så du behöver bara bygga Part.
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) returnerar de 10 största värdena först. En ordered data store lagrar bara heltal, så spara poängen som heltal. Skriptet skriver varje spelare en gång i minuten och läser topp 10 en gång i minuten, med god marginal inom standardgränserna per server (30 + 5 per spelare och minut för skrivningar till en ordered data store och 5 + 2 per spelare för sorterade läsningar, enligt dokumentationen den 30 september 2026).
Vanliga fel och lösningar
Problemen nedan täcker de flesta klagomål av typen "min topplista fungerar inte". Kontrollera först fönstret Output (öppna det från menyn Window i Studio eller på fliken Script): om skriptet kraschade med ett fel står radnumret där.
Topplistan visas inte alls
Kontrollera att mappen heter leaderstats med gemener, att dess förälder är Player (inte karaktären) och att koden är ett Script i ServerScriptService, inte ett LocalScript.
Andra spelare ser inte ändringarna i min statistik
Värdet ändrades på klienten. Flytta ändringen till ett Script på servern, och om en knapp eller tangent startar den, skicka ett RemoteEvent och låt servern ändra värdet.
attempt to index nil with 'Coins'
Koden försökte läsa player.leaderstats.Coins innan mappen fanns, eller så är namnet stavat annorlunda. På servern, använd FindFirstChild och kontrollera resultatet; i ett LocalScript, använd player:WaitForChild("leaderstats"). Guiden om skriptfel går igenom det felet i detalj.
Mynten ökar med 10, 20 eller 50 av en enda beröring
Touched utlöses om och om igen medan parts överlappar. Lägg till en nedkylning per spelare som i steg 2, eller ta bort föremålet när det plockats upp.
Statistiken nollställs varje gång jag går in igen
Roblox sparar inte leaderstats. Lägg till skriptet från steg 3. För att testa sparandet i Studio, publicera din place och slå på Studio Access to API Services i Experience Settings.
Gör det med RoCode
Om du inte vill bygga det här för hand kan RoCode bygga allt i din öppna place. Det är en AI-agent som arbetar via ett plugin för Roblox Studio, så den skapar skripten och parts i din Explorer i stället för att ge dig kod att klistra in.
Lägg till en topplista med Coins och Wins som sparas mellan sessioner, och en tavla med topp 10 i vinster på en part nära spawnen.
- Kan först söka i din place efter befintlig kod för leaderstats eller DataStore, så att den bygger vidare på det som finns i stället för att lägga till en andra topplista
- Skapar serverskriptet i ServerScriptService och parten för tavlan i Workspace
- Kontrollerar att skripten den har skrivit kompilerar i Studio innan den blir klar
- Skickar ändringarna i omgångar, och varje omgång markeras som en ångrapunkt i Studios historik
Du granskar fortfarande resultatet och testar själv statistiken och sparandet i spelet: med plugin 3.9 eller nyare kan RoCode köra ett kort speltest och läsa felen, och med plugin 3.9.11 eller nyare styra en testkaraktär och kontrollera värden som Coins och Wins, men den kontrollerar bara det som den själv valt att testa. Leaderstats är oftast det första av många system i ett spel: bygg resten av spelet ett system per prompt på samma sätt. Så ansluter RoCode till Studio.
Vanliga frågor
Vad är leaderstats i Roblox?
En Folder som heter exakt leaderstats, bara gemener, inuti Player. Roblox visar varje IntValue, NumberValue eller StringValue i den som en kolumn i spelarlistan. Skapa den från ett Script på servern, som i steg 1.
Hur gör man en global topplista i Roblox?
Skriv varje spelares poäng till en ordered data store från servern, läs sedan tillbaka de översta posterna och visa dem på en tavla i din värld. Steg 4 har det kompletta skriptet för en topp 10.
Sparar Roblox leaderstats automatiskt?
Nej. leaderstats finns bara så länge spelaren är på servern. Spara värdena med en data store när spelaren går ut och ladda dem när hen går in, som i steg 3.
Kan jag dölja ett värde från topplistan?
Ja. Bara värden inuti mappen leaderstats visas. Lagra privata data i en annan mapp på spelaren eller i en tabell i ett serverskript.
Hur döljer jag hela spelarlistan?
Från ett LocalScript, anropa StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, false). Skicka true för att visa den igen.
Kan jag använda NumberValue för mynt?
Det går, men för en valuta i heltal passar IntValue bättre, och en ordered data store tar bara emot heltal om du senare vill bygga en rankning av dem.
Källor och vidare läsning
- Roblox Creator Docs: Leaderboards (på engelska). leaderstats, statistikens ordning och de beständiga lägena Friends och Global
- Roblox Creator Docs: Data stores (på engelska). GetAsync, SetAsync, ordered data stores och gränser
Så kontrollerades koden: varje skript på den här sidan klarar strikt Luau-typkontroll mot Roblox API-definitionerna (luau-lsp, 20 november 2026). Typkontrollen fångar felstavade API-namn och fel typer, men inte fel i spellogiken, så testa allt i Studio innan du publicerar.