Puzzles Lib - это библиотека, без которой не запуска которой не заработает ни один мод от этого разработчика. Почему такое название? Ну, это и есть загадка (puzzle).) - автор любит оставлять интригу.

По сути, это прослойка между кодом мода и конкретным загрузчиком (Fabric, Forge, NeoForge, Quilt). Вместо того чтобы писать одну и ту же логику под каждый лоадер отдельно, разработчик вынес общие функции в Puzzles Lib. Это позволяет ему одновременно выпускать моды под разные платформы без лишней головной боли.

Что умеет библиотека

• Использовать большую часть Forge-событий (IModBusEvent) в общем проекте - то есть писать код один раз, а работает везде и на Fabric.
• Регистрировать контент в игровые регистры Майнкрафт (предметы, блоки, сущности и т.д.).
• Отправлять сообщения между клиентом и сервером с авто-сериализацией - просто используешь Java-запись (record) и всё само превращается в пакеты.
• Создавать конфиги на основе аннотаций, которые работают через Forge Config API Port на Fabric. Удобно - прописал пару строк и готово.
• Прикреплять кастомные данные к сущностям, блокам, чанкам и измерениям. На Forge это система способностей (capability), на Fabric - Cardinal Components.
• Вносить правки в биомы Minecraft прямо при загрузке прямо в коде - без лишних костылей.

Важно знать

Puzzles Lib заточена строго под нужды автора. Он не позиционируется как универсальная библиотека для всех разработчиков. Но если вам понравилась какая-то реализация - можете смело адаптировать её под свои проекты.

Требования к установке

• Обязательно на клиенте и на сервере - без неё моды просто не запустятся.
• Для Fabric - потребуется [Fabric API и Forge Config API Port.
• Для Forge/NeoForge - дополнительных библиотек не нужно, всё уже встроено.

По факту, если вы собираетесь играть с модами этого разработчика (например, Visual Workbench, Trading Post, Golden Age Combat), Puzzles Lib - обязательна к скачиванию. Без неё ни один из них не запустится. Так что держите её под рукой.