2025.11
release
Item Actions
Elevate your items with one-of-a-kind effects!
690
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.