# Item Actions<\/p>\n
\u2728 Create powerful custom items with unique effects and behaviors! \u2728<\/p>\n
**Item Actions** lets you design custom items that trigger actions when used or worn. Whether it\u2019s a stick that sends messages or boots that grant Speed and negate fall damage\u2014this plugin makes it simple and powerful.<\/p>\n
—<\/p>\n
## \ud83d\udd27 Features<\/p>\n
– Define item behaviors with YAML
\n– Trigger commands, potion effects, sounds, and more
\n– Set cooldowns, permissions, and custom metadata
\n– Armor-based effects when equipped or unequipped
\n– Clean configuration and reload support
\n– Full wiki documentation available<\/p>\n
—<\/p>\n
## \ud83d\udce6 Commands<\/p>\n
| Command | Description | Permission | —<\/p>\n ## \ud83d\udcc2 Configuration Example<\/p>\n “`yaml # General Configuration ZoomyBoots: # \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 # \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 —<\/p>\n ## \ud83d\udcda Documentation<\/p>\n Still not sure how to use it?<\/p>\n > \ud83d\udcdd **Read the Wiki** —<\/p>\n ## \u26a0\ufe0f Notes<\/p>\n – Be sure to use a unique `Data-Key` (namespaced) to avoid item conflicts. —<\/p>\n ## \u2b50 Reviews & Support<\/p>\n If you like the plugin, **please leave a positive review!** > \u2757 **Do not leave a negative review.** Elevate your items with one-of-a-kind effects!<\/p>\n","protected":false},"featured_media":86697,"template":"","meta":{"_minecraft_slug":"item-actions","_minecraft_project_id":"WAKeUGjR","_minecraft_author":"BitByLogic","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":690,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"item-actions.zip","_minecraft_size_bytes":457115,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T09:40:31.891983Z","_minecraft_date_created":"2025-04-22T06:07:49.611086Z","_minecraft_date_modified":"2025-11-17T21:43:41.880782Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/item-actions","_minecraft_icon_attachment_id":86697,"_minecraft_imported_at":"2026-06-04T22:52:30+00:00","_minecraft_import_hash":"f1f50f8b1a75a7100a65a942182fa43c","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,88,89,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-86696","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-equipment","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|——–|————-|————|
\n| `\/itemactions` | View command help | `itemactions.help` |
\n| `\/itemactions reload` | Reload configuration and item data | `itemactions.reload` |
\n| `\/itemactions give Click to expand configuration<\/summary>\n
\n# Message Configuration
\nMessages:
\n Cooldown-Message: “&cYou cannot use that action again yet!”<\/p>\n
\nItems:
\n SpeedPickaxe:
\n Type: “INTERACT”
\n Cooldown: 60
\n Bypass-Permission: “itemactions.speedpickaxe.bypass”
\n Version: 1
\n Item:
\n Material: “DIAMOND_PICKAXE”
\n Name: “&eSpeed Pickaxe”
\n Lore:
\n – “&cI am &oSpeed.”
\n Data-Key: “itemactions:speed_pickaxe”
\n Data-Type: “STRING”
\n Data-Value: “1”
\n Requirements:
\n Action-Types:
\n – “RIGHT_CLICK_AIR”
\n Permission: “itemactions.speedpickaxe”
\n Actions:
\n – “PLAY_SOUND:BLOCK_ANVIL_HIT”
\n – “RUN_COMMAND:say Must go FAST.”
\n – “ADD_POTION_EFFECT:speed|3|true|true”<\/p>\n
\n Type: “ARMOR”
\n Version: 1
\n Item:
\n Material: “LEATHER_BOOTS”
\n Name: “&eZoomy Boots”
\n Dye-Color: “#FF0000”
\n Data-Key: “itemactions:zoomy_boots”
\n Data-Type: “STRING”
\n Data-Value: “1”
\n Actions:
\n – “ADD_POTION_EFFECT:speed|3|true|true”
\n – “RUN_COMMAND:say Zoomy Boots Equipped.”
\n – “NEGATE_FALL_DAMAGE”
\n Unequip-Actions:
\n – “REMOVE_POTION_EFFECT:speed”
\n – “RUN_COMMAND:say Zoomy Boots Removed.”<\/p>\n
\n# Bit’s Colors
\n# \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
\nColors:
\n Separator: ‘#3B322C’
\n Primary: ‘#1E90FF’
\n Secondary: ‘#20B2AA’
\n Highlight: ‘#FAFAD2’
\n Error-Primary: ‘#DB162F’
\n Error-Secondary: ‘#E5383B’
\n Error-Highlight: ‘#621708’
\n Success-Primary: ‘#1DAB45’
\n Success-Secondary: ‘#1BC44B’
\n Success-Highlight: ‘#71EA93’<\/p>\n
\n# Bit’s Formatting
\n# \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
\nFormatting:
\n Patterns:
\n Format: <([a-zA-Z0-9 _]+)>(.*?)<\/1>|<([a-zA-Z0-9 _]+)#(.*?)>(.*?)<\/3>
\n Spigot-Hex: \u00a7x(\u00a7[a-fA-F0-9]){6}\u00a7r
\n Hex: ‘#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})’
\n Placeholder: ‘%.+?%’
\n Success:
\n Paged:
\n Footer: ‘\u2937 &7(Page: %current-page%\/%pages%)’
\n Item:
\n Invalid-Page: Invalid page!
\n Rich-Command:
\n Hover:
\n Text: ‘
\n List:
\n Header:
\n Item: ‘&8| &8\u00bb
\n Dotted-Message:
\n Symbols:
\n Dot: \u2022
\n Right-Arrow: \u00bb
\n Main:
\n Center-Pixels: 154
\n Command: ‘
\n Error:
\n“`<\/p>\n<\/details>\n
\n> \ud83d\udcac **Contact Me On Discord: @BitByLogic** for help, support, and feature requests!<\/p>\n
\n– Always match the `Data-Type` and `Data-Value` formats precisely.
\n– Armor actions only trigger when equipped in proper armor slots.<\/p>\n
\nIf you have any issues or questions:<\/p>\n
\n> Instead, **message me directly on Discord (@BitByLogic)** so I can help fix your issue quickly.<\/p>\n","protected":false},"excerpt":{"rendered":"