Hearth Logistics

Client-side inventory, smart storage and base logistics for Valheim — version 0.3.5.

Spend less time moving items and more time building, crafting and exploring. Create personal inventory profiles, organize your storage, and run Deposit, Restock, Rebalance or Service Base when you need them.

Install on your client only. No Hearth Logistics installation is required on the dedicated server or other players’ clients. Requires BepInEx 5; Jotunn is not required.

What's new since 0.2.12

• Download nearby resources: browse nearby storage by item, category or search, then transfer a chosen quantity to your inventory or an open chest/cart. Includes item icons, Max quantity, a scrollbar and an optional Ignore weight limit setting.
• Build from nearby storage: use eligible nearby materials for hammer construction as well as supported crafting.
• Multiple Overflow containers: designate several chests or carts as Overflow, with Priority controlling which destinations are used first.
• Optional fallback storage: Treat Unconfigured Chests As Overflow lets ordinary unconfigured containers provide extra storage capacity.
• Expanded base servicing: use unlocked carried supplies first, then nearby storage; configure global material permissions and station policies. Service Structures During Deposit is also available as an optional preference.
• Mead fermenters: supply valid mead bases and collect finished batches through your normal storage routes.
• Overflow highlighting: locate explicitly designated Overflow chests and carts with small cyan markers.
• Container hover previews: see a compact contents summary and explicit Overflow status without opening a chest or cart.

Inventory Profiles

Select an Inventory Profile beside the normal inventory statistics. Choose Edit to create, rename, duplicate or delete profiles and set item Min/Max quantities.

• Min 10 / Max 10: Restock and Deposit aim to keep 10.
• Min 5 / Max 10: Restock when below 5, up to 10; Deposit anything above 10.
• A blank Min means no refill requirement. A blank Max means no upper inventory limit. A Min-only rule restocks to Min.

Lock physical inventory slots while editing by hovering a slot and pressing F4. Hearth Logistics leaves locked slots untouched. Switching profiles changes the active rules without moving items automatically. Profiles and preferences are saved locally per character.

Smart storage

Open a chest or cart to configure its storage rules:

• Item or category filters for individual slots, rows or the entire container.
• Filter ghost icons and Create filters from current contents.
• Stock Min / Max, Fill Available Space, Priority and Overflow.
• Layout copy/paste and named templates.

Configured destinations are preferred, followed by explicitly marked Overflow containers and then optional unconfigured fallback storage. Higher Priority wins within a destination tier. Transfers can continue across multiple containers when one fills up.

Min protects stored supplies from withdrawal. Placement filters control where items may be deposited; they do not prevent taking existing items out. Max and Fill Available Space control destination capacity rather than reserving existing stock.

Carts support the same storage rules. Their configuration follows the cart as it moves.

Logistics actions

Action	What it does
Deposit	Stores eligible carried excess according to the active profile and nearby destination rules. Deposit unlisted items defaults on.
Restock	Deposits profile excess, then fills profile shortages while respecting protected storage reserves.
Rebalance	Redistributes nearby storage according to stock rules, capacity and destination priorities.
Service Base	Services nearby supported structures, then optionally deposits excess and restocks the player. Deposit afterward defaults on; player restocking defaults off.
Service objects	Runs structure servicing separately.
Collect outputs	Routes supported, observed production drops into storage and can tap finished fermenters with sufficient destination capacity.

Base servicing and fermenters

Supported structures include smelters, blast furnaces, charcoal kilns, windmills, spinning wheels, fermenters, finite-fuel fires, hearths and ground/wall torches.

Servicing uses unlocked carried resources first, then eligible nearby storage. Chest Min and personal storage reserves remain protected. Configure station enablement, refill thresholds and global material permissions under Servicing.

Fermenter recipes come from the game's component data. If several valid bases are available, selection follows a stable prefab-name order. Active fermentation is left alone. Finished barrels are tapped only when existing storage routes have room for the whole batch. A tapped barrel can be refilled on the next servicing action.

Servicing requires local ownership of the machine. Remote-owned machines are skipped without consuming supplies. Fermenter tapping releases vanilla drops after a delay; if storage access or capacity changes during that delay, remaining products stay as drops for later collection. Output collection recognizes supported production observed during the current session, rather than sweeping arbitrary ground loot.

Download nearby resources

Open your inventory or a chest/cart and click the small down-arrow button just outside the inventory window's top-left corner. The browser identifies the destination and excludes it from source storage.

Browse localized item names and icons, filter by category, search, choose a quantity or use Max, then transfer items directly. The list supports mouse-wheel scrolling and a draggable scrollbar.

• Download requests additional items: carrying 20 Coal and downloading 30 aims for 50.
• Player profile Min/Max does not limit this manual action; locked slots remain protected.
• Source chest Min remains protected. Personal storage reserves apply to Restock, crafting and servicing, but not Download.
• Chest/cart destinations respect placement filters, stock Max and available space.
• Player downloads respect carry weight by default. Ignore weight limit is an optional local preference; normal encumbrance can still occur.
• Partial transfers report the amount moved and the limiting condition. Use Refresh to update availability explicitly.

Craft and build from nearby storage

Enable Craft / build from nearby storage to use eligible nearby supplies for ordinary new-item crafting and hammer construction. Source Min and personal storage reserves remain protected. Normal station, placement, DLC and other vanilla requirements still apply.

Hammer construction does not require spare player inventory slots. Storage ingredients are consumed only after successful placement. Crafting upgrades, special upgrader stations, one-of-ingredient recipes and no-cost crafting modes are outside the supported crafting scope.

Find and preview containers

Under Mod Settings → Hearth Logistics → Preferences:

• Highlight Overflow Containers — off by default. Shows small cyan markers on nearby accessible chests/carts explicitly configured as Overflow. Unconfigured fallback storage is not marked.
• Show Container Contents on Hover — on by default. Adds a read-only summary to normal hover text, totaling stacks by item type. Shows up to eight types, ordered by quantity then name, with a count of any additional types. Rows use localized text; item icons are not shown in this preview.

An Overflow label identifies explicitly designated containers. Previews respect access restrictions and do not open inventories or request ownership. They are hidden while inventory or menu screens are open. Both features are local visual preferences.

Controls and settings

Action	Default key
Deposit	F6
Restock	F7
Rebalance	F8
Service Base	F9
Mod Settings	F10
Service objects	F11
Collect outputs	F12
Lock hovered inventory slot while editing	F4
Additional Restock active profile binding	Unbound

Change bindings under Preferences. Action hotkeys operate outside inventory/settings menus and are suppressed during text entry. Alt + right-click an inventory item opens the profile editor.

Open Mod Settings → Hearth Logistics from the main menu or pause menu, or press F10:

• Inventory profiles: personal rules, profile management and Storage reserves.
• Servicing: global material permissions and station policies.
• Preferences: hotkeys, visual options, notifications, crafting, logistics options, diagnostics and ranges.

Storage range and Service range default to 20 m, adjustable from 2–50 m. Treat Unconfigured Chests As Overflow and Service Structures During Deposit both default off.

Personal data is stored in BepInEx/config/HearthLogistics/<character-ID>.json; main-menu defaults use menu.json. Container configuration is stored with the container's network data.

Installation

Install with a compatible mod manager, or install manually:

1. Install BepInEx 5 for your Valheim client and close the game.
2. Extract the package's BepInEx folder into your Valheim directory.
3. Confirm the plugin is at BepInEx/plugins/HearthLogistics/HearthLogistics.dll.
4. Start the game and look for Hearth Logistics 0.3.5 loaded in BepInEx/LogOutput.log.

When updating, replace the existing DLL rather than keeping multiple copies. Install nothing from this package on the dedicated server. To uninstall, close the game and remove the HearthLogistics plugin folder.

Built against BepInEx 5.4.23.5 and Valheim 1.0.15. Harmony comes from BepInEx; Unity and Newtonsoft.Json come from the game. Dependencies are not bundled.

Multiplayer and practical limits

Transfers use nearby, loaded, accessible storage owned by the local client. Busy or inaccessible containers and tombstones are skipped. Other players do not need the mod to play; clients using Hearth Logistics can read shared container rules. Personal profiles and preferences remain local.

There is no unattended or offline automation. Shared-rule persistence and cross-client behavior should be checked on your server. Nearby caches limit repeated inventory work without requesting a full world scan.

Version 0.3.5 has passed compilation and code-level/static checks. Gameplay, visual layout and multiplayer behavior have not been verified as part of this build.

Feedback and diagnostics

Bugs, suggestions and feedback: Discord racidon.

Under Preferences → Debug Logging, select Off (default), Normal or Verbose. Logs are written to BepInEx/logs/HearthLogistics.log. With logging enabled, the chest panel also offers Dump Chest Debug and Refresh Logistics Panel.

For a report, include your mod, Valheim and BepInEx versions, what happened, and the relevant log excerpt.

License

Hearth Logistics is released under the MIT License. Third-party dependencies retain their own licenses.