
Custom Portal Builder
Utilizes the Custom Portal Api to allow the user to create portals easily
Screenshots

About this Mod
This mod uses the Custom Portal API to allow the user to configure custom portals to existing dimensions using existing blocks and items.
This is an example of the config to make a portal to the nether, that has stone as the frame, and a diamond as the igniter:
{
"isFlat": false,
"frameBlock": "minecraft:stone",
"isFluidIgniter": false,
"itemIgniter": "minecraft:diamond",
"dimension": "minecraft:the_nether",
"r": 200,
"g": 50,
"b": 50
}
Config Options
isFlat: determines if you want a nether like portal or one like the end portal
frameBlock: you designated block to make the portal from. DO NOT use the same block for multiple portals
isFluidIgniter: determines whether you want to light the portal with an item or with a liquid(lava, water, etc.)
itemIgniter: if isFluidIgniter is false then use this to sellect the item you want to use to ignite the portal
fluidIgniter: if isFluidIgniter is true then use this to sellect the fluid you want to use to ignite the portal
dimension: the id of the dimension you want the portal to lead to.
r, g, and b: These are the RGB values for the color of the portal.
Please note that on forge it the Custom Portal API Reforged by AzureDoomC is a required dependancy
Available Versions
How to Install Custom Portal Builder 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 (1.20.4).
Install Mod
Open the mod browser in the dashboard and search for "Custom Portal Builder". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.20.4, 1.20.2, 1.20.1 (+4 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Custom Portal Builder 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 (1.20.4). You can switch loaders with one click in the panel.
Is Custom Portal Builder compatible with fabric and forge?
Custom Portal Builder officially supports fabric, forge for Minecraft 1.20.4, 1.20.2, 1.20.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 Custom Portal Builder – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Custom Portal Builder 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 Custom Portal Builder with just one click on your server.