leaderstats в Roblox: таблица лидеров с монетами и победами

Чтобы создать таблицу лидеров Roblox, добавьте серверный Script в ServerScriptService, при входе игрока создайте Folder с точным именем leaderstats и поместите внутрь IntValue. Roblox автоматически покажет эти значения в стандартном списке игроков.

leaderstats не является глобальным рейтингом между серверами. Это специальная папка внутри текущего Player, которую стандартный интерфейс Roblox читает и показывает рядом с именем. Значения удобно использовать для монет, побед, очков или времени. Если нужно сохранить их между сессиями, отдельно подключается DataStore. Если нужен мировой топ, используется OrderedDataStore и собственный интерфейс. Поэтому сначала решите, кому и как долго должен быть виден показатель, а уже потом выбирайте способ хранения.

leaderstats Roblox: таблица лидеров из двух показателей

Код создаёт столбцы Coins и Wins. Значение Priority помогает поставить Wins перед Coins. Roblox также поддерживает BoolValue с именем IsPrimary, но для нескольких столбцов числовой приоритет понятнее. Все объекты создаются до присвоения Parent игроку, чтобы дерево появилось в готовом виде.

local Players = game:GetService("Players")

local function createStat(name, value, priority, parent)
    local stat = Instance.new("IntValue")
    stat.Name = name
    stat.Value = value

    local order = Instance.new("NumberValue")
    order.Name = "Priority"
    order.Value = priority
    order.Parent = stat

    stat.Parent = parent
    return stat
end

Players.PlayerAdded:Connect(function(player)
    local leaderstats = Instance.new("Folder")
    leaderstats.Name = "leaderstats"

    createStat("Wins", 0, 20, leaderstats)
    createStat("Coins", 100, 10, leaderstats)

    leaderstats.Parent = player
end)

Функция возвращает созданный IntValue, поэтому ссылку можно сохранить и менять при событии. Не ищите значение через весь Workspace. Получите игрока, затем player.leaderstats.Coins или безопасный FindFirstChild(). Для бизнес-логики полезно держать полный профиль отдельно, а leaderstats использовать как отображение выбранных чисел.

Что хранить в leaderstats

Показывайте только показатели, которые помогают игроку понять соревнование или прогресс. Десять столбцов превращают список в шум и плохо помещаются на мобильном экране. Для подробной статистики лучше ScreenGui. Помните, что клиент может визуально изменить локальные объекты, поэтому начисление наград и проверка побед должны оставаться на сервере.

Практика: соберите leaderstats с Coins и Wins и начислите победу

Соберите таблицу лидеров с нуля в пустом месте Studio, а не в текущем проекте. Успехом считайте два столбца рядом с ником: Wins стоит первым благодаря Priority 20, Coins стартует со 100. В конце значение Coins должно меняться серверной командой, а не кликом клиента.

Переименуйте папку в LeaderStats с заглавной буквы и запустите снова. Столбцы Wins и Coins исчезнут из списка игроков, при этом в Output не будет ни одной ошибки: встроенный интерфейс просто не найдёт папку с точным именем leaderstats. Верните строчное имя и убедитесь, что оба столбца вернулись на место.

Дальше свяжите Coins с DataStore и сохраняйте только число из свойства Value, а не сам объект IntValue. Затем добавьте кнопку покупки через RemoteEvent, чтобы цену и списание считал сервер, а клиент только отправлял запрос. Для мирового топа понадобится OrderedDataStore и собственный ScreenGui: leaderstats показывает результаты только текущего сервера.

Частые ошибки и почему они появляются

Если столбцы не появились, почти всегда неверно написано имя папки или код выполняется не на сервере. Если значения сбрасываются при новом входе, это нормальное поведение без DataStore. Если монеты можно накрутить кнопкой, значит сервер доверяет числу от клиента вместо самостоятельной проверки события и цены.

Самопроверка