World Dimension Loader 1.3.0 - アップグレードガイド

============================================================
1. 既存Config
============================================================
WDLは既存Configを自動上書きしません。

更新前:
1) config/worlddimensionloader/をバックアップ
2) 重要ワールドをバックアップ
3) 新版確認が終わるまで旧Configを保持

最新の生成コメントを見る場合:
- 旧Configを退避
- 一度起動
- 再生成ファイルと比較
- 意図した上書き値だけ移す

============================================================
2. Gate selectionの重要な移行
============================================================
旧parserではselection_mode省略時、dimensions=[...]があってもALL扱いでした。

WDL 1.3.0では次の曖昧な形:

[[gates]]
id = "example"
dimensions = ["test_world_01"]

をLISTとして扱います。

既存Gateで意図的にALLを使っていた場合:

selection_mode = "ALL"

を追加してください。

selection_modeもdimensionsも省略した場合は旧互換ALLを維持します。

明示した不正selection_modeは勝手に補正せず拒否します。

============================================================
3. 最小Config
============================================================
Dimension:

[[dimensions]]
id = "test_world_01"

Gate:

[[gates]]
id = "test_world_01_gate"
dimensions = ["test_world_01"]

============================================================
4. Cleanupキー移行
============================================================
現行:
runtime.defer_dimension_cleanup_until_restart

旧:
runtime.resident_reset_compatibility

現行キーがあれば現行を優先し、旧キーは現行が無い場合だけ利用します。

安全側初期値はtrueです。

============================================================
5. Historyキー移行
============================================================
現行:
gate_history.max_entries

旧:
return_history.max_entries

現行キーを優先します。

============================================================
6. 旧RETURN Gate
============================================================
gate_type="RETURN"は互換読込できます。
LIST -> minecraft:overworldとして扱います。

新規定義ではgate_typeを使わないでください。

============================================================
7. Runtime保存構造
============================================================
WDL 1.3.0はactive save内部でtimestamp物理世代を利用します。

例:
dimensions/wdl/test_world_01/20260822123000/

これは内部Runtime保存です。

インポート元コピー:
WDL_custom_dimensions/test_world_01/

インポート元をRuntime世代フォルダへ移動しないでください。

============================================================
8. Reset
============================================================
Resetはインポート元コピーからfresh Runtime世代を作ります。
Runtime内の変更は失われる場合があります。

安全側初期設定では旧世代を再起動まで保持するため、一時的に大きな容量を使う場合があります。

ゲーム中削除は非推奨です。Valkyrien Skies検知時はdeferred cleanupを強制します。

============================================================
9. STARTUP ONLY
============================================================
/wdl scanでは実行中プロセスのstartup-latched方式は切り替わりません。

cleanup/retired-generation方式やAdvanced Dimension Igniter耐久値を変えた場合は再起動してください。

============================================================
10. 互換性
============================================================
現在の保護/検証はValkyrien Skies 2.4.11、Distant Horizons 3.2.0-bの挙動を中心にしています。
将来の未知バージョンを保証するものではありません。
