Features
- Potion Shop GUI — Buy single custom potions or fill your entire inventory instantly.
- Custom Splash Potions:
- Splash Healing (Instant Health II)
- Splash Health Boost (Customizable amplifier, cooldown, and duration. Bypasses vanilla angle-scaling so players always get the full duration).
- Cure All Potion (Cleanses all negative debuffs in a custom splash radius, green color with hidden potion tooltip). - Throw Cooldowns — Fully synchronized, version-safe usage cooldowns for splash potions that prevent item consumption/inventories desyncs.
- Hotbar Sorting — Command-based sorting (/potsort) to instantly fill empty hotbar slots with your inventory potions.
- Vault Economy — Complete integration with any Vault-compatible economy engine.
- Maximum Compatibility — Run on any Spigot, Paper, or Purpur server from 1.8 all the way up to 1.21+ using modern and legacy fallback APIs.
- Extremely Lightweight — Small footprint, zero NMS dependencies, and no ProtocolLib required.
Commands
- /pots — Opens the potion shop GUI
- /potsort — Sorts potions from inventory slots into your hotbar
- /potessentials reload — Reloads the configuration file
Permissions
- potessentials.pots — Access to open the /pots shop (default: true)
- potessentials.potsort — Access to use the /potsort command (default: true)
- potessentials.reload — Access to reload the configuration (default: op)
Config
Code (YAML):
enabled:
pots : true
potsort : true
# Command cooldowns (for /pots and /potsort commands)
cooldowns:
pots : 5 # Seconds before /pots can be used again
potsort : 5 # Seconds before /potsort can be used again
potions:
healing:
enabled : true
name : "&dSplash Healing Potion"
price_single : 100.0
price_fill : 150.0
cooldown : 0 # Usage cooldown in seconds (0 = no cooldown)
healthboost:
enabled : true
name : "&cSplash Health Boost"
price_single : 200.0
price_fill : 250.0
cooldown : 5 # Usage cooldown in seconds
duration : 15 # Effect duration in seconds
amplifier : 1 # 0 = Level I (+2 hearts), 1 = Level II (+4 hearts), etc.
cureall:
enabled : true
name : "&aCure All Potion"
price_single : 300.0
price_fill : 350.0
cooldown : 10 # Usage cooldown in seconds
radius : 4.25 # Splash radius in blocks
potsort:
sort_healing : true
sort_healthboost : true
sort_cureall : true
messages:
no_permission : "&cYou don't have permission."
cooldown : "&cPlease wait {time}s before using this again."
potion_cooldown : "&cYou must wait {time}s before using this potion again."
potsort_success : "&aYour potions have been sorted to the hotbar."
bought_one : "&aYou bought 1 {type} for &6${price}&a."
bought_many : "&aYou bought &6{amount}&a {type} for &6${total}&a."
bought_none : "&cYou can't afford any potions."
not_enough_money : "&cYou don't have enough money."
- Drop PotEssentials-1.0.jar into your server's plugins directory.
- Ensure you have Vault and a compatible economy plugin (e.g. EssentialsX) installed.
- Restart the server.
- Configure `config.yml` to your liking, then run /potessentials reload to apply changes!
Support
Discord
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.7, 1.8, 1.9
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
PotEssentials is a free Minecraft Java mod. Compatible with Minecraft 1.7, 1.8, 1.9, 1.10 and newer. Downloaded 5 times (via Spigot). Download it and open it directly in the game.