Ръководство · Данни на играча

Как да направиш класация в Roblox Studio

Списъкът с играчи в горния десен ъгъл на игра в Roblox се управлява от една папка с име leaderstats. Това ръководство я изгражда от нулата: сървърен скрипт, безопасен начин да даваш точки, запазване между сесиите и глобален топ 10.

Обновено 20 ноември 2026 г.7 мин четенеАвтор:

Накратко

Създай Script в ServerScriptService, който слуша Players.PlayerAdded, създава Folder с име точно leaderstats (всичко с малки букви) и го прави дете на играча. Всеки IntValue, NumberValue или StringValue в тази папка става колона в списъка с играчи.

  • Създавай и променяй статистиката само на сървъра. Промяна, направена от LocalScript, вижда само този играч и никой друг.
  • leaderstats не се запазва. Зареждай и запазвай стойностите през data store, ако трябва да оцелеят до следващата сесия.
  • За класация на всички играчи записвай всеки резултат в ordered data store и го показвай на табло в твоя свят или в режим Global на списъка с играчи.
На тази страница
  1. Как работи leaderstats
  2. 1. Създай leaderstats
  3. 2. Даване на точки
  4. 3. Запазване
  5. 4. Глобален топ 10
  6. Common errors
  7. С RoCode
  8. Често задавани въпроси
  9. Източници и какво да прочетеш

Как работи leaderstats

ИлюстрацияГотовите скриптове за leaderstats и площадката с монети в пусната игра.

Roblox показва списък с играчи във всяка игра. Когато играчът има дете Folder с име leaderstats, списъкът добавя колона за всеки обект стойност вътре и показва стойността на този играч в неговия ред. Заглавието на колоната е Name на обекта стойност.

Обекти стойности, които можеш да слагаш в leaderstats
ОбектПазиПодходящ за
IntValueЦели числаМонети, убийства, победи, ниво
NumberValueДробни числаНай-добро време за обиколка, разстояние
StringValueТекстРанг или звание на отбора

Две правила развалят почти всяка неработеща класация. Името на папката трябва да е точно leaderstats: Leaderstats или leaderStats се пренебрегват. И папката трябва да я създава сървърен Script, защото само промените на сървъра се репликират до всички играчи. Ако не си сигурен къде се изпълнява кодът, първо прочети Script vs LocalScript vs ModuleScript (на английски).

Стъпка 1: създай скрипта за leaderstats

  1. В Explorer задръж курсора върху ServerScriptService, натисни бутона + и вмъкни Script.
  2. Преименувай го на Leaderstats, за да го намираш лесно после.
  3. Замени съдържанието му с кода по-долу и натисни Play. Името ти ще се появи в списъка с играчи с Coins и Wins, равни на 0.
Script в ServerScriptService с име Leaderstats
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 се задейства много пъти в секунда, докато персонажът стои на парта, затова скриптът пази кратко презареждане за всеки играч.

Script в парт в Workspace с име 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 се задейства много пъти на стъпка; това не позволява едно докосване да плати десет пъти
	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. Тя никога не запазва играч, чиито данни не са се заредили: точно тази грешка изтрива напредъка в повечето копирани скриптове за запазване.

Script в ServerScriptService с име Leaderstats
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.

  1. Добави в Workspace закотвен Part, наречи го WinsBoard и го направи с размер на табела (например 12 на 8 на 1 стъда), с предната страна към спауна.
  2. Вмъкни в ServerScriptService Script с име GlobalWinsBoard и кода по-долу.
  3. Натисни Play. Таблото ще се попълни след първото обновяване и ще се обновява всяка минута.
Script в ServerScriptService с име 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

-- Таблото: закотвен 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 по победи на парт до спауна.

RoCode прави
  • Може първо да потърси в плейса съществуващ код за 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 приема само цели числа, ако по-късно искаш да правиш класация по тях.

Източници и какво да прочетеш

Как е проверен кодът: всеки скрипт на тази страница минава строга проверка на типовете в Luau с дефинициите на Roblox API (luau-lsp, 20 ноември 2026 г.). Проверката на типовете хваща грешки в имената на API и грешни типове, но не и грешки в логиката на играта, затова тествай всичко в Studio, преди да публикуваш.

Пробвай RoCode в своята игра.

Безплатни кредити всеки ден, без карта. Инсталирай плъгина, опиши функцията и виж какво се е появило в Studio.