World Portal

Mod

by mahmudindes

Create custom world portal to travel between dimensions.

Type

Mod

CurseForge Downloads

40,723

CurseForge ID

1205026

Modrinth Downloads

59,101

Modrinth ID

A2PZGios

Last Updated

Oct 17, 2026

Description

World Portal

World Portal can create custom world portal to travel between dimensions. You can make your own portal for your custom dimension easily.

Important

[0.0.8] Portal frame corner left and right will be swapped.
[0.0.10] Client side issue fix and data migration. Load world with this version first before updating.

Features

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

Can be added to existing modpack or world and can be removed from existing world easly. Please make sure 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.
Add or change 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 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 (worldportal.json)

The id "minecraft:example" can be anything as long as it's unique.

{
    "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": "test:test"
}

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

For now you can only customize portal frame corner and destination dimension if matches. More mechanics will be added on the next update, for now it's enough for my use case.

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".

There are no new compatibility issues or bugs being reported. Please report it on GitHub so it can be fixed.

Support

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

🟩 Supported
🟥 Support Dropped
🟨 In Progress
🟪 Considered

Important Note

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

Made for personal gameplay tinkering, server customization, and modpack creation. Feel free to use in modpacks, videos, stream, or similar media. Consider help me financially if you like this mod, I will be really grateful.