Bookshelf Log Module

Bookshelf Log Module - это не игровой контент, а рабочий инструмент для тех, кто пишет датапаки. Простыми словами: модуль библиотеки Bookshelf, который выводит сообщения в чат с разными уровнями важности. Для обычного игрока штука бесполезная, а вот для разработчика - почти must-have, потому что отлаживать датапак вслепую то ещё удовольствие.

Что это и зачем нужно

Если вы когда-нибудь писали функции для датапака в Minecraft, то знаете главную боль - ошибка есть, а где она, непонятно. Вывод через tellraw или say быстро превращается в кашу: всё валится в чат без структуры, старые сообщения улетают вверх, а отличить важную ошибку от служебной мелочи невозможно.

Bookshelf Log Module решает именно эту проблему. Это датапак-библиотека, отдельный загрузчик вроде Forge или Fabric для неё не нужен. Модуль даёт нормальную систему логирования: сообщения получают уровни важности, их можно фильтровать по уровню, пространству имён (namespace) и тегам, а историю - просматривать и очищать. По сути, это консоль для вашего датапака прямо в чате.

Возможности

• Уровни важности - каждое сообщение помечается severity, так что info, warning и error не смешиваются в одну ленту.
• Фильтрация - логи отсеиваются по уровню, namespace или тегу. Во время теста большого проекта это экономит кучу времени.
• История - можно вернуться к предыдущим сообщениям, а не судорожно скроллить чат.
• Очистка - историю разрешено сбрасывать, когда она надоела или нужно начать проверку с чистого листа.

Для кого это

Целевая аудитория - разработчики датапаков и люди, которые собирают сложные системы на функциях и предикатах. Это библиотека-утилита в духе отладочных инструментов, и её обычно подключают в паре с полным набором Bookshelf Suite, когда проект обрастает зависимостями. Если вы пишете чисто декоративный датапак на пару функций, модуль вам ни к чему. А вот в проекте на сотни файлов он окупается быстро - по опыту, половина багов ловится именно на этапе, когда логи перестают быть кашей в чате.

Совместимость и версии

Модуль распространяется как датапак для Minecraft Java Edition. В списке поддерживаемых версий - 1.21.5-1.21.11, а также 26.1, 26.2 и 26.3. Последняя известная версия модуля - 4.2.1 под Minecraft 26.3. Отдельные моды-загрузчики не требуются, только сам датапак и, если используете его как часть библиотеки, совместимая версия Bookshelf.

Важно знать

Это модуль, а не самостоятельный датапак с контентом. Он входит в библиотеку Bookshelf и в набор Bookshelf Suite: если нужны другие модули вроде утилит для структур, рейкастов или работы с инвентарём, логичнее ставить весь набор, чем тянуть каждый модуль по отдельности. Ставить на сервер можно - работает штатно, но помните, что логи увидят только те, у кого есть доступ к чату, а лишние диагностические сообщения стоит вовремя отключать перед релизом проекта.

Совет из практики: перед публикацией датапака пробегитесь по всем точкам логирования и уберите или понизьте уровень отладочных сообщений. Иначе игроки на сервере первым делом увидят ваши внутренние warning-и, а не геймплей. И ещё - используйте namespace в логах осмысленно, иначе при совместных проектах фильтр по тегам превращается в угадайку.

Скачать Bookshelf Log Module имеет смысл тем, кто пишет и отлаживает датапаки для Майнкрафт и хочет видеть сообщения структурировано, а не искать ошибку наугад по всему чату.