mcbookshelf · aksiome · Nov 4, 2025 · Nov 8, 2025 · Nov 11, 2025 · Nov 17, 2025
diff --git a/.github/workflows/review.yml b/.github/workflows/review.yml
@@ -3,7 +3,13 @@ name: 📋 Modules Review
 on:
   push:
     branches: ["master"]
+    paths:
+      - "modules/**"
+      - "src/**"
   pull_request:
+    paths:
+      - "modules/**"
+      - "src/**"
   workflow_call:
   workflow_dispatch:
 

diff --git a/.spyglassrc.json b/.spyglassrc.json
@@ -3,11 +3,11 @@
     "useFilePolling": false,
     "exclude": [
       ".*/**",
-      "bookshelf/**",
       "build/**",
       "data/**",
       "docs/**",
-      "release/**"
+      "release/**",
+      "src/**"
     ],
     "mcmetaSummaryOverrides": {
       "commands": {

diff --git a/data/manifest.json b/data/manifest.json
@@ -1801,6 +1801,22 @@
             "minecraft_version": "1.21.4"
           }
         },
+        {
+          "id": "#bs.hitbox:is_fluid",
+          "kind": "block_tag",
+          "documentation": "https://docs.mcbookshelf.dev/en/latest/modules/hitbox.html#blocks",
+          "authors": [
+            "Aksiome"
+          ],
+          "created": {
+            "date": "2025/11/11",
+            "minecraft_version": "1.21.10"
+          },
+          "updated": {
+            "date": "2025/11/11",
+            "minecraft_version": "1.21.10"
+          }
+        },
         {
           "id": "#bs.hitbox:is_full_cube",
           "kind": "block_tag",
@@ -1817,6 +1833,38 @@
             "minecraft_version": "1.21.4"
           }
         },
+        {
+          "id": "#bs.hitbox:is_waterloggable",
+          "kind": "block_tag",
+          "documentation": "https://docs.mcbookshelf.dev/en/latest/modules/hitbox.html#blocks",
+          "authors": [
+            "Aksiome"
+          ],
+          "created": {
+            "date": "2025/11/11",
+            "minecraft_version": "1.21.10"
+          },
+          "updated": {
+            "date": "2025/11/11",
+            "minecraft_version": "1.21.10"
+          }
+        },
+        {
+          "id": "#bs.hitbox:none",
+          "kind": "block_tag",
+          "documentation": "https://docs.mcbookshelf.dev/en/latest/modules/hitbox.html#blocks",
+          "authors": [
+            "Aksiome"
+          ],
+          "created": {
+            "date": "2025/11/11",
+            "minecraft_version": "1.21.10"
+          },
+          "updated": {
+            "date": "2025/11/11",
+            "minecraft_version": "1.21.10"
+          }
+        },
         {
           "id": "#bs.hitbox:intangible",
           "kind": "entity_type_tag",
@@ -1884,7 +1932,7 @@
         {
           "id": "#bs.hitbox:get_block",
           "kind": "function_tag",
-          "documentation": "https://docs.mcbookshelf.dev/en/latest/modules/hitbox.html#get",
+          "documentation": "https://docs.mcbookshelf.dev/en/latest/modules/hitbox.html#get-block",
           "authors": [
             "Aksiome"
           ],
@@ -1932,7 +1980,7 @@
         {
           "id": "#bs.hitbox:get_entity",
           "kind": "function_tag",
-          "documentation": "https://docs.mcbookshelf.dev/en/latest/modules/hitbox.html#get",
+          "documentation": "https://docs.mcbookshelf.dev/en/latest/modules/hitbox.html#get-entity",
           "authors": [
             "Aksiome"
           ],
@@ -3567,8 +3615,8 @@
             "minecraft_version": "1.13"
           },
           "updated": {
-            "date": "2025/10/06",
-            "minecraft_version": "1.21.9"
+            "date": "2025/11/23",
+            "minecraft_version": "1.21.10"
           }
         },
         {
@@ -3584,8 +3632,8 @@
             "minecraft_version": "1.13"
           },
           "updated": {
-            "date": "2025/10/06",
-            "minecraft_version": "1.21.9"
+            "date": "2025/11/23",
+            "minecraft_version": "1.21.10"
           }
         },
         {
@@ -4432,7 +4480,7 @@
         {
           "id": "#bs.raycast:run",
           "kind": "function_tag",
-          "documentation": "https://docs.mcbookshelf.dev/en/latest/modules/raycast.html#run-the-raycast",
+          "documentation": "https://docs.mcbookshelf.dev/en/latest/modules/raycast.html#run",
           "authors": [
             "Aksiome"
           ],
@@ -4441,8 +4489,8 @@
             "minecraft_version": "1.20.2"
           },
           "updated": {
-            "date": "2025/08/27",
-            "minecraft_version": "1.21.8"
+            "date": "2025/11/09",
+            "minecraft_version": "1.21.10"
           }
         }
       ]

diff --git a/docs/changelog/v3.2.0.md b/docs/changelog/v3.2.0.md
@@ -8,6 +8,7 @@ Bookshelf is now based on **Minecraft 1.21.9/10**.
 
 - <abbr title="New Features">✨</abbr> **[#403](https://github.com/mcbookshelf/bookshelf/issues/403)** - Added the `#bs.load:status` function to see loaded modules.
 
+
 ### `🧱 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.).
@@ -18,6 +19,7 @@ Bookshelf is now based on **Minecraft 1.21.9/10**.
 - <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.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.
@@ -27,4 +29,15 @@ Bookshelf is now based on **Minecraft 1.21.9/10**.
 
 ### `🏃 bs.move`
 
-- <abbr title="Bug Fix">🐛</abbr> **[#487](https://github.com/mcbookshelf/bookshelf/issues/487)** - Prevent false collision on zero-velocity axes with partial blocks like slabs
+- <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.
diff --git a/docs/contribute/cli-reference.md b/docs/contribute/cli-reference.md
@@ -1,5 +1,5 @@
 ---
-html_theme.sidebar_secondary.remove: true
+hide-sidebar-secondary: true
 ---
 
 # 📜 CLI Reference

diff --git a/docs/contribute/conventions.md b/docs/contribute/conventions.md
@@ -1,5 +1,5 @@
 ---
-html_theme.sidebar_secondary.remove: true
+hide-sidebar-secondary: true
 ---
 
 # 📖 Conventions

diff --git a/docs/contribute/definitions.md b/docs/contribute/definitions.md
@@ -1,5 +1,5 @@
 ---
-html_theme.sidebar_secondary.remove: true
+hide-sidebar-secondary: true
 ---
 
 # 📘 Definitions

diff --git a/docs/contribute/file-format.md b/docs/contribute/file-format.md
@@ -1,5 +1,5 @@
 ---
-html_theme.sidebar_secondary.remove: true
+hide-sidebar-secondary: true
 ---
 
 # 📄 File Format

diff --git a/docs/contribute/getting-started.md b/docs/contribute/getting-started.md
@@ -1,5 +1,5 @@
 ---
-html_theme.sidebar_secondary.remove: true
+hide-sidebar-secondary: true
 ---
 
 # 🚀 Getting Started

diff --git a/docs/contribute/index.md b/docs/contribute/index.md
@@ -1,5 +1,5 @@
 ---
-html_theme.sidebar_secondary.remove: true
+hide-sidebar-secondary: true
 ---
 
 # 🤝 Contribute

diff --git a/docs/contribute/shared-resources.md b/docs/contribute/shared-resources.md
@@ -1,5 +1,5 @@
 ---
-html_theme.sidebar_secondary.remove: true
+hide-sidebar-secondary: true
 ---
 
 # 🌐 Shared Resources

diff --git a/docs/contribute/special-thanks.md b/docs/contribute/special-thanks.md
@@ -1,5 +1,5 @@
 ---
-html_theme.sidebar_secondary.remove: true
+hide-sidebar-secondary: true
 ---
 
 # ❤️ Special Thanks

diff --git a/docs/contribute/tree-structure.md b/docs/contribute/tree-structure.md
@@ -1,5 +1,5 @@
 ---
-html_theme.sidebar_secondary.remove: true
+hide-sidebar-secondary: true
 ---
 
 # 🌳 Tree Structure

diff --git a/docs/examples/index.md b/docs/examples/index.md
@@ -1,5 +1,5 @@
 ---
-html_theme.sidebar_secondary.remove: true
+hide-sidebar-secondary: true
 ---
 
 # 📖 Examples

diff --git a/docs/index.md b/docs/index.md
@@ -1,5 +1,5 @@
 ---
-html_theme.sidebar_secondary.remove: true
+hide-sidebar-secondary: true
 sd_hide_title: true
 ---