QuickStackPlus

QuickStackPlus is an inventory and storage management mod for Valheim focused on making item handling faster without taking control away from the player.

Quick Stack, Smart Storage filters, sorting, item blacklisting and trash management are combined into one lightweight system designed for both single-player and multiplayer.

Features

• Quick Stack – Instantly move matching items from your inventory into nearby containers.
• Smart Storage – Choose exactly which item types each container is allowed to store using a searchable filter menu.
• Container Sorting – Sort container contents on demand with a dedicated Sort button. Containers are never automatically rearranged when opened.
• Inventory Sorting – Quickly organize your player inventory with the built-in sorting system.
• Item Blacklist – Protect selected stacks from Quick Stack with Left Alt + Right Click. Blacklisted items stay in your inventory.
• Trash / Junk System – Mark unwanted items with Shift + Right Click and delete marked junk when you are ready.
• Visual Item Markers – Blacklisted and trash-marked items are clearly highlighted directly in the inventory.
• Configurable Shortcuts – Quick Stack, sorting and Smart Storage controls can be customized per player.
• Configurable Search Radius – Set how far Quick Stack searches for nearby containers, up to 80 metres.
• Multiplayer Friendly – Core settings can be controlled by the server while personal UI and shortcut preferences remain client-side.
• No Container Ownership Restriction – Quick Stack works with accessible containers regardless of which player originally placed them.

Quick Stack

Press the configured Quick Stack key and QuickStackPlus searches nearby accessible containers for matching items. Moved items are summarized in a detailed notification showing item names and quantities.

By default, Quick Stack uses existing container contents to determine where items belong. Smart Storage can extend this behavior by allowing an empty container to advertise exactly which items it should accept.

Quick Stack can fill the remaining space in a container even when only part of your carried stack fits. The remainder stays in your inventory or moves to another matching container.

Smart Storage

Smart Storage gives individual containers their own item filters.

1. Open a container.
2. Click the Smart Storage filter button.
3. Search or browse the available items.
4. Select the item types that the container should accept.
5. Use Quick Stack normally.

Filtered containers are preferred when routing matching items. If no Smart Storage container accepts an item, QuickStackPlus falls back to classic Quick Stack behavior.

The item picker automatically reads available ObjectDB items, including compatible modded items. Weapons, armor, tools, utility equipment, non-stackable gear and internal/untranslated entries are excluded from the picker. Selected items are pinned to the top, and Inventory, Select shown, Clear all and search controls make larger item lists easier to manage.

Smart Storage selections are stored on the container and can therefore be shared by players. Using the Smart Storage interface itself remains optional for each player.

Sorting

QuickStackPlus can sort both the player inventory and the currently opened container.

Sorting is always an intentional action: opening a container does not automatically rearrange its contents.

When Sorting > ExcludeBlacklistedItemsFromSort is enabled, blacklisted items keep their current player inventory slots. Other items sort around them. This option is off by default and requires EnableBlacklist. Container sorting is unaffected.

Blacklist

The Quick Stack blacklist is player-local. By default, use Left Alt + Right Click on an item in your inventory to toggle only that stack on or off the blacklist.

Blacklisted items:

• remain in your inventory when Quick Stack runs;
• are marked with an orange border;
• are saved on the marked stack, rather than in a list of item types.

The blacklist can be disabled without clearing the stack markings.

Markings apply only to the clicked stack. Other stacks of the same type are unaffected. Newly created or split stacks start unmarked. Items merged into an already marked stack become part of that marked stack. Legacy type-wide blacklist files are no longer loaded; please mark the stacks you want to protect again.

Trash / Junk

Use Shift + Right Click to mark only the clicked inventory stack as junk. Other stacks of the same item type remain unmarked. New stacks do not inherit marks from previously deleted items. Legacy type-wide junk lists are no longer loaded. Marked items receive a clear visual indicator and can then be deleted using the configured trash action.

This keeps accidental deletion separate from normal inventory interaction while still making cleanup fast.

Default Controls

Action	Default control
Quick Stack	P
Sort	O
Toggle blacklist	Left Alt + Right Click
Mark trash / junk	Shift + Right Click
Delete marked junk	Delete
Container Sort shortcut	Disabled by default
Toggle Smart Storage button	Disabled by default

Shortcuts can be changed in the BepInEx Configuration Manager.

Configuration

Important options include:

• General > Enabled – server-controlled master switch for QuickStackPlus.
• SearchRadius – server-controlled Quick Stack search radius, up to 80 metres.
• EnableStorageFilters – enables Smart Storage behavior for the local player.
• ShowSmartStorageButton – shows or hides the Smart Storage button for the local player without deleting existing container filters.
• ToggleSmartStorageButtonShortcut – optional shortcut for quickly showing or hiding the Smart Storage button.
• EnableBlacklist – enables or disables the local Quick Stack blacklist while keeping saved blacklist entries intact.

Configuration descriptions are available directly in BepInEx Configuration Manager.

Multiplayer

QuickStackPlus is designed for multiplayer use. The master Enabled switch and Quick Stack search radius are server-controlled, while shortcuts and personal interface options remain client-controlled.

Smart Storage filter selections are stored on containers, allowing players using Smart Storage to share the same storage rules.

For multiplayer, install QuickStackPlus and its required dependencies on the server and clients as required by the synchronized configuration.

Discord, Support & Feedback

Join the Goneryx Mods Discord for QuickStackPlus support, bug reports, feature requests and release updates:

https://discord.gg/XKMeGmGmYu

• Found a bug? Use the bug-reports forum.
• Have an idea? Use the feature-requests forum.
• Need help? Ask in #help.

When reporting a bug, please include the QuickStackPlus version, Valheim version, relevant BepInEx log/error and a short description of how to reproduce the problem.

❤️ Support development

QuickStackPlus is free to use. If you enjoy the mod and would like to support its continued development, you can make a voluntary contribution through PayPal.

Support QuickStackPlus via PayPal

Your support helps cover development costs and the time spent maintaining the mod. Any amount is appreciated. Thank you! ❤️

Known issue

Quick Stack has intermittently failed to transfer into a closed chest during testing, while working with the chest open. The cause is still under investigation. If this happens, report the steps and attach your BepInEx log. This build retains detailed transfer diagnostics to help investigate it.

Dependencies

• BepInExPack Valheim 5.4.2350+
• ConditionalConfigSync 1.0.5+

Credits

QuickStackPlus is developed and maintained by Goneryx.

QuickStackPlus was originally inspired by and built upon HexQuickStackStorage, created by Hex_Viking.

Thanks to the Valheim modding community and everyone who reports bugs, suggests improvements and helps make QuickStackPlus better. ❤️

Package Information

• Thunderstore author/team: Goneryx
• Package: QuickStackPlus
• BepInEx plugin GUID: Goneryx.QuickStackPlus