Kort fortalt
Opret et Script i ServerScriptService, der lytter på Players.PlayerAdded, opretter en Folder med navnet præcis leaderstats (kun små bogstaver) og gør den til et barn af spilleren. Hver IntValue, NumberValue eller StringValue inde i mappen bliver en kolonne i spillerlisten.
- Opret og ændr kun statistik på serveren. En ændring, som et LocalScript laver, ser kun den spiller og ingen andre.
- leaderstats gemmes ikke. Indlæs og gem værdierne med en data store, hvis de skal overleve til næste session.
- Til en rangliste over alle spillere skriver du hver score i en ordered data store og viser den på en tavle i din verden eller i spillerlistens Global-tilstand.
På denne side
Sådan virker leaderstats
Roblox viser en spillerliste i hvert spil. Når en spiller har et Folder-barn med navnet leaderstats, tilføjer listen en kolonne for hvert værdiobjekt indeni og viser spillerens værdi i hans række. Kolonnens overskrift er værdiobjektets Name.
| Objekt | Gemmer | Passer til |
|---|---|---|
IntValue | Heltal | Mønter, kills, sejre, level |
NumberValue | Decimaltal | Bedste omgangstid, distance |
StringValue | Tekst | Rang eller holdtitel |
To regler ødelægger næsten alle leaderboards, der ikke virker. Mappens navn skal være præcis leaderstats: Leaderstats eller leaderStats ignoreres. Og mappen skal oprettes af et server-Script, fordi kun ændringer på serveren replikeres til alle spillere. Hvis du er i tvivl om, hvor koden kører, så læs først Script vs LocalScript vs ModuleScript (på engelsk).
Trin 1: opret leaderstats-scriptet
- Hold musen over ServerScriptService i Explorer, klik på knappen +, og indsæt et Script.
- Omdøb det til
Leaderstats, så det er nemt at finde senere. - Erstat indholdet med koden nedenfor, og tryk på Play. Dit navn vises i spillerlisten med Coins og Wins lig med 0.
local Players = game:GetService("Players")
local function setupLeaderstats(player: Player)
local leaderstats = Instance.new("Folder")
leaderstats.Name = "leaderstats" -- navnet skal være præcis sådan, kun små bogstaver
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 -- forælderen sættes til sidst, når værdierne allerede er indeni
end
Players.PlayerAdded:Connect(setupLeaderstats)
-- I Studio kan du komme ind, før dette script starter, så vi sætter dem op, der allerede er her
for _, player in Players:GetPlayers() do
setupLeaderstats(player)
end
Løkken til sidst er vigtig ved test i Studio: den første spiller kommer nogle gange ind, før PlayerAdded er forbundet, og ville uden løkken stå uden statistik.
Trin 2: uddel point sikkert
For at ændre en statistik sætter du dens Value fra et serverscript. Denne møntplade giver 10 mønter, når en spiller rører den. Touched udløses mange gange i sekundet, mens en karakter står på parten, så scriptet 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 udløses mange gange pr. skridt; det forhindrer, at én berøring betaler ti gange
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") finder karakteren, selv når den part, der rørte, sidder inde i et accessory, hvilket et simpelt tjek af hit.Parent overser.
Hvis der gives point for noget, spilleren gør på sin egen skærm, for eksempel et tryk på en knap, skal et LocalScript bede serveren om det via en RemoteEvent, og serveren skal afgøre, om der skal betales. Lad aldrig klienten sende beløbet. Guiden til RemoteEvents viser det mønster med tjek.
Fire færdige eksempler: guiden til dit første spil giver 1 Coin for hver mønt, spilleren rører på banen, og en Win på målpladen efter 3 mønter, guiden til en clicker-simulator giver Coins for knaptryk med en klikgrænse på serveren, guiden til sværd lægger 1 til Kills hos den, der gav det sidste slag, før spilleren døde, og guiden til våben viser, hvordan man tæller et kill, når et skud bringer målets Health ned på 0.
Trin 3: gem statistik mellem sessioner
leaderstats lever kun, så længe serveren lever. For at gemme mønter og sejre indlæser du dem fra en data store, når spilleren kommer ind, og gemmer dem, når han går. Denne version erstatter scriptet fra trin 1. Den gemmer aldrig en spiller, hvis data ikke blev indlæst: netop den fejl sletter fremskridt i de fleste kopierede gemme-scripts.
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
-- Kaldes inde i hvert pcall nedenfor, så et place, der endnu ikke er udgivet
-- (uden adgang til data stores), alligevel får et leaderboard
local function statsStore(): DataStore
return DataStoreService:GetDataStore("PlayerStats_v1")
end
-- Spillere, hvis gemte statistik blev indlæst. Dem, der ikke står her, gemmer vi aldrig,
-- så en mislykket indlæsning ikke overskriver rigtige fremskridt 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 lukker ned, gemmer vi alle, før den lukker
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)
Til et lille spil er det nok. Om nye forsøg, UpdateAsync, grænser for forespørgsler og beskyttelse mod to servere, der skriver den samme spiller, kan du læse videre i tutorialen om DataStore.
Trin 4: global top 10
leaderstats sammenligner kun spillere på den samme server. Til en global rangliste skal du bruge en ordered data store: en data store, der gemmer ét tal pr. nøgle og kan returnere nøglerne sorteret efter værdi. Skriv hver spillers score i den fra serveren, og læs derefter de øverste poster tilbage.
Du kan vise den på to måder. Roblox' spillerliste har tilstandene Friends og Global, der læser en ordered data store, som er registreret i Creator Hub (i skrivende stund en betafunktion, ét aktivt leaderboard pr. spil). Eller du kan selv tegne ranglisten på en tavle i din verden: det virker i ethvert spil og lader dig udforme den, som du vil. Scriptet nedenfor gør det sidste, og det skriver scorerne med spillerens user ID som nøgle, hvilket er det samme format, som leaderboardet i Creator Hub forventer.
- Tilføj en anchored Part i Workspace, kald den
WinsBoard, og giv den størrelse som et skilt (for eksempel 12 gange 8 gange 1 stud) med forsiden mod spawnen. - Indsæt et Script i ServerScriptService med navnet
GlobalWinsBoardog koden nedenfor. - Tryk på Play. Tavlen fyldes efter første opdatering og opdateres hvert 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
-- Tavlen: en anchored Part med navnet WinsBoard i Workspace. Scriptet tilføjer selv
-- SurfaceGui og rækker, så du skal kun 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 værdier først. En ordered data store gemmer kun heltal, så gem scorer som heltal. Scriptet skriver hver spiller én gang i minuttet og læser top 10 én gang i minuttet, med god margin inden for standardgrænserne pr. server (30 + 5 pr. spiller i minuttet for skrivninger i en ordered data store og 5 + 2 pr. spiller for sorterede læsninger, ifølge dokumentationen pr. 30. september 2026).
Almindelige fejl og løsninger
Problemerne nedenfor dækker de fleste klager af typen »mit leaderboard virker ikke«. Tjek først vinduet Output (åbn det fra menuen Window i Studio eller på fanen Script): hvis scriptet fejlede, står linjenummeret dér.
Leaderboardet vises slet ikke
Tjek, at mappen hedder leaderstats med små bogstaver, at dens forælder er Player (ikke karakteren), og at koden er et Script i ServerScriptService og ikke et LocalScript.
Andre spillere kan ikke se ændringerne i min statistik
Værdien blev ændret på klienten. Flyt ændringen til et server-Script, og hvis den udløses af en knap eller en tast, så send en RemoteEvent, og lad serveren ændre værdien.
attempt to index nil with 'Coins'
Koden forsøgte at læse player.leaderstats.Coins, før mappen fandtes, eller navnet er stavet anderledes. Brug FindFirstChild på serveren, og tjek resultatet; i et LocalScript bruger du player:WaitForChild("leaderstats"). Guiden til script-fejl gennemgår den fejl i detaljer.
Mønterne stiger med 10, 20 eller 50 ved én berøring
Touched udløses igen og igen, mens parts overlapper. Tilføj en cooldown for hver spiller som i trin 2, eller fjern genstanden, når den er samlet op.
Statistikken nulstilles, hver gang jeg kommer ind igen
Roblox gemmer ikke leaderstats. Tilføj scriptet fra trin 3. For at teste gemning i Studio skal du udgive placet og slå Studio Access to API Services til under Experience Settings.
Lav det med RoCode
Hvis du ikke har lyst til at bygge det i hånden, kan RoCode bygge det hele inde i det place, du har åbent. Det er en AI-agent, der arbejder via et Roblox Studio-plugin, så den opretter scripts og parts i din Explorer i stedet for at give dig kode, du skal sætte ind.
Tilføj et leaderboard med Coins og Wins, der gemmes mellem sessioner, og en top 10-tavle over sejre på en part ved siden af spawnen.
- Kan først søge i placet efter eksisterende leaderstats- eller DataStore-kode for at bygge videre på det, der er, i stedet for at tilføje et ekstra leaderboard
- Opretter et serverscript i ServerScriptService og en part til tavlen i Workspace
- Tjekker kompileringen af de skrevne scripts inde i Studio, før den slutter
- Sender ændringerne i omgange, og hver omgang markeres som et fortryd-punkt i Studios historik
Resultatet tjekker du stadig selv, og du tester selv statistik og gemning i spillet: med plugin 3.9 eller nyere kan RoCode køre en kort playtest og læse fejl, og med plugin 3.9.11 eller nyere styre en testkarakter og tjekke værdier som Coins og Wins, men den tjekker kun det, den selv har valgt at teste. Leaderstats er som regel det første af mange systemer i et spil: byg resten af spillet med ét system pr. forespørgsel på samme måde. Sådan forbinder RoCode til Studio.
Ofte stillede spørgsmål
Hvad er leaderstats i Roblox?
En Folder med navnet præcis leaderstats, kun små bogstaver, inde i Player. Roblox viser hver IntValue, NumberValue eller StringValue i den som en kolonne i spillerlisten. Opret den fra et server-Script, som i trin 1.
Hvordan laver man et globalt leaderboard i Roblox?
Skriv hver spillers score i en ordered data store fra serveren, læs derefter de øverste poster tilbage, og vis dem på en tavle i din verden. Trin 4 har det fulde script til en top 10.
Gemmer Roblox leaderstats automatisk?
Nej. leaderstats findes kun, mens spilleren er på serveren. Gem værdierne med en data store, når spilleren går, og indlæs dem, når han kommer ind, som i trin 3.
Kan man skjule en værdi fra leaderboardet?
Ja. Kun værdier inde i mappen leaderstats vises. Gem private data i en anden mappe hos spilleren eller i en tabel i et serverscript.
Hvordan skjuler man hele spillerlisten?
Kald StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, false) fra et LocalScript. Giv true for at vise den igen.
Kan man bruge NumberValue til mønter?
Det kan man, men til en valuta af heltal passer IntValue bedre, og en ordered data store tager kun imod heltal, hvis du senere vil lave en rangliste ud fra dem.
Kilder og videre læsning
- Roblox Creator Docs: Leaderboards (på engelsk). leaderstats, rækkefølgen af statistikker og de faste tilstande Friends og Global
- Roblox Creator Docs: Data stores (på engelsk). GetAsync, SetAsync, ordered data stores og grænser
Sådan blev koden tjekket: hvert script på denne side gennemgår streng Luau-typekontrol med Roblox API-definitionerne (luau-lsp, 20. november 2026). Typekontrollen fanger fejl i API-navne og forkerte typer, men ikke fejl i spillogikken, så test alt i Studio, før du udgiver.