Docs update: Preview 1.21.40.20

1.21.0.0/1.21.40.20/Animations.html

@@ -1,4 +1,4 @@
-<h1>ANIMATIONS DOCUMENTATION </br>Version: 1.21.30.25</h1>
+<h1>ANIMATIONS DOCUMENTATION </br>Version: 1.21.40.20</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">

1.21.0.0/1.21.40.20/Biomes.html

@@ -1,4 +1,4 @@
-<h1>BIOMES DOCUMENTATION </br>Version: 1.21.30.25</h1>
+<h1>BIOMES DOCUMENTATION </br>Version: 1.21.40.20</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">

1.21.0.0/1.21.40.20/Blocks.html

@@ -1,4 +1,4 @@
-<h1>BLOCKS DOCUMENTATION </br>Version: 1.21.30.25</h1>
+<h1>BLOCKS DOCUMENTATION </br>Version: 1.21.40.20</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">
@@ -442,7 +442,7 @@ <h1><p id="Block Definition Properties">Block Definition Properties</p></h1>
 <h2>Code Example</h2>
 Example<br / ><textarea readonly="true" cols="66" rows="20">
 {
-  "format_version": "1.21.30",
+  "format_version": "1.21.40",
   "minecraft:block": {
     "description": {
       "identifier": "design:lavenderstone"

1.21.0.0/1.21.40.20/Entities.html

@@ -1,4 +1,4 @@
-<h1>ENTITIES DOCUMENTATION </br>Version: 1.21.30.25</h1>
+<h1>ENTITIES DOCUMENTATION </br>Version: 1.21.40.20</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">
@@ -13089,7 +13089,7 @@ <h2><p id="minecraft:behavior.fire_at_target">minecraft:behavior.fire_at_target<
 <td style="border-style:solid; border-width:2; padding:8px">projectile_def</td>
 <td style="border-style:solid; border-width:2; padding:8px">String</td>
 <td style="border-style:solid; border-width:2; padding:8px"></td>
-<td style="border-style:solid; border-width:2; padding:8px">Actor definition to use as projectile for the ranged attack. The actor must be a projectile.</br></td>
+<td style="border-style:solid; border-width:2; padding:8px">Actor definition to use as projectile for the ranged attack. The actor must be a projectile. This field is required for the goal to be usable.</br></td>
 </tr>
 <tr>
 <td style="border-style:solid; border-width:2; padding:8px">ranged_fov</td>
@@ -15188,30 +15188,30 @@ <h2><p id="minecraft:behavior.move_to_water">minecraft:behavior.move_to_water</p
 
 <h2><p id="minecraft:behavior.move_towards_dwelling_restriction">minecraft:behavior.move_towards_dwelling_restriction</p></h2>
 
-Allows mobs with the dweller component to move toward their Village area that the mob should be restricted to.</br><h3></h3>
+Allows entities with the "minecraft:dweller" component to move toward their Village area that the entity should be restricted to.</br><h3></h3>
 
 <table border="1" style="width:100%; border-style:solid; border-collapse:collapse; border-width:2;">
 <tr> <th style="border-style:solid; border-width:2;">Name</th> <th style="border-style:solid; border-width:2;">Type</th> <th style="border-style:solid; border-width:2;">Default Value</th> <th style="border-style:solid; border-width:2;">Description</th> </tr>
 <tr>
 <td style="border-style:solid; border-width:2; padding:8px">speed_multiplier</td>
 <td style="border-style:solid; border-width:2; padding:8px">Decimal</td>
 <td style="border-style:solid; border-width:2; padding:8px">1.0</td>
-<td style="border-style:solid; border-width:2; padding:8px">This multiplier modifies the entity's speed when moving towards it's restriction.</br></td>
+<td style="border-style:solid; border-width:2; padding:8px">This multiplier modifies the entity's speed when moving towards its restriction.</br></td>
 </tr>
 </table>
 <a href="#Index">Back to top</a><br><br>
 
 <h2><p id="minecraft:behavior.move_towards_home_restriction">minecraft:behavior.move_towards_home_restriction</p></h2>
 
-Allows mobs with the home component to move toward their pre-defined area that the mob should be restricted to.</br><h3></h3>
+</br>		Allows entities with a "minecraft:home" component to move towards their home position. </br>		If "restriction_radius" is set, entities will be able to run this behavior only if outside of it.</br>	</br><h3></h3>
 
 <table border="1" style="width:100%; border-style:solid; border-collapse:collapse; border-width:2;">
 <tr> <th style="border-style:solid; border-width:2;">Name</th> <th style="border-style:solid; border-width:2;">Type</th> <th style="border-style:solid; border-width:2;">Default Value</th> <th style="border-style:solid; border-width:2;">Description</th> </tr>
 <tr>
 <td style="border-style:solid; border-width:2; padding:8px">speed_multiplier</td>
 <td style="border-style:solid; border-width:2; padding:8px">Decimal</td>
 <td style="border-style:solid; border-width:2; padding:8px">1.0</td>
-<td style="border-style:solid; border-width:2; padding:8px">This multiplier modifies the entity's speed when moving towards it's restriction.</br></td>
+<td style="border-style:solid; border-width:2; padding:8px">This multiplier modifies the entity's speed when moving towards its restriction.</br></td>
 </tr>
 </table>
 <a href="#Index">Back to top</a><br><br>
@@ -15849,10 +15849,6 @@ <h2><p id="minecraft:behavior.panic">minecraft:behavior.panic</p></h2>
 </table>
 <a href="#Index">Back to top</a><br><br>
 
-<h2><p id="minecraft:behavior.peek">minecraft:behavior.peek</p></h2>
-
-Allows the mob to peek out. This is what the shulker uses to look out of its shell.</br><a href="#Index">Back to top</a><br><br>
-
 <h2><p id="minecraft:behavior.pet_sleep_with_owner">minecraft:behavior.pet_sleep_with_owner</p></h2>
 
 Allows the pet mob to move onto a bed with its owner while sleeping.</br><h3></h3>
@@ -19942,6 +19938,10 @@ <h2><p id="minecraft:despawn">minecraft:despawn</p></h2>
 </table>
 <a href="#Index">Back to top</a><br><br>
 
+<h2><p id="minecraft:dimension_bound">minecraft:dimension_bound</p></h2>
+
+Prevents the entity from changing dimension through portals.</br><a href="#Index">Back to top</a><br><br>
+
 <h2><p id="minecraft:drying_out_timer">minecraft:drying_out_timer</p></h2>
 
 Adds a timer for drying out that will count down and fire 'dried_out_event' or will stop as soon as the entity will get under rain or water and fire 'stopped_drying_out_event'</br><h3></h3>
@@ -20742,21 +20742,27 @@ <h2><p id="minecraft:heartbeat">minecraft:heartbeat</p></h2>
 
 <h2><p id="minecraft:home">minecraft:home</p></h2>
 
-Saves a home pos for when the the entity is spawned.</br><h3></h3>
+Saves a home position for when the the entity is spawned.</br><h3></h3>
 
 <table border="1" style="width:100%; border-style:solid; border-collapse:collapse; border-width:2;">
 <tr> <th style="border-style:solid; border-width:2;">Name</th> <th style="border-style:solid; border-width:2;">Type</th> <th style="border-style:solid; border-width:2;">Default Value</th> <th style="border-style:solid; border-width:2;">Description</th> </tr>
 <tr>
 <td style="border-style:solid; border-width:2; padding:8px">home_block_list</td>
 <td style="border-style:solid; border-width:2; padding:8px">List</td>
 <td style="border-style:solid; border-width:2; padding:8px"></td>
-<td style="border-style:solid; border-width:2; padding:8px">Optional block list that the home position will be associated with. If any of the blocks no longer exist at that position, the home restriction is removed. Example syntax: minecraft:sand.  Not supported: minecraft:sand:1</br></td>
+<td style="border-style:solid; border-width:2; padding:8px">Optional list of blocks that can be considered a valid home. If no such block longer exists at that position,</br>											the home restriction is removed. Example syntax: minecraft:sand. Not supported: minecraft:sand:1.</br></td>
 </tr>
 <tr>
 <td style="border-style:solid; border-width:2; padding:8px">restriction_radius</td>
 <td style="border-style:solid; border-width:2; padding:8px">Integer</td>
-<td style="border-style:solid; border-width:2; padding:8px">-1</td>
-<td style="border-style:solid; border-width:2; padding:8px">The radius that the entity will be restricted to in relation to its home</br></td>
+<td style="border-style:solid; border-width:2; padding:8px">0</td>
+<td style="border-style:solid; border-width:2; padding:8px">Optional radius that the entity will be restricted to in relation to its home.</br></td>
+</tr>
+<tr>
+<td style="border-style:solid; border-width:2; padding:8px">restriction_type</td>
+<td style="border-style:solid; border-width:2; padding:8px">String</td>
+<td style="border-style:solid; border-width:2; padding:8px">none</td>
+<td style="border-style:solid; border-width:2; padding:8px">Defines how the the entity will be restricted to its home position. The possible values are:</br>												\n- "none", which poses no restriction.</br>												\n- "random_movement", which restricts randomized movement to be around the home position.</br>												\n- [Beta] "all_movement", which restricts any kind of movement to be around the home position.</br>													However, entities that somehow got too far away from their home will always be able to move closer to it, if prompted to do so.</br></td>
 </tr>
 </table>
 <a href="#Index">Back to top</a><br><br>
@@ -22524,6 +22530,12 @@ <h2><p id="minecraft:projectile">minecraft:projectile</p></h2>
 <td style="border-style:solid; border-width:2; padding:8px">Determines the velocity of the projectile</br></td>
 </tr>
 <tr>
+<td style="border-style:solid; border-width:2; padding:8px">reflect_immunity</td>
+<td style="border-style:solid; border-width:2; padding:8px">Decimal</td>
+<td style="border-style:solid; border-width:2; padding:8px">0</td>
+<td style="border-style:solid; border-width:2; padding:8px">During the specified time, in seconds, the projectile cannot be reflected by hitting it</br></td>
+</tr>
+<tr>
 <td style="border-style:solid; border-width:2; padding:8px">reflect_on_hurt</td>
 <td style="border-style:solid; border-width:2; padding:8px">Boolean</td>
 <td style="border-style:solid; border-width:2; padding:8px">false</td>
@@ -23595,6 +23607,10 @@ <h2><p id="minecraft:transformation">minecraft:transformation</p></h2>
 </table>
 <a href="#Index">Back to top</a><br><br>
 
+<h2><p id="minecraft:transient">minecraft:transient</p></h2>
+
+An entity with this component will NEVER persist, and forever disappear when unloaded.</br><a href="#Index">Back to top</a><br><br>
+
 <h2><p id="minecraft:trusting">minecraft:trusting</p></h2>
 
 Defines the rules for a mob to trust players.</br><h3></h3>
@@ -24217,10 +24233,6 @@ <h3></h3>
 <td style="border-style:solid; border-width:2; padding:8px">-169886247</br></td>
 </tr>
 <tr>
-<td style="border-style:solid; border-width:2; padding:8px">minecraft:behavior.peek</td>
-<td style="border-style:solid; border-width:2; padding:8px">211304085</br></td>
-</tr>
-<tr>
 <td style="border-style:solid; border-width:2; padding:8px">minecraft:behavior.pet_sleep_with_owner</td>
 <td style="border-style:solid; border-width:2; padding:8px">1379392240</br></td>
 </tr>
@@ -24659,6 +24671,10 @@ <h3></h3>
 <td style="border-style:solid; border-width:2; padding:8px">1674909940</br></td>
 </tr>
 <tr>
+<td style="border-style:solid; border-width:2; padding:8px">minecraft:dimension_bound</td>
+<td style="border-style:solid; border-width:2; padding:8px">-1843592159</br></td>
+</tr>
+<tr>
 <td style="border-style:solid; border-width:2; padding:8px">minecraft:drying_out_timer</td>
 <td style="border-style:solid; border-width:2; padding:8px">2113510784</br></td>
 </tr>
@@ -24975,6 +24991,10 @@ <h3></h3>
 <td style="border-style:solid; border-width:2; padding:8px">-457894577</br></td>
 </tr>
 <tr>
+<td style="border-style:solid; border-width:2; padding:8px">minecraft:transient</td>
+<td style="border-style:solid; border-width:2; padding:8px">-413020544</br></td>
+</tr>
+<tr>
 <td style="border-style:solid; border-width:2; padding:8px">minecraft:trusting</td>
 <td style="border-style:solid; border-width:2; padding:8px">936499892</br></td>
 </tr>

1.21.0.0/1.21.40.20/Entity Events.html

@@ -1,4 +1,4 @@
-<h1>ENTITY EVENTS DOCUMENTATION </br>Version: 1.21.30.25</h1>
+<h1>ENTITY EVENTS DOCUMENTATION </br>Version: 1.21.40.20</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">

1.21.0.0/1.21.40.20/Entity Timeline Events.html

@@ -1,4 +1,4 @@
-<h1>ENTITY TIMELINE EVENTS DOCUMENTATION </br>Version: 1.21.30.25</h1>
+<h1>ENTITY TIMELINE EVENTS DOCUMENTATION </br>Version: 1.21.40.20</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">