HearthSort

Simple chest sorting for shared storage.

Teach your storage chests what belongs in them, drop your loot into a distributor chest, and close it. HearthSort moves matching items into nearby storage.

HearthSort provides a small native chest UI and a clear sorting workflow, plus an optional bird transformation for exploring. Keep using your preferred mods for crafting, building, and the rest of your base.

How it works

1. Teach a storage chest. Put an example item into an ordinary chest. That chest remembers the item type, even after you empty it.
2. Choose your drop-off chest. Open a supported chest, click Chest rules beside its header, and enable Use as distributor. F8 also opens the settings while the chest is open.
3. Drop off your loot and close the chest. Matching items move to the closest eligible nearby storage. Items without a destination, or without available space, stay in the distributor.

To teach already-filled storage, take an example stack out and put it back. Native manual quick-stack also teaches receiving chests. Other mods' acceptance lists are not imported.

A small, readable rules list

The inset list uses Valheim's native fonts, controls, panel material, and real item icons. Scroll with your mousewheel or the scrollbar; controller navigation is also supported.

• Checkbox: enable or pause acceptance. A paused entry stays saved, and depositing another example does not turn it back on.
• X: forget the item and remove its row completely. Items already stored in the chest stay there. A new manual deposit can teach it again.
• Esc / controller Back: close the panel.

Shared chests only

HearthSort supports public wooden, reinforced, and black metal chests, plus modded storage furniture built with Valheim's standard networked Container and Piece components. This includes Quartermaster's resource bins and racks; no Quartermaster dependency or per-mod chest list is needed. Newly supported furniture learns HearthSort rules from manual deposits, just like ordinary chests. Existing rules from other mods are not imported.

Personal Chests are excluded for everyone, including their owners. They cannot distribute or receive items, learn HearthSort rules, or show its settings. Rules saved by an older version are ignored.

Normal ward access still applies. Wagons, graves, ship holds, private or group-restricted storage, and temporary loot containers are excluded. Supported furniture must have its own network identity and ordinary serialized inventory. Mods using a separate inventory system, custom access rules or additional item restrictions may require explicit integration; component-based discovery does not reproduce those rules.

Focused sorting

Sorting is requested when you close a distributor. Supported chests register as they load, and nearby destinations are found through a chest-only spatial index. There is no recurring scene-wide entity search or idle base inventory scan. Ward permission checks also inspect nearby world records; ward sizes are cached from prefab definitions.

Transfers use bounded batches. Full, busy, or unavailable chests leave leftovers in the distributor; closing it again requests another attempt. The server coordinates ownership and synchronization, and serialized item metadata is preserved during movement. Items with different metadata stay separate.

Close requests briefly retry while the native chest-busy flag clears. If a committed batch takes more than eight seconds to synchronize, its two chests remain protected and retry in the background while unrelated distributors can continue. The server can republish the committed contents above a stale owner's revision without repeating the item movement. Up to eight pairs can recover at once; additional sorting waits when that limit is reached. A pair still cannot unlock until its connected owners synchronize, or disconnect. Unresponsive owners and unexpected inventory changes are logged rather than resolved by discarding a lock or overwriting uncertain contents.

This design aims to keep sorting work focused. Live performance gains have not been benchmarked.

Bird form

Every player can choose Bird form from the native G radial menu. Press Jump to take off, aim to steer, hold Sprint to fly faster, and descend or press Crouch to approach a landing. Flight always moves forward, builds momentum, slows during climbs and speeds up during dives, with a hard speed limit and a compact solid bird collider. Choose Return to Viking to change back.

The Flight energy bar above stamina holds 100 energy: 15 seconds of normal flight, or about 13 seconds while sprinting. It refills from empty in 60 seconds while human or grounded as a bird. Only flight drains it; sprint drains 15% faster. Empty energy automatically restores human form and normal gravity. Energy remains through toggles and character saves.

Other players see the bird with overhead player names and healthbars hidden. See docs/BIRD-FORM.md for full controls and behavior.

The energy bar shows only the remaining percentage and appears only in bird form when energy is below 100. It stays hidden in human form and at full charge while recharge continues normally.

Install

Version: 0.1.14 beta. Built against Valheim 1.0.17.

Install with Thunderstore Mod Manager or r2modman. The package declares these required dependencies:

• BepInExPack Valheim 5.4.2351
• Jotunn 2.30.2

Install the same HearthSort version on the server and every client. Jotunn enforces matching patch versions. Use matching item mods too; unknown items stop a transfer with contents retained.

For manual installation, close the game and copy the ZIP's BepInEx folder into your game or selected profile folder. The DLL should land at BepInEx/plugins/HearthSort/HearthSort.dll. For a dedicated server, use its folder containing BepInEx.

When switching from a local/manual build to a mod-manager package, remove the old HearthSort DLL first so only one copy is installed. Removing the DLL leaves ordinary chests and their contents usable; unused HearthSort rule data remains in the world.

Other mods, including Quartermaster

Quartermaster may stay installed and enabled. Turn off its deposit/distributor routing and automatic chest sorting for chests managed by HearthSort, using Quartermaster's own controls.

HearthSort does not depend on Quartermaster, read or change its settings, or include its other features. Prepared chests report the standard busy signal so inventory consumers that honor it can yield during a transfer. Mods that directly mutate a busy inventory can still conflict. Combined Quartermaster multiplayer gameplay has not yet been verified.

Configuration

BepInEx/config/cheyenne.hearthsort.cfg

Setting	Default	Behavior
Sorting.Range	20	Maximum chest-to-chest distance in metres, measured in 3D. Allowed range: 5–50.

The server controls the range. Restart after changing it.

Beta status

The native UI has been confirmed in-game. Automated checks cover rule persistence, transfer conservation, metadata handling, ownership protocol transitions, and installed-game contracts. A live two-client dedicated-server session and the latest integration changes still need verification. Try the beta on a copy of your world before relying on it for shared storage.

Detailed validation and build notes are included in the ZIP's docs folder. To confirm startup, check BepInEx/LogOutput.log for:

Hearth Sort 0.1.14 loaded; all 24 chest, UI and ownership patch targets verified.