Hearth Logistics

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

Reduce repetitive inventory management while keeping control of when items move. Configure personal inventory profiles and smart storage, then trigger Deposit, Restock, Rebalance or Service Base when you need them.

Install on the client only. No Hearth Logistics server plugin or component is required. The mod is intended for use with vanilla dedicated servers, and unmodded players can continue joining. See the multiplayer limits below.

Features

Inventory Profiles

Select a profile beside the normal inventory statistics. Choose Edit to create, rename, duplicate or delete profiles, set item Min/Max quantities and lock physical inventory slots. Switching profiles changes the rules used by Deposit and Restock; it does not move items by itself.

• Min 10 / Max 10: try to keep exactly 10 through Deposit and Restock.
• Min 5 / Max 10: Restock when below 5, up to 10; Deposit excess above 10.
• Blank Min means no refill requirement. Blank Max means no upper inventory limit; a Min-only rule restocks to Min.

Locked slots are left untouched by Hearth Logistics. Profiles and settings are saved locally per character. Item rows come from carried items plus existing rules, so rules remain editable when Current is zero.

Smart Storage

Open a chest to configure Hearth Logistics beside the normal container inventory:

• Item/category filters for individual slots, rows or the whole chest, with empty-slot ghost icons.
• Create filters from current contents, copy/paste layouts and named templates.
• Live Current, optional Min / Max, and Fill Available Space stock rules.
• Chest Priority and Overflow designation.

Fill Available Space dynamically uses compatible storage capacity instead of requiring a numeric Max. Higher priority is preferred for deposits; Overflow is a fallback. Slot filters and stock rules can be used independently. Chest configuration is stored through the shared ZDO rule system.

Logistics actions

• Deposit: moves eligible inventory excess into nearby configured storage, using the active profile and respecting locked slots, filters, priorities, Max limits and available compatible capacity. Uses Overflow as fallback. Deposit unlisted items is enabled by default.
• Restock: deposits profile excess first, then fills active-profile shortages from normal, filtered or Overflow storage. Chest Min and personal storage reserves remain protected; Max and Fill do not reserve stock. Placement filters do not prohibit withdrawing existing items.
• Rebalance: redistributes storage using stock Min/Max rules, compatible destinations and available supply. Configured-storage Rebalance is currently available in single-player; see multiplayer restrictions below.
• Service Base: optionally deposits excess and restocks the player, then services nearby supported objects. Depositing is on by default; player restocking is off. Service objects runs servicing separately.
• Servicing: supplies supported smelters, blast furnaces, charcoal kilns, windmills and spinning wheels, plus finite-fuel fires, hearths and ground/wall torches. Per-object policies control inputs, fuel permissions and refill thresholds; resin lighting has its own switch.
• Collect outputs: stores processor products observed spawning during the current session. Servicing also collects these when Collect observed outputs is enabled. It does not sweep arbitrary ground loot.
• Craft from storage: nearby eligible storage contributes resources to ordinary new-item crafting at a station. Cached availability keeps previews inexpensive; actual crafting validates live resources and rolls back staged ingredients if crafting does not complete.

Inventory rules versus chest rules

Inventory Profile: “What should I keep on my character?”

Chest Configuration: “Where should this item be stored, and how much should this chest hold?”

Chest placement filters guide deposits and sorting. Stored items remain eligible for Restock, subject to chest Min, personal storage reserves and normal access checks.

Installation

Requires BepInEx 5 on the client. This release is built against BepInEx 5.4.23.5 and Valheim 1.0.15. Harmony is supplied by BepInEx; Newtonsoft.Json and Unity assemblies are supplied by Valheim. Jotunn is not required. Dependencies are not bundled.

1. Install BepInEx 5 for your Valheim client and close the game.
2. Extract the release ZIP into the Valheim directory, preserving this structure:

Valheim/
└── BepInEx/
    └── plugins/
        └── HearthLogistics/
            └── HearthLogistics.dll

1. Start Valheim and look for Hearth Logistics 0.2.12 loaded in BepInEx/LogOutput.log.

Install nothing from this package on the dedicated server. To uninstall, close the game and remove the HearthLogistics plugin folder.

Getting started

1. Open your inventory, select Inventory Profile, then Edit to create or configure a profile.
2. Set Min/Max for carried items. While editing, hover a slot and press F4 to lock or unlock it.
3. Open a chest and use Configure Slot Filters and the stock-rule table. Give deposit destinations matching filters, stock rules or Overflow designation.
4. Close the inventory and press F6 to Deposit or F7 to Restock.
5. Configure servicing policies before using F8 Rebalance or F9 Service Base where supported.

Controls

Change these under Mod Settings → Hearth Logistics → Preferences. Action hotkeys operate during normal gameplay, outside inventory/settings menus. Slot locking only works in profile Edit mode, and text entry suppresses logistics hotkeys. Alt + right-click an inventory item opens the profile editor.

Configuration

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

• Inventory profiles: personal rules, profile management and Storage reserves shared across your profiles.
• Servicing: object policies, fuel/input permissions, thresholds and Refill Resin lighting.
• Preferences: hotkeys, notifications, crafting, action options, Debug Logging, Storage range (m) and Service range (m). Both ranges default to 20 m and can be set from 2–50 m.

No config-file editing is required. Personal data lives under BepInEx/config/HearthLogistics/<character-ID>.json; main-menu defaults use menu.json. Chest rules live on the chest's ZDO, not in those personal files.

Multiplayer / Dedicated Servers

Hearth Logistics uses client code and existing Valheim networking, without custom server code or custom server RPC handlers. Other players do not need the mod merely to join or play. Compatible modded clients read shared chest configuration from its ZDO; personal profiles remain local.

In this build, Deposit and Restock accept configured multiplayer chests. Rebalance, servicing storage sources/output destinations and nearby-storage crafting still exclude configured multiplayer chests. Consequently, configured-storage Rebalance is single-player only. Shared-rule relay, server-restart persistence and cross-client behavior should be checked on your server; they are not a blanket compatibility guarantee.

Performance and limitations

Local container caches, separate source/destination routing and aggregated crafting resources avoid repeated full chest scans. Restock validates hinted sources first and checks additional cached containers incrementally when needed. Crafting previews reuse resource snapshots; transfers validate live contents.

Actions require nearby, loaded, accessible objects owned by the local client. Busy/inaccessible containers and tombstones are skipped. There is no unattended or offline automation.

Nearby-storage crafting excludes equipment upgrades, special upgrader stations, one-of-ingredient recipes and no-cost crafting modes. Output collection only recognizes processor drops observed this session. Servicing covers supported processor/fireplace objects, not every crafting station or production system.

Debugging and feedback

Under Preferences → Debug Logging, choose:

• Off (default): routine diagnostics disabled; startup/error reporting remains.
• Normal: major actions and committed changes.
• Verbose: detailed rules, source decisions and performance summaries.

Logs are written to BepInEx/logs/HearthLogistics.log. With logging enabled, the chest panel also offers Dump Chest Debug and Refresh Logistics Panel.

Bugs, suggestions & feedback: Discord racidon.

For bug reports, include the Hearth Logistics, Valheim and BepInEx versions, what happened, and relevant HearthLogistics.log excerpts. Verbose logging can help reproduce a problem. No personal or private information is needed.

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.