Туторіал · Дані гравця

Як зробити таблицю лідерів у Roblox Studio

Списком гравців у правому верхньому куті гри Roblox керує одна папка з назвою leaderstats. Цей гайд будує його з нуля: серверний скрипт, безпечний спосіб видавати очки, збереження між сесіями та глобальний топ-10.

Оновлено 20 листопада 2026 р.6 хв читанняАвтор:

Коротко

Створіть 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.