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

Bookshelf — библиотека, а не блок

В названии легко запутаться: здесь речь о моде-библиотеке Bookshelf, а не о книжной полке для стола зачарования. Библиотека содержит общий код, события и утилиты, которые повторно используют другие моды. Она может добавлять вспомогательные команды и datapack-возможности, но основная причина установки — зависимость. Рецепт книжной полки и схема из 15 блоков относятся к отдельному гайду.

Каким модам она нужна

Официальный проект перечисляет Enchantment Descriptions, Botany Pots, Tips и Dark Utilities среди примеров. Список меняется, поэтому проверяйте Relations у конкретного файла. Не устанавливайте Bookshelf только потому, что мод создан тем же автором. Надёжное основание — manifest, страница зависимости или точное сообщение загрузчика. В готовом модпаке библиотека обычно уже включена.

Выбор версии и платформы

Сопоставьте Minecraft, Forge, Fabric, Quilt или NeoForge и требуемую ветку Bookshelf. Платформенные файлы различаются, хотя библиотека имеет общий код. Номер релиза не обязан совпадать с версией зависимого мода. Используйте официальные фильтры и название jar. Для старой сборки не берите самый свежий файл: его common-модуль может ожидать новые классы игры.

Установка

Остановите игру, положите один jar в mods выбранного профиля и добавьте мод, который его требует. Не распаковывайте файл. Запустите игру и проверьте latest.log. Если лаунчер создаёт отдельные экземпляры, откройте папку через настройки профиля. Наличие Bookshelf без зависимого мода не превращает её в самостоятельный контентный набор. Дубликаты разных версий оставлять нельзя.

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

Официальный проект работает на клиенте и сервере, но сторона установки зависит от использующего его мода. Общий игровой мод часто нужен на обеих сторонах, интерфейсный — только клиенту. На сервере повторите тот же loader и совместимую ветку. Если клиент не пускает из-за mismatched mod list, сравните полный состав, а не только Bookshelf.

Ошибка missing Bookshelf

Откройте полный текст требования: он указывает минимальную либо допустимую версию. Скачайте файл под свою игру и загрузчик. Если Bookshelf уже есть, проверьте, что jar лежит в активной папке и не отключён расширением. Старое имя файла рядом с новым может создать duplicate mod. Не обходите dependency-проверку ручным редактированием архива.

Ошибка после обновления

NoSuchMethodError и NoClassDefFoundError часто означают, что Bookshelf и зависимый мод собраны против разных API. Верните предыдущий комплект, затем обновляйте связанные файлы группой. Проверьте changelog и диапазон версий. Удаление config без копии редко помогает при такой ошибке и может уничтожить настройки. Сначала подтвердите совместимость бинарников.

Встроенные инструменты

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

Обновление модпака

Сохраните manifest, папку config и мир. Меняйте Bookshelf вместе с модами, которые явно от неё зависят, затем тестируйте копию мира. Если профиль управляется CurseForge или другим менеджером, обновляйте внутри него. Ручная подмена одного jar может нарушить зафиксированный набор. После удачного запуска запишите версии, чтобы иметь рабочую точку отката.

Диагностика

Для issue нужны Minecraft, Java, loader, Bookshelf, зависимый мод и полный журнал. Отделите библиотеку книжной полки от одноимённого блока уже в заголовке обращения. Соберите минимальный профиль и воспроизведите ошибку. Если он работает, добавляйте остальные моды партиями. Первая причина в stack trace полезнее последней общей строки о завершении.

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

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

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