Bookshelf

Коротко #what

Bookshelf — небольшой мод: его предметы и механики перечислены в карточке и профиле конфигурации. Отдельного большого гайда по нему нет.

Библиотека в сборке #library-api-ports-batch7-20261104

В игровом реестре этой сборки у библиотеки нет собственных предметов. Блоки, рецепты, игровые ограничения и действия зависимых модов описываются в их собственных статьях; одно присутствие общей библиотеки не делает их одинаковыми.⁠^[2]

Архитектурная роль библиотеки #shared-overview-20261114

Bookshelf — ключевая библиотечная платформа авторства Darkhax, на которой базируются десятки популярных модов на автоматизацию, улучшения чар, ловушки и пользовательские подсказки.⁠^[3] Она стандартизирует работу с инвентарями, биомами, тегами блоков, генерацией таблиц добычи и регистрацией игровых объектов между различными версиями Forge, NeoForge и Fabric.

Большинство зависимых модов перекладывают на Bookshelf обработку NBT-данных, форматирование текстовых описаний для предметов, а также поиск совместимых ингредиентов и предикатов рецептов.⁠^[4] Благодаря этому интерфейсные подсказки (например, описания зачарований и эффектов ловушек) работают стабильно и без лишнего повторения кода в каждом отдельном пакете.

Для обычного игрока библиотека полностью прозрачна: собственных блоков, руд или инструментов у Bookshelf в игре нет, а её наличие проверяется автоматически при старте модифицированного клиента и выделенного сервера.⁠^[3] Кроме того, внутри сосредоточены готовые предикаты состояний мира, хелперы цветов и координат, а также расширяемые таблицы модификаторов веса дропа, проверки биомов, генерации эффектов и лута сундуков в структурах.