ValheimLoading...SwampKeyPersist

Last Updated

First Uploaded

Downloads

Likes

Size

155KB

Dependency string

Baka_Gaijin-SwampKeyPersist-1.1.0

Dependants

0 other mods

Mods AI Generated

Download

Details Required (1)Wiki Changelog Versions Analysis

Swamp Key Persist

Makes the Swamp Key / Crypt Key ($item_cryptkey) persist indefinitely instead of being consumed one-per-use when opening a Sunken Crypt gate.

Why this exists

In vanilla Valheim the Crypt Key is not consumed — you keep it forever. Some mods change this by hooking Door.Open and removing one key from your inventory every time you open a Sunken Crypt gate (with no config option to turn it off). This mod counters that behavior so your key behaves like vanilla again: open as many crypts as you like, the key stays.

How it works

Patch-order-proof and mod-agnostic. A Door.Open Prefix opens a short "protect window" and records the door's key item name; a Finalizer closes it. Because Harmony finalizers run after every postfix, the window reliably spans any other mod's Door.Open postfix regardless of patch order. While the window is open, prefixes on Inventory.RemoveOneItem / RemoveItem refuse to delete that key (and report success, so the other mod's logic is unaffected).

It only protects the key during a crypt-gate open — you can still drop, store, trade, or craft with the key normally.

Anti-cheat: server-sanctioned

The key consume is a client-side operation, so on its own this DLL could be carried to any server to keep keys. To prevent that, key protection only activates on a server that also runs this mod (or when you are the host). A sanctioning server sends each connecting client a tiny ServerHello handshake RPC; a client only protects keys once it has received that Hello. On a server that does not run the mod, no Hello arrives, protection stays off, and keys consume normally. The gate is hardcoded (not exposed in config) so it can't be flipped off to cheat elsewhere.

Installation

This is a client + server mod. The server must run it to sanction key-persistence, and each player must also install it (the consume happens on the client). Install on both with a mod manager, or manually drop SwampKeyPersist.dll into BepInEx/plugins.

Configuration

baka.SwampKeyPersist.cfg:

Setting	Default	Description
`Enabled`	`true`	Master switch.
`ProtectAllKeyedDoors`	`false`	Protect the key of ANY keyed door, not just Sunken Crypt gates.
`CryptDoorNameContains`	`sunken_crypt_gate`	Comma-separated substrings; a door whose GameObject name contains any of these is treated as a crypt gate whose key must persist.

Verifying it works

After opening a Sunken Crypt gate, the BepInEx console logs:

Preserved door key '$item_cryptkey' (blocked consume on crypt-gate open).

Why this exists

How it works

It only protects the key during a crypt-gate open — you can still drop, store, trade, or craft with the key normally.

Anti-cheat: server-sanctioned

Configuration

baka.SwampKeyPersist.cfg:

Setting

Default

Description

Enabled

true

Master switch.

ProtectAllKeyedDoors

false

Protect the key of ANY keyed door, not just Sunken Crypt gates.

CryptDoorNameContains

sunken_crypt_gate

Comma-separated substrings; a door whose GameObject name contains any of these is treated as a crypt gate whose key must persist.

Details

Categories

Swamp Key Persist

Why this exists

How it works

Anti-cheat: server-sanctioned

Installation

Configuration

Verifying it works

Swamp Key Persist

Why this exists

How it works

Anti-cheat: server-sanctioned

Installation

Configuration

Verifying it works