ValheimLoading...PortalMetalLock

Last Updated

First Uploaded

Downloads

349

Likes

Size

149KB

Dependency string

Baka_Gaijin-PortalMetalLock-1.5.1

Dependants

0 other mods

Server-side Client-side AI Generated

Download

Details Required (2)Wiki Changelog Versions Analysis

PortalMetalLock

Keep metals where they belong. Metals, ores, bars, and scrap — vanilla and mod-added — can no longer be carried through normal (wood) portals. The Ashlands stone portal (the "advanced" portal) still carries everything, exactly like vanilla.

Why

Vanilla already blocks vanilla metals from wood portals, but many content mods add their own ores/bars and leave them teleportable, quietly undoing that restriction. PortalMetalLock closes that gap: it scans the item database (including items registered late by Jotunn-based mods) and flags matching materials as non-teleportable, so wood portals refuse them again.

How it works

Valheim wood portals refuse to teleport a player whose inventory holds any non-teleportable item. The Ashlands stone portal sets m_allowAllItems, which the game checks before the per-item test, so it keeps carrying everything with no extra handling.

This mod simply sets m_teleportable = false on matching items. Matching is restricted to items of type Material, so weapons, armour, tools, and jewellery (e.g. SwordBronze, SilverNecklace) are never affected — only raw metal/ore/bar/scrap.

Configuration (server-authoritative — locked on clients)

All settings are admin-only and synchronised from the server via Jötunn. When connected to a server, the server's values are pushed to every client and locked — players cannot edit their local config to make metals teleportable again. Only the server admin can change these (edit baka.PortalMetalLock.cfg on the server while it is stopped, or via the in-game Configuration Manager as an admin):

Setting	Default	Description
Enabled	`true`	Master switch. When on, matching materials are made non-teleportable.
MetalKeywords	`copper,tin,bronze,iron,silver,blackmetal,flametal,ore,scrap,ingot`	Comma-separated, case-insensitive substrings. Any Material whose prefab name or localized name contains one is blocked.
ExtraPrefabs	(empty)	Comma-separated EXACT prefab names to also block, for mod metals the keywords miss. Use VNEI in-game to find exact names.
ExcludePrefabs	`BronzeNails,LeatherScraps`	Comma-separated EXACT prefab names to never touch (false-positive guard).

After changing keywords/prefabs on the server, reload the world (or restart) so the item database is re-scanned.

Server enforcement

This mod uses Jötunn's NetworkCompatibility at level EveryoneMustHaveMod with Minor version strictness. When it runs on a dedicated server, every connecting client must also have PortalMetalLock installed at a matching major.minor version — clients that are missing the mod or on a mismatched version are rejected at the connection handshake with an error screen. This guarantees the rule is enforced for everyone on the server, not just players who happen to have it.

(The teleport gate itself is evaluated client-side, so without this enforcement a vanilla/missing-mod client could otherwise carry mod metals through. EveryoneMustHaveMod closes that gap.)

Requirements

BepInEx
Jötunn (for the server-side enforcement handshake)

Notes

This is a personal quality-of-life / rules mod. It only flips a per-item teleport flag; no world data, recipes, or items are otherwise changed. Safe to add or remove at any time.

Why

How it works

Configuration (server-authoritative — locked on clients)

Setting

Default

Description

Enabled

true

Master switch. When on, matching materials are made non-teleportable.

MetalKeywords

copper,tin,bronze,iron,silver,blackmetal,flametal,ore,scrap,ingot

Comma-separated, case-insensitive substrings. Any Material whose prefab name or localized name contains one is blocked.

ExtraPrefabs

(empty)

Comma-separated EXACT prefab names to also block, for mod metals the keywords miss. Use VNEI in-game to find exact names.

ExcludePrefabs

BronzeNails,LeatherScraps

Comma-separated EXACT prefab names to never touch (false-positive guard).

After changing keywords/prefabs on the server, reload the world (or restart) so the item database is re-scanned.

Server enforcement

(The teleport gate itself is evaluated client-side, so without this enforcement a vanilla/missing-mod client could otherwise carry mod metals through. EveryoneMustHaveMod closes that gap.)

PortalMetalLock

Details

Categories

PortalMetalLock

Why

How it works

Configuration (server-authoritative — locked on clients)

Server enforcement

Requirements

Notes

Categories

PortalMetalLock

Why

How it works

Configuration (server-authoritative — locked on clients)

Server enforcement

Requirements

Notes

Categories