Runic Storage

Version 1.3.12

See what a chest contains, send loot where it belongs, restock supplies, and search nearby storage. Runic Storage adds chest rules, labels, and convenient inventory controls while keeping your items in ordinary Valheim containers.

New: Quick Stack one stack

Hold Ctrl + Shift and left-click a carried item to send only that stack into eligible nearby storage. This works with a chest open or with just your inventory open. The opened chest can receive items when its rules match, and other stacks of the same item stay in your inventory. If storage fills up, the remainder stays carried.

Ctrl + left-click keeps its vanilla transfer behavior. Clicks on items inside a chest are unchanged. Single-stack Quick Stack follows the same range, chest rules, and item protections as Quick Stack All.

Change Keys.QuickStackSingleModifier to customize the held keys, or set it to None to disable the shortcut. Left and right Ctrl, Shift, and Alt work interchangeably.

Controls

Quick Stack All works while standing near storage or with only your inventory open. Use the single-stack shortcut to route individual items while a chest is open. Restock and Search also work with a chest open.

Controller bindings are configurable. Hold JoyAltKeys, then use D-pad Down for Quick Stack, Up for Restock, Right for Search, Left for Consolidate, or JoyRStick to sort the opened chest.

Chest previews and search

Hover over an eligible chest to preview its contents. Search shows item kinds found in nearby accessible chests. Choose an item to highlight matching chests with animated yellow rings and light for 15 seconds.

Customize the search window through Search.MenuFontSize and Search.MenuFontColor. Font size ranges from 10 to 32. Available colors include Light Gray, White, Gold, Yellow, Orange, Red, Pink, Purple, Blue, Cyan, Turquoise, Green, and Lime.

Quick Stack rules

Open a placed chest and choose Quick Stack Rules.

• Remember contents learns stored item types so Quick Stack can refill the chest even after its last item is removed.
• Always accept selects exact item types. Groups accepts categories such as wood, ores, food, tools, or ammunition.
• Only from biome restricts accepted items to selected biome associations. Any biome clears that filter.
• Never accept excludes items from Quick Stack deliveries to this chest.
• Preferred prioritizes this chest over equally specific Normal chests. Distance breaks remaining ties.
• Accepted and Remembered let you review or remove selected and learned entries.

Routing prefers exact-item rules, then narrow groups, then broad groups. Chests without positive rules use remembered items or matching current contents. Full and inaccessible destinations are skipped.

Rules apply to both Quick Stack shortcuts. Manual transfers, Store All, crafting, and production can still place other items in the chest or consume its final item.

Biome groups describe an item's associations, not where that particular stack was collected. Use exact-item rules or custom groups for modded items without a built-in biome association.

Custom groups

Open Custom groups, select New group, name it, and choose members under Items. Select Save group, apply it under Groups, then save the chest's rules.

Applied groups are saved with the chest. Editing a reusable group does not change chests that already use it; deselect and reselect the group on those chests to apply the changes. Each library or chest supports up to 16 custom groups with 128 items per group. Chests also support up to 128 exact accepted types, excluded types, and remembered types each.

Chest labels

Add automatic or custom labels to the Front, Back, Left, Right, or Top of a placed chest. Choose a text color, Transparent/White/Black background, size, and position. Labels follow the chest, including its opening lid. No separate sign or materials are needed.

Automatic labels show up to three selected or remembered designations. Enter custom text to replace the automatic caption. Front is the chest's forward face; Left and Right are viewed while facing it. Adjust positioning for unusual chest shapes.

Bend and wrap

Choose Bend… in the rules editor. Up / down and Forward / backward each have minus/plus controls and a numeric field. Start with 1 or -1; decimals allow smaller changes. Zero is flat.

For rounded containers, enable Wrap around container. A wrap adjustment of 0 fits the container's bounds; negative values flatten the curve and positive values tighten it. Wrapping is available on the four side faces. Reset bends clears both bends and turns wrapping off.

Choose Done, then Save in the chest editor. Cancel discards your changes. Existing labels and rules are retained when updating.

Emojis

Choose Emojis beside the label field to insert one of 64 Food, Materials, Equipment, or Places icons. Supported emojis can also be pasted. Chest captions allow 96 UTF-16 units; each bundled emoji uses two units. Flags, skin tones, joined sequences, and emojis outside the picker are not included.

Emoji artwork: Twemoji, copyright Twitter, Inc. and other contributors, CC BY 4.0, from jdecked/twemoji. The graphics license is included in the DLL.

Installation and configuration

Install with a Thunderstore-compatible mod manager. BepInEx is the only required dependency. For a manual installation, place the DLL and its Translations folder together under BepInEx/plugins/RunicStorage.

Settings are stored in BepInEx/config/chazman.RunicStorage.cfg. Configuration Manager is optional. The included RunicStorage.cfg.example shows common settings.

Install the same version on participating clients and the server/host. Install it on hosts that add or remove chest items to keep automatic learning consistent. No other Runic mod is required.

Item protection and multiplayer

Storage uses loaded, accessible chests whose contents are synchronized. Chests another player is using are skipped. Your own opened chest is available to single-stack Quick Stack when its rules match. Wards, chest access restrictions, item capacity, and protected slots remain in effect.

Equipped items and configured hotbar protections are respected. With Runic Inventory installed, its Quick Stack slot locks also apply. If protection cannot be checked, the action stops. Crafting, Storage, and Production coordinate chest transfers when installed together.

Search and hover never move items. If a transfer is interrupted and requires recovery, inspect the affected items before continuing.

ItemDrawers and modded containers

Makail's ItemDrawers support is included. Assign an item to the drawer first. Quick Stack can refill an assigned empty drawer and deposit up to its capacity; it does not assign blank drawers.

[Modded Containers]
QuickStackPrefabIds = piece_drawer
PullPrefabIds = piece_drawer

QuickStackPrefabIds controls deposits; PullPrefabIds controls Restock. Blank lists disable the corresponding drawer support. RunicCrafting has its own pull settings. Ordinary modded chests using Valheim's normal inventory work automatically; this drawer support is for Makail's original ItemDrawers.

Spawned items follow ItemDrawers' normal deposit behavior. Items with incompatible quality, durability, custom data, or crafter information stay carried. Withdrawn items use normal backpack stack limits.

Languages

Runic Storage follows Valheim's selected language. Files belong in Translations/RunicStorage beside the DLL. Missing entries fall back to English. To add a translation, copy English.json to a file named for the selected language and translate the values while keeping the keys unchanged.

Support My Work

Support My Work

Changelog

1.4.1 — Trash shortcut compatibility

• Fix Shift+Alt+right-click also toggling RunicInventory's yellow cell lock.
• Guard the pointer-lock operation while trash owns the shortcut.
• Preserve existing locked cells and ordinary Alt+right-click locking/unlocking.
• Keep RunicInventory optional, with explicit compatibility load ordering.

1.4.0 — SmartSort & Inventory Trash

• SmartSort: preview and organize nearby chests with Left Alt + O, grouping similar materials, consolidating compatible stacks, and applying automatic chest labels.
• Honor manually configured chests as matching destinations while preserving their existing contents, positions, rules, and labels.
• Prepare previews incrementally and revalidate inventories and access before applying changes.
• Inventory Trash: Shift + Alt + right-click multiple stacks for bright red selection, then use the new trashcan between the inventory weight and armor values.
• Add a permanent-deletion prompt with Confirm, Cancel, and Reset; show the total item quantity selected.
• Protect hotbar cells, RunicInventory's dedicated armor/quick-slot row, locked cells, empty cells, equipped items, and quest items. Ordinary bottom rows remain usable.
• Use Valheim's keyboard input for trash selection and confirmation dismissal.
• Preserve the latest single-stack Quick Stack, localization, font initialization, and chest-access compatibility improvements.
• Keep optional performance logging disabled by default. This release does not claim to resolve all world-related stutters.

1.3.12

• Added single-stack Quick Stack: hold Ctrl+Shift and left-click a carried item to route only that stack into nearby storage.
• Works with a chest open or with only your inventory open, using existing chest rules, range, and item protections.
• Added configurable shortcut modifiers through Keys.QuickStackSingleModifier.
• Preserved vanilla Ctrl+left-click transfers and chest-side clicks.

1.3.11

• Fixed nearby chest access becoming stuck when using ServersideQoL.

1.3.10

• Improved chest synchronization after ownership changes.

1.3.9

• Improved shared chest access when multiple mods request items or players open and close chests.
• Improved font loading for chest labels, rules, tooltips, and search.

1.3.8

• Clarified messages for busy storage and transfers requiring recovery.
• Prevented an interrupted chest sort from blocking an untouched player inventory.

1.3.7

• Added language files that follow Valheim's selected language, with English fallback.

1.3.6

• Improved coordination with Crafting and Production when using the same chests.
• Improved synchronization and interrupted-transfer handling.
• Preserved an ItemDrawer's assigned item after withdrawing its final item.

1.3.4

• Fixed Quick Stack deposits of spawned items into Makail ItemDrawers.
• Added clearer feedback for unsupported item attributes and full storage.

1.3.3

• Added rounded-container wrapping for chest labels, with fine adjustments.
• Preserved existing labels, bends, and chest rules.

1.3.2

• Added independent up/down and forward/backward chest-label bends.
• Added fine adjustments, decimal values, and Reset bends.

1.3.1

• Added configurable Makail ItemDrawers support for Quick Stack and Restock.

1.3.0

• Added a 64-emoji picker and full-color emoji labels.
• Retained Quick Stack-only slot locks with RunicInventory.

1.2.5

• Added RunicInventory's Quick Stack-specific slot protection while leaving other inventory actions available.

1.2.4

• Fixed Quick Stack stopping after successfully moving a full stack into a rule-based or remembered chest.
• Kept partial stacks moving to additional eligible destinations.

1.2.3

• Corrected label placement on chest faces and opening lids.

1.2.2

• Fixed tiny chest labels and biome-only automatic captions.
• Prevented movement and gameplay shortcuts while editing rules or search text.

1.2.1

• Added Transparent, White, and Black label backgrounds and improved label colors.

1.2.0

• Added item groups, biome filters, exclusions, priority, and reusable custom groups.

1.1.0

• Added remembered contents, per-chest Quick Stack rules, and exterior labels.

1.0.6

• Fixed opened-chest actions and chest previews for durability-bearing items.

1.0.5

• Improved transfers involving worn tools, partial capacity, and temporarily unavailable chests.

1.0.4

• Improved nearby storage access in multiplayer while preserving busy-chest protection.

1.0.3

• Updated inventory actions for Valheim 1.0.

1.0.2

• Updated the mod description and usage guide.

1.0.1

• Fixed Quick Stack being unavailable immediately after entering a world.

1.0.0

• Added standalone storage tools with BepInEx as the only required dependency.
• Included chest previews, Quick Stack, Restock, Search, Sort, Store All, and Consolidate.
• Added searchable nearby items, chest highlights, and configurable search appearance.