roblox-data

roblox data persistence

読み込むタイミング

プレイヤーの保存データ、移行、再試行、シャットダウン、セッションの所有権を扱う場合に読み込みます。リーダーボード／メッセージング／ワールドデータについては roblox-server-data、Open Cloud については roblox-cloud を参照してください。

クイックリファレンス

• プレイヤーの状態を保存する前に、シリアライズ可能なテンプレートとバージョンフィールドを定義します。ネストされたデフォルト値が共有されないようにテンプレートをディープコピーし、移行した後、テンプレートと照合して不足しているフィールドを補います。環境ごとにストア名を分け（PlayerData_Studio）、Studio での書き込みが本番環境に入らないようにします。
• 読み取り・変更・書き込みには UpdateAsync を使用し、スロットリングや一時的なエラーに対処します。
• セッション所有権プロトコルを使用して、プロファイルの同時変更を防ぎます。
• ProfileStore を使用する場合は、ドキュメントに従って StartSessionAsync、Profile.OnSessionEnd、EndSession を使用します。通常の読み込みで Steal は使用せず、一時的な Studio 書き込みには ProfileStore.Mock を使用します。
• 重要な変更時やライフサイクルの境界で保存します。PlayerRemoving だけでは不十分です。BindToClose で保留中の処理を完了します。
• プリミティブ値／配列／辞書を保存します。Instances／userdata／functions／循環テーブルは、事前に変換します。数値（NaN／inf でないこと）、文字列（utf8.len）、ネストされたテーブルを検証します。不正な値が1つでもあると書き込みに失敗します。
• RTBF：{UserId} の削除テンプレートと照合できるよう、キー内の静的な部分文字列としてユーザー ID を保持します（player_<UserId>）。ハッシュ化されたキーやランダムなキーでは、手動で消去する必要があります。
• GetAsync は4秒間のローカルキャッシュを使用します（DataStoreGetOptions.UseCache、デフォルトは true）。書き込みを検証するには UseCache = false を指定します。
• DataStoreService:GetRequestBudgetForRequestType をポーリングして、リアルタイムの余裕を確認します。クォータは同時接続ユーザー数に応じて増加します（エクスペリエンスの読み取り：300 + CCU x 40／分）。
• 新しいコードでは player.User（User.Id、DomainType、DomainId）でユーザーを識別します。UserId も引き続き使用できますが、同じキー方式で2種類の ID を混在させないでください。
• 初回セッションのトレースについては、roblox-analytics §8 を参照してください。

永続化ワークフロー：references/full.md