Коротко
Создайте 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, 12 ноября 2026 г.). Проверка типов ловит опечатки в API и неверные типы, но не ошибки игровой логики, поэтому протестируйте всё в Studio перед публикацией.