Docs update: Preview 1.21.120.22

destruc7i0n · destruc7i0n · commit d00c4379202b · 2025-09-16T16:26:41.000Z
diff --git a/1.21.0.0/1.21.120.22/Addons.html b/1.21.0.0/1.21.120.22/Addons.html
@@ -1,4 +1,4 @@
-<h1>ADDONS DOCUMENTATION </br>Version: 1.21.120.20</h1>
+<h1>ADDONS DOCUMENTATION </h1>
 This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>
 <h2><p id="Index">Index</p></h2>
 <table border="1">
diff --git a/1.21.0.0/1.21.120.22/Animations.html b/1.21.0.0/1.21.120.22/Animations.html
@@ -1,4 +1,4 @@
-<h1>ANIMATIONS DOCUMENTATION </br>Version: 1.21.120.20</h1>
+<h1>ANIMATIONS DOCUMENTATION </h1>
 This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>
 <h2><p id="Index">Index</p></h2>
 <table border="1">
diff --git a/1.21.0.0/1.21.120.22/Biomes.html b/1.21.0.0/1.21.120.22/Biomes.html
@@ -1,4 +1,4 @@
-<h1>BIOMES DOCUMENTATION </br>Version: 1.21.120.20</h1>
+<h1>BIOMES DOCUMENTATION </h1>
 This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>
 <h2><p id="Index">Index</p></h2>
 <table border="1">
diff --git a/1.21.0.0/1.21.120.22/Blocks.html b/1.21.0.0/1.21.120.22/Blocks.html
@@ -1,4 +1,4 @@
-<h1>BLOCKS DOCUMENTATION </br>Version: 1.21.120.20</h1>
+<h1>BLOCKS DOCUMENTATION </h1>
 This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>
 <h2><p id="Index">Index</p></h2>
 <table border="1">
@@ -395,6 +395,16 @@ <h3><p id="sticky">sticky</p></h3>
 </table>
 <a href="#Index">Back to top</a><br><br>
 
+</td>
+</tr>
+<tr>
+<td style="border-style:solid; border-width:3; padding:7px">minecraft:precipitation_interactions</td>
+<td style="border-style:solid; border-width:3; padding:7px">JSON Object</td>
+<td style="border-style:solid; border-width:3; padding:7px"></td>
+<td style="border-style:solid; border-width:3; padding:7px">Component that determines how the block will interact with rain and snow</br><h3><p id="precipitation_behavior">precipitation_behavior</p></h3>
+
+What behavior should the block have. Three possible values: obstruct_rain, obstruct_rain_accumulate_snow and none</br><a href="#Index">Back to top</a><br><br>
+
 </td>
 </tr>
 <tr>
diff --git a/1.21.0.0/1.21.120.22/Client Biomes.html b/1.21.0.0/1.21.120.22/Client Biomes.html
@@ -1,4 +1,4 @@
-<h1>CLIENT BIOMES DOCUMENTATION </br>Version: 1.21.120.20</h1>
+<h1>CLIENT BIOMES DOCUMENTATION </h1>
 This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>
 <h2><p id="Index">Index</p></h2>
 <table border="1">
diff --git a/1.21.0.0/1.21.120.22/Entities.html b/1.21.0.0/1.21.120.22/Entities.html
diff --git a/1.21.0.0/1.21.120.22/Entity Events.html b/1.21.0.0/1.21.120.22/Entity Events.html
@@ -1,4 +1,4 @@
-<h1>ENTITY EVENTS DOCUMENTATION </br>Version: 1.21.120.20</h1>
+<h1>ENTITY EVENTS DOCUMENTATION </h1>
 This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>
 <h2><p id="Index">Index</p></h2>
 <table border="1">
diff --git a/1.21.0.0/1.21.120.22/Entity Timeline Events.html b/1.21.0.0/1.21.120.22/Entity Timeline Events.html
@@ -1,4 +1,4 @@
-<h1>ENTITY TIMELINE EVENTS DOCUMENTATION </br>Version: 1.21.120.20</h1>
+<h1>ENTITY TIMELINE EVENTS DOCUMENTATION </h1>
 This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>
 <h2><p id="Index">Index</p></h2>
 <table border="1">
diff --git a/1.21.0.0/1.21.120.22/Features.html b/1.21.0.0/1.21.120.22/Features.html
@@ -1,4 +1,4 @@
-<h1>FEATURES DOCUMENTATION </br>Version: 1.21.120.20</h1>
+<h1>FEATURES DOCUMENTATION </h1>
 This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>
 <h2><p id="Index">Index</p></h2>
 <table border="1">
diff --git a/1.21.0.0/1.21.120.22/Fogs.html b/1.21.0.0/1.21.120.22/Fogs.html
@@ -1,4 +1,4 @@
-<h1>FOGS DOCUMENTATION </br>Version: 1.21.120.20</h1>
+<h1>FOGS DOCUMENTATION </h1>
 This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>
 <h2><p id="Index">Index</p></h2>
 <table border="1">
diff --git a/1.21.0.0/1.21.120.22/Item.html b/1.21.0.0/1.21.120.22/Item.html
@@ -1,4 +1,4 @@
-<h1>ITEM DOCUMENTATION </br>Version: 1.21.120.20</h1>
+<h1>ITEM DOCUMENTATION </h1>
 This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>
 <h2><p id="Index">Index</p></h2>
 <table border="1">
diff --git a/1.21.0.0/1.21.120.22/Molang.html b/1.21.0.0/1.21.120.22/Molang.html
@@ -1,4 +1,4 @@
-<h1>MOLANG DOCUMENTATION </br>Version: 1.21.120.20</h1>
+<h1>MOLANG DOCUMENTATION </h1>
 This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>
 <h2><p id="Index">Index</p></h2>
 <table border="1">
@@ -967,6 +967,10 @@ <h2></h2>
 <td style="border-style:solid; border-width:3; padding:7px">Returns the time in *seconds* of the average frame time over the last 'n' frames.  If an argument is passed, it is assumed to be the number of frames in the past that you wish to query.  'query.average_frame_time' (or the equivalent 'query.average_frame_time(0)') will return the frame time of the frame before the current one.  'query.average_frame_time(1)' will return the average frame time of the previous two frames.  Currently we store the history of the last 30 frames, although note that this may change in the future.  Asking for more frames will result in only sampling the number of frames stored.</br></td>
 </tr>
 <tr>
+<td style="border-style:solid; border-width:3; padding:7px">query.base_swing_duration</td>
+<td style="border-style:solid; border-width:3; padding:7px">Returns the duration of the mob's swing/attack animation, determined by the carried item and unmodified by effects applied on the mob. To access the swing/attack animation progress, use "variable.attack_time" instead.</br></td>
+</tr>
+<tr>
 <td style="border-style:solid; border-width:3; padding:7px">query.block_face</td>
 <td style="border-style:solid; border-width:3; padding:7px">Returns the block face for this (only valid for certain triggers such as placing blocks, or interacting with block) (Down=0.0, Up=1.0, North=2.0, South=3.0, West=4.0, East=5.0, Undefined=6.0).</br></td>
 </tr>
@@ -1839,6 +1843,10 @@ <h2></h2>
 <td style="border-style:solid; border-width:3; padding:7px">Returns the current walk speed of the entity modified by status flags such as is_baby or on_fire.</br></td>
 </tr>
 <tr>
+<td style="border-style:solid; border-width:3; padding:7px">query.modified_swing_duration</td>
+<td style="border-style:solid; border-width:3; padding:7px">Returns the duration of the mob's swing/attack animation, determined by the carried item and modified by effects applied on the mob. To access the swing/attack animation progress, use "variable.attack_time" instead.</br></td>
+</tr>
+<tr>
 <td style="border-style:solid; border-width:3; padding:7px">query.moon_brightness</td>
 <td style="border-style:solid; border-width:3; padding:7px">Returns the brightness of the moon (FULL_MOON=1.0, WANING_GIBBOUS=0.75, FIRST_QUARTER=0.5, WANING_CRESCENT=0.25, NEW_MOON=0.0, WAXING_CRESCENT=0.25, LAST_QUARTER=0.5, WAXING_GIBBOUS=0.75).</br></td>
 </tr>
diff --git a/1.21.0.0/1.21.120.22/Particles.html b/1.21.0.0/1.21.120.22/Particles.html
@@ -1,4 +1,4 @@
-<h1>PARTICLES DOCUMENTATION </br>Version: 1.21.120.20</h1>
+<h1>PARTICLES DOCUMENTATION </h1>
 This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>
 <h2><p id="Index">Index</p></h2>
 <table border="1">
diff --git a/1.21.0.0/1.21.120.22/Recipes.html b/1.21.0.0/1.21.120.22/Recipes.html
@@ -1,4 +1,4 @@
-<h1>RECIPES DOCUMENTATION </br>Version: 1.21.120.20</h1>
+<h1>RECIPES DOCUMENTATION </h1>
 This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>
 <h2><p id="Index">Index</p></h2>
 <table border="1">
diff --git a/1.21.0.0/1.21.120.22/Schemas.html b/1.21.0.0/1.21.120.22/Schemas.html
@@ -1,4 +1,4 @@
-<h1>SCHEMAS DOCUMENTATION </br>Version: 1.21.120.20</h1>
+<h1>SCHEMAS DOCUMENTATION </h1>
 This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>
 <h2><p id="Index">Index</p></h2>
 <table border="1">
@@ -13,154 +13,6 @@ <h1><p id="Overview">Overview</p></h1>
 <h1><p id="Schemas">Schemas</p></h1>
 
 ```
-actor_animation:1.8.0:{
-    version "format_version"
-    object "animations"
-    {
-        object "animation.<identifier>"
-        {
-            bool "loop" : opt // should this animation stop, loop, or stay on the last frame when finished (true, false, "hold_on_last_frame"
-            string "loop"<"hold_on_last_frame"> : opt // should this animation stop, loop, or stay on the last frame when finished (true, false, "hold_on_last_frame"
-            molang "start_delay" : opt // How long to wait in seconds before playing this animation.  Note that this expression is evaluated once before playing, and only re-evaluated if asked to play from the beginning again.  A looping animation should use 'loop_delay' if it wants a delay between loops.
-            molang "loop_delay" : opt // How long to wait in seconds before looping this animation.  Note that this expression is evaluated after each loop and on looping animation only.
-            molang "anim_time_update" : opt // how does time pass when playing the animation.  Defaults to "query.anim_time + query.delta_time" which means advance in seconds.
-            molang "blend_weight" : opt
-            bool "override_previous_animation" : opt // reset bones in this animation to the default pose before applying this animation
-            object "bones" : opt
-            {
-                object "<identifier>"
-                {
-                    object "relative_to" : opt
-                    {
-                        string "rotation"<"entity"> : opt // if set, makes the bone rotation relative to the entity instead of the bone's parent
-                    }
-                    molang "position" : opt
-                    array "position" : opt
-                    {
-                        molang "<any array element>"
-                    }
-                    object "position" : opt
-                    {
-                        array "<time_stamp>"[3]
-                        {
-                            molang "<any array element>"
-                        }
-                        object "<time_stamp>"
-                        {
-                            enumerated_value "lerp_mode"<"linear", "catmullrom"> : opt
-                            array "pre"[3] : opt
-                            {
-                                molang "<any array element>"
-                            }
-                            array "post"[3] : opt
-                            {
-                                molang "<any array element>"
-                            }
-                        }
-                    }
-                    molang "rotation" : opt
-                    array "rotation" : opt
-                    {
-                        molang "<any array element>"
-                        object "<any array element>"
-                        {
-                            molang "[xyz]"
-                        }
-                    }
-                    object "rotation" : opt
-                    {
-                        array "<time_stamp>"[3]
-                        {
-                            molang "<any array element>"
-                        }
-                        object "<time_stamp>"
-                        {
-                            enumerated_value "lerp_mode"<"linear", "catmullrom"> : opt
-                            array "pre"[3] : opt
-                            {
-                                molang "<any array element>"
-                            }
-                            array "post"[3] : opt
-                            {
-                                molang "<any array element>"
-                            }
-                        }
-                    }
-                    molang "scale" : opt
-                    array "scale" : opt
-                    {
-                        molang "<any array element>"
-                    }
-                    object "scale" : opt
-                    {
-                        array "<time_stamp>"[3]
-                        {
-                            molang "<any array element>"
-                        }
-                        object "<time_stamp>"
-                        {
-                            enumerated_value "lerp_mode"<"linear", "catmullrom"> : opt
-                            array "pre"[3] : opt
-                            {
-                                molang "<any array element>"
-                            }
-                            array "post"[3] : opt
-                            {
-                                molang "<any array element>"
-                            }
-                        }
-                    }
-                }
-            }
-            object "particle_effects" : opt
-            {
-                object "<time_stamp>" : opt
-                {
-                    string "effect" // The name of a particle effect that should be played
-                    string "locator" : opt // The name of a locator on the actor where the effect should be located
-                    molang "pre_effect_script" : opt // A Molang script that will be run when the particle emitter is initialized
-                    bool "bind_to_actor" : opt // Set to false to have the effect spawned in the world without being bound to an actor (by default an effect is bound to the actor).
-                }
-                array "<time_stamp>" : opt
-                {
-                    object "<any array element>" : opt
-                    {
-                        string "effect" // The name of a particle effect that should be played
-                        string "locator" : opt // The name of a locator on the actor where the effect should be located
-                        molang "pre_effect_script" : opt // A Molang script that will be run when the particle emitter is initialized
-                        bool "bind_to_actor" : opt // Set to false to have the effect spawned in the world without being bound to an actor (by default an effect is bound to the actor).
-                    }
-                }
-            }
-            object "sound_effects" : opt // sound effects to trigger as this animation plays, keyed by time
-            {
-                object "<time_stamp>" : opt
-                {
-                    string "effect" // Valid sound effect names should be listed in the entity's resource_definition json file.
-                    string "locator" : opt // The name of a locator on the actor where the sound should originate from
-                }
-                array "<time_stamp>" : opt
-                {
-                    object "<any array element>" : opt
-                    {
-                        string "effect" // Valid sound effect names should be listed in the entity's resource_definition json file.
-                        string "locator" : opt // The name of a locator on the actor where the sound should originate from
-                    }
-                }
-            }
-            object "timeline" : opt
-            {
-                string "<time_stamp>" : opt
-                array "<time_stamp>" : opt
-                {
-                    string "<any array element>" : opt
-                }
-            }
-            float "animation_length" : opt // override calculated value (set as the max keyframe or event time) and set animation length in seconds.
-        }
-    }
-}
-
 texture_set:1.21.30:{
     version "format_version"
     object "minecraft:texture_set"
diff --git a/1.21.0.0/1.21.120.22/Texture Sets.html b/1.21.0.0/1.21.120.22/Texture Sets.html
@@ -1,4 +1,4 @@
-<h1>TEXTURE SETS DOCUMENTATION </br>Version: 1.21.120.20</h1>
+<h1>TEXTURE SETS DOCUMENTATION </h1>
 This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>
 <h2><p id="Index">Index</p></h2>
 <table border="1">

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-<h1>ADDONS DOCUMENTATION </br>Version: 1.21.120.20</h1>`
	`1`	`+<h1>ADDONS DOCUMENTATION </h1>`
`2`	`2`	`This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>`
`3`	`3`	`<h2><p id="Index">Index</p></h2>`
`4`	`4`	`<table border="1">`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-<h1>ANIMATIONS DOCUMENTATION </br>Version: 1.21.120.20</h1>`
	`1`	`+<h1>ANIMATIONS DOCUMENTATION </h1>`
`2`	`2`	`This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>`
`3`	`3`	`<h2><p id="Index">Index</p></h2>`
`4`	`4`	`<table border="1">`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-<h1>BIOMES DOCUMENTATION </br>Version: 1.21.120.20</h1>`
	`1`	`+<h1>BIOMES DOCUMENTATION </h1>`
`2`	`2`	`This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>`
`3`	`3`	`<h2><p id="Index">Index</p></h2>`
`4`	`4`	`<table border="1">`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-<h1>CLIENT BIOMES DOCUMENTATION </br>Version: 1.21.120.20</h1>`
	`1`	`+<h1>CLIENT BIOMES DOCUMENTATION </h1>`
`2`	`2`	`This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>`
`3`	`3`	`<h2><p id="Index">Index</p></h2>`
`4`	`4`	`<table border="1">`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-<h1>ENTITY EVENTS DOCUMENTATION </br>Version: 1.21.120.20</h1>`
	`1`	`+<h1>ENTITY EVENTS DOCUMENTATION </h1>`
`2`	`2`	`This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>`
`3`	`3`	`<h2><p id="Index">Index</p></h2>`
`4`	`4`	`<table border="1">`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-<h1>ENTITY TIMELINE EVENTS DOCUMENTATION </br>Version: 1.21.120.20</h1>`
	`1`	`+<h1>ENTITY TIMELINE EVENTS DOCUMENTATION </h1>`
`2`	`2`	`This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>`
`3`	`3`	`<h2><p id="Index">Index</p></h2>`
`4`	`4`	`<table border="1">`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-<h1>FEATURES DOCUMENTATION </br>Version: 1.21.120.20</h1>`
	`1`	`+<h1>FEATURES DOCUMENTATION </h1>`
`2`	`2`	`This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>`
`3`	`3`	`<h2><p id="Index">Index</p></h2>`
`4`	`4`	`<table border="1">`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-<h1>FOGS DOCUMENTATION </br>Version: 1.21.120.20</h1>`
	`1`	`+<h1>FOGS DOCUMENTATION </h1>`
`2`	`2`	`This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.<br/>Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.<br/>`
`3`	`3`	`<h2><p id="Index">Index</p></h2>`
`4`	`4`	`<table border="1">`