Skip to content

Configuration

Masuary edited this page Nov 11, 2026 · 2 revisions

Configuration

All settings are in config/imm_ptl_core-common.toml on the server (and in the client's config/ for singleplayer). Edit the file while the server is stopped, or restart it afterwards.

Vault Hunters settings (this fork)

vaultPreview

Default: untilBroken. When a lit frame's vault is removed if nobody has entered it.

Value Meaning
untilBroken The unentered vault stays until its frame is broken.
untilRestart Also removed when the server restarts.
timeout Also removed after vaultPreviewTimeoutMinutes.
off Vault Hunters' own behaviour: no vault until someone touches the frame, so the frame shows nothing before.

A removed vault's frame stays lit and makes a fresh vault on the next touch.

vaultPreviewTimeoutMinutes

Default: 5 (1 to 10080). Minutes an unentered vault stays with vaultPreview = "timeout".

vaultWindowToggleItem

Default: minecraft:glowstone_dust. The item that switches one frame's window off and on when a player sneaks and uses it on the lit frame (see Turning windows off).

  • An item id ("minecraft:stick") or an item tag ("#forge:dusts/glowstone").
  • Empty ("") turns the switch off.
  • A value that names no item is reset to the default, with a warning in the log; a tag without items is reported in the log when tags load.

portalDisabledDimensions

Default: empty. Dimensions ("namespace:path") or whole namespaces ("namespace") where portals are turned off: a portal in or into one is not shown, loads no chunks and teleports nothing. "the_vault" turns off every vault window on the server:

portalDisabledDimensions = ["the_vault"]

restoreMissingVanillaDimensions

Default: false. Set to true to let Immersive Portals recreate a missing Nether or End, as upstream does. Off in this fork, because servers that removed the Nether or the End keep it that way.

checkForUpdates

Default: true. Once per start, look for a newer release (the mod reads a small file on GitHub). A newer release is written to the log; on a dedicated server, operators get a one-line chat notice when they join, and players get one when they enter a world, once per game launch. Hover over the line for what changed; click Download for the CurseForge page. Vault Hunters packs turn off Forge's own update check (versionCheck in config/fml.toml), so this fork has its own. Set to false to turn it off.

enableWarning

Default: false. The "maybe incompatible mod" notices in chat and the log (off: the packs are tested).

Nether and End portals

These only change portals from obsidian frames and End portal frames; vault windows are not affected.

netherPortalMode

Default: normal.

Value Meaning
normal Nether portals become see-through: you see the Nether through the frame and walk through without a loading screen. Frames do not have to be the vanilla rectangle. The other side gets a frame of the same shape.
vanilla Nether portals work as in vanilla: purple portal, loading screen, normal linking.
adaptive Like normal, but the portal on the other side may also be a rotated or resized version of the frame, so it can link to an existing frame there instead of building a new one.
disabled Nether portals cannot be lit at all, not even vanilla ones.

endPortalMode

Default: normal.

Value Meaning
normal The End portal becomes see-through and leads above the main island.
toObsidianPlatform See-through, leading to the obsidian platform where vanilla puts you.
scaledView The frame shows a small scaled-down view of the End.
vanilla The End portal works as in vanilla.

Everything else

The other options (rendering, chunk loading, performance) are Immersive Portals' own and work as upstream describes them: see the Immersive Portals config documentation.

Clone this wiki locally