Quick Stack to Nearby Containers

[line]

Overview

QuickStack adds fast & intelligent inventory management to Subnautica 2 and is Fully Supported in Multiplayer.

Controls

• N - quick stack your inventory items into all nearby containers holding matching items or matching labels. Swaps batteries from chargers if higher charge ones are available. Restocks food, drinks, and healing items from nearby lockers, and routes extra items to overflow lockers[/*]

• G - while viewing a container, will quick-stack matching items from your inventory into that container [/*]

• H - attempts to redistribute items from overflow lockers to nearby chests[/*]

Labels and Routing

Label a locker, and matching items will route there automatically - even if the locker is empty. Label size limit increased from 15 -> 50 to support longer lists.

The following examples are all valid and cover most use cases:

• "Copper Wire" -> matches "Copper Wire" but not "Copper"[/*]

• "Luc Rot" -> matches "Lucifer Rotsac"[/*]

• "Silv Ing, Tit Ing" -> matches "Silver Ingot" and "Titanium Ingot" [/*]

• "Copper" and "Cop Wi" -> Copper Ore routes to "Copper", Copper Wire routes to "Cop Wi", Copper Ingot routes to "Copper" (until a more specific label is created for the ingot)[/*]

• "%o" -> receives overflows (unmatched or locker was full)[/*]

• "%x" -> never receives items [/*]

Sort Order

• Label match - lockers with labels that match the item's display name (best match wins)[/*]

• Existing items - lockers that already contain the same item type[/*]

• Overflow - lockers prefixed with %o receive anything that didn't match or fit above[/*]

[line]

Installation

• Install UE4SS for Subnautica 2[/*]

• Extract the QuickStack folder into Subnautica2/Subnautica2/Binaries/Win64/ue4ss/Mods/[/*]

• Launch the game[/*]

For best experience, I highly recommend installing Mod Settings for Subnautica 2. Though not required, it will allow you to edit config options in game, in real time (no restart required). If installing mod settings for the first time, it may not show up on first boot of the game. Simply relaunch and settings will show.[line]

Features

Consumable Auto-Restock | Thanks to 4izenn | v3.3.0+

After quick-stacking, automatically restocks food, drinks, and healing items from ALL nearby lockers (including overflow and excluded lockers). Prefers higher-quality items: enhanced medkits over basic, isotonic water over regular, etc.

• Configurable budgets per category (default 2 each, set to 0 to disable)[/*]

• Excess consumables beyond your budget get stacked to lockers automatically (worst quality first)[/*]

• You always end up with the best items in your inventory[/*]

• Inspired by 4izenn's QuickSorter mod - full credit for the original concept, and special thanks for giving permission to implement here![/*]

SN2ModSettings Integration | v3.3.0+

Optional in-game settings UI via SN2ModSettings. Adjust scan radius, restock budgets, battery swap, and summary panel settings without touching config.txt. Changes take effect instantly. Fully optional - the mod works exactly the same without it.

• Settings appear after restarting the game once on first install[/*]

Overflow Lockers | v3.2.0+

• Label your locker with %o - will designate it as an overflow locker. When you quick stack with N, anything that doesn't match gets dumped into your overflow instead of sitting in your inventory[/*]

• Press H - when you're ready to organize, this will sort everything in your overflow lockers back into nearby matching lockers. [/*]

• Perfect dive-and-dump workflow, and is fully supported in multiplayer[/*]

Multi-Language Support | v3.1.0+

• Full localization support - label your lockers in your game-selected language, and items will route properly[/*]

Smart Label Routing Algorithm | v3.1.0+

• Items route to the most specific matching label - "Copper Wire" beats "Copper" locker for Copper Wire items, etc. [/*]

• Supports abbreviations ( "cop wi" ), comma-separated lists ("Cop, Salt"), numbered labels ("Titanium 1"), and any language[/*]

Transfer Summary UI | v3.0.0+

Full visual summary of all items transferred when quick stacking nearby

• Shows Restocked, Overflow, and Sorted sections separately[/*]

• Visibility & duration are all fully configurable[/*]

[line]

Changelog

[3.3.2]

• Fixed water slugs being pulled during restock instead of normal water bottles (thanks Kaizlin!)[/*]

[3.3.1]

• Added all cooked fish & raw fish species to consumable detection for restock[/*]

• Priority order now based on actual in-game food/water values[/*]

• Consumable upgrade swap - will swap lower quality food/drinks/heals with better ones (if they exist) from nearby lockers - similar to battery swap [/*]

• Fixed BiofuelBlock being incorrectly detected as food[/*]

[3.3.0]

• Consumable Auto-Restock - After quick-stacking, automatically restocks food, drinks, and healing items from ALL nearby lockers (including %o and %x lockers). Prefers higher-quality items. Configurable budgets per category (default 2 each, set to 0 to disable). Special thanks to 4izenn for doing the ground work on this and providing the implementation details & permissions![/*]

• Budget-Aware Stacking - Excess consumables beyond your budget get stacked to lockers automatically (worst quality first). You always keep the best items[/*]

• SN2ModSettings Integration - Optional in-game settings UI. Adjust radius, restock budgets, battery swap, and summary panel from the Mods tab. No dependency required[/*]

• Enhanced First Aid Kit prioritized over basic kits during restock[/*]

• Summary panel now shows "Restocked" section at top with items pulled from lockers[/*]

• Fixed: battery swap no longer strips power cells from Tadpoles and other vehicles[/*]

• Fixed: batteries now protected by stack_equipment setting (treated as equipment)[/*]

[3.2.0] 

• Overflow Lockers - Label a locker starting with %o (e.g. "%o Dump") and it receives any items that didn't match elsewhere during Quick Stack (n)[/*]

• Sort Overflow (H key by default) - Press H to sort overflow locker contents back into nearby matching lockers[/*]

• Smart replication polling - non-host multiplayer clients will now see results much quicker (previous 500ms flat delay. introduced 100ms polling to verify transfers)[/*]

• Summary panel sections - overflow and sorted transfers now shown in separated labeled sections for clarity[/*]

[3.1.0]

• Redesigned label matching: token-prefix algorithm with best-match scoring [/*]

• Full localization support - match locker labels in any language supported by the native game (thanks to gango90 for raising the issue!)[/*]

• Locker label character limit increased from 15 to 50 (configurable via label_max_chars config option)[/*]

• Abbreviated labels: "Cop wir" matches "Copper Wire" & will prefer to route there even if a "Copper" label is present[/*]

• Numbered locker labels: "Titanium 1", "Tita 2" -> both accept titanium as expected[/*]

• Summary panel now shows localized item display names[/*]

• Fixed: "Copper" locker no longer greedily captures Copper Wire when a more specific locker exists (thanks to lulu2807 for discovering this issue!)[/*]

• Fixed: false "No matching items" toast on non-host multiplayer clients when using the "G" transfer[/*]

• Fixed: hotkeys now suppressed in all text inputs including bug reports (thanks to captainjm94 for pointing out this issue)[/*]

[3.0.0]

• Added a full transfer summary UI after running the quick stack nearby operation[/*]

• Summary panel shows the item icon, count, and destination container for each item transferred[/*]

• Panel smoothly animates in and gently fades out[/*]

• Fully configurable[/*]

• Organized config.txt[/*]

• Special thanks to Xionghaizi for the idea of listing all transferred contents individually![/*]

[2.0.3]

• Added exclude_prefix option (thanks to shayeryan's suggestion), allowing lockers with labels prefixed by "%x" to be ignored entirely during the quick stack nearby operation[/*]

• Exclude prefix is configurable[/*]

[2.0.2]

• Added a config option to disable the labelling behavior entirely[/*]

[2.0.1]

• Food, water, and medical items now protected from quick-stacking by default (stack_consumables=false) [/*]

• Battery & Power Cell Swap - Automatically swaps drained batteries and power cells with higher-charged ones from nearby Battery and Power Cell Terminals.[/*]

• Item Protection - Tools and equipment are protected from stacking by default. Add specific items to keep_types in config to protect them too. [/*]

• Label Prefix - Optionally set a prefix (e.g. %qs) so only labeled lockers starting with that prefix are matched. Can be configured in config.txt (see below) [/*]

• UI Safety - Keybinds won't fire while typing locker labels.[/*]

[line]

Requirements

• UE4SS for Subnautica 2 (install this first)[/*]

• (Optional) SN2ModSettings — for in-game settings UI[/*]

[line]

Configuration

A full list of configurable options can be edited in Mods/QuickStack/config.txt. Some key highlights:

• Keybinds - remap N, G, and H[/*]

• Scan radius - how far to search for containers (default 25 meters)[/*]

• Item protection - toggle stacking for tools, equipment and consumables[/*]

• Restock budgets - food, drink, and heal counts (default 2 each, 0 to disable)[/*]

• Label limit - max characters in locker labels[/*]

• Prefixes - customize overflow (%o) and exclusion (%x) prefixes [/*]

If you have SN2ModSettings installed, most options are also available in the in-game Settings > Mods tab.

Source on GitHub

[line]

This is the first mod I've ever made and I'm super excited to release it publicly! Please let me know if you experience any bugs or issues with the mod in your gameplay. I'll do my best to resolve issues/bugs as soon as I can :)

Known Limitations

• Controller/gamepad buttons are not supported. UE4SS keybinds only support keyboard keys[/*]

• Quick-stack range is limited to ~235m by the game engine (container data is not available beyond this distance)[/*]

• SN2ModSettings: settings appear after restarting the game once on first install (load order limitation)[/*]

[line]

Check Out My Other Mods ❤

• Material Painter: Paint your base pieces using any material![/*]

• InstantFabricate:  Instantly craft items when using the fabricator![/*]

• Sleep Through the Night: Skip nighttime by sleeping in a bed - multiplayer supported with sleep voting[/*]

• Database Terminal: Browse, search, and pull items from every nearby container through a custom UI[/*]