YAVSOS: Yet Another Valheim Storage Organization System

You've played Valheim for a while now, so you know how it goes. You have chests everywhere and an inventory full of items. Valheim asks you to open each chest one by one and stack everything one chest at a time. It also asks you to manage hundreds of items and where each one belongs. YAVSOS says, "Hold my beer." YAVSOS lets you assign chests a category, then gives you the power to stash into every chest in the area with the press of a button. "But, YAVSOS!" you exclaim. "What about items in chests that don't belong there?!" YAVSOS says, "I got this." With another press of a button, every chest in the area magically reorganizes according to its categories, filters and priorities.

You don't need to spend hours categorizing items; YAVSOS does it for you, using actual game data and hints to work out which categories items belong in. Assigning a category also anticipates items you haven't found yet and makes a home for them.

AI Disclaimer

This project's codebase was written entirely by AI. If this deters you from wanting to use the project, I completely understand. I am not a coder. I've tried to become one many times and failed each time. It just doesn't work for me. That isn't a defense for my use of AI, it just is what it is.

With that being said, my involvement with this project is, and will continue to be, the design for every behavior, UI flow, feature, and function. Their implementation is a direct result of my choices. I can't read or understand the code; this means my friends/family and I test it by how it behaves.

I've put almost a month of time (at the time of writing this) into this project so far and plan to keep supporting it the only way I can. Bugs and issues will be addressed and fixed. I will read and listen to feature requests and weigh them against what I envision for the project, and how best to keep it something that helps or is useful to people.

This document has been written by myself, and not AI.

Why YAVSOS?

We know there are so many other storage mods out there (hence the name), and what I saw is that most of them tried, in a sense, to reinvent the wheel by building everything from scratch: a stashing feature, maybe their own chest screen, multi-user chest logic and so on.

The problem with that is they end up replacing parts of other mods you trust or prefer, or at worst, they're plainly incompatible or overlap a lot with them, forcing you to pick and choose between a feature and your favorite mods.

YAVSOS attempts to go a different route. It works with the mods you already know and love, and it goes to some lengths to keep them behaving exactly the way you expect them to.

• Built with mod-to-mod collaboration in mind. YAVSOS doesn't replace mods like AzuAutoStore (AAS); it tells AAS which chest each item belongs in, and AAS keeps doing what it does best. Your stashing still feels like AAS, because it still is.
• Modest about other mods' settings. When another mod already has a say, YAVSOS tries to respect it. For example, if AAS's config has exclusions for stashing, YAVSOS respects them, and the panel shows you which items they affect. Settings that belong to another mod stay in that mod, so there's only ever one place to change them.
• Steps aside when you already have it. YAVSOS comes with its own copy of MultiUserChest (MUC), for moving items into a chest another player has open. If you have the standalone mod, or the copy inside AzuAutoStore, YAVSOS uses that one instead. If you run only YAVSOS, our MUC adds protections that prevent item loss in certain situations.
• Forward compatible. YAVSOS never switches something off just because a version number changed. Each time the game starts, it checks the parts of other mods it actually relies on. If an update changes one of them, only that part turns off, everything else keeps working, and the panel tells you what happened.

• A communal effort! When a mod YAVSOS works with has a gap, we'd rather work with its modder to see whether a fix belongs there than build a replacement. Anything we do have to work around is kept small, separate and easy to remove once it's no longer needed.

The way I see it, you shouldn't have to give up the mods you trust to get your storage organized. YAVSOS should just fit in.

Getting started

Required mods

• BepInEx
• Jotunn

While this mod was designed to work with mods like AzuAutoStore (AAS), it is still optional. With AAS, YAVSOS leverages it to handle the stashing while YAVSOS supplies the rules. Without AAS, it uses its own stashing feature with similar feature parity, so it's up to you what you want to use; you don't have to sacrifice your comfort to use this mod. See Stashing.

Gale

1. Select your Valheim profile.
2. Search for YAVSOS in the mod browser and press Install. Gale installs BepInEx and Jotunn along with it.
3. Optional: search for AzuAutoStore and press Install.
4. Press Launch game.

r2modman

1. Select Valheim and your profile.
2. Go to Online, search for YAVSOS, select it and press Download. r2modman installs BepInEx and Jotunn along with it.
3. Optional: do the same for AzuAutoStore.
4. Press Start modded.

Manual install

1. BepInEx: download BepInExPack_Valheim and copy everything inside its BepInExPack_Valheim folder into your Valheim folder, next to valheim.exe. To find that folder in Steam, right-click Valheim and choose Manage → Browse local files.
2. Start the game once and close it, so BepInEx creates its folders.
3. Jotunn: put Jotunn.dll in BepInEx/plugins.
4. YAVSOS: put the YAVSOS folder from the download in BepInEx/plugins, so you end up with BepInEx/plugins/YAVSOS/YAVSOS.dll.
5. Optional: put AzuAutoStore.dll in BepInEx/plugins.

Servers

A Steam-hosted world needs nothing extra: the host installs YAVSOS like any other player.

For a dedicated server, install the same files into the server's folder, the one with valheim_server.exe:

• BepInExPack_Valheim's contents go next to valheim_server.exe.
• Jotunn.dll and the YAVSOS folder (and AzuAutoStore.dll if you use it) go in the server's BepInEx/plugins.
• On Linux, start the server with start_server_bepinex.sh from BepInExPack. On Windows, start it the way you normally do.
• If your host has a mod or file manager, upload the same files to the same folders.

The server's YAVSOS settings live in its BepInEx/config/com.bastionntb.yavsos.cfg, and they're sent to every player who joins.

Setup types

YAVSOS works in single-player, on a server, or just for you on a server that doesn't have it. If the server has YAVSOS installed, every player will need it as well. The server's categories and settings apply to everyone. If it's on client only stashing should work on its own, but stashing into busy chests requires the other player(s) to have YAVSOS as well.

How it works

Create rules in a chest

Open a chest, and the rule panel shows up beside it. Tick the categories you want it to accept, for example, Ores & metal scrap or Raw food. YAVSOS rules are live as soon as you change them. Every item in those categories now belongs there, including ones you haven't found yet.

You can always clear a rule with a click of a button.

Rule editing respects the ward's permission settings when the chest is inside its area; a private chest can only be edited by the builder.

If you want more control:

• Always or Never. Under the "Items" tab, you can click an item's icon to mark it Always, meaning it will always be accepted there (even if it's not in the category), click again for Never, meaning it won't be stashed there (even if it is in the category). Click again to clear it, meaning it will follow the category and filters. This is so you can have fine-grained control over what goes into a chest or not.
• Filters. Narrow things down, for example only upgraded gear, items crafted by you, an EpicLoot rarity, or food that's mostly health. The panel only offers filters that make sense for the items you picked.
• Priority. When two chests are set to accept an item, you can set a priority rank on chests you want to accept the item first, then use others as a backup. Priority 1 (Critical) vs Priority 10 (Fuhgeddaboudit), with Priority 5 being normal.

Status marks

On the top right of the YAVSOS panel, you can find the status of YAVSOS and its integrations (if the companion mod is installed). Hover over each of the status icons in game to see explanations of exactly what's going on. Below is a general overview:

• Green ✔ means everything is active.
• Amber/yellow ! means a partial failure or there is something you might need to look at, such as AAS exclusions for a chest or categories for a mod not working.
• Red 𐄂 means a mod integration was disabled due to an automatic incompatibility check or functionality of YAVSOS is considered not working.
• Grey ⁃ means a setting has been disabled.

Stashing

Stashing takes items from your inventory and automatically puts them into nearby chests for you. YAVSOS also directs where those items end up using rules you set up.

Press . (period) to stash everything in your inventory or middle-click a single stack/item in your inventory to stash just that one. With AzuAutoStore (AAS) installed, YAVSOS defers to AAS for its stashing and you would use the AAS stash key as usual.

• For chests with a rule: Your items end up in the chests according to the rules that were set up, regardless of whether the item is already in the chest or not.

• For chests without a rule: The chest will accept items where existing items already match. (As is AAS's default behavior.)

Equipped items are never stashed. Items in your hotbar or AzuExtendedPlayerInventory (AzuEPI) quick slots are by default not stashed. These are configured through AAS when installed, or YAVSOS when standalone.

Cleaning up

Sometimes people don't always stash things in the right place, or maybe you want to change the rules or priority on existing chests, or your critical supply chest has run out of items also stored in a lower-priority chest somewhere nearby. The cleanup function can help here!

It finds items that are better placed in other chests (rule mismatch, higher priority, etc.) and moves them to the place within the configured range. You can do this from the chest panel by clicking on Clean up nearby or by pressing Ctrl + stash key (default ., period). Afterwards, you will see a panel display informing you of what moved or stayed.

Finding things

• Hover over a chest to see its rule, like "Food › eaten by Boar · priority 2 (Urgent)".
• Hover over an item in your inventory to see its categories and where stashing would send it.
• Search in the panel, and the nearby chests that would take that item light up.

Help and feedback

Everything goes through GitHub issues: bugs, questions, ideas and requests.

Open an issue on GitHub › · See existing issues

Reference

For server admins and modders

• Settings: for a list of all settings and their defaults and much more.
• Categories file: Want to add your own categories? Find out how here!

For developers

• Building from source
• Contributing
• Design: how YAVSOS works and why.
• Changelog

Other mods in detail

• AzuAutoStore: every item still goes in through AzuAutoStore's own store call, so its messages, skip lists and multiplayer handling are unchanged. It matches stacks by name and quality, keeps your equipped items, hotbar, quick slots and favourites, and anything no rule asks for follows its own settings.
• MultiUserChest: moves into another player's chest follow MultiUserChest's own rules, including what happens if that player lags or leaves while a move is waiting. YAVSOS's copy refuses a move when it can't be sure the other player will read the item correctly.
• EpicLoot: YAVSOS reads its item definitions to filter by rarity. If a stack's rarity can't be read at that moment, a rarity filter doesn't take that stack.
• RossItemDrawers: drawers don't take YAVSOS rules, because the drawer's own item assignment already does that job. An empty drawer assigned to an item gets that item through AzuAutoStore.
• The game's "Place stacks" button works as it always has and doesn't follow rules.
• Item origin: the "from mod" filter knows items registered through Jotunn or ItemManager. Items a mod adds some other way show their origin as "not known".

Tested with AzuAutoStore 3.1.7, Jotunn 2.30.2, EpicLoot 0.15.4, RossItemDrawers 1.3.0 and AzuExtendedPlayerInventory 2.6.4. During the testing, other mods were tested as well, but they won't be listed here; the mod is designed to generally be compatible by default. If specific compatibilities need to be expanded or made, create an issue on the GitHub for it!

Licence and credits

YAVSOS is GPL-3.0-or-later (LICENSE). YAVSOS wouldn't work without the hard work of these modders and their mods: ServerSync by blaxxun and MultiUserChest by MSchmoecker, both MIT (notices). Built on Jotunn and BepInEx.

Changelog

1.3.0 (2026-11-08)

Templates! Full multiplayer rule editing! Storehouse mod support!

Before you update

• New stack key. Moved the stack key from middle mouse to Shift + middle mouse, for greater compatibility with ZenSign's search. This move overwrites previous stack key bindings if it was set to its previous middle mouse default.

New

• Rule templates. You can now save a chest's rule on the new Templates tab and apply it to any chest.
• Server templates. Admins can share templates with everyone on the server. You can use them or make a copy of them for yourself.
• Edit chests in use. You can now change a chest's rule while another player has it open.
• Show or hide the panel. You can now use the YAVSOS button below the chest window to hide the panel completely.

Improved

• Items tab sections. Each ticked category gets its own section on the Items tab.
• Bulk Never actions. You can now mark a whole section as Never and clear it all with a single button. This will help with narrowing down categories to a few exceptions.
• Right-click to step back. You can now use right-click on an item in the Items tab to go in reverse order from left-clicking: Never, Always, then clear.
• Lit chests show through walls. Chests that are lit will get a marker you can see through walls.
• Lit chests stay lit after you clear the search. Clearing the search box no longer turns the lights off at once: the chests stay lit for your lit-chest time, which starts over when you close the chest, so you can still walk to them.
• Chests in stacks. When a chest is in a vertical stack, the results, tooltips and search will inform you of its place, such as "2 of 3 from the bottom".

Mod compatibility

• Storehouse mod compatibility. A new Storehouse store will automatically take what it's built for without needing a rule. This also applies to other mods that add filtered containers the same way as the Storehouse mod does.
• Filtered containers as categories. When a mod adds a container (much like the Storehouse mod), those filtered chests automatically become categories that you can now use for other containers as well.
• Zen.ModLib outlines. With Zen.ModLib installed, lit chests get its outline instead of a marker.

For server admins

• Bigger reach. You can now let stashing and cleanup reach up to 512 chests, and let one cleanup organize up to 256 of them.

Fixed

• Cleanup in large bases. Fixed cleanup getting stuck on the same nearby chests in a large base, so items further away never got cleaned up unless you walked closer. Cleanup will now start with the chests holding items that don't belong, and pressing it again will reach the rest.
• No more false "no room". Fixed a rare case where a chest refused an item: stashing and cleanup now pick another chest instead of falsely saying there's "no room".
• Clear message when categories fail. Fixed an issue when the server couldn't build the categories: players now see a message saying so instead of "still loading". The server will also retry every few minutes.

1.2.2 (2026-11-07)

Your favorites stay in your inventory!

Mod compatibility

• Favorites stay put. YAVSOS's stash and stack keys will now leave your favorites from AzuExtendedPlayerInventory, Quick Stack Store and ItemFavoriteFramework in your inventory, whether you favorited the stack or its slot. With AzuAutoStore installed, AzuAutoStore keeps its own favorites, as before.
• Why a favorite stays. Pressing the stack key on a favorite will now tell you why it stays, such as "Wood stays: it's a favorite in Quick Stack Store." The item tooltip says so too.
• Unreadable favorites. If YAVSOS can't read a favorites mod, stashing will still work and treat those items like any other. The result panel will name that mod once per game session.

1.2.1 (2026-11-05)

Categories load on busy servers!

Fixed

• Categories stuck loading. Fixed categories staying "still loading" for good on a busy server, which left chests taking only their Always items and what they already held.
• Retry when loading fails. Fixed the server waiting for a restart after loading the categories failed. It will now try again every few minutes, and the panel will say so.

1.2.0 (2026-11-04)

Undo! Rule suggestions! See exactly where your items went!

New

• Undo and redo. You can now click ↶ or press Ctrl + Z to undo your last change to a chest's rule, even a Paste or Clear rule. Do it again to redo.
• Rule suggestions. You can now set a rule from what a chest already holds. The panel will suggest one, such as "Set rule: Metals", and ✕ hides it.

Improved

• Where your items went. The result panel will now list every chest or drawer that got items, and what went in. This works with AzuAutoStore's stash key too.
• Search names the matches. When a search matches several items, a lit chest will now name the ones it accepts, such as "Accepts Copper, Tin".
• Panel messages. Moved the panel's messages into one strip under its title, so you can see why a change wasn't made.
• Category names. Renamed two categories: Moulds is now Molds, and Epic Loot is now EpicLoot.

For server admins

• Add or remove items from categories. You can now add an item to a category, or remove it from one, with <add> and <remove> lines in the categories file. The item will keep its other categories.

Fixed

• Cleanup stutter. Fixed cleanup stuttering on its first press after you start the game, and pausing in large bases.
• Storehouse armor stands. Fixed stashing and cleanup reporting items as unconfirmed when they went onto storage that sorts them into its own slots, such as Storehouse's armor stands.

1.1.0 (2026-11-02)

Search that lights up your base! Glowing chests! Copy and paste rules!

New

• Search lights up chests. When you search in the YAVSOS panel, chests holding a match will now glow gold. Turn on the toggle beside the search bar to also light, in blue, the chests whose rule takes it.
• Arrival glow. Chests will now glow and give off a small puff when stashing or cleanup puts items in them. Choose the effect, or none, with the ChestArrivalEffect setting.
• See what stayed. After a cleanup, a chest that kept items no chest takes or has room for will now glow red-orange. Point at it to see what stayed and why.
• Copy and paste rules. You can now use Copy and Paste beside Clear rule to copy a chest's whole rule to another chest. Pasting replaces that chest's rule.
• Fold the panel. You can now use the arrow left of the panel's title to fold the panel down to its title, status marks and chest label. It will stay folded on every chest until you unfold it.

Improved

• Glow colors. You can now change the gold, blue and red-orange glows with the HoldsColor, TakesColor and StaysColor settings.
• Result panel closes itself. The result panel will now close 10 seconds after a stash or cleanup, even with your inventory open. Change how long with ResultPanelSeconds.
• Tooltips say why. The "Stash stack" line in item tooltips will now say why the item goes to that chest, such as "(counts as Metals)".
• Skipped chests explained. When stashing or cleanup skips another player's chest, the result panel will now give each reason on its own line.
• Panel hover hints. Pointing at the Rule heading will now show the chest's label as other players see it, and the YAVSOS title will show the mod's full name.

Mod compatibility

• AzuAutoStore results. With AzuAutoStore installed, its store key will now show YAVSOS's result panel, listing what it stored and where.
• AzuAutoStore cleanup key. With AzuAutoStore installed, the cleanup key will now use the modifier from the Cleanup Shortcut setting instead of always Ctrl. Set Shortcut to None to turn the cleanup key off.
• Shared chests without YAVSOS. On a server without YAVSOS, stashing and cleanup can now put items in a chest another player has open or stands near, as long as that player has AzuAutoStore or MultiUserChest.

Fixed

• Tankards and mead horns. Fixed tankards and mead horns going to chests that take Swords. They now count as Equipment.
• Cleanup tooltip. Fixed the cleanup button's tooltip naming another player's chest that cleanup then skipped.
• Leftover tooltip. Fixed an item's tooltip staying over the empty slot after you stashed the whole stack with middle mouse.

1.0.2 (2026-10-31)

Magic items stay safe!

Fixed

• Vanishing magic items. Fixed items with extra data, such as EpicLoot magic items, vanishing when a player with AzuAutoStore but not YAVSOS took them from your chest on a server without either mod. Those items will now stay in the chest.

1.0.1 (2026-10-30)

Clearer warnings! Fewer skipped chests!

Before you update

• Update EpicLoot on the server. EpicLoot 0.15.2 and later put its belt and rings in their categories itself, so YAVSOS no longer does. With an older EpicLoot on the server, those items won't have a category.

New

• Display mark. A new Display status mark will turn amber when tooltips, labels, search or the result panel turn off after an error, and say which.

Improved

• Clearer warnings. YAVSOS will now tell you when something can't work and why, such as cleanup being off because AzuAutoStore's exclusion list can't be read, or a rule too large to save.
• Warning marks stand out. Amber status marks will now show "!" instead of a check mark, so they stand apart from the green ones.

Fixed

• Chests with unmovable items. Fixed stashing and cleanup skipping a whole chest because it held one item YAVSOS can't move. That item will now stay put, and the rest of the chest will be handled as usual.
• Keys with the inventory open. Fixed the cleanup and store keys doing nothing while your inventory is open. They will now tell you to close it first.
• Item grid and filters. Fixed the item grid marking different items as taken than stashing and cleanup would move, when a rule uses a filter such as Damaged or Crafted by.
• Split stacks. Fixed the stash result counting a split stack more than once.
• Left-alone chests. Fixed the stash result saying "rules changed" for a chest set to be left alone during cleanup. It will now say the chest is left alone.
• AzuAutoStore notice. Fixed AzuAutoStore's exclusion notice counting creature attacks, such as "Lox bite", as items.
• Read-only config folder. Fixed YAVSOS failing to load when its config folder is read-only.

1.0.0 (2026-10-28)

First public release! Chest rules! Automatic categories! One-key cleanup!

New

• Chest rules. Set what each chest takes in a panel beside the open chest: categories, Always and Never items, filters and a priority.
• Automatic categories. Every item gets its categories automatically, including items other mods add.
• Stashing. Stash items through AzuAutoStore when it's installed, or with YAVSOS's own stash when it isn't.
• Cleanup. One key moves items to the chest whose rule fits them best.
• Find your items. Hover labels, item tooltips and a search that lights up the chests taking an item.
• Play anywhere. Works on any server, in single player, and when you join a server without YAVSOS.

Mod compatibility

• Works with other mods. Works with MultiUserChest, EpicLoot and the other mods the player guide lists under "Other mods". Each one is checked when the game starts and turns off on its own if it doesn't fit.