How it works ?

Features Guide

🎯 Stackable Items

Tools (Default: 8 per stack)

• Pickaxes, Shovels, Axes, Hoes, Brushes
• Durability Rule: Only fresh (undamaged) tools stack
• Isolation: When you use one, durability is applied only to that tool

Potions (Default: 16 per stack)

• Healing, Damage, Speed, Strength, etc.
• NBT-Aware: Different potion types won't mix
• Splash/Lingering: Both supported

Enchanted Books (Default: 4 per stack)

• Books with identical enchantments stack together
• Caveat: Different enchantments won't merge

Weapons (Default: 1 — no stacking)

• Swords, Tridents
• Can be configured to stack if desired
• Durability Isolation applies here too

Armor Pieces (Default: 1 — no stacking)

• Helmets, Chestplates, Leggings, Boots
• Can be enabled for stacking in config
• Equip Restriction: Armor slots only accept 1 item at a time

Elytra (Default: 1 — no stacking)

• Can be configured to stack
• Equip Restriction: Armor slot only holds 1

🛡️ Durability Isolation Mechanism

How it works:

1. You have a stack of 8 iron pickaxes with 0 damage
2. You use one pickaxe, taking 1 damage
3. The stack automatically separates:
   • 1 pickaxe with 1 damage (currently in use)
   • 7 pickaxes with 0 damage (returned to inventory)
4. Only the active pickaxe takes additional damage

Benefits:

• No durability loss to the rest of the stack
• Seamless experience when the active tool breaks
• Works with Mending and Unbreaking enchantments

🔄 Automatic Merging

When you pick up or insert items into inventory:

1. The mod checks if an existing stack has room
2. If item properties match (enchantments, NBT), items merge
3. Respects configured maximum stack sizes
4. Works with drag-and-drop in inventory GUIs

💡 Smart Insertion

The inventory insertion system is inventory-context-aware:

• Creative Mode: Stacking is bypassed (creative behavior preserved)
• Armor Slots: Max stack = 1 (equipment restriction)
• Inventory Slots: Full stacking rules apply
• Crafting Grid: Standard Minecraft behavior