SmartContainers

SmartContainers (Valheim 1.0 fork)

Unofficial community port of Flueno/ZOR SmartContainers for Valheim 1.0 (Unity 6).

Original idea and design belong to Flueno / ZOR ( mod 332).

This package rebuilds and updates that mod so it loads again after the 1.0 release.

Want to quickly drop your loot? Tired of looking for the chest with a specific item-stack just to store more of it? Teach your containers to arrange items with their neighbors.

Also available. Support for this fork is handled there (see below).

Support / Bug reports

Please report bugs, crashes, compatibility issues and feedback:.com/valheim/mods/3656

• Use the Bugs tab for reproducible problems (include game version, BepInEx version, and a snippet from BepInEx/LogOutput.log when possible).
• Use the Posts tab for questions, multiplayer notes and general feedback.
• Feature requests are welcome Posts as well.

Do not use the abandoned original mod 332 for support of this fork — that page is credits only.

comments are not monitored for support.

When filing a bug, please include:

• Valheim version (1.0.x)
• BepInExPack version (expected: 5.4.2350+)
• SmartContainers version (as shown in BepInEx/LogOutput.log)
• Whether it happens in singleplayer or multiplayer
• Relevant lines from BepInEx/LogOutput.log (especially SmartContainers / Harmony errors)

Support the author

If this Valheim 1.0 fork helps you out, you can support continued maintenance with a donation on Ko-fi:

ko-fi.com/tudoecriativo

Tips help cover the time spent keeping the mod working after game updates. Thank you!

Features

• Automatically sends items you put into a chest to other nearby chests that already contain the same item-stack.
• Routes same-kinded items to their siblings (example: copper ore goes to a chest that already has tin ore).
• Create custom item-groups from any combination — put carrots, stones and feathers in one box, click the button, and from then on carrots can route to a chest that has feathers.
• Optional unload button to dump configured loot from your inventory into the correct nearby chests in one click.
• Protect / favorite backpack items from Unload: Alt + Right-click (stored in itemsSkipList)
• HUD message, sound and VFX feedback when items are successfully routed.
• Multiplayer-aware options to skip or block chests currently used by other players.

How it works

When you move an item stack into a container with Ctrl + Click:

• If the current container is full or does not already have that item:
• Search nearby containers for the same item-stack and route there if there is space.
• If none found and grouping is enabled:
• Search nearby containers that contain items from a matching group (user groups, system groups, prefix/postfix patterns, or item-type groups).

In short: if a group contains your item and a nearby chest already has another member of that group, your item can go to that chest.

Controls

| Input | Action |

|---|---|

| Ctrl + Click | Move stack and trigger SmartContainers routing |

| Ctrl + L + Click | Same as above, but also prints the item name to the F5 console |

| Alt + Right-click (backpack) | Toggle protect / favorite — Unload (>>) will not move that item type |

| Chest UI button + | Create / merge custom item-groups from the opened chest |

| Chest UI button >> | Unload configured inventory items into nearby chests (if Unload is enabled) |

| Shift + click + | Add current chest item names to unload allow-list |

| Ctrl + click + | Add current chest item names to unload skip-list (protect) |

Gamepad bindings are configurable (create-group, unload filters, etc.).

General configuration

Config file: BepInEx/config/flueno.SmartContainers.cfg

Also editable in-game with Configuration Manager (F1).

| Option | Description |

|---|---|

| enabled | Master toggle |

| range | Radius used to find nearby containers |

| onlyStackableItems | If enabled, tools/weapons/armor are not rearrang