Viking Crafting & Quick Deposit

Spend less time moving supplies between your pockets and your chests. Manually deposit matching items, restock your chosen supplies, craft and build from nearby storage, and find where you put things.

Built primarily for a private local Valheim server, with configurable settings for other servers. Compatibility with every mod combination is not guaranteed. AI-generated software.

Features

• Manual quick deposit: press Period to move eligible items into chests containing the same item type. There is no automatic pickup routing. Deposit and restock share a three-second client/server cooldown.
• Exact restock targets: choose a total for each supply, from 1 to its maximum stack. Setting three foods to 2 tops each food up to 2; it does not take two extra each time. Your chosen totals are also kept when depositing.
• Crafting from storage: missing ordinary ingredients are gathered into your inventory before the normal craft or upgrade runs. Crafting stations and their levels still matter.
• Building from storage: a placement attempt gathers missing materials. Once the readiness message appears, place the piece again. You need room in your inventory for the gathered materials.
• Chest search: Ctrl+F opens a searchable inventory overview. Locate adds a temporary map ping, outline and distance marker; the marker follows moving cargo.
• Recipe discovery: learn materials from accessible chests through the game's normal discovery system.
• Personal protection: item blacklists, protected inventory slots, hotbar protection and restock reserves. Equipped and quest items are excluded from quick deposit.
• Chest controls: buttons on the open chest independently enable or disable quick deposit, crafting pulls and building pulls. Set priorities to prefer particular chests.
• Boat and wagon cargo: native Container-based vehicle inventories use the same storage rules. Unusual custom inventory systems may need their own adapters.
• Optional Epic Loot support: automatically detects Epic Loot for rarity/effect search and item handling. Transfers preserve native item state and custom data. Enchanted equipment deposit requires explicit opt-in; ordinary material pulls exclude enchanted and custom-state items.
• Brief result messages: quantities, unavailable supplies and pending results appear as fading text, without a confirmation screen.

Controls and settings

Keys and ranges are configurable. Server range settings apply to connected clients. Open the search window's Deposit & restock rules tab to set a blacklist and supply totals, or Protected slots to reserve inventory positions. Favorites stay with their slots when items move.

Quick deposit matches existing item types. Put one of an item in its intended chest first. Identical names alone do not permit stacks with different custom state to merge.

Installation

Install BepInEx and this same mod build on the dedicated server and every participating client. Epic Loot is optional and is not installed as a dependency. Restart the game/server after installation. Configuration is generated at BepInEx/config/JacobsValheim.VikingCraftingAndQuickDeposit.cfg.

For manual installation, copy the package's BepInEx folder into the game/server folder. Use a separate mod-manager profile and disposable world for initial multiplayer validation. Disable overlapping storage action features in that test profile to avoid competing keybinds or inventory operations.

Current 0.0.1 limits

Only loaded, accessible containers are available. A 250-metre range setting does not load distant chests. Whole-base access to unloaded storage is still in development.

Backpack inventories are not scanned. Craft/build gathering may leave a partial quantity in your bag if a chest becomes unavailable; no craft output is created until the normal game requirements are met.

If a transfer is interrupted, its local recovery record blocks a new transfer. Pressing deposit/restock again checks the original inventories. It clears the record only when all inventories exactly match the recorded complete or unchanged state. An ambiguous result needs manual review; the mod does not blindly replay or refund items. Keep configuration/recovery files when investigating an interrupted transfer.

Viking Storyteller event integration is planned separately and is not active in this build.

Validation status

Automated model tests and isolated native game-process tests cover item preservation, deposit, restock, crafting, a Legendary upgrade, native chest/cart/boat inventories and exact-state recovery, with and without Epic Loot. These do not substitute for a real two-client session. Graphical interaction, multiplayer contention and disconnect tests are pending before publication.

This document describes the mod as a whole. Release changes belong in the changelog.

0.0.5

• Fix Epic Loot materials incorrectly showing as missing even when carried in inventory.
• Recognize standard Epic Loot crafting material metadata without stripping it or allowing unknown chest item metadata to be consumed.
• Pull only the missing amount for mixed inventory/storage enchanting costs, while preserving native carried-item behavior.
• Handle zero-cost entries and preserve native inventory enchanting if storage preflight is unavailable.
• Use Viking Storyteller 0.4.9 for storage ledger integration with this version.

0.0.4

• Add built-in shared chest viewing with coordinated transfers, splitting, swapping, take-all, stack-all, sorting and settings.
• Add stone oven/cooking-rack and shield-generator fuel/input pulls; extend native fuel coverage.
• Request an exclusive owner handoff for automatic fire, torch and brazier refilling.
• Add optional Epic Loot enchanting, conversion, augmentation and disenchanting material pulls.
• Add a drag-to-trash inventory button with equipped, quest, locked and protected-slot safeguards.
• Prune unloaded storage references on clients and servers; remove repeated full inventory-map searches when refreshing one chest.
• Keep transfers pending until the server observes the changed chest contents; reject stale replies and retain ambiguous outcomes without automatic refunds or retries.
• Retain bounded before/after transfer evidence. Network confirmation does not replace Valheim character/world backups or prevent character-save rollbacks.
• Fix battering ram wood input by resolving its parent network view; verify carried wood first and chest fallback with the original prefab geometry.

0.0.3

• Locate lasts 20 seconds; highlight geometry follows chest rotation, including vehicle tilt.
• Search loads on open or Refresh storage. Background recipe discovery no longer rewrites its visible snapshot.
• All matching stacks are accessible in one scrollable list, with only visible rows drawn. Opening resets old text and rarity filters.
• Item and enchantment search excludes the container name/type.
• The search window consumes gameplay mouse-wheel zoom input while retaining UI scrolling.
• Deposit icons rise vertically for 0.8 seconds, then arc toward their destination. Three-second default duration, larger icons, staggered starts, configurable 2–8 seconds. Effects remain cosmetic and occur only after confirmed transfers.
• Recipe-list availability includes chest ingredients when refreshed inside the native crafting call. Material consumption remains limited to gathered backpack ingredients.
• Optional Storyteller reporting requires Storyteller 0.4.7 for its strict storage-version compatibility check. No transfer schema change.

0.0.2

• Add manual chest-supplied fuel and machine input for fires, torches, braziers, smelters and kilns.
• Add persistent Alt+Interact automatic fuel toggles on fires, torches and braziers, with owner/access/capacity checks.
• Show required (available) material counts and inventory/storage subtotals.
• Add Alt-click item-rule cycling and LOCK / restock badges.
• Add larger search cards, native item icons, rarity colors, chest totals and sorting options.
• Add chest sorting that preserves existing item instances and metadata.
• Add optional flying item icons after completed deposits.
• Allow deposit/restock while holding movement and sprint keys.
• Index item locations, backfill existing loaded chests, update affected chests on inventory changes and add Refresh storage.
• Share the lightweight index with search; display basic rows first and enrich rarity/effects in batches, with explicit loading status.
• Cache unchanged search rows; batch background repairs.
• Skip irrelevant chests before requesting ownership for material pulls.
• Add distinct manual/automatic fuel-pull purposes for Storyteller 0.4.6.

Changelog

0.0.1

Initial development candidate: manual quick deposit, exact-target restock, loaded-storage material pulls, searchable inventories, chest controls, optional Epic Loot handling and conservative transfer recovery.

Publication is pending multiplayer validation and review. No earlier version of this package has been published.