Накратко
Създай Script в ServerScriptService, който слуша Players.PlayerAdded, създава Folder с име точно leaderstats (всичко с малки букви) и го прави дете на играча. Всеки IntValue, NumberValue или StringValue в тази папка става колона в списъка с играчи.
- Създавай и променяй статистиката само на сървъра. Промяна, направена от LocalScript, вижда само този играч и никой друг.
- leaderstats не се запазва. Зареждай и запазвай стойностите през data store, ако трябва да оцелеят до следващата сесия.
- За класация на всички играчи записвай всеки резултат в ordered data store и го показвай на табло в твоя свят или в режим Global на списъка с играчи.
На тази страница
Как работи leaderstats
Roblox показва списък с играчи във всяка игра. Когато играчът има дете Folder с име leaderstats, списъкът добавя колона за всеки обект стойност вътре и показва стойността на този играч в неговия ред. Заглавието на колоната е Name на обекта стойност.
| Обект | Пази | Подходящ за |
|---|---|---|
IntValue | Цели числа | Монети, убийства, победи, ниво |
NumberValue | Дробни числа | Най-добро време за обиколка, разстояние |
StringValue | Текст | Ранг или звание на отбора |
Две правила развалят почти всяка неработеща класация. Името на папката трябва да е точно leaderstats: Leaderstats или leaderStats се пренебрегват. И папката трябва да я създава сървърен Script, защото само промените на сървъра се репликират до всички играчи. Ако не си сигурен къде се изпълнява кодът, първо прочети Script vs LocalScript vs ModuleScript (на английски).
Стъпка 1: създай скрипта за leaderstats
- В Explorer задръж курсора върху ServerScriptService, натисни бутона + и вмъкни Script.
- Преименувай го на
Leaderstats, за да го намираш лесно после. - Замени съдържанието му с кода по-долу и натисни Play. Името ти ще се появи в списъка с играчи с Coins и Wins, равни на 0.
local Players = game:GetService("Players")
local function setupLeaderstats(player: Player)
local leaderstats = Instance.new("Folder")
leaderstats.Name = "leaderstats" -- името трябва да е точно такова, всичко с малки букви
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 -- родителя задаваме последен, когато стойностите вече са вътре
end
Players.PlayerAdded:Connect(setupLeaderstats)
-- В Studio можеш да влезеш преди този скрипт да тръгне, затова настройваме и тези, които вече са тук
for _, player in Players:GetPlayers() do
setupLeaderstats(player)
end
Цикълът в края е важен при тестове в Studio: първият играч понякога влиза преди PlayerAdded да е свързан и без цикъла щеше да остане без статистика.
Стъпка 2: давай точки безопасно
За да промениш характеристика, задай нейния Value от сървърен скрипт. Тази площадка с монети дава 10 монети, когато играч я докосне. Touched се задейства много пъти в секунда, докато персонажът стои на парта, затова скриптът пази кратко презареждане за всеки играч.
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 се задейства много пъти на стъпка; това не позволява едно докосване да плати десет пъти
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") намира персонажа дори когато докосналият парт е вътре в аксесоар, а простата проверка hit.Parent това го пропуска.
Ако точките се дават за нещо, което играчът прави на своя екран, например натискане на бутон, LocalScript трябва да помоли сървъра през RemoteEvent, а сървърът да реши дали да плати. Никога не позволявай на клиента да праща сумата. Ръководството за RemoteEvents показва този шаблон с проверка.
Четири готови примера: ръководството за първа игра дава 1 Coin за всяка монета, която играчът докосне на трасето, и Win на финалната площадка след 3 монети, ръководството за кликер симулатор дава Coins за натискания на бутон с лимит на кликовете на сървъра, ръководството за меч добавя 1 към Kills на този, който е нанесъл последния удар преди смъртта на играча, а ръководството за оръжие показва как да отчетеш убийство, когато изстрелът свали Health на целта до 0.
Стъпка 3: запазвай статистиката между сесиите
leaderstats живее само докато живее сървърът. За да запазиш монетите и победите, зареждай ги от data store, когато играчът влезе, и ги запазвай, когато излезе. Тази версия заменя скрипта от стъпка 1. Тя никога не запазва играч, чиито данни не са се заредили: точно тази грешка изтрива напредъка в повечето копирани скриптове за запазване.
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
-- Извиква се вътре във всеки pcall по-долу, затова още непубликуван плейс
-- (без достъп до data store) пак получава класация
local function statsStore(): DataStore
return DataStoreService:GetDataStore("PlayerStats_v1")
end
-- Играчи, чиято запазена статистика се е заредила. Тези, които ги няма тук, никога не ги запазваме,
-- затова неуспешно зареждане няма да презапише истинския напредък с нули.
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)
-- Когато сървърът се изключва, запазваме всички преди затварянето
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)
За малка игра това е достатъчно. За повторни опити, UpdateAsync, лимити на заявките и защита от два сървъра, които пишат един и същ играч, чети по-нататък в ръководството за DataStore.
Стъпка 4: глобален топ 10
leaderstats сравнява само играчите на един сървър. За глобална класация трябва ordered data store: data store, който пази по едно число на ключ и може да връща ключовете, подредени по стойност. Записвай в него резултата на всеки играч от сървъра, после чети горните записи обратно.
Можеш да я покажеш по два начина. Списъкът с играчи в Roblox има режими Friends и Global, които четат ordered data store, регистриран в Creator Hub (към момента на писане това е бета функция, една активна класация на игра). Или можеш сам да нарисуваш класацията на табло в своя свят: това работи във всяка игра и ти позволява да я оформиш както искаш. Скриптът по-долу прави второто, а резултатите ги записва с user ID на играча като ключ, и това е същият формат, който очаква класацията в Creator Hub.
- Добави в Workspace закотвен Part, наречи го
WinsBoardи го направи с размер на табела (например 12 на 8 на 1 стъда), с предната страна към спауна. - Вмъкни в ServerScriptService Script с име
GlobalWinsBoardи кода по-долу. - Натисни Play. Таблото ще се попълни след първото обновяване и ще се обновява всяка минута.
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
local winsBoard = DataStoreService:GetOrderedDataStore("GlobalWins_v1")
local TOP_N = 10
local REFRESH_SECONDS = 60
-- Таблото: закотвен Part с име WinsBoard в Workspace. Скриптът сам добавя
-- SurfaceGui и редовете, затова трябва да построиш само 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) връща първо 10-те най-големи стойности. Ordered data store пази само цели числа, затова пази резултатите като цели. Скриптът записва всеки играч веднъж в минута и чете топ 10 веднъж в минута, с голям запас в рамките на стандартните лимити на сървър (30 + 5 на играч в минута за записи в ordered data store и 5 + 2 на играч за подредени четения, по документацията към 30 септември 2026).
Чести грешки и решения
Проблемите по-долу покриват повечето оплаквания „класацията ми не работи“. Първо провери прозореца Output (отвори го от менюто Window в Studio или от раздела Script): ако скриптът е спрял с грешка, там ще има номер на ред.
Класацията изобщо не се показва
Провери дали папката се казва leaderstats с малки букви, дали родителят ѝ е Player (а не персонажът) и дали кодът е Script в ServerScriptService, а не LocalScript.
Другите играчи не виждат промените на моята характеристика
Стойността е променена на клиента. Премести промяната в сървърен Script, а ако я задейства бутон или клавиш, прати RemoteEvent и остави сървъра да промени стойността.
attempt to index nil with 'Coins'
Кодът се е опитал да прочете player.leaderstats.Coins преди папката да се появи или името е написано различно. На сървъра използвай FindFirstChild и проверявай резултата; в LocalScript използвай player:WaitForChild("leaderstats"). Ръководството за грешки в скриптовете разглежда подробно тази грешка.
Монетите се увеличават с 10, 20 или 50 от едно докосване
Touched се задейства отново и отново, докато партовете се пресичат. Добави презареждане за всеки играч като в стъпка 2 или изтривай предмета след вземането му.
Статистиката се нулира при всяко повторно влизане
Roblox не запазва leaderstats. Добави скрипта от стъпка 3. За да провериш запазването в Studio, публикувай плейса и включи Studio Access to API Services в Experience Settings.
Направи го с RoCode
Ако не ти се сглобява това на ръка, RoCode може да построи всичко в отворения ти плейс. Това е ИИ агент, който работи през плъгин за Roblox Studio, затова създава скриптове и партове в твоя Explorer, вместо да ти дава код за поставяне.
Добави класация с Coins и Wins, която се запазва между сесиите, и табло с топ 10 по победи на парт до спауна.
- Може първо да потърси в плейса съществуващ код за leaderstats или DataStore, за да допълни това, което има, вместо да добавя втора класация
- Създава сървърния скрипт в ServerScriptService и парта за таблото в Workspace
- Проверява дали написаните скриптове се компилират в Studio, преди да приключи
- Праща промените на партиди и всяка партида се отбелязва като точка за отмяна в историята на Studio
Резултата пак го проверяваш ти и сам тестваш в играта статистиката и запазването: с плъгин 3.9 или по-нов RoCode може да пусне кратък плейтест и да прочете грешките, а с плъгин 3.9.11 или по-нов да управлява тестов персонаж и да проверява стойности като Coins и Wins, но проверява само това, което сам е избрал за теста. Leaderstats обикновено е първата от много системи в играта: построй останалата игра по една система на промпт по същия начин. Как RoCode се свързва със Studio.
Често задавани въпроси
Какво е leaderstats в Roblox?
Folder с име точно leaderstats, всичко с малки букви, вътре в Player. Roblox показва всеки IntValue, NumberValue или StringValue в нея като колона в списъка с играчи. Създавай я от сървърен Script, както в стъпка 1.
Как да направя глобална класация в Roblox?
Записвай резултата на всеки играч в ordered data store от сървъра, после чети горните записи обратно и ги показвай на табло в своя свят. В стъпка 4 е пълният скрипт за топ 10.
Roblox запазва ли leaderstats автоматично?
Не. leaderstats съществува само докато играчът е на сървъра. Запазвай стойностите през data store, когато играчът излиза, и ги зареждай, когато влиза, както в стъпка 3.
Може ли да скрия стойност от класацията?
Да. Показват се само стойностите вътре в папката leaderstats. Пази скритите данни в друга папка на играча или в таблица в сървърен скрипт.
Как да скрия целия списък с играчи?
От LocalScript извикай StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, false). Подай true, за да го покажеш отново.
Може ли да използвам NumberValue за монети?
Може, но за валута от цели числа по-подходящ е IntValue, а ordered data store приема само цели числа, ако по-късно искаш да правиш класация по тях.
Източници и какво да прочетеш
- Roblox Creator Docs: Leaderboards (на английски). leaderstats, ред на характеристиките и постоянните режими Friends и Global
- Roblox Creator Docs: Data stores (на английски). GetAsync, SetAsync, ordered data stores и лимити
Как е проверен кодът: всеки скрипт на тази страница минава строга проверка на типовете в Luau с дефинициите на Roblox API (luau-lsp, 20 ноември 2026 г.). Проверката на типовете хваща грешки в имената на API и грешни типове, но не и грешки в логиката на играта, затова тествай всичко в Studio, преди да публикуваш.