Коротко
Створіть 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 перед публікацією.