ForgeEngine (Форженджин)

Плагин для серверов Майнкрафт на Spigot и Paper, который добавляет настраиваемые станции крафта с отдельными меню и рецептами. Администратор создаёт станции, рецепты, условия и награды в YAML-файлах без написания кода.

Возможности

• Каждая станция имеет своё меню, оформление, звуки, рецепты, очередь крафта и право на открытие.
• Рецепт может выдавать несколько предметов с отдельным шансом выпадения: например, гарантированный основной предмет и редкий бонус.
• Ингредиенты можно пометить !nc: предмет должен быть в инвентаре, но не расходуется. Это удобно для инструментов и станков.
• Для рецепта задаются время изготовления, задержка перед повторным крафтом, место в меню, свечение значка и закрытие меню после крафта.
• Условия крафта включают уровень, класс, права, значения PlaceholderAPI, сытость, ману, выносливость и деньги. Ресурсы списываются только после успешной проверки всех условий.
• После крафта можно отправить сообщение, показать текст над панелью быстрого доступа или заголовок, выполнить команду, воспроизвести звук, создать частицы, выдать опыт, деньги, бонусный предмет или использовать возможности MythicMobs.
• Длительные крафты попадают в персональную очередь игрока. Прогресс, потраченные ресурсы и готовые предметы сохраняются при перезапуске сервера; незавершённый крафт можно отменить с возвратом ингредиентов.
• Правый клик по рецепту открывает предпросмотр с результатом, ингредиентами, условиями и кнопкой подтверждения.
• Поддерживаются ванильные предметы, MythicMobs, Oraxen, Nexo и ItemsAdder. Другие плагины могут добавлять собственные источники предметов через Java API.

Команды

Для отдельной станции можно включить собственную команду в её YAML-файле:

command:
  enabled: true
  name: forge
  description: Открыть станцию
  permission: forgeengine.station.forge
  aliases:
    - кузница

Команда открывает настроенную станцию; имя, описание, право и псевдонимы задаются в параметрах command.name, command.description, command.permission и command.aliases.

Права

Доступ к станции включается параметром permission.enabled. По умолчанию используется право вида forgeengine.station.<id>, где <id> — имя файла станции без .yml.

В рецептах можно дополнительно проверять права игроков через условие:

permission{list="forge.advanced"}

Настройка

Файлы станций размещаются в папке stations/; каждый файл .yml создаёт отдельную станцию, а имя файла становится её внутренним идентификатором. В папке можно использовать вложенные каталоги для порядка.

Рецепты описываются в разделе recipes:. Ингредиенты и результаты записываются в формате provider{key=value}, например:

output: 'vanilla{type=IRON_PICKAXE,amount=1}'
ingredients:
  - 'vanilla{type=IRON_INGOT,amount=3}'
  - 'vanilla{type=SMITHING_TABLE,amount=1}!nc'

У рецепта можно настроить crafting-time, cooldown, conditions, triggers и параметры из раздела options. В общем конфиге доступны размер очереди, автоматический сбор готовых предметов, срок хранения невостребованных результатов, обработка очереди в фоне, подключение экономики и PlaceholderAPI.

Для базы данных поддерживаются SQLite и MySQL. Параметры MySQL: host, port, database, username, password, useSSL и pool-size.

Требования

Плагин работает на серверах Spigot и Paper с Bukkit API.

• Vault нужен для экономики с провайдером vault.
• Для валют GemsEconomy и CoinsEngine используются провайдеры gemseconomy и coinsengine.
• MMOCore добавляет условия и расход уровня, класса, маны и выносливости.
• PlaceholderAPI позволяет проверять произвольные плейсхолдеры и используется как запасной источник уровня и класса.
• MythicMobs, Oraxen, Nexo и ItemsAdder подключаются для работы с их предметами и возможностями MythicMobs.

Интеграции включаются в конфиге только при наличии соответствующих плагинов.