Item Actions

Elevate your items with one-of-a-kind effects!

Автор: BitByLogic1 тыс.3обновлён 17 нояб. 2025 г.

Скачать 2025.11 Все версии (3)

СнаряжениеМеханики игрыУтилиты

Описание

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

# 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?

📝 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.

Галерея

Последние версии

Все версии →

release

Version 2025.11

2025.11

17 нояб. 2025 г.765Minecraft: 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.2bukkit, paper, purpur, spigot

Скачать

Что нового

## 🛠️ Fixes - Prevents potential errors by properly handling `null` `ItemMeta` in the `ItemData.matches()` method.

release

2025.5

20 мая 2025 г.174Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5bukkit, paper, spigot

Скачать

Что нового

# 🛠️ Version 2025.5 - Bug Fixes & New Features This update brings a handful of important bug fixes and new functionality to **ItemActions**! ## 🐛 Bug Fixes - Fixed a bug where **food component options** wouldn't apply correctly on consumable items. - Fixed an issue where **armor potion effects** could become permanent if the armor was removed using a plugin or command. These effects now clean up properly on removal. ## ✨ New Features - Added **recipe support** for custom action items! You can now define shaped or shapeless crafting recipes directly in your item configuration. - Added **consumable item support** — configure items to behave like food, complete with nutrition, saturation, and even particle effects! ### Example Config Snippet: ```yaml Stick: Type: INTERACT Version: 1 Item: Material: STICK Name: '&eSpeed Pickaxe' Data-Key: itemactions:sticks Data-Type: STRING Data-Value: '1' Consumable-Options: Consume-Seconds: 0 Sound: "ENTITY_PLAYER_LEVELUP" Particles: true Food-Options: Can-Always-Eat: true Nutrition: 5 Saturation: 2 Recipe: Recipe-Type: "SHAPED" Ingredients: - "d:DIAMOND" - "e:ENDER_PEARL" Shape: - " " - "ded" - " " Requirements: Action-Types: - RIGHT_CLICK_AIR Actions: - PLAY_SOUND:BLOCK_ANVIL_HIT ``` Thanks for using ItemActions! As always, feedback and suggestions are welcome 💬

release

2025.4

20 апр. 2025 г.89Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5bukkit, paper, spigot

Скачать

Что нового

Initial Project Release!