Туториал · Данные игрока

Как сделать таблицу лидеров в Roblox Studio

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

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

Попробуйте RoCode в своей игре.

Бесплатные кредиты каждый день, без карты. Установите плагин, опишите функцию и проверьте, что появилось в Studio.