Stackmaster

Turn a messy Viking inventory into a tidy, adventure-ready loadout.

Stackmaster by JStack424 combines automatic inventory sorting, deliberate nearby-storage depositing, protected-stack replenishment, storage-aware requirement totals, expedition-kit withdrawal, and optional nearby-chest material use for building and crafting in one Valheim workflow.

Vanilla-plus by design

Stackmaster is built to preserve the vanilla experience. It adds no gameplay advantage: no free resources, extra carrying capacity, powers, cheats, or progression shortcuts. Instead, it removes repetitive container rummaging so you can spend more time adventuring and building immersive spaces. Put a pantry behind real doors and cook at the nearby station without fetching every ingredient by hand, or unload a mining haul into its organized storage without visiting every chest one by one.

Convenience stays deliberate. Auto-deposit works only when you look at or interact with a chest and press Left Alt + E; simply walking near your base never empties your backpack.

Compatibility status: Stackmaster 1.1.5 fixes a serious 1.1.4 remote-crafting transaction bug: detached read-only chest snapshots could be debited instead of live inventories, granting chest-backed crafting resources for free. Prepared crafting now recaptures the exact plan from selected owned containers, verifies live inventory identity, journals every observed mutation, and fails closed unless the full exact debit is confirmed. The corrected chest-backed debit was live-tested in Valheim before this production release. The startup gate still validates required types, exact method overloads and parameters, fields, properties, and every Harmony target and patch entrypoint before patching; the release gate also verifies the pinned DoCrafting output/charge call shape used for duplicate-charge suppression. Runtime versions and assembly identity remain diagnostics only. Broader multiplayer, dedicated-server, workbench-extension, manual-access-preemption, and load/unload edge-case testing remains incomplete; back up valuable characters and worlds and report any item loss, duplication, free output, crash, blocked chest, or synchronization disagreement.

Features

• Inventory sorting
  • Sorts movable backpack slots alphabetically whenever the inventory opens.
  • Adds an Auto-sort chest checkbox beneath each supported opened vanilla chest.
  • Sorts an enabled chest when its UI opens and again when it closes, so removing items does not require a reopen to restore order.
  • Remembers disabled chests locally per player, world, and chest without writing preferences to shared world state or affecting other players.
  • Keeps the whole quick bar, equipped items, and protected stacks fixed.
• One consistent storage scope
  • Inside a vanilla workbench build zone, follows every overlapping workbench zone as one connected base mesh and includes loaded supported chests anywhere in that exact union.
  • Excludes nearby chests outside the connected mesh, even if they are within the fallback radius.
  • Outside every workbench mesh, uses the configurable player-centered radius (20 metres by default).
  • Applies the same scope to deposit, replenishment, building, and crafting; a chest's Auto-sort chest checkbox never changes storage eligibility.
• Auto-deposit
  • Runs only when you press Left Alt + E while targeting or interacting with a vanilla chest.
  • Deposits only into eligible vanilla containers in the active storage scope that already hold a compatible item.
  • Fills partial stacks first, prioritizing the targeted chest and then searching nearest to farthest.
  • Leaves unmatched items and overflow safely in the player inventory.
• Auto-replenish
  • Refills protected stacks, including ammo and consumables, to optional target quantities during the same storage action.
  • Uses the configured storage-action modifier for two distinct inventory controls: left-click instantly protects or fully unprotects an item, while right-click opens target entry for stackable items.
  • A left-click protection toggle never opens a dialog; unlocking also clears any replenishment target. Canceling the right-click dialog preserves the prior state, and non-stackable items remain protection-only.
  • Keeps protected stacks fixed while sorting and follows one compatible stack when it moves or survives a merge inside the player inventory.
  • Clears a stack's protection and target after that whole stack is manually transferred to a chest or dropped into the world; partial moves keep the protected remainder.
  • Prunes older orphaned targets before a storage hotkey action, so an item you no longer carry does not keep reporting target item missing.
• Storage-aware build and craft requirements
  • Separately controls storage-backed crafting, storage-backed building, and visibility of base-wide storage totals; all three options default to on.
  • When enabled for an action, counts and consumes exact costs from the player plus accessible vanilla chests in the active storage scope, regardless of current network ownership.
  • Independently shows selected build-piece, crafting, and upgrade costs as required / total available, including selected upgrade quality and multi-craft totals.
  • Affordability and red/white flashing always follow what the action may actually consume: player-held materials when its storage permission is off, or combined player-plus-storage stock when it is on.
  • Adaptively fits longer exact crafting and building totals such as 45 / 172 and 999 / 999 inside the vanilla amount label instead of clipping the final digits; short totals retain the normal font size.
  • Handles quality-specific and multi-craft quantities without consuming whole stacks or charging duplicate costs twice.
  • Uses the player inventory first, then chooses only the minimum distinct chest set needed by the complete action plan.
• Expedition kits from the build menu
  • Hold the configured storage-action modifier (Left Alt by default) and click a build piece to move one complete copy of that piece's recipe from eligible storage into your inventory.
  • Keeps the build menu open and leaves ordinary clicks unchanged.
  • Treats every modified click as one full additional kit; materials you already carry never reduce the requested quantities.
  • Draws each ingredient from the chest holding the largest total stock first, then smaller sources, with deterministic tie-breaking.
  • Moves nothing unless the complete recipe is available, every required chest remains safe and accessible, all resulting stacks fit, and the added weight stays within carry capacity.
• Safety
  • Reads nearby build and craft totals without claiming chest ownership.
  • Requests ownership only for required chests, then rechecks active-scope membership, access, ownership, chest use, serialized revision, stack identity, and quantity before removal.
  • Withdraws exact quantities and rolls back completed steps if a later removal fails.
  • Cancels before consuming anything and shows The required materials are currently in use when a required chest is busy.
  • Keeps only ownership demonstrably acquired and used by a successful build on a 30-second sliding lease, yielding immediately when another player manually opens that chest.
  • Ends logical in-use reservations before releasing matching ownership. If exact same-client cleanup fails transiently, it is retained and retried before that ownership can be relinquished, including during disable and hot unload; later or unrelated owners are never cleared.
  • Never mutates inaccessible, unknown, unsupported, or actively used containers.
  • Shows compact totals, shortages, meaningful skips, and incomplete-search notices.
  • Disables all item-changing behavior if its runtime compatibility checks fail.

Controls

• Open inventory: Sort movable player slots when the player-inventory Auto-sort checkbox is enabled. An opened vanilla chest follows its own Auto-sort chest checkbox on both open and close.
• Left Alt + left-click an unprotected item: Protect it immediately with no restocking target and no dialog.
• Left Alt + left-click any protected item: Fully unprotect it and clear any restocking target immediately.
• Left Alt + right-click a stackable item: Open the restocking quantity dialog. Confirming protects the item and adds or edits its target; canceling preserves its exact prior protection and target state.
• Left Alt + right-click a non-stackable item: Leave its protection state unchanged; non-stackable items cannot have restocking targets.
• Ordinary inventory clicks: Keep Valheim's normal left- and right-click behavior.
• Left Alt + E while targeting a vanilla container: Deposit matching items and replenish protected targets.
• Left Alt + E while a vanilla chest is open: Run the same action using that chest as the target without closing it.
• Left Alt-click a build piece in the build menu: Withdraw one complete expedition kit for that piece from eligible storage without closing the menu. If the configured storage-action shortcut uses different modifiers, use those modifiers instead.

Version 1.1.5 supports keyboard and mouse. Controller-specific controls are not included yet.

Configuration

Stackmaster has exactly six settings:

1. Auto-sort enabled — on by default and also controlled by the checkbox below the player inventory. Chest auto-sort is controlled separately in each chest UI and is not a seventh global setting.
2. Nearby-storage radius — 20 metres by default; configurable from 1 to 50 metres and used by all chest-powered features only while the player is outside every valid connected workbench mesh.
3. Storage-action keybind — Left Alt + E by default. Its modifier keys also activate protected-item left/right clicks in the player inventory and expedition-kit left-clicks in the build menu; the main E key is not required for either click action.
4. Allow building from storage — on by default and independently controls building eligibility and consumption from storage.
5. Allow crafting from storage — on by default and independently controls crafting/upgrade eligibility and consumption from storage.
6. Show storage amounts in craft and build menus — on by default; independently shows player-plus-eligible-storage totals in both requirement UIs without granting permission to consume those stored items.

All six global settings are available through the normal r2modman/BepInEx configuration editor after the first launch. Existing building/crafting opt-outs migrate automatically to the renamed permission settings, so an explicit false remains off and the obsolete keys disappear after launch. Per-chest auto-sort choices are local-only preferences scoped to the current player, world, and stable chest identity; a missing or unreadable identity safely skips chest sorting.

Installation

Install with r2modman, Thunderstore Mod Manager, or another Thunderstore-compatible manager. BepInExPack Valheim is installed as a separate dependency; Stackmaster does not bundle BepInEx or Harmony.

For a manual install, install denikson-BepInExPack_Valheim 5.4.2350 or newer, then place Stackmaster.dll in BepInEx/plugins/Stackmaster/.

Compatibility and support

Stackmaster 1.1.5 is compiled from a documented Valheim/Unity/BepInEx/Harmony reference bundle, but exact version strings, file hashes, and assembly MVIDs are provenance and diagnostics—not a runtime allowlist. It supports vanilla containers only. On startup, Stackmaster checks the complete API surface it relies on, including exact overload parameters and every Harmony target, before installing any patch. A missing, changed, or ambiguous contract disables the mod before item-changing hooks are installed; a patching error disables the runtime and removes all Stackmaster patches.

Inside a base, Stackmaster discovers the complete connected union of loaded canonical vanilla workbench build zones using each station's current game-reported build range. Outside a base, the configurable player-centered radius is the fallback. Nearby build/craft totals read stable serialized snapshots from accessible vanilla containers in that active scope without claiming them, including containers owned by another peer. Mutation remains stricter: after player-first allocation, Stackmaster requests ownership only for the minimum required chests, revalidates their owner/data revisions and exact contents, reserves them for the transaction, and cancels before mutation if any required chest is busy, denied, stale, or unavailable. Valheim’s owner-authorized request is asynchronous. Remote-owned building actions use the existing prepared-ownership retry window; chest-backed crafting and expedition-kit clicks instead wait in their client-side coroutines for the exact required ownership and proceed from the original click only after a fresh matching plan and reservations are ready. After a successful chest-backed building placement, only the exact acquired chests actually used remain locally owned on a 30-second sliding lease, renewed by each subsequent successful build use. Crafting and expedition-kit withdrawals release their reservations and exact acquired ownership immediately and never create or renew that lease. A remote player's manual open request immediately invalidates the build lease and continues through vanilla's normal ownership transfer. Every cancellation, failure, rollback, disable, disconnect, logout, unload, shutdown, exception, or unused acquisition releases only ownership Stackmaster can still prove it acquired, with identity, session, owner-revision, and current-owner guards. If exact local reservation cleanup cannot finish immediately, Stackmaster keeps the matching ownership cleanup record and retries the reservation first; it never clears a later or unrelated owner's in-use state.

Plugin GUID: com.jstack424.stackmaster

Source, issue tracker, and MIT license: https://github.com/JStack424/Stackmaster

Development

The repository keeps pure inventory policy separate from Valheim/Unity adapters. The deployable plugin targets .NET Framework 4.8, pure planners target .NET Standard 2.0, and automated tests target .NET 8.

Private compile-time references must come from your own Valheim/BepInEx installation and remain under the ignored lib/local/StackmasterReferences/ directory (or an ignored path override). They are never committed or packaged. On Windows, scripts/Inspect-StackmasterEnvironment.ps1 performs a read-only environment inventory, and scripts/Collect-StackmasterReferences.ps1 copies only the required compile-time assemblies from paths you explicitly provide.

./scripts/build.sh

The build restores locked dependencies, builds Release, runs the pure-domain suite, runs repository safety checks, and rejects copied runtime/game assemblies in plugin output. See the approved behavior contract and implementation/test plan for the full design and release gates.

Changelog

1.1.5

Public release of the live-tested, fail-closed repair for chest-backed crafting transactions.

• Fixed remote crafting so prepared withdrawals are recaptured from each selected owned Container.GetInventory() rather than from detached ZDO inventory snapshots used only for read-only discovery and planning.
• The prepared transaction now requires the live owned-inventory plan to match the original exact plan, reserves and revalidates only selected chests, and rejects any detached inventory identity before removal.
• Centralized the exact withdrawal journal: every observed player or chest mutation is recorded once, exact quantities are required, incomplete debits cannot commit, and cancellation or failure rolls receipts back in reverse order.
• Preserved vanilla charge suppression after Stackmaster's exact debit, so successful remote crafts pay once—not zero times or twice. Storage-disabled and NoCost modes remain vanilla.
• Added regressions for mixed player/chest debit, selected-chest-only mutation, duplicate-charge prevention, incomplete-debit rejection, and exact cancellation/failure rollback.
• Strengthened the pinned Valheim release gate to verify that successful-output crafting still reaches the exact string-based Inventory.RemoveItem overload and Player.ConsumeResources, after the output-add call shape Stackmaster's transaction depends on.
• Live-tested the corrected chest-backed crafting debit in Valheim before promoting this exact gameplay candidate to production.

1.1.4

Harmony-target manifest correction and release-gate hardening with no gameplay or configuration changes. This build supersedes 1.1.3.

• Fixed startup patch preflight for InventoryGui.SetupRequirement(Transform, Requirement, Player, bool, int, int): the compatibility gate correctly validated this Valheim API as static, but the separate patch installer incorrectly searched for an instance method.
• Replaced every duplicated target declaration, including target-bearing patch attributes and the hot-unload cleanup resolver, with one canonical Harmony target manifest consumed by compatibility validation and every installation path. Each descriptor pins the declaring type, exact overload, static/instance shape, return type, patch entrypoints, and whether it belongs to the cleanup-safety subset.
• Added fail-closed Harmony patch-signature validation for original arguments, __instance, __result, __state, __exception, and injected fields before any patch is installed.
• Added the release-gating HarmonyTargetManifestReleaseGate, which resolves all 32 patch operations against the pinned Valheim assemblies and proves PatchInstaller.Prepare() returns those exact resolved MethodInfo objects. Packaging now runs the complete build/test gate itself and refuses to create a ZIP if this check fails.
• Made release binaries byte-reproducible across clean checkout paths by enabling deterministic source paths and requiring the generated Source Link map to use the normalized /_/ root and pinned release revision.
• Runtime identity, version, SHA-256, and MVID remain diagnostic-only. All Stackmaster 1.1.0 gameplay and settings remain unchanged, including the rule that modifier + right-click never clears protection.

1.1.3

Compatibility-gate static-method correction with no gameplay or configuration changes. This build supersedes 1.1.2.

• Corrected four contract declarations that accidentally requested instance methods even though Stackmaster and Valheim expose the APIs statically: ZDOMan.GetSessionID(), GameCamera.InFreeFly(), ZInput.ResetButtonStatus(string), and PrivateArea.CheckAccess(Vector3, float, bool, bool).
• Preserves fail-closed validation for all four APIs. Session identity remains mandatory for ownership and reservation safety; free-fly detection and input reset remain mandatory input guards; ward access remains mandatory before guarded containers can be used.
• Added regressions for each missing API and instance-shaped lookalike, plus pinned metadata checks for the exact static signatures in both assembly_valheim.dll and assembly_utils.dll.
• Runtime identity, version, SHA-256, and MVID remain diagnostic-only. All Stackmaster 1.1.0 gameplay and settings remain unchanged.

1.1.2

Compatibility-gate correction with no gameplay or configuration changes.

• Replaced exact Valheim label, Unity/BepInEx/Harmony version, assembly_valheim SHA-256, and MVID runtime enforcement with a contract-based fail-closed gate.
• Runtime identity values remain diagnostics only; the pinned private-reference hashes remain build provenance and are not a client allowlist.
• Validates every declared dependency in the runtime contract—required types, exact method overloads and parameters, constructors, fields, properties, static/instance shape, Harmony targets, and patch entrypoints—before installing the first patch.
• A missing or ambiguous contract disables Stackmaster before patching. Any Harmony installation failure fully disables the runtime and removes all patches installed under Stackmaster's Harmony ID.
• Added focused executable/static tests proving differing identity metadata is accepted when contracts match, exact-version constants are absent from the runtime gate, required contracts are covered, and missing or ambiguous members fail closed.
• Preserves the 1.1.0 gameplay, settings, networking, ownership, reservation, and persistence behavior exactly.

1.1.1

Release package prepared with the exact DLL bytes supplied for live validation.

• Revalidated the unchanged 1.1.0 gameplay and configuration against Valheim 1.0.14, anonymous Steam dedicated-server build 25364309, and Unity 6000.0.75f1.
• Updated the fail-closed Valheim assembly fingerprint and private reference bundle.
• Added deterministic private-reference fingerprint validation plus 84 independent metadata/IL compatibility checks, including exact left-click/right-click inventory routing.
• No gameplay behavior, settings, networking, ownership, reservation, or persistence semantics changed.

1.1.0

Public release, preserving the live-validated 1.1.0 behavior without gameplay or configuration changes.

• Replaced the former all-in-one protected-item modifier-click prompt with separate mouse controls using the configured storage-action modifier (Left Alt by default).
• Modifier + left-click now toggles protection immediately with no dialog: an unprotected item becomes protection-only, while any protected item is fully unprotected and loses its target in one click.
• Modifier + right-click now opens the restocking quantity dialog for stackable items. Confirming protects the item and adds or edits its target; canceling or entering an invalid quantity preserves the prior state exactly.
• Non-stackable items remain protection-only: modifier + right-click is consumed without changing their state. All unmodified inventory clicks remain vanilla.
• Added an expedition-kit shortcut to the active build-piece menu: hold the configured storage-action modifier (Left Alt by default) and click a piece to withdraw one complete copy of its recipe from eligible storage into the player inventory while keeping the menu open.
• Every modified click requests a fresh full kit and intentionally ignores materials already carried by the player.
• For each ingredient, withdraws from the eligible chest holding the largest total stock first, then smaller sources, with deterministic tie-breaking.
• Preflights the complete kit against exact inventory slots and added carry weight before requesting any chest ownership.
• Replans from fresh storage after asynchronous ownership acquisition, requires an identical plan, reserves and revalidates every required chest, then performs exact source-to-destination moves.
• Cancels without moving anything on shortage, access or ownership changes, busy storage, stale contents, insufficient slots, or insufficient carry capacity. Late transfer failures roll back completed moves before guarded ownership cleanup.
• Emergency snapshot rollback restores the original player item objects and their complete captured state, preserving every equipped-item reference; chest snapshots remain detached.
• A failed exact local in-use cleanup is retained and retried before Stackmaster may relinquish its matching ownership acquisition, including disable and hot-unload paths, without clearing later or unrelated owners' state.
• Logging out now performs a recoverable session teardown rather than permanently disabling Stackmaster for the remaining Valheim process. Joining a new server session rearms every feature without requiring a game restart.
• Reconnect rearming is fail-closed: rollback and reservation-before-ownership cleanup must complete successfully, the network-session object must change, permanent compatibility failures stay disabled, and stale coroutines are generation-isolated from later sessions.
• Chest-backed crafting is now one click: Stackmaster captures the exact recipe/upgrade/variant/multi-craft intent, acquires only the minimum required chest set before starting vanilla crafting, marks every selected chest in use, and resumes that original intent automatically.
• Ownership waiting no longer starts a disposable progress bar. The normal vanilla craft duration and animation begin exactly once, only after every required chest is reserved, and the atomic withdrawal occurs only when vanilla reaches DoCrafting.
• Craft cancel, recipe or tab changes, inventory close, scope/station changes, failed validation, exceptions, timeout, disable, disconnect, and shutdown immediately clear reservations and release only exact proven Stackmaster acquisitions; delayed callbacks are generation- and session-isolated.
• Uses the existing configured shortcut modifier, connected-workbench/fallback storage scope, vanilla ownership handshake, and access/in-use protections without Jötunn, custom RPCs, server data, or networking.
• Ordinary build-piece clicks, the existing 30-second chest-backed building lease, and all existing features remain unchanged.
• Final automated verification passes with zero compiler warnings/errors, 133/133 pure-domain tests, and 65/65 static/repository safety checks. In-game validation passed; broader multiplayer, dedicated-server, workbench-extension, and load/unload edge-case testing remains incomplete.

1.0.0

Public release, preserving the live-validated 0.4.2 behavior without gameplay or configuration changes.

• Added independent, default-on controls for storage-backed crafting, storage-backed building, and aggregate storage totals in crafting, upgrade, and building requirement rows.
• Preserved explicit legacy building/crafting opt-outs through one-time migration to the renamed settings.
• Added adaptive exact requirement totals for longer values such as 45 / 172, with affordability and flashing tied to the resources the active action is actually allowed to consume.
• Added a guarded 30-second sliding ownership lease for successful chest-backed building, with immediate remote manual-access preemption and immediate cleanup across every non-success lifecycle path.
• Fixed full-stack chest transfers and world drops leaving stale protected-item targets; partial transfers and internal player-inventory moves continue to retain protection.
• Pruned orphaned target records before storage actions so removed items no longer produce stale target item missing shortages.
• Final verification passes with zero compiler warnings/errors, 99/99 pure-domain tests, and 57/57 static/repository safety checks.
• In-game validation passed. Broader multiplayer, dedicated-server, workbench-extension, and load/unload edge-case testing remains incomplete.

0.4.2

Development-only build; not published.

• Split nearby-resource behavior into three independent, default-on settings: Allow crafting from storage, Allow building from storage, and Show storage amounts in craft and build menus.
• Existing Enable building from nearby chests and Enable crafting from nearby chests choices migrate once to the renamed permissions; explicit opt-outs remain off, and obsolete keys are removed from the saved configuration.
• Storage totals can now remain visible as exact required / total available values in crafting, upgrade, and building rows even when the corresponding action is restricted to player-held materials.
• Requirement affordability and red/white flashing now follow actual action permission on both code paths: player-only stock when that action's storage permission is off, aggregate player-plus-eligible-storage stock when it is on.
• Turning storage totals off preserves vanilla count text and typography while storage-backed crafting or building can remain enabled independently; turning both display and the relevant permission off leaves that requirement UI untouched.
• Preserved the connected-workbench mesh / fallback scope, exact aggregate accounting, adaptive long requirement-count fit, independent crafting/building consumption paths, and all 0.4.1 ownership and protected-item cleanup behavior.
• Automated tests cover all eight combinations of the three new booleans across both crafting and building UI decisions. Live in-game validation remains pending.

0.4.1

Development-only build; not published.

• Added a 30-second sliding Valheim ownership lease after a successful chest-backed building placement. Only exact chests Stackmaster demonstrably acquired and actually used are retained, and each successful build use renews that chest's lease.
• Logical in-use reservations still end immediately after the atomic transaction; crafting behavior is unchanged and does not retain the new build lease.
• A remote player's manual chest-open request immediately invalidates an idle retained build lease and continues through Valheim's normal request and ownership-transfer path. The local owner's own manual access remains available and does not invalidate the lease.
• Lease expiry returns the exact tracked chest to Valheim owner 0 only while identity, local session, current owner, and successor owner-revision guards still prove it is the ownership Stackmaster acquired.
• Cancellation, failure, rollback, partial or unused acquisition, disable, disconnect, logout, scene unload, shutdown, hot unload, compatibility disable, and exceptions preserve immediate guarded cleanup. Unrelated, merely inspected, already-local, or non-acquired chests are never retained or released.
• Preserved exact nearby-resource accounting, minimum mutated-chest planning, connected-workbench/20 m fallback scope, chest auto-sort opt-outs, and the exact busy message The required materials are currently in use.
• Crafting and upgrade requirement labels now keep every digit visible by using the normal vanilla font size when it fits and bounded TextMeshPro auto-sizing for longer exact totals such as 45 / 172 and 999 / 999; pooled rows and disabled/fail-open paths restore their original typography.
• Manually transferring a whole protected/targeted stack into a chest or dropping it into the world now clears that stack's protection immediately. Partial external moves retain the protected remainder, while moves and merges wholly inside the player inventory keep existing item-following behavior.
• Storage hotkey planning now prunes older orphaned target records that cannot resolve any compatible player-inventory item, preventing stale target item missing shortage notices without disturbing valid moved targets.
• Automated verification passes with zero build warnings/errors, 95 pure-domain tests, and 55 static/repository safety checks.
• The ownership-lease change has not yet been independently tested in multiplayer, on dedicated servers, with workbench extensions, or across broader load/unload topologies.

0.4.0

Public release.

• Added one uniform storage scope for auto-deposit, protected-stack replenishment, building, and crafting.
• While the player is inside a valid vanilla workbench build zone, Stackmaster now searches the complete connected graph of overlapping loaded workbench zones and treats their exact union as one base mesh.
• Chests inside the connected mesh are eligible throughout the base; nearby chests outside that mesh are excluded.
• While the player is outside every valid workbench mesh, all four chest-powered features use the existing configurable player-centered fallback radius (20 metres by default).
• Preserved targeted-chest-first then nearest-to-player routing, exact minimum-chest build/craft planning, loaded-only discovery, and read-only planning before ownership.
• The per-chest Auto-sort chest checkbox still controls sorting only; disabled, manually organized chests remain fully eligible for every chest-powered feature.
• Added one fresh immutable scope snapshot per mutation phase plus topology-aware HUD/resource caching. A connected mesh is never silently truncated by the ordinary nearby-action inspection budget.
• Added fail-closed compatibility checks for the current workbench instances, build-range, prefab-identity, and ZDO APIs used by the mesh resolver.
• Automated verification passes with zero build warnings/errors, 78 pure-domain tests, and 51 static/repository safety checks.
• Core connected-workbench storage behavior has been live-tested in Valheim. Multiplayer behavior, dedicated-server behavior, workbench extensions, and broader load/unload edge cases have not yet been independently verified.

0.3.0

• Added an Auto-sort chest checkbox beneath supported opened vanilla chests.
• Each chest defaults to enabled and remembers its choice locally per player, world, and stable chest identity. The preference is never written to shared ZDO/world state and cannot affect another player.
• Enabled chests sort on both UI open and UI close, so removing items no longer requires reopening the chest to restore order.
• Disabling one chest takes effect immediately without disabling player-inventory sorting or changing deposit, replenishment, nearby build/craft, or manual organization behavior.
• Chest sorting fails safely when stable identity, local preference storage, ownership, or inventory access is unavailable.
• Automated verification passes with zero build warnings/errors, 64 pure-domain tests, and 50 static/repository safety checks.

0.2.2

• Updated the README for clarity and readability. No gameplay changes.

0.2.1

Early public testing release.

Version 0.2.1 reissues the approved nearby-resource release under a fresh Thunderstore version number so package managers can distinguish it from an earlier 0.2.0 upload. There are no gameplay changes from the approved build.

Added

• Added independently switchable building and crafting from eligible nearby vanilla chests; both settings default to on and use the existing configurable nearby-storage radius.
• Added exact all-or-nothing material planning across the player inventory and nearby chest stacks, including duplicate-requirement normalization, quality-specific ingredients, and multi-craft quantities.
• Added required / total available material rows for selected build pieces and crafting or upgrade menus at workbenches, forges, cauldrons, and equivalent stations.
• Added aggregate shortage coloring: satisfied combined stock stays white, while true shortages retain red flashing.

Changed

• Material withdrawals now use the player inventory first, then select only the minimum distinct chest set required by the complete plan.
• Display-only scans read stable serialized snapshots from accessible vanilla chests regardless of current network owner and never request ownership.
• Remotely owned actions use Valheim's owner-authorized asynchronous handoff. The first attempt consumes nothing while ownership is prepared and prompts one normal retry; the second attempt performs fresh validation before any withdrawal.
• Ownership prepared by Stackmaster gets a 10-second retry window. Cleanup then returns it to Valheim's native unowned state after success, cancellation, validation failure, rollback, timeout, disable, or disconnect, and retries later rather than releasing ownership it can no longer prove it acquired.

Safety and fixes

• Revalidates container identity, access, distance, use state, owner revision, serialized data revision, stack identity, quality, world level, and quantity before mutation.
• Briefly reserves only required chests during the synchronous transaction, withdraws exact quantities, and rolls back completed removals if any later step fails.
• Cancels the whole action without partial consumption when any required chest is busy, denied, stale, changed, inaccessible, or out of range.
• Fixed remote ownership outliving build, craft, or Left Alt + E actions and blocking vanilla peers after the modded player disconnected.
• Fixed detached serialized chest items being omitted from totals by hydrating their item metadata from resolved prefabs; any incomplete chest snapshot is rejected as a whole.
• Fixed nearby-resource UI failures interrupting vanilla chest, build, or crafting interfaces; these paths now fail open to vanilla behavior.
• Fixed crafting requirement overlays for Valheim's current static requirement-row method.

Testing status

• Release build passes with zero warnings and zero errors.
• 61/61 domain tests and 48/48 static/repository safety checks pass.
• Initial live testing passed, including the corrected ownership cleanup behavior.
• The full co-op host, co-op guest, and unmodded dedicated-server matrix remains in progress; this release does not claim proven multiplayer safety.

0.1.0

Initial public testing release.

• Added automatic alphabetical sorting for movable player-inventory slots and opened vanilla containers.
• Added protected stacks with optional replenishment targets.
• Added one configurable nearby-storage action for matching-item deposits and loadout replenishment.
• Added targeted-container-first, partial-stack-first, nearest-to-farthest routing.
• Added compact visual result feedback and a fail-closed runtime compatibility gate.
• Added exactly three settings: auto-sort, nearby-storage radius, and storage-action keybind.
• Passed automated domain/repository checks and solo smoke testing.
• Co-op host, co-op guest, and unmodded dedicated-server testing remain in progress; this release does not claim proven multiplayer safety.