Item Actions

Minecraft 版本： 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2 26.2

平台： bukkit paper purpur spigot

标签： equipment game-mechanics utility

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: (.*?)\1>|(.*?)\3> 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
? 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.