🌌 Custom Dimensions: The Multiverse Engine

Custom Dimensions is a high-performance, fully server-side mod that lets administrators create an infinite multiverse of custom worlds — no client mods required. Players connect with vanilla Minecraft and experience seamless portal travel, custom dimensions, and immersive particle effects.

Available for 1.21.x (Yarn), 26.1x, and 26.2.x (Mojmap).

---

Features

🔄 Automatic Two-Way Portal Linking

Step through any custom gateway and the mod instantly creates a return portal at your destination using the same frame material. UUID-based PlayerOrigin tracking sends you back to your exact entry point — never get lost.

🧊 Smart Frame Ignition

Right-click any face of the frame block. The mod scans all 6 adjacent positions and falls back to a 7×7×7 bounding-box search if needed. Supports both configurable default frame blocks (crying obsidian → Overworld, obsidian → Nether, iron block → End) and custom igniter items per portal.

📐 Coordinate Scaling

Portals support configurable scale (via /portal link or config). Create Nether-style 1:8 links, 1:1 overworld connections, or any custom ratio (0.001–1000.0).

🕳️ Void-Safe Placement

Portals work in void dimensions — automatically placed at sea level or 10 blocks above the void floor.

🌈 Immersive Particles

Source zones emit colored portal particles. Target portals also emit matching frame block particles — so both sides glow with your custom RGB color and light level.

🚫 No Duplicate Portals

A 5-block radius check on every teleport reuses existing portals instead of creating new ones.

---

Commands

Command	Arguments	Description
/dimension create <name> <type>	void, overworld, nether, end	Create a new dimension
/dimension delete <name>	—	Delete a dimension
/portal link <id> <frame> <igniter> <target> <color> <light> [scale]	See below	Link a frame+igniter to a destination
/portal delete <id>	—	Remove a portal link

Arguments for /portal link:

Argument	Description	Example
id	Unique portal name	my_portal
frame	Block ID for the frame	minecraft:obsidian
igniter	Item ID to ignite	minecraft:flint_and_steel
target	Target dimension	minecraft:my_dimension
color	RGB hex color	FF0000
light	Light level (0–15)	15
scale (optional)	Coordinate multiplier	8 (default 1.0)

---

Configuration

Auto-generated at config/multiverse_config.json:

{
  "frameOverworld": "minecraft:crying_obsidian",
  "frameNether": "minecraft:obsidian",
  "frameEnd": "minecraft:iron_block"
}

Set which frame blocks create portals to vanilla dimensions without needing a custom igniter.

Portal links are persisted in config/portal_links.json.

---

Examples

PvP Arena (void world, red glow)

/dimension create pvp_arena void
/portal link arena_gate obsidian flint_and_steel minecraft:pvp_arena FF0000 15

Resource World (1:8 scaling, green glow)

/dimension create resource_world overworld
/portal link farm_gate iron_block stick minecraft:resource_world 00FF00 10 8

Custom "Alther" Dimension (amethyst ignition, purple glow)

/dimension create alther void
/portal link alther_gate gold_block amethyst_shard minecraft:alther A020F0 15

---

Why Custom Dimensions?

• 🟢 100% Server-Side — Vanilla clients can join. Zero downloads required.
• 📂 Official Pathing — Worlds saved in world/dimensions/. Full compatibility with backups and tools.
• 🐎 Mount-Ready — Ride horses, camels, striders, and donkeys through portals.
• ⌨️ Full TAB Completion — Autocomplete for all dimension IDs, block IDs, and item IDs.
• 🔄 PlayerOrigin Tracking — UUID-based return, never lose your way.
• 🧊 Smart Detection — Right-click any frame face, even from 3 blocks away.
• 🎨 RGB Particles + Custom Lighting — Every portal can have its own color and brightness.

---

Installation

1. Drop the .jar into your server's mods/ folder.
2. Restart the server.
3. Use /dimension create and /portal link to build your multiverse!

Requires: Fabric Loader 0.16+ (1.21.x) or NeoForge (26.x).

---

Support

Report issues at: Discord | The mod is under development so there might be some issues, but the main functions work 🧊