hPotionStack

# hPotionStack **hPotionStack** is a lightweight plugin that allows potions to stack in inventories and as dropped items on the ground. The plugin supports regular potions, splash potions and lingering potions. Each potion type can have separate settings for inventory stacking and ground item stacking, including custom stack limits and spawn delays. --- ## Features - Inventory potion stacking - Ground item potion stacking - Support for `POTION` - Support for `SPLASH_POTION` - Support for `LINGERING_POTION` - Separate settings per potion type - Separate inventory and ground stack limits - Configurable delay before ground item stacking - Configurable allowed inventory types - Permission check for inventory stacking - Custom messages - Custom actions - Reload command - Inventory type debug command - Hex color support --- ## Stacking hPotionStack works with three potion item types: ```text POTION SPLASH_POTION LINGERING_POTION ``` 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 Inventory stacking can be enabled globally and separately for every potion type. Players need this permission to stack potions inside inventories: ```text hpotionstack.stack ``` If the player does not have permission, the plugin can run actions from: ```text actions.noPermsInventory ``` Default allowed inventory types: ```text CRAFTING ENDER_CHEST BARREL SHULKER_BOX CHEST ``` --- ## Ground Items Ground item stacking can be enabled globally and separately for every 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. The ground stacking behavior is controlled through: ```text settings.enable.itemSpawn settings.stackSettings.<type>.itemSpawn.enable settings.stackSettings.<type>.itemSpawn.maxStack settings.stackSettings.<type>.itemSpawn.delay ``` --- ## Config Default configuration example: ```yaml settings: prefix: "&7" debug: true enable: inventory: true itemSpawn: true stackSettings: potion: inventory: enable: true maxStack: 3 itemSpawn: enable: true maxStack: 5 delay: 4 splashPotion: inventory: enable: true maxStack: 64 itemSpawn: enable: true maxStack: 64 delay: 4 lingeringPotion: inventory: enable: true maxStack: 48 itemSpawn: enable: true maxStack: 48 delay: 4 inventories: - "CRAFTING" - "ENDER_CHEST" - "BARREL" - "SHULKER_BOX" - "CHEST" ``` --- ## Actions The plugin includes action sections for inventory stacking feedback. ```yaml actions: noPermsInventory: - " {prefix} You do not have permission to stack potions in inventories!" onStackInventory: - " ENTITY_VILLAGER_YES" - " {prefix} Potions have been stacked!" ``` --- ## Commands | Command | Description | |---|---| | `/hpotionstack` | Shows the help message | | `/hpotionstack reload` | Reloads the configuration | | `/hpotionstack inventory <player>` | Shows the open inventory type of a player | The inventory command is useful when configuring the allowed inventory type list. --- ## Permissions | Permission | Description | |---|---| | `hpotionstack.admin` | Access to administrative commands | | `hpotionstack.stack` | Allows potion stacking inside inventories | 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 --- ## Install 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: ```text plugins/hPotionStack/config.yml ``` --- ## 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.