
World Portal
Create custom world portal to travel between dimensions.
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
- 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.
Available Versions
How to Install World Portal on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (26.1.2).
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
Minecraft Versions
26.1.2, 26.1.1, 26.1 (+13 more)
Server-side
✓ RequiredRecommended 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.
Similar Mods
Rent Modded Server
Install World Portal with just one click on your server.






