SargamAutoStore

Drop items near your storage and let SargamAutoStore put them away. Chests that receive items briefly glow green. Keep control with item protection, designated chests for new items, and commands in normal game chat.

0.2.5 preview — tested locally with Valheim 1.0.15 and BepInEx 5.4.23.5. Multiplayer validation is still pending. English is the official language of the mod; localized item names and your sign text remain supported.

Install

Install SargamAutoStore using your Valheim mod manager. Its BepInEx dependency is installed automatically. Restart Valheim after installing or updating.

Disable AzuAutoStore and aedenthorn's AutoStore first. SargamAutoStore declares both incompatible. Disable other automatic storage mods too, so multiple collectors do not compete for the same items. Keep a backup of your world and character when changing your mod setup.

For multiplayer cooperative ownership, install the same SargamAutoStore version on the server and participating clients. Collection runs near players who have the mod; a dedicated server without a local player only handles ownership requests. A missing remote component can leave items waiting at their source. There is no global version handshake or automatic configuration synchronization. If a server requires a different AutoStore mod, coordinate the change with its administrator.

How items choose a chest

Among loaded, accessible chests with room, the priority is:

1. Existing contents. Chests already containing that item type, with compatible partial stacks preferred before distance.
2. Matching sign. Sign text matching part of the item's name, such as ore, helm, or wood. Matching ignores case and accents. For example, wood matches FineWood too.
3. Designated chest for new types. An explicit destination for items not recognized by the first two rules. Multiple chests can be designated; the nearest eligible one wins.

To designate a chest, close it, look at it from within 8 m, and press Left Alt+N. Press again to remove that chest's designation. On Mac, Alt is Option. Close chat and menus first. If the chest is owned by another peer, open and close it normally, then try again.

By default, each chest uses its nearest valid sign above it within 3 m, allowing a sign to label the group below it. Use Wood, Stone for alternative labels. A nonmatching sign never overrides existing contents or an explicit designation.

Automatic collection is on by default and retries items that cannot yet be stored. New types need a matching sign or a designated chest; arbitrary empty chests are not fallback destinations by default. Existing configuration choices survive updates.

Storage feedback

Completed transfers appear in the top-left pickup notification area and the game's message history: SargamAutoStore: Stored 7 Wood (ground; existing contents). Each summary identifies the item, quantity, source and route. Rapid transfers are grouped, at most once every two seconds, with up to three item names plus an overflow total. Concise errors appear there too, at most once every five seconds; full exception details remain in BepInEx/LogOutput.log.

Feedback.ShowHudTransfers and Feedback.ShowHudErrors are enabled by default and can be switched off independently in the mod configuration. Detailed per-transfer file logging is controlled separately by Feedback.LogTransfers.

Controls

Press Enter to open normal chat. Commands below include /; the F5 console is not required.

F9 keeps the hotbar, equipped items, food, and potions by default. Quest items are always protected. Explicit type blocks apply to ground items, F8, F9, and inventory all. Food and potions deliberately dropped on the ground may be collected unless their type is blocked. Forced collection respects protections, access, range, and routing.

Ranges

Use /sas help range for instructions. Range changes save immediately and briefly display all three guides through walls and terrain.

Cyan: ground-item range. Yellow: chest range for the selected source. Purple: sign range around the selected chest, or a labeled preview around you until a chest is selected. Guides illustrate distance; they do not grant access or promise available space. Larger ranges search only loaded objects and may increase work in dense areas.

If an item stays on the ground

1. Run /sas status; use /sas resume if collection is paused.
2. Check /sas blocked and whether the destination already contains the exact type. Wood and FineWood are distinct types.
3. For a new type, add a matching sign or designate a chest with Alt+N.
4. Check both item and chest ranges, free capacity, and whether another player has the chest open. Ward/private access restrictions still apply.
5. In multiplayer, verify the matching version on all participating peers and the server. Collection waits for authorized ownership; it does not steal control.

Only fixed, player-built chests are destinations. Tombstones, world loot, boats, carts, backpacks, and containers with an external root object are excluded. Decorations, live fish, and items stuck in tar are not collected. If initialization failed, check your mod manager's BepInEx log for incompatible mods or an unsupported game update.

Validation and limits

Developed with AI assistance. Version 0.2.5 passed 384 local automated tests, 15 API checks against the installed game, and 24 native Unity checks, including native storage/error notifications. Counted in-game tests covered routing, retry, metadata, rollback, FineWood/LeatherScraps/BombOoze, and 1,000 dropped items with 200 chests, including independent native ZDO readback. Inventory analysis matched the reference for all 1,519 loaded item types in six scenarios each; this is not a transfer test of every prefab. Candidate-query microbenchmarks ran inside Valheim/Mono; they are not FPS guarantees. Multiplayer and Windows/Linux runtime trials remain pending.

Work is spread across frames using an item limit and a cooperative time budget. A single game call may exceed that budget. Crashes between saves, disconnects, conflicting mods, and external save corruption are not guaranteed loss-free. Report the game/mod versions and reproduction steps when describing a problem; remove private session details from any shared diagnostic material.

Changelog

1.0.0

• Show receipt highlights on up to 64 destinations at once, preserving bounded updates, expiry and native/other-mod color ownership.
• Expand the gameplay demo to ground collection and inventory deposits across dozens of chests, with separately measured local workload results.
• Add an optional NewtCraftHub recommendation for crafting and base quality-of-life features.
• Retain the per-release ZIP timestamp safeguard introduced in 0.2.9.

0.2.9

• Fix stale BepInEx loading-version metadata after upgrades. Previous packages reused the same DLL modification time, allowing the loader to report 0.2.5 while the running plugin reported 0.2.8.
• Give each release a distinct, reproducible archive timestamp so existing loader caches refresh on update. Storage behavior is unchanged.

0.2.8

• Reorganize the English page around a first transfer, routing examples, protections and practical controls.
• Add a branded banner and real gameplay captures of existing-content, sign and designated-chest routing. The animated sequence has edited timing.
• Add a public support link and a structured issue-report form.
• Keep the approved short description and existing storage behavior.

0.2.7

• Shorten the mod-manager description to: "Smart auto-sorting. Built for performance." No gameplay changes.

0.2.6

• Rewrite the Thunderstore introduction to lead with automatic sorting, existing-stack priority, sign routing, chosen destinations for new item types, destination glow, and item protection. No behavior changes from 0.2.5.

0.2.5

• Show item quantities, source and destination route in the native top-left pickup area and message history after completed transfers.

• Add concise error notifications; aggregate rapid transfers every two seconds and throttle errors to five seconds. Both HUD options default on and remain independent of detailed file logging.

• Reduce repeated inventory scans when choosing destination chests.

• Avoid unnecessary item-identity and metadata work for full stacks.

• Preserve routing priority, protections, metadata, retries and transaction checks.

• Validate in native Valheim/Mono with 24 checks, including counted 1000-drop / 200-chest loads, the previously reported FineWood/LeatherScraps/BombOoze cases, and analysis parity for all 1,519 loaded item types.

• 384 automated tests and 15 installed-game API checks passed. Catalog analysis is not a transfer test of every item; multiplayer and Windows/Linux runtime validation remain pending.

0.2.4

• Initial Thunderstore package with an original icon and English documentation.
• Automatically collect nearby ground items, retrying items that cannot yet be stored.
• Route by existing contents, then matching sign text, then designated chests for new types.
• Add Alt+N chest designation, persistent item-type blocks, and inventory consumable protection.
• Show a green glow only on chests that actually receive items.
• Provide /sas help and range controls through normal chat.
• Support item/chest radii of 1–256 m and sign radii of 0.2–8 m, with three temporary guides visible through walls.
• Bound scheduler work and adapt spatial queries to avoid scanning large empty cell volumes.
• Preview: local game validation completed for selected scenarios; multiplayer, full-catalog, and large-load performance validation remain pending.