Oath Potion Stacking

Allows for easy Potion Stacking with limits to what can be stacked and what can't, easy use for any server.

Config.yml ``` #################################################################### # Oath-PotionStacking # ------------------------------------------------------------------ # Makes potions stack like normal items by stamping them with # Minecraft's NATIVE max_stack_size item component (1. 20. 5+). # # Because this uses the real vanilla mechanic, stamped potions: # • merge automatically on pickup, shift-click, drag AND # double-click — exactly like cobblestone or arrows, # • NEVER "destack" when moved around the inventory. # No fake/lore stacking, so there are none of the classic dupe or # destack bugs that approach suffers from. ####################################################################

# Master switch. false = the plugin does nothing (existing stacks keep # whatever size component they already have). enabled: true

# Default maximum stack size for every stackable potion (1-99). Used for any # potion type that does not have its own override in potion-types below. default-stack-size: 16

# Which item materials are treated as "potions". By default ALL THREE potion # item types are made stackable — drinkable, splash and lingering. potion-materials: - POTION - SPLASH_POTION - LINGERING_POTION

# ------------------------------------------------------------------ # Strict matching # true (recommended): potions only ever stack when they are EXACTLY # identical (same type, effects, custom name, lore — the server's own # item comparison). This is precisely how normal vanilla items behave # and is completely safe — nothing is ever rewritten. # false: looser matching. Potions of the same type are normalised to a # canonical form (their custom name and lore are stripped) so cosmetic # differences no longer stop them from stacking together. # WARNING: this rewrites the name/lore of affected potions. Leave it # on 'true' unless you specifically want that behaviour. # ------------------------------------------------------------------ strict-matching: true

# Never touch potions created by other plugins, so custom/special potions are # left completely alone (detected by their persistent-data-container namespace). ignore-custom-items: true custom-item-namespaces: - mmoitems - itemsadder - nexo - oraxen

# A safety-net re-scan of every online player's inventory, in ticks (20 = 1s). # Stamps potions that arrived from sources we don't hook directly (the creative # menu, /give, other plugins, trades, ...). Set 0 to disable the periodic scan. rescan-interval-ticks: 100

# Event hooks for INSTANT stacking. Leave all true for the best experience. hooks: pickup: true # stamp ground items just before they are picked up inventory-open: true # stamp every potion when a player opens an inventory inventory-click: true # stamp (next tick) after a click, for instant merges brew: true # stamp brewing-stand output

# ================================================================== # Per-potion-type overrides # ------------------------------------------------------------------ # Keys are Bukkit PotionType names. Hold a potion and run # /oathpotionstacking info to see the exact key for it. # For each type you may set: # enabled: false -> keep that potion type UNSTACKABLE # stack-size: -> use a different limit than default-stack-size # Potions that have only custom effects (no base type) use the key CUSTOM. # # Every potion type stacks by default — only the entries below differ. # ================================================================== potion-types: # Instant Healing is kept unstackable by default — this is the example disable. # Every other potion type stacks. Add more entries to disable others the same # way (e.g. HARMING / STRONG_HARMING for instant damage on a PvP server). HEALING: enabled: false STRONG_HEALING: enabled: false

# ---- More disable examples (uncomment to use) ---- # HARMING: # enabled: false # STRONG_HARMING: # enabled: false

# ---- Per-type custom stack limits (uncomment / edit) ---- # REGENERATION: # stack-size: 8 # STRONG_REGENERATION: # stack-size: 8 # STRENGTH: # stack-size: 16 # WATER: # stack-size: 64 ```