World Dimension Loader 1.3.0 - Configガイド

Configフォルダ:
config/worlddimensionloader/

ファイル:
- common.toml
- dimensions.toml
- gates.toml

不足ファイルは自動生成されます。既存ファイルは自動上書きされません。
生成Configは ALL OPTIONS、使用例、LEGACY COMPATIBILITY に分かれます。

============================================================
1. common.toml
============================================================

[general]

strict_validation = true
初期値: true
インポート元のgenerator情報を安全に解釈できない場合、危険なfallbackを拒否します。

debug_logging = false
初期値: false
WDLの追加診断ログを有効にします。

default_gate_open_time_seconds = 10
初期値: 10
通常Gateの標準開放秒数です。

default_min_inner_width = 2
初期値: 2
有効範囲: 2..32

default_min_inner_height = 3
初期値: 3
有効範囲: 3..32

default_max_inner_width = 32
初期値: 32
min以上、最大32へ補正されます。

default_max_inner_height = 32
初期値: 32
min以上、最大32へ補正されます。

[paths]

dimension_root_folder = "WDL_custom_dimensions"
初期値: WDL_custom_dimensions
インポート元ワールドコピーのルートです。

[items]

advanced_dimension_igniter_durability = 100
初期値: 100
範囲: 1..10000
STARTUP ONLY。完全な再起動が必要です。

[runtime]

storage_mode = "AUTO"
初期値: AUTO
通常利用: AUTO, IMPORT
DIRECTはWDL 1.3.0では予約/未提供です。

max_loaded_dimensions = 8
初期値: 8
最小値: 1
現在ロード中の論理WDL Dimension数だけを数えます。retired Resident物理世代はこの枠に含みません。

auto_unload = false
初期値: false

unload_delay_seconds = 300
初期値: 300
最小: 10秒

vs_remount_cooldown_ticks = 100
初期値: 100
最小: 20
互換性向けの上級設定です。

defer_dimension_cleanup_until_restart = true
初期値: true
STARTUP ONLY。
trueが安全推奨です。旧物理世代をプレイ中に削除せず、次回起動時に整理します。
falseはゲーム中Unload/Deleteを許可しますが、他MODがDimension参照を保持している可能性があるため非推奨です。
Valkyrien Skies検知時は実効値trueを強制します。

resident_gc_backup = false
初期値: false
Startup GC前バックアップは任意です。
true時の最新成功バックアップ:
WDL_backups/resident_gc/<save-id>/latest.zip
バックアップ失敗時は、その起動の削除候補を削除しません。
falseへ戻しても既存バックアップは自動削除しません。

resident_retired_generation_limit = 100
初期値: 100
最小: 0
WDL独自の最大値なし
STARTUP ONLY。
RETIRED + LIVE_ORPHAN + Rotation予約の安全上限です。
0は同一プロセス内Resident Rotationを禁止し、再起動/offline Reset進行を必要とします。

RESET容量注意:
安全側の初期設定では、再起動まで複数の物理世代が一時的に残るため、Resetを繰り返すとディスク容量を大量に使う場合があります。ゲーム中削除は容量を抑えられる場合がありますが、安全性・他MOD互換性のため推奨しません。

[respawn]

mode = "OVERWORLD"
初期値: OVERWORLD
値: OVERWORLD, VANILLA

prefer_overworld_player_spawn = true
初期値: true

fallback_to_overworld_world_spawn = true
初期値: true

[return_scroll]

default_xp_level_cost = 5
初期値: 5
最小: 0

[gate_history]

max_entries = 3
初期値: 3
範囲: 1..10

[rarity_weights]

COMMON = 100
UNCOMMON = 60
RARE = 25
EPIC = 10
LEGENDARY = 3
上記が初期値です。0以上へ補正されます。

旧commonキー:
runtime.resident_reset_compatibility
defer_dimension_cleanup_until_restartが無い場合だけ利用。

return_history.max_entries
gate_history.max_entriesが無い場合だけ利用。

============================================================
2. dimensions.toml
============================================================

正式な最小構成:

[[dimensions]]
id = "test_world_01"

id
必須。
test_world_01のようなnamespace無しの小文字WDL IDを使用します。
worlddimensionloader:test_world_01のようなnamespaced definition IDは使いません。
不正/namespace付きIDは早期に拒否します。

display_name
初期値: id

enabled
初期値: true

folder
初期値: id

rarity
初期値: COMMON
値: COMMON, UNCOMMON, RARE, EPIC, LEGENDARY, CUSTOM

weight
初期値: 省略
省略時はcommonのrarity weightを利用。
CUSTOMでweightも省略した場合は最終fallback 1。

[dimensions.destination]

prefer_anchor = true
初期値: true

prefer_world_spawn = true
初期値: true

fallback_x = 0
fallback_y = 80
fallback_z = 0
fallback_yaw = 0.0
fallback_pitch = 0.0
上記が初期値です。

[dimensions.respawn]

mode = "INHERIT"
初期値: INHERIT
値: INHERIT, OVERWORLD, VANILLA

[dimensions.environment]

game_mode = "INHERIT"
初期値: INHERIT
値: INHERIT, SURVIVAL, CREATIVE, ADVENTURE, SPECTATOR

fixed_time
初期値: 省略
指定時: 0..23999
省略時は通常の時間進行。

difficulty = "INHERIT"
初期値: INHERIT
値: INHERIT, PEACEFUL, EASY, NORMAL, HARD

SPECTATOR注意:
通常のGate/Return Scroll操作ができない場合があります。強制する場合は別の復旧手段を用意してください。

[dimensions.time_limit]

durationキー無しで無効。
有効化する場合は次から1つだけ:
seconds
minutes
hours
minecraft_days
各1以上。

exit_destination = "PREVIOUS"
初期値: PREVIOUS
値: PREVIOUS, OVERWORLD

[dimensions.runtime]

keep_loaded = false
初期値: false

reset_on_empty = false
初期値: false

reset_delay_seconds = 30
初期値: 30
範囲: 0..2147483647

RESET注意:
Resetはインポート元コピーから次のRuntime物理世代を作り直します。
そのため建築、ブロック変更、Entity、その他Runtime内の変更はResetで失われる場合があります。
インポート元コピー自体はReset/削除しません。
安全側のdeferred cleanupでは旧世代を再起動まで保持するため、一時容量が大きく増える場合があります。

[dimensions.bed]

allow_bed_respawn = false
初期値: false

[dimensions.return_scroll]

enabled = true
初期値: true

xp_level_cost
初期値: 省略 -> common.return_scroll.default_xp_level_costを継承

[dimensions.anchor]

enabled = true
初期値: true

[dimensions.inventory.import]
[dimensions.inventory.export]

mode = "BLACKLIST"
初期値: BLACKLIST
値: BLOCK_ALL, WHITELIST, BLACKLIST

items = []
初期値: []
BLACKLIST + 空配列は全許可。

[dimensions.travel.import]
[dimensions.travel.export]

mode = "ALLOW_ALL"
初期値: ALLOW_ALL
値: ALLOW_ALL, WHITELIST, BLACKLIST

dimensions = []
初期値: []

Travel PolicyのDimension参照はGate行先制限とは別機能です。

旧Dimensionキー:
[dimensions.return_gate]
enabled = true
旧gate_type="RETURN"互換用のみ。新規定義では使いません。

============================================================
3. gates.toml
============================================================

正式な最小構成:

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

dimensionsが空でなくselection_modeを省略した場合、LISTを自動採用します。

id
必須。

display_name
初期値: id

enabled
初期値: true

frame_block
初期値: minecraft:obsidian

corner_block
初期値: frame_block

min_inner_width
初期値: common初期値 2

min_inner_height
初期値: common初期値 3

max_inner_width
初期値: common初期値 32

max_inner_height
初期値: common初期値 32

selection_mode
値: LIST, ALL

動作:
- 明示LIST + dimensionsあり -> LIST
- 明示LIST + dimensionsなし -> Gate拒否
- 明示ALL -> ALL
- mode省略 + dimensionsあり -> LIST
- mode省略 + dimensionsなし -> 旧Config互換ALL
- 明示した不正値 -> ERRORでGate拒否

ALLはREADYなWDLインポートDimension全体です。Overworldは自動で含みません。

dimensions
初期値: []
LISTはWDL ID、またはminecraft:overworld単独を指定できます。
minecraft:overworldとWDL IDを同じLISTに混在させないでください。
その他のnative/第三者DimensionはGate行先として未対応です。

open_time_seconds
初期値: common初期値 10
-1は常時
0または-1未満は不正

reopen_cooldown_seconds
初期値: 0
最小: 0

allowed_igniters
初期値: 省略/[]
通常WDL Dimension Igniterは制限なし。
Creative Dimension Igniterは別の管理/master経路です。

GATE重複注意:
物理Gate判定ではframe block、corner block、size range、利用可能Igniterが重なっていると、複数定義が曖昧になり安全側で無効化される場合があります。行先IDが違うだけでは区別できません。
複数Gateは枠/角、重ならないサイズ範囲、Igniter制限などで区別してください。

============================================================
4. Gate Cost
============================================================

[[gates.costs]]無し = 無料。
複数ブロックは累積し、すべて支払い可能である必要があります。

type = "ITEM"
初期値: ITEM
値: ITEM, XP_LEVEL, XP_POINTS, HEALTH, HUNGER

item = "minecraft:air"
ITEMのparser fallback。実用ITEM costでは実際のitem IDを指定してください。

amount_mode = "FIXED"
初期値: FIXED
値: FIXED, RANGE
FIXED/RANGEはITEMだけでなく対応Cost typeに適用されます。

amount = 0
初期値: 0

min = amount
max = amount
RANGEの初期値。

min > maxのRANGEは現在のparserではそのCostを無視します。
ITEM RANGEは安全な予約/支払いのため、起動前にmax分の在庫を必要とします。

============================================================
5. デフォルトOverworld Gate
============================================================

WDLは最小インポートGateとは別に、次の有効なOverworld Gateを初期生成します。
- 石レンガ枠
- エメラルドブロック角
- LIST -> minecraft:overworld
- 常時開放
- エメラルド1個

============================================================
6. 既存Config移行
============================================================

重要:
旧WDLではselection_mode省略時、dimensions=[...]があってもALL扱いでした。
WDL 1.3.0では最小構成を直感的にするため、mode省略 + dimensionsありをLISTとして扱います。

既存Gateで意図的にALLを使っていた場合:
selection_mode = "ALL"
を追加してください。

modeもdimensionsも省略した旧形は互換ALLを維持します。

既存Configは自動書換えされません。最新コメントが必要な場合:
1) config/worlddimensionloader/をバックアップ
2) 旧Configを退避
3) 一度起動
4) 意図した上書き値だけ移す

============================================================
7. /wdl scanと再起動
============================================================

/wdl scanは再読込可能なConfig/catalog状態を更新します。
STARTUP ONLY設定は実行中プロセスの方式を切り替えないため完全な再起動が必要です。
cleanup/retired-generation方式、Advanced Dimension Igniter耐久値などが該当します。

============================================================
8. 互換性
============================================================

Valkyrien Skiesの安全挙動はVS 2.4.11を中心に検証し、検知時はdeferred cleanupを強制します。
Distant HorizonsはDH 3.2.0-bを中心に互換対応・検証しています。

将来の未知バージョンまで保証するものではありません。

============================================================
9. 設定例 / 遊び方
============================================================
各オプションを組み合わせた実用例は WDL_EXAMPLES_AND_PLAY_IDEAS_JA_1.3.0.txt を参照してください。

最小Gateから、LIST/ALL抽選、rarity/weight、Timed Session、Runtime Reset、Inventory/Travel Policy、複数GateとCostまで10個のコピペ可能な例を掲載しています。
