Мод PatchouliButton 1.0.2+1.20.1 +1.0.2

PatchouliButton — дополнение для Fabric с единым доступом к книгам Patchouli из инвентаря. Автор сборки может направить его к конкретному руководству вместо общего перечня. Лицензия — MIT; в публичной команде указан Globox1997.

Назначение дополнения​

В сборках несколько модов могут добавлять собственные книги Patchouli. PatchouliButton предоставляет единую точку входа, чтобы игроку не приходилось искать каждый книжный предмет отдельно. Подтверждены два сценария:

• открытие общего набора книг Patchouli;
• прямой доступ к одной выбранной книге, например руководству модпака.

Мод не заменяет Patchouli и не пишет содержание руководств. Он упрощает навигацию по уже существующим книгам.

Скриншоты и внешний вид​

Аудитория и сценарии выбора​

Игроки получают справку через инвентарь, а разработчики модпаков могут сделать свою книгу главным руководством.

PatchouliButton уместен, когда установлено несколько книг, игрокам нужен единый вход в документацию или у модпака есть одно главное руководство.

Без книг Patchouli дополнение не создаёт полезное содержание само по себе. Оно также не заменяет просмотр рецептов, журнал заданий или меню настроек.

Совместимость и платформы​

Подтверждены Minecraft 1.20.1 и 1.19.2, загрузчик Fabric. В официальном описании указано, что проект разрабатывается для Fabric и планов на Forge-версию нет. Поддержка Forge, NeoForge, Quilt и других версий Minecraft не заявлена.

Перед установкой сопоставляют Minecraft, Fabric, обязательные зависимости, выпуск PatchouliButton и состав клиента с сервером.

Два доступных файла имеют одинаковое имя, но разные размеры, хеши и метаданные.

Как различить файлы​

Проверены два выпуска:

• patchoulibutton-1.0.2.jar — версия 1.0.2+1.20.1, 34691 байт, SHA-1 3c544b2e96182f589e5ad8706f4c9d0e1cc88e58;
• patchoulibutton-1.0.2.jar — версия 1.0.2, 36395 байт, SHA-1 287b33acc4e50fa52dfb9ae6e2a62cf94231c3be.

Из-за одинакового имени выбирать нужно по версии Minecraft, размеру и контрольной сумме. Оба файла нельзя оставлять в одной папке mods, даже если один был переименован: это создаёт дубликат, а не совместимую пару.

Обязательные зависимости​

Для PatchouliButton указаны три required-зависимости:

• Fabric API;
• Patchouli;
• Cloth Config API.

Все компоненты должны соответствовать выбранным Minecraft и Fabric. Наличие двух зависимостей не заменяет третью. Конкретные параметры Cloth Config или ручные настройки в фактической основе не приведены, поэтому придумывать ключи и пути по аналогии нельзя.

При сообщении об отсутствующей зависимости требуется подобрать правильный JAR, а не переименовывать существующий файл или распаковывать архив.

Клиентская и серверная стороны​

Для проекта отмечено client=required и server=required. В сетевой сборке PatchouliButton нужен на клиенте и сервере. Перед подключением сверяют Minecraft, Fabric, сам мод, Fabric API, Patchouli, Cloth Config API и отсутствие дубликатов.

Односторонняя установка может вызвать отказ подключения или неполную работу интерфейса. В одиночной игре JAR размещается в обычной папке модов.

Подготовка и установка​

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

Порядок действий:

• Зафиксировать версии Minecraft и Fabric.
• Выбрать PatchouliButton по метаданным, размеру и хешу.
• Подобрать три совместимые зависимости.
• Удалить старые и дублирующиеся выпуски.
• Поместить отдельные JAR в папку mods.
• Установить согласованный набор на вторую сторону.
• Запустить тестовый профиль и проверить журнал.

Распаковывать JAR не требуется. Дополнительные команды установки не заявлены.

Проверка результата​

Проверять следует не только успешный запуск, но и заявленный путь к книгам. Удобна тестовая сборка с одной или несколькими известными книгами Patchouli.

Контрольный список:

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

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

Доступ к конкретной книге модпака​

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

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

Ограничения подтверждённых функций​

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

Не подтверждены:

• версии для Forge и NeoForge;
• автоматическое создание книги модпака;
• преобразование других форматов документации;
• отдельные команды управления;
• конкретные параметры внешнего вида;
• поддержка Minecraft вне 1.20.1 и 1.19.2.

Файлы получены по официальному HTTPS, сверены по хешам и статически проверены; динамический запуск не выполнялся. Лицензия MIT (SPDX: MIT) допускает локализацию при сохранении названия, авторства Globox1997 и лицензионных сведений.

Безопасное обновление​

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

Безопасная последовательность:

• Остановить клиент и сервер и создать копию профиля.
• Удалить прежний PatchouliButton.
• Добавить один файл для нужной версии Minecraft.
• Не менять все зависимости одновременно.
• Проверить инвентарь, список и целевую книгу.
• После теста выдать одинаковый набор участникам.

Обновление самого Patchouli может изменить отображение книг независимо от PatchouliButton, поэтому компоненты лучше проверять по одному.

Откат​

Если кнопка исчезла, инвентарь закрывается с ошибкой или книга не открывается, возвращают последний рабочий комплект: PatchouliButton, Fabric API, Patchouli и Cloth Config API. Возврата одного JAR недостаточно, если зависимости тоже обновлялись.

Для отката удаляют новый выпуск, возвращают прежние файлы без дубликатов, восстанавливают настройки и проверяют копию профиля по журналу.

Хотя изменение мирогенерации не заявлено, резервная копия мира остаётся разумной мерой обслуживания.

Диагностика неполадок​

Проверку ведут последовательно:

• отсутствует зависимость — проверить все три required-проекта;
• несовместимая версия — сверить Minecraft и конкретный JAR;
• мод загружается дважды — удалить одинаковые или переименованные копии;
• кнопка отсутствует — убедиться, что мод распознан и нет конфликта интерфейсов;
• список пуст — проверить наличие самих книг Patchouli;
• конкретная книга не открывается — проверить её существование и настройку;
• сервер не принимает клиента — сравнить обязательный состав сторон;
• ошибка началась после обновления — вернуть рабочую связку и менять компоненты по одному.

FAQ​

PatchouliButton заменяет Patchouli?​

Нет. Patchouli является обязательной зависимостью. Дополнение только предоставляет общий способ открыть существующие книги.

Есть ли версия для Forge?​

Нет подтверждения. Проект разработан для Fabric, а планов на Forge-версию не заявлено.

Почему два JAR называются одинаково?​

Это разные выпуски по метаданным, размеру и хешам. Одного имени для выбора недостаточно.

Обязательно ли устанавливать мод на сервер?​

Да. Для PatchouliButton клиентская и серверная стороны отмечены как обязательные.

Можно ли открыть сразу книгу сборки?​

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

Разрешено ли включать мод в модпак?​

Да. Это прямо разрешено при соблюдении условий MIT.