Patchouli: установка, книги и решение проблем

Что такое Patchouli

Patchouli — библиотека интерактивных книг внутри Minecraft. Другие моды и авторы сборок используют её для руководств, рецептов, схем и прогрессии. Сама библиотека не обязана добавлять готовую книгу игроку: контент предоставляет зависимый мод или datapack. Поэтому установленный Patchouli без сторонней книги может выглядеть как «ничего не произошло». Его ценность проявляется в документации конкретной сборки.

Установите совместимую версию

Выберите официальный релиз под точную версию Minecraft и загрузчик. Для новых веток состав поддерживаемых загрузчиков отличается от старых, поэтому не переносите jar по памяти. Установите Patchouli на стороны, которые требует модпак или зависимый мод. Не берите snapshot для обычного прохождения: официальный репозиторий предупреждает, что промежуточные сборки могут ломаться и удаляться. Начинайте со стабильного release-файла.

Где взять книгу

Книга может выдаваться при первом входе, создаваться рецептом, выпадать за достижение или появляться как отдельный предмет мода. Откройте JEI/REI и найдите название руководства, а не только слово Patchouli. Если рецепта нет, прочитайте страницу зависимого проекта: сборщик мог привязать книгу к квесту. Команда выдачи полезна лишь в тестовом мире; на сервере она может обойти задуманный этап прогрессии.

Как открыть и читать

Возьмите книгу и используйте её. Главный экран обычно содержит категории, записи и поиск, а страницы — текст, изображения, рецепты или схемы. Используйте кнопку назад внутри интерфейса, чтобы не закрывать книгу после каждой темы. Ссылки между записями помогают пройти цепочку понятий. Если термин непонятен, найдите его через индекс. Patchouli показывает то, что написал автор книги, поэтому полнота зависит от конкретного мода.

Почему главы заблокированы

Автор книги может связать записи с advancements или другими условиями. Заблокированная глава не означает повреждённый файл. Проверьте подсказку, квесты и достижения. На сервере прогресс хранится отдельно для игрока. Не копируйте чужие advancement-данные без резервной копии. Если условие выполнено, но глава не открылась, перезайдите и приложите ID достижения и книги к отчёту автора контента.

Рецепты внутри книги

Страница рецепта отражает данные, которые связал автор книги. Модпак может изменить рецепт через datapack или скрипты, а книга остаться старой. Сравнивайте с JEI/REI и фактической сеткой крафта. Если значения расходятся, сообщайте сборщику модпака, указав страницу и текущий рецепт. Patchouli отображает документацию и не всегда является источником самого рецепта. Не удаляйте библиотеку ради исправления одной устаревшей страницы.

Мультблоки и визуальные схемы

Некоторые книги показывают послойные конструкции и позволяют визуализировать их в мире. Освободите площадку, выберите правильную ориентацию и сверяйте каждый слой. Голограмма помогает собрать форму, но не заменяет требования к активирующим предметам, направлению портов и внутренним блокам. Если схема обрезана, проверьте масштаб интерфейса, ресурс-паки и версию книги. Сделайте снимок конкретного слоя для отчёта.

Книга пустая или без текста

Сначала проверьте язык клиента: перевод зависимого мода может быть неполным. Затем убедитесь, что ресурс-пак книги включён и версия контента соответствует Patchouli. Пустые категории часто возникают из-за ошибки datapack или несовместимой ветки. Повторите с английским языком и без пользовательских ресурсов. Если текст появился, проблема относится к локализации, а не к сохранению мира.

Patchouli как зависимость

Сообщение «Patchouli is missing» означает, что другой мод ожидает библиотеку. Скачайте версию, указанную в зависимостях этого проекта, а не просто самый новый файл. Если подходящего релиза для вашей версии нет, не подставляйте сборку соседней ветки. Обновите связанный модпак целиком или выберите совместимую версию. Один неправильный jar способен остановить загрузку до главного меню.

Для авторов сборок

Автор может создать собственную книгу данными, разбить её на категории и записи, добавить рецепты, изображения и условия открытия. Храните исходники в системе контроля версий и проверяйте ссылки автоматическим поиском. Не копируйте чужие тексты и изображения без разрешения. Сначала сделайте короткий рабочий прототип, затем добавляйте главы. Тестируйте книгу на чистом клиенте и на сервере с обычными правами игрока.

Диагностика

Укажите Minecraft, загрузчик, версию Patchouli, мод-владелец книги, ID предмета и язык. Приложите latest.log и снимок пустой или ошибочной страницы. Для падения при открытии сохраните полный stack trace. Проверьте чистый профиль с Patchouli и зависимым модом. Если ошибка относится к JSON конкретной книге, сначала сообщите её автору; репозиторий Patchouli нужен для воспроизводимой проблемы самой библиотеки.

Быстрая проверка перед началом

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

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