Что такое шаблон Patchouli для взаимодействия с блоками
Когда вы собираете собственный модпак, рано или поздно встаёт вопрос документации. Игроки должны понимать, как работают изменённые рецепты, уникальные механики и особые взаимодействия. Мод Patchouli давно стал стандартом для создания внутриигровых руководств, а шаблон Block Interaction — это готовый инструмент, который упрощает описание любых действий с блоками. Сам по себе этот шаблон не добавляет в игру ни одного нового предмета или механики. Он предназначен исключительно для авторов сборок, которые используют CraftTweaker, KubeJS, GroovyScript или Scavenge, чтобы превратить обычный клик по блоку в нечто большее.
Установка и первые шаги
Шаблон поставляется в виде обычного zip-архива. Чтобы начать работу, достаточно распаковать его прямо в корневую папку установки Minecraft. После этого появится директория patchouli_books\ThanasiShadoW's Patchouli Templates\en_us\templates. Внутри вы найдёте несколько json-файлов — это и есть заготовки страниц. Их нужно скопировать в папку templates вашей собственной книги Patchouli. Дальше останется только наполнить параметры реальными данными, и руководство оживёт прямо в игре.
Если вы активно экспериментируете с модами и часто пересобираете сборку, удобно держать все инструменты под рукой. Кстати, многие создатели модпаков уже оценили, что моды и шаблоны можно легко установить через лаунчер foxygame.net — удобный, гибкий и современный лаунчер для Minecraft, где можно скачать моды прямо из меню. Это сильно экономит время, когда нужно быстро развернуть тестовое окружение и проверить, как выглядят ваши кастомные взаимодействия.
Базовый шаблон: block_interaction_basic
Первый и самый часто используемый тип страницы — block_interaction_basic. Он описывает простое взаимодействие: игрок кликает по блоку, держа определённые предметы в руках, и что-то происходит. Все параметры обязательны к заполнению, иначе страница просто не отобразится корректно.
Обязательные поля
- main_hand — предмет в основной руке (может быть пустым, если не требуется).
- off_hand — предмет во второй руке (аналогично).
- block — блок, с которым происходит взаимодействие.
- click_type — тип клика: строго
"left"или"right". Оставлять это поле пустым нельзя. - mainhand_result, offhand_result, block_result — иконки, показывающие судьбу каждого элемента после взаимодействия.
- notes — текстовое поле для дополнительных условий или побочных эффектов.
Варианты результатов
Параметры mainhand_result, offhand_result и block_result принимают одно из пяти значений, и каждое отображается особой иконкой рядом с предметом:
- keep — предмет остаётся без изменений (нет иконки).
- consume — предмет тратится (восклицательный знак).
- unknown — результат не определён (знак вопроса).
- percent — есть шанс потери или изменения (знак процента).
- damage — предмет получает урон (молния).
Такая визуальная система позволяет игроку мгновенно понять механику, не вчитываясь в длинные описания. Например, если вы создали рецепт, где при правом клике огнивом по наковальне расходуется уголь из второй руки, вы просто выставляете offhand_result: "consume" — и в книге сразу появится понятная подсказка.
Продвинутый шаблон: block_interaction_exhaust
Когда взаимодействие отнимает у игрока ресурсы — голод, здоровье или опыт — на помощь приходит block_interaction_exhaust. Он наследует все поля базового шаблона, но добавляет три новых параметра, которые отображаются в центре характерных иконок.
- hunger — сколько единиц сытости потратится. Отображается на фоне иконки-окорочка тёмно-коричневым жирным шрифтом (можно форматировать).
- hp — потеря здоровья. Показывается на иконке сердца тёмно-красным цветом.
- xp — расход опыта или уровней. Иконка сферы опыта и тёмно-зелёный текст.
Важно: все три поля — это строки, а не числа. Вы можете написать не только цифру, но и любой текст с форматированием, например, "2 уровня" или "5% от максимума". Это даёт огромную гибкость при создании сложных механик в духе хардкорных сборок.
Сетка дропов: block_interaction_drops
Часто одного описания результата недостаточно — нужно показать, какие именно предметы могут выпасть. Для этого существует отдельная страница block_interaction_drops, которая работает только в связке с одним из предыдущих шаблонов. Она представляет собой сетку 7 на 9 слотов, куда можно поместить до 63 предметов. Параметры называются незамысловато: drop1, drop2… drop63. Каждый из них — это ItemStack, то есть вы можете указать не только тип предмета, но и количество, повреждение, NBT-теги.
Такая детализация особенно полезна, когда вы документируете взаимодействия с рудой, сундуками или кастомными блоками, где дроп зависит от инструмента или удачи. Игрок, открыв книгу, сразу видит полную таблицу возможных наград.
Советы по оформлению и тестированию
Шаблон тестировался только на версии Minecraft 1.12.2, поэтому при использовании на более новых версиях стоит быть внимательным. Перед публикацией модпака обязательно проверьте все страницы в игре — иногда даже мелкая опечатка в названии параметра ломает отображение. Помните, что поля click_type и все _result не могут быть пустыми, иначе страница просто не загрузится. Если вы сомневаетесь в результате, используйте "unknown" — это честно скажет игроку, что механика ещё может измениться.
Заключение
Шаблон Block Interaction для Patchouli — это незаменимый помощник для любого автора модпаков, который хочет сделать сборку понятной и дружелюбной. Он превращает сухие скрипты CraftTweaker или KubeJS в наглядные страницы с иконками, подсказками и таблицами дропа. Грамотно заполненные шаблоны избавляют от бесконечных вопросов в чате и повышают погружение в игру. Не бойтесь экспериментировать с форматированием текста в полях hunger, hp и xp, комбинируйте базовый шаблон с сеткой дропов — и ваша документация станет образцовой. В конечном счёте, именно внимание к таким деталям отличает хороший модпак от великого.