🧪 BetterPotionsExtended

An advanced, high-performance sandbox utility engine designed to seamlessly override, extend, and visually display custom potion mechanics across all configurations. Fully supports Minecraft 1.21+ Trial Chamber variants (like Weaving) via real-time, interactive in-game UI controls!

🚀 Key Features

⚡ Total Potion & Tier Customization: Set separate custom durations for Normal, Extended, Splash, and Lingering tracks across both Tier I and Tier II potions.
📦 Dynamic Inventory Synchronizer: Automatically hides deceptive client-side vanilla tooltips and replaces them with a clean, custom blue status line matching your config timers.
🌈 54-Slot Visual Editor Dashboard: Open a beautifully colored in-game GUI where every potion bottle matches its exact vanilla liquid texture color, complete with a Central Preview Bottle that displays live duration and tier updates.
🛠️ In-Game Tier I & II Fine Tuning: Seamlessly toggle between Tier I and Tier II inside the GUI and click interactive items to add or subtract 30 seconds from any potion track on the fly.
🔄 Hot-Reload Support: Configuration changes save instantly and update live across the server via command or the dedicated GUI hot-reload button without requiring a restart.
🛡️ Ultra-Lightweight: Written using native event intercepts and optimized explicitly for high-population Paper and Spigot environments.

🔧 Commands

All subcommands feature intelligent, deep Tab-Completion that dynamically populates online player names, valid potion keys, item forms, and potion tiers as you type.

Command	Description	Permission
`/bpe potions`	Opens the 54-slot interactive visual GUI configuration editor.	`betterpotionsextended.admin`
`/bpe give <player> <potion> [type] [1/2]`	Instantly spawns a custom Tier I or Tier II potion stack into a player's inventory.	`betterpotionsextended.admin`
`/bpe reload`	Reloads the `config.yml` settings live into the server memory.	`betterpotionsextended.admin`

Examples

/bpe give @s WEAVING splash (Spawns a custom Weaving splash potion)
/bpe give @s STRENGTH normal 2 (Spawns a custom Tier II Strength drinkable potion)
/bpe give @s SWIFTNESS lingering 1 (Spawns a custom Tier I Speed lingering potion)

📦 Installation

Download the compiled plugin jar from our versions tab.
Stop your server and place the jar file into your server's /plugins/ folder.
Start the server to generate the default configuration folder.
If you use a permission manager (like LuckPerms), grant your admin group the following permission node: betterpotionsextended.admin

⚙️ Configuration

You can edit times for both Tier I and Tier II directly via the /bpe potions game menu, or modify the plugins/BetterPotionsExtended/config.yml file directly. All values are set in seconds:

# BetterPotionsExtended Configuration
# All durations are defined in seconds. Set a value to -1 to fall back to vanilla defaults.

potions:
  STRENGTH:
    tier_1:
      normal_duration: 360       # Standard drinkable potion duration
      extended_duration: 480     # Redstone-extended potion duration
      splash_duration: 270       # Splash potion duration
      lingering_duration: 90     # Lingering cloud effect duration
    tier_2:
      normal_duration: 180       # Tier II (Glowstone) drinkable duration
      splash_duration: 135       # Tier II splash duration
      lingering_duration: 45     # Tier II lingering duration
  SWIFTNESS:
    tier_1:
      normal_duration: 360
      extended_duration: 480
      splash_duration: 270
      lingering_duration: 90
    tier_2:
      normal_duration: 180
      splash_duration: 135
      lingering_duration: 45
  WEAVING:
    tier_1:
      normal_duration: 180
      splash_duration: 135
      lingering_duration: 45

Better Potions Extended

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags