Guide · Spelardata

Så gör du en topplista (leaderboard) i Roblox Studio

Spelarlistan i övre högra hörnet av ett Roblox-spel styrs av en enda mapp med namnet leaderstats. Den här guiden bygger den från grunden: serverskriptet, ett säkert sätt att dela ut poäng, sparande mellan sessioner och en global topp 10.

Uppdaterad 20 november 20267 min läsningSkriven av

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
  1. Så fungerar leaderstats
  2. 1. Skapa leaderstats
  3. 2. Dela ut poäng
  4. 3. Spara
  5. 4. Global topp 10
  6. Common errors
  7. Med RoCode
  8. Vanliga frågor
  9. Källor och vidare läsning

Så fungerar leaderstats

IllustrationDe färdiga skripten för leaderstats och myntplattan i ett spel som körs.

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.

Värdeobjekt som du kan lägga i leaderstats
ObjektLagrarPassar för
IntValueHeltalMynt, kills, vinster, nivå
NumberValueDecimaltalBästa varvtid, sträcka
StringValueTextRang 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

  1. I Explorer, håll muspekaren över ServerScriptService, klicka på knappen + och infoga ett Script.
  2. Byt namn på det till Leaderstats så att det är lätt att hitta senare.
  3. Ersätt innehållet med koden nedan och tryck på Play. Ditt namn visas i spelarlistan med Coins och Wins på 0.
Script i ServerScriptService med namnet Leaderstats
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.

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

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

  1. Lägg till en förankrad Part i Workspace, kalla den WinsBoard och gör den lika stor som en skylt (till exempel 12 gånger 8 gånger 1 stud), med framsidan mot spawnen.
  2. Infoga ett Script i ServerScriptService med namnet GlobalWinsBoard och koden nedan.
  3. Tryck på Play. Tavlan fylls efter den första uppdateringen och uppdateras sedan varje minut.
Script i ServerScriptService med namnet 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

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

Du skriver

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.

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

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.

Testa RoCode i ditt eget spel.

Gratis krediter varje dag, inget kort krävs. Installera pluginet, beskriv en funktion och kontrollera vad som dök upp i Studio.