Unified Storage (Valheim 0.221.12)

Unified storage for Valheim using a dedicated terminal, without changing vanilla chest behavior.

Current state (v1.0.6)

• New placeable: Unified Chest (via Jotunn).
• Opening the terminal uses Valheim's native chest UI.
• Aggregates items from nearby static vanilla chests within configured range.
• Built-in text search in the interface.
• Native scroll support for large item lists.
• Type-based ordering with lightweight material grouping (for example: ores/metals).
• Deposit and withdraw use normal chest interactions.
• Take all is disabled in the terminal to avoid incorrect behavior.
• Vanilla chest UI now includes Include In Unified toggle (default: enabled).
• Multiplayer consistency is server-authoritative with reservation/timeout flow.

Scope

• No built-in crafting system.
• Vanilla chests remain unchanged.
• The terminal is the only access point to unified storage.

Dependencies

• denikson-BepInExPack_Valheim
• ValheimModding-Jotunn

Configuration (BepInEx)

• ScanRadius = 20
• MaxContainersScanned = 128
• RequireAccessCheck = true
• TerminalPieceEnabled = true
• TerminalDisplayName = "Unified Chest"
• TerminalRangeOverride = 0

Project structure

• src/UnifiedStorage.Mod: Valheim plugin (BepInEx + Jotunn).
• src/UnifiedStorage.Core: shared models and logic.
• tests/UnifiedStorage.Core.Tests: core unit tests.

Local build

PowerShell:

$VALHEIM_MANAGED_DIR = "C:\Program Files (x86)\Steam\steamapps\common\Valheim\valheim_Data\Managed"
$BEPINEX_CORE_DIR = "C:\Users\<user>\AppData\Roaming\r2modmanPlus-local\Valheim\profiles\<profile>\BepInEx\core"
$JOTUNN_DLL = "C:\Users\<user>\AppData\Roaming\r2modmanPlus-local\Valheim\profiles\<profile>\BepInEx\plugins\ValheimModding-Jotunn\Jotunn.dll"

dotnet build .\src\UnifiedStorage.Mod\UnifiedStorage.Mod.csproj -c Release `
  /p:VALHEIM_MANAGED_DIR="$VALHEIM_MANAGED_DIR" `
  /p:BEPINEX_CORE_DIR="$BEPINEX_CORE_DIR" `
  /p:JOTUNN_DLL="$JOTUNN_DLL"

Output:

• src/UnifiedStorage.Mod/bin/Release/net472/UnifiedStorage.dll
• src/UnifiedStorage.Core/bin/Release/netstandard2.0/UnifiedStorage.Core.dll

Manual install (r2modman profile)

Copy DLLs to:

BepInEx/plugins/UnifiedStorage/

Files:

• UnifiedStorage.dll
• UnifiedStorage.Core.dll

Thunderstore packaging

Expected release ZIP layout:

• manifest.json
• README.md
• icon.png
• plugins/UnifiedStorage/UnifiedStorage.dll
• plugins/UnifiedStorage/UnifiedStorage.Core.dll