Справочник BreweryX — формат рецептов и все поля YAML

Каждый рецепт BreweryX — это YAML-запись, где ключом является уникальный ID рецепта (например my_beer или thunder_whiskey). Внутри записи находятся все параметры напитка: название, описание, ингредиенты, время варки и опциональные поля.

Ниже приведён минимальный пример рецепта с основными полями:

my_beer:
  name: '&6Craft Beer'
  lore:
    - 'Tasty beer'
    - 'Refreshing'
  ingredients:
    - WHEAT/6
    - WATER_BUCKET/1
  cookingtime: 5
  color: WHITE
  difficulty: 6

recipe_id

Уникальный строковый идентификатор рецепта (например my_beer). Используется как ключ в recipes.yml и для ссылок на рецепт в командах.

name

Отображаемое название напитка с кодами цвета (например &6Craft Beer). Поддерживает коды &, именованные цвета и HEX.

ingredients

Список ингредиентов в формате МАТЕРИАЛ/КОЛИЧЕСТВО. Минимум один ингредиент. Пример: WHEAT/6, WATER_BUCKET/1.

cookingtime

Время варки в минутах. Значение от 0 (мгновенно) до 1000. Определяет, как долго игрок должен стоять у котла.

difficulty

Сложность варки от 1 до 10. Чем выше значение, тем точнее должен быть игрок, чтобы получить качественный напиток.

Ингредиенты задаются списком строк в формате МАТЕРИАЛ/КОЛИЧЕСТВО. Поддерживаются любые ванильные предметы Minecraft. Примеры:

WHEAT/6

6 единиц пшеницы — классический ингредиент для пива.

WATER_BUCKET/1

1 ведро воды — обязательно для большинства напитков.

SUGAR/2

2 единицы сахара — делает напиток слаще, добавляется в медовуху и виски.

HONEY_BOTTLE/1

1 бутылка мёда — основной ингредиент для медовухи.

NETHER_WART/1

1 адский нарост — для зельевидных напитков.

cookingtime

Время варки в минутах. Значение от 0 до 1000. При значении 0 напиток варится мгновенно при добавлении всех ингредиентов. Рекомендуемые значения: 3–15 минут для пива, 10–30 для крепких напитков.

difficulty

Сложность от 1 до 10. Определяет, насколько точно игрок должен попасть в целевой интервал времени. При difficulty 1 почти любое время даст хороший результат, при difficulty 10 нужно попасть с точностью до минуты.

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

Поля:

distillruns

Количество перегонок (от 1 до 10). Каждая перегонка повышает крепость напитка. Для виски обычно 2–3 перегонки.

distilltime

Время одной перегонки в секундах (от 1 до 3600). Рекомендуемые значения: 60–300 секунд. При слишком коротком времени напиток может не перегнаться.

BreweryX поддерживает выдержку напитков в бочках из разных пород дерева. Каждый тип бочки влияет на вкус и свойства напитка. Выдержка длится указанное количество дней (в игровых днях).

Типы бочек (wood):

0

Любая бочка (Any wood) — автоматически подбирает доступную бочку.

1

Берёзовая бочка (Birch) — лёгкий привкус, подходит для лёгких напитков.

2

Дубовая бочка (Oak) — классический выбор для большинства напитков.

3

Бочка из тропического дерева (Jungle) — тропический аромат для медовухи и фруктовых напитков.

4

Еловая бочка (Spruce) — тёмный, насыщенный вкус, отлично подходит для виски.

5

Акациевая бочка (Acacia) — экзотический привкус для необычных напитков.

6

Тёмно-дубовая бочка (Dark Oak) — интенсивный вкус дуба.

7

Бочка из красного дерева Кримсона (Crimson) — насыщенный грибной аромат.

8

Бочка из дерев Варпа (Warped) — морской оттенок вкуса.

9

Бочка из мангрового дерева (Mangrove) — необычный вкус для экспериментов.

10

Бочка из вишнёвого дерева (Cherry) — сладкий фруктовый аромат.

11

Бочка из бамбука (Bamboo) — лёгкий тропический привкус.

12

Бочка из медной пластины (Cut Copper) — металлический привкус для экспериментов.

Цвет напитка определяет его отображение в инвентаре и в руке игрока. BreweryX поддерживает как стандартные именованные цвета Minecraft, так и HEX-цвета для версий 1.16+.

Именованные цвета:

WHITE

Белый — для светлых напитков и молочных коктейлей.

BRIGHT_GREY

Светло-серый — для прозрачных напитков.

GREY

Серый — для тёмных напитков с углём.

BLACK

Чёрный — для портеров и stout.

DARK_RED

Тёмно-красный — для тёмных крепких напитков.

RED

Красный — для крепких и острых напитков.

BRIGHT_RED

Ярко-красный — для огненных напитков.

ORANGE

Оранжевый — для цитрусовых напитков и виски.

YELLOW

Жёлтый — для пива и медовухи.

GREEN

Зелёный — для травяных напитков.

LIME

Лаймовый — для зелёных напитков.

OLIVE

Оливковый — для крепких травяных настоек.

TEAL

Бирюзовый — для морских напитков.

CYAN

Циановый — для ледяных напитков.

BLUE

Синий — для ледяных и водных напитков.

WATER

Водный — прозрачный голубой для лёгких напитков.

PURPLE

Фиолетовый — для магических зелий.

PINK

Розовый — для цветочных напитков.

Эффекты — это стандартные эффекты зелий Minecraft, которые применяются при употреблении напитка. Формат: ЭФФЕКТ/УРОВЕНЬ/ДЛИТЕЛЬНОСТЬ (в секундах).

Можно задать несколько эффектов, а также диапазоны для системы качества (плохое/среднее/хорошее). Примеры:

effects:
  - SPEED/1/60
  - NAUSEA/1/30

# With quality ranges:
effects:
  - SPEED/1-3/10-60
  - REGENERATION/1-2/5-30

alcohol

Крепость напитка в процентах (0–100). Влияет на уровень опьянения игрока. При 0% напиток не вызывает опьянения. Рекомендуемые значения: 5–15% для пива, 20–40% для крепких напитков.

glint

Свечение предмета (true/false). Если true, напиток будет мерцать как зачарованный предмет. Подходит для магических зелий и редких напитков.

BreweryX позволяет настраивать отображаемое название (name), описание (lore) и надписи (displayname) для каждого уровня качества. Формат: три значения, разделённые слешем — плохое/среднее/хорошее.

Доступные поля:

name

Название напитка. Можно задать одно для всех качеств или три через слеш: '&4Плохое/&6Нормальное/&aХорошее'.

lore

Описание напитка (список строк). Префиксы качества: '+' — при плохом качестве, '++' — при среднем, '+++' — при хорошем. Без префикса строка отображается всегда.

displayname

Отображаемое имя в инвентаре. Перекрывает name для более точной настройки.

При употреблении напитка можно выполнить серверные или игрокские команды. Команды выполняются от имени сервера или игрока соответственно.

Доступные поля:

servercommands

Список команд, выполняемых сервером при употреблении. Формат: 'команда'. Пример: 'give %player% diamond 1'.

playercommands

Список команд, выполняемых игроком при употреблении. Формат: 'команда'. Пример: 'me выпил крепкого напитка'.

drinkmessage

Сообщение, отправляемое игроку при употреблении. Поддерживает цветовые коды.

Поле customModelData позволяет задать пользовательскую модель для предмета, если установлены ресурспаки. Используется с плагинами вроде ItemsAdder для отображения кастомных текстур.

Формат: одно значение (для всех качеств) или три через слеш для разных качеств: '1000/1001/1002'.

BreweryX поддерживает три уровня качества: плохое (poor), среднее (medium) и хорошее (good). Качество определяется точностью варки: если игрок снял напиток с котла слишком рано или слишком поздно — качество будет хуже.

Для каждого уровня можно задать уникальные: название, описание, эффекты, CustomModelData и надписи. Формат — три значения через слеш: 'плохое/среднее/хорошее'. Пример:

name: '&4Bad Beer/&6Normal Beer/&aGood Beer'
lore:
  - '+Lukewarm beer'
  - '++Pleasant taste'
  - '+++Excellent ale'
customModelData: 1000/1001/1002
effects:
  - SPEED/1-3/10-60
  - REGENERATION/1-2/5-30

Ниже приведён полный рецепт виски с дистилляцией, выдержкой в бочке, эффектами и крепостью. Этот пример демонстрирует все основные поля:

thunder_whiskey:
  name: '&8Thunder Whiskey'
  lore:
    - 'Strong aged whiskey'
    - 'Made in oak barrels'
  ingredients:
    - WHEAT/10
    - WATER_BUCKET/2
    - SUGAR/4
  effects:
    - SPEED/1/60
    - NAUSEA/1/30
  cookingtime: 10
  distillruns: 2
  distilltime: 120
  wood: 2
  age: 5
  color: ORANGE
  difficulty: 7
  alcohol: 30