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