Návod · Dáta hráča

Ako urobiť leaderboard v Roblox Studiu

Zoznam hráčov v pravom hornom rohu hry v Robloxe riadi jeden priečinok s názvom leaderstats. Tento návod ho postaví od nuly: serverový skript, bezpečný spôsob, ako dávať body, ukladanie medzi reláciami a globálna top 10.

Aktualizované 20. novembra 20267 min čítaniaAutor:

V skratke

Vytvorte Script v ServerScriptService, ktorý počúva Players.PlayerAdded, vytvorí Folder s názvom presne leaderstats (celý malými písmenami) a urobí ho potomkom hráča. Každý IntValue, NumberValue alebo StringValue vnútri tohto priečinka sa stane stĺpcom v zozname hráčov.

  • Štatistiky vytvárajte a meňte len na serveri. Zmenu urobenú LocalScriptom vidí len tento hráč a nikto iný.
  • leaderstats sa neukladajú. Hodnoty načítavajte a ukladajte cez data store, ak majú prežiť do ďalšej relácie.
  • Pre rebríček cez všetkých hráčov zapisujte každé skóre do ordered data store a ukazujte ho na tabuli vo svojom svete alebo v režime Global zoznamu hráčov.
Na tejto stránke
  1. Ako fungujú leaderstats
  2. 1. Vytvoriť leaderstats
  3. 2. Pridávanie bodov
  4. 3. Ukladanie
  5. 4. Globálna top 10
  6. Common errors
  7. S RoCode
  8. Časté otázky
  9. Zdroje a ďalšie čítanie

Ako leaderstats fungujú

IlustráciaHotové skripty leaderstats a plošiny s mincami v spustenej hre.

Roblox ukazuje zoznam hráčov v každej hre. Keď má hráč potomka Folder s názvom leaderstats, zoznam pridá stĺpec pre každý objekt hodnoty vnútri a v riadku hráča ukáže jeho hodnotu. Hlavička stĺpca je Name objektu hodnoty.

Objekty hodnôt, ktoré môžete dať do leaderstats
ObjektUchovávaHodí sa na
IntValueCelé číslaMince, zabitia, výhry, úroveň
NumberValueDesatinné číslaNajlepší čas kola, vzdialenosť
StringValueTextHodnosť alebo titul tímu

Dve pravidlá rozbijú takmer každý nefunkčný leaderboard. Názov priečinka musí byť presne leaderstats: Leaderstats alebo leaderStats sa ignorujú. A priečinok musí vytvoriť serverový Script, pretože len zmeny na serveri sa replikujú všetkým hráčom. Ak si nie ste istí, kde kód beží, prečítajte si najprv Script vs LocalScript vs ModuleScript (po anglicky).

Krok 1: vytvorte skript leaderstats

  1. V Exploreri prejdite myšou na ServerScriptService, kliknite na tlačidlo + a vložte Script.
  2. Premenujte ho na Leaderstats, aby ste ho neskôr ľahko našli.
  3. Nahraďte jeho obsah kódom nižšie a kliknite na Play. Vaše meno sa objaví v zozname hráčov s Coins a Wins rovnými 0.
Script v ServerScriptService s názvom Leaderstats
local Players = game:GetService("Players")

local function setupLeaderstats(player: Player)
	local leaderstats = Instance.new("Folder")
	leaderstats.Name = "leaderstats" -- názov musí byť presne taký, celý malými písmenami

	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 -- rodiča nastavujeme až na konci, keď sú hodnoty už vnútri
end

Players.PlayerAdded:Connect(setupLeaderstats)

-- V Studiu môžete prísť skôr, ako sa tento skript spustí, preto nastavíme tých, ktorí už sú tu
for _, player in Players:GetPlayers() do
	setupLeaderstats(player)
end

Slučka na konci je dôležitá pri testoch v Studiu: prvý hráč niekedy príde skôr, ako je PlayerAdded pripojený, a bez slučky by zostal bez štatistík.

Krok 2: dávajte body bezpečne

Ak chcete štatistiku zmeniť, nastavte jej Value zo serverového skriptu. Táto plošina s mincami dá 10 mincí, keď sa jej hráč dotkne. Touched sa spúšťa mnohokrát za sekundu, kým postava stojí na parte, preto skript drží krátky cooldown pre každého hráča.

Script v parte vo Workspace s názvom 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 sa spustí mnohokrát za krok; toto zabráni, aby jeden dotyk zaplatil desaťkrát
	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") nájde postavu, aj keď je part, ktorý sa dotkol, vnútri doplnku, zatiaľ čo jednoduchá kontrola hit.Parent ju minie.

Ak sa body dávajú za niečo, čo hráč robí na svojej obrazovke, napríklad za kliknutie na tlačidlo, LocalScript musí požiadať server cez RemoteEvent a server musí rozhodnúť, či zaplatí. Nikdy nedovoľte klientovi posielať sumu. Návod na RemoteEvents ukazuje tento vzor s kontrolou.

Štyri hotové príklady: návod na prvú hru dáva 1 Coin za každú mincu, ktorej sa hráč na trati dotkne, a Win na cieľovej plošine po 3 minciach, návod na clicker simulátor dáva Coins za kliknutie na tlačidlo s limitom kliknutí na serveri, návod na meč pridá 1 do Kills tomu, kto zasadil posledný úder pred smrťou hráča, a návod na zbrane ukazuje, ako započítať zabitie, keď výstrel zníži Health cieľa na 0.

Krok 3: ukladajte štatistiky medzi reláciami

leaderstats žijú len tak dlho ako server. Ak chcete uchovať mince a výhry, načítajte ich z data store, keď hráč príde, a uložte ich, keď odchádza. Táto verzia nahrádza skript z kroku 1. Nikdy neukladá hráča, ktorého dáta sa nenačítali: práve táto chyba maže postup vo väčšine skopírovaných skriptov ukladania.

Script v ServerScriptService s názvom Leaderstats
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")

-- Volá sa vnútri každého pcall nižšie, takže ešte nepublikovaný place
-- (bez prístupu k data store) leaderboard aj tak dostane
local function statsStore(): DataStore
	return DataStoreService:GetDataStore("PlayerStats_v1")
end

-- Hráči, ktorých uložené štatistiky sa načítali. Tých, ktorí tu nie sú, nikdy neukladáme,
-- takže neúspešné načítanie neprepíše skutočný postup nulami.
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)

-- Keď sa server vypína, uložíme všetkých pred zatvorením
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)

Pre malú hru to stačí. O opakovaných pokusoch, UpdateAsync, limitoch požiadaviek a ochrane proti dvom serverom, ktoré zapisujú toho istého hráča, čítajte ďalej v návode na DataStore.

Krok 4: globálna top 10

leaderstats porovnávajú len hráčov na jednom serveri. Pre globálny rebríček potrebujete ordered data store: data store, ktorý uchováva jedno číslo na kľúč a vie vracať kľúče zoradené podľa hodnoty. Zapisujte doň skóre každého hráča zo servera a potom čítajte horné záznamy späť.

Ukázať ho môžete dvoma spôsobmi. Zoznam hráčov v Robloxe má režimy Friends a Global, ktoré čítajú ordered data store zaregistrovaný v Creator Hube (v čase písania je to beta funkcia, jeden aktívny leaderboard na hru). Alebo môžete rebríček nakresliť sami na tabuli vo svojom svete: to funguje v každej hre a môžete ho vyzdobiť, ako chcete. Skript nižšie robí to druhé a skóre zapisuje s user ID hráča ako kľúčom, čo je rovnaký formát, aký čaká leaderboard v Creator Hube.

  1. Pridajte do Workspace ukotvený Part, pomenujte ho WinsBoard a urobte ho veľký ako tabuľa (napríklad 12 na 8 na 1 stud), prednou stenou k spawnu.
  2. Vložte do ServerScriptService Script s názvom GlobalWinsBoard a kódom nižšie.
  3. Kliknite na Play. Tabuľa sa naplní po prvej aktualizácii a bude sa obnovovať každú minútu.
Script v ServerScriptService s názvom 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

-- Tabuľa: ukotvený Part s názvom WinsBoard vo Workspace. Skript sám pridá
-- SurfaceGui a riadky, takže stačí postaviť len 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) vráti 10 najväčších hodnôt ako prvé. Ordered data store uchováva len celé čísla, preto skóre ukladajte ako celé. Skript zapisuje každého hráča raz za minútu a top 10 číta raz za minútu, s veľkou rezervou vnútri štandardných limitov na server (30 + 5 na hráča za minútu pre zápisy do ordered data store a 5 + 2 na hráča pre zoradené čítania, podľa dokumentácie k 30. septembru 2026).

Časté chyby a riešenia

Problémy nižšie pokrývajú väčšinu sťažností „môj leaderboard nefunguje“. Najprv skontrolujte okno Output (otvorte ho z menu Window v Studiu alebo na karte Script): ak skript spadol s chybou, bude tam číslo riadku.

Leaderboard sa vôbec nezobrazuje

Overte, že sa priečinok volá leaderstats malými písmenami, že jeho rodičom je Player (nie postava) a že kód je Script v ServerScriptService, nie LocalScript.

Ostatní hráči nevidia zmeny mojej štatistiky

Hodnota sa zmenila na klientovi. Presuňte zmenu do serverového Scriptu, a ak ju spúšťa tlačidlo alebo kláves, pošlite RemoteEvent a nech hodnotu mení server.

attempt to index nil with 'Coins'

Kód sa pokúsil prečítať player.leaderstats.Coins skôr, ako sa priečinok objavil, alebo je názov napísaný inak. Na serveri používajte FindFirstChild a výsledok kontrolujte; v LocalScripte používajte player:WaitForChild("leaderstats"). Návod na chyby v skriptoch túto chybu podrobne rozoberá.

Mince pribúdajú o 10, 20 alebo 50 z jedného dotyku

Touched sa spúšťa znova a znova, kým sa party prekrývajú. Pridajte cooldown pre každého hráča ako v kroku 2 alebo predmet po zobratí zmažte.

Štatistiky sa pri každom novom pripojení vynulujú

Roblox leaderstats neukladá. Pridajte skript z kroku 3. Ak chcete ukladanie otestovať v Studiu, publikujte place a zapnite Studio Access to API Services v Experience Settings.

Urobiť s RoCode

Ak sa vám to nechce stavať ručne, RoCode to všetko môže postaviť vnútri vášho otvoreného place. Je to AI agent, ktorý pracuje cez plugin pre Roblox Studio, takže vytvára skripty a party vo vašom Exploreri, namiesto toho, aby vám dal kód na vloženie.

Napíšete

Pridaj leaderboard s Coins a Wins, ktorý sa ukladá medzi reláciami, a tabuľu top 10 podľa výhier na parte pri spawne.

RoCode urobí
  • Môže v place najprv vyhľadať existujúci kód leaderstats alebo DataStore, aby doplnil to, čo máte, a nepridával druhý leaderboard
  • Vytvorí serverový skript v ServerScriptService a part pre tabuľu vo Workspace
  • Pred dokončením overí kompiláciu napísaných skriptov vnútri Studia
  • Posiela zmeny po dávkach a každá dávka sa v histórii Studia označí ako bod na vrátenie

Výsledok aj tak kontrolujete vy a štatistiky aj ukladanie v hre testujete sami: s pluginom 3.9 alebo novším môže RoCode spustiť krátky playtest a prečítať chyby a s pluginom 3.9.11 alebo novším ovládať testovaciu postavu a kontrolovať hodnoty ako Coins a Wins, ale kontroluje len to, čo si sám vybral na test. Leaderstats sú zvyčajne prvý z mnohých systémov hry: postavte zvyšok hry po jednom systéme na požiadavku rovnakým spôsobom. Ako sa RoCode pripája k Studiu.

Časté otázky

Čo sú leaderstats v Robloxe?

Folder s názvom presne leaderstats, celý malými písmenami, vnútri Player. Roblox ukazuje každý IntValue, NumberValue alebo StringValue v ňom ako stĺpec v zozname hráčov. Vytvárajte ho zo serverového Scriptu ako v kroku 1.

Ako urobiť globálny leaderboard v Robloxe?

Zapisujte skóre každého hráča do ordered data store zo servera, potom čítajte horné záznamy späť a ukazujte ich na tabuli vo svojom svete. V kroku 4 je celý skript pre top 10.

Ukladá Roblox leaderstats automaticky?

Nie. leaderstats existujú, len kým je hráč na serveri. Hodnoty ukladajte cez data store, keď hráč odchádza, a načítavajte ich, keď prichádza, ako v kroku 3.

Dá sa hodnota z leaderboardu skryť?

Áno. Zobrazujú sa len hodnoty vnútri priečinka leaderstats. Súkromné dáta uchovávajte v inom priečinku pri hráčovi alebo v tabuľke v serverovom skripte.

Ako skryť celý zoznam hráčov?

Z LocalScriptu zavolajte StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, false). Odovzdajte true a znova ho ukážete.

Môžem na mince použiť NumberValue?

Môžete, ale pre menu z celých čísel sa lepšie hodí IntValue a ordered data store prijíma len celé čísla, ak podľa nich neskôr budete chcieť stavať rebríček.

Zdroje a ďalšie čítanie

Ako bol kód overený: každý skript na tejto stránke prechádza prísnou kontrolou typov Luau s definíciami Roblox API (luau-lsp, 20. novembra 2026). Kontrola typov zachytí chyby v názvoch API a nesprávne typy, ale nie chyby v hernej logike, preto všetko pred publikovaním otestujte v Studiu.

Vyskúšajte RoCode vo svojej hre.

Kredity zadarmo každý deň, bez karty. Nainštalujte plugin, opíšte funkciu a pozrite sa, čo sa objaví v Studiu.