ImmersivePortals

Immersive Portals — Server-Side Dimension Preview

See another dimension through vanilla portals without requiring client mods or resource packs.

Immersive Portals is an experimental server-side reinterpretation of the famous seamless portal concept.

Using packet-based rendering, the plugin creates a visual preview of the destination behind vanilla portals. Players can look through a portal and see an approximation of the other dimension before crossing it.

Everything is handled by the server. Players only need a normal Minecraft client.

⚠️ This is an experimental visual system. It is not a complete replacement for the original Immersive Portals mod.

Main Features

• Server-side portal previews.
• No client mods required.
• No resource packs required.
• Plug and play installation.
• Nether and Overworld portal previews.
• Experimental End portal preview.
• Nearby entities can be displayed through portals.
• Portal scenes update according to the player’s position.
• Improved first activation animation.
• Optimized packet handling.
• Paper, Spigot, Purpur and Folia support.
• Optional vertically connected dimensions.

How Portal Rendering Works

When a player approaches a portal, the plugin:

• Hides the vanilla purple portal surface for that player.
• Captures blocks near the destination.
• Creates a controlled client-side scene behind the portal.
• Sends temporary block changes using packets.
• Adjusts the perspective according to the viewer’s position.
• Attempts to display nearby entities inside the projected scene.

The projected blocks do not physically exist in the world. They are visual changes sent only to the player viewing the portal.

This allows the destination to feel visible without loading a real second-world renderer inside the portal.

Connected Dimensions

Version 1.1 introduces optional vertical transitions that connect the three vanilla dimensions.

End → Overworld

Falling deep into the End void can transport the player into the Overworld sky.

The player will appear at a high altitude and continue falling toward the world below.

Overworld → Nether

Small openings can be generated in the deepest bedrock caves of the Overworld.

Falling through one of these openings transports the player into the Nether.

Nether → Overworld

Openings can also be generated in the Nether ceiling.

Reaching and crossing them transports the player into a deep Overworld cave.

These transitions are optional and disabled by default.

dimension-stacking:
  enabled: false / true

  holes:
    enabled: false / true

⚠️ Bedrock Warning

Enabling bedrock holes allows the plugin to remove real bedrock blocks from your worlds.

holes:
  enabled: true

The removed bedrock will not be restored automatically after disabling the feature.

Create a world backup before enabling this option.

End Portal Experience

The End portal now includes an experimental visual preview.

Because a server plugin cannot render the true End sky, void, fog and complete environment inside another dimension, this preview is an artistic approximation rather than an exact view of the destination.

After entering the End, players no longer appear standing on a temporary floating block. Instead, they fall from the sky toward the island while the plugin safely controls the transition and prevents fall damage in Survival mode.

Performance Improvements

The rendering system has been optimized to reduce unnecessary packet traffic and improve stability.

The projected area behind portals is intentionally limited. A smaller controlled scene provides:

• Better client performance.
• Safer packet handling.
• More stable entity rendering.
• Reduced visual flickering.
• Better Folia compatibility.

Entities visible through portals should now remain significantly more stable instead of constantly appearing and disappearing.

Compatibility

• Minecraft 1.21.x
• Minecraft 26.1
• Minecraft 26.2
• Spigot
• Paper
• Purpur
• Folia

No additional dependencies are required.

Place the plugin .jar inside your server’s plugins folder and restart the server.

Important Limitations

Minecraft does not normally allow a server-side plugin to render another dimension’s complete environment inside a portal.

The plugin cannot perfectly reproduce:

• Another dimension’s sky.
• Dimension-specific fog.
• Clouds and particles.
• Complete lighting.
• True seamless world rendering.
• Every entity and block update in real time.

Because of these limitations, the plugin creates a controlled projected scene behind the portal.

Minor clipping, lighting differences, perspective errors or visual inconsistencies may still occur.

Performance can also depend on:

• Portal size.
• Number of visible blocks.
• Number of nearby entities.
• Number of players viewing portals.
• Client hardware.
• Server hardware.

Testing the plugin before using it on an important production server is strongly recommended.

Final Developer Note

Immersive Portals started as a large technical experiment.

The plugin was built without external libraries or client-side modifications, using only server-side logic and packet-based visual techniques.

Unfortunately, vanilla Minecraft places strict limits on how accurately another dimension can be displayed through a portal. The current system is close to the practical limit of what can be achieved with a traditional server plugin.

Even with those limitations, I hope this project provides a unique and immersive experience for your server.

Please report any bugs, performance problems or visual issues through GitHub or the Spigot discussion page.

Credits

Special thanks to LinsaFTW for suggesting that I experiment with packets and client-side block rendering.

This project is an independent experiment and is not affiliated with the original Immersive Portals mod or its developers.