DataStore в Roblox: сохранение прогресса игрока без потери данных

Для сохранения прогресса Roblox используйте DataStoreService только в серверном Script, ключ на основе Player.UserId, сетевые вызовы внутри pcall() и UpdateAsync() для записи. Загружайте данные при входе, сохраняйте при выходе и тестируйте на отдельной опубликованной версии.

DataStore хранит значения между игровыми сессиями и доступен всем places одной experience. Это подходит для монет, уровней, инвентаря и настроек. Вызовы идут по сети и иногда завершаются ошибкой, поэтому код обязан иметь ветку неудачи. LocalScript не может обращаться к DataStore. Сервер остаётся владельцем прогресса и не принимает готовый баланс от клиента.

DataStore Roblox: код загрузки и сохранения прогресса

Пример хранит только число монет, поэтому его легко проверить. Script поместите в ServerScriptService. Перед тестом опубликуйте отдельную тестовую experience и разрешите Studio Access to API Services именно для неё. Не включайте Studio-доступ к боевым данным: случайный тест может перезаписать настоящий профиль.

local DataStoreService = game:GetService("DataStoreService")
local Players = game:GetService("Players")
local coinsStore = DataStoreService:GetDataStore("Coins_v1")

local function getKey(player)
    return "User_" .. player.UserId
end

local function savePlayer(player)
    local coins = player:GetAttribute("Coins") or 0
    local success, message = pcall(function()
        coinsStore:UpdateAsync(getKey(player), function()
            return coins
        end)
    end)

    if not success then
        warn("Save failed for", player.UserId, message)
    end
end

Players.PlayerAdded:Connect(function(player)
    local success, savedCoins = pcall(function()
        return coinsStore:GetAsync(getKey(player))
    end)

    player:SetAttribute("Coins", success and savedCoins or 0)
end)

Players.PlayerRemoving:Connect(savePlayer)

Это учебная основа, а не полный профиль игрока. В реальном проекте нужен контроль повторной загрузки, автосохранение, обработка закрытия сервера, схема данных и стратегия повторных попыток. Если загрузка не удалась, нельзя бездумно разрешать игроку продолжить с нулём и потом перезаписать существующий профиль. Для ценных данных используйте отдельное состояние загрузки и блокируйте сохранение неуспешно загруженного профиля.

DataStore, MemoryStore или Attributes

Не сохраняйте данные после каждого подобранного предмета. Запись имеет лимиты, а UpdateAsync расходует бюджет чтения и записи. Меняйте профиль в памяти, запускайте разумное автосохранение и делайте финальную попытку при выходе. Для одной горячей записи со множеством серверов продумайте конкуренцию и не храните весь мир под одним ключом.

Практика: сохраните Coins через UpdateAsync и проверьте полный цикл

Соберите минимальный профиль из одного числа: монеты игрока в хранилище Coins_v1. Скрипт кладите в ServerScriptService и тестируйте на отдельной опубликованной experience, где включён Studio Access to API Services. Успех: вы вышли из сессии с 25 монетами, зашли снова и увидели те же 25, а не ноль.

Теперь сломайте ветку отказа специально: временно выключите Studio Access to API Services или передайте в UpdateAsync значение, которое хранилище не умеет сериализовать, например таблицу с функцией внутри. pcall вернёт success равным false, и в Output появится ваш warn с UserId и текстом ошибки. Дальше главное: убедитесь, что после неудачного GetAsync игра не подставила ноль и не записала его поверх настоящих 25. Верните доступ, повторите вход и проверьте, что число на месте.

Дальше замените одно число таблицей профиля с полями для монет, уровня и версии данных, чтобы позже можно было мигрировать формат. Добавьте автосохранение по таймеру и последнюю попытку записи при закрытии сервера, но не пишите после каждой подобранной монеты: у записи есть лимиты, а UpdateAsync расходует бюджет чтения и записи. Для глобального рейтинга заведите отдельный OrderedDataStore, а текущие монеты покажите игроку через leaderstats. Кнопку покупки делайте через RemoteEvent, где цену проверяет сервер.

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

Потери данных чаще возникают не из-за одной опечатки, а из-за неверного сценария отказа. Игрок вошёл, GetAsync вернул ошибку, игра поставила ноль, а при выходе сохранила его поверх старого значения. Другая проблема появляется, когда два сервера меняют один профиль без контроля версии. Третья связана с тестами прямо на боевом хранилище.

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