Tutorial · Spillerdata

Sådan laver du et leaderboard i Roblox Studio

Spillerlisten øverst til højre i et Roblox-spil styres af én mappe med navnet leaderstats. Denne guide bygger den fra bunden: et serverscript, en sikker måde at uddele point på, gemning mellem sessioner og en global top 10.

Opdateret 20. november 20267 min. læsningSkrevet af

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
  1. Sådan virker leaderstats
  2. 1. Opret leaderstats
  3. 2. Uddel point
  4. 3. Gemning
  5. 4. Global top 10
  6. Common errors
  7. Med RoCode
  8. Ofte stillede spørgsmål
  9. Kilder og videre læsning

Sådan virker leaderstats

IllustrationDe færdige scripts til leaderstats og møntpladen i et kørende spil.

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.

Værdiobjekter, du kan lægge i leaderstats
ObjektGemmerPasser til
IntValueHeltalMønter, kills, sejre, level
NumberValueDecimaltalBedste omgangstid, distance
StringValueTekstRang 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

  1. Hold musen over ServerScriptService i Explorer, klik på knappen +, og indsæt et Script.
  2. Omdøb det til Leaderstats, så det er nemt at finde senere.
  3. Erstat indholdet med koden nedenfor, og tryk på Play. Dit navn vises i spillerlisten med Coins og Wins lig med 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 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.

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 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.

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

  1. 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.
  2. Indsæt et Script i ServerScriptService med navnet GlobalWinsBoard og koden nedenfor.
  3. Tryk på Play. Tavlen fyldes efter første opdatering og opdateres hvert minut.
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. 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.

Du skriver

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.

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

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.

Prøv RoCode i dit eget spil.

Gratis credits hver dag, intet kort. Installér pluginet, beskriv en funktion, og se hvad der dukker op i Studio.