This wiki describes the latest version of Immersive Portals Mod (ImmPtl).

This wiki on GitHubopen in new window

Common Questions

Can I use it in multiplayer?

Yes. The server and client must both install this mod. (This mod is not a plugin and cannot be used on Bukkit, Spigot or Paper.)

Sodium Compatibility?

In MC 1.19.x, Fabric will tell incompatibiltiy warning when you use an incompatible version.

In MC 1.18.2, the latest version of ImmPtl is roughly compatible with Sodium 0.4.1.

In MC 1.17.1, the latest version of ImmPtl is roughly compatible with Sodium 0.3.4.

In 1.16.5 you can use thisopen in new window.

Mod Compatibility?

Immersive Portals mod is incompatible with some mods. It's recommended to check Known compatibility issuesopen in new window before using this mod. The mods that don't touch inner game mechanics are likely to be compatible with ImmPtl.

Any mod compatibility issue is NOT intentional. The compatibility issues come from how the computer program works. If a mod is programmed upon the fact that only one dimension is loaded at client, that mod will break with ImmPtl.

Fixing compatibility issues requires tons of efforts. Compatibility issues can be fixed by ad-hoc hacking which is both hard and fragile. This mod is compatible with Sodium and Iris via ad-hoc hacking which is fragile (It's possible that next version of Sodium/Iris will not be compatible with ImmPtl). The close-sourced mods such as OptiFine are much harder to do ad-hoc hacking with so I marked OptiFine as incompatible.

Will the portal impact performance?

Loading more chunks and rendering more things will affects performance. I already put a lot of efforts into optimizing this mod's performance and make portal rendering compatible with Sodium (not all Sodium versions are compatible with ImmPtl, see the above).

It's recommended to allocate more memory to Minecraft. Not having enough memory will make the game laggy. Sometimes it will by default only allocate 2GB to Minecraft even if the computer have many memory. How to allocate more RAM to Minecraftopen in new window

Where to report bugs or compatibility issues?

Report Issues (Fabric version)open in new window

Report Issues (Forge version)open in new window

This mod is very complex and the core part of the mod is only mainly developed by only one person at spare time for free. Expect it to be imperfect.

How to integrate with other mod's portals?

You can use datapack to make it convert other mod's portals into see-through portals.

How to make portal helper craft-able in survival?

You can make other blocks to behave like portal helper. Check this

The nether portal is not see-through.

This mod does not change existing vanilla portals. You need to light new portals.

It can only link to an empty obsidian frame with the same shape and orientation (unless you change the nether portal mode to adaptive). It will not link to a vanilla nether portal.