CustomItems+ (Кастомайтемс)

Плагин для серверов Майнкрафт на Paper и Purpur, который позволяет создавать собственные предметы через YAML-конфиги без программирования. Для предмета задаётся цепочка «событие → условия → действия»: она подходит для инструментов, пвп-оружия, способностей, комбо и эффектов.

Возможности

• События срабатывания: BLOCK_BREAK при разрушении блока, ENTITY_HIT при ударе по сущности и RIGHT_CLICK при нажатии ПКМ.
• Условия COOLDOWN для задержки использования и HIT_COUNTER для срабатывания после заданного числа ударов.
• Действия наносят дополнительный урон, накладывают эффекты, притягивают или отталкивают сущностей, выбирают цель, ломают блоки областью и расходуют прочность.
• Можно выбрать игрока, атакованную сущность или ближайших существ и сохранить выбор в переменную, например targets.
• Плагин учитывает отменённые события и не обходит защиту регионов; совместим с плагинами приватов, пвп, боевых меток и античитами.

Настройка

Пользовательские предметы описываются в items.yml, общие параметры — в config.yml. Если действие использует from:, перед ним нужно выбрать цель, например через SELECT_HIT_ENTITY, SELECT_NEARBY_ENTITIES или SELECT_SELF.

Пример условия задержки:

- type: COOLDOWN
  seconds: 5

Пример добычи блоков кубом 3×3:

BLOCK_BREAK:
  actions:
    - type: BREAK_PATTERN
      radius: 1
      shape: CUBE

Ошибки в конфиге выводятся в консоль: если предмет не срабатывает, стоит проверить предупреждения и названия параметров. Дополнительный урон складывается с ванильным уроном.

Требования

Работает на серверах Paper и Purpur.