Armor Items allow you to give armor pieces unique features. Example being, a helmet that gives the player night vision, or boots that prevent fall damage. Currently these actions are limited to each armor piece, but eventually the goal is to allow unique armor set features.
Now, let's go over the default Armor Item example.
ZoomyBoots: # The name of the Armor Item, can be anything
# The type of action item this is. Valid Types: INTERACT, ARMOR
Type: "ARMOR"
# This version is used for refresh logic
Version: "1"
# 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:
# A list of materials, if the item matches any it will be valid, learn more here (https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html)
Material: "LEATHER_BOOTS"
Name: "&eZoomy Boots" # The items name
Dye-Color: "#FF0000" # The color of the leather boots
# 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:zoomy_boots"
# 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"
Actions: # Item actions, view valid actions on the wiki.
- "ADD_POTION_EFFECT:speed|3|true|true"
- "RUN_COMMAND:say Zoomy Boots Equipped."
- "NEGATE_FALL_DAMAGE"
Unequip-Actions: # These are ran when the armor item is unequipped.
- "REMOVE_POTION_EFFECT:speed"
- "RUN_COMMAND:say Zoomy Boots Removed."
