クラウド配信でセーブデータが消える理由と永続ストレージの構築方法
要点まとめ
クラウドゲーム配信におけるセーブデータの消失を防ぐため、オブジェクトストレージとランチャーを用いた永続ストレージレイヤーの構築手法を解説します。
プレイヤーが3時間ゲームをプレイして進行状況を保存し、ストリームを閉じ、翌日戻ってきたところ、セーブデータが消えていた――。これはゲームコードのバグでもユーザーエラーでもありません。セーブファイルを保持していたストリーミングインスタンスが終了して新しいインスタンスに置き換えられ、ローカルデータのすべてのバイトが一緒に消去されたのです。
これがクラウドゲームストリーミングにおける根本的なアーキテクチャの罠です。Amazon GameLift Streamsなどのプラットフォームは、エフェメラルな(一時的な)コンピューティングを使用することでコストを最適化しています。各セッションは新しいインスタンスを起動し、ゲームバイナリを実行し、セッション終了時にそれを破棄します。リソース効率には優れていますが、ディスクにファイルを書き込むすべてのゲームにとっては最悪です。セーブシステム自体は完璧に機能しており、ゲームは設計通りに %APPDATA%/YourGame/save.dat へ書き込んでいますが、ファイルシステム自体が一時的なものです。
このランブックでは、何が壊れるのか、どうやってそれを検知するか、クラウドオブジェクトストレージを使用して永続的なセーブレイヤーを構築する方法、そして実際の実行コストがどれくらいになるのかを詳しく解説します。以下のスクリプトはすべて本番環境でテスト済みであり、すぐにプロジェクトに組み込むことができます。
何が壊れるのか:エフェメラルインスタンスのライフサイクル
一般的なクラウドストリーミングセッションのライフサイクルと、それがどこで失敗するのかを以下に示します。
- セッション開始 — プラットフォームがインスタンスをプロビジョニングし、ゲームバイナリをアップロードする
- プレイヤー接続 — ゲームが起動し、プレイヤーがプレイを開始する
- セーブデータの書き込み — セーブファイルがローカルディスクに保存される(ゲームはこのディスクが一時的なものであることを知らない)
- セッション終了 — プレイヤーが切断し、インスタンスが終了またはリサイクルされる
- ファイルの破棄 — すべてのローカルファイルがワイプされ、次のセッションはゼロから開始される
重大な障害ポイントはステップ4から5への移行です。ゲームのセーブシステムは本来あるべき動作を正確に行っていますが、その下のプラットフォームがファイルシステムを使い捨てのものとして扱っていることが問題です。これはゲームプレイのバグを装ったインフラストラクチャの問題であり、このようなサーバーのライフサイクルに関する問題は、プレイヤーがクラウドストリーミングタイトルを離脱する最も一般的な理由の1つです。
この問題を検知する方法
症状は具体的かつ再現性があります。
- プレイヤーからの報告: 「セーブデータが消え続ける」が、クラウド/ストリーミングユーザーでのみ発生し、ローカルインストールでは発生しない
- クラッシュログなし: ゲームは完璧に動作しており、次回の起動時にセーブデータが存在しないだけである
- セッションスコープの永続性: データは1つのセッション内では維持されるが、セッション間では消滅する
- プラットフォーム固有: ストリーミングインスタンスにのみ影響し、ローカルビルドやDedicated Serverビルドには影響しない
バグ報告がこのパターンに一致する場合、エフェメラルインスタンスの問題が発生しています。ゲーム側のデバッグをどれだけ行っても解決しません。解決策はインフラストラクチャレイヤーにあります。
アーキテクチャ:永続レイヤーとしてのオブジェクトストレージ
修正方法は概念的にはシンプルです。長期保存のためにインスタンスのローカルファイルシステムに依存するのをやめ、信頼性の高いオブジェクトストレージサービス(Amazon S3など)を信頼できるセーブ場所として使用します。ランチャースクリプトが同期を透過的に処理するため、ゲームコードを変更する必要はありません。
このストレージレイヤーを自分で構築したくない場合は、horizOn cloud savesを使用してマネージドバックエンドでプレイヤーのセーブデータを管理できます。
フローは以下のようになります。
- ゲーム起動前: S3から既存のセーブデータをダウンロード → ローカルファイルシステムへ
- ゲームプレイ中: ローカルのセーブファイルの変更を監視 → 更新をS3に同期
- セッション終了時: 最終同期により、インスタンスの破棄前にすべてのデータが確実に永続化される
ゲームはこれまで通りローカルディスクに書き込みを行いますが、ランニヤーがそれらの書き込みをクラウドストレージにミラーリングしていることには気づきません。このゼロ変更アプローチにより、ゲームのコードを1行も触ることなく、既存のゲームに永続的なセーブ機能を追加できます。
ステップ1: IAMロールの設定
ストリーミングセッションにS3バケットへのスコープ付きアクセスを許可するIAMロールが必要です。このロールはストリーミングサービスを信頼し、最小権限の原則に従う必要があります。
以下の信頼ポリシーを持つロールを作成します([ACCOUNT_ID] をAWSアカウントIDに置き換えてください):
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "gameliftstreams.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "[ACCOUNT_ID]"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:gameliftstreams:*:[ACCOUNT_ID]:streamsession/*"
}
}
}
]
}
次に、必要なS3操作のみを許可するインラインポリシーをアタッチします。
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject"
],
"Resource": "arn:aws:s3:::your-save-bucket/saves/*"
}
]
}
重要: Resource は /saves/* などの特定のプレフィックスにスコープを限定し、バケット全体を指定しないでください。これにより、ロールが侵害された場合の被害範囲(ブラストradius)を制限し、セキュリティのベストプラクティスに従うことができます。プラットフォームの要件により、ロール名は GameLiftStreams- で始まる必要があります。
ステップ2: ランチャースクリプト(Windows)
ランチャースクリプトはオーケストレーターです。既存のセーブデータをダウンロードし、ゲームを起動し、変更を同期するためのバックグラウンドファイルウォッチャーを実行します。以下はWindowsバッチ版です。
@echo off
setlocal
set SCRIPT_DIR=%~dp0
if not defined LOCAL_SAVE_FILE_PATH (
echo WARNING: LOCAL_SAVE_FILE_PATH not set, skipping save sync
goto :start_app
)
if not defined S3_SAVE_PATH (
echo WARNING: S3_SAVE_PATH not set, skipping save sync
goto :start_app
)
set LOG_FILE=%SCRIPT_DIR%save_sync.log
set REGION_ARG=
if defined AWS_REGION set REGION_ARG=-Region "%AWS_REGION%"
REM Download existing save from S3
powershell -NoProfile -ExecutionPolicy Bypass -File "%SCRIPT_DIR%download-save.ps1" ^
-S3Path "%S3_SAVE_PATH%" -LocalPath "%LOCAL_SAVE_FILE_PATH%" ^
-LogFile "%LOG_FILE%" %REGION_ARG%
REM Start background file watcher
start "" /b powershell -NoProfile -WindowStyle Hidden -ExecutionPolicy Bypass ^
-File "%SCRIPT_DIR%watch-save.ps1" -WatchPath "%LOCAL_SAVE_FILE_PATH%" ^
-S3Path "%S3_SAVE_PATH%" -LogFile "%LOG_FILE%" %REGION_ARG%
:start_app
REM Replace with your actual game executable:
YourGame.exe -f
2つの環境変数(S3_SAVE_PATH と LOCAL_SAVE_FILE_PATH)は、バックエンドサービスが StartStreamSession を呼び出す際に渡されます。S3パスはプレイヤーごとに一意である必要があり、s3://your-bucket/saves/{player-id}/save.dat のように認証されたプレイヤーIDから構築してください。セッションIDは絶対に使用しないでください。セッションIDはセッションごとに変更されるため、セーブデータが孤立してしまいます。
ステップ3: ダウンロードスクリプト
このPowerShellスクリプトは、S3に既存のセーブファイルがないか確認し、存在する場合はダウンロードします。
param(
[Parameter(Mandatory=$true)][string]$S3Path,
[Parameter(Mandatory=$true)][string]$LocalPath,
[Parameter(Mandatory=$true)][string]$LogFile,
[Parameter(Mandatory=$false)][string]$Region
)
$timestamp = Get-Date -Format 'yyyy-MM-dd HH:mm:ss'
Add-Content -Path $LogFile -Value "$timestamp - Checking for save at: $S3Path"
$regionArgs = @()
if (-not [string]::IsNullOrWhiteSpace($Region)) {
$regionArgs = @('--region', $Region)
}
# Ensure local directory exists
$localDir = Split-Path $LocalPath -Parent
if (-not (Test-Path $localDir)) {
New-Item -ItemType Directory -Path $localDir -Force | Out-Null
}
try {
$result = & aws s3 cp $S3Path $LocalPath @regionArgs 2>&1
if ($LASTEXITCODE -eq 0) {
Add-Content -Path $LogFile -Value "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') - Downloaded save from S3"
} else {
Add-Content -Path $LogFile -Value "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') - No existing save found (first session?)"
}
} catch {
Add-Content -Path $LogFile -Value "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') - Download error: $_"
}
既存のセーブデータがない初回プレイヤーの場合、S3のコピーは失敗しますが、これは想定内の動作です。ゲームが新しいセーブファイルを作成し、ウォッチャーがそれを検知します。
ステップ4: ファイルウォッチャー
これは、ゲームプレイ中にセーブデータの同期を維持するコンポーネントです。
param(
[Parameter(Mandatory=$true)][string]$WatchPath,
[Parameter(Mandatory=$true)][string]$S3Path,
[Parameter(Mandatory=$true)][string]$LogFile,
[Parameter(Mandatory=$false)][string]$Region
)
$timestamp = Get-Date -Format 'yyyy-MM-dd HH:mm:ss'
Add-Content -Path $LogFile -Value "$timestamp - Watching for changes: $WatchPath"
$regionArgs = @()
if (-not [string]::IsNullOrWhiteSpace($Region)) {
$regionArgs = @('--region', $Region)
}
$folder = Split-Path $WatchPath -Parent
$fileName = Split-Path $WatchPath -Leaf
if (-not (Test-Path $folder)) {
New-Item -ItemType Directory -Path $folder -Force | Out-Null
}
try {
$watcher = New-Object System.IO.FileSystemWatcher
$watcher.Path = $folder
$watcher.Filter = $fileName
$watcher.NotifyFilter = [System.IO.NotifyFilters]::LastWrite -bor `
[System.IO.NotifyFilters]::Size
$watcher.EnableRaisingEvents = $true
while ($true) {
$change = $watcher.WaitForChanged(
[System.IO.WatcherChangeTypes]::All, 1000
)
if (-not $change.TimedOut) {
$ts = Get-Date -Format 'yyyy-MM-dd HH:mm:ss'
Add-Content -Path $LogFile -Value "$ts - Change detected: $($change.ChangeType)"
try {
$s3Result = & aws s3 cp $WatchPath $S3Path @regionArgs 2>&1
if ($LASTEXITCODE -eq 0) {
Add-Content -Path $LogFile -Value "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') - Synced to S3"
} else {
Add-Content -Path $LogFile -Value "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') - Sync failed: $s3Result"
}
} catch {
Add-Content -Path $LogFile -Value "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') - Sync error: $_"
}
}
}
} catch {
Add-Content -Path $LogFile -Value "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') - Watcher crashed: $_"
}
ステップ5: Linux/Protonのバリエーション
Linuxベースのストリーミングインスタンスの場合、PowerShellウォッチャーを inotifywait に置き換えます。
#!/bin/bash
# watch-save.sh — Linux equivalent using inotify-tools
WATCH_PATH="$1"
S3_PATH="$2"
LOG_FILE="$3"
echo "$(date -Iseconds) - Watching: $WATCH_PATH" >> "$LOG_FILE"
while true; do
inotifywait -e modify -e create "$WATCH_PATH" 2>/dev/null
sleep 2 # Brief debounce
aws s3 cp "$WATCH_PATH" "$S3_PATH" 2>/dev/null
if [ $? -eq 0 ]; then
echo "$(date -Iseconds) - Synced to S3" >> "$LOG_FILE"
else
echo "$(date -Iseconds) - Sync failed" >> "$LOG_FILE"
fi
done
コストの内訳:実際の数字
このアーキテクチャの実際の実行コストを数値化してみましょう。
S3 PUTリクエスト(書き込み操作)
ゲームがゲームプレイ中に30秒ごとにオートセーブを行う場合、一般的な2時間のセッションで約 240回のPUTリクエスト が発生します。S3の料金が1,000リクエストあたり$0.005の場合:
- セッションあたりのコスト: $0.0012
- 月間10,000プレイヤーセッションあたりのコスト: $1.20
S3 GETリクエスト(読み込み操作)
既存のセーブデータをダウンロードするためにセッション開始ごとに1回のGETリクエストが発生します。
- 10,000セッションあたりのコスト: $0.40
S3ストレージ
平均セーブファイルサイズ:プレイヤーあたり5MB。月間アクティブプレイヤー(MAU)10,000人の場合:
- 合計ストレージ: 約50GB
- 月額コスト($0.023/GB): $1.15
10,000 MAUあたりの合計月額コスト
月額3ドル未満。 これはコンピューティングコストに比べればごくわずかです。S3レイヤーはインディーズ規模では実質的に無料です。
本番環境の最適化:デバウンス(チャタリング防止)による同期
生データのファイルウォッチャーは書き込みごとに発火します。頻繁にオートセーブを行うゲーム(10〜15秒ごと)では、過剰なPUTリクエストが発生します。デバウンス遅延を追加し、最後の変更から5秒待ってから同期を行います。
# Debounce logic — add to the change handler in watch-save.ps1
$lastSync = [DateTime]::MinValue
$debounceSeconds = 5
# Inside the WaitForChanged loop, replace the sync block:
if (-not $change.TimedOut) {
$now = Get-Date
if (($now - $lastSync).TotalSeconds -ge $debounceSeconds) {
& aws s3 cp $WatchPath $S3Path @regionArgs 2>&1
$lastSync = $now
}
}
これにより、データ損失のリスクを最小限に抑えながら、PUTリクエストを 60〜80%削減 できます。デバウンスの途中でインスタンスが終了した場合でも、失われる進行状況はせいぜい5秒分であり、ほとんどのゲームで許容範囲内です。
エッジケースと障害モード
セーブファイルがまだ存在しない場合(初回プレイヤー)
ダウンロードステップは失敗しますが、それは正しい動作です。ゲームが新しいセーブファイルを作成し、ファイルウォッチャーが最初の書き込み時にそれを検知します。特別な処理は必要ありません。
ネットワーク切断による破損したアップロード
PUTリクエスト中にネットワークが切断された場合、S3オブジェクトが不完全になる可能性があります。アップロード後にETagを検証することでこれを軽減できます。
# After syncing, verify upload integrity
$localHash = (Get-FileHash -Path $WatchPath -Algorithm MD5).Hash.ToLower()
$s3Head = & aws s3api head-object --bucket your-bucket --key saves/player123/save.dat 2>&1
$s3ETag = ($s3Head | ConvertFrom-Json).ETag.Trim('"')
if ($localHash -ne $s3ETag) {
Add-Content -Path $LogFile -Value "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') - INTEGRITY MISMATCH - re-uploading"
& aws s3 cp $WatchPath $S3Path @regionArgs 2>&1
}
複数のセーブスロット
ゲームが複数のセーブファイルをサポートしている場合は、単一ファイルではなくディレクトリを監視します。$watcher.Filter を * に設定し、セーブディレクトリ全体を同期します。ファイル数が膨大な場合は、アップロード前に単一の .zip にアーカイブしてください。
セーブファイルのサイズ制限
S3は最大5TBのオブジェクトをサポートしているため、ファイルサイズは実用上の問題になりません。ほとんどのゲームのセーブデータは500KBから50MBの範囲です。巨大な状態を持つプロシージャル生成ワールド(500MB超)を扱う場合は、アップロード前にgzipで圧縮することを検討してください。通常のセーブデータは元のサイズの20〜40%に圧縮されます。
プレイヤーが複数のデバイスでプレイする場合
プレイヤーが同じ日に異なるデバイスからストリーミングプレイする場合、最後のセッションのセーブデータが前のものを上書きします。ほとんどのシングルプレイヤーゲームでは、これが正しい動作です。クラウド同期インベントリのようにマージセマンティクスが必要なゲームの場合は、競合解決ロジックが必要になり、ここで専用のバックエンドサービスが不可欠になります。
ベストプラクティス
IAMロールのスコープを特定のS3プレフィックスに限定する — バケット全体に許可するのではなく、
arn:aws:s3:::your-bucket/saves/*を使用します。これにより最小権限の原則に従い、認証情報が漏洩した場合の被害を抑えられます。プラットフォーム要件を満たすため、ロール名はGameLiftStreams-で始める必要があります。認証されたIDからプレイヤーごとのS3キーを構築する —
saves/{session-id}/save.datではなく、saves/{platform-user-id}/save.datを使用します。セッションIDはセッションごとに変更されるため、セーブデータが完全に孤立してしまいます。本番環境でデバウンス同期を実装する — 生のファイルシステムウォッチャーはセーブごとにPUTリクエストを生成します。5秒のデバウンスウインドウを設けることで、データ損失のリスクを1つのオートセーブ間隔未満に抑えつつ、APIコールを60〜80%削減できます。
すべての同期操作をログに記録する — セーブの失敗は、プレイヤーが何時間もの進行状況を失うまで気づかれません。上記のスクリプトにおける
$LogFileパターンを使用すると、インスタンス上で永続的な監査証跡を取得できます。これらのログをモニタリングシステムに転送し、プロアクティブなアラートを設定してください。切断だけでなくインスタンスの終了でテストする — ゲームの途中でストリーミングインスタンスを強制終了し、デバウンス同期のウインドウが許容範囲内であることを確認します。正常な切断では最終同期が完了する時間が与えられますが、突然の終了では与えられません。
BaaSのショートカット:自作する価値がない場合
上記のアーキテクチャは機能します。実証済みであり、実行コストもほとんどかかりません。しかし、IAMロール、ランチャースクリプト、ファイルウォッチャー、整合性チェック、Linuxのバリエーション、環境ごとの設定を管理する必要があります。小規模なチームにとって、これは実際のゲーム制作とは何の関係もないインフラ作業に2〜4日を費やすことを意味します。
horizOnは、クラウドセーブをマネージドサービスとして提供しています。ゲームはUnity、Godot、UnrealのSDKまたはREST APIを介してセーブデータや進行状況をバックエンドに書き込むため、ストリーミングインスタンスのディスクに依存するものは何もありません。ストレージコードを自分で書く必要はなく、すべてのアカウントが日次バックエンド付きの独自のデータベースを取得します。
まとめ
クラウドストリーミングにおける永続的なゲームセーブには、インスタンスのファイルシステムを一時的なものとして扱い、信頼性の高いオブジェクトストレージを信頼できる情報源として使用することが求められます。完全なアーキテクチャは以下の通りです。
- IAMロールがストリーミングセッションにスコープ付きのS3読み取り/書き込みアクセスを許可する
- ランチャースクリプトがゲーム起動前に既存のセーブデータをダウンロードする
- バックエンドファイルウォッチャーがデバウンス書き込みを用いてゲームプレイ中の変更をS3に同期する
- バックエンドサービスが認証されたプレイヤーIDからプレイヤーごとのS3パスを構築する
- 整合性チェックが同期ごとにアップロード/ダウンロードの正確性を検証する
インディーズ規模でのコストは、10,000人のアクティブプレイヤーに対して月額3ドル未満です。自分で構築する場合の実装には1〜2日かかりますが、horizOn cloud savesにストレージレイヤーを任せることも可能です。
いずれにせよ、この問題を解決せずにクラウドストリーミングゲームをリリースしないでください。プレイヤーはセーブデータが消えていることをあなたに教えてはくれません。ただプレイをやめるだけです。