Datapack Portals
Java mod listed for Minecraft 1.16–1.21. File opened and checked on 4 Oct 2026; downloads from the MC Java Mods app on Android.
⬇ Download on CurseForgeDatapack Portals
Create custom portals using CustomPortalApi with datapacks.
Inside your datapack create a "portals" folder, this is where you'll put all your custom portals. There is no set limit of allowed portals, as long as there aren't any duplicate frame blocks. See an example datapack here
Here is an example file: stoneendportal.json
{
"block": "minecraft:stone",
"dim": "minecraft:the_end",
"r": 66,
"g": 135,
"b": 245
}
- block: the block used for the frame.
- dim: the dim id to travel to
- r, g, b: the color to tint the portal
There are also some optional arguments
- ignitionType: the type of ignition to use. Options are "BLOCK", "FLUID", "ITEM".
- ignitionSource: the id for block/item/fluid for ignition of the portal, the only supported block being fire : "minecraft:fire". All items and fluids are supported.
- returnDim: the dimmension to return to, allows for specifying a location other than the overworld to return to
That is all! Portals will function exactly like vanilla nether portals do
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 1.21.1, 1.20.1
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on CurseForge — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
Datapack Portals is a free Minecraft Java mod. Compatible with Minecraft 1.21, 1.21.1, 1.20.1, 1.20 and newer. Downloaded 988,626 times (via CurseForge). Download it and open it directly in the game.