See release notes: Github

BuffedItems v1.4.1 Patch Notes


Bug Fixes

• Item Duplication: Fixed a critical issue where modifying a copied item's properties (specifically nested data like Costs or Ingredients) would also unintentionally modify the original item.

BuffedItems v1.4.0 Changelog

New Features

• [Sets] Item Set System Added: A complete system to grant bonuses for wearing/holding specific combinations of items.
  • Configuration: New sets.yml file to define sets and bonuses easily.
  • In-Game Editor: Full GUI support added to Main Menu (/bi menu). You can create sets, add items, and configure tier bonuses (Potions/Attributes) entirely in-game.
  • Smart Logic:
    • Bonuses are cumulative (e.g., wearing 3 pieces grants both 2-piece and 3-piece bonuses).
    • Armor pieces must be equipped in armor slots to count (holding them in hand won't trigger bonuses).
    • Weapons/Tools count when held in hands.
• [Core] Enhanced Startup Summary: The console startup log now includes detailed statistics for Item Sets (Total, Valid, Errors).

Performance & Improvements

• [Core] Optimized EffectApplicatorTask:
  • Distributed Checks: Inventory scanning is now distributed over ticks to prevent lag spikes on high-population servers.
  • Permission Caching: Implemented smart caching (1s) for permission checks, drastically reducing CPU usage for permission plugins while keeping updates responsive.
• [Editor] The Item Editor's live preview item now displays Usage Limit, Depletion Action, and Transform Target details when Active Mode is enabled.

Fixes

• [Core] Data Loss Prevention (ItemUpdater):
  • Refactored the update mechanism to clone existing items instead of rebuilding them from config.
  • Impact: This ensures that custom NBT data from other plugins, player-added enchantments, and custom names are preserved when BuffedItems updates an item.
  • Fixed IllegalArgumentException: Modifier is already applied error when updating attribute modifiers.

Changelog

• Hex Color Input Fix: Fixed an issue where hex colors entered via chat were being stripped or corrupted by other chat plugins. The system now correctly captures raw hex codes and saves them in the clean &#RRGGBB format.

BuffedItems v1.3.0 Changelog

This update transforms the plugin from a static structure into a "Live and Dynamic" system. Changes made in config files are now instantly reflected on player items, along with a robust Usage Limit system and significant Performance Optimizations.

New Feature: Live Item & Placeholder Update

Your items are now alive! Any changes to item names, lore, or properties in the config are automatically applied to old items held by players the moment they are used.

• Dynamic Placeholders: PlaceholderAPI placeholders (e.g. %player_name%, %vault_eco_balance%) are now re-parsed dynamically whenever the item is used or updated.
• Smart Update: Items auto-upgrade when used, held, picked up, or when players join.
• Data Preservation: The following are preserved during updates:
 ✔ Anvil-renamed Names
 ✔ Custom Enchantments
 ✔ Armor Trims
 ✔ Leather Armor Colors
 ✔ Vanilla Durability & Usage Limits

New Feature: Usage Limits

A custom Usage Right system.

• Flexible Actions: DESTROY, DISABLE (mark as depleted), or TRANSFORM
• Depletion Commands: Supports logic prefixes like [chance], [delay]
• Advanced Feedback: Special sounds, lores, and messages

Performance & Optimization

• Item Caching: Cached & cloned instead of fully rebuilt
• PAPI Optimization: Fast-Fail skip if no % placeholders are present

GUI & Visual Improvements

• New Usage Limit Menu
• Expanded sound presets
• Cleaner menu icons using ItemFlags

Bug Fixes

• Fixed Base Item saving in Upgrade menu
• Hex color capture priority improved
• Prevented player-inventory clicks from triggering menu actions
• Fixed Smithing Table protection logic
• Sound = NONE now properly disables playback

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.
• 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].
  • 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, etc.).
  • Recipe Browser: A built-in menu to view all available upgrades.
• Universal Cost System:
  • Add requirements for Using Active Items or Upgrading Items.
  • Supported Costs: MONEY (Vault), COINSENGINE, XP, LEVEL, HEALTH, HUNGER, ITEM (Vanilla), BUFFED_ITEM.
  • Custom Feedback: Define specific failure messages for each cost.
• Advanced Customization:
  • Custom Enchantment Support: Added support for third-party plugin enchantments (e.g., EcoEnchants) in the selector.
  • Enchantment Search: Added a search bar to the Enchantment Selector GUI.
  • New Flag: LOST_ON_DEATH (Item permanently vanishes on death).
  • Permission Hierarchy: Active/Passive permissions now inherit from Main permission if not set.

️ Improvements & Refactors

• HookManager: Centralized all external dependencies (Vault, PAPI, CoinsEngine, ItemsAdder, Nexo).
• Global PAPI Support: Placeholders are now parsed in all chat messages, visuals, and item generation.
• Smart Config Updater: Intelligently updates config headers without resetting custom items.
• Validation: Added strict config checks for Upgrades, Costs, and Sounds to prevent silent failures.
• Startup Summary: Enhanced console output to show valid/invalid item counts.
• Editor Polish: Merged selector menus, added visual error indicators, and improved layouts.

Bug Fixes

• Critical Fix: Implemented deterministic UUIDs for active attributes to fix memory leaks and conflicts.
• GUI Fixes: Fixed NPE in PaginatedMenu and glass pane interactions.
• Config Fix: Fixed configuration migration resetting user-deleted default items.

Bug Fixes

• Fixed a critical issue where config.yml was not generated automatically on the first server startup. It now correctly saves the default configuration if missing.

To update, simply replace the jar file. No config changes are required.

v1.1.0

This update introduces significant architectural changes to improve data safety and configuration management.

NOTICE: Existing item configurations in config.yml will be automatically migrated to items.yml upon first launch.

Changelog

• [New] Configuration Split: Items are now stored in a dedicated items.yml file.
• [New] Instant-Save: All changes made via the in-game GUI are now immediately committed to disk.
• [New] General Settings Menu: Added a new menu to toggle global settings in-game.
• [New] Quick Retrieve: Added Shift+Left Click shortcut to the Main Menu.
• [Change] Backups are now stored in the /plugins/BuffedItems/backups/ directory.
• [Remove] Removed /bi save command and auto-save task (obsolete).
• [Fix] Resolved redundant console logs during startup.
• [Fix] Optimized shutdown routines to prevent potential data race conditions.

[1.0.1]

Fixed
- Potion Effects Refresh Issue: Fixed potion effects not refreshing continuously for cached players