BuffedItems v1.2.0 - The "Active Logic & Upgrades" Update

v1.2.0 update introduces Active Abilities, a Scripting Engine, an Upgrade System, a Cost System, and major architectural refactors.

Buffed Items has a wiki now!

✨ New Features

• ⚡ Active Items (Right-Click Abilities):

  • Items can now trigger actions when right-clicked!
  • Cooldown System: RAM-based tracking with visual feedback (Chat, Title, Action Bar, and BossBar).
  • Temporary Effects: Give potion effects or attributes for a specific duration upon use.
  • Sound FX: Configure custom sounds for Success, Cooldown, and Cost Failure.
  • Silent Execution: Commands run without console spam.

• 📜 Advanced Scripting Engine:

  • Create complex mechanics using Logic Prefixes in your command chains.
  • [chance:50]: Execute commands with a percentage chance.
  • [delay:20]: Add delays (in ticks) between actions.
  • [else]: Trigger commands only if the immediately preceding [chance] check failed.
  • [console]: Run commands as console (supports execute at %player%).
  • Visual Actions: [message], [title], and [actionbar] for clean feedback.
  • Chaining: Use ;; to run multiple logic blocks in a single line.

• 🆙 Upgrade Station (/bi upgrade):

  • A new GUI system allowing players to evolve their items (e.g., Sword Lvl 1 -> Sword Lvl 2).
  • Risk System: Configure Success Rates and Failure Actions (LOSE_EVERYTHING, KEEP_BASE_ONLY, KEEP_EVERYTHING).
  • Recipe Browser: A built-in menu to view all available upgrades.
  • Visuals: Added visual quantity indicators to upgrade menus.

• 💎 Universal Cost System:

  • Add requirements for Using Active Items or Upgrading Items.
  • Supported Costs:
    • Economy: MONEY (Vault), COINSENGINE (Custom Currencies).
    • Player: XP (Points), LEVEL, HEALTH, HUNGER.
    • Items: ITEM (Vanilla Materials), BUFFED_ITEM (Custom Items).
  • Custom Feedback: Define specific failure messages for each cost.

• 🔮 Advanced Customization:

  • Custom Enchantment Support: Added EnchantmentFinder to support vanilla, namespaced, and third-party plugin enchantments (e.g., EcoEnchants) in the selector menu.
  • Enchantment Search: Added a search bar to the Enchantment Selector GUI.
  • New Item Flag: LOST_ON_DEATH (Item permanently vanishes on death).
  • Permission Hierarchy: Implemented Active and Passive permissions that inherit from the Main permission if not set individually.

🛠️ Improvements & Refactors

• HookManager: Centralized all external dependencies (Vault, PAPI, CoinsEngine, ItemsAdder, Nexo) into a safe HookManager.
• Global PAPI Support: Placeholders are now parsed in all chat messages, error warnings, visual elements (BossBar/Title), and item generation.
• Smart Config Updater: Intelligently updates config headers/versions without resetting custom items in items.yml or recipes in upgrades.yml.
• Backups: Added automatic backup generation for upgrades.yml.
• Validation: Added strict config checks for Upgrade recipes, Costs, Sounds, and BossBars to prevent silent failures.
• Startup Summary: Enhanced console output to show valid/invalid item counts and active hooks.
• Editor Polish: * Merged Cost and Ingredient selectors into a unified TypeSelectorMenu.
  • Added visual error indicators (Bedrock icon) for missing plugins in menus.
  • Improved CostListMenu layout.

🐛 Bug Fixes & Optimization

• Critical Fix: Implemented deterministic, player-specific UUIDs for active attributes to fix memory leaks and attribute conflicts.
• GUI Fixes: Fixed NPE in PaginatedMenu on empty slot clicks; fixed glass pane interactions.
• Config Fix: Fixed configuration migration resetting user-deleted default items.
• Logic Fix: Fixed active effect paths and attribute parsing in chat listeners.