ВЕРСИИ (14)

## 📦 [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.

## 📦 [Bookshelf - 3.1.0](https://github.com/mcbookshelf/bookshelf/releases/tag/v3.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` - <abbr title="Bug Fix">🐛</abbr> **[#469](https://github.com/mcbookshelf/bookshelf/issues/469)** - Fixed missing `execute in minecraft:overworld` when running location-based loot tables. ### `🔬 bs.dump` - <abbr title="Bug Fix">🐛</abbr> **[#441](https://github.com/mcbookshelf/bookshelf/issues/441)** - Fixed `#bs.dump:var` incorrectly appending `undefined` to output. ### `⛰️ bs.environment` - <abbr title="New Feature">✨</abbr> **[#14](https://github.com/mcbookshelf/bookshelf/issues/14)** - Added `#bs.environment:get_sun_angle` to get the sun's angle at a specific time on the Y axis relative to the horizon, in degrees. - <abbr title="New Feature">✨</abbr> **[#14](https://github.com/mcbookshelf/bookshelf/issues/14)** - Added `#bs.environment:get_moon_angle`to get the moon's angle at a specific time on the Y axis relative to the horizon, in degrees. - <abbr title="New Feature">✨</abbr> **[#14](https://github.com/mcbookshelf/bookshelf/issues/14)** - Added `#bs.environment:get_current_sun_angle` to get the current sun's angle on the Y axis relative to the horizon, in degrees. - <abbr title="New Feature">✨</abbr> **[#14](https://github.com/mcbookshelf/bookshelf/issues/14)** - Added `#bs.environment:get_current_moon_angle` to get the current moon's angle on the Y axis relative to the horizon, in degrees. - <abbr title="New Feature">✨</abbr> **[#14](https://github.com/mcbookshelf/bookshelf/issues/14)** - Added `#bs.environment:get_moon_phase` to get the current moon phase as a string identifier following Minecraft's 8-day lunar cycle. - <abbr title="New Feature">✨</abbr> **[#14](https://github.com/mcbookshelf/bookshelf/issues/14)** - Added `#bs.environment:look_at_sun` to orient the executing entity to look at the sun. - <abbr title="New Feature">✨</abbr> **[#14](https://github.com/mcbookshelf/bookshelf/issues/14)** - Added `#bs.environment:look_at_moon` to orient the executing entity to look at the moon. - <abbr title="New Feature">✨</abbr> **[#475](https://github.com/mcbookshelf/bookshelf/issues/475)** - Added time-based predicates: `is_day_time`, `is_night_time`, `is_sunrise_time`, `is_sunset_time` for determining current time of day. - <abbr title="New Feature">✨</abbr> **[#475](https://github.com/mcbookshelf/bookshelf/issues/475)** - Added villagers behavior predicates: `is_villager_working_time`, `is_villager_socializing_time`, `is_villager_sleeping_time` for detecting villager activity phases. - <abbr title="New Feature">✨</abbr> **[#475](https://github.com/mcbookshelf/bookshelf/issues/475)** - Added beds usage predicate: `is_bed_time` for determining when players can use beds based on weather and time conditions. - <abbr title="New Feature">✨</abbr> **[#475](https://github.com/mcbookshelf/bookshelf/issues/475)** - Added mobs behavior predicates: `is_undead_burning_time`, `is_monster_spawning_time` for detecting mob behavior condition according to weather and time. - <abbr title="New Feature">✨</abbr> **[#475](https://github.com/mcbookshelf/bookshelf/issues/475)** - Added bees behavior predicate: `is_bee_sleeping_time` for detecting time when bees are in their nests/hives. - <abbr title="New Feature">✨</abbr> **[#475](https://github.com/mcbookshelf/bookshelf/issues/475)** - Added creakings spawning predicate: `is_creaking_spawn_time` for detecting time when creakings can spawn. ### `❤️ bs.health` - <abbr title="Bug Fix">🐛</abbr> **[#466](https://github.com/mcbookshelf/bookshelf/issues/466)** - Fixed a bug where healing on Paper servers always set players' health to maximum. ### `🎯 bs.hitbox` - <abbr title="New Feature">✨</abbr> **[#465](https://github.com/mcbookshelf/bookshelf/pull/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. ### `🖱️ bs.interaction` - <abbr title="Bug Fix">🐛</abbr> **[#463](https://github.com/mcbookshelf/bookshelf/issues/463)** - Fixed an issue where left/right click events could incorrectly target previously clicked entities instead of the current one. ### `🏃 bs.move` - <abbr title="New Feature">✨</abbr> **[#465](https://github.com/mcbookshelf/bookshelf/pull/465)** - Optimized bounding box computation for moving entities and added support for baked and custom hitboxes. ### `🧭 bs.position` - <abbr title="Bug Fix">🐛</abbr> **[#455](https://github.com/mcbookshelf/bookshelf/issues/455)** – Replaced `/rotate` with `/tp` in `bs.position` to fix jitter and momentum issues. ### `🎲 bs.random` - <abbr title="New Feature">✨</abbr> **[#286](https://github.com/mcbookshelf/bookshelf/issues/286)** - Added support for **normal distribution** generation to `bs.random` module. - <abbr title="Bug Fix">🐛</abbr> **[#469](https://github.com/mcbookshelf/bookshelf/issues/469)** - Fixed missing `execute in minecraft:overworld` when running location-based loot tables. ### `🔦 bs.raycast` - <abbr title="New Feature">✨</abbr> **[#465](https://github.com/mcbookshelf/bookshelf/pull/465)** - Added support for baked and custom entity hitboxes. - <abbr title="New Feature">✨</abbr> **[#445](https://github.com/mcbookshelf/bookshelf/issues/445)** - `#bs.raycast:run` now computes all lambda data before invoking callbacks. - <abbr title="Bug Fix">🐛</abbr> **[#457](https://github.com/mcbookshelf/bookshelf/issues/457)** - Fixed raycasts not stopping at the nearest hit when detecting both blocks and entities. ### `🧣 bs.spline` - <abbr title="New Feature">✨</abbr> **[#417](https://github.com/mcbookshelf/bookshelf/issues/417)** - Added full support for **linear splines**.

## 📦 [Bookshelf - 3.0.2](https://github.com/mcbookshelf/bookshelf/releases/tag/v3.0.2) > **🩹 A Quick Hotfix!** > > *This is a hotfix for version 3.0.1.* - <abbr title="Bug Fix">🐛</abbr>**[#431](https://github.com/mcbookshelf/bookshelf/pull/431)** - Improve compatibility by using deflate instead of bzip2 for compression. ### `❤️ bs.health` - <abbr title="Bug Fix">🐛</abbr> **[#428](https://github.com/mcbookshelf/bookshelf/pull/428)** - Ensure player health updates correctly when using percentage-based max health attributes. ### `🔬 bs.dump` - <abbr title="Bug Fix">🐛</abbr> **[#432](https://github.com/mcbookshelf/bookshelf/issues/432)** - Fix dump failing on compounds with single-letter keys.

## 📦 [Bookshelf - 3.0.1](https://github.com/mcbookshelf/bookshelf/releases/tag/v3.0.1) > **🩹 Simple Hotfix!** > > *This is a hotfix for version 3.0.0.* - <abbr title="Documentation">📝</abbr> **[#314](https://github.com/mcbookshelf/bookshelf/issues/314)** - Add the Lifestring example, linking players' health using the `bs.health` module. ### `❤️ bs.health` - <abbr title="Bug Fix">🐛</abbr> **[#410](https://github.com/mcbookshelf/bookshelf/issues/410)** - Ensure player health updates consistently. - <abbr title="Bug Fix">🐛</abbr> **[#426](https://github.com/mcbookshelf/bookshelf/pull/426)** – Players are now correctly killed when their health drops below 0, unless they are in Creative or Spectator mode. ### `🧣 bs.spline` - <abbr title="Bug Fix">🐛</abbr> **[#423](https://github.com/mcbookshelf/bookshelf/pull/423)** - Fix module tag incorrectly set to default, now set to runtime to ensure the module is properly included in bundles. - <abbr title="Bug Fix">🐛</abbr> **[#412](https://github.com/mcbookshelf/bookshelf/issues/412)** - Fix Hermite spline tangents to use absolute space instead of relative. - <abbr title="Enhancements">⚡</abbr> **[#409](https://github.com/mcbookshelf/bookshelf/issues/409)** - Improve performance of sampling and streaming functions. ### `🔠 bs.string` - <abbr title="Bug Fix">🐛</abbr> **[#423](https://github.com/mcbookshelf/bookshelf/pull/423)** - Fix module tag incorrectly set to default, now set to runtime to ensure the module is properly included in bundles. ### `👀 bs.view` - <abbr title="Bug Fix">🐛</abbr> **[#424](https://github.com/mcbookshelf/bookshelf/issues/424)** - Fix `#bs.view:at_block_placement` that was incorrectly using hit normal data from the previous call instead of the current one.

## 📦 [Bookshelf - 3.0.0](https://github.com/mcbookshelf/bookshelf/releases/tag/v3.0.0) > **🚂 The Pipeline Update!** > > *This release overhauls the project structure with Beet, focusing on modularity and isolation of each module. It also introduces a new version loader that resolves conflicts between multiple versions.* > > **⚠️ BREAKING CHANGES**: This new version has a few breaking changes! Bookshelf is now based on **Minecraft 1.21.5**. Each module of Bookshelf is now shipped as a separate datapack for people wanting to use only a single module. Introduced bundles to better group modules, replacing **Bookshelf** and **Bookshelf Dev** datapacks: **Bookshelf Runtime**, **Bookshelf Dev**, **Bookshelf Prefabs**, and **Bookshelf Suite**. - <abbr title="Breaking Changes">⚠️</abbr> **[#281](https://github.com/mcbookshelf/bookshelf/issues/281)** - Merged the `bs.biome` and `bs.weather` modules into a single `bs.environment` module. - <abbr title="New Bundles">📦</abbr> **[#323](https://github.com/mcbookshelf/bookshelf/pull/323)** - Introduced bundles to better group modules, replacing **Bookshelf** and **Bookshelf Dev** datapacks: **Bookshelf Runtime**, **Bookshelf Dev**, **Bookshelf Prefabs**, and **Bookshelf Suite**. - <abbr title="New Modules">🎉</abbr> **[#272](https://github.com/mcbookshelf/bookshelf/issues/272)** - Added an automatically generated `bs.load` module, removing the need for manual `load` and `unload` tags. Bookshelf now also uses **LanternLoad**. - <abbr title="Enhancements">⚡</abbr> **[#285](https://github.com/mcbookshelf/bookshelf/pull/285)** - Removed the need for `__help__` functions and `help` tags. These are now generated. - <abbr title="Documentation">📝</abbr> **[#285](https://github.com/mcbookshelf/bookshelf/pull/285)** - Migrated the documentation to **mcbookshelf.dev** and reworked the contribution guide to explain the new **Beet** pipeline. - <abbr title="GitHub & CI/CD">⚙️</abbr> **[#285](https://github.com/mcbookshelf/bookshelf/pull/285)** - Created a GitHub organization and transitioned from the **Jupyter Notebook** to **Beet**. Updated the metadata format, added new issue templates, and introduced workflows for automatic deployment to **Modrinth** and **Smithed**. Modules now also require a `README.md` and a `pack.png`. - <abbr title="Download">📥</abbr> **[#333](https://github.com/mcbookshelf/bookshelf/issues/333)** - Bookshelf now has its own [download manager](https://mcbookshelf.dev), allowing users to select modules along with their dependencies and create custom bundles. - <abbr title="Download">📥</abbr> **[#336](https://github.com/mcbookshelf/bookshelf/issues/336)** - Bookshelf is now available on **PyPI** for use with the **Beet** toolchain. ### `🧱 bs.block` - <abbr title="Breaking Changes">⚠️</abbr> **[#375](https://github.com/mcbookshelf/bookshelf/pull/375)** - Changed `get_block` and `get_type` to only return existing data. Empty strings for state or NBT are no longer possible; if absent, the field is omitted instead. - <abbr title="New Features">✨</abbr> **[#279](https://github.com/mcbookshelf/bookshelf/issues/279)** - Introduced `play_block_sound`, a function for playing block sounds. - <abbr title="Bug Fix">🐛</abbr> **[#320](https://github.com/mcbookshelf/bookshelf/issues/320)** - Fixed functions that were previously unusable outside the Overworld. - <abbr title="Enhancements">⚡</abbr> **[#375](https://github.com/mcbookshelf/bookshelf/pull/375)** - Added default values to `emit_block_particle` and new parameters (`mode`, `viewers`). - <abbr title="Enhancements">⚡</abbr> **[#363](https://github.com/mcbookshelf/bookshelf/issues/363)** - Enhanced `fill_block`, `fill_type`, `fill_random`, `set_block`, and `set_type` to accept `strict` as a `mode` parameter, allowing control over whether the operation triggers block updates. - <abbr title="Enhancements">⚡</abbr> **[#349](https://github.com/mcbookshelf/bookshelf/issues/349)** - Added the `on_finished` argument to fill operations. If specified, the provided command runs automatically when the operation completes. - <abbr title="Enhancements">⚡</abbr> **[#287](https://github.com/mcbookshelf/bookshelf/issues/287)** - Updated `replace_type` to return whether a type was found and replaced. ### `🧱 bs.environment` - <abbr title="Bug Fix">🐛</abbr> **[#320](https://github.com/mcbookshelf/bookshelf/issues/320)** - Fixed functions that were previously unusable outside the Overworld. ### `🌱 bs.generation` - <abbr title="Breaking Changes">⚠️</abbr> **[#296](https://github.com/mcbookshelf/bookshelf/issues/296)** - Renamed the `bs.generate` module to `bs.generation`. - <abbr title="Breaking Changes">⚠️</abbr> **[#282](https://github.com/mcbookshelf/bookshelf/issues/282)** - Renamed scores used in callbacks to use the new `bs.lambda` objective. - <abbr title="Breaking Changes">⚠️</abbr> **[#296](https://github.com/mcbookshelf/bookshelf/issues/296)** - Renamed the `bs.generate:fractal_shape_2d` function to `bs.generation:gen_fractal_shape_2d`. - <abbr title="Breaking Changes">⚠️</abbr> **[#296](https://github.com/mcbookshelf/bookshelf/issues/296)** - Renamed the `bs.generate:shape_2d` function to `bs.generation:gen_shape_2d`. - <abbr title="Breaking Changes">⚠️</abbr> **[#296](https://github.com/mcbookshelf/bookshelf/issues/296)** - Renamed the `bs.generate:simplex_shape_2d` function to `bs.generation:gen_simplex_shape_2d`. ### `❤️ bs.health` - <abbr title="Breaking Changes">⚠️</abbr> **[#396](https://github.com/mcbookshelf/bookshelf/issues/396)** - Updated the `get_max_health` function to only return the base value, excluding all modifiers. - <abbr title="Bug Fix">🐛</abbr> **[#348](https://github.com/mcbookshelf/bookshelf/pull/348)** - Fixed an issue where running the heal command in a tick loop caused empty hearts to visually disappear. ### `🎯 bs.hitbox` - <abbr title="Breaking Changes">⚠️</abbr> **[#318](https://github.com/mcbookshelf/bookshelf/issues/318)** - Introduced `collision_shape` for block hitboxes and renamed `shape` to `interaction_shape`. - <abbr title="Breaking Changes">⚠️</abbr> **[#318](https://github.com/mcbookshelf/bookshelf/issues/318)** - Removed `is_in_block` and `is_entity_in_block(s)` functions in favor of `is_in_block_<collision|interaction>` and `is_entity_in_block(s)_<collision|interaction>`. - <abbr title="Breaking Changes">⚠️</abbr> **[#297](https://github.com/mcbookshelf/bookshelf/issues/297)** - Replaced the `is_composite` block tag with `is_full_cube` for better clarity. - <abbr title="New Features">✨</abbr> **[#299](https://github.com/mcbookshelf/bookshelf/pull/299)** - Moved the `#bs.hitbox:can_pass_through` block tag from the move module and documented it. - <abbr title="New Features">✨</abbr> **[#285](https://github.com/mcbookshelf/bookshelf/pull/285)** - Introduced the `#bs.hitbox:is_sized` tag for better hitbox management. - <abbr title="Bug Fix">🐛</abbr> **[#320](https://github.com/mcbookshelf/bookshelf/issues/320)** - Fixed functions that were previously unusable outside the Overworld. ### `🖱️ bs.interaction` - <abbr title="New Features">✨</abbr> **[#300](https://github.com/mcbookshelf/bookshelf/issues/300)** - Added `bs.interaction.hovered` tag to check if an interaction is currently hovered. ### `📄 bs.log` - <abbr title="Breaking Changes">⚠️</abbr> **[#369](https://github.com/mcbookshelf/bookshelf/issues/369)** - Migrated the `bs.log` module to use SNBT instead of JSON for log messages. ### `🏃 bs.move` - <abbr title="Breaking Changes">⚠️</abbr> **[#282](https://github.com/mcbookshelf/bookshelf/issues/282)** - Updated `on_collison` callback: scores now use the `bs.lambda` objective, and the input requires a full command instead of a function path. Additionally, `on_collision/*` functions have been renamed to `callback/*`. - <abbr title="New Features">✨</abbr> **[#318](https://github.com/mcbookshelf/bookshelf/issues/318)** - Added optional `hitbox_shape` parameter to `apply_vel` functions, selecting between `collision` and `interaction` hitboxes. - <abbr title="New Features">✨</abbr> **[#298](https://github.com/mcbookshelf/bookshelf/issues/298)** - Predicate `bs.move:has_vel` is now properly documented. hitbox_shape - <abbr title="Bug Fix">🐛</abbr> **[#316](https://github.com/mcbookshelf/bookshelf/issues/316)** - Fixed entities clipping into blocks during collision resolution. ### `🔦 bs.raycast` - <abbr title="Enhancements">⚡</abbr> **[#358](https://github.com/mcbookshelf/bookshelf/issues/358)** - Added additional lambda values to callbacks. - <abbr title="Enhancements">⚡</abbr> **[#318](https://github.com/mcbookshelf/bookshelf/issues/318)** - Added the `hitbox_shape` argument to `run`, allowing selection between `collision` and `interaction` shapes. ### `⏲️ bs.schedule` - <abbr title="Breaking Changes">⚠️</abbr> **[#282](https://github.com/mcbookshelf/bookshelf/issues/282)** - Changed the `schedule` function signature for better consistency with others that use callbacks. ### `📰 bs.sidebar` - <abbr title="Enhancements">⚡</abbr> **[#367](https://github.com/mcbookshelf/bookshelf/issues/367)** - Optimized the module for the 1.21.5 version of Minecraft. - <abbr title="Bug Fix">🐛</abbr> **[#301](https://github.com/mcbookshelf/bookshelf/pull/301)** - Fixed the issue where `bs.sidebar:create` was not functioning correctly. ### `🔠 bs.string` - <abbr title="New Modules">🎉</abbr> **[#283](https://github.com/mcbookshelf/bookshelf/pull/283)** - Added a new `bs.string` module for managing strings. ### `🧣 bs.spline` - <abbr title="New Modules">🎉</abbr> **[#241](https://github.com/mcbookshelf/bookshelf/issues/241)** - Added a new `bs.spline` module for working with splines. ### `⌚ bs.time` - <abbr title="Bug Fix">🐛</abbr> **[#379](https://github.com/mcbookshelf/bookshelf/issues/379)** - Fixed get time for the 1.21.5 version of Minecraft. ### `👀 bs.view` - <abbr title="New Features">✨</abbr> **[#318](https://github.com/mcbookshelf/bookshelf/issues/318)** - Added the `hitbox_shape` argument to raycast related functions, allowing selection between `collision` and `interaction` shapes. - <abbr title="New Features">✨</abbr> **[#299](https://github.com/mcbookshelf/bookshelf/pull/299)** - Block tag `can_see_through` is now properly documented. - <abbr title="Bug Fix">🐛</abbr> **[#319](https://github.com/mcbookshelf/bookshelf/issues/319)** - Fixed `can_see_ata` max distance computation.