Puzzles Lib — Minecraft Java Edition 1.21.1

Puzzles Lib — це базова технічна бібліотека для модів Майнкрафт, створена розробником Fuzs. Вона не додає нових блоків, предметів, мобів чи геймплейних механік безпосередньо у світ гри. Її головна функція — надання спільного програмного інтерфейсу (API), який дозволяє іншим модифікаціям працювати однаково стабільно на різних завантажувачах, абстрагуючи специфічний код Forge, Fabric та NeoForge. Завантажити мод Puzzles Lib необхідно виключно для забезпечення роботи пов'язаних доповнень.

Екосистема залежних модифікацій

Ця бібліотека є обов'язковою вимогою для запуску понад тридцяти різних проєктів. Вона містить загальний код для обробки подій, рендерингу моделей та синхронізації даних між клієнтом і сервером.

Найпопулярніші технічні моди для Minecraft, які використовують цей фреймворк:

• Зміни інтерфейсів та блоків: Easy Magic, Easy Anvils, Visual Workbench. Бібліотека відповідає за збереження предметів в інвентарях цих блоків після їх закриття та за візуалізацію луту безпосередньо на текстурі блоку.

• Магічні та торгові розширення: Enchanting Infuser, Trading Post, Universal Enchants. Puzzles Lib забезпечує логіку взаємодії цих модів з ванільним генератором випадкових чисел та алгоритмами генерації угод жителів.

• Клієнтські розширення: компаси, годинники та інші інформаційні доповнення, де API обробляє виведення даних на екран без падіння FPS.

Конфігурація модів Fuzs

Уніфікація форматів налаштувань — ключове завдання цієї бібліотеки. Замість підтримки JSON для Fabric і TOML для Forge, розробник запровадив єдиний стандарт.

Puzzles Lib примусово переводить усі залежні від неї моди на використання формату .toml. Сама бібліотека також має власний файл налаштувань puzzleslib-client.toml у папці config.

checkIncompatibleMods

enableOptifineWarning

forceResourcePacks

Вирішення проблем із запуском та конфлікти

Оскільки Puzzles Lib є кросплатформною, помилки під час збірки клієнта трапляються часто. Аналіз логів показує три основні причини, через які стається виліт гри (crash), пов'язані з цією бібліотекою.

Відсутність порту конфігурацій на Fabric

Помилка, яка призводить до миттєвого закриття гри на етапі ініціалізації. Оскільки Fabric нативно не підтримує систему конфігурацій Forge (формат TOML), Puzzles Lib не може прочитати файли налаштувань. Для виправлення ситуації необхідно завантажити в папку mods допоміжний мод Forge Config API Port.

Несумісність версій завантажувача

Гравці часто копіюють .jar файл Puzzles Lib для Forge у збірку на Fabric, або навпаки. Файли на платформах CurseForge та Modrinth мають відповідні теги (fabric, forge, neoforge у назві). Запуск файлу для іншого завантажувача гарантовано видає помилку Mod resolution failed або java.lang.NoClassDefFoundError.

Десинхронізація серверних тегів

Якщо бібліотеку встановлено на сервері, але вона відсутня на клієнті (або версії відрізняються), гравець отримує помилку Connection closed - mismatched mod channel list під час спроби підключення. Puzzles Lib вимагає встановлення по обидва боки з ідентичною версією файлу.

Сумісність

• Обов'язкові залежності: Для гри на Fabric/Quilt критично необхідні Fabric API та Forge Config API Port. Для Forge/NeoForge додаткових файлів завантажувати не потрібно — класи вбудовані у завантажувач.

• Несумісність: Інтеграція з OptiFine працює нестабільно через конфлікти у конвеєрі рендерингу. Розробник рекомендує використовувати альтернативи: Sodium або Embeddium.

Висновок

Puzzles Lib — це виключно технічний інструмент, який оптимізує розробку та дозволяє оновлювати великий список модифікацій на всіх актуальних завантажувачах одночасно. У порівнянні з масштабними фреймворками на зразок Architectury API, цей мод є вузькоспрямованим і обслуговує виключно екосистему від одного автора. Обмеженням є дещо перевантажена структура залежностей для Fabric-гравців, яким доводиться завантажувати сторонні порти конфігурацій. Наявність цього мода обов'язкова для всіх, хто збирає технічні чи RPG-збірки з використанням інструментів від Fuzs.