Stackables

Turn Non-Stackable Items into Stackable Ones

The Stackables mod fundamentally changes inventory management by allowing items that previously occupied single slots to be stacked. Now potions, soups, cakes, enchanted books, full buckets, boats, minecarts, saddles, beds, music discs, goat horns, and banner patterns can be placed in stacks! Each category is individually configurable with sensible default values. For splash potions, there's an option to add a cooldown timer to maintain game balance.

Compatibility with Versions 1.20.5 and Newer

Starting with Minecraft 1.20.5, developers changed the maximum stack size configuration system, making it more data-driven. This creates challenges for dynamically changing settings through configuration files. Work on a solution continues, but future versions may require a revision of the dynamic configuration approach.

Compatibility Features and Potential Issues

Simply increasing the maximum stack size is not enough for proper operation. Vanilla Minecraft code (and many mods) contains numerous assumptions about the maximum stack size of items.

For example, when drinking milk from a bucket, the standard code simply replaces the item(s) in the slot with an empty bucket without checking the stack contents. If only the maximum stack size for milk buckets is increased, drinking from a stack will remove all items. Therefore, it's necessary to intercept relevant code sections and replace them with custom logic.

Such peculiarities are found throughout vanilla code and many mods. Most of these cases in the standard game have already been handled, but if you discover unaccounted situations, please report them for prompt resolution. Sometimes errors occur due to conflicts with other mods modifying the same code sections, which complicates their elimination.

Tag System

Starting with version 2.0.0, Stackables uses a tag system to manage maximum stack size. All settings are now controlled exclusively through new tags. If other mods contain items that should belong to specific categories, you can add them to appropriate tags using datapacks.

Complete Tag List

• stackables:potions - Potions and lingering potions
• stackables:splash_potions - Splash potions
• stackables:soups - Stews & soups (everything in wooden bowls)
• stackables:enchanted_books - Enchanted books
• stackables:boats - Regular and chest boats
• stackables:minecarts - All forms of minecarts
• stackables:buckets - Powder snow, water, and lava buckets
• stackables:beds - Beds
• stackables:music_discs - Music discs
• stackables:instruments - Goat horns
• stackables:banner_patterns - Banner patterns
• stackables:horse_equipment - Saddles and horse armor
• stackables:cakes - Cakes
• stackables:totems - Totems of Undying
• stackables:empty_buckets - Empty buckets
• stackables:armor_stands - Armor stands
• stackables:banners - Banners
• stackables:signs - Both standing and hanging signs
• stackables:throwables - Eggs and snowballs
• stackables:ender_pearls - Ender pearls
• stackables:drinkables - Honey bottles and milk buckets
• stackables:signed_books - Signed books
• stackables:decorated_pots - Decorated pots. Only in versions 1.20-1.20.2

Configuration Settings

The mod's behavior is configured through the stackables.toml file in the configuration folder. With ModMenu installed, a graphical settings interface is also available through the mod list (works only in single-player games).

Configuration Version 2 (mod versions >= 2.0.0)

• modEnabled: true|false - Enable/disable the mod
• potions: true|false - Allow stacking potions
• potionCount: 1-64 - Maximum stack size for potions
• splashPotions: true|false - Allow stacking splash potions
• splashPotionCount: 1-64 - Maximum stack size for splash potions
• splashPotionDelay: 0-20 - Delay/cooldown for throwing splash potions in game ticks
• soups: true|false - Allow stacking soups
• soupCount: 1-64 - Maximum stack size for soups
• enchantedBooks: true|false - Allow stacking enchanted books
• enchantedBookCount: 1-64 - Maximum stack size for enchanted books
• buckets: true|false - Allow stacking full buckets
• bucketCount: 1-64 - Maximum stack size for full buckets
• boats: true|false - Allow stacking boats
• boatCount: 1-64 - Maximum stack size for boats
• minecarts: true|false - Allow stacking minecarts
• minecartCount: 1-64 - Maximum stack size for minecarts
• beds: true|false - Allow stacking beds
• bedCount: 1-64 - Maximum stack size for beds
• discs: true|false - Allow stacking music discs
• discCount: 1-64 - Maximum stack size for music discs
• instruments: true|false - Allow stacking instruments (goat horns)
• instrumentCount: 1-64 - Maximum stack size for instruments
• patterns: true|false - Allow stacking banner patterns
• patternCount: 1-64 - Maximum stack size for patterns
• horseEquipments: true|false - Allow stacking horse equipment
• horseEquipmentCount: 1-64 - Maximum stack size for horse equipment
• cakes: true|false - Allow stacking cakes
• cakeCount: 1-64 - Maximum stack size for cakes
• totems: true|false - Allow stacking totems
• totemCount: 1-64 - Maximum stack size for totems
• decoratedPots: true|false - Allow stacking decorated pots
• decoratedPotCount: true|false - Maximum stack size for decorated pots
• emptyBucketCount: 1-64 - Maximum stack size for empty buckets
• armorStandCount: 1-64 - Maximum stack size for armor stands
• bannerCount: 1-64 - Maximum stack size for banners
• signCount: 1-64 - Maximum stack size for signs
• throwableCount: 1-64 - Maximum stack size for throwables
• enderPearlCount: 1-64 - Maximum stack size for ender pearls
• drinkableCount: 1-64 - Maximum stack size for drinkables
• signedBookCount: 1-64 - Maximum stack size for signed books

Configuration Version 1 (mod versions < 2.0.0)

• modEnabled: true|false - Enable/disable the mod
• potions: true|false - Allow stacking regular & lingering potions
• potionCount: 1-64 - Maximum stack size for potions
• splashPotions: true|false - Allow stacking splash potions
• splashPotionCount: 1-64 - Maximum stack size for splash potions
• splashPotionDelay: 0-20 - Delay for throwing splash potions
• soups: true|false - Allow stacking soups
• soupCount: 1-64 - Maximum stack size for soups
• enchantedBooks: true|false - Allow stacking enchanted books
• enchantedBookCount: 1-64 - Maximum stack size for enchanted books
• buckets: true|false - Allow stacking full buckets
• bucketCount: 1-64 - Maximum stack size for full buckets
• boats: true|false - Allow stacking boats
• boatCount: 1-64 - Maximum stack size for boats
• minecarts: true|false - Allow stacking minecarts
• minecartCount: 1-64 - Maximum stack size for minecarts
• beds: true|false - Allow stacking beds
• bedCount: 1-64 - Maximum stack size for beds
• discs: true|false - Allow stacking music discs
• discCount: 1-64 - Maximum stack size for music discs
• horns: true|false - Allow stacking goat horns
• hornCount: 1-64 - Maximum stack size for goat horns
• patterns: true|false - Allow stacking banner patterns
• patternCount: 1-64 - Maximum stack size for patterns
• saddles: true|false - Allow stacking saddles
• saddleCount: 1-64 - Maximum stack size for saddles
• cakes: true|false - Allow stacking cakes
• cakeCount: 1-64 - Maximum stack size for cakes
• armorStandCount: 1-64 - Maximum stack size for armor stands
• bannerCount: 1-64 - Maximum stack size for banners
• signCount: 1-64 - Maximum stack size for signs
• snowballCount: 1-64 - Maximum stack size for snowballs
• eggCount: 1-64 - Maximum stack size for eggs
• enderPearlCount: 1-64 - Maximum stack size for ender pearls
• honeyBottleCount: 1-64 - Maximum stack size for honey bottles
• signedBookCount: 1-64 - Maximum stack size for signed books