World Portal

World Portal

Create custom world portal to travel between dimensions.

by
19.8K Downloads
fabricforgeneoforgegame-mechanicstransportationutility
Rent Server with this Mod

About this Mod

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

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.


See me on GitHub Available on CurseForge Watch me on YouTube Chat with me on Discord Support me on Patreon Support me on Ko-fi Support me on Saweria

Dimension Fixer Dimension Link Vanilla World More Cat Variants Passengers Portal Fix Create: Portal Integration Superflat Dimension Amplified Dimension Large Biomes Dimension Mushroom Fields Dimension Beta 1.7.3 Dimension Desert Dimension Badlands Biomes Dimension Forest Biomes Dimension The Void Dimension

Available Versions

World Portal 0.0.10+26.1release
MC 26.1, 26.1.1, 26.1.2neoforge
April 27, 2026
World Portal 0.0.10+26.1release
MC 26.1, 26.1.1, 26.1.2fabric
April 27, 2026
World Portal 0.0.10+1.21.11release
MC 1.21.11neoforge
February 26, 2026
World Portal 0.0.10+1.21.11release
MC 1.21.11fabric
February 26, 2026
World Portal 0.0.10+1.21.10release
MC 1.21.10neoforge
February 26, 2026

How to Install World Portal on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (26.1.2).

3

Install Mod

Open the mod browser in the dashboard and search for "World Portal". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabricforgeneoforge

Minecraft Versions

26.1.2, 26.1.1, 26.1 (+13 more)

Server-side

Required

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

World Portal server crashes on startup – what to do?

Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.1.2). You can switch loaders with one click in the panel.

Is World Portal compatible with fabric and forge and neoforge?

World Portal officially supports fabric, forge, neoforge for Minecraft 26.1.2, 26.1.1, 26.1. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with World Portal – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if World Portal consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install World Portal with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
LicenseRef-All-Rights-Reserved
Server-side
Required

Supported Versions

26.1.226.1.126.11.21.111.21.101.21.91.21.81.21.71.21.61.21.5+6 more