How do I install Immersive Portal?

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. Opens on CurseForge — not every file is mirrored on our own servers.

What Minecraft version does Immersive Portal work with?

The listing gives Minecraft 1.21.11. This is the version stated by the author or source site, not something we verified ourselves.

Home›Java›Mods›Immersive Portal

ModsJava

Immersive Portal

Java mod listed for Minecraft 1.21. File opened and checked on 28 Sep 2026; downloads from the MC Java Mods app on Android.

by Hooneybadgers · on CurseForge

⬇ Download on CurseForge

The author built this one for Minecraft 1.21.11 on Fabric. On other versions it may install and then do nothing.

Open in MC Java Mods Get it on Google Play →

MAJOR UPDATE 7/18/2026 (IMMERSIVErework)

Until now, my portals were still vanilla's purple portal blocks, with the view rendered over them and my own teleport hack behind them. That meant portals could only exist where a vanilla obsidian frame could stand, with none of Immersive Portals' actual machinery underneath.

Today, the system is a faithful, complete hand port of the Immersive Portals engine. Portals are now entities, exactly as in IP: any size, any position, any orientation, any destination, same dimension or a differnt one, with a genuine live view of the other side rendered every frame, and true seamless crossing that preserves your momentum, look direction, and hand state.

(almost) Everything IP does, this does:

The full /portal command suite: make_portal of any width/height to any dimension and coordinates, the whole command-block family (cb_make_portal, destination setters, completing portals into two-way and two-faced clusters), round portals, scaled portals (giant/miniature world effects), rotating and animated portals, global portals like world-wrapping borders, goback, and the debug tooling.
Real portal generation: Flint-and-steel an obsidian frame and get a seamless two-way, two-faced portal cluster instead of purple blocks, with an async destination search, automatic frame construction on the far side, a floating progress indicator, existing-frame linking, correct 8:1 nether coordinate mapping, and frame-break that properly kills the portal. Crouch-ignite still gives you a classic vanilla portal when you want one.
Everything crosses: Items, arrows, ender pearls, animals, minecarts and boats with passengers, through one unified teleport pipeline.
Recursion: Portals visible through portals, 5 levels deep, including seeing your own body and other creatures back through a portal loop.
Mirrors: (Flint-and-steel on glass), the portal helper block for linking same-dimension frame pairs, and datapack-defined custom portal generation: your own frame blocks, ignition items, target dimensions, and portal forms (classical, flipping-floor, scaling-square, one-way, and more), loaded from a standard datapack.
The portal wand and command sticks: Create custom portals by clicking three corners in the world, drag and reshape existing ones, copy/paste them, all in a dedicated creative tab.
Dimension stacks and alternate dimensions: Stack worlds on top of each other with portals at the seams (configurable from the world-creation screen), plus IP's extra dimensions: skylands, chaos terrain, and more.
Real cross-dimension simulation: The other side of every portal is genuinely chunk-loaded, lit, and ticking on the server.

Deliberate changes:

Ender pearls teleport seamlessly: Original IP hands pearl teleports to the vanilla loading screen path, ours keeps them seamless with momentum preserved.
Animals stay scared across dimensions: A fleeing animal that crosses a portal keeps panicking on the other side, original IP loses that state at the crossing.
Firework edge cases at crossings.

(7/19/2026) Sodium(0.9.1) Compatibility (IMMERSIVErework3)

Updates IP to Sodium 0.9.1's modern async architecture:

(7/20/2026) IRIS(1.11.2) Compatibility (IMMERSIVErework4)

Iris works but shaders do not.

(7/21/2026) FULL IRIS(1.11.2) Compatibility (IMMERSIVErework6)

SHADER PORTAL VIEWS: Portals now render live views with shaderpack but dimension lighting may be inaccurate and recursive portals don't show. (IMMERSIVErework 7 fixed terrain flashing when using same dimesnion portals)

CREDITS 🙏