Quick Stack to Nearby Containers

[line]

About

QuickStack adds fast & intelligent inventory management to Subnautica 2 and has full multiplayer support.

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[/*]

[line]

How to Install

• Install UE4SS for Subnautica 2[/*]

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

• Launch the game[/*]

Mod Settings for Subnautica 2 is also recommended but not required. It will allow you to edit most 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]

Update Instructions

• Backup your categories.txt[/*]

• Backup your config.txt if you aren't using sn2modsettings (or configured options in config.txt that aren't present in the mod menu)[/*]

• With the two files backed up, you can overwrite / replace the QuickStack folder in ue4ss/Mods with the new one[/*]

• Replace the categories.txt/config.txt with your backed up ones [/*]

[line]

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 -> 200 to support longer lists.

Labels lazy-match your items by prefix and auto sort by best score. The following examples are all valid and cover most use cases:

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

• "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 [/*]

Categories

As of v5, you can create label aliases in categories.txt allowing you to use simpler locker labels to match items.

For example, if set in categories.txt:

Components = adv wiring kit, wiring kit, sys chip

Ingots = tit ing, silv ing, gold ing

If your locker label includes "Components" or "Ingots", quick stack will match against the associated category/alias definition. 

•  In multiplayer, clients automatically sync with the host's categories[/*]

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]

Features

Categories / Label Aliases | v5.0.0+

See section above.

Infinite Range Stacking | v5.0.0+

Separate config option (infinite_range=true) or in mod settings enables quickstack to lockers anywhere in the world. 

• If enabling on an existing save, you'll need to discover those lockers once for the mod to store their refs. After that, you're set.[/*]

• SP only. In multiplayer, it currently only works on host. The networking logic is complex and added too much risk[/*]

Auto-Label / Smart Lockers | v4.0.0+

Drop items in lockers with a blank label and their label will update automatically, up to the amount you set in config. It doesn't get easier than that! 

• Must be enabled in settings / config: auto_label_max: >0[/*]

Localization | v4.0.0+

Fully localized in all 11 game-supported languages.

Consumable Auto-Restock | v3.3.0+

After quick-stacking, automatically restocks food, drinks, and healing items from all nearby lockers. Prefers higher-quality items.

• 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)[/*]

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

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.[/*]

• Fully multiplayer supported[/*]

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

[5.0.0]

Features

• Added infinite range quick stack support, SP only. In multiplayer, it currently only works on host. [/*]

• Added label aliases/categories (see categories.txt). Clients automatically sync with host's categories in multiplayer[/*]

Fixes

• Quick stack performance drastically improved; now stacks with near-zero lag / hitch after first stack[/*]

• Fixed certain keybinds being blocked in other mods when having this one installed[/*]

• Fixed infinite load on clients in multiplayer with larger bases with lots of lockers/items[/*]

• Fixed several stability issues / occasional crashes by migrating to gthread for deferred work[/*]

• Several MP-client routing corrections[/*]

[4.0.1]

• Fixed SN2ModSettings key binds not registering requiring users to set hotkeys in config.txt[/*]

[4.0.0]

Features

• Added optional separate restock keybind config option (keybind_restock)[/*]

• Added ability to fully customize the summary panel, including position (left or right side of screen), text scale, and truncation amount[/*]

• Added all 11 game supported languages to all quickstack popups, summary labels, settings, etc. [full localization support][/*]

• Added several config options to Sn2ModSettings to allow more config items to persist between updates[/*]

• Overflow lockers now fill in alphabetical order based on text after the %o (or whatever it's configured to)[/*]

Fixes

• Fixed host sorting connected clients' inventories in 3.3.3 / 3.3.2[/*]

• Fixed issues related to non-host (client) triggering battery swap[/*]

• Fixed restocks still happening despite their budgets being set to 0[/*]

• SN2ModSettings radius slider max raised to 235m[/*]

• Fixed battery swap failing on full terminals[/*]

Opt-in Features - Must be enabled in config.txt or SN2ModSettings 

• New budget-based battery restock system, allowing you to keep N top charged batteries at all time [/*]

• Using quickstack "N" also sorts from nearby tadpole inventories or attached portable lockers[/*]

• Auto-label lockers: Automatically sets labels on your lockers as you drop items in, up to a pre-configured number of unique items[/*]

• Auto-sort on base entry: Automatically run quick stack nearby when entering your base if enabled in settings/config[/*]

.. see changelog dropdown at the top of the mod page for full version list

[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.

Categories.txt

• Define aliases for labels to route multiple items with a single label keyword. Syncs with clients in multiplayer, host authoritative [/*]

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[/*]