Tutorial · Spillerdata

Slik lager du et leaderboard i Roblox Studio

Spillerlisten øverst til høyre i et Roblox-spill styres av én mappe med navnet leaderstats. Denne guiden bygger den fra bunnen: et serverskript, en trygg måte å dele ut poeng på, lagring mellom økter og en global topp 10.

Oppdatert 20. november 20267 min lesingSkrevet av

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
  1. Slik virker leaderstats
  2. 1. Lag leaderstats
  3. 2. Del ut poeng
  4. 3. Lagring
  5. 4. Global topp 10
  6. Common errors
  7. Med RoCode
  8. Ofte stilte spørsmål
  9. Kilder og videre lesing

Slik virker leaderstats

IllustrasjonDe ferdige skriptene for leaderstats og myntplaten i et spill som kjører.

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.

Verdiobjekter du kan legge i leaderstats
ObjektLagrerPasser til
IntValueHeltallMynter, kills, seire, level
NumberValueDesimaltallBeste rundetid, distanse
StringValueTekstRang 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

  1. Hold musen over ServerScriptService i Explorer, klikk på knappen + og sett inn et Script.
  2. Gi det nytt navn, Leaderstats, så det er lett å finne senere.
  3. Bytt ut innholdet med koden nedenfor og trykk på Play. Navnet ditt vises i spillerlisten med Coins og Wins lik 0.
Script i ServerScriptService med navnet Leaderstats
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.

Script i en part i Workspace med navnet CoinPad
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.

Script i ServerScriptService med navnet Leaderstats
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.

  1. Legg til en anchored Part i Workspace, kall den WinsBoard og gi den størrelse som et skilt (for eksempel 12 ganger 8 ganger 1 stud) med forsiden mot spawnen.
  2. Sett inn et Script i ServerScriptService med navnet GlobalWinsBoard og koden nedenfor.
  3. Trykk på Play. Tavlen fylles etter første oppdatering og oppdateres hvert minutt.
Script i ServerScriptService med navnet GlobalWinsBoard
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.

Du skriver

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.

RoCode gjør
  • 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

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.

Prøv RoCode i ditt eget spill.

Gratis credits hver dag, uten kort. Installer pluginen, beskriv en funksjon og se hva som dukker opp i Studio.