ValheimLoading...UnifiedStorage1.1.2

You are viewing a potentially older version of this package. View Latest Version

Install

Date Uploaded

4 months ago

Downloads

1.7K

Size

179KB

Dependency string

andre-UnifiedStorage-1.1.2

Download

Details Required (2)Versions

Unified Storage (Valheim 0.221.12)

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

Current state (v1.1.2)

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.
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.
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 (v1.1.1)

Added terminal UI improvements: slot usage bar + live slot counter and integrated search field.
Added storage-capacity guardrails to prevent deposits when no chest space is available.
Added terminal hover text with nearby chest count for better in-world feedback.
Improved terminal interaction validation and nearby-container flow.
Refined session and inventory refresh behavior to keep projection and server snapshot aligned.
Replaced operation-heavy logs with opt-in development logs via EnableDevLogs.

Release notes (v1.1.2)

Added localized display names in terminal sessions so item names follow the active game language.
Fixed terminal session close flow to avoid stale/incorrect session shutdown behavior.
Optimized terminal hover text by caching nearby chest count lookups.

Architecture (v1.1.2)

UnifiedTerminal implements Interactable + Hoverable directly (no Container.Interact patch needed).
ReflectionHelpers centralizes all reflection-based access to Valheim internals.
TerminalUIManager owns all UI creation and layout management.
TerminalSessionService manages client-side session state and authoritative projection.
TerminalAuthorityService handles server-side authorization, reservations, and conflict checks.

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
EnableDevLogs = false
TerminalPieceEnabled = true
TerminalDisplayName = "Unified Chest"
TerminalRangeOverride = 0
TerminalTintEnabled = true
TerminalTintColor = "#6EA84A"
TerminalTintStrength = 0.35

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.2)

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.

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.

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 (v1.1.1)

Added terminal UI improvements: slot usage bar + live slot counter and integrated search field.

Added storage-capacity guardrails to prevent deposits when no chest space is available.

Added terminal hover text with nearby chest count for better in-world feedback.

Improved terminal interaction validation and nearby-container flow.

Refined session and inventory refresh behavior to keep projection and server snapshot aligned.

Replaced operation-heavy logs with opt-in development logs via EnableDevLogs.

Architecture (v1.1.2)

UnifiedTerminal implements Interactable + Hoverable directly (no Container.Interact patch needed).

ReflectionHelpers centralizes all reflection-based access to Valheim internals.

TerminalUIManager owns all UI creation and layout management.

TerminalSessionService manages client-side session state and authoritative projection.

TerminalAuthorityService handles server-side authorization, reservations, and conflict checks.

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