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-TypeandData-Valueformats 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.
