Ve zkratce
Vytvořte Script v ServerScriptService, který poslouchá Players.PlayerAdded, vytvoří Folder s názvem přesně leaderstats (celý malými písmeny) a udělá ho potomkem hráče. Každý IntValue, NumberValue nebo StringValue uvnitř této složky se stane sloupcem v seznamu hráčů.
- Statistiky vytvářejte a měňte jen na serveru. Změnu provedenou LocalScriptem vidí jen tento hráč a nikdo jiný.
- leaderstats se neukládají. Hodnoty načítejte a ukládejte přes data store, pokud mají přežít do další relace.
- Pro žebříček přes všechny hráče zapisujte každé skóre do ordered data store a ukazujte ho na tabuli ve svém světě nebo v režimu Global seznamu hráčů.
Na této stránce
Jak leaderstats fungují
Roblox ukazuje seznam hráčů v každé hře. Když má hráč potomka Folder s názvem leaderstats, seznam přidá sloupec pro každý objekt hodnoty uvnitř a v řádku hráče ukáže jeho hodnotu. Záhlaví sloupce je Name objektu hodnoty.
| Objekt | Uchovává | Hodí se na |
|---|---|---|
IntValue | Celá čísla | Mince, zabití, výhry, úroveň |
NumberValue | Desetinná čísla | Nejlepší čas kola, vzdálenost |
StringValue | Text | Hodnost nebo titul týmu |
Dvě pravidla rozbijí skoro každý nefunkční leaderboard. Název složky musí být přesně leaderstats: Leaderstats nebo leaderStats se ignorují. A složku musí vytvořit serverový Script, protože jen změny na serveru se replikují všem hráčům. Pokud si nejste jistí, kde kód běží, přečtěte si nejdřív Script vs LocalScript vs ModuleScript (anglicky).
Krok 1: vytvořte skript leaderstats
- V Exploreru najeďte myší na ServerScriptService, klikněte na tlačítko + a vložte Script.
- Přejmenujte ho na
Leaderstats, abyste ho později snadno našli. - Nahraďte jeho obsah kódem níže a klikněte na Play. Vaše jméno se objeví v seznamu hráčů s Coins a Wins rovnými 0.
local Players = game:GetService("Players")
local function setupLeaderstats(player: Player)
local leaderstats = Instance.new("Folder")
leaderstats.Name = "leaderstats" -- název musí být přesně takový, celý malými písmeny
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če nastavujeme až nakonec, když už jsou hodnoty uvnitř
end
Players.PlayerAdded:Connect(setupLeaderstats)
-- Ve Studiu můžete přijít dřív, než se tento skript spustí, proto nastavíme ty, kdo už tu jsou
for _, player in Players:GetPlayers() do
setupLeaderstats(player)
end
Smyčka na konci je důležitá při testech ve Studiu: první hráč někdy přijde dřív, než je PlayerAdded připojený, a bez smyčky by zůstal bez statistik.
Krok 2: dávejte body bezpečně
Chcete-li statistiku změnit, nastavte její Value ze serverového skriptu. Tato plošina s mincemi dá 10 mincí, když se jí hráč dotkne. Touched se spouští mnohokrát za sekundu, dokud postava stojí na partu, proto skript drží krátký cooldown pro každého hráče.
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 se spustí mnohokrát za krok; tohle zabrání, aby jeden dotyk zaplatil desetkrá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") najde postavu, i když je part, který se dotkl, uvnitř doplňku, zatímco jednoduchá kontrola hit.Parent to mine.
Pokud se body dávají za něco, co hráč dělá na své obrazovce, například za kliknutí na tlačítko, LocalScript musí požádat server přes RemoteEvent a server musí rozhodnout, jestli zaplatí. Nikdy nedovolte klientovi posílat částku. Návod k RemoteEvents ukazuje tento vzor s kontrolou.
Čtyři hotové příklady: návod k první hře dává 1 Coin za každou minci, které se hráč na trati dotkne, a Win na cílové plošině po 3 mincích, návod ke clicker simulátoru dává Coins za kliknutí na tlačítko s limitem kliknutí na serveru, návod k meči přidá 1 do Kills tomu, kdo zasadil poslední úder před smrtí hráče, a návod ke zbraním ukazuje, jak započítat zabití, když výstřel sníží Health cíle na 0.
Krok 3: ukládejte statistiky mezi relacemi
leaderstats žijí jen tak dlouho jako server. Chcete-li uchovat mince a výhry, načtěte je z data store, když hráč přijde, a uložte je, když odchází. Tato verze nahrazuje skript z kroku 1. Nikdy neukládá hráče, jehož data se nenačetla: právě tato chyba maže postup ve většině zkopírovaných skriptů ukládání.
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
-- Volá se uvnitř každého pcall níže, takže ještě nepublikovaný place
-- (bez přístupu k data store) leaderboard stejně dostane
local function statsStore(): DataStore
return DataStoreService:GetDataStore("PlayerStats_v1")
end
-- Hráči, jejichž uložené statistiky se načetly. Ty, kdo tu nejsou, nikdy neukládáme,
-- takže neúspěšné načtení nepřepíše skuteč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)
-- Když se server vypíná, uložíme všechny před zavření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)
Pro malou hru to stačí. O opakovaných pokusech, UpdateAsync, limitech požadavků a ochraně proti dvěma serverům, které zapisují stejného hráče, čtěte dál v tutoriálu k DataStore.
Krok 4: globální top 10
leaderstats porovnávají jen hráče na jednom serveru. Pro globální žebříček potřebujete ordered data store: data store, který uchovává jedno číslo na klíč a umí vracet klíče seřazené podle hodnoty. Zapisujte do něj skóre každého hráče ze serveru a pak čtěte horní záznamy zpět.
Ukázat ho můžete dvěma způsoby. Seznam hráčů v Robloxu má režimy Friends a Global, které čtou ordered data store zaregistrovaný v Creator Hubu (v době psaní je to beta funkce, jeden aktivní leaderboard na hru). Nebo můžete žebříček nakreslit sami na tabuli ve svém světě: to funguje v každé hře a můžete ho vyzdobit, jak chcete. Skript níže dělá to druhé a skóre zapisuje s user ID hráče jako klíčem, což je stejný formát, jaký čeká leaderboard v Creator Hubu.
- Přidejte do Workspace ukotvený Part, pojmenujte ho
WinsBoarda udělejte ho velký jako cedule (například 12 na 8 na 1 stud), přední stěnou ke spawnu. - Vložte do ServerScriptService Script s názvem
GlobalWinsBoarda kódem níže. - Klikněte na Play. Tabule se naplní po první aktualizaci a bude se obnovovat každou minutu.
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
local winsBoard = DataStoreService:GetOrderedDataStore("GlobalWins_v1")
local TOP_N = 10
local REFRESH_SECONDS = 60
-- Tabule: ukotvený Part s názvem WinsBoard ve Workspace. Skript sám přidá
-- SurfaceGui a řádky, takže stačí postavit jen 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átí 10 největších hodnot jako první. Ordered data store uchovává jen celá čísla, proto skóre ukládejte jako celá. Skript zapisuje každého hráče jednou za minutu a top 10 čte jednou za minutu, s velkou rezervou uvnitř standardních limitů na server (30 + 5 na hráče za minutu pro zápisy do ordered data store a 5 + 2 na hráče pro seřazená čtení, podle dokumentace k 30. září 2026).
Časté chyby a řešení
Problémy níže pokrývají většinu stížností „můj leaderboard nefunguje“. Nejdřív zkontrolujte okno Output (otevřete ho z menu Window ve Studiu nebo na kartě Script): pokud skript spadl s chybou, bude tam číslo řádku.
Leaderboard se vůbec nezobrazuje
Ověřte, že se složka jmenuje leaderstats malými písmeny, že jejím rodičem je Player (ne postava) a že kód je Script v ServerScriptService, ne LocalScript.
Ostatní hráči nevidí změny mé statistiky
Hodnota se změnila na klientu. Přesuňte změnu do serverového Scriptu, a pokud ji spouští tlačítko nebo klávesa, pošlete RemoteEvent a ať hodnotu mění server.
attempt to index nil with 'Coins'
Kód se pokusil přečíst player.leaderstats.Coins dřív, než se složka objevila, nebo je název napsaný jinak. Na serveru používejte FindFirstChild a výsledek kontrolujte; v LocalScriptu používejte player:WaitForChild("leaderstats"). Návod k chybám ve skriptech tuto chybu podrobně rozebírá.
Mince přibývají o 10, 20 nebo 50 z jednoho dotyku
Touched se spouští znovu a znovu, dokud se party překrývají. Přidejte cooldown pro každého hráče jako v kroku 2, nebo předmět po sebrání smažte.
Statistiky se při každém novém připojení vynulují
Roblox leaderstats neukládá. Přidejte skript z kroku 3. Chcete-li ukládání otestovat ve Studiu, publikujte place a zapněte Studio Access to API Services v Experience Settings.
Udělat s RoCode
Pokud se vám to nechce stavět ručně, RoCode to všechno může postavit uvnitř vašeho otevřeného place. Je to AI agent, který pracuje přes plugin pro Roblox Studio, takže vytváří skripty a party ve vašem Exploreru, místo aby vám dal kód k vložení.
Přidej leaderboard s Coins a Wins, který se ukládá mezi relacemi, a tabuli top 10 podle výher na partu u spawnu.
- Může v place nejdřív vyhledat existující kód leaderstats nebo DataStore, aby doplnil to, co máte, a nepřidával druhý leaderboard
- Vytvoří serverový skript v ServerScriptService a part pro tabuli ve Workspace
- Před dokončením ověří kompilaci napsaných skriptů uvnitř Studia
- Posílá změny po dávkách a každá dávka se v historii Studia označí jako bod pro vrácení
Výsledek stejně kontrolujete vy a statistiky i ukládání ve hře testujete sami: s pluginem 3.9 nebo novějším může RoCode spustit krátký playtest a přečíst chyby a s pluginem 3.9.11 nebo novějším ovládat testovací postavu a kontrolovat hodnoty jako Coins a Wins, ale kontroluje jen to, co si sám vybral k testu. Leaderstats jsou obvykle první z mnoha systémů hry: postavte zbytek hry po jednom systému na požadavek stejným způsobem. Jak se RoCode připojuje ke Studiu.
Časté otázky
Co jsou leaderstats v Robloxu?
Folder s názvem přesně leaderstats, celý malými písmeny, uvnitř Player. Roblox ukazuje každý IntValue, NumberValue nebo StringValue v ní jako sloupec v seznamu hráčů. Vytvářejte ho ze serverového Scriptu jako v kroku 1.
Jak udělat globální leaderboard v Robloxu?
Zapisujte skóre každého hráče do ordered data store ze serveru, pak čtěte horní záznamy zpět a ukazujte je na tabuli ve svém světě. V kroku 4 je celý skript pro top 10.
Ukládá Roblox leaderstats automaticky?
Ne. leaderstats existují, jen dokud je hráč na serveru. Hodnoty ukládejte přes data store, když hráč odchází, a načítejte je, když přichází, jako v kroku 3.
Dá se hodnota z leaderboardu skrýt?
Ano. Zobrazují se jen hodnoty uvnitř složky leaderstats. Soukromá data uchovávejte v jiné složce u hráče nebo v tabulce v serverovém skriptu.
Jak skrýt celý seznam hráčů?
Z LocalScriptu zavolejte StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, false). Předejte true a znovu ho ukážete.
Můžu na mince použít NumberValue?
Můžete, ale pro měnu z celých čísel se lépe hodí IntValue a ordered data store přijímá jen celá čísla, pokud podle nich později budete chtít stavět žebříček.
Zdroje a další čtení
- Roblox Creator Docs: Leaderboards (anglicky). leaderstats, pořadí statistik a trvalé režimy Friends a Global
- Roblox Creator Docs: Data stores (anglicky). GetAsync, SetAsync, ordered data stores a limity
Jak byl kód ověřen: každý skript na této stránce prochází přísnou kontrolou typů Luau s definicemi Roblox API (luau-lsp, 20. listopadu 2026). Kontrola typů zachytí chyby v názvech API a špatné typy, ale ne chyby v herní logice, proto vše otestujte ve Studiu před publikováním.