ValheimAutoSort

Sorts nearby chests on keybind (Alt+R). Spatial ordering, fill-first tagged chests, stack consolidation, safe overflow handling, ground-item duplication fix. Multiplayer compatible.

This mod requires the following mods to function

denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.

Preferred version: 5.4.2202

README

ValheimAutoSort v2.4.0

Sorts nearby chests on demand with a single keypress. Chests infer their own category from their contents; you can pin a category permanently with the catagory dropdown inside in-game containers. Multiplayer compatible via ZDO sync.

Features

Feature	Detail
Keybind sort	Press Alt+R (configurable) to sort all chests within `ScanRadius`
Spatial ordering	Chests filled in reading order (top-left → right, then down); same-category chests grouped together
Fill-first tagged	Tagged chests of the same category fill completely before spilling to the next
Category inference	Chest dominated by Wood items "owns" Wood — no setup needed
Tag override	`autosort_tag Wood` while looking at a chest pins it to Wood permanently
Ground suction	Dropped items on the ground are periodically pulled into matching chests
Hover tooltip	Shows chest category, tagged/inferred, and the sort keybind reminder
Visual effects	Blue highlight + particle VFX on sorted chests (configurable)
Multiplayer	`MoveItemToThis` + ZDO dirty-mark; no server plugin required

Configuration

Config file location after first launch:

BepInEx/config/com.yourname.valheim.autosort.cfg

Editable in-game via r2modman config editor or any text editor.

1 — General

Key	Default	Description
`ModEnabled`	`true`	Master switch. Disables everything without uninstalling.
`LogDebug`	`false`	Verbose BepInEx console logging for troubleshooting.

2 — Chest Tagging

Key	Default	Description
`EnableTagOverride`	`true`	Allow `autosort_tag <Category>` to pin chests. Requires relogging to affect existing chests if changed mid-session.

3 — Sort Pass

Key	Default	Range	Description
`SortKeybind`	`Alt+R`	Any key combo	Keyboard shortcut that triggers a full sort. Configurable via r2modman.
`ScanRadius`	`16`	4 – 64 m	Radius around the player within which chests are included in a sort pass.

4 — Ground Items

Key	Default	Range	Description
`EnableGroundSuck`	`true`	—	Pull ground items into matching chests periodically.
`GroundSuckRadius`	`8`	2 – 32 m	Radius around the player to search for ground items. Independent of `ScanRadius`.
`GroundSuckInterval`	`5`	1 – 60 s	Seconds between ground scans. Lower = more responsive, slightly more CPU.

5 — Effects

Key	Default	Description
`HighlightContainers`	`true`	Flash chests blue when items are sorted into them.
`PingContainers`	`true`	Spawn a particle VFX at sorted chests.
`PingVFX`	`vfx_Potion_health_medium`	VFX prefab name. Leave blank to disable. Browse prefabs

Usage

Basic (zero setup)

Build chests near each other and put a different type of item in each. After a few deposits the mod infers each chest's category. Press Alt+R whenever you want items redistributed.

Tagging a chest manually

Look at the chest, open console (F5):

autosort_tag Stone

Valid categories (case-insensitive):

Stone, Wood, Metal, Ore, Gem, Leather, Bone, Fiber, Seed,
Food, Potion, Fish, Arrow, Weapon, Shield, Armor, Tool,
Magic, Trophy, Furniture, Misc

Clear a tag:

autosort_tag

How It Works

Player presses Alt+R
        │
        ▼
Patch_Player_Update detects SortKeybind.IsDown()
  (blocked if inventory / map / store GUI is open)
        │
        ▼
SortEngine.TriggerSortPass()
  ├─ Sets IsRearrangingItem = true   (blocks all AddItem callbacks)
  ├─ Yields one frame
  │
  └─ DoSort(playerPosition)
        ├─ ChestOwnershipResolver.Resolve()
        │     ├─ Tagged chests   → pinned category, priority 1
        │     │     └─ Multiple tagged of same category: rightmost first
        │     └─ Inferred chests → dominant item category, priority 2
        │
        ├─ ChestOwnershipResolver.PlanSortFull()
        │     ├─ SortInferredByPosition()
        │     │     ├─ Pass 1: reading order (top-left → right, then down)
        │     │     ├─ Pass 2: find each category's earliest spatial anchor
        │     │     └─ Pass 3: cluster same-category chests at their anchor
        │     │
        │     └─ FindDest() priority chain (mirrors single-item path):
        │           1. Tagged chest (rightmost first, fill before spilling)
        │           2. Inferred chest already holding this item (consolidate)
        │           3. Any inferred chest for this category (spatial order)
        │           4. Free/unclaimed chest (spatially earliest)
        │
        ├─ Execute moves (deferred removal to avoid HashSet mutation crash)
        │
        ├─ PackInventorySlots() for each dirty chest
        │
        ├─ MarkDirty() ONCE per modified chest  (ZDO write)
        │
        └─ Re-read live inventory → notify player of any homeless categories

Last updated	2 days ago
Total downloads	100
Total rating	0
Categories	Mods Tweaks Misc Tools Server-side
Dependency string	tubbbusz-ValheimAutoSort-2.4.0
Dependants	0 other packages depend on this package

Get the Thunderstore App