Pe scurt
Creează un Script în ServerScriptService care ascultă Players.PlayerAdded, creează un Folder numit exact leaderstats (numai cu litere mici) și îl face copil al jucătorului. Fiecare IntValue, NumberValue sau StringValue din acest folder devine o coloană în lista de jucători.
- Creează și schimbă statisticile doar pe server. O schimbare făcută de un LocalScript o vede doar acel jucător și nimeni altcineva.
- leaderstats nu se salvează. Încarcă și salvează valorile printr-un data store dacă trebuie să ajungă până la sesiunea următoare.
- Pentru un clasament al tuturor jucătorilor, scrie fiecare scor într-un ordered data store și arată-l pe un panou din lumea ta sau în modul Global al listei de jucători.
Pe această pagină
Cum funcționează leaderstats
Roblox arată o listă de jucători în fiecare joc. Când un jucător are un Folder copil numit leaderstats, lista adaugă o coloană pentru fiecare obiect-valoare din el și arată valoarea acelui jucător pe rândul lui. Titlul coloanei e Name-ul obiectului-valoare.
| Obiect | Păstrează | Potrivit pentru |
|---|---|---|
IntValue | Numere întregi | Monede, eliminări, victorii, nivel |
NumberValue | Numere zecimale | Cel mai bun timp pe tur, distanță |
StringValue | Text | Rang sau titlu de echipă |
Două reguli strică aproape fiecare clasament care nu merge. Numele folderului trebuie să fie exact leaderstats: Leaderstats sau leaderStats sunt ignorate. Iar folderul trebuie creat de un Script de server, pentru că doar schimbările de pe server se replică la toți jucătorii. Dacă nu ești sigur unde rulează codul, citește întâi Script vs LocalScript vs ModuleScript (în engleză).
Pasul 1: creează scriptul leaderstats
- În Explorer treci cu mouse-ul peste ServerScriptService, apasă butonul + și inserează un Script.
- Redenumește-l în
Leaderstats, ca să-l găsești ușor mai târziu. - Înlocuiește-i conținutul cu codul de mai jos și apasă Play. Numele tău apare în lista de jucători cu Coins și Wins egale cu 0.
local Players = game:GetService("Players")
local function setupLeaderstats(player: Player)
local leaderstats = Instance.new("Folder")
leaderstats.Name = "leaderstats" -- numele trebuie să fie exact așa, numai cu litere mici
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 -- părintele îl setăm la final, când valorile sunt deja înăuntru
end
Players.PlayerAdded:Connect(setupLeaderstats)
-- În Studio poți intra înainte să pornească acest script, așa că îi configurăm pe cei deja aici
for _, player in Players:GetPlayers() do
setupLeaderstats(player)
end
Bucla de la final contează la testele din Studio: primul jucător intră uneori înainte să fie conectat PlayerAdded și fără buclă ar rămâne fără statistici.
Pasul 2: dă puncte în siguranță
Ca să schimbi o statistică, setează-i Value dintr-un script de server. Această platformă cu monede dă 10 monede când un jucător o atinge. Touched se declanșează de multe ori pe secundă cât personajul stă pe part, așa că scriptul ține un cooldown scurt pentru fiecare jucător.
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 declanșează de multe ori pe pas; asta împiedică o singură atingere să plătească de zece ori
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") găsește personajul chiar și când part-ul care a atins e într-un accesoriu, iar o simplă verificare hit.Parent ratează asta.
Dacă punctele se dau pentru ce face jucătorul pe ecranul lui, de exemplu pentru apăsarea unui buton, LocalScript-ul trebuie să-i ceară serverului printr-un RemoteEvent, iar serverul trebuie să decidă dacă plătește. Nu lăsa niciodată clientul să trimită suma. Ghidul despre RemoteEvents arată acest tipar cu verificare.
Patru exemple gata făcute: ghidul despre primul joc dă 1 Coin pentru fiecare monedă atinsă de jucător pe traseu și un Win pe platforma de final după 3 monede, ghidul despre clicker simulator dă Coins pentru apăsările unui buton, cu o limită de clicuri pe server, ghidul despre sabie adaugă 1 la Kills celui care a dat ultima lovitură înainte de moartea unui jucător, iar ghidul despre arme arată cum numeri o eliminare când o împușcătură duce Health-ul țintei la 0.
Pasul 3: salvează statisticile între sesiuni
leaderstats trăiește doar cât trăiește serverul. Ca să păstrezi monedele și victoriile, încarcă-le dintr-un data store când jucătorul intră și salvează-le când iese. Versiunea asta înlocuiește scriptul de la pasul 1. Nu salvează niciodată un jucător ale cărui date nu s-au încărcat: exact greșeala asta șterge progresul în cele mai multe scripturi de salvare copiate.
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
-- Se apelează în fiecare pcall de mai jos, așa că un place încă nepublicat
-- (fără acces la data store) primește totuși clasamentul
local function statsStore(): DataStore
return DataStoreService:GetDataStore("PlayerStats_v1")
end
-- Jucătorii ale căror statistici salvate s-au încărcat. Pe cei care nu sunt aici nu-i salvăm niciodată,
-- așa că o încărcare eșuată nu va suprascrie progresul real cu zerouri.
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)
-- Când serverul se oprește, îi salvăm pe toți înainte de închidere
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)
Pentru un joc mic, asta ajunge. Despre reîncercări, UpdateAsync, limitele de cereri și protecția contra a două servere care scriu același jucător citește mai departe în tutorialul DataStore.
Pasul 4: un top 10 global
leaderstats compară doar jucătorii de pe același server. Pentru un clasament global îți trebuie un ordered data store: un data store care păstrează un număr pe cheie și știe să returneze cheile sortate după valoare. Scrie în el scorul fiecărui jucător de pe server, apoi citește înapoi primele intrări.
Îl poți arăta în două feluri. Lista de jucători Roblox are modurile Friends și Global, care citesc un ordered data store înregistrat în Creator Hub (la momentul scrierii e o funcție beta, un singur clasament activ pe joc). Sau poți desena singur clasamentul pe un panou din lumea ta: merge în orice joc și îți permite să-l aranjezi cum vrei. Scriptul de mai jos face a doua variantă, iar scorurile le scrie cu user ID-ul jucătorului drept cheie, același format pe care îl așteaptă clasamentul din Creator Hub.
- Adaugă în Workspace un Part ancorat, numește-l
WinsBoardși fă-l de mărimea unei firme (de exemplu 12 pe 8 pe 1 stud), cu fața din față spre spawn. - Inserează în ServerScriptService un Script numit
GlobalWinsBoardcu codul de mai jos. - Apasă Play. Panoul se umple după prima actualizare și se actualizează în fiecare minut.
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
local winsBoard = DataStoreService:GetOrderedDataStore("GlobalWins_v1")
local TOP_N = 10
local REFRESH_SECONDS = 60
-- Panoul: un Part ancorat numit WinsBoard în Workspace. Scriptul adaugă singur
-- SurfaceGui-ul și rândurile, așa că trebuie să construiești doar Part-ul.
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) returnează primele cele mai mari 10 valori. Un ordered data store păstrează doar numere întregi, așa că ține scorurile ca întregi. Scriptul scrie fiecare jucător o dată pe minut și citește topul 10 o dată pe minut, cu mult sub limitele standard pe server (30 + 5 pe jucător pe minut pentru scrierile într-un ordered data store și 5 + 2 pe jucător pentru citirile sortate, conform documentației la 30 septembrie 2026).
Erori frecvente și soluții
Problemele de mai jos acoperă cele mai multe plângeri de tipul „nu-mi merge clasamentul”. Verifică întâi fereastra Output (o deschizi din meniul Window din Studio sau din fila Script): dacă scriptul a căzut cu o eroare, acolo e numărul rândului.
Clasamentul nu apare deloc
Verifică dacă folderul se numește leaderstats cu litere mici, dacă părintele lui e Player-ul (nu personajul) și dacă codul e un Script în ServerScriptService, nu un LocalScript.
Ceilalți jucători nu văd schimbările statisticii mele
Valoarea a fost schimbată pe client. Mută schimbarea într-un Script de server, iar dacă o declanșează un buton sau o tastă, trimite un RemoteEvent și lasă serverul să schimbe valoarea.
attempt to index nil with 'Coins'
Codul a încercat să citească player.leaderstats.Coins înainte să apară folderul sau numele e scris altfel. Pe server folosește FindFirstChild și verifică rezultatul; într-un LocalScript folosește player:WaitForChild("leaderstats"). Ghidul despre erorile din scripturi explică această eroare în detaliu.
Monedele cresc cu 10, 20 sau 50 de la o singură atingere
Touched se declanșează iar și iar cât part-urile se suprapun. Adaugă un cooldown pentru fiecare jucător, ca la pasul 2, sau șterge obiectul după ridicare.
Statisticile se resetează la fiecare reintrare
Roblox nu salvează leaderstats. Adaugă scriptul de la pasul 3. Ca să verifici salvarea în Studio, publică place-ul și activează Studio Access to API Services în Experience Settings.
Fă-o cu RoCode
Dacă nu ai chef să construiești asta manual, RoCode poate construi totul în place-ul pe care îl ai deschis. E un agent AI care lucrează printr-un plugin Roblox Studio, așa că creează scripturile și part-urile în Explorer-ul tău, în loc să-ți dea cod de lipit.
Adaugă un clasament cu Coins și Wins care se salvează între sesiuni și un panou top 10 după victorii pe un part lângă spawn.
- Poate căuta întâi în place cod existent de leaderstats sau DataStore, ca să completeze ce există în loc să adauge un al doilea clasament
- Creează scriptul de server în ServerScriptService și part-ul pentru panou în Workspace
- Verifică în Studio compilarea scripturilor scrise înainte să termine
- Trimite modificările în loturi, iar fiecare lot e marcat ca punct de anulare în istoria Studio
Rezultatul tot tu îl verifici și tot tu testezi în joc statisticile și salvarea: cu pluginul 3.9 sau mai nou, RoCode poate porni un playtest scurt și citi erorile, iar cu pluginul 3.9.11 sau mai nou poate controla un personaj de test și verifica valori precum Coins și Wins, dar verifică doar ce a ales el să testeze. Leaderstats e de obicei primul dintre multe sisteme ale unui joc: construiește restul jocului câte un sistem pe cerere în același fel. Cum se conectează RoCode la Studio.
Întrebări frecvente
Ce e leaderstats în Roblox?
Un Folder numit exact leaderstats, numai cu litere mici, în Player. Roblox arată fiecare IntValue, NumberValue sau StringValue din el ca o coloană în lista de jucători. Creează-l dintr-un Script de server, ca la pasul 1.
Cum faci un clasament global în Roblox?
Scrie scorul fiecărui jucător într-un ordered data store de pe server, apoi citește înapoi primele intrări și arată-le pe un panou din lumea ta. La pasul 4 e scriptul complet pentru top 10.
Salvează Roblox automat leaderstats?
Nu. leaderstats există doar cât jucătorul e pe server. Salvează valorile printr-un data store când jucătorul iese și încarcă-le când intră, ca la pasul 3.
Pot ascunde o valoare din clasament?
Da. Se arată doar valorile din folderul leaderstats. Ține datele private în alt folder al jucătorului sau într-un tabel dintr-un script de server.
Cum ascund toată lista de jucători?
Dintr-un LocalScript apelează StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, false). Transmite true ca s-o arăți din nou.
Pot folosi NumberValue pentru monede?
Poți, dar pentru o monedă din numere întregi IntValue se potrivește mai bine, iar un ordered data store acceptă doar întregi, dacă mai târziu vrei să faci un clasament după ele.
Surse și lecturi suplimentare
- Roblox Creator Docs: Leaderboards (în engleză). leaderstats, ordinea statisticilor și modurile permanente Friends și Global
- Roblox Creator Docs: Data stores (în engleză). GetAsync, SetAsync, ordered data stores și limite
Cum a fost verificat codul: fiecare script de pe această pagină trece printr-o verificare strictă a tipurilor Luau cu definițiile API Roblox (luau-lsp, 20 noiembrie 2026). Verificarea tipurilor prinde nume greșite de API și tipuri greșite, dar nu și greșelile de logică a jocului, așa că testează totul în Studio înainte să publici.