ValheimLoading...UnifiedStorage

This package has been deprecated and may no longer be maintained. We recommend looking for an alternative.

Install

Last Updated

First Uploaded

Downloads

1.7K

Likes

Size

182KB

Dependency string

andre-UnifiedStorage-1.1.5

Dependants

1 other mods

Mods Utility

Deprecated

Download

Details Required (2)Wiki Changelog Versions Analysis

Unified Storage (Valheim 0.221.12)

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

Current state (v1.1.5)

New placeable: Unified Chest (via Jotunn) with custom Interactable.
Opening the terminal uses Valheim's native chest UI.
Aggregates items from nearby static vanilla chests within configured range.
Supports optional integration with ItemDrawers (kg_ItemDrawers) and includes drawers in unified storage when available.
Respects real maxStackSize per item (no stack size mutation).
Built-in text search in the terminal inventory.
Slot usage bar and counter (used / total) with dynamic color by fill ratio.
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.
Deposit is blocked when unified storage has no available space.
Take all is disabled in the terminal to avoid incorrect behavior.
Vanilla chest UI includes Include In Unified toggle (default: enabled).
Hover text shows nearby chest count when aiming at the terminal.
Global scan cap is configurable via MaxContainersScanned (default: 128) to balance coverage and performance.
Multiplayer consistency is server-authoritative with reservation/timeout flow.
Delta broadcast keeps multiple players viewing the same terminal in sync.
Core library (UnifiedStorage.Core) used for aggregation, search, withdraw/deposit planning.

Release notes

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

Optional integration:

kg_ItemDrawers (drawer sources are included automatically when installed)

Configuration (BepInEx)

ScanRadius = 20
MaxContainersScanned = 128 (global cap; increasing this can significantly impact performance)
EnableDevLogs = false
TerminalPieceEnabled = true

Project structure

src/UnifiedStorage.Mod: Valheim plugin (BepInEx + Jotunn + Harmony).
- Pieces/: UnifiedTerminal (Interactable) and UnifiedTerminalRegistrar.
- UI/: TerminalUIManager (all UI creation and layout).
- Server/: TerminalAuthorityService, ContainerScanner, ChestInclusionRules.
- Session/: TerminalSessionService (client-side session logic).
- Network/: TerminalRpcRoutes, TerminalCodec (RPC and serialization).
- Shared/: ReflectionHelpers (centralized reflection).
- Patches/: Harmony patches for InventoryGui, InventoryGrid, ZInput, and terminal interactions.
src/UnifiedStorage.Core: shared models and pure logic (aggregation, search, withdraw/deposit planning).
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

Current state (v1.1.5)

New placeable: Unified Chest (via Jotunn) with custom Interactable.

Opening the terminal uses Valheim's native chest UI.

Aggregates items from nearby static vanilla chests within configured range.

Supports optional integration with ItemDrawers (kg_ItemDrawers) and includes drawers in unified storage when available.

Respects real maxStackSize per item (no stack size mutation).

Built-in text search in the terminal inventory.

Slot usage bar and counter (used / total) with dynamic color by fill ratio.

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.

Deposit is blocked when unified storage has no available space.

Take all is disabled in the terminal to avoid incorrect behavior.

Vanilla chest UI includes Include In Unified toggle (default: enabled).

Hover text shows nearby chest count when aiming at the terminal.

Global scan cap is configurable via MaxContainersScanned (default: 128) to balance coverage and performance.

Multiplayer consistency is server-authoritative with reservation/timeout flow.

Delta broadcast keeps multiple players viewing the same terminal in sync.

Core library (UnifiedStorage.Core) used for aggregation, search, withdraw/deposit planning.

Project structure

src/UnifiedStorage.Mod: Valheim plugin (BepInEx + Jotunn + Harmony).

Pieces/: UnifiedTerminal (Interactable) and UnifiedTerminalRegistrar.
UI/: TerminalUIManager (all UI creation and layout).
Server/: TerminalAuthorityService, ContainerScanner, ChestInclusionRules.
Session/: TerminalSessionService (client-side session logic).
Network/: TerminalRpcRoutes, TerminalCodec (RPC and serialization).
Shared/: ReflectionHelpers (centralized reflection).
Patches/: Harmony patches for InventoryGui, InventoryGrid, ZInput, and terminal interactions.

src/UnifiedStorage.Core: shared models and pure logic (aggregation, search, withdraw/deposit planning).

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

UnifiedStorage

Details

Categories

Unified Storage (Valheim 0.221.12)

Current state (v1.1.5)

Release notes

Scope

Dependencies

Configuration (BepInEx)

Project structure

Local build

Manual install (r2modman profile)

Thunderstore packaging

Categories

Unified Storage (Valheim 0.221.12)

Current state (v1.1.5)

Release notes

Scope

Dependencies

Configuration (BepInEx)

Project structure

Local build

Manual install (r2modman profile)

Thunderstore packaging

Categories