Config Options
In Fabric version, you can access the config GUI via the mod menu (you need to manually install mod menu).
You can also access the config GUI by using command /imm_ptl_client_debug config in game if you don't install mod menu.
The config file is /config/immersive_portals_fabric.json .
When you are nearby a portal, the FPS may drop due to these reasons:
- Portal rendering. If the portal is invisible in the view (for example hidden by a wall) then it won't be rendered. Rendering a portal is roughly equivalent to rendering the whole world inside the portal again.
- Client lighting updates. Some remote light updates happen upon chunk data retrieval and some light updates happen upon portal rendering. The light updates may cause lag spikes.
- More chunk mesh rebuild. This mod tries not to build any remote chunk in the render thread during portal rendering. But rebuilding the chunks that are viewed through portals sometimes still costs performance.
- More frequent GC due to loading more chunks. Approaching a portal loads more chunks and entities which consumes more RAM and may increase GC frequency thus creating more lag spikes.
This mod's latest version can automatically reduce the chunks rendered through portal when client FPS is low.
Specifies the maximum portal-in-portal rendering layer.
When rendering infinite mirror room or world wrapping portals, the FPS may go very low because it renders too many portals in portals.
If you set that value to 1, then it won't render any portal inside a portal.
If it's 0, you can see the portal view area but the world inside the portal won't be rendered.
When FPS drops because of rendering too many portals (for example, a mirror room), it will enter "lag attack proof" mode and only render one layer of portals and only render near portals which helps you recover from the lag.
The maximum amount of portals that can be rendered in one frame.
If a player is close to a portal, then the chunks on the other side will be loaded and ticked. The chunk loading radius of a portal is determined by the player's distance to the portal.
This mod has one-layer indirect loading and two-layer indirect loading. One-layer indirect loading means portals nearby a player can load chunks. Two-layer indirect loading means the portals near the one-layer loading portal's destination can also load chunks.
Defines the maximum loading radius of indirect chunk loading through portals. Turning it down means that fewer chunks will be loaded when a player approaches a portal thus increase server performance.
The loading radius cap of global portals is twice this value.
If it's enabled, the portal rendering algorithm that avoids using the stencil buffer will be used and portal-in-portal cannot be rendered. If you see portals through walls with (Iris) shaders enabled then you should enable this option.
If disabled, you cannot see yourself in portals. But other players will still be rendered.
If enabled, the glass texture on mirrors will not be rendered.
If disabled, the entities that are touching a portal will look clipped. However, sometimes cross portal entity rendering may cause rendering issues.
If enabled, when you are crouching, flint and steel lights vanilla nether portal.
If disabled, the alternate dimensions won't be loaded, and all portals pointing to alternate dimensions will vanish.
If enabled, the newly generated nether portals will have vanilla nether portal texture overlay (with opacity 0.5).
Won't affect existing nether portals.
Horizontal nether portals won't have this overlay because the vanilla nether portal block does not have the horizontal variant. (May be changed in the future)
If the entity's scale is too small or too big after crossing the portal, its scale will be reset. (The scale is from Pehkui) Having too big scale will lag the server's collision calculation. Having too small scale will make the entity nearly invisible. The scale limit only applies when one entity go through a portal.
If this config value is x, the actual scale limit is 1/2x to x .
The range that the existing portal frame is being searched in when lighting a nether portal (or datapack custom portal).
If enabled, the creative mode players that does not have level 2 permission cannot use any /portal command.
If enabled, all players can use command sticks. If disabled, only the creative mode player and the ones with level 2 permission can use.