ExecutableItems

Что такое ExecutableItems?

В ванильном Майнкрафте предметы быстро приедаются. Мечи, кирки, броня - всё это просто статы. Если вы хотите сделать нормальный RPG или MMO сервер, вам нужны "умные" вещи: мечи, которые наносят АоЕ урон, сапоги, дающие двойной прыжок, или посохи, призывающие мобов. Именно эту проблему решает плагин ExecutableItems. Он позволяет полностью кастомизировать каждый аспект предмета и вешать на них уникальные активаторы.

Плагин работает на Bukkit, Spigot, Paper, Purpur и даже Folia. Поддержка версий тут монументальная - от древней 1.8 до самых свежих 1.20.x и 1.21.x. Для работы строго требуется библиотека SCore. Без неё ничего не запустится, так что ставьте их в пару.

Настройка предметов под любые задачи

ExecutableItems предлагает безумную глубину кастомизации. Вы можете менять динамическое имя, лор, зачарования, атрибуты, зелья. Есть даже настройка тримов брони, кастомные NBT-теги и цвета кожаной брони.

Базовые настройки

• Динамическое имя и описание (Lore)
• Зачарования и атрибуты
• Эффекты зелий
• Свечение (Glow) с цветами (Premium)
• Кастомные текстуры и NBT-теги (Premium)
• Тримы брони и цвет кожаной брони
• Сохранение предмета после смерти (Soulbound)
• Кастомная прочность и неразрушимость
• Лимиты использований (всего или в день)
• Кастомные переменные
• Автообновление предметов
• Выдача при первом входе
• Блокировка в инвентаре, запрет дропа, использование только владельцем
• Скрытие флагов (эффектов, атрибутов, зачарований, баннеров)
• Ограничения взаимодействий: отмена дропа, установки, крафта, использования в печах, верстаках, сундуках и куче других блоков. Предмет нельзя будет сжечь в лаве или удалить кактусом.

Автообновление предметов

Сделали меч слишком имбовым? Хотите поменять текстуру? Встроенный автоапдейтер автоматически обновит предмет у всех игроков. Больше не нужно выдавать новые вещи вручную - все играют по одним правилам.

Триггеры и активаторы

По факту, это ядро плагина. Активаторы позволяют выполнять команды или эффекты при определенных действиях игрока. В бесплатной версии доступно более 20 триггеров, а в Premium - более 100. С их помощью вы можете сделать предмет по-настоящему живым.

Список триггеров (бесплатные выделены жирным)

• PLAYER_ALL_CLICK: При ЛКМ или ПКМ по предмету.
• PLAYER_BEFORE_DEATH: Спасает игрока от смерти и активируется.
• PLAYER_CHANGE_WORLD: При переходе между мирами.
• PLAYER_CLICK_ON_PLAYER: При клике по другому игроку.
• PLAYER_CONSUME: При поедании предмета.
• PLAYER_CUSTOM_LAUNCH: При запуске снаряда командами LAUNCH, LOCATEDLAUNCH и LAUNCHENTITY.
• PLAYER_DEATH: При смерти игрока.
• PLAYER_DISCONNECTION: При выходе с сервера.
• PLAYER_DISMOUNT: При спешивании с моба.
• PLAYER_DROP_ITEM: При выбрасывании предмета.
• PLAYER_HIT_PLAYER: При ударе по игроку.
• PLAYER_LAUNCH_PROJECTILE: При стрельбе из лука или броске.
• PLAYER_LEFT_CLICK: При ЛКМ.
• PLAYER_PORTAL: При использовании портала.
• PLAYER_RIGHT_CLICK: При ПКМ.
• PROJECTILE_HIT_PLAYER: Когда снаряд попадает по игроку.
• PLAYER_ENABLE_FLY: При включении/выключении полета.
• PLAYER_ENABLE_SNEAK: При начале приседания.
• PLAYER_ENABLE_SPRINT: При начале бега.
• PLAYER_BED_ENTER: При клике по кровати.
• PLAYER_BED_LEAVE: При выходе из кровати.
• PLAYER_BLOCK_BREAK: При ломании блока.
• PLAYER_BLOCK_PLACE: При установке блока.
• PLAYER_CLICK_ON_ENTITY: При клике по сущности.
• PLAYER_CONNECTION: При входе на сервер.
• PLAYER_DESACTIVE_SNEAK: При прекращении приседания.
• PLAYER_DESACTIVE_SPRINT: При прекращении бега.
• PLAYER_DESELECT_THE_EI: При снятии предмета с хотбара.
• PLAYER_DROP_THE_EI: При выбрасывании кастомного предмета.
• PLAYER_EDIT_BOOK: При редактировании книги.
• PLAYER_EI_BREAK: При поломке кастомного предмета.
• PLAYER_EQUIP_THE_EI: При надевании брони.
• PLAYER_ENTER_IN_HIS_PLOT: При входе на свой регион (PlotSquared).
• PLAYER_ENTER_IN_HIS_LAND: При входе на свою землю (Lands).
• EI_ENTER_IN_THE_PLAYER_INVENTORY: При попадании предмета в инвентарь.
• PLAYER_FERTILIZE_BLOCK: При удобрении костной мукой.
• PLAYER_FILL_BUCKET: При наборе воды/лавы в ведро.
• PLAYER_FISH_BLOCK: При рыбалке на блоке.
• PLAYER_FISH_ENTITY: При поимке сущности.
• PLAYER_FISH_FISH: При поимке рыбы.
• PLAYER_FISH_NOTHING: При пустой рыбалке.
• PLAYER_FISH_PLAYER: При поимке игрока.
• PLAYER_HIT_ENTITY: При ударе по сущности.
• PLAYER_ITEM_BREAK: При поломке предмета по прочности.
• PLAYER_JUMP: При прыжке.
• PLAYER_KILL_ENTITY: При убийстве сущности.
• PLAYER_KILL_PLAYER: При убийстве игрока.
• PLAYER_LEAVE_HIS_PLOT: При выходе из региона PlotSquared.
• PLAYER_LEAVE_HIS_LAND: При выходе из земли Lands.
• EI_LEAVE_THE_PLAYER_INVENTORY: При выходе предмета из инвентаря (нужен ProtocolLib).
• PLAYER_PICKUP_THE_EI: При поднятии кастомного предмета.
• PLAYER_REGAIN_HEALTH: При восстановлении здоровья.
• PLAYER_RIPTIDE: При использовании трезубца с потоком.
• PLAYER_SPAWN_CHANGE: При смене точки спавна.
• PLAYER_WALK: При ходьбе.
• PLAYER_WRITE_COMMAND: При вводе команды.
• PLAYER_RECEIVE_HIT_BY_ENTITY: При получении урона от сущности.
• PLAYER_RECEIVE_HIT_BY_PLAYER: При получении урона от игрока.
• PLAYER_RECEIVE_HIT_GLOBAL: При любом получении урона.
• PLAYER_RESPAWN: При респавне.
• PLAYER_SHEAR_ENTITY: при стрижке сущности.
• PLAYER_SELECT_THE_EI: При выборе предмета на хотбаре.
• PLAYER_TARGETED_BY_AN_ENTITY: Когда сущность берет вас в таргет.
• PLAYER_TRAMPLE_CROP: При вытаптывании культур.
• PLAYER_UNEQUIP_THE_EI: При снятии брони.
• PROJECTILE_ENTER_LIQUID: При попадании снаряда в воду.
• PROJECTILE_HIT_BLOCK: При попадании снаряда в блок.
• PROJECTILE_HIT_ENTITY: При попадании снаряда в сущность.
• INVENTORY_CLICK: При клике по предмету в инвентаре.
• LOOP: Активируется циклически, пока предмет в инвентаре.

Условия и команды

Через библиотеку SCore вы получаете более 100 кастомных условий и команд. Хотите, чтобы урон меча зависел от количества маны? Легко. Нужны требования по деньгам, опыту или предметам? Всё уже встроено. Плагин поддерживает плейсхолдеры из других плагинов, так что интеграция с экономикой или скиллами будет бесшовной.

Кулдауны (перезарядка)

Ни одна RPG не выживет без кулдаунов. В ExecutableItems можно настроить:

• Время в секундах или тиках
• Кастомные сообщения о перезарядке
• Паузу кулдауна при выходе игрока
• Паузу в зависимости от плейсхолдеров
• Глобальные кулдауны для всех игроков (чтобы не абузили толпой)

Возможности и примеры

Плагин позволяет реализовать практически любую механику. Вот лишь малая часть того, что уже сделали другие админы (включает примеры из Premium):

• Trench Tools, которые работают с учетом защищенных регионов
• Кирки с вейнмайнером (Veinminer)
• Огнестрельное оружие с кулдауном
• Губки для воды и лавы
• Крюки-кошки (Grappling Hooks)
• Взрывные луки
• Бесконечные блоки
• Бесконечная вода и лава
• Инструменты-морфы
• Мечи с АоЕ уроном и эффектами
• Радужный шлем
• Косметические частицы
• Автоматический динамит (TNT)
• Конвертер предметов
• Кастомный тотем бессмертия
• Сеты брони с бонусами от 1 до 4 предметов
• Модификаторы луков, которые делают крутые вещи при попадании в цель
• Предмет возврата (Recall), который телепортирует вас к месту смерти
• Комбо-клики, где нужно нажать ЛКМ+ЛКМ+ПКМ для активации
• Автокрафтер / Автокомпактор
• Вайтлист/блэклист блоков, которые может ломать кастомная кирка
• Арбалеты, не требующие перезарядки для стрельбы
• Предметы, требующие топливо
• Дождь из снарядов
• Броня, помогающая уворачиваться от ударов врагов
• Предметы, которые нужно зарядить для активации атакующего скилла
• Предметы, стреляющие стрелами, отталкивающими игроков и мобов
• Элитры с частицами во время полета
• Инструмент для расстановки блоков, помогающий строителям ставить больше одного блока за раз
• Кастомные условия появления частиц, если вы не попали по цели какое-то время
• Предметы, позволяющие наносить урон в падении, прорываться сквозь врагов и наносить урон
• Предметы с 5 способностями одновременно
• Прыжок в воздухе, двойной прыжок, тройной прыжок и более
• Портативный маяк, где можно менять основные и вторичные баффы
• Назначение таблички для отображения ваших координат в реальном времени
• Притягивание мобов к себе
• Предметы для телепортации вперед или назад
• Предметы, помогающие пересаживать культуры, которые вы сломали
• Предметы, увеличивающие урон в зависимости от того, сколько:
  • раз вы нанесли урон цели
  • раз вы получили урон
  • врагов в заданном радиусе
• Предметы, которые при броске на землю снимают все эффекты с ближайших игроков
• Костная мука, моментально растящая культуры
• Предметы, обнаруживающие движение игрока
• Предметы, автоматически плавящие блоки при разрушении (с настройкой, какие блоки плавить)
• Предметы, наносящие урон или эффекты атакующим
• Предметы, наносящие урон со временем (DoT)
• Предметы, которые при броске разрушают область блоков (с настройкой, какие блоки ломать)
• Предметы, притягивающие мобов в точку и отталкивающие их в направлении
• Предметы для прыжка с нанесением АоЕ урона при приземлении
• Предметы для рывка сквозь цели
• Предметы с двумя формами атаки и переключением между ними
• Предметы, останавливающие движение снарядов во время приседания
• Предметы, подбрасывающие врагов вверх и наносящие урон в воздухе при рывке
• Предметы, сохраняющие координаты и бьющие молнией в этом месте
• Предметы, превращающие область из одного блока в другой
• Снаряды, наносящие АоЕ урон и оставляющие эффект
• Сапоги, создающие радужные частицы
• Кастомные удочки с бонусным лутом
• Жезлы, призывающие летучих мышей и собирающие их для ХП
• Интеграция с MMOItems и другими плагинами на предметы
• Снаряды, отталкивающие или притягивающие мобов к точке падения
• Оружие с отдачей
• Снаряды с разными типами пуль и эффектами
• Предметы для прохождения сквозь блоки
• Предметы, временно превращающие область в блоки с возвратом к оригиналу
• Инструменты, считающие сломанные блоки
• Мечи, считающие убитых мобов
• Оружие, увеличивающее урон за каждые 5 убийств
• Сапоги, предотвращающие урон (например, "Сапоги без урона от падения")
• Предметы с разным поведением в зависимости от биома
• Оружие, призывающее трезубцы с неба, летящие к вам и взрывающиеся
• Щиты, блокирующие урон (и не дающие наносить свой)
• Зелья, снимающие эффекты в области при броске
• Оружие, чей урон зависит от дистанции до цели

Совместимость с другими плагинами

ExecutableItems отлично дружит с другими популярными проектами:

• Хостинг и регионы: WorldGuard, Lands, IridiumSkyblock, SuperiorSkyblock2, GriefPrevention, GriefDefender, Residence, PlotSquared, Towny, Terra. В последних обновлениях разработчики специально починили проблемы с WorldGuard, импортом NBT и автоимпортом свечения (glow), так что защита регионов работает корректно.
• Мана и скиллы: Aurelium Skills, EcoSkills, MMOCore
• Предметы: Oraxen, ItemsAdder, HeadDB, Head Database
• Зачарования: AdvancedEnchantments, Enchants Squared, ExcellentEnchants, Eco Enchants
• Дроп: MythicMobs, LevelledMobs, RoseLoots, Wildstacker
• Магазины: ShopGui+, ShopKeepers, Tradesplus

Как запустить сервер с ExecutableItems

Если вы хотите поиграть с друзьями в RPG-выживание или сделать полноценный сервер, плагин легко запустится на Bungee.Host. Это идеальный хостинг серверов Майнкрафт, где вы можете арендовать сервер Minecraft в один клик. Сборка с кастомными предметами и скиллами - это то, что заставит игроков залипнуть на часы. Создать сервер Minecraft с такими механиками проще простого.

Совет: Перед запуском обязательно проверьте конфиги на версии 1.21.x. Плагин поддерживает старые версии вплоть до 1.8, но новые фичи вроде тримов брони работают только на свежих релизах. Если что-то не работает - проверьте, обновили ли вы SCore, без него активаторы могут молчать.

Скачайте плагин ExecutableItems и превратите свой сервер в настоящую RPG-вселенную с уникальным оружием и магией!