Настройки игрока: как сохранить громкость и чувствительность между сессиями

-- Каждая настройка: тип, значение по умолчанию и границы.
-- Всё, чего здесь нет, сервер не примет и не сохранит.
local SCHEMA = {
    musicVolume  = { kind = "number",  default = 0.6, min = 0, max = 1 },
    sfxVolume    = { kind = "number",  default = 0.8, min = 0, max = 1 },
    sensitivity  = { kind = "number",  default = 1.0, min = 0.2, max = 3 },
    cameraShake  = { kind = "boolean", default = true },
    subtitles    = { kind = "boolean", default = false },
}

local Schema = {}

function Schema.defaults()
    local result = {}

    for name, rule in pairs(SCHEMA) do
        result[name] = rule.default
    end

    return result
end

-- Возвращает очищенную копию: лишние ключи выброшены,
-- числа зажаты в границы, неверные типы заменены значением
-- по умолчанию. Мусор с клиента дальше этой функции не проходит.
function Schema.sanitize(raw)
    local clean = Schema.defaults()

    if type(raw) ~= "table" then
        return clean
    end

    for name, rule in pairs(SCHEMA) do
        local value = raw[name]

        if rule.kind == "number" and type(value) == "number" and value == value then
            clean[name] = math.clamp(value, rule.min, rule.max)
        elseif rule.kind == "boolean" and type(value) == "boolean" then
            clean[name] = value
        end
    end

    return clean
end

return Schema

local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")

local Schema = require(ServerStorage.SettingsSchema)
local store = DataStoreService:GetDataStore("PlayerSettings_v1")

local push = ReplicatedStorage:WaitForChild("SettingsPush")
local save = ReplicatedStorage:WaitForChild("SettingsSave")

-- Что сейчас у каждого игрока на сервере. Источник истины —
-- здесь, а не на клиенте.
local current = {}
local lastSave = {}

local function load(player)
    local ok, data = pcall(store.GetAsync, store, tostring(player.UserId))

    if not ok then
        warn("Настройки не загрузились: " .. tostring(data))
        data = nil
    end

    -- Что бы ни лежало в хранилище, оно проходит ту же очистку,
    -- что и данные с клиента: схема могла измениться с прошлого раза.
    current[player] = Schema.sanitize(data)
    push:FireClient(player, current[player])
end

local function persist(player)
    local data = current[player]

    if data == nil then
        return
    end

    local ok, err = pcall(store.SetAsync, store, tostring(player.UserId), data)

    if not ok then
        warn("Настройки не сохранились: " .. tostring(err))
    end
end

Players.PlayerAdded:Connect(load)

save.OnServerEvent:Connect(function(player, raw)
    -- Клиент прислал таблицу — сервер оставил из неё только то,
    -- что знает, и в тех границах, что задал.
    current[player] = Schema.sanitize(raw)

    -- Не чаще раза в несколько секунд: ползунок шлёт события
    -- десятками, а лимиты DataStore — не резиновые.
    local now = os.clock()

    if lastSave[player] and now - lastSave[player] < 5 then
        return
    end

    lastSave[player] = now
    persist(player)
end)

Players.PlayerRemoving:Connect(function(player)
    -- Последнее состояние уходит в хранилище независимо от таймера:
    -- иначе правка, сделанная за секунду до выхода, пропадёт.
    persist(player)
    current[player] = nil
    lastSave[player] = nil
end)

game:BindToClose(function()
    for _, player in ipairs(Players:GetPlayers()) do
        persist(player)
    end
end)

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SoundService = game:GetService("SoundService")
local UserInputService = game:GetService("UserInputService")

local push = ReplicatedStorage:WaitForChild("SettingsPush")
local save = ReplicatedStorage:WaitForChild("SettingsSave")

local settings = nil
local pending = false

local function apply()
    -- Группы звуков заводятся в SoundService заранее:
    -- Music и Sfx. Все звуки игры привязаны к одной из них.
    SoundService.Music.Volume = settings.musicVolume
    SoundService.Sfx.Volume = settings.sfxVolume
    UserInputService.MouseDeltaSensitivity = settings.sensitivity
    -- Тряску и субтитры читают свои системы через эту же таблицу.
end

-- Сервер прислал настройки при входе. Пока их нет,
-- интерфейс настроек лучше не показывать вовсе.
push.OnClientEvent:Connect(function(data)
    settings = data
    apply()
end)

-- Вызывается из интерфейса при каждом движении ползунка
-- или переключателя.
local function set(name, value)
    if settings == nil then
        return
    end

    settings[name] = value
    apply()

    if pending then
        return
    end

    pending = true

    -- Ждём, пока игрок закончит крутить, и шлём один раз.
    task.delay(1, function()
        pending = false
        save:FireServer(settings)
    end)
end

return set