Runic Storage

Version 1.4.1 — SmartSort & Inventory Trash

Turn a collection of mixed chests into organized, labeled storage, then clear unwanted inventory items with a protected, multi-select trashcan. Runic Storage 1.4.1 brings SmartSort and Inventory Trash into the main mod alongside Quick Stack, chest rules, restock, search, and customizable labels.

1.4.1 hotfix: Shift + Alt + right-click now selects trash without toggling RunicInventory's cell lock. Ordinary Alt + right-click still locks and unlocks cells.

SmartSort: organize your storage area

SmartSort looks at the items in nearby chests, groups similar materials, combines compatible stacks, and automatically labels the results: Wood, Ores, Metal Bars, Food, and more. When space is limited, a chest may hold mixed categories. Empty chests become Spare Storage.

1. Stand near at least two accessible chests and close your inventory.
2. Press Left Alt + O to prepare a preview of the proposed chest contents.
3. Review the preview, then press Left Alt + O again within 30 seconds to apply it. Escape cancels.

Your configured chests remain destinations. SmartSort can add matching items according to their existing rules without taking away their contents, rearranging their existing stacks, or replacing their rules and labels. Other eligible chests supply the items and receive the remaining category groups.

The default SmartSort radius is 10 meters, adjustable through SmartSort.RangeMeters and capped by the overall Storage range. SmartSort.OrganizeKey changes the shortcut; SmartSort.Enabled turns this feature off. Busy, inaccessible, private, or unsynchronized chests are skipped. SmartSort uses ordinary Valheim container inventories; ItemDrawers retain their separate Quick Stack/Restock support.

SmartSort checks that inventories, access, and rules still match the preview before applying changes. Configured container LockedSlots prevent SmartSort from running; chests containing protected items are skipped. A pre-apply diagnostic snapshot is saved under BepInEx/config/SmartSortBackups; it is recovery information, not an in-game Undo button.

Inventory Trash: select, review, delete

The trashcan sits between the weight and armor values beside the player inventory. Hold Shift + Alt and right-click an item to select it. Selected cells show a bright red outline; repeat the shortcut to unselect a stack. Select as many eligible stacks as you need, then click the trashcan.

The prompt asks “Permanently delete XX items?”, counting the individual items across all selected stacks.

Protected: hotbar cells, RunicInventory's dedicated armor/quick-slot row, locked cells, empty cells, equipped items, and quest items. Ordinary inventory rows—including the ordinary bottom row—can be selected. RunicInventory is optional; its existing yellow slot locks are honored when installed. Normal Alt + right-click locking remains available.

Moving or changing a selected stack clears its selection. Confirm rechecks the exact items and their protections before deletion. Closing the inventory clears the selection. Set Inventory Trash.Enabled = false to disable the trashcan.

Updating to 1.4.1

Update the existing RunicStorage package; both features are now included. Existing RunicStorage settings, chest rules, and labels are retained. If you used the separate SmartSort test build, disable or remove that test plugin before enabling RunicStorage 1.4.1. They must not run together. Test-build settings stay in their separate config; adjust the new settings in chazman.RunicStorage.cfg as needed.

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.2 — Native ownership recovery

• Recover nearby chest access after native ownership changes without a matching Runic handoff receipt. The server independently confirms the current ownership generation, data revision, and saved item fingerprint before the client refreshes and resumes. Stale or mismatched snapshots, busy chests, and denied access remain blocked.
• Preserve native ownership, material accounting, access checks, and rollback behavior.
• Add bounded server confirmation requests and reject stale or spoofed acknowledgements.
• Update matching companion builds together and restart both client and server.

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.