QuickStackPlus

Author: Goneryx
Version: 1.1.0

QuickStackPlus adds convenient inventory and storage management to Valheim.

Features

• Quick Stack items from the player inventory into nearby containers.
• Smart Storage filters: open a chest, click the filter icon and select which stackable items that chest should accept.
• Filtered chests are preferred by Quick Stack and can accept their selected items even when empty.
• Smart Storage is optional per player through EnableStorageFilters; disabling it hides the filter UI and restores classic Quick Stack behavior for that player.
• The Smart Storage item picker automatically reads available ObjectDB items, including compatible modded items.
• Weapons, armor, tools, utility equipment and non-stackable gear are excluded from the Smart Storage picker.
• Search, Select shown, and Clear all controls in the Smart Storage panel.
• Selected Smart Storage items are pinned to the top of the list for quick review.
• Typing in the Smart Storage search field blocks character movement so WASD can be used safely as text input.
• Internal/untranslated ObjectDB entries are hidden from the picker.
• Configuration descriptions/tooltips are available in BepInEx Configuration Manager only.
• Works with accessible containers regardless of which player originally placed them.
• Server-controlled Quick Stack search radius from 5 to 80 meters.
• Detailed Quick Stack notification showing moved item names and quantities.
• Sort the player inventory and the currently opened container.
• Mark inventory items as junk and delete marked items.
• Dedicated trash UI/icon.
• Client-local configurable shortcuts.
• Configuration synchronization through ConditionalConfigSync.

Smart Storage

1. Open a container.
2. Click the filter icon next to the container controls.
3. Search for an item and click its row to check/uncheck it.
4. Quick Stack will try matching filtered containers first.
5. If no filtered container accepts an item, classic Quick Stack behavior is used as a fallback.

Filter selections are stored on the container so they can be shared by players using Smart Storage. The EnableStorageFilters option itself is client-local, so every player can choose whether to use the feature. ShowSmartStorageButton is also client-local and only hides the chest button; it does not disable existing Smart Storage routing.

Default shortcuts

• P — Quick Stack
• O — Sort
• Delete — Delete marked junk
• Container Sort — disabled by default; configure a key if desired

Multiplayer

SearchRadius and the master Enabled switch are server-controlled. Keyboard shortcuts, EnableStorageFilters, and ShowSmartStorageButton remain client-controlled.

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

Dependencies

• BepInExPack Valheim 5.4.2350+
• ConditionalConfigSync 1.0.5+

Package identity

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

Server master switch

General > Enabled is server-controlled. Server admins can disable all QuickStackPlus gameplay features and in-game buttons for every connected player without uninstalling the mod.

Smart Storage uses a fixed scroll speed of 100 and returns to the top whenever the list is opened. The in-game explanatory tooltip/help text is intentionally hidden; descriptions are available in the mod settings.

Smart Storage convenience

• ShowSmartStorageButton remains a per-player option.
• ToggleSmartStorageButtonShortcut is an optional per-player keybind for quickly hiding/showing the Smart Storage button.
• The Inventory button inside Smart Storage temporarily filters the list to item types currently in your player inventory.

Quick Stack blacklist

The blacklist is fully player-controlled and can be disabled in the mod settings with EnableBlacklist. By default, Left Alt + Right Click on an item in your player inventory toggles that item type on the local Quick Stack blacklist. The shortcut is configurable with BlacklistShortcut. Blacklisted item types stay in your inventory when Quick Stack runs and are shown with an orange border while the feature is enabled. The blacklist is stored per player/client in BepInEx/config/QuickStackPlus.blacklist.txt.

Changelog

1.2.1

• Fixed intermittent item loss during Quick Stack on multiplayer servers by checking container ownership before moving items.
• Verify that the full stack arrived in the destination before removing it from the player's inventory. If the check fails, source removal is skipped and a warning is logged.

1.2.0

• Updated QuickStackPlus for compatibility with Valheim 1.0.14 keybinding/input changes.
• Fixed QuickStackPlus keybinds not responding while the player was running.
• Shortcut detection now uses Valheim's ZInput while preserving the existing configurable keybind settings.

1.1.2

• Fixed containers being automatically sorted when opened.
• Container contents are now sorted only when the player explicitly uses the Sort action.

1.1.0

• Added Smart Storage filters for individual containers. Selected item types are routed to those containers first, even when the container is empty.
• Added searchable Smart Storage item list with selected items pinned to the top, Inventory-only filtering, Select shown and Clear all.
• Smart Storage selections are stored on containers and persist in multiplayer.
• Added player-local EnableStorageFilters, ShowSmartStorageButton and configurable Smart Storage button toggle shortcut.
• Added server-controlled General > Enabled master switch for the whole mod.
• Added player-local Quick Stack blacklist with configurable enable/disable option and shortcut; default is Left Alt + Right Click.
• Blacklisted item types are protected from Quick Stack and shown with an orange inventory border.
• Improved Smart Storage UI: fixed scroll speed 140, always opens at the top, search input prevents character movement while typing, and a short in-panel help text explains routing.
• Filtered out unsuitable equipment/tools and internal or unlocalized item_* entries from the Smart Storage list.
• Optimized Smart Storage list rendering to reduce stutter when opening the panel.
• Includes HarmonyX compatibility fix for blacklist input handling.

1.0.0

• First release as QuickStackPlus by Goneryx.
• Quick Stack into nearby accessible containers, including containers placed by other players.
• Server-controlled search radius from 5 to 80 m.
• Client-configurable Quick Stack, Sort, Trash and Container Sort shortcuts.
• Detailed Quick Stack notifications, sorting, junk marking/deletion and custom trash icon.
• ConditionalConfigSync integration.