Robloxスクリプティング実践ガイド — RemoteEvent・DataStore・クライアントサーバー通信の基本【2026年版】

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local scoreEvent = ReplicatedStorage:WaitForChild("UpdateScore")

-- クライアントからのイベントを受信
scoreEvent.OnServerEvent:Connect(function(player, amount)
    -- 必ずサーバーでバリデーション
    if type(amount) ~= "number" or amount <= 0 then return end
    local leaderstats = player:FindFirstChild("leaderstats")
    if leaderstats then
        leaderstats.Score.Value += amount
    end
end)

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local scoreEvent = ReplicatedStorage:WaitForChild("UpdateScore")

-- サーバーへイベント送信
scoreEvent:FireServer(10)

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local getDataFunc = ReplicatedStorage:WaitForChild("GetPlayerData")

getDataFunc.OnServerInvoke = function(player)
    -- サーバーで処理してデータを返す
    return { coins = 100, level = 5 }
end

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local getDataFunc = ReplicatedStorage:WaitForChild("GetPlayerData")

local data = getDataFunc:InvokeServer()
print(data.coins, data.level)

local DataStoreService = game:GetService("DataStoreService")
local playerStore = DataStoreService:GetDataStore("PlayerData_v1")

-- データ読み込み（リトライ付き）
local function loadData(player)
    local key = "player_" .. player.UserId
    local success, data = pcall(function()
        return playerStore:GetAsync(key)
    end)
    if success then
        return data or { coins = 0, level = 1 }  -- デフォルト値
    else
        warn("DataStore load failed:", data)
        return nil
    end
end

-- データ保存
local function saveData(player, data)
    local key = "player_" .. player.UserId
    local success, err = pcall(function()
        playerStore:SetAsync(key, data)
    end)
    if not success then
        warn("DataStore save failed:", err)
    end
end

-- 悪い例: クライアントの値をそのまま信用
scoreEvent.OnServerEvent:Connect(function(player, newScore)
    player.leaderstats.Score.Value = newScore  -- 危険!
end)

-- 良い例: サーバーで計算
scoreEvent.OnServerEvent:Connect(function(player, action)
    if action == "collectCoin" then
        player.leaderstats.Score.Value += 1  -- サーバー完結
    end
end)

-- メモリキャッシュ
local cache = {}  -- { [userId] = data }

-- プレイヤー参加時にロードしキャッシュ
game.Players.PlayerAdded:Connect(function(player)
    local data = loadData(player)
    cache[player.UserId] = data
end)

-- 定期バッチ保存（30秒ごと）
local RunService = game:GetService("RunService")
local elapsed = 0
RunService.Heartbeat:Connect(function(dt)
    elapsed += dt
    if elapsed >= 30 then
        elapsed = 0
        for userId, data in pairs(cache) do
            local player = game.Players:GetPlayerByUserId(userId)
            if player then saveData(player, data) end
        end
    end
end)

game:BindToClose(function()
    -- 全プレイヤーのデータを同期的に保存
    for _, player in ipairs(game.Players:GetPlayers()) do
        local data = cache[player.UserId]
        if data then
            saveData(player, data)
        end
    end
    task.wait(2)  -- 保存完了を待つ
end)