Item Actions
Elevate your items with one-of-a-kind effects!
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
Item Actions
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
```yaml
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?
> 📝 Contact Me On Discord: @BitByLogic > 💬 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:
> ❗ message me directly on Discord (@BitByLogic) > Instead, message me directly on Discord (@BitByLogic) so I can help fix your issue quickly.