## 📦 [Bookshelf - 4.2.1](https://github.com/mcbookshelf/bookshelf/releases/tag/v4.2.1) > **🩹 Hotfix!** > > *This is a hotfix for version 4.2.0.* ### `🔦 bs.raycast` - 🐛 **[#586](https://github.com/mcbookshelf/bookshelf/issues/586)** - Prevent entity ID collisions between casts.

## 📦 [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. ### `🎬 bs.animation` - <abbr title="New Modules">🎉</abbr> **[#512](https://github.com/mcbookshelf/bookshelf/pull/512)** - Added a new `bs.animation` module. ### `❤️ bs.health` - <abbr title="Enhancements">⚡</abbr> **[#577](https://github.com/mcbookshelf/bookshelf/pull/577)** - Optimized health computation using new number providers.

## 📦 [Bookshelf - 4.1.1](https://github.com/mcbookshelf/bookshelf/releases/tag/v4.1.1) > **🩹 Hotfix!** > > *This is a hotfix for version 4.1.0.* ### `🎯 bs.hitbox` - <abbr title="Bug Fixes">🐛</abbr> **[#563](https://github.com/mcbookshelf/bookshelf/issues/563)** - Fixed fluid providers ignoring the water in non-waterloggable fluid blocks such as kelp and seagrass. - <abbr title="Documentation">📝</abbr> **[#569](https://github.com/mcbookshelf/bookshelf/pull/569)** - Expanded block tag documentation and added `#bs.hitbox:is_water`, `#bs.hitbox:is_waterlogged`, `#bs.hitbox:is_full_cube_shape`, and `#bs.hitbox:is_full_cube_collision`

## 📦 [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. ### `🗂️ bs.collection` - <abbr title="New Modules">🎉</abbr> **[#510](https://github.com/mcbookshelf/bookshelf/pull/510)** - Added a new `bs.collection` module with 45+ functional programming operations for collections, including map/filter/reduce, set operations, slicing, aggregation, and generation utilities. ### `🎯 bs.hitbox` - <abbr title="New Features">✨</abbr> **[#555](https://github.com/mcbookshelf/bookshelf/pull/555)** - Updated entity hitboxes for Minecraft 26.2. ### `🔦 bs.raycast` - 🐛 **[#556](https://github.com/mcbookshelf/bookshelf/issues/556)** - Fixed `$raycast.prev_entry_distance` and `$raycast.prev_exit_distance` lambda score scaling.

## 📦 [Bookshelf - 4.0.1](https://github.com/mcbookshelf/bookshelf/releases/tag/v4.0.1) > **🩹 Hotfix!** > > *This is a hotfix for version 4.0.0.* ### `🎯 bs.hitbox` - 🐛 **[#543](https://github.com/mcbookshelf/bookshelf/issues/543)** - Fixed glow squid entities hitboxes and the `is_sized` entity type tag. ### `🧣 bs.spline` - 🐛 **[#545](https://github.com/mcbookshelf/bookshelf/issues/545)** - Fixed an issue where 2D and 3D stream functions incorrectly returned 1D results.

## 📦 [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). ### `🔬 bs.dump` - <abbr title="Bug Fix">🐛</abbr> **[#524](https://github.com/mcbookshelf/bookshelf/issues/524)** - Updated `#bs.dump:var` for compatibility with Minecraft 26.1. ### `⛰️ bs.environment` - <abbr title="Bug Fix">🐛</abbr> **[#527](https://github.com/mcbookshelf/bookshelf/issues/527)** - Fixed the different features of the module for Minecraft 26.1. Please, note that between previous Minecraft version and this one, the number of elapsed days has been reset to 0. ### `🌱 bs.generation` - <abbr title="Breaking Changes">⚠️</abbr> **[#509](https://github.com/mcbookshelf/bookshelf/issues/509)** - Complete module rework. Replaced `gen_shape_2d`, `gen_fractal_shape_2d`, and `gen_simplex_shape_2d` with a generic iteration system. - <abbr title="New Features">✨</abbr> **[#509](https://github.com/mcbookshelf/bookshelf/issues/509)** - Added `on_cuboid` for 3D iteration over a cubic region with configurable direction, spacing, and tick limit. - <abbr title="New Features">✨</abbr> **[#509](https://github.com/mcbookshelf/bookshelf/issues/509)** - Added `on_rectangle` for 2D iteration over a rectangular region with configurable direction, spacing, and tick limit. - <abbr title="New Features">✨</abbr> **[#509](https://github.com/mcbookshelf/bookshelf/issues/509)** - Added predefined callbacks: `set_block`, `set_block_type`, `set_random_block`, `fractal_noise_2d`, and `simplex_noise_2d`. - <abbr title="Bug Fix">🐛</abbr> **[#435](https://github.com/mcbookshelf/bookshelf/issues/435)** - Configurable iteration direction now allows accommodating mask offsets when blocks are updated during iteration. ### `🎯 bs.hitbox` - <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> **[#532](https://github.com/mcbookshelf/bookshelf/pull/532)** - Removed fluids from the `intangible` block tag to simplify the use of hitbox providers. - <abbr title="New Features">✨</abbr> **[#532](https://github.com/mcbookshelf/bookshelf/pull/532)** - Updated entity hitboxes for Minecraft 26.1. ### `🏃 bs.move` - <abbr title="Breaking Changes">⚠️</abbr> **[#523](https://github.com/mcbookshelf/bookshelf/issues/523)** - Removed deprecated arguments from previous versions. ### `🔦 bs.raycast` - <abbr title="Breaking Changes">⚠️</abbr> **[#531](https://github.com/mcbookshelf/bookshelf/pull/531)** - Removed deprecated `bs:out raycast` and `bs:lambda raycast` storage data. - <abbr title="Breaking Changes">⚠️</abbr> **[#531](https://github.com/mcbookshelf/bookshelf/pull/531)** - Renamed `on_hit_point` callback to `on_entry_point`. Added new `on_exit_point` callback. - <abbr title="Breaking Changes">⚠️</abbr> **[#531](https://github.com/mcbookshelf/bookshelf/pull/531)** - Renamed `$raycast.distance` to `$raycast.entry_distance`. Added `$raycast.exit_distance`. - <abbr title="Breaking Changes">⚠️</abbr> **[#531](https://github.com/mcbookshelf/bookshelf/pull/531)** - Replaced `$raycast.pierce_distance` (delta) with `$raycast.prev_entry_distance` and `$raycast.prev_exit_distance` (absolute values). Compute deltas manually for more flexibility (e.g., `entry - prev_entry`). - <abbr title="New Features">✨</abbr> **[#531](https://github.com/mcbookshelf/bookshelf/pull/531)** - Added `$raycast.entry_point.[x,y,z]` and `$raycast.exit_point.[x,y,z]` lambda scores for precise hit positions relative to the target. - <abbr title="New Features">✨</abbr> **[#531](https://github.com/mcbookshelf/bookshelf/pull/531)** - Added `$raycast.targeted_block.[x,y,z]` lambda scores for targeted block coordinates. - <abbr title="Documentation">📝</abbr> **[#531](https://github.com/mcbookshelf/bookshelf/pull/531)** - Improved documentation with comprehensive "How to use" section including examples for callbacks, filtering, piercing, and hitbox providers.

## 📦 [Bookshelf - 3.2.2](https://github.com/mcbookshelf/bookshelf/releases/tag/v3.2.2) > **🩹 Hotfix!** > > *This is a hotfix for version 3.2.1.* ### `🎯 bs.hitbox` - 🐛 **[#520](https://github.com/mcbookshelf/bookshelf/pull/520)** - Fixed Nautilus entities hitboxes. - 🐛 **[#519](https://github.com/mcbookshelf/bookshelf/pull/519)** - Fixed fluid hitbox providers for full liquid blocks.

## 📦 [Bookshelf - 3.2.1](https://github.com/mcbookshelf/bookshelf/releases/tag/v3.2.1) > **🩹 Hotfix!** > > *This is a hotfix for version 3.2.0.* ### `🎲 bs.random` - 🐛 **[#514](https://github.com/mcbookshelf/bookshelf/issues/514)** - Fixed `#bs.random:choice` rarely selecting the last option.

## 📦 [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. ### `🎯 bs.environment` - <abbr title="Bug Fix">🐛</abbr> **[#501](https://github.com/mcbookshelf/bookshelf/pull/501)** - Fixed `look_at` functions teleporting the player to the current execution position. ### `🎯 bs.hitbox` - <abbr title="Deprecations">🗑️</abbr> **[#484](https://github.com/mcbookshelf/bookshelf/pull/484)** - Block tag `has_offset` has been **deprecated** and will be removed in a v4.0.0. Please use `has_shape_offset` instead. - <abbr title="Deprecations">🗑️</abbr> **[#484](https://github.com/mcbookshelf/bookshelf/pull/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. - <abbr title="Deprecations">🗑️</abbr> **[#484](https://github.com/mcbookshelf/bookshelf/pull/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. - <abbr title="New Features">✨</abbr> **[#502](https://github.com/mcbookshelf/bookshelf/pull/502)** - Added new 1.21.11 entities. ### `🏃 bs.move` - <abbr title="New Features">✨</abbr> **[#473](https://github.com/mcbookshelf/bookshelf/issues/473)** - Added custom block hitboxes and soft collisions. - <abbr title="Bug Fix">🐛</abbr> **[#487](https://github.com/mcbookshelf/bookshelf/issues/487)** - Prevented false collisions on zero-velocity axes with partial blocks such as slabs. ### `🔦 bs.raycast` - <abbr title="New Features">✨</abbr> **[#473](https://github.com/mcbookshelf/bookshelf/issues/473)** - Added custom block hitboxes and improved multi-layer piercing. ### `👀 bs.view` - <abbr title="Bug Fix">🐛</abbr> **[#498](https://github.com/mcbookshelf/bookshelf/issues/498)** - Fixed `#bs.view:at_block_placement` to match vanilla placement behavior for special blocks such as cauldrons, hoppers, composters, and scaffolding.

## 📦 [Bookshelf - 3.1.1](https://github.com/mcbookshelf/bookshelf/releases/tag/v3.1.1) > **🩹 Hotfix Release!** > > *Patch release for version 3.1.0.* ### `🎯 bs.environment` - 🐛 **[#482](https://github.com/mcbookshelf/bookshelf/issues/482)** - Fixed misplaced test function that caused module load errors.