ВЕРСИИ (26)

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

## 📦 Bookshelf - 2.2.2 ### 🐛 Fixes - **[#293](https://github.com/Gunivers/Bookshelf/issues/293)** Entity `creaking_transient` was removed from Minecraft 1.21.4, causing `bs.hitbox` to stop working for entities.

## 📦 Bookshelf - 2.2.1 Bookshelf is now based on **Minecraft 1.21.4**. ### 🐛 Fixes - **[#288](https://github.com/Gunivers/Bookshelf/issues/288)** Fix `bs.move` collisions. - **[#290](https://github.com/Gunivers/Bookshelf/issues/290)** Add missing blocks in `bs.block` registries.

## 📦 Bookshelf - 2.2.0 **🪐 The dimensional update!** *This release features new modules for random distribution and terrain generation, refinements to existing modules, performance enhancements, and minor bug resolutions. Additionally, this update aims to ensure all functions work seamlessly across all dimensions.* Bookshelf is now based on **Minecraft 1.21.3**. ### 🎉 Added modules - **[#1](https://github.com/mcbookshelf/Bookshelf/issues/1)** / **[#220](https://github.com/mcbookshelf/Bookshelf/issues/220)** Added the `bs.random` module, which includes: - Random distributions: uniform, binomial, geometric, and Poisson. - Noise generation functions: white, simplex, and fractal. - Random selection of an element from a list. - **[#6](https://github.com/mcbookshelf/Bookshelf/issues/6)** Added the `bs.generate` module for terrain generation. Currently supports 2D shape algorithms, enabling texture and heightmap-based terrain generation. - **[#193](https://github.com/mcbookshelf/Bookshelf/issues/193)** Added the `bs.interaction` module, which proposes interactions to listen to different players' events: left click, right click, hover (enter, leave and continuous). ### ✨ Added features - **[#222](https://github.com/mcbookshelf/Bookshelf/issues/222)** Added `#bs.block:fill_random` for filling regions with randomly selected blocks. - **[#258](https://github.com/mcbookshelf/Bookshelf/issues/258)** Added `#bs.block:emit_block_particle` to emit block particles in specific locations. - **[#245](https://github.com/mcbookshelf/Bookshelf/issues/245)** Added `piercing` and callback options to `#bs.raycast:run`. - **[#203](https://github.com/mcbookshelf/Bookshelf/issues/203)** Added `#bs.hitbox:is_entity_in_block` and `#bs.hitbox:is_entity_in_blocks` to verify if an entity is within a block. - **[#233](https://github.com/mcbookshelf/Bookshelf/issues/233)** Introduced new link management functions: - `#bs.link:remove_link` to remove specific links. - `#bs.link:as_children`, `#bs.link:as_parent`, `#bs.link:at_children`, and `#bs.link:at_parent` to handle parent-child link relationships. - **[#171](https://github.com/mcbookshelf/Bookshelf/issues/171)** Added logging functions `#bs.log:history` and `#bs.log:clear_history` for viewing and clearing log history. ### 🔁 Tweaks - **[#251](https://github.com/mcbookshelf/Bookshelf/issues/251)** Enhanced `bs.block` fill functions to accept `from` and `to` inputs as either `[x, y, z]` lists or as stringified coordinates (e.g., `~ ~5 25`). - **[#247](https://github.com/mcbookshelf/Bookshelf/pull/247)** Improved the default `bs.log` format for clarity. - **[#252](https://github.com/mcbookshelf/Bookshelf/pull/252)** Optimized `bs.hitbox` module for improved performance. - **[#265](https://github.com/mcbookshelf/Bookshelf/pull/265)** Optimized `bs.schedule` module for improved performance. - **[#265](https://github.com/mcbookshelf/Bookshelf/pull/265)** Enabled `bs.move` module to function effectively at higher coordinate ranges. Collision detection has also been improved and should be more robust. - **[#265](https://github.com/mcbookshelf/Bookshelf/pull/265)** Load tags do not load modules in isolation anymore. This can now be done using the `exclusive_load` tag. - **[#276](https://github.com/mcbookshelf/Bookshelf/pull/276)** Add new hitboxes (new babies and salmon variants). ### 🐛 Fixes - **[#254](https://github.com/mcbookshelf/Bookshelf/issues/254)** Resolved execution loop interruptions caused by `#bs.schedule:schedule` callbacks. - **[#243](https://github.com/mcbookshelf/Bookshelf/issues/243)** Fixed unload functions for `bs.health` and `bs.move`. - **[#264](https://github.com/mcbookshelf/Bookshelf/issues/264)** Resolved compatibility issues with the schedule module outside the overworld. - **[#255](https://github.com/mcbookshelf/Bookshelf/issues/255)** Fixed `bs.move` local velocity collisions. - **[#262](https://github.com/mcbookshelf/Bookshelf/pull/262)** Resolved collision issues with paintings for `bs.raycast` and `bs.move`. - **[#256](https://github.com/mcbookshelf/Bookshelf/issues/256)** Fixed XP progress boundary issues at 0% and 100%. - **[#265](https://github.com/mcbookshelf/Bookshelf/pull/265)** Corrected hitbox for player in spectator mode. - **[#270](https://github.com/mcbookshelf/Bookshelf/issues/270)** Enabled all modules to function across any dimension.

## 📦 Bookshelf - 2.1.1 ### 🔁 Tweaks - ([238](https://github.com/mcbookshelf/Bookshelf/pull/238)) Load tags now load modules in isolation. - ([237](https://github.com/mcbookshelf/Bookshelf/pull/237)) Enhanced speed of `bs.block` module. - ([218](https://github.com/mcbookshelf/Bookshelf/pull/218)) Enhanced speed of factorial function in `bs.math`. ### 🐛 Fixes - ([236](https://github.com/mcbookshelf/Bookshelf/issues/236)) Fix `bs.block`, `bs.id` and `bs.math` load functions. - ([235](https://github.com/mcbookshelf/Bookshelf/issues/235)) Fix `bs.block` inputs that required extra escaping. ### 📄 Documentation - ([215](https://github.com/mcbookshelf/Bookshelf/issues/215)) There is now documentation about the documentation (kind of metadocumentation?).

## 📦 Bookshelf - 2.1.0 Bookshelf is now based on **Minecraft 1.21**. ### 🎉 Addition - ([187](https://github.com/mcbookshelf/Bookshelf/issues/187)) Add `#bs.block:map_type` and `#bs.block:mix_type` functions. ### 🐛 Fixes - ([211](https://github.com/mcbookshelf/Bookshelf/pull/211)) Add missing help function tag in `bs.link`. - ([211](https://github.com/mcbookshelf/Bookshelf/pull/211)) Add missing help function tag in `bs.vector`. - ([211](https://github.com/mcbookshelf/Bookshelf/pull/211)) Add missing help function tag in `bs.xp`. ### 📄 Documentation - ([206](https://github.com/mcbookshelf/Bookshelf/issues/206)) Add new related datapacks and mods. - ([208](https://github.com/mcbookshelf/Bookshelf/issues/208)) Add missing documentation for feature `bs.position:get_pos_and_rot`. - ([208](https://github.com/mcbookshelf/Bookshelf/issues/208)) Add missing documentation for feature `bs.position:set_pos_and_rot`. - ([208](https://github.com/mcbookshelf/Bookshelf/issues/208)) Add missing documentation for feature `bs.position:add_pos_and_rot`. ### 📋 Conventions - ([#200](https://github.com/mcbookshelf/Bookshelf/issues/200)) We throw away the old feature function header to a new one with only the licence. This header is now mandatory for all functions. All the metadata that was present inside the old one have been moved to the feature function tag. - ([#52](https://github.com/mcbookshelf/Bookshelf/issues/52), [#175](https://github.com/mcbookshelf/Bookshelf/issues/175)) Each module has now its own metadata that should be specified manually. The metadata of the features and modules are used to generate more metadata, including the dependencies. These metadata can be used by bots like the incomming Bookshelf Manager. More information [here](https://docs.mcbookshelf.dev/en/latest/contribute/metadata.html). ### ⚙️ Github and CI - Added a template for pull requests. - Added templates for issues. - ([#199](https://github.com/mcbookshelf/Bookshelf/pull/199)) The different metadata (the manually specified one and the generated one) are now automatically verified at each commit inside a pull request. This prevents them from being forgotten. More information [here](https://docs.mcbookshelf.dev/en/latest/contribute/index.html).

# 📦 Bookshelf - 2.0.0 This new version is filled with breaking changes. Since maintaining a list of those became unrealistic, the following changelog only highlights a selection of tweaks and new functionalities. ## 🎉 Addition - There is now a changelog! - Added player health manipulation. - Added precise collisions (move, raycast and view). - Added float manipulation (frexp and ldexp). - Added a new hitbox module. - Added a new raycast module. - Added a new sidebar module. ## 🔁 Tweaks - The project has a new fresh identity: Bookshelf. - Every module has been reworked for improved accuracy, performance, and/or simplicity. - Renamed almost everything (scores, objectives, functions, ...). - Many functions now utilize macros, storage, or fake scores instead of objectives. - Removed the core module. The library no longer requires a base module. - Removed outdated modules (cache, item, mapedit, and memory). - Merged the location and orientation modules into a new position module. - Bitwise operations have been moved out of the math module into a separate module. - Enhanced the accuracy of the move and view modules due to their rework and the addition of the new hitbox module. - The schedule module now maintains the current execution context. ## 🐛 Bug fixes - Who knows at this point 🤷‍♂️, almost no legacy code remains...