SmartStorage

v0.2.0·Updated 2026-04-27

Auto-sorts items into the right chest when shift-clicking. Items go to nearby chests that already contain that item type.

About this mod Author’s original text

SmartStorage

Auto-sorts items into the right chest when shift-clicking, instead of dumping everything into the currently opened chest.

How it works

When you shift+click an item from your inventory while a chest is open:

  • SmartStorage searches for nearby chests that already contain that item type
  • If a match is found, the item goes there automatically
  • If no match exists, vanilla behavior kicks in (item goes to the open chest)

No more manually placing wood in the wood chest, stones in the stone chest. Just shift+click and let the mod handle the sorting.

Features

  • Automatic smart sorting — items go where they belong
  • HUD notification — visual feedback when an item is auto-sorted
  • Configurable scan radius — from 1m to 50m (default: 10m)
  • Multiplayer-friendly — only targets chests you own (configurable)
  • Vanilla-compatible — fallback to default behavior when no smart match exists
  • Localization-aware — item names display correctly in your language
  • Optimized — caching system to avoid lag on large bases

Installation

Via r2modman Mod Manager (recommended)

Click the "Install with Mod Manager" button page.

Manual installation

  • Install BepInEx Pack Valheim
  • Download SmartStorage.dll
  • Place it in /BepInEx/plugins/SmartStorage/
  • Launch Valheim

Configuration

Settings are in BepInEx/config/com.macheon.smartstorage.cfg:

| Setting | Default | Description |

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

| Enabled | true | Master toggle for the mod |

| ScanRadius | 10 | Container search radius in meters (1-50) |

| ShowNotifications | true | Display HUD message on auto-sort |

| RequireOwnedContainers | true | Only target chests you own |

| VerboseLogging | false | Log every transfer to BepInEx console |

Usage tips

  • Set up once, sort forever: put one wood log in your "wood chest", one stone in your "stone chest", etc. From then on, shift+clicking any wood/stone auto-sorts to the right place.
  • Increase the radius if your storage room is large
  • Disable temporarily by setting Enabled = false in the config (no need to remove the mod)

Compatibility

  • Valheim 0.221.x (Unity 6)
  • Single-player and multiplayer
  • Works alongside most other QoL mods

Credits

Made by Macheon - first Valheim mod, feedback welcome!

License

MIT

Install & use Install: BepInEx plugin

  1. The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
  2. Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
  3. Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
  4. Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.

Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file. In multiplayer, the host and every client need the same mods installed.

Dependencies

Install these first, or the mod will not work:

denikson-BepInExPack_Valheim

File & checksum

Filename
SmartStorage-0.2.0.zip
File size
166.2 KiB