BuffedItems is a powerful item engine that allows you to create unique custom items with persistent attributes, passive effects, and scripted active abilities all managed through a comprehensive in-game GUI editor.


▤ Full In-Game GUI Editor: Access a powerful menu with /bi menu to manage every aspect of your items.


️✪ Passive Effects: Grant permanent effects based on where the item is held/worn ( MAIN_HAND, OFF_HAND, ARMOR, INVENTORY).

• Potions: Speed, Night Vision, Jump Boost, etc.
• Attributes: +Max Health, +Attack Damage, +Movement Speed, etc.

✺ Active Abilities & Scripting: Trigger commands and effects with a Right-Click.

• Advanced Command Chaining: Use logic prefixes ([delay], [chance], [else]) and command chaining (;;) to create complex scenarios.
• Note: The [else] command only triggers if the immediately preceding command fails due to a chance check ([chance:XX]). See the Wiki for detailed logic guides.
• Actions: Send messages, titles, play sounds, or execute console commands.
  
• Visual Feedback: Built-in cooldowns with BossBar, ActionBar, and Title support.

◆ Cost System: Set requirements to use items or upgrades.

• Supported Types: Money (Vault), CoinsEngine, XP, Level, Health, Hunger, Vanilla Items, and Custom BuffedItems.
• Custom Messages: Set item-specific failure messages for each cost to provide precise player feedback.

⟳ Live Item Updates: Change an item's damage, lore, or name in the config, and players' existing items will automatically update the moment they are used or clicked.

• Data Safety: Custom Enchants, Anvil Names, and Usage Stats are preserved during updates.

▮ Usage Limits: Create items with a specific number of uses.

• Actions: Choose what happens when depleted: DESTROY, DISABLE (Mark as depleted), or TRANSFORM (into another item).
• Feedback: Custom sounds and messages for depletion events.

▲Upgrade Station: Allow players to evolve their items

• (e.g., Sword Lvl 1 -> Sword Lvl 2).
• Configure Success Rates and Risk Factors (Lose all on fail, keep base item, etc.).

✦ Item Set Bonuses: Create RPG-style armor sets!

• Combine specific items (Helmet, Chestplate, Sword, etc.) to unlock Tiered Bonuses.
• Example: "Wear 2 pieces for Speed I, wear 4 pieces for +10 Health."
• Manage sets entirely via the In-Game GUI (/bi menu -> Item Sets).

■ Item Flags & Protections:

• PREVENT_DEATH_DROP (Soulbound): Item stays with player on death.
• PREVENT_DROP: Prevents dropping, storing in chests, or placing in item frames.
• UNBREAKABLE: Item never loses durability.
• PREVENT_ANVIL_USE / PREVENT_SMITHING_USE: Restricts item usage in various crafting tables.
• PREVENT_CONSUME / PREVENT_INTERACT: Blocks eating/drinking or general right-click actions.
• and many more...

✎ Deep Customization:

• Full HEX Color support (&#RRGGBB).
• Custom Model Data support for resource packs (ItemsAdder/Nexo friendly).
• Cooldown Visuals: BossBar, ActionBar, and Title countdowns.
• PAPI Placeholders: Placeholders are accepted everywhere.

For detailed guides on all features, visit the BuffedItems Wiki.



The plugin operates on a dynamic, event-driven architecture designed for performance and flexibility:

1. Design in-Game: Use /bi menu to create items. No config editing needed. You can attach Passive Stats (Attributes/Potions) and Active Abilities (Command Logic) to any item.
2. Passive Engine: The core task scans players' inventories efficiently. If a player equips a specific item in the correct slot (e.g., Magma Boots on feet), they instantly gain the configured effects. Unequip it, and the effects vanish.
3. Active Triggers: When a player right-clicks an Active Item:
   • Checks: Cooldowns, Permissions, and Costs (Money, XP, Items) are verified.
   • Logic: If checks pass, the item executes your command script (supports [chance], [delay], [console] logic).
   • Feedback: Plays sounds, visuals, etc.
4. Set Bonuses: The plugin tracks how many items from a specific Set a player is wearing. As they equip more pieces (2/4, 3/4...), they unlock tiered bonuses automatically.
5. Live Updates: Changed a stat in the config? The moment a player uses or clicks their existing item, it auto-updates to the new version while preserving their custom enchantments and data.

• Custom Armor Textures: This plugin only sets the CustomModelData tag. It does not manage resource packs or custom armor models. Wearable items (helmets, armor) using ItemsAdder/Nexo IDs will show the custom texture in the inventory, but will render as the default material (e.g., Diamond Helmet) when equipped on the player.
• Configuration Files:
  • config.yml: Contains general plugin settings (messages, debug level, etc.)
  • items.yml: Stores all your custom items.
  • upgrades.yml: Stores all your upgrade recipes.
    
  • Editing: We recommend using the in-game GUI (/bi menu) as it handles everything for you instantly. However, you CAN edit these files manually if you prefer! Just run /bi reload afterwards to apply your manual changes.

The main command is /buffeditems (Aliases: /bi, /buffitems).

Command	Permission	Description
/bi menu	buffeditems.command.menu	Opens the main GUI editor to create, edit, and delete items.
/bi upgrade	buffeditems.command.upgrade	Opens the Item Upgrade Station.
/bi give <player> <item_id> [amount]	buffeditems.command.give	Gives a player the specified custom item.
/bi reload	buffeditems.command.reload	Safely reloads config.yml, items.yml, and upgrades.yml from disk.
/bi list	buffeditems.command.list	Lists all created items and shows if any have configuration errors.
/bi wiki	buffeditems.command.wiki	Opens wiki page
/bi update	buffeditems.command.update	Checks for the latest update.

Admin Permission:

• buffeditems.admin: Grants access to all BuffedItems commands.

Item Permissions:

• You can define a custom permission (e.g., myitems.warrior_perk) inside the item editor. If set, a player must have this permission to receive the item's effects. See the Wiki for permission details.

• Java 17 or newer
• Minecraft 1.21 or newer