Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
BetterChests
Chests standing together form a group you can use as one: search it, deposit into it and restock from it with a redesigned chest panel and keys, plus auto deposit and smarter sorting.
| Date uploaded | 12 hours ago |
| Version | 0.7.0 |
| Download link | Aestelwen-BetterChests-0.7.0.zip |
| Downloads | 95 |
| Dependency string | Aestelwen-BetterChests-0.7.0 |
This mod requires the following mods to function
ValheimModding-Jotunn
Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.
Preferred version: 2.30.2denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2360README
BetterChests
Chests standing together form a group you can use as one: search it, deposit into it and restock from it with a redesigned chest panel and keys, plus auto deposit and smarter sorting.

Chest Groups
Chests standing close together form a group, such as a row, a wall or a stack of chests.
A chest joins a group when it is within a metre of any chest already in it (the Cluster Gap setting), so a group can run the length of a storage room.
Only chests you could open yourself are used: not other players' private chests or chests inside someone else's ward. A chest another player has open is skipped until they close it.
Everything in the mod is built on groups:
- Search the whole group from any chest in it, and take, use, deposit or gather items across it.
- Restock your partial stacks from the whole group.
- Auto deposit items you drop into the group, next to the same items.
- Duplicates shows which items are spread over several chests in the group.
The Chest Panel
The open chest's name is at the top left, with the search bar beside it, and the five buttons are in one row underneath. The panel grows taller to show every row of big chests without scrolling, as far as the bottom of the screen, and the wardrobe is shown as 10 columns by 5 rows instead of 5 by 10.

Buttons and Keys
Every button has a key, shown in the key hints at the bottom of the screen and in a chest's hover text. The keys also work while just looking at a chest, without opening it, and a message says what moved. While you search, the buttons work on the whole group instead of the open chest.
| Button | Key | On the open chest | While searching the group |
|---|---|---|---|
| Restock | R |
Tops up every partial stack you carry from the whole group. | The same. |
| Take all | T |
Moves everything in the chest into your inventory. | Takes every stack the search shows. |
| Deposit all | F |
Moves everything you carry into the chest, except kept items (see below). | Puts each item in the chests that already hold it, topping up their stacks first, and the rest in this one. |
| Place stacks | G |
Tops up stacks already in the chest with what you carry, except kept items. | Tops up stacks anywhere in the group with the items you carry that match the search. |
| Sort | H |
Sorts the chest. | Gathers each item the search shows into the chest holding the most of it, then sorts that chest. |
All the keys can be changed in the config file.

Search
Type in the search bar to search the open chest and every chest grouped with it. While you type, the chest's grid shows every matching item from the whole group, as if it were one chest, in sort order:
- Click an item to take that stack into your inventory, straight from the chest it is in.
- Shift + click it to split the stack, and take only part of it.
- Right-click it to eat or drink it from that chest, or to take it and equip it.
- Drag an item from your inventory onto the results, or Ctrl + click it in your inventory, to put it in the chests that already hold that item (the same way as Deposit all).
- Click the red cross at the end of the search bar to clear it.

Keeping Items
Deposit all and Place stacks never move your hotbar (the top row of your inventory) or anything you have equipped, so you can empty your bags after an adventure without losing your gear.
To keep other items too, such as your food, hold Alt and right-click them in your inventory to mark them. Marked items get a frame; do the same again to unmark them.
Duplicates
Items in the open chest that another chest in its group also holds get a blue frame, so you can see what could be gathered into one chest (searching for it and pressing Sort does that).

Hovering over an item in the chest makes the other chests in the group that hold it glow, and its tooltip says how many of them there are and how much they hold. Hovering over an item in your inventory does the same for every chest group within auto deposit range of you, so you know where to take it.

Split Stack
The split stack dialog (Shift + click a stack) gets - and + buttons either side of the slider to change the amount by one, and so does the mouse wheel. This works in your inventory as well as in chests.

Auto Deposit
Drop an item near any chest in a group, and it is stored in the group: in a chest that already holds that item if there is one, otherwise in any chest with room.
Sorting
Sorting merges partial stacks, then groups related items together, in this order: wood, stone and minerals, ores, metal bars, nails and other metal parts, hides, other creature parts, valuables, other materials, upgrade kits, moulds and casts, seeds, raw meat and fish, crops, cooked food, meads, other consumables, then ammo, weapons, shields, tools, armour, utility items and trophies. Within each group, items are ordered by tier, from the earliest biome to the latest. Also:
- Crops (anything picked from a plant, edible or not) are ordered by tier.
- Cooked food is ordered by the stat it raises most (health, balanced health and stamina, stamina, then eitr), lowest first.
- Armour is grouped by set, then helmet, chest, legs, gloves and cape.
- Weapons are grouped by class (swords, axes, clubs, spears, polearms, knives, fists, bows, crossbows, staffs), one-handed before two-handed.
- Moulds and casts are ordered like the gear they make: armour sets first, then weapons, then shields.
- Upgrade kits: armour kits by tier, then weapon kits by tier.
- Meads are grouped by what they do (health, stamina, eitr, each resistance, then the rest), then by tier, with their bases first.
Items from other mods are sorted the same way, by what the game says they are and where they come from.
Configuration
Settings are in the BepInEx config file javidahmed64592.betterchests.cfg.
Settings marked "(Synced with server)" use the server's values when the server has the mod installed.
Compatibility
- Other chest mods that add sorting, quick stacking or auto storing (such as Quick Stack - Store - Sort - Trash - Restock) overlap with this mod. Their keys may clash with
R,T,F,GandH(all can be changed in the config file), and their buttons may overlap on the chest panel. - This mod has not been tested with a gamepad, only with keyboard and mouse.
Uninstalling
The mod can be removed at any time. Items marked to keep (Alt + right-click) keep a small marker in their data, which does nothing without the mod.
License
This project is licensed under the MIT License - see the LICENSE file for details.
CHANGELOG
Changelog
0.7.0
- Fixed "Someone else is using this" appearing for chests nobody had open, stopping the chest keys, Restock, auto deposit and search from using them. It happened whenever another player owned the chest: their "yes" arrived a moment before the chest itself, and was taken as a "no". Requests now wait for the chest to arrive, as opening a chest does, and ask again if the chest changed hands before its owner answered.
- New button order and default keys: Restock (
R), Take all (T), Deposit all (F), Place stacks (G) and Sort (H). The key hints and a chest's hover text follow the same order. Keys already saved in your config file are kept, so delete theKeybindsentries to get the new defaults.
0.6.0
-
Chest panel redesign. The chest's name and a new search bar sit at the top, with all five buttons in one row underneath: Take all, Restock, Deposit all, Place stacks and Sort.
-
Search the chest group. Typing in the search bar shows matching items from every chest in the group as one grid. Click to take a stack, Shift + click to split it, and right-click to eat, drink or equip it, straight from the chest it's in. A red cross clears the search.
-
Buttons act on the whole group while searching. Take all takes every result. Place stacks and Deposit all put items into the chests that already hold them before the open chest, as do Ctrl + click and dragging onto the results. Sort gathers each result into the chest holding the most of it.
-
Restock (Y or the button) tops up every partial stack you carry from the chest's group.
-
Keys work while looking at a chest, without opening it, with a message and a sound saying what moved. While they act, they don't also trigger the game's or other mods' bindings for the same key (such as the Forsaken power on F). They can be turned off in the new
Chest Keysconfig section. -
Smarter sorting, worked out from the game's own data so Deep North and other mods' items sort sensibly:
- crops by tier;
- cooked food by the stat it raises most;
- armour by set, then slot;
- weapons by class;
- meads by effect;
- moulds next to the gear they make;
- upgrade kits by kind and tier;
- separate groups for bars, metal parts and hides.
The new
betterchests_sortinfoconsole command logs where every item sorts. -
Fixed Place stacks moving items out of your hotbar. It now keeps the same items as Deposit all.
-
The README has been rewritten around chest groups, and the Harmony patches now live in a
Patchesfolder.
0.5.0
- Items in an open chest that another chest in its group also holds get a blue frame, so you can spot items worth gathering into one chest.
- Hovering over an item in the open chest makes the other chests in its group that hold it glow, and its tooltip says how many of them there are and how much they hold.
- Hovering over an item in your inventory does the same for every chest in the groups within auto deposit range of you, whether or not a chest is open.
- Other players' private chests and chests in someone else's ward are never counted. Nothing is moved for you.
- Added the
Show Duplicatessetting to turn this off. - Moved the source files into feature folders (
Core,Deposit,Duplicates,Sorting,UI). No change in behaviour.
0.4.1
- The wardrobe is now shown as 10 columns by 5 rows instead of 5 by 10, so all of it fits without a scroll bar. The chest panel widens to fit it.
0.4.0
- Auto deposit now asks a chest's owner for the chest the same way opening a chest does, instead of taking it over. A chest another player has open is skipped, and two players can no longer change a chest's contents at the same time. This also works when the other player doesn't have the mod.
- Opening a chest just as an item is being stored in it still opens the chest.
- The auto deposit
Radius,Cluster GapandDelayare now synced from the server when it has the mod.EnabledandThrow Anglestay your own choice. - Buttons, key hints and messages can now be translated (
Translations/English.json). - Added a CI check that the version matches in every file.
- Moved
package.shinto.github/scriptsand made it the same for every mod: the name, version and DLL now come frommanifest.jsonand the.csproj.
0.3.2
- Items marked to keep (Alt + right-click) now also stay in your inventory when using Place stacks, not just Deposit all.
0.3.1
- Fixed auto deposit never storing dropped items: the hook that starts watching a dropped item never ran.
- When a dropped item is left on the ground, the reason is written to the BepInEx log.
0.3.0
- Dropped items now land on the ground and lie there for 3 seconds before being stored, so other players can pick them up first. Previously they went straight into the chest.
- The distance to a chest is now measured from where the item lands, not from the player.
- Only chests in the direction you throw an item are used (within 60 degrees of the way you face), so items dropped with your back to a chest stay on the ground.
- Chests close together count as one group: an item that lands near one of them can go into any of them, filling chests that already hold it first.
- Lowered the default auto deposit radius from 6m to 4m.
- Added the Cluster Gap, Throw Angle and Delay settings.
0.2.1
- Lowered the default auto deposit radius from 10m to 6m, and the maximum from 50m to 12m.
0.2.0
- Items in your inventory can be marked to stay behind when using Deposit all: hold Alt and right-click (Mouse 1) them. Marked items get a gold frame.
- The keep key can be changed in the config file.
0.1.1
- Declared the mod as client side to Jotunn, so servers and other players are never required to have it installed.
0.1.0
- Initial release.
- Dropped items are stored in nearby chests, preferring chests that already hold the item. They are shown flying into the chest.
- Added a Sort button to the chest panel, which merges stacks and groups related items together (wood, stone, ores, metals, seeds, crops, food, gear and so on).
- Added a Deposit all button to the chest panel, which moves everything except the hotbar and equipped items into the chest.
- The chest panel grows to fit the new buttons and every row of big chests.
- Added keys laid out like the chest buttons while a chest is open: take all (
R), place stacks (T), deposit all (F) and sort (G). - Added -/+ buttons to the split stack dialog, and the mouse wheel changes the amount too.
- The keys are shown in the inventory key hints and can be changed in the config file.