Item Actions

✨ Create powerful custom items with unique effects and behaviors! ✨

Item Actions lets you design custom items that trigger actions when used or worn. Whether it’s a stick that sends messages or boots that grant Speed and negate fall damage—this plugin makes it simple and powerful.

🔧 Features

• Define item behaviors with YAML
• Trigger commands, potion effects, sounds, and more
• Set cooldowns, permissions, and custom metadata
• Armor-based effects when equipped or unequipped
• Clean configuration and reload support
• Full wiki documentation available

📦 Commands

📂 Configuration Example

# Message Configuration
Messages:
  Cooldown-Message: "&cYou cannot use that action again yet!"

# General Configuration
Items:
  SpeedPickaxe:
    Type: "INTERACT"
    Cooldown: 60
    Bypass-Permission: "itemactions.speedpickaxe.bypass"
    Version: 1
    Item:
      Material: "DIAMOND_PICKAXE"
      Name: "&eSpeed Pickaxe"
      Lore:
        - "&cI am &oSpeed."
      Data-Key: "itemactions:speed_pickaxe"
      Data-Type: "STRING"
      Data-Value: "1"
    Requirements:
      Action-Types:
        - "RIGHT_CLICK_AIR"
      Permission: "itemactions.speedpickaxe"
    Actions:
      - "PLAY_SOUND:BLOCK_ANVIL_HIT"
      - "RUN_COMMAND:say Must go FAST."
      - "ADD_POTION_EFFECT:speed|3|true|true"

  ZoomyBoots:
    Type: "ARMOR"
    Version: 1
    Item:
      Material: "LEATHER_BOOTS"
      Name: "&eZoomy Boots"
      Dye-Color: "#FF0000"
      Data-Key: "itemactions:zoomy_boots"
      Data-Type: "STRING"
      Data-Value: "1"
    Actions:
      - "ADD_POTION_EFFECT:speed|3|true|true"
      - "RUN_COMMAND:say Zoomy Boots Equipped."
      - "NEGATE_FALL_DAMAGE"
    Unequip-Actions:
      - "REMOVE_POTION_EFFECT:speed"
      - "RUN_COMMAND:say Zoomy Boots Removed."

────────────

Bit's Colors

────────────

Colors: Separator: '#3B322C' Primary: '#1E90FF' Secondary: '#20B2AA' Highlight: '#FAFAD2' Error-Primary: '#DB162F' Error-Secondary: '#E5383B' Error-Highlight: '#621708' Success-Primary: '#1DAB45' Success-Secondary: '#1BC44B' Success-Highlight: '#71EA93'

────────────────

Bit's Formatting

────────────────

Formatting: Patterns: Format: <([a-zA-Z0-9 _]+)>(.?)</\1>|<([a-zA-Z0-9 _]+)#(.?)>(.*?)</\3> Spigot-Hex: §x(§[a-fA-F0-9]){6}§r Hex: '#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})' Placeholder: '%.+?%' Success: <c#success_primary>&l%prefix% &8%dot% <c#success_secondary>%message% Paged: Footer: '⤷ &7(Page: %current-page%/%pages%)' Item: <c#separator>| » <c#highlight>%text% Invalid-Page: Invalid page! Rich-Command: Hover: <c#secondary>%description% Text: ' <c#primary>/%command%' List: Header: <c#primary>&l%prefix% &8%dot% <c#secondary>%info% Item: '&8| &8» <c#success_primary>%prefix% &8%dot% <c#success_secondary>%message%' Dotted-Message: <c#success_primary>%prefix% &8%dot% <c#success_secondary>%message% Symbols: Dot: • Right-Arrow: » Main: <c#primary>&l%prefix% &8%dot% <c#secondary>%message% Center-Pixels: 154 Command: ' <c#primary>/%command% &8─ <c#secondary>%description%' Error: <c#error_primary>&l%prefix% &8%dot% <c#error_secondary>%message%

</details>

---

## 📚 Documentation

Still not sure how to use it?

> 📝 **Read the Wiki**  
> 💬 **Contact Me On Discord: @BitByLogic** for help, support, and feature requests!

---

## ⚠️ Notes

- Be sure to use a unique `Data-Key` (namespaced) to avoid item conflicts.
- Always match the `Data-Type` and `Data-Value` formats precisely.
- Armor actions only trigger when equipped in proper armor slots.

---

## ⭐ Reviews & Support

If you like the plugin, **please leave a positive review!**  
If you have any issues or questions:

> ❗ **Do not leave a negative review.**  
> Instead, **message me directly on Discord (@BitByLogic)** so I can help fix your issue quickly.