⭐ hPotionStack ⭐ [1.16.X-26.X] | PAPI, Vault, and more support!

hPotionStack is a lightweight plugin that allows potions to stack in inventories and as dropped items on the ground.
The plugin supports normal potions, splash potions and lingering potions. Each potion type can have separate stack settings for inventory stacking and ground item stacking, including different maximum stack sizes and item-spawn delays.
hPotionStack also includes configurable inventory type protection, reload command, inventory type debug command, messages, actions and permission-based inventory stacking access.
Main Features

• Stacks regular POTION items.
• Stacks SPLASH_POTION items.
• Stacks LINGERING_POTION items.
• Inventory potion stacking.
• Ground item potion stacking.
• Separate settings for every potion type.
• Separate max stack limits for inventory and ground items.
• Configurable delay before ground item stacking.
• Configurable list of allowed inventory types.
• Permission check for inventory stacking.
• Custom messages.
• Custom actions when stacking succeeds or permission is missing.
• Reload command.
• Inventory type debug command.
• Hex color support in messages.

How It Works
hPotionStack works with three potion item types:
When inventory stacking is enabled, the plugin checks potion clicks inside allowed inventory types and combines similar potions up to the configured limit.
When ground stacking is enabled, the plugin checks spawned potion items after a configurable delay and merges similar nearby potion items up to the configured limit.
Inventory Stacking
Inventory stacking can be enabled or disabled globally and separately for each potion type.
Players need the permission hpotionstack.stack to stack potions inside inventories.
If a player does not have permission, the plugin can run configured actions from:
The plugin also supports a configurable list of allowed inventory types to prevent unwanted behavior in specific inventories.
Default allowed inventories:
Ground Item Stacking
Ground stacking can be enabled or disabled globally and separately for each potion type.
When a potion item spawns on the ground, the plugin waits for the configured delay and then tries to merge it with similar nearby potion items.
Each potion type has its own ground stack limit and delay.
This behavior is controlled through:
Configuration
Default configuration example:
Potion Settings
Each potion type has its own settings.
Actions
The plugin includes action sections for inventory stacking feedback.
These actions can be used to notify players when stacking succeeds or when they do not have permission.
Commands
Command Description:
The inventory command is useful when configuring the allowed inventory type list.
Permissions
Ground item stacking works automatically according to the configuration.
Requirements

• Minecraft 1.16 or newer.
• Spigot, Paper or a compatible server fork.

Optional soft dependencies:

• Vault
• PlaceholderAPI

Installation

1. Place hPotionStack.jar into your server's plugins folder.
2. Restart the server.
3. Open the generated configuration file.
4. Configure potion stack limits and enabled modules.
5. Give players hpotionstack.stack if they should be able to stack potions in inventories.
6. Use /hpotionstack reload after editing the configuration.

Configuration file:
Notes

• Only similar potions are stacked together.
• Inventory stacking requires hpotionstack.stack.
• Ground item stacking is controlled by the configuration.
• Every potion type can have its own inventory and ground stack limit.
• Allowed inventory types can be configured to prevent unwanted stacking behavior.
• Use /hpotionstack inventory <player> to check the type of the inventory a player currently has open.