World Dimension Loader 1.2.2 - 1.0.0 / 1.1.x / 1.2.xからの更新ガイド

============================================================
1.2.1 -> 1.2.2
============================================================
必須のConfig移行はありません。既存1.2.1 Configはそのまま利用でき、自動書換えされません。

1.2.2はRuntime既定値を変えず、Configの「見せ方」を整理します。
- 初期値の設定は省略して表現
- 自動生成Configに全項目コメントアウト済みALL OPTIONS TEMPLATEを用意
- 実用例は初期値と同じ項目を省略
- common.tomlは有効な設定行が0件でも正常
- .template.tomlは未完成の空欄式ではなく、有効なコメントOnly TOMLへ変更
- Java自動生成Configと*.example.tomlを同期

初期値のままなら省略できる代表例:
- dimensions.respawn.mode -> INHERIT
- dimensions.runtime.keep_loaded -> false
- dimensions.bed.allow_bed_respawn -> false
- dimensions.anchor.enabled -> true
- Inventory/Travel Policy -> 制限なし
- Gate enabled/frame/size/open time -> WDL既定値
- Gate allowed_igniters -> 通常WDL Igniter制限なし

簡潔な1.2.2形式を使いたい場合だけ推奨:
1. Minecraft/サーバー停止
2. config/worlddimensionloader/をバックアップ
3. 旧Configを退避
4. WDL 1.2.2を起動して新Config生成
5. 旧Configから「意図的に変更していた値だけ」コピー
6. /wdl scan -> /wdl list -> /wdl status とGate動作を確認

ALL OPTIONS TEMPLATEは設定辞書です。通常の定義へ全行を書き写す必要はありません。

============================================================
1.2.0 -> 1.2.1
============================================================
破壊的migrationは不要です。既存Configはそのまま利用できます。

変更点:
- 自動生成Config/example/templateのコメントを英語のみに整理
- allowed_igniters未記入または[] = 通常WDL Dimension Igniterを制限しない
- 非空リスト = 記載した通常Igniterだけに制限
- Creative Dimension IgniterのMaster/Policy/Cost bypass仕様は変更なし
- same-frame競合判定はwildcardを考慮してfail-closed

1.2.0で明示的にBasic+Advancedを列挙しているGateは、そのままBasic+Advanced限定として動作します。
1.2.0でallowed_ignitersが未記入/[]だったGateは、1.2.1では将来追加される通常WDL Igniterも受け入れるunrestricted Gateになります。現在の標準Igniter構成では通常の利用感はほぼ変わりません。

既存の日本語+英語混在Configも有効です。英語のみの新形式が欲しい場合だけ、Configをバックアップして再生成してください。

旧1.0.0/1.1.xからの移行:
WDL 1.2.xは旧Configを可能な限り読込しますが、Gate/History/Policyの考え方が整理されたため、バックアップ後のConfig再生成を推奨します。

推奨移行:
1. Minecraft/サーバー停止
2. config/worlddimensionloader/ を丸ごとバックアップ
3. 既存Configを別名へ退避
4. WDL 1.2.1を入れて起動。ワールドを開く前に新Config生成
5. 新Configのコメントを読み、必要なDimension/Gate/Policy設定だけ手作業で移行
6. /wdl scan -> /wdl list -> /wdl status
7. Gate、Overworld Gate、Gate History、Return Scroll、Policy、Anchor、Bed/Respawnを確認

互換性:
- 既存Configは削除必須ではありません
- 自動破壊的migrationはしません
- gate_type="DIMENSION" -> 通常Gateとして読込
- gate_type="RETURN" -> Overworld行き通常GateのLegacy alias
- 新規gates.tomlではgate_typeを書きません
- 旧[dimensions.return_gate].enabledはLegacy RETURN aliasだけの互換ガード。新しい通常Overworld Gateには適用しません
- 旧[return_history].max_entriesは新[gate_history].max_entriesが無い場合のみfallback
- 旧Return History SavedDataは新Gate Travel Historyへ自動変換しません

Return Gateからの移行:
旧:
gate_type = "RETURN"

新:
selection_mode = "LIST"
dimensions = ["minecraft:overworld"]

Gate Travel Historyが有効な完全逆経路では元Gate付近へのLandingを補助しますが、Destination自体は常にGate Configが決めます。

1.2.xで確認する主要設定:
[gate_history] max_entries=3
Dimensionごとのinventory.import/export
Dimensionごとのtravel.import/export
[dimensions.anchor] enabled
[dimensions.return_scroll] enabled / xp_level_cost
[dimensions.runtime] keep_loaded
[dimensions.bed] allow_bed_respawn

Config生成タイミング:
旧版でワールドロード後に生成されていたConfigも、現在は不足時にゲーム起動時生成です。

公開前/本番移行前には元ワールドとConfig両方のバックアップを推奨します。


Advanced Dimension Igniter耐久
旧common.tomlに [items].advanced_dimension_igniter_durability が無い場合は初期値100を使用します。最新版Configを再生成すると項目が追加されます。変更後は完全再起動が必要です。
