🧪 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.

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

1. Download the compiled plugin jar from our versions tab.
2. Stop your server and place the jar file into your server's /plugins/ folder.
3. Start the server to generate the default configuration folder.
4. 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