Bookshelf Dump Module

Bookshelf Dump Module - узкоспециализированный датапак для отладки, часть модульной библиотеки Bookshelf. Если вы когда-нибудь собирали сложную систему на scoreboard и NBT, то знаете, как больно смотреть на десятки команд /scoreboard players get и /data get по одной. Этот модуль делает всё за один вызов.

Зачем это нужно

Minecraft не даёт удобного дебаггера для командных систем. Данные разбросаны по scoreboard, NBT-тегам сущностей и блочных сущностей. Bookshelf Dump Module собирает всё в один структурированный вывод в чат через единую функцию #bs.dump:var. По сути это такой console.log для мира Minecraft.

Подойдёт в первую очередь мапмейкерам, авторам мини-игр и разработчикам своих датапаков. Обычным игрокам в выживании он ни к чему - это чисто технический инструмент.

Что умеет

• Выгрузка scoreboard-значений в чат по простому синтаксису
• Выгрузка NBT-данных в том же дампе
• Объединение разных типов данных в один структурированный вывод
• Единая точка входа через #bs.dump:var

Ключевой плюс - не нужно держать под рукой шпаргалку с командами. Прописали функцию один раз, получили всё, что хотели увидеть, в удобочитаемом виде.

Технические детали

Это именно датапак, а не мод. Значит, никакой Fabric, Forge, NeoForge или Quilt не нужен - достаточно Java Edition и папки datapacks в вашем мире. Ставится стандартно: скидываете архив в datapacks, перезагружаете мир командой /reload.

Актуальная ветка модуля идёт с файлом bs.dump-26.3-v4.2.1, то есть рассчитан на Minecraft 26.3. Заявлена совместимость также с 26.2, 26.1 и версиями с 1.21.5 по 1.21.11. Имейте в виду: для старых версий Minecraft ветки датапака отличаются, читайте версию файла перед скачиванием.

Важные нюансы из практики

Датапак считается устаревшим, если версия не совпадает с версией мира - команды могут просто не загрузиться. Проверяйте соответствие pack_format или смотрите на название файла, оно как раз кодирует версию.

Модуль тесно работает с остальной экосистемой Bookshelf. Если вы уже используете другие модули библиотеки, #bs.dump:var подхватит структуры данных без конфликтов. Отдельно ставить полный Bookshelf Suite не обязательно - можно взять только dump-модуль, но тогда проверьте, что его внутренние зависимости не тянут за собой другие части библиотеки.

В версии 4.0.0 функцию #bs.dump:var обновили под Minecraft 26.1, так что если у вас старый вызов из туториала - сверьте синтаксис. Хотфикс 4.2.1 относится к bs.raycast, а не к самому дампу, но обновляться всё равно стоит, чтобы не ловить несовместимости между модулями.

Кому и зачем

Если вы пишете датапак с десятком взаимозависимых счётчиков scoreboard и NBT-тегов - это буквально спасение. Отладка перестаёт быть археологией. Если же вам нужно просто быстро глянуть одно значение - хватит встроенных команд /scoreboard players get и /data get, модуль будет избыточен.

По сути Bookshelf Dump Module - это микроинструмент с одной функцией, но сделанный как надо: производительно, лаконично и в составе продуманной библиотеки для mapmaker'ов. Скачайте Bookshelf Dump Module для Minecraft, если ваш проект уже перерос ручную отладку через чат - и держите данные под контролем.