StackAnything

Requirements

UE4SS 1. 21. 0 or above.

Installation

• []Extract the StackAnything zip into ../ue4ss/Mods/[/]

  []Launch the game[/]

Configuration

Edit Mods/StackAnything/config.lua.

On the first run (or if config.lua is missing or empty) the mod writes a default config covering the built-in item categories, generated from the built-in defaults. Delete config.lua and restart to regenerate the defaults. Edit config.lua to customize; it is never overwritten while it exists.

The config maps regular expressions to max stack sizes. Longer (more specific) patterns win; items not matched by any pattern keep their vanilla stack size.

["fish_.+"] = 20,       -- all fish

[".hair."] = 2,   -- any chair

["paintbucket"] = 10,   -- exact match

The basics: . matches any single character, + one or more of the preceding, zero or more, and matches any character in the class.

Regular expressions support many more constructs - for a full reference see regex101 or RegExr.

Safe Stacking

Stacking is always safe, even for items that normally duplicate or lose data when merged:

Fluid Containers

Fillable fluid containers (bottles, buckets, pots, soups, etc.) can be stacked without any fluid or food duplication.

Stacking them is safe because the mod auto-splits a stack whenever its liquid state changes:

• []Filling - one fill cost only fills one container. The single filled container moves to a free slot (or joins an existing identical stack); the rest of the stack stays empty. If no slot is available the fill is reverted and the container's fluid is refunded, so nothing is duplicated or lost.[/]

  []Emptying - only one container drains. The rest of the stack keeps its fluid and stays in your hand, ready to empty again. The single drained container moves out to a free slot (or an existing identical stack).[/]

  []Stacking rules - drag-and-drop and shift-click will not merge containers with different liquid states (filled vs empty, or different liquids); identical containers merge normally. Inventory sort groups containers by their liquid state so filled and empty ones never combine.[/]

  Batteries and laser cells keep their vanilla stack-charge behavior.

  Texture-Variant Items

  Paintings, TVs, arcade machines, and rare fish share a base item row, but each instance carries its own texture variant (different painting art, TV channel, arcade game, or fish variant). Stacking them is safe because the mod treats each variant as a distinct item:

  • []Stacking rules - drag-and-drop and shift-click will not merge two items of the same row that have different texture variants (or a base item with a variant). Identical variants merge normally.[/]

    []Sorting - inventory sort groups items by their variant, so different variants never combine while identical ones still do.[/]

    Yes, this also applies to fish caught from fishing.

    Upgrade Bench

    Stacked items can be placed into the upgrade bench and upgraded in batches:

    • []Costs - upgrade requirements scale with the inserted stack size, so upgrading N items costs N times each required item.[/]

      []Display - the upgrade screen shows the scaled requirements and availability.[/]

      []Batch upgrades - the entire inserted stack upgrades at once after the scaled costs are paid.[/]

      Finding Item IDs

      To find the item IDs used in the config patterns, the mod can dump every item it knows about:

      • []Open Mods/StackAnything/Scripts/main.lua[/]

        []Set DUMP_ITEMS = true at the top[/]

        []Restart the game[/]

        []Read Mods/StackAnything/item_dump.lua - it lists every item's ID (row name), display name, current stack size, and more[/]

        []Set DUMP_ITEMS = false and restart to stop dumping