Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for BitByLogic
Avatar for BitByLogic
BitByLogic /

ItemActions

Elevate your items with one-of-a-kind effects!

Report ItemActions?

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

Command Description Permission
/itemactions View command help itemactions.help
/itemactions reload Reload configuration and item data itemactions.reload
/itemactions give <player> <item> Give a player a configured item itemactions.give

πŸ“‚ Configuration Example

Click to expand configuration 
# 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%</c> &8%dot% <c#success_secondary>%message%</c>
  Paged:
    Footer: 'β€· &7(Page: %current-page%/%pages%)'
    Item: <c#separator>| Β» </c><c#highlight>%text%</c>
    Invalid-Page: Invalid page!
  Rich-Command:
    Hover: <c#secondary>%description%</c>
    Text: ' <c#primary>/%command%</c>'
  List:
    Header: <c#primary>&l%prefix%</c> &8%dot% <c#secondary>%info%</c>
    Item: '&8| &8Β» <c#success_primary>%prefix%</c> &8%dot% <c#success_secondary>%message%</c>'
  Dotted-Message: <c#success_primary>%prefix%</c> &8%dot% <c#success_secondary>%message%</c>
  Symbols:
    Dot: β€’
    Right-Arrow: Β»
  Main: <c#primary>&l%prefix%</c> &8%dot% <c#secondary>%message%</c>
  Center-Pixels: 154
  Command: ' <c#primary>/%command%</c> &8─ <c#secondary>%description%</c>'
  Error: <c#error_primary>&l%prefix%</c> &8%dot% <c#error_secondary>%message%</c>

πŸ“š 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.

Information

CategoryAdmin Tools
Published onNovember 17, 2024
LicenseUnspecified
Downloads28
Stars1
Watchers0

Pinned Versions

Pages

Members

Avatar for BitByLogic

BitByLogic

Owner