World Dimension Loader (WDL) 1.0.0

Initial Release

This is the first public release of World Dimension Loader (WDL) for Minecraft 1.20.1 Forge.

Added

• External Minecraft worlds can be registered as WDL dimensions.

• External worlds are stored under WDL_custom_dimensions/.

• Lightweight Dimension Catalog for managing many registered worlds without keeping all of them loaded.

• Lazy Mount system that loads external dimensions only when needed.

• Support for preserving imported world generation data and existing chunks.

• Configurable DIMENSION Gates.

• Configurable RETURN Gates.

• Configurable Gate frame and corner blocks.

• Configurable minimum and maximum Gate sizes.

• Configurable allowed Igniters.

• Timed and permanent Gate sessions.

• LIST destination mode.

• ALL destination mode.

• Weighted random destination selection.

• Dimension rarity system:

  • COMMON

  • UNCOMMON

  • RARE

  • EPIC

  • LEGENDARY

  • CUSTOM

• Explicit per-dimension weight overrides.

• Current-dimension exclusion to prevent same-dimension spawn teleporting.

• Multiple Gate definitions can share the same physical frame when their Igniter or size rules are unambiguous.

• Safe detection and rejection of ambiguous Gate configurations.

• Gate activation costs:

  • Items

  • XP Levels

  • XP Points

  • Health

  • Hunger

• Basic Dimension Igniter.

• Advanced Dimension Igniter.

• Creative Dimension Igniter.

• Dimensional Anchor system.

• Return Scroll system.

• Per-dimension Return Scroll cost overrides.

• Per-dimension Return Scroll sealing.

• Configurable Overworld respawn handling.

• Auto-Unload support.

• Configurable maximum number of simultaneously loaded WDL dimensions.

• Administrative and diagnostic /wdl commands.

• Valkyrien Skies 2.4.11 unload/remount compatibility handling.

• Thin directional portal membrane rendering for both Gate orientations.

Gate Safety / Reliability

• Breaking a required Gate frame block now closes the Gate.

• Breaking a required corner block now closes the Gate.

• Removing or replacing a WDL Portal block clears the complete active Gate session.

• Fixed stale OPEN states that could prevent a Gate from being opened again.

• Igniter activation revalidates stale Gate sessions and repairs invalid states.

• Permanent RETURN Gates use the same structural integrity checks as timed Gates.

• Gate costs are validated before being committed to reduce partial-payment failures.

• Ambiguous Gate definitions fail closed instead of depending on config order.

Dimension Management

• Registered dimension count is separated from live ServerLevel count.

• Large collections of external worlds can remain registered while only a limited number are mounted.

• Added Auto-Unload delay configuration.

• Added loaded-dimension limit configuration.

• Added same-ID remount safety handling for Valkyrien Skies environments.

Documentation

The distributed WDL JAR includes complete setup and configuration guides in both languages:

• WDL_README_EN.txt

• WDL_README_JA.txt

The included guides cover:

• Beginner setup

• Singleplayer installation

• Dedicated server installation

• External world registration

• common.toml

• dimensions.toml

• gates.toml

• Gate construction

• Igniters and recipes

• Random destination pools

• Rarity and weight

• Gate costs

• Shared Gate frames

• Dimensional Anchors

• Return Scroll

• Respawn settings

• Auto-Unload

• Commands

• Troubleshooting

Storage

• IMPORT is the stable storage mode for WDL 1.0.0.

• AUTO currently uses the validated IMPORT behavior.

• DIRECT remains future / experimental work and is not a stable 1.0.0 feature.

Compatibility

• Minecraft 1.20.1

• Forge 47.4.22

• Java 17

Developer Note

WDL is a personal hobby project created by a non-professional developer with significant AI assistance during programming, debugging, review, documentation, and development planning.

The mod has gone through repeated builds, runtime testing, regression testing, and manual in-game verification.

Please back up important worlds before importing or testing external worlds.