Puzzles Lib: что это и какую версию устанавливать

Что такое Puzzles Lib

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

Когда она нужна

Основанием служат Relations, manifest модпака или сообщение загрузчика. Не ставьте Puzzles Lib в чистую игру ради проверки. Некоторые проекты автора могут использовать другие библиотеки или не требовать её в определённой ветке. Проверяйте зависимость выбранного файла, а не общее название проекта.

Статус веток

Официальный GitHub разделяет ветки на primary, maintained, bugfixes only и archived. Это важно для старых версий Minecraft: файл может оставаться доступным, но не получать новые функции. Для стабильной сборки выбирайте релиз, который соответствует вашему модпаку, а не переносите новый jar в архивную ветку.

Выбор платформы

Совместите Minecraft, Fabric, Forge или NeoForge и требуемый диапазон Puzzles Lib. В современной линии доступность платформ меняется между версиями. Откройте Files и отфильтруйте игру. Не используйте Forge-файл на NeoForge либо Fabric, если официальный релиз не обозначает совместимость прямо.

Дополнительные зависимости Fabric

Для Fabric библиотека может требовать Fabric API и Forge Config API Port. Точный список указан на странице конкретного релиза. Puzzles Lib не заменяет эти компоненты. Если загрузчик сообщает несколько missing dependencies, установите каждую официальную совместимую версию, а не останавливайтесь после первой строки.

Установка

Закройте игру и положите один jar в mods нужного экземпляра. Добавьте зависимый мод и дополнительные API, если они указаны. Не распаковывайте архив. После запуска проверьте latest.log. Если Puzzles Lib загрузилась, но контента нет, исправляйте основной мод — библиотека не создаёт его функции самостоятельно.

Клиент и сервер

Официальный проект предназначен для обеих сторон. Когда зависимый мод меняет gameplay, совместимая библиотека нужна клиенту и серверу. Чисто клиентский проект может быть исключением. Следуйте его странице. На сервере сравните manifest целиком и удалите случайные клиентские дополнения.

Ошибка requires Puzzles Lib

Сравните установленный номер с диапазоном в сообщении. Удалите дубликаты, затем скачайте релиз для правильной игры и loader. Если разные моды требуют несовместимые ветки, обновите или откатите один из них. Не меняйте dependency вручную внутри jar: код всё равно ожидает конкретные методы.

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

Сохраните mods, config и мир. Обновите Puzzles Lib вместе с модами Fuzs, которые от неё зависят. Сначала используйте тестовый мир. Если появляется NoSuchMethod, верните предыдущую группу и найдите пересекающиеся релизы. Менеджер модпака помогает сохранить manifest и дополнительные API.

Диагностика

Укажите Minecraft, Java, loader, Puzzles Lib, требующий мод и все дополнительные библиотеки. Приложите latest.log или server log. Создайте минимальный профиль и воспроизведите ошибку. ClassNotFound говорит об отсутствующем компоненте или неверной платформе, NoSuchMethod — о несовместимой ветке.

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

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

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