Bookshelf Hitbox Module

Bookshelf Hitbox Module - модуль датапак-библиотеки Bookshelf для Minecraft Java Edition. Если ты делаешь карты, мини-игры или сложные серверные системы на датапаках, эта штука сэкономит кучу времени. Она открывает то, что ванильный Minecraft старательно прячет: точную геометрию хитбоксов блоков и сущностей.

Зачем это вообще нужно

В ваниле ты не можешь просто спросить у игры "какой формы этот блок" или "пролезет ли сущность в этот проём". Приходилось либо вручную прописывать таблицы форм, либо проверять блоки по одному - а это лишняя нагрузка и куча кода. Bookshelf Hitbox Module закрывает эту дыру и даёт готовый API для работы с хитбоксами.

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

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

• Точный хитбокс любого блока или сущности. Получаешь реальную форму, а не приблизительную прикидку.
• Проверка попадания сущности в блок. Можно узнать, находится ли сущность внутри коллизии блока или его interaction-бокса.
• Провайдеры форм для жидкостных и нежидкостных блоков. Другие модули берут эти данные и строят на них свои системы.
• Кастомные размеры сущностей. Стандартные габариты можно переопределить под свои задачи.

Отдельно стоит сказать про разницу между collision-shape и interaction-shape. Первое - это физическая коллизия, во что ты реально упираешься. Второе - зона взаимодействия. Модуль различает их, и для точных механик это критично.

Важные нюансы

Это не мод. Fabric, Forge или NeoForge не нужны - проект ставится как датапак в папку мира или на сервер. Лицензия MPL-2.0.

Начиная с v3.0 модуль поставляется отдельно от остальной библиотеки и поддерживает кастомные хитбоксы. Старые функции interaction-hitbox постепенно заменяются shape-функциями - если переносишь старый проект, проверь, что вызываешь актуальные. Иначе получишь тихие ошибки в логах, которые не всегда сразу заметишь.

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

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

Параметр	Значение
Тип	Датапак-модуль (библиотека)
Загрузчик	Не требуется, ванильный датапак
Версии Minecraft	1.21.5 - 1.21.11, 26.1, 26.2
Лицензия	MPL-2.0
Зависимости	Bookshelf

Актуальная ветка самой библиотеки Bookshelf вышла как v4.2.1 для Minecraft 26.3. В обновлении под 26.2 подтянули hitbox-данные сущностей, починили fluid-провайдеры для блоков вроде kelp и seagrass и добавили теги is_water, is_waterlogged, is_full_cube_shape и is_full_cube_collision. Последние два особенно удобны, когда нужно быстро отсеять полные кубы от сложных форм.

С чем сочетается

Модуль заточен под экосистему Bookshelf. Логичнее всего он раскрывается в связке с bs.raycast и bs.move - провайдеры хитбоксов напрямую кормят системы рейкастов и движения. Хочешь больше - бери полный Bookshelf Suite, там собран весь набор модулей.

Если ты пишешь что-то серьёзное на датапаках - это must-have. Скачать датапак Bookshelf Hitbox Module стоит тем, кто устал вручную считать формы блоков и хочет работать с реальной геометрией мира. На слабом железе разницы не почувствуешь, а вот в точности механик - вполне.