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

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

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.

Changelog

0.4.0

A major HearthLogistics update adding container contents displays, expanded nearby-storage support, inventory improvements, a redesigned container interface, and an early version of Container Portals.

Container Portals are currently a work in progress.

HearthLogistics works client-side without a server plugin. In client-only mode, portal transfers work with loaded containers owned by the local client. An optional server worker, disabled by default, can transfer between unloaded unowned/server-owned endpoints outside player active areas. Expect further changes and improvements to the portal system in future releases.

Container Portals — WIP

• Added experimental portal installations for chests, carts and boat storage.

• Install an unlocked standard wood or stone portal recipe onto a container.

• Link an Outgoing container to an Incoming container using a shared portal ID.

• Portal transfers respect:

  • Container filters

  • Stock Min / Max rules

  • Fill Available Space

  • Destination capacity

  • Portal type restrictions

• Added portal status and direction/link indicators.

• Portal installations consume the normal portal recipe materials.

• Destroying a container with an installed portal refunds the portal materials.

• Portal installations are kept separate from copied layouts and templates.

• Portal IDs are scoped to the character that installed them.

• Legacy portal pairs can be claimed without paying for the installation again.

Current Portal Limitations — Client-Only Mode

• Portal functionality works client-side without a server plugin.

• Both endpoints must be loaded and owned by the local client for transfers to occur.

• Unloaded-world transfers require the optional server worker; it is disabled by default and only processes unowned/server-owned endpoints outside player active areas.

• Containers owned by another client may need to wait until they become accessible.

• Portal behaviour and configuration may change while the feature is being developed.

Ignore Containers

• Added Ignore this container for personal chests, carts and boat storage.

• Ignored containers are excluded from:

  • Deposit

  • Restock

  • Rebalance and automatic logistics

  • Nearby crafting and building supplies

  • Download

  • F5 build-material retrieval

  • Portal transfers

  • HearthLogistics contents displays

• Ignored containers can still be opened and configured normally.

Container Contents Displays

• Added optional item icons directly to container surfaces.

• Display:

  • A single item

  • Four-item side grids

  • Six-item front/back grids

• Choose which container faces display their contents.

• Added an optional background behind displayed icons.

• Added per-container background colours with:

  • Colour wheel

  • Brightness

  • Opacity

  • Hex colour entry

• Save reusable colour swatches per character.

• Contents display settings are included in copied layouts and templates.

• Improved icon positioning across different chest models and animations.

• Added Container Icon Calibration for manually adjusting unusual container models.

Nearby Storage & Multiplayer

• Improved handling of nearby containers owned by other connected players.

• HearthLogistics can request normal Valheim container ownership when required for an operation.

• Added shared read-only inventory information for nearby storage.

• Restock, Download, Deposit, crafting and servicing now share improved nearby-resource discovery.

• Improved handling of busy, inaccessible and remotely owned containers.

• Reduced repeated ownership requests and unnecessary storage scans.

Building & Upgrading

• Nearby storage can now supply materials for normal item upgrades.

• Added Building can consume materials in locked slots, enabled by default.

• Explicit item locks, equipped items and quest items remain protected.

• Added an F5 shortcut while using the hammer to retrieve missing materials for one copy of the selected build piece.

• Improved shortage reporting when building from nearby storage.

Inventory Improvements

• Deposit now consolidates compatible partial stacks after transfers.

• Equipped partial stacks are preferred where appropriate.

• Restock and Download can fill unlocked equipped stacks while keeping them equipped.

• Fixed upgrades being incorrectly rejected when the target item occupied a locked slot.

Interface Improvements

• Redesigned container configuration into separate main and Contents & Filters panels.

• Moved commonly used container settings back to the main panel.

• Added visible draggable scrollbars.

• Improved panel scaling across different resolutions.

• Fixed filter-panel controls stretching vertically.

• Filter actions remain anchored at the bottom while the item list fills the available space.

• Colour picker now opens independently beside the main panel.

• Updated HearthLogistics UI to make greater use of native Valheim panel, input, checkbox, slider and scrollbar graphics.

Controls

• HearthLogistics hotkeys now appear in Valheim's normal Keyboard / Mouse Controls menu.

• Bindings remain per-character.

• Escape cancels changes.

• Delete clears a binding.

• Added a HearthLogistics reset-bindings option.

• Mod shortcuts are suppressed while the Controls menu is open.

Fixes & Reliability

• Improved persistent container configuration synchronization.

• Added stronger protection against conflicting configuration updates.

• Improved rollback when transfers or upgrades fail.

• Fixed stale nearby-storage information causing incorrect building shortages.

• Fixed several container icon-positioning issues caused by open lids, snow meshes and decorative geometry.

• Improved diagnostics for Deposit, Restock, Download, portals and container configuration.

0.3.5

Major logistics expansion since 0.2.12.

Added

• Download nearby resources from accessible storage directly into your inventory or an open chest/cart.

• Search nearby resources by localized item name or category.

• Download a specific quantity or use Max.

• Optional Ignore weight limit preference for Download.

• Build from nearby storage using eligible chest and cart resources.

• Multiple Overflow destinations with Priority-based routing.

• Optional Treat Unconfigured Chests As Overflow.

• Optional Service Structures During Deposit.

• Mead fermenter servicing and finished-product collection.

• Optional highlighting for Overflow containers.

• Read-only container contents summaries while hovering.

Storage & Servicing

• Service Base can use carried supplies before nearby storage.

• Supported structures can be configured with material and fuel policies.

• Chests and carts support:

  • Filters

  • Min / Max stock rules

  • Fill Available Space

  • Priority

  • Overflow

• Cart configuration travels with the cart.

• Download, crafting and building use nearby resource information with live validation before transfers.

Notes

• HearthLogistics is client-side only.

• No server plugin is required.

• Automatic operations respect container ownership and access.

• Fermenter collection checks destination capacity before collecting output.

0.2.12

Initial public HearthLogistics release.

Features

• Personal inventory profiles.

• Item Min / Max rules.

• Physical inventory slot locks.

• Container filters and stock rules.

• Fill Available Space.

• Priority and Overflow storage.

• Container layout templates.

• Deposit.

• Restock.

• Rebalance.

• Supported structure servicing.

• Observed output collection.

• Nearby-storage support for normal crafting.

• Local settings and configurable controls.

• Diagnostics.

• Shared container configuration.