IG: Potion Stacker Addon

🧪 Potion Stacker Addon

"Brew More, Clutter Less. Stack Drinkable, Splash, and Lingering Potions Safely."

📖 Introduction

Ever since alchemy was introduced to Minecraft, potions have remained stubbornly limited to an unstackable single item per inventory slot. Preparing for an arduous boss battle against the Wither or Ender Dragon, navigating deep Ancient Cities, or exploring Nether Fortresses turns your inventory into a cluttered mess where a standard combat buff loadout (Speed, Fire Resistance, Strength, Regeneration, Healing) completely wipes out your available bag space.

Potion Stacker Addon solves the alchemy storage dilemma under the Instant Gratification design philosophy. It seamlessly stacks standard Drinkable Potions, Splash Potions, and Lingering Potions up to 16 (or custom limits) in your inventory, chests, and brewing stands. Engineered with smooth split-stack drinking mechanics, automatic empty glass bottle returns, dispenser firing compatibility, and client-server sync, your potion combat experience becomes effortless and organized.

[!NOTE] 1 Jar 1 Version Policy: I build 1 dedicated JAR for each Minecraft version (e.g. MC 26.2, MC 26.3). Please download the exact build that matches your Minecraft installation.

Addon & Standalone Synergy: Functions as an optional companion addon for Stack Size Adjuster or as a 100% self-contained standalone potion mod!

Part of the Instant Gratification Collection — mods that respect the player's time.

✨ Features

🍶 Safe Potion Stacking (Up to 16 by Default)

• Unified Alchemy Stacking: Drinkable potions, Splash Potions, and Lingering Potions stack up to 16 by default (configurable up to 64).
• Matching NBT & Component Validation: Potions only stack if they possess identical potion effects, durations, and custom amplification components (DataComponents.POTION_CONTENTS), preventing accidental mixing of healing and poison.

💨 Fluid Combat Drinking & Bottle Management

• Single-Bottle Consumption: Drinking from a potion stack consumes exactly 1 dose, decrementing the stack count while granting you full status effects.
• Smart Bottle Recovery: The returned empty Glass Bottle automatically attempts to stack with existing empty bottles in your inventory. If your inventory is completely full, it cleanly drops at your feet without swallowing items.
• Dispenser & Dropper Integration: Dispensers loaded with splash potion stacks fire exactly 1 splash potion per redstone pulse, enabling compact, high-capacity automated defensive turret traps.

⚗️ Brewing Stand Automated Batch Loading

• Place stacks of awkward potions directly into brewing stand slots. Brew an entire batch of 16 potions simultaneously with a single nether wart, glowstone dust, or fermented spider eye!

📊 Inventory Combat Loadout Comparison

⚙️ Native GameRules & Configuration

Configure potion stacking rules in-game:

📖 In-Depth How-To & Gameplay Playbook

Step 1: Installation & Setup

1. Install Fabric Loader and Fabric API for Minecraft 26.2+ / 26.3+.
2. Place `potion-stacker-addon-x.y.z+.jarinto yourmods/` directory.
3. Launch Minecraft. Potions of identical type in your chests and inventory will now stack automatically when clicked together!

Step 2: Optimizing Combat Hotbars

• Consolidate your combat bag: place a stack of 8 Splash Potions of Healing II on your hotbar key 8, and a stack of 4 Swiftness II potions on key 9.
• Free up 10+ inventory slots for mob drops, ancient city loot, and armor switches!

☕ Support & Creator Community

I am an independent solo developer creating lightweight, vanilla-enhancing mods that respect your time and game performance. If Potion Stacker Addon streamlines your survival, consider supporting future development:

[!TIP] 🇮🇩 Indonesian Local Payment Note: Indonesian supporters can also support my development work directly using local payment options (GoPay, OVO, Dana, QRIS, LinkAja) via Saweria or SocioBuzz!

Join our official Discord community for live development updates, early test builds, and friendly support:

• 💬 Discord Community: https://discord.gg/EV99bgAFqb

📜 Metadata & Permissions

[!IMPORTANT] 📦 Modpack Permissions & Distribution:
You are fully welcome to include this mod in any modpack on any platform! However, the mod file must be downloaded directly through official distribution channels (Modrinth or CurseForge). Re-uploading, mirroring, or redistributing the original mod JAR to third-party mirror sites, scraper portals, or unauthorized launchers is strictly prohibited.

⚖️ License & Fork Guidelines (No Zero-Change Re-uploads):
This project is open-source under the GNU GPLv3. You are fully encouraged to inspect the code, learn from it, and fork the repository to create genuine modifications, substantial feature expansions, or community ports—provided your project remains open-source under GPLv3 with proper attribution.
However, straight 1:1 re-uploads, clone forks with no meaningful functional changes, or re-publishing identical builds under different project names (e.g. to farm downloads or rewards) are strictly forbidden.