Kort fortalt
Lag et Script i ServerScriptService som lytter på Players.PlayerAdded, lager en Folder med navnet nøyaktig leaderstats (bare små bokstaver) og gjør den til et barn av spilleren. Hver IntValue, NumberValue eller StringValue inne i mappen blir en kolonne i spillerlisten.
- Lag og endre statistikk bare på serveren. En endring som et LocalScript gjør, ser bare den spilleren og ingen andre.
- leaderstats lagres ikke. Last inn og lagre verdiene med en data store hvis de skal overleve til neste økt.
- For en rangliste over alle spillere skriver du hver poengsum i en ordered data store og viser den på en tavle i verdenen din eller i spillerlistens Global-modus.
På denne siden
Slik virker leaderstats
Roblox viser en spillerliste i hvert spill. Når en spiller har et Folder-barn med navnet leaderstats, legger listen til en kolonne for hvert verdiobjekt inni og viser spillerens verdi i raden hans. Kolonneoverskriften er verdiobjektets Name.
| Objekt | Lagrer | Passer til |
|---|---|---|
IntValue | Heltall | Mynter, kills, seire, level |
NumberValue | Desimaltall | Beste rundetid, distanse |
StringValue | Tekst | Rang eller lagtittel |
To regler ødelegger nesten alle leaderboards som ikke virker. Mappenavnet må være nøyaktig leaderstats: Leaderstats eller leaderStats blir ignorert. Og mappen må lages av et server-Script, fordi bare endringer på serveren replikeres til alle spillere. Hvis du er usikker på hvor koden kjører, les først Script vs LocalScript vs ModuleScript (på engelsk).
Steg 1: lag leaderstats-skriptet
- Hold musen over ServerScriptService i Explorer, klikk på knappen + og sett inn et Script.
- Gi det nytt navn,
Leaderstats, så det er lett å finne senere. - Bytt ut innholdet med koden nedenfor og trykk på Play. Navnet ditt vises i spillerlisten med Coins og Wins lik 0.
local Players = game:GetService("Players")
local function setupLeaderstats(player: Player)
local leaderstats = Instance.new("Folder")
leaderstats.Name = "leaderstats" -- navnet må være nøyaktig slik, bare små bokstaver
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 -- forelderen settes til slutt, når verdiene allerede er inni
end
Players.PlayerAdded:Connect(setupLeaderstats)
-- I Studio kan du komme inn før dette skriptet starter, så vi setter opp dem som allerede er her
for _, player in Players:GetPlayers() do
setupLeaderstats(player)
end
Løkken til slutt er viktig når du tester i Studio: den første spilleren kommer noen ganger inn før PlayerAdded er koblet til, og ville uten løkken stått uten statistikk.
Steg 2: del ut poeng på en trygg måte
For å endre en statistikk setter du Value fra et serverskript. Denne myntplaten gir 10 mynter når en spiller rører den. Touched utløses mange ganger i sekundet mens en karakter står på parten, så skriptet holder en kort cooldown for hver spiller.
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 mange ganger per skritt; dette hindrer at én berøring betaler ti ganger
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") finner karakteren selv når parten som rørte sitter inne i et accessory, noe en enkel sjekk av hit.Parent overser.
Hvis det gis poeng for noe spilleren gjør på sin egen skjerm, for eksempel et trykk på en knapp, må et LocalScript be serveren om det via en RemoteEvent, og serveren må avgjøre om det skal betales. La aldri klienten sende beløpet. Guiden til RemoteEvents viser det mønsteret med sjekker.
Fire ferdige eksempler: guiden til ditt første spill gir 1 Coin for hver mynt spilleren rører på banen og en Win på målplaten etter 3 mynter, guiden til en clicker-simulator gir Coins for knappetrykk med en klikkgrense på serveren, guiden til sverd legger 1 til Kills hos den som ga det siste slaget før spilleren døde, og guiden til våpen viser hvordan du teller et kill når et skudd tar målets Health ned til 0.
Steg 3: lagre statistikk mellom økter
leaderstats lever bare så lenge serveren lever. For å lagre mynter og seire laster du dem inn fra en data store når spilleren kommer inn, og lagrer dem når han går. Denne versjonen erstatter skriptet fra steg 1. Den lagrer aldri en spiller hvis data ikke ble lastet inn: nettopp den feilen sletter fremgang i de fleste kopierte lagringsskript.
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
-- Kalles inne i hvert pcall nedenfor, så et place som ennå ikke er publisert
-- (uten tilgang til data stores) likevel får et leaderboard
local function statsStore(): DataStore
return DataStoreService:GetDataStore("PlayerStats_v1")
end
-- Spillere der den lagrede statistikken ble lastet inn. Dem som ikke står her, lagrer vi aldri,
-- så en mislykket innlasting ikke overskriver ekte fremgang med nuller.
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 serveren slås av, lagrer vi alle før den lukkes
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)
For et lite spill er dette nok. Om nye forsøk, UpdateAsync, grenser for forespørsler og beskyttelse mot at to servere skriver den samme spilleren kan du lese videre i tutorialen om DataStore.
Steg 4: global topp 10
leaderstats sammenligner bare spillere på samme server. For en global rangliste trenger du en ordered data store: en data store som lagrer ett tall per nøkkel og kan returnere nøklene sortert etter verdi. Skriv hver spillers poengsum i den fra serveren, og les deretter de øverste oppføringene tilbake.
Du kan vise den på to måter. Spillerlisten i Roblox har modusene Friends og Global, som leser en ordered data store registrert i Creator Hub (i skrivende stund en betafunksjon, ett aktivt leaderboard per spill). Eller du kan tegne ranglisten selv på en tavle i verdenen din: det virker i alle spill og lar deg utforme den som du vil. Skriptet nedenfor gjør det siste, og det skriver poengsummene med spillerens user ID som nøkkel, som er det samme formatet leaderboardet i Creator Hub forventer.
- Legg til en anchored Part i Workspace, kall den
WinsBoardog gi den størrelse som et skilt (for eksempel 12 ganger 8 ganger 1 stud) med forsiden mot spawnen. - Sett inn et Script i ServerScriptService med navnet
GlobalWinsBoardog koden nedenfor. - Trykk på Play. Tavlen fylles etter første oppdatering og oppdateres hvert minutt.
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
local winsBoard = DataStoreService:GetOrderedDataStore("GlobalWins_v1")
local TOP_N = 10
local REFRESH_SECONDS = 60
-- Tavlen: en anchored Part med navnet WinsBoard i Workspace. Skriptet legger selv til
-- SurfaceGui og rader, så du trenger bare å bygge 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) returnerer de 10 største verdiene først. En ordered data store lagrer bare heltall, så lagre poengsummer som heltall. Skriptet skriver hver spiller én gang i minuttet og leser topp 10 én gang i minuttet, godt innenfor standardgrensene per server (30 + 5 per spiller i minuttet for skriving i en ordered data store og 5 + 2 per spiller for sorterte lesinger, ifølge dokumentasjonen per 30. september 2026).
Vanlige feil og løsninger
Problemene nedenfor dekker de fleste klagene av typen «leaderboardet mitt virker ikke». Sjekk først vinduet Output (åpne det fra menyen Window i Studio eller på fanen Script): hvis skriptet feilet, står linjenummeret der.
Leaderboardet vises ikke i det hele tatt
Sjekk at mappen heter leaderstats med små bokstaver, at forelderen er Player (ikke karakteren), og at koden er et Script i ServerScriptService og ikke et LocalScript.
Andre spillere ser ikke endringene i statistikken min
Verdien ble endret på klienten. Flytt endringen til et server-Script, og hvis den utløses av en knapp eller en tast, send en RemoteEvent og la serveren endre verdien.
attempt to index nil with 'Coins'
Koden prøvde å lese player.leaderstats.Coins før mappen fantes, eller navnet er stavet annerledes. Bruk FindFirstChild på serveren og sjekk resultatet; i et LocalScript bruker du player:WaitForChild("leaderstats"). Guiden til skriptfeil går gjennom den feilen i detalj.
Myntene øker med 10, 20 eller 50 ved én berøring
Touched utløses igjen og igjen mens parts overlapper. Legg til en cooldown for hver spiller som i steg 2, eller fjern gjenstanden når den er plukket opp.
Statistikken nullstilles hver gang jeg kommer inn igjen
Roblox lagrer ikke leaderstats. Legg til skriptet fra steg 3. For å teste lagring i Studio må du publisere placet og slå på Studio Access to API Services under Experience Settings.
Lag det med RoCode
Hvis du ikke har lyst til å bygge dette for hånd, kan RoCode bygge alt inne i placet du har åpent. Det er en AI-agent som jobber via en Roblox Studio-plugin, så den lager skript og parts i Explorer i stedet for å gi deg kode du må lime inn.
Legg til et leaderboard med Coins og Wins som lagres mellom økter, og en topp 10-tavle over seire på en part ved siden av spawnen.
- Kan først søke i placet etter eksisterende leaderstats- eller DataStore-kode for å bygge videre på det som finnes, i stedet for å legge til et ekstra leaderboard
- Lager et serverskript i ServerScriptService og en part til tavlen i Workspace
- Sjekker kompileringen av skriptene den har skrevet inne i Studio før den avslutter
- Sender endringene i runder, og hver runde markeres som et angrepunkt i historikken i Studio
Resultatet sjekker du fortsatt selv, og du tester selv statistikk og lagring i spillet: med plugin 3.9 eller nyere kan RoCode kjøre en kort playtest og lese feil, og med plugin 3.9.11 eller nyere styre en testkarakter og sjekke verdier som Coins og Wins, men den sjekker bare det den selv har valgt å teste. Leaderstats er som regel det første av mange systemer i et spill: bygg resten av spillet med ett system per forespørsel på samme måte. Slik kobler RoCode seg til Studio.
Ofte stilte spørsmål
Hva er leaderstats i Roblox?
En Folder med navnet nøyaktig leaderstats, bare små bokstaver, inne i Player. Roblox viser hver IntValue, NumberValue eller StringValue i den som en kolonne i spillerlisten. Lag den fra et server-Script, som i steg 1.
Hvordan lager man et globalt leaderboard i Roblox?
Skriv hver spillers poengsum i en ordered data store fra serveren, les så de øverste oppføringene tilbake og vis dem på en tavle i verdenen din. Steg 4 har hele skriptet for en topp 10.
Lagrer Roblox leaderstats automatisk?
Nei. leaderstats finnes bare mens spilleren er på serveren. Lagre verdiene med en data store når spilleren går, og last dem inn når han kommer inn, som i steg 3.
Kan man skjule en verdi fra leaderboardet?
Ja. Bare verdier inne i mappen leaderstats vises. Lagre private data i en annen mappe hos spilleren eller i en tabell i et serverskript.
Hvordan skjuler man hele spillerlisten?
Kall StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, false) fra et LocalScript. Send true for å vise den igjen.
Kan man bruke NumberValue til mynter?
Det kan du, men for en valuta i heltall passer IntValue bedre, og en ordered data store tar bare imot heltall hvis du senere vil lage en rangliste ut fra dem.
Kilder og videre lesing
- Roblox Creator Docs: Leaderboards (på engelsk). leaderstats, rekkefølgen på statistikk og de innebygde modusene Friends og Global
- Roblox Creator Docs: Data stores (på engelsk). GetAsync, SetAsync, ordered data stores og grenser
Slik ble koden sjekket: hvert skript på denne siden går gjennom streng Luau-typesjekk med Roblox API-definisjonene (luau-lsp, 20. november 2026). Typesjekken fanger feil i API-navn og feil typer, men ikke feil i spillogikken, så test alt i Studio før du publiserer.