LockSmith

Share chests and doors behind your ward without putting people on the ward. Designate a piece with the Locksmith key, then open it publicly or grant guest access to individuals. Also covers Personal/Team private chests for shared stashes.

Ward-friendly access for Valheim bases:

• Public / private on normal chests and doors (inside wards)
• Personal / Team on private-family chests (shared stash, no ward required)
• Guests on ward pieces via a Join list, works similar to ward opt-in
• Easy to clear without rebuild

Craft one Locksmith Key, designate a piece, then permitted players use Alt+E for public/private without holding the key. The key stays required for Team / Join setup.

Requires (everyone on the server): BepInExPack Valheim, Jotunn, DrakeModsLibs

Install folder:

BepInEx/plugins/DrakeMods-LockSmith/

Version

0.4.0 — Hammer Public tab (EnablePieceMode), RequireActiveWard, and Valheim 1.0 center-message fix. Requires DrakeModsLibs 0.9.4+.

0.3.9 — Key passes (inventory menu + Ctrl+C/V) and shared DrakeModsLibs inventory chord / tab host. Requires DrakeModsLibs 0.9.4+.

Craft the key

Default recipe: 1 Wood, craftable from the inventory (no station). Configurable under LockSmith → Key (KeyMaterials, KeyCraftingStation).

How to use

Designate a piece (key)

1. Equip the Locksmith Key.
2. Look at a player-built chest, door, or gate.
3. E → Enable LockSmith (sets locksmith_managed). First use claims it.
4. Unequip the key for day-to-day use.
5. ClearModifier+E (default Alt+E, key equipped) → Clear LockSmith. Guests → confirm twice.
6. SetupModifier+E (default Shift+E, key equipped) → Open/close Join.

Ward chests / doors — after designate

1. If you have ward or guest access: Alt+E → public / private (no key).
2. Strangers cannot toggle. [Public] means open — no Join/setup until private again.
3. Key still needed for SetupModifier+E Join open/close (guest list on that piece).

Private chests — Personal / Team

1. Equip the key on a private chest.
2. E → Personal ↔ Team (creator) — also designates.
3. SetupModifier+E (default Shift+E) → open/close Join (opt-in ready). Key required.
4. Other character: E → Join access. Guests see names on hover; Alt+E → Leave access while Join is open.
5. Hover shows Open (not vanilla No access) when you have team/guest rights.

Public hammer pieces (piece mode)

1. Host sets EnablePieceMode=true and restarts (clients need the same mod).
2. Hammer → Public category: always-open clones of ward-locked chests/doors (vanilla and discovered mod pieces).
3. Names append (public) when PublicPieceNameSuffix is on. Already-public vanilla pieces (e.g. Christmas boxes) are not duplicated.
4. Use PublicPieceDenyList / PublicPieceAllowList to trim or force donors. Key mode does not designate these clones.

Ward chests / doors — partial guest access

1. Designate with key, then SetupModifier+E (with key) → open/close Join.
2. A player not on the ward presses E while Join is open → guest list.
3. Guests can open that chest/door without ward permit (EnablePieceGuests).
4. Guests (and ward members) can Alt+E public/private without the key. Private chests are excluded.

Config (synced)

Inventory key menu uses DrakeModsLibs Integration.InventoryOpenModifier (default Shift) + right-click — shared with RenameIt when both claim an item.

Multiplayer

Required on server and all clients (EveryoneMustHaveMod). Feature toggles and key recipe sync via DrakeModsLibs config sync.

What’s next

See docs/drakeVision.md.

Feedback

Bug reports and “this would help our RP server” notes welcome — GitHub issues.

Changelog

0.4.1

• Fix multiplayer Join: re-bind piece RPCs after chunk reload (opt-in/out and Join open/close stopped applying).
• Fix Join toggle spam when ZDO sync lags - owner tool no longer flips open/open on stale state.

0.4.0

• Piece mode (Phase 4): EnablePieceMode discovers ward-locked chests/doors/gates (vanilla + mods) and registers always-public Hammer Public tab clones (m_checkGuardStone = false, no ZDO toggle).
• Skips donors that are already public (e.g. Christmas boxes) and private-family chests.
• Synced PublicPieceAllowList / PublicPieceDenyList; PublicPieceNameSuffix (default on) appends localized (public) to clone names.
• Key mode ignores public clones (hover: always public). Restart after changing piece-mode registration settings.
• RequireActiveWard (default on): with no enabled ward covering a normal chest/door, LockSmith cannot manage or toggle it - including already-managed pieces. Personal/Team private-family chests stay exempt. Doors always need the ward up.
• Fix Valheim 1.0 center feedback: AccessFeedback no longer calls the removed 4-arg Character.Message (was red MissingMethodException on key Join/clear/clipboard).
• Drop duplicate Config Manager masterkey section from ArtItemLoader; use 03 Key only for name / recipe.
• Requires DrakeModsLibs 0.9.4+.

0.3.9

• Key passes: inventory menu on the Locksmith key (Relabel, grab nearby, clear, clone at craft cost) via DrakeModsLibs wood UI / DrakeTabHost.
• Clipboard: Ctrl+C / Ctrl+V copy guest names onto the key and paste onto a looked-at piece.
• Inventory open chord uses DrakeModsLibs Integration.InventoryOpenModifier (removed LockSmith KeyMenuOpenModifier).
• Localized single-mode hint configure lock tool; Libs shows customize when 2+ tabs are usable (e.g. admin TagBypass + RenameIt). Soft NoRename + hard description lock on keys (description only is hard-locked).
• Requires DrakeModsLibs 0.9.4+.

0.3.8

• Repair flattened Thunderstore installs (Gale puts keys.bundle next to the DLL) into Assets/Items/keys so the Locksmith Key registers.
• Require DrakeModsLibs 0.9.3 (Valheim 1.0 Character.Message signature ??? fixes pickup MissingMethodException).

0.3.7

• Require DrakeModsLibs 0.9.2+ (ArtItemLoader folder packs) so the official Locksmith Key art loads for store installs.

0.3.6

• First public release (GitHub). Thunderstore/Hexium upload when store tokens are set.
• Official Locksmith Key from Assets/Items/keys ArtItem pack (MasterKey mesh, bone skull, flipped grip).
• Slim visual-only keys.bundle (no drop physics / particle VFX / packed Valheim scripts).
• Removed temporary give-key-on-spawn debug helper.
• README elevator pitch + store description; release categories ready for Thunderstore + Hexium.

0.3.5

• Designate flag (locksmith_managed): key claims a chest/door as a LockSmith piece (EnableDesignate).
• After designation, Alt+E public/private for anyone with access (ward or guest) ??? no key in hand (EnableGuestPublicToggle).
• Strangers never toggle. Public stays open-only (no Join/setup).
• Key still required for Team mode and Join open/close.
• Pre-0.3.5 pieces with public/guests/team state count as already designated.
• Clear with key: configurable ClearModifier+E (default Alt). Guests ??? confirm twice.
• Join setup with key: configurable SetupModifier+E (default Shift) so it no longer collides with Clear when AltPlace is rebound to Shift.
• Fix: Join hover no longer doubles [Join open] / [E] Join access.
• Guest names: keep playerId, show name; refresh Unknown when online.

0.3.4

• Guests on ward chests/doors can Alt+E toggle public/private without the Locksmith key (EnableGuestPublicToggle).
• Not for private-family chests. While public: Join/setup disabled ??? public means open.
• While Join is open, Alt+E still means Leave; when Join is closed, Alt+E unlocks/locks for everyone.
• Future (drakeVision): access setup menu UI.

0.3.3

• Guests [N] vs names-with-key; local TeamLabelColor; name resolve/refresh.

0.3.2

• Hover No access fix; opt-out; names; ward bypass for team guests.

0.3.1

• Ward-style Join; piece guests.

0.3.0

• Personal/Team private chests.

0.2.0

• Ward public/private.

0.0.1

• Internal prototype.