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

Bookshelf Block Module

Get and set block IDs and states in Minecraft datapacks. Mix block properties and produce sounds, particles, display blocks, and more from stored data.

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

Опубликован 5 апреля 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 Block Module

Get and set block IDs and states in Minecraft datapacks. Mix block properties and produce sounds, particles, display blocks, and more from stored data.

"Architecture is the thoughtful making of space."

— Louis Kahn

✨ Features

  • 🔍 Get: get the block state or type and store it into a storage
  • ⚙️ Set: set the block state or type from a storage to a block
  • 🔄 Transform: mix blocks (for example stone + oak stairs = stone stairs)
  • ✅ Check: check if a block is a certain type, has a certain state
  • 🎨 Produce: create a new block, display block, sound or particle from stored data

📚 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.block

  • ✨ #555 - Updated block mappings 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.

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.block

  • ⚠️ #509 - Removed multi-tick fill operations (fill_block, fill_type, fill_random). Use the new bs.generation module for async iteration with callbacks.
  • ⚠️ #523 - Removed deprecated functions and tags from previous versions.
  • ⚠️ #525 - Removed NBT concatenation from block output. State and NBT are now returned as separate fields.
  • ⚡ #509 - Simplified fill_block to use the vanilla fill command (single-tick execution).
  • ⚡ #509 - Simplified fill_type with a cleaner recursion model (single-tick execution).
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.

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.block

  • 🗑️ #489 - Deprecated play_block_sound in favor of more granular functions (play_break_sound, etc.).
  • ✨ #496 - Added new predicates: is_conductive, is_powered, is_spawnable, is_strongly_powered, and is_weakly_powered.
  • ✨ #496 - Added new functions: is_touching_power, is_touching_strong_power, and is_touching_weak_power.
  • ✨ #489 - Added new block property functions: get_blast_resistance, get_friction, get_hardness, get_instrument, get_jump_factor, get_luminance, get_sounds, and get_speed_factor.
  • ✨ #489 - Added new block sound functions: play_break_sound, play_hit_sound, play_fall_sound, play_place_sound, and play_step_sound.
  • ✨ #489 - Added new block tags: can_occlude and ignited_by_lava.
  • ⚡ #489 - Modified emit_block_particle to support a default type, aligning it with the new block sound function behavior.
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.block

  • 🐛 #469 - Fixed missing execute in minecraft:overworld when running location-based loot tables.

Комментарии

Загружаем…