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 (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 <player> <item>` | Give a player a configured item | `itemactions.give` | --- ## 📂 Configuration Example <details> <summary>Click to expand configuration</summary> ```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: <(+)>(.*?)</\1>|<(+)#(.*?)>(.*?)</\3> Spigot-Hex: §x(§){6}§r Hex: '#({6}|{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> ``` </details> --- ## 📚 Documentation Still not sure how to use it? > 📝 **(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.