AggStack

What is AggStack?

AggStack allows you to store multiple items with the same ID but different NBT data (different durability, enchantments, or custom names) in a single inventory slot.

💡 Example: Store a 5% durability diamond pickaxe and a 100% durability diamond pickaxe in the same slot!

---

🎮 How to Use

Creating an Aggregated Stack

Method	How to do it
Drag to Merge	Pick up an item with your mouse, then drag and drop it onto another item of the same type (e.g., two iron pickaxes with different durability). They will merge into an aggregated stack.
Auto Pickup	If you already have an aggregated stack in your inventory, picking up the same type of item will automatically add it to the stack. (Can be disabled in config)

Viewing Sub-items

1. Hover your mouse over an aggregated stack slot
2. Hold Left Alt (default) – a panel will appear below your inventory
3. The panel displays all sub-items in a 7-column grid, each showing its own durability bar and enchantment glint
4. Release Left Alt – the panel closes

🔧 You can change the expand behavior in config: HOLD / TOGGLE / CLICK_OUTSIDE

Interacting with Aggregated Stacks

Action	Result
Left Click (on the stack)	Pick up the entire aggregated stack (all sub-items)
Right Click (on the stack)	Take half of the top item (if stackable), or the whole top item (if unstackable)
Shift + Left Click	Split the stack – all sub-items scatter into your inventory (or drop on the ground if inventory is full)
Q (Drop)	Drop the entire aggregated stack as a single item

Interacting with Sub-items (in the expanded panel)

Action	Result
Left Click on a sub-item	Take that single sub-item out – it will appear on your mouse cursor
Right Click on a sub-item	Set that sub-item as the new top item (changes the appearance, durability bar, and enchantment glint)

Adding Items to an Existing Stack

1. Pick up an item with your mouse (must be the same type as the aggregated stack)
2. Right-click on the aggregated stack
3. The item is added as a new sub-item

---

⚙️ Configuration

Press G in-game to open the configuration GUI.

Option	Description	Default
Enabled	Enable/disable the entire mod	true
Max Sub-Items	Maximum items per aggregated stack (1-64)	64
Auto Pickup	Automatically merge picked-up items	true
Expand Key	Key to open the sub-item panel	Left Alt
Expand Behavior	HOLD = hold to open, release to close / TOGGLE = press to toggle / CLICK_OUTSIDE = click outside to close	HOLD
Death Drop	SPLIT = drop all sub-items separately / KEEP_ALL = drop as a single stack	SPLIT
Creative Auto Stack	Auto pickup in creative mode (disabled by default)	false
Split Key	Modifier key for splitting aggregated stacks	Left Ctrl

---

🚫 Restrictions

Aggregated stacks cannot be placed into the following container slots (to prevent bugs/exploits):

• Crafting Table • Furnace/Smoker/Blast Furnace • Brewing Stand
• Villager Trading • Grindstone • Anvil • Smithing Table
• Stonecutter • Loom • Cartography Table

✅ You can still take out aggregated stacks from these containers.

---