SargamAutoStore

Smart auto-sorting. Built for performance.

Drop items near your storage and let SargamAutoStore sort them. It fills existing stacks first, follows matching chest signs, and sends new item types to chests you choose. Each destination glows so you can see where items went, and protected items stay out.

0.2.7 preview — description-only update; behavior is unchanged from 0.2.5, 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.

Action	Shortcut or chat command
Show all commands	/sas help
Force a ground-item sweep	F8 or /sas ground
Store inventory with default protections	F9 or /sas inventory
Include hotbar items; other protections still apply	/sas inventory all
Toggle a chest for new types	Left Alt+N
Designate or remove the looked-at chest	/sas newchest add or /sas newchest remove
List loaded, accessible designated chests	/sas newchest list
Block or unblock every stack of an item type	Ctrl+Alt+click the inventory item
Block or unblock by name or exact prefab	/sas block Wood or /sas unblock Wood
List item protections	/sas blocked
Pause or resume automatic collection	/sas pause or /sas resume
Use contents and designated chests, ignoring signs	/sas mode content
Restore contents → signs → designated chests	/sas mode hybrid
Show diagnostics and latest transfer	/sas status
Reload configuration	/sas reload

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.

Chat command	Meaning and accepted range
/sas_range items 32	Ground items around you: 1–256 m; default 32 m
/sas_range chests 10	Chests around each item source, or you for F9: 1–256 m; default 10 m
/sas_range signs 3	Sign association around a chest: 0.2–8 m; default 3 m
/sas_range status	Show saved distances and selected origin
/sas_range debug on or /sas_range debug off	Show guides for 90 seconds or hide them
/sas_range origin item	Aim at a ground item before opening chat to preview its chest-search radius
/sas_range origin player	Preview the player-centered F9 chest-search radius

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. Version 0.2.7 changes the listing copy only; these results are from 0.2.5.

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.