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.3.7 — requires DrakeModsLibs 0.9.2+ for Locksmith Key art (ArtItemLoader).

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.

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)

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.