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

Action	Default control	Result
Quick Stack one stack	Ctrl + Shift + left-click a carried item	Routes only the clicked stack into nearby storage
Quick Stack All	Left Alt + Q	Routes eligible carried items into nearby storage
Restock	Left Alt + R	Pulls configured supplies up to their target quantities
Search	Left Alt + F	Opens a searchable list of nearby stored items
Sort opened container	Left Alt + S	Sorts the opened chest while preserving locked slots
Store All	Left Alt + A	Moves eligible carried items into the opened chest
Consolidate	Left Alt + C	Combines compatible carried partial stacks

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.

Group	Examples
Equipment	Weapons, Shields, Armor, Capes, Tools
Ammunition	Arrows, Bolts, All Ammunition
Consumables	Food, Health Foods, Stamina Foods, Balanced Foods, Eitr Foods, Potions
Resources	Wood Materials, Stone Materials, Ores, Metal Bars, Seeds, Crops, Animal Materials
Other	Trophies, Valuables, Crafting Ingredients
Biomes	Meadows, Black Forest, Swamp, Mountains, Plains, Mistlands, Ashlands, Deep North

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