# 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](https://bitbylogic.gitbook.io/bitbylogics-resources/resources/item-actions) available --- ## 📦 Commands | Command | Description | Permission | |--------|-------------|------------| | `/itemactions` | View command help | `itemactions.help` | | `/itemactions reload` | Reload configuration and item data | `itemactions.reload` | | `/itemactions give ` | 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 _]+)>(.*?)|<([a-zA-Z0-9 _]+)#(.*?)>(.*?) Spigot-Hex: §x(§[a-fA-F0-9]){6}§r Hex: '#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})' Placeholder: '%.+?%' Success: &l%prefix% &8%dot% %message% Paged: Footer: '⤷ &7(Page: %current-page%/%pages%)' Item: | » %text% Invalid-Page: Invalid page! Rich-Command: Hover: %description% Text: ' /%command%' List: Header: &l%prefix% &8%dot% %info% Item: '&8| &8» %prefix% &8%dot% %message%' Dotted-Message: %prefix% &8%dot% %message% Symbols: Dot: • Right-Arrow: » Main: &l%prefix% &8%dot% %message% Center-Pixels: 154 Command: ' /%command% &8─ %description%' Error: &l%prefix% &8%dot% %message% ```

--- ## 📚 Documentation Still not sure how to use it? > 📝 **[Read the Wiki](https://bitbylogic.gitbook.io/bitbylogics-resources/resources/item-actions)** > 💬 **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: > ❗ **Do not leave a negative review.** > Instead, **message me directly on Discord (@BitByLogic)** so I can help fix your issue quickly.

ItemActions

2025.5

2024.5