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
Ako leaderstats fungujú
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.
| Objekt | Uchováva | Hodí sa na |
|---|---|---|
IntValue | Celé čísla | Mince, zabitia, výhry, úroveň |
NumberValue | Desatinné čísla | Najlepší čas kola, vzdialenosť |
StringValue | Text | Hodnosť 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
- V Exploreri prejdite myšou na ServerScriptService, kliknite na tlačidlo + a vložte Script.
- Premenujte ho na
Leaderstats, aby ste ho neskôr ľahko našli. - 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.
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.
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.
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.
- Pridajte do Workspace ukotvený Part, pomenujte ho
WinsBoarda urobte ho veľký ako tabuľa (napríklad 12 na 8 na 1 stud), prednou stenou k spawnu. - Vložte do ServerScriptService Script s názvom
GlobalWinsBoarda kódom nižšie. - Kliknite na Play. Tabuľa sa naplní po prvej aktualizácii a bude sa obnovovať každú minútu.
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.
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.
- 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
- Roblox Creator Docs: Leaderboards (po anglicky). leaderstats, poradie štatistík a trvalé režimy Friends a Global
- Roblox Creator Docs: Data stores (po anglicky). GetAsync, SetAsync, ordered data stores a limity
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.