Immersive Portals Paperized

A highly-optimized, server-side portal rendering and teleportation engine for PaperMC. Inspired by the Immersive Portals mod. I made a port for modern versions based of the code from NetherView and BetterPortals.

Plugin

A Minecraft plugin that allows nether portals to be seen through, it displays whats on the other side in real-time, and supports custom portal creation. Everything without any client modifications.

⚠️ REQUIRES PACKETEVENTS!

⚠️ Currently in Alpha, don't expect a stable plugin!

⚠️ Spigot support is not guaranteed as it uses extensive PaperAPI features!

Please open a Issue on github if you encounter any Bugs!

GithubIssues (for Bug-Reports, other Issues and Feedback)

Current Features:

• See-through nether portals
• Real-time portal rendering
• Custom portal creation
• Cross-server portal support
• Portal effects and presets
• Economy integration (Vault)
• Selection wand
• Folia compatible
• GUI admin menu
• TPS-aware rendering
• Portal admin GUI
• Anti-dupe protection
• Multi-world support
• Dimension blending
• Light block system (1.18+)
• Entity tracking and replication (mobs, items, and other entities are visible through portals)
• Internationalization (25+ languages)

Future Features:

• Entity/Player Pass through (walking through a portal's surface to teleport, without needing a vanilla portal block)
• Making the Plugin more stable
• Performance optimizations
• Automatic update checks via Modrinth

How to use To build a custom portal: grab the wand (/bp wand), select your origin corners and run /bp setOrigin, select your destination corners and run /bp setDestination, then /bp linkPortals (or /bp linkExternalPortals for a cross-server portal).

Commands:

All commands are under /immersiveportalspaperized, which can also be shortened to /p or /bp.

• /bp reload Reloads the plugin and the config file
• /bp reconnect Reconnects to the proxy if the connection dropped
• /bp wand Gives you the portal selection wand
• /bp setOrigin Sets your current wand selection as the origin position
• /bp setDestination Sets your current wand selection as the destination position
• /bp linkPortals Links your origin and destination selections together
• /bp linkExternalPortals Links your origin selection with a destination selection on another server
• /bp createfromcoords Creates a portal directly from coordinates, without needing a player or wand
• /bp remove Removes the nearest portal within 20 blocks
• /bp removebyname Removes all portals with the given name
• /bp setPortalName Sets the name of the nearest custom portal within 20 blocks
• /bp getportalname Tells you the name of the nearest portal within 20 blocks
• /bp setprice Sets the price of the nearest custom portal
• /bp setpreset Sets the effect preset of the nearest custom portal
• /bp getallowNonPlayerTeleportation Tells you whether the nearest portal allows non-player (item/mob) teleportation
• /bp setAllowNonPlayerTeleportation Sets whether the nearest portal allows non-player (item/mob) teleportation
• /bp setseethroughportal Sets whether you personally can see through portals
• /bp toggleseethroughportal Toggles whether you personally can see through portals
• /bp menu Opens the Portal Admin GUI

Alias:

• /p and /bp Can be used instead of /immersiveportalspaperized

Permissions:

• immersiveportalspaperized.createfromcoords Allows creating portals from coordinates
• immersiveportalspaperized.getname Allows getting portal names
• immersiveportalspaperized.link Allows linking portals
• immersiveportalspaperized.linkexternal Allows creating cross-server portals
• immersiveportalspaperized.remove Allows removing portals
• immersiveportalspaperized.remove.others Allows removing portals you don't own
• immersiveportalspaperized.reload Allows reloading the plugin configuration
• immersiveportalspaperized.reconnect Allows reconnecting to the proxy
• immersiveportalspaperized.select Allows using the selection wand and the admin menu
• immersiveportalspaperized.setname Allows renaming portals and setting their price/preset
• immersiveportalspaperized.setname.others Allows renaming portals you don't own
• immersiveportalspaperized.getallowNonPlayerTeleportation Allows checking if items/mobs can teleport through a portal
• immersiveportalspaperized.setAllowNonPlayerTeleportation Allows toggling item/mob teleportation for a portal
• immersiveportalspaperized.wand Allows using the portal selection wand
• immersiveportalspaperized.user Allows using portals (default: true)
• immersiveportalspaperized.see Allows seeing through portals (default: true)

By default, everyone can walk through and see through portals (.user/.see). Everything related to creating, editing or removing portals defaults to OP.

Dependencies:

• PacketEvents (required, used for packet-based portal rendering)
• Vault (optional, for economy features)
• Multiverse-Core (optional, for world management)
• My_Worlds (optional, for world management)

Configuration: The plugin configuration file will be generated on first startup at plugins/ImmersivePortalsPaperized/config.yml.

The plugin supports hot-reloading via /bp reload.

For detailed configuration options, including world connections, portal effect presets, proxy settings, and performance tuning, refer to the comments in the generated config.yml.

Have fun :)