World Portal

World Portal can create custom world portal to travel between dimensions. With this, you can make your own custom portal for your custom dimension via config or datapack and it is server-side.

This mod are made for personal gameplay tinkering, server customization, and modpack creation.

Important

[0.0.8] Portal frame corner left and right will be swapped.
[0.0.10] Client side issue fix and data migration.
[0.0.11] Config file migrated from "worldportal.json" to "worldportal-common.toml".

This mod can only create a custom portal. To make a new dimension, you need datapack or another mod to do it.

Features

No client needed custom portal.
Transform nether portal to custom portal by changing its frame corners.
Horizontal portal (>=0.0.8).
Simple configuration and datapack support.

Can be added to existing world or modpack and can be removed from existing world easily. Please make sure to backup your world first.

Planned

End portal mode.
Customized portal frame.
Customized portal spawned mobs not just piglin or disable it.
Customized portal minimum spawn height.
Customized portal particles.
Command or function execution when entering and exiting portal.
Destination based on biome, dimension, height, moon phase, time, and weather.
Destination based on player level, saturation, or even economy and mana.
Destination based on executed command or function.
Destination restricted by dimension and player permissions.
Destination override gamerule.
Support for economy, permission, and quest mods.
And many more including compat or integration mods in the way.

Suggest new features for World Portal on GitHub Discussion or Discord would be appreciated.

Usage

You can configure this mod by config or data driven by using datapack.

Config

Portal id "minecraft:example" can be anything as long as it is unique.

worldportal-common.toml

[portals]

	[portals."minecraft:example"]
		frame_top_right = "minecraft:gold_block"
		frame_top_left = "minecraft:iron_block"
		frame_bottom_right = "minecraft:iron_block"
		frame_bottom_left = "minecraft:gold_block"
		mode = "worldportal:default"
		destination = "customdimension:dimension"

	[portals."minecraft:example_horizontal"]
		frame_top_right = "minecraft:gold_block"
		frame_top_left = "minecraft:iron_block"
		frame_bottom_right = "minecraft:iron_block"
		frame_bottom_left = "minecraft:gold_block"
		mode = "worldportal:horizontal"
		destination = "customdimension:dimension_flat"

worldportal.json (OLD)

{
    "portals": {
        "minecraft:example": {
            "frame_top_right": "minecraft:gold_block",
            "frame_top_left": "minecraft:iron_block",
            "frame_bottom_right": "minecraft:iron_block",
            "frame_bottom_left": "minecraft:gold_block",
            "mode": "worldportal:default",
            "destination": "customdimension:dimension"
        },
        "minecraft:example_horizontal": {
            "frame_top_right": "minecraft:gold_block",
            "frame_top_left": "minecraft:iron_block",
            "frame_bottom_right": "minecraft:iron_block",
            "frame_bottom_left": "minecraft:gold_block",
            "mode": "worldportal:horizontal",
            "destination": "customdimension:dimension_flat"
        }
    }
}

Datapack

In your datapack namespace folder, create "worldportal" folder with "portal" folder inside. In portal folder create json file with any name with content:

{
    "frame_top_right": "minecraft:gold_block",
    "frame_top_left": "minecraft:iron_block",
    "frame_bottom_right": "minecraft:iron_block",
    "frame_bottom_left": "minecraft:gold_block",
    "mode": "worldportal:default",
    "destination": "testdimension:dimension"
}

-> data\{namespace}\worldportal\portal\{name}.json

Portal id consist of {namespace}:{name}. Portal mode can be "worldportal:default" for normal portal or "worldportal:horizontal" for horizontal portal.

Compatibility

Passengers Portal Fix
Create Addons: Create: Portal Integration

Issues

[Radium] Use Canary instead for better mod compatibility or manually disable "mixin.ai.poi.fast_portals" on its config.

Check other issues or report new issues on GitHub Issues is recommended.

Support

🟩 26.1-26.4 / 🟩 1.21.1 / 🟥 1.21-1.21.11 / 🟩 1.20.1 / 🟪 1.16.5 / 🟪 1.12.2

🟩 Supported
🟥 Support Dropped
🟨 In Progress
🟪 Considered

Permissions

Feel free to use in servers, modpacks, videos, live streams, or any similar media without need for attribution or ask permission. The mod file itself, its assets, and code cannot be sold, re-licensed, or put behind a paywall.