Confirm with your password

PersonalChestHeeler

Tiered personal locked storage chests scaled across Valheim progression ages with server-synced configurable capacity, crafting recipes, and subtle emissive lock indicators.

Client & Server Pieces Storage
Install with Gale
Changelog & versions
Stats Source Decompile

Stars
0
Downloads
31
Version
1.0.1
Updated
Author
DreamWraith
Virus scan
✓ Scan successful
Runs on
Client & Server

Compatibility

Required 2

Install these too — Gale pulls them in for you.

Description

PersonalChestHeeler

GitHub Release GitHub Downloads Last Commit Publish Status Thunderstore Hexium Nexus Mods Game: Valheim BepInEx Pack Target: .NET 4.8 Client & Server License AI Philosophy

Tiered personal locked storage chests scaled across Valheim progression ages with server-synced configurable capacity, crafting recipes, and subtle emissive lock indicators.

[!NOTE] Multiplayer Requirement: In multiplayer, this mod must be installed on both the dedicated server and all connecting clients because it registers custom piece prefabs. It also works seamlessly in standalone single-player.

Overview

In vanilla Valheim, private locked storage is limited to a single 6-slot Personal Chest (piece_chest_private). PersonalChestHeeler introduces a 7-tier progression of secure personal lockboxes and vaults scaled across Valheim's biomes and crafting stations. Each tier features dedicated physical sizing, themed emissive lock glows, custom sound layering, and full multiplayer server synchronization.

Progression Matrix

Tier Prefab Name Vanilla Donor Asset Grid (W x H) Slots Scale Lock Glow Hue Default Recipe Required Station Health
Tier 1 (Chained Lockbox) piece_chest_chained_personal TreasureChest_morkhalla 3 x 2 6 0.30x Gold Amber (#D2A700) Wood:8,Tin:1,Copper:1,Resin:4,GreydwarfEye:1 Workbench 250
Tier 2 (Bronze Trussed Chest) piece_chest_finewood_personal piece_chest_private 4 x 3 12 0.90x Forest Green (#00AA39) RoundLog:12,Bronze:4,Ooze:4,WitheredBone:2,Ectoplasm:1 Forge 1,000
Tier 3 (Ironbound Strongbox) piece_chest_reinforced_personal piece_chest 6 x 3 18 0.60x Fiery Orange (#FF7900) ElderBark:16,Iron:6,Guck:4,WolfFang:4,SurtlingCore:1 Forge 1,500
Tier 4 (Ornate Silver Coffer) piece_chest_dvergr_sm_personal TreasureChest_dvergrtower 6 x 4 24 1.10x Arcane Magenta (#E360E7) FineWood:20,Silver:8,Tar:4,LinenThread:8,WolfClaw:1 Artisan Table 2,500
Tier 5 (Dvergr Clockwork Vault) piece_chest_dvergr_lg_personal TreasureChest_dvergrtown 6 x 5 30 1.20x Cobalt Blue (#2359FF) YggdrasilWood:24,BlackMetal:10,Sap:4,MechanicalSpring:2,Eitr:1 Black Forge 4,000
Tier 6 (Charred Flametal Safehold) piece_chest_charred_personal TreasureChest_charredfortress 6 x 6 36 0.95x Crimson Red (#FF0000) Blackwood:28,FlametalNew:12,CharcoalResin:4,CeramicPlate:2,Wisp:1 Black Forge 10,000
Tier 7 (Ancient Morkhalla Reliquary) piece_chest_ancient_personal Morkhalla_ChestAncient 7 x 6 42 0.90x Pale Glacial Cyan (#CAFFFF) Grausten:32,Gold:14,OozeMork:4,Frostwood:8,MemorialCoal:1 Galdr Table 25,000

Features

  • Dedicated Hammer Category: Appears under a dedicated "Personal Chests" tab in the Hammer build menu using Jötunn's Valheim 1.x category support, while retaining Storage filter tags.
  • Normalized Piece Physics: All chest colliders are standardized on the piece physics layer (layer 10) for seamless building grid snapping, reliable repair targeting, and zero ground clipping.
  • Themed Emissive Lock Glow (ChestGlowController): Each chest features a gentle, lock-centered point light and material emission reflecting its metal/biome tier, instantly distinguishing private storage from shared chests.
  • Access Control & Dismantle Protection: Enforces creator ownership across multiplayer servers. Prevents deconstruction of chests containing items.
  • Admin Lock Bypass: Server administrators can optionally bypass personal chest locks (AdminBypassesLock).
  • HUD Ownership Indicators: Contextual hover text highlights lock status ([Personal Lock: Owned] in green, [Personal Lock: Restricted] in red).
  • Live Configuration Hot-Reload: Capacities, recipes, crafting stations, health, and visual glow settings synchronize across clients via ConditionalConfigSync.
  • Zero Asset Bundle Overhead: Uses zero-asset prefab cloning from built-in Valheim assets.

Configuration

Settings can be customized directly in-game using the BepInEx Configuration Manager (F1) or by editing BepInEx/config/dreamwraith.PersonalChestHeeler.cfg:

Section Key Type Default Description
1 - General EnableMod bool true Master switch to enable or disable mod functionality.
1 - General AdminBypassesLock bool true If true, server administrators bypass personal chest ownership restrictions.
1 - General PieceCategory string Personal Chests Hammer build menu category name (supports custom names or vanilla categories).
1 - General EnableChestGlow bool true Enables subtle emissive lock indicator and point-light on chests.
1 - General ChestGlowIntensity float 1.0 Intensity multiplier for chest lock glow and point lights (0.0 - 3.0).
1 - General EnableDebugLogs bool false Enables verbose diagnostic logging in the BepInEx console.
2 - Chest.Chained Chained Chest Enabled bool true Enable Tier 1 Chained Lockbox.
2 - Chest.Chained Chained Chest Health float 250.0 Structural health points.
2 - Chest.Chained Chained Chest Inventory Height int 2 Inventory grid row height (1 - 10).
2 - Chest.Chained Chained Chest Inventory Width int 3 Inventory grid column width (1 - 10) (6 slots total).
2 - Chest.Chained Chained Chest Crafting Station string piece_workbench Required crafting station.
2 - Chest.Chained Chained Chest Recipe string Wood:8,Tin:1,Copper:1,Resin:4,GreydwarfEye:1 Crafting requirements formatted as ItemPrefab:Amount,....
3 - Chest.FineWood Fine Wood Chest Enabled bool true Enable Tier 2 Bronze Trussed Chest.
3 - Chest.FineWood Fine Wood Chest Health float 1000.0 Structural health points.
3 - Chest.FineWood Fine Wood Chest Inventory Height int 3 Inventory grid row height (1 - 10).
3 - Chest.FineWood Fine Wood Chest Inventory Width int 4 Inventory grid column width (1 - 10) (12 slots total).
3 - Chest.FineWood Fine Wood Chest Crafting Station string forge Required crafting station.
3 - Chest.FineWood Fine Wood Chest Recipe string RoundLog:12,Bronze:4,Ooze:4,WitheredBone:2,Ectoplasm:1 Crafting requirements.
4 - Chest.Reinforced Reinforced Chest Enabled bool true Enable Tier 3 Ironbound Strongbox.
4 - Chest.Reinforced Reinforced Chest Health float 1500.0 Structural health points.
4 - Chest.Reinforced Reinforced Chest Inventory Height int 3 Inventory grid row height (1 - 10).
4 - Chest.Reinforced Reinforced Chest Inventory Width int 6 Inventory grid column width (1 - 10) (18 slots total).
4 - Chest.Reinforced Reinforced Chest Crafting Station string forge Required crafting station.
4 - Chest.Reinforced Reinforced Chest Recipe string ElderBark:16,Iron:6,Guck:4,WolfFang:4,SurtlingCore:1 Crafting requirements.
5 - Chest.SmallDvergr Small Dvergr Chest Enabled bool true Enable Tier 4 Ornate Silver Coffer.
5 - Chest.SmallDvergr Small Dvergr Chest Health float 2500.0 Structural health points.
5 - Chest.SmallDvergr Small Dvergr Chest Inventory Height int 4 Inventory grid row height (1 - 10).
5 - Chest.SmallDvergr Small Dvergr Chest Inventory Width int 6 Inventory grid column width (1 - 10) (24 slots total).
5 - Chest.SmallDvergr Small Dvergr Chest Crafting Station string piece_artisanstation Required crafting station.
5 - Chest.SmallDvergr Small Dvergr Chest Recipe string FineWood:20,Silver:8,Tar:4,LinenThread:8,WolfClaw:1 Crafting requirements.
6 - Chest.LargeDvergr Large Dvergr Chest Enabled bool true Enable Tier 5 Dvergr Clockwork Vault.
6 - Chest.LargeDvergr Large Dvergr Chest Health float 4000.0 Structural health points.
6 - Chest.LargeDvergr Large Dvergr Chest Inventory Height int 5 Inventory grid row height (1 - 10).
6 - Chest.LargeDvergr Large Dvergr Chest Inventory Width int 6 Inventory grid column width (1 - 10) (30 slots total).
6 - Chest.LargeDvergr Large Dvergr Chest Crafting Station string blackforge Required crafting station.
6 - Chest.LargeDvergr Large Dvergr Chest Recipe string YggdrasilWood:24,BlackMetal:10,Sap:4,MechanicalSpring:2,Eitr:1 Crafting requirements.
7 - Chest.CharredFortress Charred Fortress Chest Enabled bool true Enable Tier 6 Charred Flametal Safehold.
7 - Chest.CharredFortress Charred Fortress Chest Health float 10000.0 Structural health points.
7 - Chest.CharredFortress Charred Fortress Chest Inventory Height int 6 Inventory grid row height (1 - 10).
7 - Chest.CharredFortress Charred Fortress Chest Inventory Width int 6 Inventory grid column width (1 - 10) (36 slots total).
7 - Chest.CharredFortress Charred Fortress Chest Crafting Station string blackforge Required crafting station.
7 - Chest.CharredFortress Charred Fortress Chest Recipe string Blackwood:28,FlametalNew:12,CharcoalResin:4,CeramicPlate:2,Wisp:1 Crafting requirements.
8 - Chest.AncientMorkhalla Ancient Chest Enabled bool true Enable Tier 7 Ancient Morkhalla Reliquary.
8 - Chest.AncientMorkhalla Ancient Chest Health float 25000.0 Structural health points.
8 - Chest.AncientMorkhalla Ancient Chest Inventory Height int 6 Inventory grid row height (1 - 10).
8 - Chest.AncientMorkhalla Ancient Chest Inventory Width int 7 Inventory grid column width (1 - 10) (42 slots total).
8 - Chest.AncientMorkhalla Ancient Chest Crafting Station string piece_magetable Required crafting station.
8 - Chest.AncientMorkhalla Ancient Chest Recipe string Grausten:32,Gold:14,OozeMork:4,Frostwood:8,MemorialCoal:1 Crafting requirements.

Compatibility

  • Multiplayer: Must be installed on both the dedicated server and all connecting clients. Attempting to place custom chests on a server without the mod will result in missing prefab errors.
  • Single-Player: Fully functional in local single-player worlds.
  • Mod Managers: Fully compatible with Gale, Thunderstore Mod Manager, and r2modman.
  • Modded Setups: Cleanly integrates with other building and inventory mods without conflicts.

Installation

[!TIP] Mod Manager Recommended: Using a modern mod manager like Gale or Thunderstore makes installation and automatic dependency updates effortless.

Mod Manager (Recommended)

  1. Install via Gale, Thunderstore Mod Manager, or r2modman.
  2. Launch Valheim and enjoy!

Manual Installation

  1. Ensure BepInExPack Valheim is installed.
  2. Download and extract the latest release archive.
  3. Place PersonalChestHeeler.dll into your Valheim/BepInEx/plugins/ directory.
  4. Launch Valheim.

Building from Source

The project uses a portable MSBuild configuration that auto-detects standard Steam paths.

dotnet build -c Release

The compiled assembly will be placed in bin/Release/net48/PersonalChestHeeler.dll. Building in Release configuration automatically packages the distribution ZIP to bin/Publish/PersonalChestHeeler-<Version>.zip. For details on version bumping and standalone archive generation, see PACKAGE.md.

Custom & CI Paths

For non-standard Steam library locations or mod manager profiles, copy PersonalChestHeeler.csproj.user.example to PersonalChestHeeler.csproj.user in the project root:

<?xml version="1.0" encoding="utf-8"?>
<Project>
  <PropertyGroup>
    <GamePath>D:\SteamLibrary\steamapps\common\Valheim</GamePath>
    <BepInExCorePath>$(UserProfile)\AppData\Roaming\com.kesomannen.gale\valheim\profiles\<ProfileName>\BepInEx\core</BepInExCorePath>
  </PropertyGroup>
</Project>

Packaging, Publishing & Releases

All developer automation tools for release management, packaging, and publishing to Thunderstore, Hexium, and Nexus Mods are consolidated into the single PowerShell 7 entrypoint .scripts/modtools.ps1, powered by the shared DW.ValheimModTools module:

  • Release Management: pwsh ./.scripts/modtools.ps1 release compiles in Release, creates mod & source archives, extracts changelog notes, and publishes GitHub Releases (Draft by default, or published with -Publish) using the gh CLI.
  • Packaging & Version Bumping: pwsh ./.scripts/modtools.ps1 package -Bump Patch increments SemVer in PersonalChestHeeler.csproj, updates manifest.json, and bundles distribution archives.
  • Portal Publishing: pwsh ./.scripts/modtools.ps1 publish -Target All uploads directly to Thunderstore, Hexium, and Nexus Mods APIs.
  • CI/CD Workflow: .github/workflows/publish.yml provides an automated GitHub Actions workflow to publish to Thunderstore, Hexium, and Nexus Mods whenever a GitHub Release is published.

For detailed documentation on flags, workflows, and secret configuration, see .scripts/README.md.

License, Author Notes

Changelog

All notable changes to PersonalChestHeeler will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.0.1 Latest

Added

  • Configured Nexus Mods integration with Mod ID 4357 in project metadata and portal publishing tooling.
  • Enabled automated GitHub Actions CI/CD workflow (.github/workflows/publish.yml) for portal deployments to Thunderstore, Hexium, and Nexus Mods.
1.0.0

Added

  • 7-Tier Personal Locked Storage Progression:
    • Tier 1 (Chained Lockbox): Crypt treasure chest model (TreasureChest_morkhalla), compact scaling (0.30x), 6 slots (3 x 2), 250 HP, crafted at Workbench.
    • Tier 2 (Bronze Trussed Chest): Native personal chest model (piece_chest_private), scaled 0.90x, 12 slots (4 x 3), 1,000 HP, crafted at Forge.
    • Tier 3 (Ironbound Strongbox): Reinforced iron chest model (piece_chest), scaled 0.60x, 18 slots (6 x 3), 1,500 HP, crafted at Forge.
    • Tier 4 (Ornate Silver Coffer): Dwarven lockbox model (TreasureChest_dvergrtower), scaled 1.10x, 24 slots (6 x 4), 2,500 HP, crafted at Artisan Table.
    • Tier 5 (Dvergr Clockwork Vault): Large dwarven vault model (TreasureChest_dvergrtown), scaled 1.20x, 30 slots (6 x 5), 4,000 HP, crafted at Black Forge.
    • Tier 6 (Charred Flametal Safehold): Ashlands fortress vault model (TreasureChest_charredfortress), scaled 0.95x, 36 slots (6 x 6), 10,000 HP, crafted at Black Forge.
    • Tier 7 (Ancient Morkhalla Reliquary): Ancient monument reliquary model (Morkhalla_ChestAncient), scaled 0.90x, 42 slots (7 x 6), 25,000 HP, crafted at Galdr Table.
  • Dedicated Hammer Category:
    • Registered under a dedicated "Personal Chests" tab in the Hammer build menu using Jötunn's Valheim 1.x dynamic category support, with configurable category name and fallback tags.
  • Real-Time 3D Build Menu Snapshots (RenderManager):
    • Automatically captures off-screen camera rendered 3D snapshot icons for all 7 chest prefabs in the hammer placement menu.
  • Themed Emissive Lock Glow (ChestGlowController):
    • Lock-centered point lights and material emissions tailored per metal/biome tier (Amber, Forest Green, Fiery Orange, Arcane Magenta, Cobalt Blue, Crimson Red, and Pale Glacial Cyan).
    • Synchronized across clients and fully toggleable/scalable via server settings (EnableChestGlow, ChestGlowIntensity).
  • Multi-Layered Dynamic Audio FX (ChestAudioEffectManager):
    • Multi-layered placement, hit, destroy, open, close, and ambient overlay audio using native Valheim AudioClip caching and spatial 3D ZSFX components with tier-specific pitch adjustments.
  • Visual & Material Conformance:
    • Authentic Custom/Piece shader mapping with Twitcher_Spawner_e rune emission bloom and WearNTear structural highlights on Ashlands Flametal models.
    • Automatic piece collider and layer conformance (Layer 10 piece) enabling hammer targeting, snapping, and repair for all dungeon prop donors.
  • Access Enforcement & Security:
    • Full creator-ownership lock enforcement across multiplayer servers via native Valheim Container privacy logic.
    • Native protection against deconstructing chests containing items (m_canBeRemoved).
    • Configurable server administrator lock bypass (AdminBypassesLock).
    • Color-coded HUD hover indicators showing ownership status ([Personal Lock: Owned] / [Personal Lock: Restricted]).
  • Live Configuration Hot-Reload:
    • Real-time synchronization of grid capacities, crafting recipes, stations, and structural health via ConditionalConfigSync.
    • Interactive IMGUI crafting recipe editor with [PrefabName : Amount] controls in BepInEx ConfigurationManager.

Full version history & older downloads →

Manual download
Just this mod One .zip — PersonalChestHeeler 1.0.1
Files you'll get 3

Your browser may ask permission to download several files at once. How to install these manually
Manual installation instructions
1

Install BepInExPack Valheim

BepInExPack Valheim is required to run mods in Valheim.

Download BepInExPack Valheim 5.4.2351 · View mod page

Check out the mod page for detailed installation instructions.

2

Install PersonalChestHeeler

This mod must be installed on both the client and the server.

Download PersonalChestHeeler 1.0.1

Extract the ZIP and place the file(s) into the BepInEx/plugins/ folder inside your Valheim game folder.