Плагин для серверов Майнкрафт на Paper, который позволяет создавать собственные предметы с эффектами, крафтами, добычей и условиями использования. Предметы настраиваются через меню-сундук в игре или YAML-файлы; игроки могут находить их в обычном мире и видеть рецепты в ванильной книге рецептов.
Возможности
- Предмет состоит из базового материала, названия, описания и способностей. Способность собирается из активатора, условий, цели и действий: например, срабатывает при ударе, проверяет здоровье игрока и отравляет цель.
- Доступны эффекты урона, зелий, отбрасывания, притягивания, поджога, заморозки, телепортации, рывка, лечения за урон, разрушения области или жилы руды, автоплавки, призыва мобов, выдачи предметов и работы с экономикой.
- Способности можно запускать при клике, ударе, убийстве, смерти, разрушении или установке блока, использовании еды, приседании, выбрасывании и поднятии предмета, стрельбе, экипировке и удерживании предмета.
- Для сложных эффектов есть задержки, повторы, проверки условий, случайные ветки и досрочная остановка цепочки.
- Использование способностей ограничивается правами, миром или регионом, деньгами, опытом, предметами, голодом, зарядами, собственной прочностью и общими либо отдельными перезарядками.
- Предметы можно получать через фигурные и бесформенные крафты, печь, доменную печь, коптильню, костёр, кузнечный стол и камнерез. Также поддерживаются выпадения с мобов и блоков, а также добавление в добычу сундуков, мобов и рыбалки.
- В игровом каталоге игрок может искать предметы, узнавать способы получения и добавлять известные рецепты в книгу рецептов.
- Администраторский редактор позволяет менять материал, идентификатор, название, описание, рецепты, выпадения, добычу и дерево способностей. Есть шаблоны оружия, инструмента, брони, расходуемого и носимого предмета.
Команды
Основная команда — /itemsmith; также доступны /ismith и /citems.
/itemsmith catalog— открыть каталог предметов./itemsmith open— открыть редактор предметов./itemsmith create— начать создание предмета./itemsmith get <id>— выдать предмет себе./itemsmith give <id> [player]— выдать предмет игроку./itemsmith list— показать список созданных предметов./itemsmith reload— перечитать файлы предметов.
Права
itemsmith.admin— редактор и административные команды; по умолчанию для операторов.itemsmith.catalog— доступ к каталогу; выдано всем по умолчанию.itemsmith.bypass.all— обход всех ограничений способностей.itemsmith.bypass.cost— обход стоимости использования.itemsmith.bypass.cooldown— обход перезарядок.itemsmith.bypass.region— обход ограничений регионов.
Настройка
Файлы предметов хранятся в plugins/ItemSmith/items/. Редактор в игре и ручное редактирование YAML используют одни и те же файлы, поэтому предметы можно переносить между серверами.
Для собственных текстур и моделей укажите item-model: или custom-model-data: у предмета и подключите свой ресурс-пак. Без ресурс-пака предмет выглядит как его базовый материал.
Требования
Нужен сервер Paper и Java 21 или новее; Spigot не поддерживается. Vault нужен для денежных затрат, WorldGuard — для ограничений по регионам, GriefPrevention — для защиты. Игрокам не требуется устанавливать моды или ресурс-пак, если не используются свои текстуры; для ввода текста и чисел в редакторе нужен клиент с поддержкой Dialog API.
