🧪 OutStacker — Ultimate Potion Stacking System

The most advanced potion stacking plugin for Minecraft. Zero configuration, zero commands, zero lag — just pure automatic stacking for all potions.

---

🧪 About OutStacker

OutStacker is the simplest potion stacking solution for Minecraft. No commands, no permissions, no nonsense — just install and forget.

Unlike other plugins that fight with vanilla inventory behavior, OutStacker uses native Paper API (setMaxStackSize()) to tell the game: "These potions can stack." The result? Perfect stacking that works exactly like vanilla items, with zero performance impact.

Perfect for survival servers, PvP arenas, factions, or any server where players need to carry lots of potions without inventory clutter.

---

✨ Why OutStacker?

🎯 The Problem

Other potion stacking plugins:

• ❌ Scan inventory every tick (LAG)
• ❌ Fight with vanilla click logic (BROKEN)
• ❌ Cause dupe exploits (UNSAFE)
• ❌ Require commands (ANNOYING)

✅ The Solution

OutStacker does it THE RIGHT WAY:

• ✓ Uses Paper's native setMaxStackSize() API
• ✓ Game handles ALL logic automatically
• ✓ Zero performance impact
• ✓ Impossible to dupe
• ✓ No commands needed

---

✨ Features

🧪 Core Features

Feature	Description
Auto Stack	All potions automatically stack — no commands, no clicks, no nothing
Native API	Uses Paper's setMaxStackSize() — the ONLY correct way to stack items
All Potions	Regular potions, splash potions, lingering potions, tipped arrows
Persistent	Potions remember stack size after server restart
Universal	Works in all inventories — player, chests, hoppers, dispensers

🛡️ Safety & Performance

Feature	Description
No Dupes	Uses vanilla game logic — literally impossible to duplicate items
Zero Lag	No inventory scanning, no event spamming, no schedulers
Safe Transactions	Works with ALL click types — left, right, shift, drag, double
Lightweight	Single event listener, minimal code, maximum efficiency

🎨 Simplicity

Feature	Description
Plug & Play	Download → Restart → Done. That's literally it.
One-Line Config	Open config.yml, change ONE number, save, restart
bStats	Anonymous statistics to help improve the plugin (ID: 30274)
No Commands	Players don't need to learn ANYTHING

---

📥 Installation Guide

Step	Action
1️⃣	Download — Get the latest .jar from Modrinth
2️⃣	Install — Place the JAR into your server's plugins/ folder
3️⃣	Restart — Restart your server (DO NOT use /reload)
4️⃣	Done! — That's it. All potions now stack automatically

⚠️ Important: Requires Paper 1.21.5 or higher with Java 21. Will NOT work on Spigot or older Paper versions. Full server restart required — /reload will cause issues.

---

⚙️ Configuration

📁 config.yml — The ONLY file you'll ever need

# maximum stack size for ALL potions (1-127)
# change this number and restart the server
default-stack: 16
That's it. One line. Change the number, restart, done.

Want 32 potions per stack? Change to 32. Want 64? Change to 64. Want 100? Go wild (up to 127).

</details>