🧪 BetterPotionsExtended

!Version !Platform !Minecraft

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 Customization: Set separate custom durations for Normal, Extended, Splash, and Lingering tracks.
• 📦 Dynamic Inventory Synchronizer: Automatically hides deceptive client-side vanilla tooltips and replaces them with a clean, custom blue status line matching your config timers.
• ✨ Visual Editor Dashboard: Open a beautifully colored in-game GUI where every potion bottle matches its actual vanilla liquid texture color.
• 🛠️ In-Game Fine Tuning: Click interactive items inside the GUI 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 without requiring a restart.
• 🛡️ Ultra-Lightweight: Written using native event intercepts and optimized explicitly for high-population Paper environments.

---

🔧 Commands

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

Command	Description	Permission
/bpe potions	Opens the interactive visual GUI configuration editor.	betterpotionsextended.admin
/bpe give <player> <potion> [type]	Instantly spawns a custom 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 (Spawns a custom Strength drinkable 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 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
  SPEED:
    tier_1:
      normal_duration: 360
      extended_duration: 480
      splash_duration: 270
      lingering_duration: 90
  WEAVING:
    tier_1:
      normal_duration: 180
      splash_duration: 135
      lingering_duration: 45