DundrPortalGun

Dundr Portal Gun

Dundr Portal Gun turns a runtime clone of Valheim's Dundr into a Portal-style tool with two linked, glow-only endpoints and a live circular view through each portal.

Gameplay

Features

• Left click places the Standard orange/red portal.
• Right click places the Blue portal without entering Valheim's block action.
• Middle click deletes your aimed portal.
• Each player owns an independent pair: your Standard portal links only to your Blue portal.
• Any player can use any completed pair.
• Players preserve speed and portal-relative direction, including floor-to-wall and falling launches.
• Dropped items, eligible creatures, arrows, spears, and Projectile-based magic can cross portals while retaining velocity.
• Live circular portal views have configurable diameter, resolution, render rate, distance, and edge feathering.
• Portals can be placed on any solid target by default, including terrain, structures, trees, creatures, and destructibles.
• Server owners can restrict placement to an allowlist of internal prefab names for puzzle maps.
• Optional fall-damage grace prevents a large portal height change from being treated as a vanilla fall.
• Portals are static world-space anchors and remain where they were placed if the struck target moves or is destroyed.

The mod clones Valheim-owned visual prefabs at runtime. It does not redistribute Valheim assets or modify the vanilla Dundr and buildable portals globally.

Requirements

• Valheim
• BepInExPack for Valheim
• Jotunn

Thunderstore managers install the declared BepInEx and Jotunn dependencies automatically.

Multiplayer

The mod is required on the server and every connecting player. All peers must use the exact same Dundr Portal Gun patch version.

Portal placement, replacement, deletion, snapshots, disconnect cleanup, and puzzle-map placement rules are host-authoritative. Existing portals are sent to late joiners, and a disconnected player's portals are removed after a short grace period.

Each player has a separate pair, but everyone can see and traverse every completed pair. The owning peer handles its player and projectiles; Valheim's network owner handles eligible items and creatures.

Default Recipe

The Portal Gun is crafted at a level 1 Workbench for 1 Wood. The station, station level, and Wood cost are configurable.

Configuration

Launch the game once to create:

BepInEx/config/samuel.valheim.dundrportalgun.cfg

Important settings include:

• Portal Gun projectile velocity and recipe.
• Portal aperture size, surface offset, and middle-click aim distance.
• Restrict Placement By Prefab and Allowed Placement Prefabs for puzzle maps.
• Entry tolerance, minimum entry speed, exit clearance, re-entry cooldown, and rearm distance.
• Player fall-damage grace enable switch and duration; defaults to enabled for 3 seconds.
• Dropped-item, creature, and projectile traversal switches.
• Portal-view resolution, render rate, distance, circle diameter, border feathering, and effect suppression.

The placement allowlist accepts comma-, semicolon-, or line-separated internal prefab names. Matching ignores capitalization and runtime (Clone) suffixes. Use * to allow every prefab. Placement logs report resolved prefab names to help map authors build allowlists.

The old F10 relocation research tool remains available under Research Harness, but it is disabled by default in the packaged release.

Manual Installation

Install BepInEx and Jotunn, then copy:

plugins/DundrPortalGun.dll

to:

Valheim/BepInEx/plugins/DundrPortalGun.dll

Do not install the DLL twice through both a mod manager and a separate manual copy.

Current Limitations

• Portal pairs last only for the current session and are not written to the world save.
• Portal views are intentionally non-recursive.
• A portal does not follow a moving target after placement.
• Boats, carts, ships, bosses, oversized creatures, and arbitrary physics objects are not supported traversal targets.
• Cross-world, cross-server, and dungeon-to-overworld vanilla portal travel are not used.
• Very long-distance traversal into an unloaded destination zone is unsupported.

Troubleshooting

Check BepInEx/LogOutput.log for entries beginning with:

• PORTAL_NETWORK
• PORTAL_PLACED or PORTAL_PLACEMENT_REJECTED
• PORTAL_TRAVERSED or PORTAL_TRAVERSAL_BLOCKED
• PORTAL_VIEW
• PORTAL_PROJECTILE
• PORTAL_FALL_GRACE

If multiplayer connection is rejected, confirm the server and every player have exactly the same Dundr Portal Gun version.