Immersive Portals for Vault Hunters

Immersive Portals for Vault Hunters

An unofficial fork of Immersive Portals (Forge 1.18.2, based on 1.4.20) made to run with Vault Hunters 3: Remastered 3.0.1, 3rd Edition 3.21.7 and Wold’s Vaults 0.34.2. Vault portals become windows: light a portal frame in the hub and you see the vault’s start room through it at once, walk straight in, and see the hub again through the start-room portal on the way out. Every crossing still goes through Vault Hunters’ own rules.

Immersive Portals is made by qouteall and kept alive on Forge by Nick1st. This fork is not made or supported by them. Please report problems with it on this fork’s issue tracker or on our Discord, not to the original authors.

See-through vault portals

• Lighting a Vault Hunters portal frame in the hub creates the vault right away, so the frame shows its start room before anyone enters. The start-room portal shows the hub back. The vault timer only starts once a runner leaves the start room, as before.
• Walking through runs Vault Hunters’ own join: party, crystal and every other check. Immersive Portals only does the teleport. Walking out runs Vault Hunters’ own exit and bail rules.
• A refused crossing leaves you standing where you were.
• Works for every framed crystal type (classic, Personal, Paradox, PvP, Royale), including rotated start rooms, and for players who enter alone. Both windows cover their whole opening and show the other side one to one: a hub frame of any size shows the start room and the walls around its portal, and from inside the whole start-room portal shows the hub frame, with people in front of it where they stand. Blocks seen through a window are solid, so you walk through where the other side is open.
• The player who lights the frame owns the vault. A vault nobody enters is removed when its frame is broken (or after a restart or a timeout, if configured); the frame stays lit and makes a fresh vault on the next touch.
• Floor (horizontal) frames (Remastered, or Better Vault Portals in Wold’s Vaults), Greed challenge crystals and Wold’s Vaults’ Corrupted and Hyper crystals keep the normal Vault Hunters portal (the last two get their windows once someone enters). Completing, dying, being kicked or running out of time also use Vault Hunters’ own teleport.
• Want Vault Hunters’ own portal texture on a frame, for a build? Sneak and use glowstone dust on the lit frame to switch its window off for everyone (“Vault window off”), and again to switch it back on. Only players who could break the frame may switch it, the dust is not used up, and the frame stays that way until a frame block is broken.

Vault rules stay intact

• No other Immersive Portals portal can carry anything into or out of a vault: players, items, projectiles, pearls or mobs.
• No breaking, placing or using blocks in a vault through a portal. Reach through portals is capped at 7 blocks.
• Anyone who ends up inside a vault without being one of its runners (and is not a spectator or operator) is sent out after 2 seconds.

Fixes for the Vault Hunters packs

• No crash at startup next to Vault Hunters.
• Multiplayer joins work with Connectivity installed.
• Vaults tick in parallel on Vault Hunters’ own threads, as without Immersive Portals, with no deadlock between vault ticking and portals.
• Vault rooms show up for players watching from another dimension.
• Servers stop cleanly, also with players in vaults.
• Closed vaults leave nothing behind on the server or the client.
• Vault Hunters’ end-of-vault screen shows all its tabs (stats, vault map, loot, combat).
• Steam ‘n’ Rails conductor cameras and Taterzens NPCs work.
• The Nether and the End are not recreated on servers that removed them.
• New Nether portal frames on the other side are placed like vanilla places them, not inside solid rock.
• Vault Hunters’ “Missing Backpack” notice clears after walking into a vault.

The full list is in the changelog of each file.

Installation

• Minecraft 1.18.2, Forge 40.2 or newer. Works with Vault Hunters 3 Remastered 3.0.1, Vault Hunters 3rd Edition 3.21.7 and Wold’s Vaults 0.34.2, on servers and in singleplayer.
• Works with Oculus shader packs (Wold’s Vaults ships with one switched on).
• Install it on the server and on every client. Players with stock Immersive Portals, or without this mod, cannot join a server that runs it.
• This mod replaces Immersive Portals (same mod ids). Remove any other Immersive Portals jar first.

Configuration

In config/imm_ptl_core-common.toml:

• portalDisabledDimensions: dimension ids or whole namespaces where portals are not shown, loaded or crossed. Add the_vault to turn the vault windows off for the whole server.
• vaultWindowToggleItem (default minecraft:glowstone_dust): the item that switches one frame’s window off and on, as an item id or an item tag (#forge:dusts/glowstone); empty turns the switch off.
• restoreMissingVanillaDimensions (default false): set to true to let Immersive Portals recreate a missing Nether or End, as upstream does.
• vaultPreview (default untilBroken): when a lit frame’s unentered vault is removed: untilBroken, untilRestart, timeout (after vaultPreviewTimeoutMinutes, default 5), or off for Vault Hunters’ own behaviour (the vault is made on the first touch).
• enableWarning (default false): the “maybe incompatible mod” notices.

Known limits

• Immersive Portals portals cannot span servers behind a proxy (Velocity, BungeeCord). They work inside one server.
• Create contraptions through portals are untested.

License

Apache License 2.0, like Immersive Portals. Source: github.com/Masuary/ImmersivePortalsModForForge (branch 1.18-vh3r). Every change from upstream is listed in CHANGELOG.md.

Like Immersive Portals? Support qouteall on Patreon.