ChestSorter

ChestSorter

Tag your chests with categories ("Wood", "Ores & Metals", "Food: Meals

(Health)"...). After that, one click empties a messy chest into the right

chests around your base.

Client-side only. The server and other players don't need the mod.

Installation

With a mod manager (recommended): install ChestSorter with

r2modman or the

Mod Manager. BepInEx is installed automatically.

Manually: install

BepInExPack for Valheim,

then copy ChestSorter.dll into \BepInEx\plugins\.

Client-side only. The server and other players don't need the mod.

Quick start

• Open a chest and click Categories. Pick what belongs in it, e.g.

Wood. The chest now shows a glowing WOOD label on all four sides.

• Tag your other storage chests the same way.
• Dump your loot into any chest, then click Push (or press

Shift+P). Each item goes to a nearby chest tagged for its category.

• Click Sort (Shift+S) to tidy the open chest.

Buttons

When a container is open, a column of buttons appears to the right of the

container panel:

| Button | Hotkey | What it does |

|---|---|---|

| Push | Shift+P | Sends items that don't belong in this chest to chests that are tagged for them. |

| Sort | Shift+S | Merges stacks and lays the chest out alphabetically. For a chest group, it sorts the whole group. |

| Categories | | Opens the category picker for this chest. |

| Only these items | | Tags the chest with exactly the items that are in it right now. |

| Join below / Leave group | | Joins this chest to the chest directly underneath it, or takes it out of its group. |

| Undo | | Undoes the last Push. |

Features

Categories

The Categories panel lists every category from the rules file. Click a

row to turn it on or off. Selected categories are highlighted and saved

immediately.

• The top of the panel shows what's in the chest right now, grouped by

category.

• From contents tags the chest with the categories of the items that are

currently in it.

• Clear removes all tags.

A chest can have any number of categories. Tags are stored on the chest

itself in the world save, so they:

• survive restarts,
• are shared with every player who has the mod,
• keep working when the category rules change.

Parent categories: Some categories have a parent. For example, all

Food:... categories belong to Food (all kinds). A chest tagged Food

accepts every kind of food, but Push fills chests with the exact category

first and uses Food chests only as overflow.

"Only these items" chests

Put, for example, honey into a chest and click Only these items. That

chest is now a honey chest: its label reads HONEY, and it replaces

whatever categories the chest had before.

Item-specific chests take priority over category chests. If a general Food

chest contains honey and a honey chest exists nearby, the next Push from the

Food chest moves the honey to the honey chest. In the Categories panel,

these tags appear as Item:, and you can untick them like any other

tag.

Push

The chest you open acts as the source. Only the source loses items.

Every other chest only receives items.

For each kind of item in the source:

• The item fits the source by its exact item tag: it stays.
• The item fits the source by category: it stays, unless an

"only these items" chest for that exact item is nearby. In that case it

moves there.

• The item doesn't fit the source: it moves to the best-matching chest

nearby.

Destinations are chosen in this order:

• Chests tagged with that exact item.
• Chests tagged with the item's category.
• Chests tagged with a parent category, such as Food.

At each of those levels, chests (or groups) that already contain the item

come first, to top up existing stacks. After that, the nearest chest wins.

Inside a group, chests fill from the bottom up.

A chest can receive items only if it is:

• within SearchRadius of you (150 m by default) and loaded,
• a stationary chest built by a player (not a cart, a ship, a gravestone or a

dungeon chest),

• public (priva