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 🙏

Immersive Portals by qouteall

 Easily one of the best mods ever created

❤️          ❤️          ❤️          ❤️          ❤️          ❤️          ❤️

❤️Thank you for open sourcing this incredible project❤️

❤️          ❤️          ❤️          ❤️          ❤️          ❤️          ❤️

❓ FAQ ❓

How is this different from Immersive Portals?
This mod follows the same core architecture (stencil buffer rendering, secondary world context-switching, per-dimension chunk loading) but is built for MC's 26.x new rendering system.

Does it affect performance?
Yes, you're loading two worlds at once.

Can I include this in my modpack?
Yes.

Where do I report bugs?
Open an issue on the GitHub repository. Please include your loader, MC version, and a latest.log