Initial Dim Choice

Choose your starting dimension before joining the world!

Initial Dim Choice is a data-driven mod for Minecraft 1.20.1 Forge that lets players pick their starting dimension when first joining a world. The mod automatically finds a safe landing spot, sets the respawn point in the chosen dimension, and teleports the player there.

For modpack developers who only want to change the default spawn dimension, a silent mode is also available — no selection screen is shown, and players are sent directly to a preset dimension.

Everything is highly customizable and data-driven, giving developers full freedom to tailor the experience.

✨ Features

• First-Join Selection Screen — Players choose their starting dimension from a clean, intuitive UI when joining a world for the first time.
• Safe Spawn Search — Multiple built-in spawn-finding algorithms (heightmap, Y-range, fixed position, end islands) ensure players never spawn in the void or inside walls.
• Forced Spawn Platform — Optionally generates a 3×3 cobblestone platform and clears the space above, guaranteeing a safe landing in even the harshest dimensions.
• Graceful Fallback — If a configured dimension isn't loaded, the option is silently hidden without crashing or breaking datapack loading.
• Fully Data-Driven — Add or modify dimension choices easily via datapacks.

⚙️ Configuration

All behavior is configured through simple JSON files:

• A global config toggles the selection screen and sets the default dimension choice.
• Dimension choice files define each option — target dimension, translation keys, icon, UI color, display order, and spawn search settings.
• Four spawn search types are supported: fixed, y_range, heightmap, and end_islands, each with optional parameters such as y_anchor and enable_spawn_platform.

See the README on GitHub for full configuration documentation.