Bookshelf Block Module

Bookshelf Block Module - библиотечный датапак для Minecraft Java Edition. Если коротко: это набор готовых функций, которые снимают с автора карт рутину при работе с блоками. Мод тут ни при чём - загрузчики вроде Fabric, Forge или NeoForge не нужны, всё держится на ванильной механике датапаков.

Проект входит в экосистему Bookshelf от команды Gunivers. Идея простая: вместо одной большой библиотеки автор подключает только нужные модули. Блоковый модуль отвечает за блоки - их состояния, NBT и свойства. Зайдёт это в первую очередь мейпмейкерам и разработчикам датапаков, которые делают механизмы, головоломки, кастомные структуры или целые мини-игры. Обычному игроку сам по себе он не нужен - это инструмент для тех, кто что-то собирает внутри игры, а не для выживания.

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

В ванильном Майнкрафт есть /setblock и /data. Но когда дело доходит до реальной механики, команд становится слишком много, а логика - громоздкой. Bookshelf Block Module закрывает именно эту боль: короткие вызовы вместо длинных цепочек.

Представь, что нужно поставить блок, прочитать его состояние, а потом ещё и превратить один блок в другой. Вручную это десятки строк. С модулем - пара функций.

Что умеет модуль

• Доставать блоки из мира и складывать их в storage
• Ставить блоки обратно из storage
• Смешивать блоки: камень плюс дубовые ступени дают каменные ступени
• Проверять, является ли блок нужным типом, и есть ли у него конкретное состояние
• Создавать из сохранённых данных display-блок, звук или частицу

Все функции живут в пространстве имён bs.block. Зависимые датапаки обращаются к ним через коллбэки вида #bs.block:.... Если ты уже писал что-то под Bookshelf, синтаксис будет знакомым.

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

Платформа	Версии
Minecraft Java Edition	1.21.5 - 1.21.11, 26.1, 26.2
Актуальная ветка на GitHub	4.2.1 для Minecraft 26.3
Загрузчики модов	не требуются (это датапак)
Лицензия	MPL-2.0

В версии 4.0.0 модуль пережил крупную переработку: NBT и состояния блоков разделили, а устаревшие функции заполнения убрали. Если переносишь старый проект, готовься править вызовы.

Релиз 4.2.1 для самого bs.block ничего нового не принёс - это hotfix всей библиотеки, который чинит конфликт идентификаторов сущностей в модуле bs.raycast.

Важный нюанс

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

Ещё момент: bs.block официально требуется некоторым callback-функциям модуля bs.generation. То есть если используешь генерацию из той же библиотеки, без Block Module часть механик просто не заведётся. Датапак IRE, например, публиковал обновление со встроенной версией Bookshelf Block Module - наглядный пример, как модуль встраивают в сторонние проекты.

Совет

Перед подключением проверь версию Minecraft. Диапазон совместимости тут не самый широкий, и на старых сборках вроде 1.20 модуль просто не заработает. Для свежих версий - пожалуйста.

И держи в голове: это библиотека. Красивых текстур и мобов она не добавит. Вся её ценность видна только когда ты сам пишешь датапак или карту и хочешь сэкономить время на рутине.

Скачать Bookshelf Block Module стоит, если ты делаешь карты, механизмы или мини-игры и устал от громоздких командных цепочек. Модуль берёт скучную часть на себя, а тебе оставляет творческую.