SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedQuality of life & UI

UnstablePortalsMetalTransport

by KernelPanik · for Valheim

Transport metal through portals by paying a configurable toll, with portal damage and audiovisual instability effects.

134Downloads
59d agoLast updated
BepInExLoaders
ThunderstoreSource

About UnstablePortalsMetalTransport

From Thunderstore

Transport metal through portals by paying a configurable toll, with portal damage and audiovisual instability effects.

Unstable Portals: Metal Transport

A client-side Valheim mod for BepInEx that lets players transport metal and other normally restricted items through portals by paying a configurable toll. The default is 1 Surtling Core and 5 Greydwarf Eyes per successful trip, with portal damage and audiovisual instability warning of the risk.

Behavior

  • Ordinary portal travel remains free.
  • If the inventory contains one or more portal-restricted items, the player must also carry the configured toll. The default is 1 Surtling Core and 5 Greydwarf Eyes.
  • The toll is consumed only after Valheim accepts the teleport.
  • The price is per trip, not per stack, item, or unit of metal.
  • By default, the source and destination portals each take damage equal to 10% of their maximum health. They can be repaired normally.
  • When the toll is available, the portal's existing particle animation and light slowly pulse from dark orange to purple and back. By default, the glowing frame runes pulse in the opposite phase, suggesting unstable energy moving between the portal and its frame. No custom model or animation is added.
  • The portal's existing sound also wobbles at a slightly deeper pitch while that instability effect is active. This uses the built-in audio source; no sound file is added.
  • Ordinary items flagged by Valheim as non-teleportable count. This includes metals and ores. Items marked by Valheim as absolutely blocked remain blocked.
  • Toll items inside a cart or container do not count; they must be in the player's inventory.

Installation

  1. Install the current BepInExPack for Valheim.
  2. If upgrading from version 1.2.0 or earlier, delete the pre-rename DLL first. Do not leave both DLLs installed.
  3. Create BepInEx\plugins\UnstablePortalsMetalTransport in the Valheim game folder.
  4. Copy UnstablePortalsMetalTransport.dll into that folder.
  5. Start Valheim through the mod manager or BepInEx-enabled launcher.

For multiplayer, install the mod on every player's client. A dedicated-server-only installation is not sufficient because the player's client owns this portal interaction.

Configuration

After the game starts once with the mod installed, edit:

BepInEx/config/com.kernelpanik.unstableportalsmetaltransport.cfg

Version 1.2.2 completes the mod rename by changing its internal plugin identity. BepInEx therefore creates a new configuration file. After launching once, copy any customized values from your previous configuration into the new file.

The available settings are:

| Section | Setting | Default | Purpose | |---|---|---:|---| | Toll | SurtlingCoreCost | 1 | Surtling Cores consumed per paid trip. | | Toll | GreydwarfEyeCost | 5 | Greydwarf Eyes consumed per paid trip. | | Portal Damage | DamagePercent | 10 | Percent of maximum portal health removed from each enabled side. | | Portal Damage | DamageSourcePortal | true | Damage the portal the player enters. | | Portal Damage | DamageDestinationPortal | true | Damage the linked portal the player arrives at. | | Visuals | InverseRunePulse | true | Pulse the glowing frame runes opposite the portal particles and light. Set to false to synchronize them. | | Visuals | RuneBrightnessMultiplier | 3 | HDR brightness of the pulsing frame runes. Increase if they appear dim; decrease if bloom is excessive. | | Audio | EnableUnstableSound | true | Pitch-wobble the existing portal sound during the toll effect. | | Audio | MinimumPitchMultiplier | 0.82 | Deeper endpoint of the pitch wobble. Values below 1 lower the pitch. | | Audio | MaximumPitchMultiplier | 0.96 | Upper endpoint of the pitch wobble. Values above 1 raise the pitch. |

Set either item cost or the damage percentage to 0 to disable that part. Set either portal-damage toggle to false to protect that side. In multiplayer, use the same configuration on every player's client for consistent tolls.

For a higher, more strained sound, try MinimumPitchMultiplier = 1.04 and MaximumPitchMultiplier = 1.18. Set both pitch values to the same number for a steady pitch shift instead of a wobble.

Build from source

Requirements:

  • The current PC version of Valheim
  • BepInExPack for Valheim installed in the game directory
  • .NET SDK capable of targeting .NET Framework 4.6.2

From PowerShell:

.\build.ps1

If Valheim is not in the default Steam location:

.\build.ps1 -ValheimPath "D:\SteamLibrary\steamapps\common\Valheim"

The output DLL is written to bin\Release\net462\UnstablePortalsMetalTransport.dll.

Compatibility notes

The mod uses BepInEx and Harmony but does not require Jötunn. It resolves Valheim gameplay types at runtime so moving those types between game assemblies does not by itself break the mod. Other mods that completely replace portal logic may conflict.

Version 1.2.2 targets Valheim 1.0.14's current portal flow. Keep a normal world/character backup before testing any new mod.

Uninstall

Delete UnstablePortalsMetalTransport.dll from BepInEx\plugins. The mod does not add items or save custom world data.

Highlights

From source data

Loaders

Runs on BepInEx.

Footprint

Rated a light load on a server.

Last update

Its author last shipped an update 59d ago.

UnstablePortalsMetalTransport on Nxeon

From our catalogue
One-click install
Supported on Nxeon Valheim servers, for BepInEx servers. We download it from Thunderstore, place it, and restart the server.
Server side
Optional on the server
Server type needed
BepInEx
Server load
light
Smallest plan we suggest
Valheim — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
Latest build
1.2.2, released 2026-09-24

Game versions by loader

LoaderGame versionsNewest
BepInEx

From 2 recorded builds of UnstablePortalsMetalTransport.

Recent builds

BuildReleasedGame versionsLoaders
1.2.22026-09-24n/aBepInEx
1.2.12026-09-23n/aBepInEx

Run UnstablePortalsMetalTransport on a Valheim server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on Thunderstore as “Tweaks”

Quality of life & UI

Small conveniences, tweaks and interface improvements players notice straight away.

Works on a server

From source side support

Thunderstore lists server-side support for UnstablePortalsMetalTransport as optional: it can run on a server, but isn’t required there.

Compatibility

Game
Valheim
Loaders
BepInEx
Runs on
Serveroptional on the server
Requires
One-click install needs a BepInEx server.

Verified at the source

  • ✓ThunderstoreOfficial listing, checked 2026-10-16Open ↗
  • ✓AuthorKernelPanik, as published on Thunderstore
  • ✓LicenseNot published by the sourceFree

UnstablePortalsMetalTransport, answered

Generated from the mod’s own source data.

Do my players need to install UnstablePortalsMetalTransport?

Thunderstore lists server-side support for UnstablePortalsMetalTransport as optional: it can run on a server, but isn’t required there.

Which loaders does it support?

BepInEx.

Is it free?

Yes. UnstablePortalsMetalTransport is free to download from Thunderstore.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run UnstablePortalsMetalTransport on a Valheim server.

Deploy in about a minute from $6.50 a month, then add UnstablePortalsMetalTransport in one click.