You are viewing a potentially older version of this package. View all versions.
Zellds-SmartCraftStorage-0.1.0 icon

SmartCraftStorage

Automates chest storage in Valheim: quick-stack, restock, craft/build from nearby chests, auto-fuel and collect at fireplaces/smelters/kilns/cooking stations, auto-feed tameable animals, and repair everything at once.

By Zellds
Date uploaded a week ago
Version 0.1.0
Download link Zellds-SmartCraftStorage-0.1.0.zip
Downloads 27
Dependency string Zellds-SmartCraftStorage-0.1.0

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2350 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2350
ValheimModding-Jotunn-2.30.0 icon
ValheimModding-Jotunn

Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.

Preferred version: 2.30.0

README

SmartCraft-Storage

A personal Valheim 1.0 mod that combines storage and station automation into one cohesive package: mass-stashing items into nearby chests, crafting/building with materials pulled straight from chests without opening them, keeping fireplaces, smelters, charcoal kilns and cooking stations fueled and self-collecting, automatically feeding tameable animals from a nearby chest, and repairing all your gear at once.

Requires BepInEx and Jotunn.

  • Quick-stack: Press Shift + E to stash matching items into nearby chests.
  • Lock and restock: Alt + left-click locks an item so quick-stack never moves it. Alt + Ctrl + left-click marks it for restock instead.
  • Restock: Press Ctrl + E to refill every marked item to a full stack from nearby chests, even from zero.
  • Crafting and building: Use materials from nearby chests within a configurable radius (default 20m) — no need to open them.
  • Repair-all: The station's Repair button fixes every repairable equipped item in one click instead of one at a time.
  • Fuel and ingredients: Fireplaces, smelters, charcoal kilns, and cooking stations pull fuel/ingredients from nearby chests and store their output automatically — each behavior toggleable on its own.
  • Animal feeding: Automatically feeds hungry tameable animals from nearby chests, taming or already-tamed.

Hotkeys

All hotkeys use E as the base key, combined with a modifier. They work with a free cursor (no need to have a chest open).

Hotkey Action
Shift + E Quick-stack: stashes items from your inventory into nearby chests that already contain that item. Locked (🔒) and equipped items are never moved.
Ctrl + E Restock: pulls from nearby chest(s) enough of each item marked for restock to fill a full stack in your inventory — even if you currently have none of that item.
Alt + left-click on an inventory item Toggles the lock (🔒) on that item — a locked item is never moved by quick-stack.
Alt + Ctrl + left-click on an inventory item Toggles the restock mark (🔵) on that item — defines the list Ctrl+E uses.

Both modifier-clicks replace the normal click (they don't open/move the item) only while the modifier is held.

Nearby chests: how they're chosen

Every automation in this mod (quick-stack, restock, crafting-from-nearby- chests, the 4 stations, and the automatic animal feeder) uses the same rule to decide which chests count as "nearby":

  • Within the configured radius (see the configuration section)
  • Not a dead player's coffin (TombStone)
  • Not currently in use by anyone else (open by another player)
  • You have access permission on the chest (respects public/private/group)
  • The chest is inside a Ward (protection) area that grants you access — a chest outside your ward, or inside someone else's ward without permission, is ignored

Works in multiplayer: when the mod needs to write to a chest owned by another player (different ZDO owner), it claims ownership before touching it, the same way the game itself does when you open a chest manually.

Mass storage (Quick-Stack)

Shift + E — for each item in your inventory (except equipped and locked items), looks for a nearby chest that already has that item (same name and quality) and moves it there. It tops off existing stacks in the chest first; if there's leftover quantity and the chest has free space, it creates a new stack there too. It only moves an item into a chest that already contains it — this isn't a "stash everything," it's "find where that item already lives."

Item lock

Alt + left-click on an item marks it with an orange border. A locked item is never moved by quick-stack, even if a chest with that same item is nearby. Useful for keeping ammo, food, or building material always in your inventory.

Restock

Mark which items you always want restocked with Alt + Ctrl + left-click (marks it with a blue dot in the corner of the slot). Then, Ctrl + E pulls enough of each marked item from nearby chests to fill a full stack in your inventory — even if you currently have zero of that item. Example: mark arrows and cooked meat; every time you press Ctrl+E, it fills your inventory with both from whatever's in nearby chests.

Crafting and building from nearby chests

While crafting at a workbench/forge/etc. or building (hammer in hand), the game treats items in nearby chests as if they were in your inventory — without needing to open any chest. It always prioritizes consuming what you're already carrying first, only pulling from a chest for what's missing. The count shown in the crafting UI already includes nearby chests too.

Repair-all

At a crafting station (workbench, forge, etc.), the Repair button now fixes every equipped item the current station can repair in one go — instead of having to click repeatedly until nothing's left. It respects the exact same vanilla rule (station level vs. the item's minimum required level): an item that needs a more advanced station still won't get repaired there. No extra on-screen message, no configuration — just instant repair.

Automatic stations

The 4 station categories pull material from nearby chests on their own and store the output instead of dropping it on the ground. Each has its own radius and can be disabled individually (see the configuration table). Skill XP (Cooking) from automatic food collection always goes to whoever owns the station (typically whoever built it or interacted with it first) — in multiplayer, not necessarily whoever's nearby or supplied the ingredient.

Fireplace, torch and hearth

Refuels fuel (wood, resin, etc.) by pulling from the nearest chest until full, one unit at a time. It has no buffer/queue — it's just a fuel tank, so it tops up to the max whenever there's room.

Smelter (ore forge)

Automatically pulls ore and fuel from nearby chests and stores the produced bar in the nearest chest with space. If no chest has room left, the remainder drops on the ground as usual (default game behavior, with no duplication or loss of what was already stored).

Charcoal kiln

Same radius as the smelter (configured together). Unlike the fireplace, it has a configurable buffer (default: 3) — it only keeps that much wood in its internal queue instead of filling it all at once, letting ongoing production finish before pulling more. It also has a configurable cap on coal accumulated in nearby chests: past that cap, it stops pulling new wood (without interrupting what's already processing). The coal it produces first tries to feed nearby smelters that are low on fuel (configurable strategy: prioritize the one with the least fuel, or the nearest one); only the leftover goes to a chest.

Cooking station (fire spit, cauldron, etc.)

Pulls raw food (and its own fuel, if the station uses one) from nearby chests and cooks on its own. When an item finishes cooking, it's collected automatically and stored in the nearest chest — no need to interact with the station to take the finished food. Automatic collection goes through the same code path as a manual interaction, so skill XP and yield bonuses keep working normally (see the note above about who gets the XP).

Automatic animal feeding

Tameable animals (boar, wolf, lox, and any other creature with the game's own taming component) that are hungry automatically pull compatible food from a nearby chest — both while taming a wild animal and afterward, to keep breeding active in a pen. The mod spawns the actual food item near the animal (it doesn't magically make the animal "fed"): the animal walks over and eats it normally, with the same animation as always — only the food's source (a chest instead of you manually dropping it) is automated. Each species only ever receives an item it actually accepts (the same list the game itself already uses to decide what that animal eats).

Note: this automation also feeds wild animals that aren't tamed yet, or any tameable creature that isn't in alert/combat mode, as long as there's a chest with compatible food within range — it doesn't distinguish "this one I want to feed" from "this one's just passing by the chest."

Configuration

All options live in BepInEx's Configuration Manager, split into four sections.

Radii (storage/restock/crafting-from-chest):

Option Default Description
QuickStackRadius 20m Radius in which quick-stack and restock search for chests
CraftingChestRadius 20m Radius in which crafting/building considers items from nearby chests

Stations (radii and per-behavior on/off):

Option Default Description
FireplaceRadius 10m Radius for fireplaces/torches/hearths
SmelterKilnRadius 10m Radius shared between smelters and charcoal kilns
CookingStationRadius 10m Radius for cooking stations
FireplaceAutoRefuel on Fireplaces automatically pull fuel
SmelterAutoRefuel on Smelters automatically pull ore/fuel
SmelterAutoCollect on Smelters store their output in a chest
KilnAutoRefuel on Kilns automatically pull wood
KilnAutoCollect on Kilns store/redirect the coal they produce
CookingStationAutoRefuel on Cooking stations automatically pull raw food/fuel
CookingStationAutoCollect on Cooking stations collect and store on their own

Charcoal kiln (kiln-specific tuning):

Option Default Description
KilnWoodBuffer 3 Wood level kept in the internal queue (not the kiln's max capacity)
KilnMaxCoalInChest 50 Coal cap in nearby chests before pausing new wood pulls
KilnFeedStrategy LeastFuelFirst How to pick which nearby smelter to feed first: LeastFuelFirst or Nearest

Animals (automatic feeding):

Option Default Description
AnimalFeederRadius 20m Radius in which hungry tameable animals search nearby chests for food
AnimalAutoFeed on Tameable animals automatically pull compatible food from nearby chests

Every option also has its own description inside the Configuration Manager.

CHANGELOG

Changelog

0.8.0

  • Fixed the available-amount text (10(34)) overflowing into the next ingredient slot on crowded recipes; it now shrinks to fit instead
  • Added AvailableAmountFormat to choose how that number is written: Compact (abbreviates past a thousand, e.g. 1.1k), Exact (the full number), or Spaced (the full number at the original size, like before this update) (community contribution by uy8Uk4N56G)

0.7.0

  • Alt + left-click locks on chest stacks are now reserved from crafting, building, station fuel/inputs, and Epic Loot's Enchanter, so a locked stack is never spent automatically. Locked equipment, including what you're carrying, is also protected from Epic Loot's Sacrifice: a selection that includes a locked item is canceled instead of consuming it (community contribution by EremesNG)
  • Fixed lock and restock marks getting left behind in empty inventory slots when other UI mods (such as Shield Me Bruh) copy item icons. Marks also now follow items moved into ExtraSlots and keep their size when MyLittleUI scales icons (community contribution by EremesNG)

0.6.0

  • If you also have Epic Loot installed, the Enchanter can now use materials from nearby chests too, the same way crafting and building already do. Not required, only kicks in when Epic Loot is present

0.5.1

  • Fixed an edge case where undoing a partial automatic beehive collection (when a nearby chest couldn't fit everything) could remove honey that was already sitting in the chest instead of just the honey that had been added (community contribution by ManuelROAL)

0.5.0

Community contribution by uy8Uk4N56G:

  • Further reduced stutter/freezing while crafting or building near chests, building on the fix from 0.4.1
  • Fixed a rare multiplayer issue where writing to a chest at the same moment another player opened it could cause problems
  • Crafting and building now show how much of each material you actually have available (inventory plus nearby chests), not just how much is needed. Toggle this off in the settings if you prefer the old look
  • Cleaned up some unnecessary warnings that could show up in the mod's log
  • Now requires BepInExPack 5.4.2350 or newer

0.4.2

  • Fixed a beehive item duplication bug: if the automatic honey collection could only partially fit the harvested honey into nearby chests, the leftover was also duplicated on the ground instead of just the leftover being dropped
  • Automatic beehive collection now leaves the honey queued in the hive (instead of dropping any of it) when no nearby chest can fit it all; manually interacting with the hive still drops the leftover on the ground as usual

0.4.1

  • Fixed a performance issue where crafting/building from nearby chests could re-scan for chests dozens of times per frame while the crafting panel or the build piece list was open, potentially stalling the host long enough to disconnect other players. Nearby-chest results are now cached for 0.1s and refreshed immediately after an actual consumption, instead of re-scanning on every check

0.4.0

  • Fermenters now auto-pull any mead/potion base from nearby chests and auto-collect the finished product once ready, with their own radius (FermenterRadius, max 25m) and an optional duration override (FermenterDurationOverride, 0 = keep the vanilla duration)
  • New experimental feature, off by default: PlantAutoHarvest auto-harvests ripe cultivated crops near the player into the nearest chest (its own radius, PlantHarvestRadius, max 25m); marked in test since the game only exposes one flag to tell a farmed crop apart from a wild pickable

0.3.0

  • Beehives now harvest honey automatically as soon as it's ready and store it in the nearest chest, no need to visit the hive (BeehiveRadius/BeehiveAutoCollect)
  • Charcoal kilns now default to pulling only regular Wood from nearby chests instead of any wood type, since Fine Wood and Core Wood convert to coal at the same rate and burning them was pure waste (configurable via KilnRegularWoodOnly)

0.2.0

  • Nearby chests are now searched nearest-first, so automations that stop at the first usable chest prefer the closest one (community contribution by BearFlinn)
  • Servers running this mod can now set gameplay config (radii, all station toggles, kiln settings, animal feeder) for every connecting client; hotkeys always stay per-player (community contribution by BearFlinn)

0.1.3

  • Hotkeys are now fully configurable: QuickStackShortcut/RestockShortcut let you set any key combo via the Configuration Manager (click and press), no fixed base key
  • Lock and restock-mark click combos (LockClickShortcut/RestockMarkClickShortcut) are also configurable, and fully independent of each other (marking for restock no longer requires the lock combo to also be held)
  • Config section names are now all in English for consistency
  • Quick-stack and restock on-screen messages are now localized (English, Portuguese-Brazilian, Spanish)
  • Removed the on-screen action hint that was tied to the old fixed hotkey registration

0.1.2

  • Set the website link (GitHub repo) in the package metadata
  • Trimmed the README down to a quick reference; full docs moved to the wiki

0.1.1

  • Declared BepInExPack_Valheim as an explicit dependency (was only pulled transitively through Jotunn)

0.1.0

  • Initial release
  • Quick-stack (Shift + E), item lock (Alt + left-click), and restock (Ctrl + E, mark items with Alt + Ctrl + left-click)
  • Crafting and building using materials from nearby chests
  • Repair-all at crafting stations in one click
  • Automatic fuel/ingredient pulling and output collection for fireplaces, smelters, charcoal kilns, and cooking stations
  • Automatic feeding of tameable animals from nearby chests