World Dimension Loader (WDL) - 1.1.3

Minecraft: 1.20.1
Forge: 47.4.22
Java: 17
Mod ID: worlddimensionloader

============================================================
START HERE
============================================================

WDL imports existing Minecraft worlds as configurable dimensions.
Registered worlds remain lightweight in the catalog and are mounted only when needed,
unless a dimension is explicitly configured with keep_loaded=true.

For a complete beginner-friendly guide inside this JAR:

Japanese:
docs/WDL_README_JA.txt

English:
docs/WDL_README_EN.txt

Copy-ready configuration examples:
config_samples/

After changing WDL config, run:

/wdl scan
/wdl list


============================================================
EXISTING USERS
============================================================

Existing WDL config files remain compatible with 1.1.3.
Deleting config/worlddimensionloader/ is NOT required.

If you want the newest generated settings and explanatory comments:

1. Back up config/worlddimensionloader/
2. Move the old config folder aside
3. Start WDL 1.1.3 once to generate the newest config
4. Stop the game/server
5. Copy your own Dimension/Gate definitions into the new files
6. Keep the new settings/comments
7. Run /wdl scan and /wdl list

Do not overwrite the newly generated files wholesale with the old files,
or the new options/comments will disappear.


============================================================
KEY FEATURES
============================================================

- External-world catalog and validation.
- Lazy IMPORT mount/unmount.
- Source WorldGenSettings / LevelStem preservation, including superflat worlds.
- Configurable DIMENSION and RETURN Gates.
- LIST / ALL random selection with rarity / weight.
- Same-frame multiple Gate definitions with fail-closed ambiguity handling.
- Gate costs: items, XP levels/points, health, hunger.
- Dimensional Anchor.
- Return Scroll.
- Player Return History with loop compression.
- Per-dimension Bed Respawn opt-in.
- Session Resume after logout/restart inside a WDL dimension.
- Per-dimension [dimensions.runtime] keep_loaded.
- Creative Dimension Igniter master/admin mode.
- Auto-Unload and max-loaded-dimension controls.
- Shutdown hardening.
- Valkyrien Skies 2.4.11 same-ID unload/remount cleanup compatibility.


============================================================
IMPORTANT DEFAULTS
============================================================

You do not need to write [dimensions.runtime] or [dimensions.bed] for normal use.
Both settings default to false when omitted.

Only add this for a dimension that should remain loaded:

[dimensions.runtime]
keep_loaded = true

Only add this when beds in that WDL dimension should be allowed as death-respawn points:

[dimensions.bed]
allow_bed_respawn = true

Beds still work for sleeping when [dimensions.bed] is omitted.


Creative Dimension Igniter:
worlddimensionloader:creative_dimension_igniter

It can activate valid Gates even when omitted from allowed_igniters and bypasses
configured Gate costs. It does not bypass structural/destination safety or
same-frame ambiguity protection.


============================================================
BUILD
============================================================

On Windows with Java 17:

1. Double-click BUILD_WINDOWS.bat
2. Confirm BUILD SUCCESSFUL
3. Use dist/WDL-1.1.3.jar

The final JAR should contain:
- README.txt
- docs/WDL_README_JA.txt
- docs/WDL_README_EN.txt
- changelog.txt
- LICENSE.txt
- CREDITS.txt
- config_samples/
