要点
DataStoreService はサーバーの Script から使います。プレイヤーが参加したら GetAsync でデータを読み込み、プレイ中はテーブルに保持し、タイマーで定期的に、退出時(PlayerRemoving)に、そしてサーバーのシャットダウン時(game:BindToClose)に UpdateAsync で保存します。すべての呼び出しを pcall で包み、失敗したものは何回かリトライします。
- Studio でテストするには、プレイスを公開し、別のテスト用ゲームで File > Experience Settings > Security > Enable Studio Access to API Services をオンにします。Studio はライブサーバーと同じデータを使うためです。
- プレイヤーのデータが読み込めなかった場合は、そのプレイヤーを絶対に保存しないでください。デフォルト値を保存すると、本当の進行状況が上書きされてしまいます。
- プレイヤーごとに1つのテーブルを
User_12345のような1つのキーに入れ、変更のたびではなくタイマーで保存します。 - トレードや有料アイテムがある場合は、セッションロックを追加して、2つのサーバーが同じプレイヤーを保存できないようにします。
このページの内容
始める前に:テスト用コピーで Studio のアクセスを有効にする
Studio で実行したゲームは、許可するまでデータストアにアクセスできません。この許可には、Roblox のドキュメントも注意している落とし穴があります。許可すると、Studio はライブのゲームと同じデータストアを読み書きするのです。そのため、Studio でコインをリセットするテストをすると、ライブのゲームでもリセットされ、テストコードのバグが本物のプレイヤーのキーを壊すこともあります。
- テスト用のコピーを作ります。プレイスをファイルに保存してコピーを開き、File > Publish to Roblox As を選んで Create new game をクリックします。ライブのゲームの中にプレイスとして追加しないでください。同じゲームのプレイスはすべて同じデータストアを共有します。
- テスト用コピーで File > Experience Settings を開き、Security に移動します。
- Enable Studio Access to API Services をオンにして Save をクリックします。
データストアの呼び出しが動くのはサーバーの Script だけです。LocalScript が呼び出そうとするとエラーになるので、クライアントは保存データを書き込めません。ボタンで保存データを変える必要があるときは、クライアントが RemoteEvent でサーバーに頼み、サーバーが判断します(RemoteEvent のガイドを参照、英語)。
データストアがプレイヤーデータを保存する仕組み
データストア(data store)は、Roblox のサーバー上にある名前付きのキーと値の集まりで、ゲームのすべてのサーバーとすべてのプレイスで共有されます。DataStoreService:GetDataStore("PlayerData") はそのようなストアを1つ返します。
Roblox の推奨事項をまとめると、プレイヤーデータには1つのストア、プレイヤーごとに1つのキー、各キーに1つのテーブルというルールになります。キーはプレイヤーの UserId から作り(たとえば User_12345)、プレイヤーが変更できる名前からは決して作らないでください。User_{UserId} という一定のパターンにしておくと、設定すれば Roblox の忘れられる権利の自動処理がプレイヤーのデータを見つけられるようにもなります。
| 型 | 保存できる? | 注意点 |
|---|---|---|
| 数値、文字列、真偽値、バッファー | はい | 文字列は正しい UTF-8 である必要があります。inf や nan は保存しないでください。 |
| テーブル | はい | 中身もすべて保存できるものであれば保存できます。数値のキーが 1 から始まらない(そのため長さが 0 になる)テーブルは、そのキーが文字列になって返ってきます。 |
Instance、Vector3、CFrame、Color3 | いいえ | 保存するとエラーになるか、nil が書き込まれます。アイテムの名前や、3つの数値で表した位置を保存してください。 |
リクエストはどれもウェブ呼び出しで、失敗することがあり、時間がかかり、1分ごとの予算を消費します。そのため、信頼できる保存システムは、プレイヤーの参加時にデータを1回だけ読み、プレイ中はサーバーのテーブルに保持し、ときどき書き戻します。
GetAsync、SetAsync、UpdateAsync のどれを使うか
| メソッド | 動作 | 用途 |
|---|---|---|
GetAsync(key) | 値を読み込みます。結果はそのサーバーで4秒間キャッシュされます。 | プレイヤーデータの読み込み |
SetAsync(key, value) | 値を読まずに上書きします。書き込み1回。 | 新しいキー、または古い値に依存しない値 |
UpdateAsync(key, callback) | 最新の値を読み、それを自分の関数に渡し、関数が返したものを書き込みます。読み込み1回と書き込み1回。 | プレイヤーデータの保存と、複数のサーバーが書き込む可能性のあるキー |
IncrementAsync(key, delta) | 保存されている整数に整数を足します。 | カウンター |
RemoveAsync(key) | キーを削除して古い値を返します。以前のバージョンは引き続き一覧表示して読むことができます。 | プレイヤーデータの削除 |
SetAsync は確認せずに書き込みます。2つのサーバーがほぼ同時に同じキーを保存すると、中身が何であれ最後の書き込みが勝ちます。UpdateAsync はまず現在の値を読み、その間に別のサーバーが書き込んだ場合は、新しい値で関数をもう一度実行します。書き込みが現在の値に依存する場合や、複数のサーバーがキーを書き込む可能性がある場合、Roblox は常にこちらを勧めています。プレイヤーデータはまさにそれに当たります。この関数には3つのルールがあります。
- 処理を譲ってはいけません(yield しない)。中で
task.wait()やほかのデータストアの呼び出しを使わないでください。 - 2回以上実行されることがあるので、新しい値を計算するだけにして、アイテムを渡したりイベントを発火したりは絶対にしないでください。
nilを返すと書き込みが取り消されます。モジュールはこれを使って、より新しいバージョンのゲームが保存したデータを上書きしないようにしています。
ステップ1:PlayerData モジュールを作る
この ModuleScript が、データストアとやり取りする唯一のコードです。参加時にプレイヤーのデータを読み込み、メモリに保持し、180秒ごと、退出時、サーバーのシャットダウン時に保存し、データが読み込めなかったプレイヤーの保存は拒否します。
- Explorer で ServerScriptService にカーソルを合わせ、+ をクリックして ModuleScript を挿入します。名前を
PlayerDataに変え、中身を下のコードに置き換えます。 - ModuleScript は、どこかのスクリプトが読み込んだ(require した)ときにだけ実行されます。ServerScriptService に
Mainという名前の Script を挿入し、次の1行を書きます:local PlayerData = require(game:GetService("ServerScriptService").PlayerData)。ほかのサーバースクリプトも同じ方法で読み込みます。 DEFAULTSとData型を自分のゲームに合わせて変えます。各フィールドは数値、文字列、真偽値、テーブルのいずれかにしてください。
ServerScriptService
PlayerData ModuleScript new
Main Script new
StarterPlayer
StarterPlayerScripts
DataWarning LocalScript new
-- PlayerData: 参加時にプレイヤーのデータを読み込み、メモリに保持し、
-- タイマーで定期的に、退出時に、サーバーのシャットダウン時に保存します。
-- ほかのサーバースクリプトは PlayerData.Get(player) でデータを読み、変更します。
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
local RunService = game:GetService("RunService")
local STORE_NAME = "PlayerData"
local SCHEMA_VERSION = 2 -- データの形を変えたら上げて、migrate() に手順を追加します
local AUTOSAVE_SECONDS = 180
-- Studio では失敗した呼び出しをすぐにあきらめるので、ストアにアクセスできないテストでも速く進みます
local MAX_ATTEMPTS = if RunService:IsStudio() then 1 else 4
local FIRST_RETRY_SECONDS = 1 -- 失敗するたびに2倍になります: 1、2、4
export type Data = {
SchemaVersion: number,
Coins: number,
Level: number,
Inventory: { string },
}
-- まったく新しいプレイヤーが最初に持つもの
local DEFAULTS: { [string]: any } = {
Coins = 0,
Level = 1,
Inventory = {},
}
type Session = {
key: string,
userId: number,
data: Data,
canSave: boolean, -- 読み込みに失敗したら false: デフォルトのデータで本当の進行状況を置き換えてはいけません
}
-- 下の各 pcall の中で呼ばれるので、まだ公開していないプレイス
-- (ストアにアクセスできない)でも、プレイヤーはデフォルトのデータで読み込まれます
local function store(): DataStore
return DataStoreService:GetDataStore(STORE_NAME)
end
local sessions: { [Player]: Session } = {}
local pendingSaves: { [string]: number } = {} -- まだ進行中の保存(キーごと)
local loadedEvent = Instance.new("BindableEvent")
local PlayerData = {}
-- プレイヤーのデータの準備ができたら、そのプレイヤーを渡して発火します。テーブルは PlayerData.Get(player) で取得してください:
-- BindableEvent で送ったテーブルはコピーとして届くので、それを変更しても何も変わりません。
PlayerData.Loaded = loadedEvent.Event
local function deepCopy(value: any): any
if type(value) ~= "table" then
return value
end
local copy = {}
for key, item in value do
copy[key] = deepCopy(item)
end
return copy
end
local function defaultData(): Data
local data = deepCopy(DEFAULTS) -- 新しいコピーなので、プレイヤー同士が1つの Inventory テーブルを共有することはありません
data.SchemaVersion = SCHEMA_VERSION
return data
end
-- 保存されたデータを現在のスキーマに合わせます。安全に使えない場合は nil を返します。
local function migrate(saved: any): Data?
if type(saved) ~= "table" then
return nil
end
local version = tonumber(saved.SchemaVersion) or 1
if version > SCHEMA_VERSION then
return nil -- より新しいバージョンのゲームが保存したもの: ここでは読み込みも上書きもしません
end
-- スキーマの変更ごとに1つの手順、古いものから新しいものへ
if version < 2 then
-- 例: バージョン1では通貨の名前が Gold でした。Coins がない場合だけコピーします。
-- こうすると、Coins はあるが SchemaVersion がない古いデータの値はそのまま残ります。
if saved.Coins == nil then
saved.Coins = saved.Gold
end
saved.Gold = nil
end
-- プレイヤーが最後に保存した後に増えたフィールドを追加し、型が違う値を置き換えます
for field, default in DEFAULTS do
if type(saved[field]) ~= type(default) then
saved[field] = deepCopy(default)
end
end
saved.SchemaVersion = SCHEMA_VERSION
return saved
end
-- データストアの呼び出しを pcall で実行します。失敗したら待ってからやり直し、そのたびに
-- 待ち時間を2倍にして少しランダムさを加え、サーバーが一斉にリトライしないようにします。
local function withRetries(label: string, call: () -> any): (boolean, any)
for attempt = 1, MAX_ATTEMPTS do
local ok, result = pcall(call)
if ok then
return true, result
end
warn(`{label} failed (attempt {attempt} of {MAX_ATTEMPTS}): {result}`)
if attempt < MAX_ATTEMPTS then
local waitTime = FIRST_RETRY_SECONDS * 2 ^ (attempt - 1)
task.wait(waitTime + math.random() * waitTime / 2)
end
end
return false, nil
end
local function save(session: Session): boolean
if not session.canSave then
return false
end
local key = session.key
pendingSaves[key] = (pendingSaves[key] or 0) + 1
local newerSchema = false
local ok = withRetries(`Save {key}`, function()
return store():UpdateAsync(key, function(current: any)
if type(current) == "table" and (tonumber(current.SchemaVersion) or 1) > SCHEMA_VERSION then
newerSchema = true
return nil -- nil を返すと書き込みが取り消されます
end
-- 現在のテーブル全体を、プレイヤーの UserId のタグ付きで書き込みます
return session.data, { session.userId }
end)
end)
local left = (pendingSaves[key] or 1) - 1
if left > 0 then
pendingSaves[key] = left
else
pendingSaves[key] = nil
end
if newerSchema then
session.canSave = false
warn(`{key} was saved by a newer version of the game, so this server stopped saving it`)
end
return ok and not newerSchema
end
local function startAutosave(player: Player, session: Session)
task.spawn(function()
-- 間隔の中のランダムな時点から始めて、サーバーが一斉に保存しないようにします
task.wait(math.random() * AUTOSAVE_SECONDS)
while sessions[player] == session do
save(session)
task.wait(AUTOSAVE_SECONDS)
end
end)
end
local function load(player: Player)
local key = "User_" .. player.UserId
-- プレイヤーがこのサーバーから退出してすぐ戻ってきた場合は、先に最後の保存が終わるのを待ちます
while pendingSaves[key] do
task.wait()
end
local ok, saved = withRetries(`Load {key}`, function()
return store():GetAsync(key)
end)
if player.Parent ~= Players then
return -- 読み込み中に退出した: 何も変わっていないので、保存するものはありません
end
local data: Data? = nil
if ok then
data = if saved == nil then defaultData() else migrate(saved)
end
local session: Session = {
key = key,
userId = player.UserId,
data = data or defaultData(),
canSave = data ~= nil,
}
if not session.canSave then
warn(`Could not load {key}. {player.Name} is playing on default data that will not be saved.`)
end
sessions[player] = session
player:SetAttribute("DataLoaded", session.canSave) -- GUI はこれを読んでプレイヤーに警告できます
startAutosave(player, session)
loadedEvent:Fire(player)
end
local function endSession(player: Player)
local session = sessions[player]
if not session then
return
end
sessions[player] = nil -- 自動保存のループを止めます。もう一度呼んでも何もしません
save(session)
end
-- プレイヤーの実際のデータテーブル。読み込みが終わるまでは nil。変更はサーバースクリプトからだけにしてください。
function PlayerData.Get(player: Player): Data?
local session = sessions[player]
return if session then session.data else nil
end
-- プレイヤーのデータが読み込まれ、保存される予定なら true。販売の前に必ず確認してください。
function PlayerData.CanSave(player: Player): boolean
local session = sessions[player]
return session ~= nil and session.canSave
end
-- タイマーを待たずに今すぐ保存します。購入のような大事な場面で使います。
-- 処理を譲り(yield し)、保存に成功したら true を返します。
function PlayerData.SaveNow(player: Player): boolean
local session = sessions[player]
return session ~= nil and save(session)
end
Players.PlayerAdded:Connect(load)
Players.PlayerRemoving:Connect(endSession)
for _, player in Players:GetPlayers() do
task.spawn(load, player) -- このモジュールが最初に読み込まれる前に参加していたプレイヤー
end
game:BindToClose(function()
-- サーバーはこれらの関数に30秒しか与えないので、全員を同時に保存します
for player in sessions do
task.spawn(endSession, player)
end
-- その後、PlayerRemoving で始まったものも含め、まだ進行中のすべての保存を待ちます
while next(pendingSaves) do
task.wait()
end
end)
return PlayerData
ゲームを公開した後は、STORE_NAME とキーのパターン User_ を変えないでください。どちらかを変えると、モジュールは空のキーを見に行き、すべてのプレイヤーがデフォルト値からやり直しになります。
モジュールがデータを守る仕組み
デフォルト値とスキーマのバージョン
新しいプレイヤーは DEFAULTS の新しいコピーを受け取ります。必ずコピーでなければなりません。すべてのプレイヤーが1つの Inventory テーブルを共有していたら、1人に追加したアイテムが全員に現れてしまいます。
保存されるテーブルにはどれも SchemaVersion が入っています。フィールドを追加するだけなら新しいバージョンは不要です。migrate が足りないフィールドをデフォルト値で埋めるからです。名前の変更や構造の組み替えには新しいバージョンが必要です。SCHEMA_VERSION を上げて、Gold を Coins に名前変更する例のような手順を追加してください(新しいゲームではこの例を消して 1 から始めます)。サーバーより高いバージョンのデータは、まだ展開中のより新しいリリースから来たものなので、古いサーバーはそれに触れません。
読み込みに失敗したデータは決して保存しない
このルールが全消去を防ぎます。読み込みの試行がすべて失敗した場合、プレイヤーはデフォルトのデータで遊びますが、canSave が false なので、その値が本当の進行状況を上書きすることはありません。モジュールは属性 DataLoaded も false にし、ステップ3ではそれを使ってプレイヤーに知らせます。Roblox の参考実装も読み込みの失敗を同じように扱い、キックする代わりにこの方法を提案しています。キックしたい場合は、モジュールが警告を出している場所で、メッセージ付きで player:Kick() を呼んでください。
間隔を広げながらのリトライ
withRetries はすべての呼び出しを pcall で包みます。失敗すると 1秒、次に 2秒、次に 4秒待ち、毎回その時間の最大半分までのランダムな時間を足して、4回試したら止まります(Studio では1回で止まるので、ストアにアクセスできないプレイスでもすぐに始まります)。ランダムさによって、障害の後に多くのサーバーが行うリトライが分散されます。上限があるので待ち時間はおよそ10秒以内に収まり、サーバーがシャットダウンに使える30秒の中に入ります。どの保存も UpdateAsync で実際のテーブル全体を書き込むので、遅れて終わったリトライが古いデータを戻してしまうことはありません。
モジュールが保存するタイミング
| タイミング | 理由 |
|---|---|
| プレイヤーがサーバーにいる間、180秒ごと | クラッシュしたときの損失を抑えます。最初の保存は間隔の中のランダムな時点になるので、サーバーが一斉に保存することはありません。Roblox の参考実装も180秒を使っています。 |
プレイヤーが退出したとき(PlayerRemoving) | 通常の最後の保存です。先にセッションが削除されるので、自動保存は止まります。 |
サーバーがシャットダウンするとき(game:BindToClose) | まだサーバーにいる全員を一度に保存し、関数は進行中の保存をすべて待ちます。Roblox はこれに30秒を与えます。 |
必要なときに PlayerData.SaveNow(player) で | 購入のように失うわけにいかないことの後に使います。 |
プレイヤーが最後の保存の途中で同じサーバーに参加し直した場合、新しい読み込みはその保存が終わるのを待つので、古い値を読むことはありません。
ステップ2:ほかのスクリプトからデータを読み、変更する
モジュールを読み込むサーバースクリプトはすべて、同じテーブルを使います。
| 呼び出し | 動作 |
|---|---|
PlayerData.Get(player) | プレイヤーの実際のデータテーブル。読み込みが終わるまでは nil です。data.Coins += 10 のようにフィールドを直接変更すれば、次の保存に反映されます。 |
PlayerData.Loaded | プレイヤーのデータの準備ができたら、そのプレイヤーを渡して発火します。読み込みに失敗した後も発火します。BindableEvent で送ったテーブルはコピーとして届くので、渡すのはプレイヤーだけです。 |
PlayerData.CanSave(player) | 読み込みに失敗した場合は false です。販売の前に必ず確認してください。保存できない購入は、プレイヤーが退出すると消えてしまいます。 |
PlayerData.SaveNow(player) | すぐに保存し、成功したら true を返します。処理を譲ります(yield します)。 |
保存データが存在する場所はモジュールだけで、leaderstats は表示にすぎません。リーダーボードのガイドと同じように作り、Loaded のハンドラーで PlayerData.Get(player) から値を入れ、値が変わったら両方を更新してください。保存する値を leaderstats から読み戻したり、2つ目のスクリプトに同じキーを保存させたりしてはいけません。
プレイヤーが参加した後にモジュールを読み込んだスクリプトは、そのプレイヤーたちの Loaded を受け取れません。ハンドラーをつないだ後に Players:GetPlayers() もループで回し、PlayerData.Get(player) がすでにテーブルを返すプレイヤーを全員処理してください。
古い保存スクリプト(たとえばリーダーボードのガイドのもの)を置き換えますか?その値は古いスクリプト自身のストアとキーに残っているので、このモジュールは全員をデフォルト値から始めます。公開する前に、STORE_NAME と接頭辞 User_ を古いものに向けるか(migrate は SchemaVersion のないデータをバージョン1として扱い、足りないフィールドを埋めます)、古い値を移してから古いスクリプトを削除してください。
クライアントがこのデータを直接変えることはありません。ショップのボタンは RemoteEvent を発火し、サーバーが CanSave を確認し、価格をプレイヤーの Coins と比べ、テーブルを変更して SaveNow を呼びます。ショップの GUI のガイドでは、そうした購入をサーバー側で作っています。
フィールドを追加する完成例はクリッカーシミュレーターのガイドにあります。PowerLevel と Rebirths を DEFAULTS と Data 型に追加し、PlayerData.Get が返すテーブルでそれらを変更しています。古い保存データを持つプレイヤーには、migrate が新しいフィールドを与えます。
ステップ3:データが読み込めなかったことをプレイヤーに知らせる
データが読み込めなかったプレイヤーは、このセッションが保存されないことを知っておくべきです。そうすれば無駄に遊ばず、参加し直せます。この LocalScript は属性 DataLoaded を監視し、それが false のときにバナーを表示します。
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local shown = false
local function showWarning()
if shown or player:GetAttribute("DataLoaded") ~= false then
return
end
shown = true
local gui = Instance.new("ScreenGui")
gui.Name = "DataWarning"
gui.ResetOnSpawn = false
local label = Instance.new("TextLabel")
label.AnchorPoint = Vector2.new(0.5, 0)
label.Position = UDim2.new(0.5, 0, 0, 12)
label.Size = UDim2.new(0.8, 0, 0, 48)
label.BackgroundColor3 = Color3.fromRGB(110, 28, 28)
label.TextColor3 = Color3.new(1, 1, 1)
label.TextScaled = true
label.Text = "Your saved progress could not be loaded. Nothing you do in this server will be saved, so rejoin later."
label.Parent = gui
gui.Parent = player:WaitForChild("PlayerGui")
end
-- サーバーは、このプレイヤーのデータの読み込みを試した後に DataLoaded を1回だけ設定します
player:GetAttributeChangedSignal("DataLoaded"):Connect(showWarning)
showWarning()
ステップ4:Studio で保存をテストする
これは Studio のアクセスを有効にしたテスト用コピーで行ってください。
- 保存するものを自分に与えます。
Mainの require の行の下に次を追加します:PlayerData.Loaded:Connect(function(player) local data = PlayerData.Get(player) if data then data.Coins += 100 print(player.Name, data.Coins) end end) - Play を押します。Output ウィンドウ(Window メニューか Script タブにあります)に、自分の名前と 100 が(初回は)表示され、
Could not loadの警告は出ません。 - Stop を押します。テストを終えるとサーバーが閉じ、モジュールは閉じる前にあなたを保存します。
- もう一度 Play を押します。Output には前回より 100 多い 200 が表示されるはずです。また同じ数字が表示された場合は保存に失敗しています。その上にある警告を読んでください。
- 失敗したときの流れを確認します。Studio のアクセスをオフにして Play を押します。数秒のリトライの後、Output に
Could not load User_...と 100 が表示され、ステップ3のバナーが出ます。テストを止め、アクセスをもう一度オンにして Play を押します。Output には 300、つまり保存されていた 200 に 100 を足した数が表示されます。失敗したセッションがデータを上書きしなかったからです。 Mainからテスト用の行を削除します。
プレイヤーデータが失われる原因
保存システムが進行状況を失う典型的な原因は次のとおりです。モジュールは、最初の4行とスキーマの行をコードで防いでいます。残りは何をどのように保存するかによって決まり、最後の行にはセッションロックが必要です。
| 起きること | 結果 | 防ぎ方 |
|---|---|---|
| 読み込みに失敗したのに、スクリプトがそのまま保存する | デフォルト値が本当の進行状況を上書きします: 全消去 | 読み込みに失敗したプレイヤーは決して保存しない |
PlayerRemoving だけで保存する | クラッシュやサーバーのシャットダウンで保存が抜け落ちます | 自動保存に加えて、自分の保存を待つ BindToClose |
pcall もリトライもない | 1回のリクエストの失敗でスクリプトが止まるか、保存が失われます | 時間を分散した数回のリトライ付きの pcall |
| 変更のたびに保存する | リクエストがキューに溜まり、キューが30件になると新しいものは捨てられます | データをメモリに保持し、タイマーで保存する |
| ストアが保存できないものを保存する | 保存がエラーになるか、値が nil で返ってきます | 数値、文字列、真偽値、それらから成るテーブルを保存する |
| 移行なしでデータの形を変える | 古い保存データが違うフィールドに読み込まれます | スキーマのバージョンと移行の手順 |
| 2つのスクリプトが同じキーを保存する | それぞれの保存が、もう一方のフィールドを上書きします | キーは1つのモジュールだけが持つ |
| 2つのサーバーが同じプレイヤーを保持する | 古いデータを持つサーバーが最後に保存して、新しい進行状況を上書きします | セッションロック |
セッションロック、「lock lost」、ProfileStore
プレイヤーが一度に接続しているサーバーは1つですが、新しいサーバーに参加したとき、古いサーバーの最後の保存がまだ進行中かもしれません。遅いリトライ、テレポート、すばやい参加し直しなどです。新しいサーバーが先にデータを読み込むと、古いデータを持つことになり、最後に保存したサーバーが勝ちます。Roblox のドキュメントは、トレードがあるゲームでは、このすき間がアイテム複製のよくある原因だと指摘しています。
セッションロックがこのすき間をふさぎます。サーバーはプレイヤーのキーを読み込むとき、同じ UpdateAsync の呼び出しの中で、キーのメタデータに自分のロック ID を書き込みます。ほかのサーバーは、期限切れでない、自分がかけたものでないロックを見つけると、そのキーの読み込みも保存もしません。持ち主は自動保存のたびにロックを更新し、最後の保存でロックを外します。更新が止まるとロックは期限切れになり、別のサーバーが引き取れるようになります。
「lock lost」の意味
セッションロックを使うシステムでは、ロックが期限切れになったか奪われたために別のサーバーがプレイヤーのキーを持つようになると、そのサーバーはロックを失ったことになります。そのサーバーのコピーは古くなっている可能性があるので、そのプレイヤーの保存をやめなければなりません。普通の対応は、再接続するようメッセージを付けてキックすることです。プレイヤーとして「lock lost」を見た場合、それはそのゲーム独自の保存システムのメッセージで、説明できるのはそのゲームの開発者だけです。
自分のゲームに必要か?
このガイドのモジュールはセッションをロックしません。ロックがない場合の現実的な最悪のケースは、まれな競合で、古いサーバーで最後に保存が成功した後に得たものをプレイヤーが失うことです。複製や損失がプレイヤーにとって本当の価値を失うことになるなら、ロックを追加してください。トレード、developer products、レアアイテム、頻繁なテレポートなどです。
| 選択肢 | 内容 | 知っておくこと |
|---|---|---|
| このガイドのモジュール | 読み込み、メモリのキャッシュ、リトライ、自動保存、シャットダウン時の保存、スキーマのバージョン。ロックなし | 全部読んで変更できるくらい短い |
| Roblox のプレイヤーデータと購入の例 | セッションロック、キーごとに順番に行うリトライ、購入レシートの処理を備えた Roblox の参考コード | Roblox は、人気のゲームで実績があるわけではなく、十分なテストなしにそのまま使うべきではないとしています |
| ProfileStore | ProfileService の後継となる、無料でオープンソースのコミュニティ製モジュール。セッションロックと自動保存を中心に作られています | Roblox 製ではありません。既存のゲームを移行するには、すでに保存されたデータの移行が必要です |
サードパーティのモジュールについて、Roblox は、誰が管理しているか、メンテナンスされているか、それがなくても自分のデータにどうアクセスするかを確認するよう勧めています。同じドキュメントは、DataStore2 を新しいゲームでは使うべきでない古いライブラリとしています。
データストアの制限
これは2026年9月30日時点の Roblox のドキュメントにある制限です。Roblox はこれを見直すことがあるので、正確な数値に頼る前にエラーコードと制限のページ(英語)を確認してください。
| リクエストの種類 | 通常のストア | 順序付きストア |
|---|---|---|
読み込み: GetAsync、UpdateAsync の読み込み | 60 + 40 × プレイヤー数 | 60 + 40 × プレイヤー数 |
書き込み: SetAsync、IncrementAsync、UpdateAsync の書き込み | 60 + 40 × プレイヤー数 | 30 + 5 × プレイヤー数 |
一覧: ListKeysAsync、順序付きストアでは GetSortedAsync | 5 + 2 × プレイヤー数 | 5 + 2 × プレイヤー数 |
削除: RemoveAsync | 60 + 40 × プレイヤー数 | 30 + 5 × プレイヤー数 |
プレイヤーが20人なら、サーバーは1分あたり860回の通常の書き込みができます。このモジュールの自動保存が使うのはそのうち約7回で、退出したプレイヤーごとに1回が加わります。予算を使い切るのは、コインを拾うたびに保存するようなやり方です。2つ目の予算はゲーム全体に適用され、Open Cloud と共有されます。1分あたり、読み込みは300回にオンラインのプレイヤー1人につき40回、書き込みは300回にプレイヤー1人につき20回です。
| 制限 | 値 |
|---|---|
| ストア名、キー名、scope | それぞれ50文字 |
| 1つのキーの値 | JSON で 4,194,304 文字 |
| すべてのサーバーからの1つのキーの読み込み | 1分あたり 25 MB |
| すべてのサーバーからの1つのキーへの書き込み | 1分あたり 4 MB。各リクエストは次の KB に切り上げられます |
| 待機中のリクエスト | キューごとに30件。それを超えたリクエストはエラー 301-306 で失敗します |
| ゲーム全体のストレージ | 500 MB に、これまでの全ユーザー1人につき 1 MB を加えたもの |
プレイヤーデータのサイズは #HttpService:JSONEncode(data) で測り、ライブサーバーの残りの予算は DataStoreService:GetRequestBudgetForRequestType(Enum.DataStoreRequestType.StandardWrite) で確認します。4秒のキャッシュから応答した GetAsync の呼び出しは数えられません。Studio の Run モードには独自の、もっと低いかもしれない制限があるので、リクエスト制限のテストには Team Create を使うよう Roblox は勧めています。
バージョンとバックアップ
通常のデータストアは履歴を自動で残します。UTC の各時間帯でキーへの最初の書き込みがバージョンとして保存され、その時間帯のそれ以降の書き込みは互いに上書きし合います。古いバージョンは、より新しい書き込みに置き換えられてから30日で期限切れになります。最新のバージョンは決して期限切れになりません。順序付きストアはバージョンを残しません。
1人のプレイヤーを巻き戻すには、Data Stores Manager(Creations、自分のゲーム、Configure > Data Stores Manager)を開き、そのプレイヤーのキーを選び、以前のバージョンを選んで Revert をクリックします。これには Edit 権限が必要です。プレイヤーがオフラインの間に行ってください。そうしないと、そのプレイヤーのセッションを持つサーバーが、巻き戻しの上に自分のコピーを保存してしまいます。サーバースクリプトからは、ListVersionsAsync と GetVersionAsync で古いバージョンを見つけて読み、それを現在の値として書き戻します。
データの保存方法を変えるアップデートを公開する前に、Open Cloud の Snapshot Data Stores API でスナップショットを取るよう Roblox は勧めています(ゲームごとに1日1回)。スナップショットがないと、UTC 3:30 の誤った保存が、3:00 以降にそのキーへ書き込まれたものをすべて上書きしてしまいます。同じ1時間のバージョンに入るからです。
よくあるエラーと対処法
データストアのエラーは Studio の Output ウィンドウに表示され、モジュールは試行が失敗するたびに Roblox のエラー文を含む警告を出します。Output の読み方全般はスクリプトエラーのガイドで説明しています。
StudioAccessToApisNotAllowed(エラー 403)
「Can't write to DataStore from Studio because API access is not enabled.」プレイスを公開してから、テスト用コピーの File > Experience Settings > Security で Enable Studio Access to API Services をオンにしてください。
DataStore request was added to queue
サーバーが予算で許されるより速くリクエストを送っているか、1つのキーに書き込みすぎています。たいていは変更のたびやループの中で保存しているのが原因です。キューが30件になると、新しいリクエストはエラー 301-306 で失敗します。データをメモリに保持し、タイマーで保存してください。
CantStoreValue(エラー 104)、またはフィールドが nil で返ってくる
テーブルに、Instance、Vector3、Color3 のようなストアが保存できないものが入っています。代わりに名前、ID、単純な数値を保存し、読み込むときにオブジェクトを作り直してください。
ValueTooLarge(エラー 105)
1つのキーに JSON で 4,194,304 文字を超えるデータが入っています。#HttpService:JSONEncode(data) で測り、作り直せるものを取り除くか、データを複数の固定キーに分けてください。
エラーは出ないのに、データが保存されない
モジュールの Could not load という警告を探してください。読み込みに失敗した後、モジュールはわざと保存を拒否します。そうでなければ、おそらく値を LocalScript で変更していて、それはサーバーに届いていないか、別のスクリプトが同じキーを保存しています。
参加し直すたびにデータがリセットされる
セッションごとにキーが変わっている(player.Name から作っている、または STORE_NAME を変えた)か、読み込みに失敗してデフォルト値を見ているか、モジュールをどこも読み込んでいないため、まったく動いていないかのどれかです。Output と、Main が PlayerData を読み込んでいることを確認してください。
RoCode で作る
自分で組み立てたくない場合は、RoCode がいま開いているプレイスで直接作ることもできます。RoCode は Roblox 製ではない独立した AI エージェントで、Roblox Studio のプラグインを通じて動きます。ほかのスクリプトと同じように DataStoreService を使う Luau を書き、Explorer にスクリプトを作成します。RoCode 自身がデータストアにアクセスすることはありませんが、プラグイン 3.9 以降なら Play を押して短いプレイテストを行えます。そこでは、どのテストとも同じようにあなたのスクリプトが動きます。
自分のゲームに保存を追加して: Coins、Level、Inventory を、自動保存とサーバーのシャットダウン時の保存付きの PlayerData モジュールに保存して、Coins をすでにある leaderstats に表示して。
- Search Scripts と Read Script で既存の leaderstats や DataStore のコードを探し、2つ目の保存スクリプトを足すのではなく、今あるものを拡張できます。大きなプレイスでは、メッセージでスクリプト名かフォルダー名を伝えてください。
- Create Script で ModuleScript とそれを読み込む Script を作るか、Edit Script で既存のものを変更します
- 書いたスクリプトごとに Check Script を実行します。これは Studio の中で行うコンパイルのチェックで、短い警告の一覧が出ます。型チェックやテスト実行ではありません
- 変更をまとまりごとに送り、まとまりごとに Studio の取り消し(undo)ポイントになります
テスト用コピーで Studio Access to API Services をオンにするのは、やはり自分で行う必要があります。RoCode はこの設定を変えられません。プラグイン 3.9 以降では短いプレイテストでエラーを読み取り、プラグイン 3.9.11 以降ではテスト用のキャラクターを操作してゲームが動くかを確認できます。ただし確認するのは RoCode 自身が確認すると決めたことだけなので、自分でも遊んで、Coins、Level、Inventory が保存され、読み込まれることを確かめてください。自分のテストで保存に失敗した場合は、Check Output が、あなたが実行したプレイテストの Server の行を読み取れます。保存は普通、メインのゲームループが動くようになってから追加します。この順番はAI で Roblox のゲームを1つのシステムずつ作る方法で紹介しています。RoCode が Studio に接続する仕組み。
よくある質問
Roblox Studio で DataStore を有効にするには?
プレイスを公開し、File > Experience Settings > Security を開き、Enable Studio Access to API Services をオンにして Save をクリックします。これは別のテスト用ゲームで行ってください。有効にすると、Studio はそのゲームのライブサーバーと同じデータストアを使うからです。
Roblox はプレイヤーのデータを自動で保存しますか?
いいえ。サーバーのスクリプトが DataStoreService で保存しない限り、プレイヤーのことはセッションの後に何も残りません。leaderstats も同じです。
ProfileStore と DataStoreService を直接使うのと、どちらを選ぶべきですか?
ProfileStore もデータストアの上に作られているので、問題はセッションロックを誰かに書いてメンテナンスしてもらいたいかどうかです。トレード、有料アイテム、頻繁なテレポートがあるなら、ライブラリでも Roblox の参考実装でも、ロックを入れる価値があります。もっと小さなゲームなら、このようなモジュールのほうが読みやすく、変更もしやすいです。
プレイヤーのデータをリセットまたは削除するには?
Data Stores Manager でキーを見つけて Mark for Deletion を選ぶ(待機期間のうちなら取り消せます)か、サーバースクリプトからそのキーに RemoveAsync を呼びます。プレイヤーがオフラインの間に行ってください。そうしないと、そのサーバーの次の保存がデータを書き戻してしまいます。テスト用コピーなら、STORE_NAME を変えれば全員がゼロから始まります。ライブのゲームでは絶対にしないでください。
参考資料
- Roblox Creator Docs: Data stores(英語). Studio のアクセス、GetAsync、SetAsync、UpdateAsync、set と update
- Roblox Creator Docs: Best practices for data stores(英語). プレイヤーごとに1つのキー、メモリ上のデータ、間隔を広げるリトライ、サードパーティのモジュール
- Roblox Creator Docs: Data store error codes and limits(英語). エラーコード、サーバーとゲームのリクエスト制限、サイズ、スループット、ストレージの制限
- Roblox Creator Docs: Versioning, listing and caching(英語). 1時間ごとのバージョン、スナップショット、4秒のキャッシュ、保存できるもの
- Roblox Creator Docs: Implement player data and purchasing systems(英語). 参考実装、セッションロック、読み込みの失敗、180秒ごとの自動保存
- Roblox Creator Docs: Data Stores Manager(英語). キーの表示、バージョンの巻き戻し、データの削除
- Roblox Engine API: DataModel:BindToClose(英語). シャットダウンに30秒
コードの検証方法: このページのスクリプトはすべて、Roblox API の型定義(luau-lsp、2026年11月20日)を使った Luau の strict 型チェックを通っています。型チェックで見つかるのは API 名の誤りや型の不一致であり、ゲームロジックの誤りは見つかりません。公開する前に必ず Studio でテストしてください。