PotionPacker

Managing potions in Minecraft can quickly turn into an inventory nightmare. Whether you are brewing for a boss fight, stocking up for a raid, or simply organizing your alchemy chest, the vanilla limit of one potion per slot feels restrictive. PotionPacker is the elegant solution that lets you stack normal, splash, and lingering potions without relying on fragile NMS hacks or reflection. Built on the modern Paper Data Component API, this plugin brings smart stacking to your server while keeping performance rock-solid.

Why PotionPacker Stands Out

Unlike older stacking plugins that often break with every Minecraft update, PotionPacker uses the MAX_STACK_SIZE data component introduced in Paper. This means no direct manipulation of internal server code, resulting in a lightweight and future-proof utility. Server administrators can fine-tune stack sizes per potion type, giving them complete control over game balance. Whether you want splash potions to stack to 8 or lingering potions to 16, the configuration handles it gracefully.

Core Features at a Glance

• Stack normal, splash, and lingering potions with a single plugin.
• Per-type stack size configuration for precise balance.
• Optional profile-based system with permissions and priorities.
• Live config reload — no server restarts needed.
• Lightweight design using the Paper Data Component API.

How the Profile System Works

One of the most powerful aspects of PotionPacker is its optional profile mode. When enabled in the configuration, you can define multiple stacking profiles, each with its own set of rules. Every profile is tied to a specific permission node, such as potionpacker.profile.vip or potionpacker.profile.default. If a player holds multiple profile permissions, the plugin automatically selects the one with the highest priority. Profiles inherit missing values from the default profile, so you only need to override what changes. This makes it easy to reward donors with larger potion stacks or create custom gameplay experiences for different ranks.

Commands and Permissions

PotionPacker keeps things simple with a single command. The /potionpacker reload command (aliases are configurable, defaulting to /pp) lets you apply configuration changes on the fly. No server restarts, no downtime. The permission potionpacker.reload controls access to this command, while profile permissions follow the pattern potionpacker.profile.<name>. This clean separation ensures that only trusted staff can reload settings, while players automatically receive the correct stacking limits based on their assigned profile.

How to Install PotionPacker

Getting started with PotionPacker is straightforward. First, ensure your server runs Paper 1.20.4 or newer, as the plugin relies on the Paper Data Component API. Then, simply download PotionPacker from a trusted source and place the JAR file into your server's plugins folder. Restart the server or use a plugin manager to load it. Once active, a default configuration file will be generated, which you can tweak to your liking. For those who prefer a streamlined setup, the foxygame.net launcher offers a one-click install option for PotionPacker, automatically handling version compatibility and placing the add-on directly into your server's plugin directory.

Configuring Stack Sizes

Open the config.yml file to adjust stack sizes for each potion type. You can set values for normal, splash, and lingering potions independently. The profile system is disabled by default, but turning it on unlocks per-group customization. After making changes, simply run /potionpacker reload to apply them instantly. This live reload feature is a huge time-saver for busy server admins who need to tweak gameplay without interrupting players.

Why Choose PotionPacker for Minecraft

Many stacking plugins exist, but PotionPacker distinguishes itself through its modern API usage and minimal performance footprint. By avoiding NMS and reflection, it remains compatible with future Paper updates and reduces the risk of conflicts with other plugins. The profile system adds a layer of flexibility that is rare in free utilities, allowing server owners to create unique progression systems or donor perks tied directly to potion management. Whether you run a survival, PvP, or minigame server, PotionPacker for Minecraft adapts to your needs.

Real-World Use Cases

Imagine a faction server where premium members can stack up to 16 potions per slot, while regular players are limited to 4. With PotionPacker's profile system, this is a matter of minutes to configure. Or consider a custom adventure map where lingering potions are a rare resource — you can cap their stack size at 2 to maintain scarcity. The plugin's per-type settings give you that level of control without complex scripting. Even on a small community server, simply allowing all potions to stack to 8 drastically reduces chest clutter and makes brewing more rewarding.

Performance and Compatibility

Because PotionPacker hooks directly into the Paper Data Component API, it introduces virtually no overhead. There are no ticking tasks, no entity scans, and no NBT manipulation. The plugin only activates when a potion is picked up or moved, applying the stack size limit efficiently. It is designed for Paper 1.20.4 and above, and it works seamlessly with other inventory-related plugins. If you are using the foxygame.net launcher, you can also rely on its built-in add-on catalog to keep PotionPacker updated automatically, ensuring you always have the latest features and bug fixes without manual downloads.

Final Thoughts

PotionPacker is a must-have utility for any Paper server looking to improve quality of life without sacrificing stability. Its clean codebase, intuitive configuration, and optional profile system make it suitable for both casual and competitive environments. Whether you are a server owner tired of cluttered inventories or a player who wants to carry more potions into battle, this plugin delivers. Download PotionPacker today and experience a tidier, more efficient Minecraft.