Перейти к содержимому
Mineforgian

Bookshelf Hitbox Module

Get precise hitbox data for blocks and entities in Minecraft datapacks. Check collisions and access both collision and interaction shapes.

Загрузки
880
Подписчики
3
Обновлён
17 июня 2026 г.
Лицензия
MPL-2.0

Опубликован 6 апреля 2025 г.

Bookshelf

Bookshelf is a library datapack for Minecraft. It's modular, so mapmakers can pick only the parts they need. This helps them create complex systems more easily.

Documentation      


🎯 Bookshelf Hitbox Module

Get precise hitbox data for blocks and entities in Minecraft datapacks. Check collisions and access both collision and interaction shapes.

"Talent hits a target no one else can hit; Genius hits a target no one else can see."

— Arthur Schopenhauer

✨ Features

  • 📏 Hitbox detection: get precise hitbox information for both blocks and entities
  • 🎯 Collision checking: check if entities are within block collision or interaction boxes
  • 🔍 Detailed analysis: access both collision and interaction shapes for blocks

📚 Read the full documentation

📖 About Bookshelf

This module is part of the Bookshelf Library:

🧩 Find more modules in the Bookshelf organization
📦 Get the full Bookshelf Suite

🤝 Get involved

💬 Join our Discord community
🛠 Contribute via the contribution guide

Ченджлог

4.1.0Релиз26.2 · 17 июня 2026 г.

📦 Bookshelf - 4.1.0

🗂️ The Collection Update!

Adds a new collection module and support for Minecraft 26.2.

Bookshelf is now based on Minecraft 26.2.

  • 🐛 #552 - Migrate to the Minecraft 26.2 predicate format.

🎯 bs.hitbox

  • #555 - Updated entity hitboxes for Minecraft 26.2.
4.0.1Релиз26.1 · 4 апреля 2026 г.

📦 Bookshelf - 4.0.1

🩹 Hotfix!

This is a hotfix for version 4.0.0.

🎯 bs.hitbox

  • 🐛 #543 - Fixed glow squid entities hitboxes and the is_sized entity type tag.
4.0.0Релиз26.1 · 24 марта 2026 г.

📦 Bookshelf - 4.0.0

🧹 The Tiny Sweep Update!

First release for Minecraft's new date-based versioning, dropping support for previous versions.

⚠️ BREAKING CHANGES: This version has breaking changes!

Bookshelf is now based on Minecraft 26.1.

🎯 bs.hitbox

  • ⚠️ #523 - Removed deprecated functions and tags from previous versions.
  • ⚠️ #532 - Removed fluids from the intangible block tag to simplify the use of hitbox providers.
  • #532 - Updated entity hitboxes for Minecraft 26.1.
3.2.2Релиз1.21.9, 1.21.10, 1.21.11 · 1 февраля 2026 г.

📦 Bookshelf - 3.2.2

🩹 Hotfix!

This is a hotfix for version 3.2.1.

🎯 bs.hitbox

  • 🐛 #520 - Fixed Nautilus entities hitboxes.
  • 🐛 #519 - Fixed fluid hitbox providers for full liquid blocks.
3.2.1Релиз1.21.9, 1.21.10, 1.21.11 · 12 января 2026 г.

📦 Bookshelf - 3.2.1

🩹 Hotfix!

This is a hotfix for version 3.2.0.

3.2.0Релиз1.21.9, 1.21.10, 1.21.11 · 9 декабря 2025 г.

📦 Bookshelf - 3.2.0

🧱 The Block Update!

Introduces new block data and deprecates several older features in preparation for the future.

Bookshelf is now based on Minecraft 1.21.9-1.21.11.

  • #403 - Added the #bs.load:status function to view loaded modules.
  • #501 - Optimized tp commands used in macros.
  • #501 - Reduce NBT writing and remove a few macros.
  • 🐛 #501 - Ensure sculk sensors are not triggered when markers are killed.

🎯 bs.hitbox

  • 🗑️ #484 - Block tag has_offset has been deprecated and will be removed in a v4.0.0. Please use has_shape_offset instead.
  • 🗑️ #484 - Function #bs.hitbox:get_block has been deprecated and will be removed in a v4.0.0. Please use #bs.hitbox:get_block_shape or #bs.hitbox:get_block_collision instead.
  • 🗑️ #484 - Functions #bs.hitbox:is_entity_in_block_interaction, #bs.hitbox:is_entity_in_blocks_interaction, and #bs.hitbox:is_in_block_interaction have been deprecated and will be removed in a v4.0.0. Please use #bs.hitbox:is_entity_in_block_shape, #bs.hitbox:is_entity_in_blocks_shape, or #bs.hitbox:is_in_block_shape instead.
  • #502 - Added new 1.21.11 entities.
3.1.1Релиз1.21.6, 1.21.7, 1.21.8 · 30 августа 2025 г.

📦 Bookshelf - 3.1.1

🩹 Hotfix Release!

Patch release for version 3.1.0.

3.1.0Релиз1.21.6, 1.21.7, 1.21.8 · 17 июля 2025 г.

📦 Bookshelf - 3.1.0

💫 The Spatial Update!

Introduces Moon and Sun position features, as well as fully customizable hitboxes that integrate across the entire Bookshelf ecosystem.

Bookshelf is now based on Minecraft 1.21.8.

🎯 bs.hitbox

  • #465 - Added support for custom hitboxes. #bs.hitbox:get_entity now also returns depth in addition to width. For most dynamic entities depth equals width, except for static entities (e.g. item frames, paintings) and custom hitboxes.

Комментарии

Загружаем…