移動されるもの
Runtime Path 内のすべて: インスタンス (Mod、ワールド、設定)、Minecraft 共有アセット、Minecraft 共有ライブラリ、GDLauncher がダウンロードした Java、ランチャーデータベース、アプリ全体ログ。要するに GDLauncher がマシン上で生成した重いものすべて。移動しないもの: App Data Path (ウィンドウ状態、Electron キャッシュ、トップレベル設定)。OS 標準位置に残り、通常触ることはありません。
予想されるサイズ
インスタンスなしのクリーンインストールは約 1 GB (Minecraft アセットと Java インストールがほぼ)。各 Modpack はおおよそその自身のダウンロードサイズ分追加され、大きな Pack を数個入れれば 50 GB 超に。OS のファイルマネージャーで現在のデータパスのサイズを確認すれば、マイグレーション時間を見積もれます。
すでに手動で移動済みの場合
gdlauncher_carbon/data を手動で別の場所にコピーした場合 (Settings を経由せず)、GDLauncher を新しい場所に向けられます。すでに有効な GDLauncher データが入っているパスを入力するとマイグレーションがスキップされ、GDLauncher は設定だけ更新。別マシンへ移動してから新規インストールで移行済みデータを指す場合に便利。
マイグレーション失敗時
問題があれば進行モーダルにエラーが表示されます。よくある原因: 対象ドライブの容量不足 (ソースデータと同等以上の空きが必要、エラーには不足バイト数が記載)。権限拒否 (Windows では Program Files や C:\ ルートに管理者権限必要、Linux/macOS では所有パスでなければならない、ユーザー所有フォルダーを選択)。対象が読み取り専用 (一部のネットワークドライブは読み取り専用でマウント、GDLauncher 外で先にファイル作成可能か確認)。マイグレーション失敗後、GDLauncher は元の場所にフォールバックしエラーを表示。詳細は __gdl_logs__ 内のファイルで読めます。
runtime_path_override マーカー
移動成功後、GDLauncher は App Data Path (Runtime Path 内ではない) に runtime_path_override という小さなテキストファイルを書きます。内容は新しい Runtime Path。各起動でこのファイルを読み、データがどこにあるかを判定。誤って削除すると、ランチャーはデフォルト位置にフォールバックし、移動したデータは Settings → Runtime Path で移動先フォルダーを再指定するまで見えません (「すでに使用中」と認識され、コピーなしで切替)。
プレイ中に Runtime Path を同期しない
OneDrive、iCloud、Dropbox などは GDLauncher とファイルハンドルで競合します。Runtime Path がこれらが積極的に同期するフォルダー内にあると、奇妙な「ファイル使用中」エラーや、たまにセーブ破損が発生。連続同期するドライブではなく、オフラインバックアップされるドライブ (スナップショット、restic、Backblaze など) に Runtime Path を置いてください。