Item Actions icon

Item Actions -----

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



Item Actions allows you to create items that have unique properties, or that execute specific actions upon click. For example, a stick that sends the player a defined message or a helmet that gives the player night vision.

Confused? Read the WIKI or join my Discord!

Commands:
  • /itemactions - View command help. (Permission: itemactions.help)
  • /itemactions reload - Reload the configuration and loaded items. (Permission: itemactions.reload)
  • /itemactions give <player> <item> - Give a player Action Item(s). (Permission: itemactions.give)
Default Configuration:

Code (YAML):

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

# General Configuration
Items
:
  SpeedPickaxe
: # The name of the item action, can be anything
    Type
: "INTERACT" # The type of action item this is. Valid Types: INTERACT, ARMOR
    Cooldown
: 60 # The cooldown before they can run the action again, this is in seconds.
    Bypass-Permission
: "itemactions.speedpickaxe.bypass" # The permission to bypass the cooldown.
    Version
: 1 # Used for refresh logic
    # Any information under this must be matched for the action to run from the item.
    # It is recommended to just use the 'data-key' field for items, because it's the safest.
    Item
:
      # The material of the item (https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html)
      Material
: "DIAMOND_PICKAXE"
      Name
: "&eSpeed Pickaxe" # The items name
      Lore
: # The items lore
        - "&cI am &oSpeed."
      # A custom key that can be added to any item/entity, learn more here (https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/persistence/PersistentDataContainer.html)
      # MUST be formatted plugin-name:data-key.
      Data-Key
: "itemactions:speed_pickaxe"
      # The data value type
      # Currently supports: INTEGER, STRING and DOUBLE
      Data-Type
: "STRING"
      # The value of the data
      # Must match the data-type field, for example INTEGER must be an integer.
      # You still must make below value a string though, so even if it's an integer it would still be "1"
      Data-Value
: "1"
    Requirements
:
      # The actual actions required to activate this item action (https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/event/block/Action.html)
      Action-Types
:
       - "RIGHT_CLICK_AIR"
      Permission
: "itemactions.speedpickaxe" # The permission required to use this action, can be removed if no permission is needed
    Actions
: # Item actions, view valid actions on the wiki (https://wiki.justugh.net/resources/item-actions/actions)
      - "PLAY_SOUND:BLOCK_ANVIL_HIT"
      - "RUN_COMMAND:say Must go FAST."
      - "ADD_POTION_EFFECT:speed|3|true|true"
  ZoomyBoots
: # Armor example item, applies speed and negates fall damage when equipped.
    Type
: "ARMOR"
    Version
: 1 # Used for refresh logic
    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>
 

Please leave a good review!

If you have any issues, please do not leave a negative review, contact me first on Discord (@BitByLogic) to attempt to solve your issue!
Resource Information
Author:
----------
Total Downloads: 579
First Release: Feb 9, 2021
Last Update: Apr 20, 2025
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings