
Bookshelf Block Module
Manipulate blocks with their states and NBT, and combine block properties.
1,7 тыс.6обновлён 19 сент. 2026 г.
Библиотеки
Описание
Bookshelf is a Minecraft datapack library. It provides performant modules that help you create complex systems more easily.
🧱 Bookshelf Block Module
Manipulate blocks with their states and NBT, and combine block properties.
"Architecture is the thoughtful making of space."
— Louis Kahn
✨ Features
- Get blocks from the world, or set them from storage
- Mix blocks (for example stone + oak stairs = stone stairs)
- Check whether a block is a given type, has a given state
- Create a display block, sound or particle from storage
About Bookshelf
This module is part of the Bookshelf library:
🧩 Find more in the Bookshelf Organization
📦 Get the full Bookshelf Suite
Get involved
💬 Join our Discord
🛠 Learn how to contribute
Последние версии
Все версии →release
Bookshelf Block Module
4.2.119 сент. 2026 г.57Minecraft: 26.3datapack
Что нового
## 📦 [Bookshelf - 4.2.1](https://github.com/mcbookshelf/bookshelf/releases/tag/v4.2.1)
> **🩹 Hotfix!**
>
> *This is a hotfix for version 4.2.0.*
release
Bookshelf Block Module
4.2.015 сент. 2026 г.8Minecraft: 26.3datapack
Что нового
## 📦 [Bookshelf - 4.2.0](https://github.com/mcbookshelf/bookshelf/releases/tag/v4.2.0)
> **🎬 The Animation Update!**
>
> *Adds a new animation module and support for Minecraft 26.3.*
Bookshelf is now based on **Minecraft 26.3**.
- <abbr title="New Features">✨</abbr> **[#572](https://github.com/mcbookshelf/bookshelf/pull/572)** - Migrate resources to Minecraft 26.3.
release
Bookshelf Block Module
4.1.127 авг. 2026 г.149Minecraft: 26.2datapack
Что нового
## 📦 [Bookshelf - 4.1.1](https://github.com/mcbookshelf/bookshelf/releases/tag/v4.1.1)
> **🩹 Hotfix!**
>
> *This is a hotfix for version 4.1.0.*
release
Bookshelf Block Module
4.1.017 июн. 2026 г.84Minecraft: 26.2datapack
Что нового
## 📦 [Bookshelf - 4.1.0](https://github.com/mcbookshelf/bookshelf/releases/tag/v4.1.0)
> **🗂️ The Collection Update!**
>
> *Adds a new collection module and support for Minecraft 26.2.*
Bookshelf is now based on **Minecraft 26.2**.
* <abbr title="Bug Fix">🐛</abbr> **[#552](https://github.com/mcbookshelf/bookshelf/pull/552)** - Migrate to the Minecraft 26.2 predicate format.
### `🧱 bs.block`
- <abbr title="New Features">✨</abbr> **[#555](https://github.com/mcbookshelf/bookshelf/pull/555)** - Updated block mappings for Minecraft 26.2.
release
Bookshelf Block
4.0.14 апр. 2026 г.61Minecraft: 26.1datapack
Что нового
## 📦 [Bookshelf - 4.0.1](https://github.com/mcbookshelf/bookshelf/releases/tag/v4.0.1)
> **🩹 Hotfix!**
>
> *This is a hotfix for version 4.0.0.*
release
Bookshelf Block
4.0.024 мар. 2026 г.23Minecraft: 26.1datapack
Что нового
## 📦 [Bookshelf - 4.0.0](https://github.com/mcbookshelf/bookshelf/releases/tag/v4.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`
- <abbr title="Breaking Changes">⚠️</abbr> **[#509](https://github.com/mcbookshelf/bookshelf/issues/509)** - Removed multi-tick fill operations (`fill_block`, `fill_type`, `fill_random`). Use the new `bs.generation` module for async iteration with callbacks.
- <abbr title="Breaking Changes">⚠️</abbr> **[#523](https://github.com/mcbookshelf/bookshelf/issues/523)** - Removed deprecated functions and tags from previous versions.
- <abbr title="Breaking Changes">⚠️</abbr> **[#525](https://github.com/mcbookshelf/bookshelf/issues/525)** - Removed NBT concatenation from block output. State and NBT are now returned as separate fields.
- <abbr title="Enhancements">⚡</abbr> **[#509](https://github.com/mcbookshelf/bookshelf/issues/509)** - Simplified `fill_block` to use the vanilla `fill` command (single-tick execution).
- <abbr title="Enhancements">⚡</abbr> **[#509](https://github.com/mcbookshelf/bookshelf/issues/509)** - Simplified `fill_type` with a cleaner recursion model (single-tick execution).
release
Bookshelf Block
3.2.21 февр. 2026 г.121Minecraft: 1.21.9, 1.21.10, 1.21.11datapack
Что нового
## 📦 [Bookshelf - 3.2.2](https://github.com/mcbookshelf/bookshelf/releases/tag/v3.2.2)
> **🩹 Hotfix!**
>
> *This is a hotfix for version 3.2.1.*
release
Bookshelf Block
3.2.112 янв. 2026 г.25Minecraft: 1.21.9, 1.21.10, 1.21.11datapack
Что нового
## 📦 [Bookshelf - 3.2.1](https://github.com/mcbookshelf/bookshelf/releases/tag/v3.2.1)
> **🩹 Hotfix!**
>
> *This is a hotfix for version 3.2.0.*
release
Bookshelf Block
3.2.09 дек. 2025 г.39Minecraft: 1.21.9, 1.21.10, 1.21.11datapack
Что нового
## 📦 [Bookshelf - 3.2.0](https://github.com/mcbookshelf/bookshelf/releases/tag/v3.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**.
- <abbr title="New Features">✨</abbr> **[#403](https://github.com/mcbookshelf/bookshelf/issues/403)** - Added the `#bs.load:status` function to view loaded modules.
- <abbr title="Enhancements">⚡</abbr> **[#501](https://github.com/mcbookshelf/bookshelf/pull/501)** - Optimized tp commands used in macros.
- <abbr title="Enhancements">⚡</abbr> **[#501](https://github.com/mcbookshelf/bookshelf/pull/506)** - Reduce NBT writing and remove a few macros.
- <abbr title="Bug Fix">🐛</abbr> **[#501](https://github.com/mcbookshelf/bookshelf/pull/501)** - Ensure sculk sensors are not triggered when markers are killed.
### `🧱 bs.block`
- <abbr title="Deprecations">🗑️</abbr> **[#489](https://github.com/mcbookshelf/bookshelf/pull/489)** - Deprecated `play_block_sound` in favor of more granular functions (`play_break_sound`, etc.).
- <abbr title="New Features">✨</abbr> **[#496](https://github.com/mcbookshelf/bookshelf/issues/496)** - Added new predicates: `is_conductive`, `is_powered`, `is_spawnable`, `is_strongly_powered`, and `is_weakly_powered`.
- <abbr title="New Features">✨</abbr> **[#496](https://github.com/mcbookshelf/bookshelf/issues/496)** - Added new functions: `is_touching_power`, `is_touching_strong_power`, and `is_touching_weak_power`.
- <abbr title="New Features">✨</abbr> **[#489](https://github.com/mcbookshelf/bookshelf/pull/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`.
- <abbr title="New Features">✨</abbr> **[#489](https://github.com/mcbookshelf/bookshelf/pull/489)** - Added new block sound functions: `play_break_sound`, `play_hit_sound`, `play_fall_sound`, `play_place_sound`, and `play_step_sound`.
- <abbr title="New Features">✨</abbr> **[#489](https://github.com/mcbookshelf/bookshelf/pull/489)** - Added new block tags: `can_occlude` and `ignited_by_lava`.
- <abbr title="Enhancements">⚡</abbr> **[#489](https://github.com/mcbookshelf/bookshelf/pull/489)** - Modified `emit_block_particle` to support a default `type`, aligning it with the new block sound function behavior.
release
Bookshelf Block
3.1.130 авг. 2025 г.226Minecraft: 1.21.6, 1.21.7, 1.21.8datapack
Что нового
## 📦 [Bookshelf - 3.1.1](https://github.com/mcbookshelf/bookshelf/releases/tag/v3.1.1)
> **🩹 Hotfix Release!**
>
> *Patch release for version 3.1.0.*