Custom Recipes

Custom Recipes - плагин для серверов Minecraft Java, с которым можно создавать свои рецепты и менять ванильные через внутриигровой интерфейс. Он решает практичную задачу: администратору не нужно вручную разбирать конфиги, чтобы изменить крафт, добавить особый предмет или ограничить доступ к рецепту.

Плагин подходит для серверов с собственным прогрессом, экономикой или правилами выживания. Например, можно заменить стандартный рецепт, добавить плавку с особыми условиями или сделать результат крафта случайным. Рецепты и настройки редактируются в GUI, а игроки могут просматривать доступные им рецепты через меню.

Крафт и рецепты печи

Custom Recipes работает с верстаком и печью. Для верстака доступны рецепты с заданным расположением ингредиентов и shapeless-рецепты, где порядок предметов в сетке не важен. Один рецепт может принимать несколько вариантов ингредиентов, например разные виды дерева.

Можно настраивать как собственные, так и ванильные рецепты Minecraft. Для существующих рецептов доступны поиск, фильтрация по категориям, включение и отключение, а также сброс к исходному варианту. Заявлена настройка всех 801 ванильного рецепта.

Для рецептов печи настраиваются результат, время плавки и топливо. Также можно задать требования к правам, уровню опыта, деньгам, задержке между использованиями и общему числу применений. За успешную плавку плагин может выдавать опыт.

Результаты и события

Рецепт может выдавать несколько возможных результатов с весовыми шансами. Для случайного результата доступно до 27 вариантов; отдельно задаётся вероятность полного провала, при котором предмет не выдаётся.

При создании или плавке предмета можно запускать события:

• воспроизводить звук с заданной громкостью и высотой тона;
• создавать частицы с настраиваемыми параметрами;
• выполнять команды от имени консоли с поддержкой плейсхолдеров.

Наборы событий можно сохранять и повторно применять к другим рецептам. Интеграция с Vault позволяет учитывать экономику сервера, например назначать денежную стоимость рецепта.

Настройка предметов и доступ

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

Рецепты можно включать или отключать в отдельных мирах, в том числе в Верхнем мире, Незере и Крае. Скрытые рецепты не показываются в поддерживаемых просмотрщиках рецептов, пока игрок их не откроет. Для работы с крупным списком предусмотрены поиск, просмотр шаблона крафта и автоматическая разбивка по страницам. Изменения рецептов можно перезагрузить без рестарта сервера.

Интерфейс переведён на английский, русский, украинский и немецкий языки. Игрок может выбрать язык отдельно; если для текста нет перевода, используется английский. Для цветного текста поддерживается формат MiniMessage, включая именованные и HEX-цвета, градиенты и форматирование.

Команды и права

Основные команды доступны с короткими псевдонимами /cr, /crecipes и /customrecipe.

• /customrecipes list - открыть список доступных пользовательских рецептов. Требуется customrecipes.list; для просмотра всех рецептов нужно customrecipes.list.all.
• /customrecipes help - открыть справку для администраторов.
• /customrecipes reload - перезагрузить настройки. Право: customrecipes.reload.
• /customrecipes gui - открыть панель управления. Право: customrecipes.gui.

Право customrecipes.manage позволяет создавать, редактировать и удалять рецепты. customrecipes.update.notify включает уведомления об обновлениях при входе. customrecipes.* даёт все права и по умолчанию предназначено для операторов сервера. Права на управление и перезагрузку также по умолчанию доступны операторам.

Установка и совместимость

Поместите файл плагина в папку plugins сервера и запустите сервер, чтобы создать стандартную конфигурацию. После этого интерфейс администрирования открывается командой /customrecipes gui или /cr gui.

Поддерживаются Minecraft Java 1.18.2-1.21.10 и серверы Bukkit, Folia, Paper, Purpur и Spigot, включая совместимые форки. Требуется Java 17 или новее. Игрокам не нужно устанавливать клиентский мод: Custom Recipes работает как серверный плагин.

В интерфейсе уже есть редакторы верстака и печи. Рецепты для плавильной печи, коптильни, костра, зельеварения и кузнечного стола перечислены как запланированные возможности, а не как текущая функциональность.