HexAutoStorage

Automatically stores bars, coal, flour, linen thread, eitr, Bloodgold, and LiquidFrost produced by supported vanilla production stations in nearby containers.

⚠️ Important

HexAutoStorage only supports items produced by supported vanilla production stations. Mods that add custom production stations, such as custom windmills or smelters, are not guaranteed to be supported.

Containers must be within the configured storage radius and must have been placed by the same player who placed the production station.

How to Use

HexAutoStorage works automatically. Containers must either have a matching Auto Storage tag or already contain the produced item.

Place a supported storage container within range of a supported production station, then either tag it for the produced item or place at least one of that item inside it.

Tags let you use an empty container for a specific resource. Without tags, leave at least one of the desired item inside the container so HexAutoStorage continues using it.

When a supported production station creates an item, HexAutoStorage searches nearby containers in the following order:

1. Matching tagged containers

   • A container tagged for the produced item is always preferred.
   • Matching tagged containers are checked from nearest to farthest.

2. Untagged containers that already contain the produced item

   • If no matching tagged container has room, HexAutoStorage looks for untagged containers that already contain that item.
   • These containers are checked from nearest to farthest.

3. Normal Valheim behavior

   • If no matching tagged container or untagged container already holding the item has room, the production station drops the item normally.

Containers with tags that do not match the produced item are skipped. Untagged containers that do not already contain the produced item are also skipped, even if they have empty slots.

Example

You have three nearby chests:

• Chest A is tagged Iron
• Chest B is untagged and already contains Iron
• Chest C is untagged and empty

When a Smelter produces Iron:

1. HexAutoStorage tries Chest A first
2. If Chest A is full, it tries Chest B
3. If Chest B is full, the Iron drops normally. Chest C is skipped because it is untagged and does not contain Iron.

If none of the chests are tagged, HexAutoStorage only uses chests that already contain Iron.

For example, if Chest B already contains Iron and has room, it will receive the Iron. If no untagged container already contains Iron and has room, the Iron drops normally.

Features

• Automatically stores produced items in nearby supported containers
• Container tags are optional
• Supports the following production stations:
  • Smelter
  • Charcoal Kiln
  • Frost Kiln
  • Blast Furnace
  • Windmill
  • Spinning Wheel
  • Eitr Refinery
• Supports the following storage containers:
  • Wood Chest
  • Barrel
  • Reinforced Chest
  • Black Metal Chest
  • Personal Chest
  • Cart
• Configurable storage radius
• Optional storage radius visualization when hovering over a production station
• Container tags allow specific resources to be routed to specific containers
• Container hover text displays assigned Auto Storage tags
• Tagged containers take priority over normal storage
• Storage falls back to untagged containers already holding the item when tagged containers are full

Screenshots

Container Tags

Container tags allow you to choose where specific resources are stored, including empty containers. Untagged containers only receive resources they already contain.

Look at a supported container and press Left Shift + P by default, or use your configured Edit Tags Shortcut, to open the Auto Storage tag editor.

Multiple tags can be assigned to the same container by separating them with commas.

Example:

Iron,Copper,Coal

Supported tags:

• Copper
• Tin
• Bronze
• Iron
• Silver
• Blackmetal
• Flametal
• Coal
• Flour
• Linen
• Eitr
• Bloodgold
• LiquidFrost

Tags are not case-sensitive. Use Bloodgold and LiquidFrost for the Deep North resources; LiquidFrost is one word. The internal prefab names do not need to be entered by the player.

To remove tags, clear the tag editor and save. The container will then only receive produced items it already contains.

Tag Example

A chest tagged:

Iron,Copper

will be preferred whenever a nearby supported production station produces Iron or Copper.

If that chest is full, HexAutoStorage will try another matching tagged container before falling back to an untagged container already holding the produced item. If none has room, the item drops normally.

A tagged container will only accept produced items that match one of its assigned tags. It will not be used as fallback storage for other resources.

Storage Radius

Production stations only search for containers within the configured StorageRadius.

The default radius is 5 meters, configurable from 5 to 100 meters. Detection uses container collider overlap, so a large container's center can be slightly outside the radius while its edge is within range.

The storage radius can optionally be displayed by enabling:

ShowRadiusVisual = true

When enabled, hover over a supported production station to display its storage radius.

Configuration

Configuration options are available in:

BepInEx/config/com.hex.autostorage.cfg

Current configuration options include:

• Enabled — Enable or disable HexAutoStorage
• StorageRadius — Radius in meters used to search for nearby storage
• ShowRadiusVisual — Display the Auto Storage radius while hovering over a supported production station
• EditTagsShortcut — Keyboard shortcut used to edit container Auto Storage tags

The EditTagsShortcut configuration description also contains the list of supported tag names for reference.

Multiplayer

HexAutoStorage is a client-side mod.

HexAutoStorage uses the creator of the production station when searching for nearby storage.

Only supported containers placed by the same player who placed the production station are considered valid Auto Storage destinations.

Installation

r2modman / Thunderstore Mod Manager

Install HexAutoStorage through your preferred Thunderstore mod manager.

Manual Installation

1. Install BepInEx for Valheim.

2. Download HexAutoStorage.

3. Copy HexAutoStorage.dll into:

   BepInEx/plugins/HexAutoStorage/

4. Start Valheim.

Source Code

Source code is available on GitHub:

https://github.com/guillenjgg/valheim-hex-autostorage

Issues / Suggestions

For bug reports, suggestions, or feedback, join the Discord:

https://discord.gg/wU2FXD94v4

Changelog

v1.1.3

Added

• Optional debug logging, disabled by default.

Fixed

• Allow shared public storage regardless of who placed the station or container; skip private and group containers.
• Improved storage checks while loading a base.
• Fixed multiplayer tag saving and added access checks and confirmation.
• Remotely managed containers remain skipped to prevent unsaved deposits, even when public.
• Preserved vanilla item metadata on stored output.

v1.1.2

Added

• Support for the Frost Kiln
• Auto storage for deep north resources:
• Bloodgold
• LiquidFrost

Changed

• Auto storage now only uses matching tagged containers or untagged containers already holding the produced item. Otherwise, items drop normally.
• Compiled with Valheim v1.0.21
• Updated BepInEx dependency denikson-BepInExPack_Valheim-5.4.2360

v1.1.1

Added

• Valheim 1.0 update

v1.1.0

Added

• Support for the Spinning Wheel and Linen Thread

Changed

• Improved the storage radius visualizer to make it more noticeable and easier to see across uneven terrain

v1.0.0

• Initial release