Editing Java Edition 1.21.5

{{Infobox version
| title = Minecraft 1.21.5
| image = 1.21.5 banner.jpg
| image2 = Java Edition 1.21.5.png
| name = [[Spring to Life]]
| edition = Java
| vernum = 1.21.5
| date = March 25, 2025
| jsonhash = 09fe09042d1767d677649d1e4a9d26ce3b462ebb
| clienthash = b88808bbb3da8d9f453694b5d8f74a3396f1a533
| clientmap = 57669731d542f98646772e91a0d68628f9827a5c
| serverhash = e6ec2f64e6080b9b5d9b471b291c33cc7f509733
| servermap = f4812c1d66d0098a94616b19c21829e591d0af3a
| prevparent = 1.21
| prev = 1.21.4
| next = <!-- 1.21.6 -->
| nextparent = 
}}
{{Relevant guide|Java Edition guides/Spring to Life}}
'''1.21.5''', the release of '''[[Spring to Life]]''', is a [[game drop]] released on March 25, 2025.<ref>{{cite|url=https://www.minecraft.net/en-us/article/minecraft-java-edition-1-21-5|title=Minecraft Java Edition 1.21.5|date=March 25, 2025|website=Minecraft.net}}</ref> This update introduces new [[chicken]], [[cow]], and [[pig]] variants, expands plant life, and updates all [[spawn egg]] textures. Additionally, several features previously exclusive to ''[[Bedrock Edition]]'' have been added to {{JE}}, enhancing gameplay diversity and visual aesthetics, and also fixes bugs. This is the first version released in 2025.

is the performance fixed in this update? because it made it worse i n 1.21.2

== Additions ==
{{Additions table
|Leaf Litter
|Wildflowers
|Test Block
|Test Block log
|Test Block fail
|Test Block accept
|Test Instance Block
|Bush
|Firefly Bush
|Cactus Flower
|Short Dry Grass
|Tall Dry Grass
|Brown Egg
|Blue Egg
|Jungle Explorer Map
|Swamp Explorer Map
|Desert Village Map
|Plains Village Map
|Savanna Village Map
|Snowy Village Map
|Taiga Village Map
}}

=== Blocks ===
'''[[File:Bush.png|32px]] [[Bush]]'''
* Generates in the following biomes:
**{{BiomeLink|Plains}}
**{{BiomeLink|Windswept Hills}}
**{{BiomeLink|Windswept Gravelly Hills}}
**{{BiomeLink|Windswept Forest}}
**{{BiomeLink|River}}
**{{BiomeLink|Frozen River}}
**{{BiomeLink|Forest}}
**{{BiomeLink|Birch Forest}}
**{{BiomeLink|Old Growth Birch Forest}}
* They are tinted by the grass color of the biome they are placed in.
* Can be used in the [[composter]], with a 30&nbsp;% chance to add a layer.
* Using [[bone meal]] on a bush will generate a neighboring bush next to it if possible.
* Can be obtained using [[shears]] or a [[Silk Touch]] tool.

'''[[File:Cactus Flower JE1.png|32px]] [[Cactus Flower]]'''
* A new type of flower which has a chance of generating on cacti.<!-- The flower does not generate specificly in the biomes in which cactus spawn as a player can grow a cactus which will still have the chance of generating a cactus additionally technicaly even if the above is not the case the flower itself is not linked to dessers and or badlands but instead to the cactus plant the fact that cactus only generated in those biomes in irrelevent -->
* Can be placed on cactus blocks or any block which has center support at the top of the block.
* Has a chance of growing on cactus blocks.
** If a cactus is one or two blocks high the flower has a 10&nbsp;% chance to grow instead of the cactus getting higher.
** If a cactus is three blocks or higher the flower has a 25&nbsp;% chance to grow.
** Cactus flowers will only grow if they have space on all four sides.
* Can be mined without any tool.
* Can be used in the [[composter]], with a 30&nbsp;% chance to add a layer.
* Can be used to craft 1 [[pink dye]].
{{Crafting|Cactus Flower
|Output = Pink Dye
|shapeless = 1
|ignoreusage = 1
}}

'''[[File:Firefly Bush.png|32px]] [[Firefly Bush]]'''
* Generates in [[swamp]]s, near [[river]]s, near water in [[mangrove swamp]]s and all types of [[badlands]] (very rarely).
* When it's dark, glowing firefly particles appear around the firefly bush, up to 5 blocks away.
* It plays ambient sounds when all of the following conditions are met:
** The firefly bush is not blocked from above by any collidable block (except [[leaves]]).
** It is nighttime.
* Can be used in the [[composter]], with a 30&nbsp;% chance to add a layer.
* Using [[bone meal]] on a firefly bush will generate a neighboring firefly bush next to it if possible.
* Emits a light level of 2.
* Can be instantly broken without any particular tool.

'''{{animate|Leaf Litter 1 (S) JE1.png;Leaf Litter 2 (S) JE1.png;Leaf Litter 3 (S) JE1.png;Leaf Litter 4 (S) JE1.png|40px}}[[Leaf Litter]]'''
* A new type of decorative block which can be found in [[forest]]s, [[dark forest|dark forests,]] and [[wooded badlands]].
* Can have different amounts of leaves in one block space.
** Up to four leaf litter pieces can be placed in the same block space, like the [[pink petals]].
** Placing a leaf litter into an already placed leaf litter block increases the amount of leaves.
* Leaf litter is tinted based on which biome it is in.
* Can be placed in four orientations, on any block which has full solid top surface.
* Can be created by smelting any type of leaves block.
* Can be used as fuel for smelting.
* Can be used in a [[composter]].
* Has unique block sounds.
{{Smelting
  |Any leaves
  |Leaf Litter
  |ingredients=Any [[leaves]] block
}}

'''[[File:Short Dry Grass.png|32px]] [[Short Dry Grass]]'''
* Is one block high.
* Generates in the [[desert]] and [[badlands]], randomly offset within the block they are on.
* Can be placed on types of [[sand]], [[terracotta]] and [[dirt block]]s like the [[dead bush]].
* Can be obtained using [[shears]] or a [[Silk Touch]] tool.
* Can be bone mealed.
** Using [[bone meal]] on short dry grass grows it into a tall dry grass.
* Can be used in the [[composter]], with a 30&nbsp;% chance to add a layer.
* [[Sheep]] can eat short dry grass to regrow its wool.
* Can be used as fuel for smelting, where they smelt half an item.

'''[[File:Tall Dry Grass.png|32px]] [[Tall Dry Grass]]'''
* Is one block high.
* Generates in the [[desert]] and [[badlands]], randomly offset within the block they are on.
* Can be placed on types of [[sand]], [[terracotta]] and [[dirt block]]s like the [[dead bush]].
* Can be obtained using [[shears]] or a [[Silk Touch]] tool.
* Can be bone mealed.
** Using [[bone meal]] on tall dry grass places a neighboring short dry grass next to the block if possible.
* Can be used in the [[composter]], with a 30&nbsp;% chance to add a layer.
* [[Sheep]] can eat tall dry grass to regrow its wool.
* Can be used as fuel for smelting, where they smelt half an item.

'''{{animate|Wildflowers 1 (S) JE1.png;Wildflowers 2 (S) JE1.png;Wildflowers 3 (S) JE1.png;Wildflowers 4 (S) JE1.png|40px}} [[Wildflowers]]'''
* A new type of [[flower]] which grow in [[birch forest]]s, [[old growth birch forest]]s and [[meadow]]s.
* Can have different amounts of flowers in one block space.
** Up to four wildflowers can be placed in the same block space, like the [[pink petals]].
** Placing a wildflower into an already placed wildflowers block increases the amount of flowers.
** Using bone meal on wildflowers will produce more wildflowers.
* Can be placed in four orientations.
* Can be crafted into [[yellow dye]].
{{Crafting|Wildflowers
|Output = Yellow Dye
|shapeless = 1
|ignoreusage = 1
}}

'''{{animate|Test Block start JE2.png;Test Block log JE2.png;Test Block fail JE2.png;Test Block accept JE2.png|32px}} [[Test Block]]'''
* A technical block used in game tests.
* Can be obtained by {{cmd|setblock}}, {{cmd|fill}}, or {{cmd|give}} commands, or through the [[Operator Items Tab]].
* The test block is a block used for implementing block-based tests. It has four modes:
** {{cd|start}}: Triggers a redstone pulse when the test starts
** {{cd|log}}: Logs a message to the server log file when powered by redstone (prints twice, due to a bug{{cn|Mojira link?}}<ref name="youtube-6elLSg0y7X4">{{Citation|url=https://www.youtube.com/watch?v=6elLSg0y7X4|title=Mojang just added some WEIRD new blocks. Here's how they work.|author=Conure [@conure512]|website=YouTube|date=2025-01-15|archive-url=https://preservetube.com/watch?v=6elLSg0y7X4}}</ref><sup>:9m10s</sup>)
** {{cd|fail}}: Fails the test when powered by redstone
** {{cd|accept}}: Completes the test when powered by redstone
* Block-based tests are required to have at least one start block and one accept block in the structure.

'''[[File:Test Instance Block JE2.png|32px]] [[Test Instance Block]]'''
* A technical block used in game tests.
* Can be obtained by {{cmd|setblock}}, {{cmd|fill}}, {{cmd|give}}, or {{cmd|test}} commands, or through the [[Operator Items Tab]].
* To run a test in a world, a test instance block is used. This type of block represents the test as placed in the world and is used to interact with that test, to save the structure, reset or run the test.
* Using the {{cmd|test}} command to run or create a test will also place a test instance block to control that test.

=== Items ===
'''[[File:Blue Egg.png|32px]] [[Blue Egg]]'''
* A variant of the [[egg]] laid by the cold chicken variant.
* Spawns the cold chicken variant when hatched.

'''[[File:Brown Egg.png|32px]] [[Brown Egg]]'''
* A variant of the [[egg]] laid by the warm chicken variant.
* Spawns the warm chicken variant when hatched.

=== Mobs ===
'''{{Animate|Warm Chicken.png;Cold Chicken.png|32px}}  [[Chicken]]'''
*New [[chicken]] variants have been added, the variant is determined by the biome they spawn in.
**{{EntityLink|Chicken|Temperate Chicken}} – The pre-existing chicken variant.
***Spawns by default where the cold and warm chicken variants do not spawn.
**{{EntityLink|Cold Chicken}} – A variant that spawns in the following biomes:
*** {{BiomeLink|Old Growth Pine Taiga}}
*** {{BiomeLink|Old Growth Spruce Taiga}}
*** {{BiomeLink|Taiga}}
*** {{BiomeLink|Snowy Taiga}}
*** {{BiomeLink|Windswept Hills}}
*** {{BiomeLink|Windswept Gravelly Hills}}
*** {{BiomeLink|Windswept Forest}}
*** {{BiomeLink|Snowy Plains}}
*** {{BiomeLink|Ice Spikes}}
*** {{BiomeLink|Frozen Peaks}}
*** {{BiomeLink|Jagged Peaks}}
*** {{BiomeLink|Snowy Slopes}}
*** {{BiomeLink|Grove}}
*** {{BiomeLink|Stony Peaks}}
*** {{BiomeLink|Frozen River}}
*** {{BiomeLink|Cold Ocean}}
*** {{BiomeLink|Deep Cold Ocean}}
*** {{BiomeLink|Frozen Ocean}}
*** {{BiomeLink|Deep Frozen Ocean}}
*** {{BiomeLink|Deep Dark}}
*** {{BiomeLink|The End}}
*** {{BiomeLink|End Barrens}}
*** {{BiomeLink|Small End Islands}}
*** {{BiomeLink|End Midlands}}
*** {{BiomeLink|End Highlands}}
**{{EntityLink|Warm Chicken|Warm Chicken}} – A variant that spawns in the following biomes:
*** {{BiomeLink|Savanna}}
*** {{BiomeLink|Savanna Plateau}}
*** {{BiomeLink|Windswept Savanna}}
*** {{BiomeLink|Jungle}}
*** {{BiomeLink|Sparse Jungle}}
*** {{BiomeLink|Bamboo Jungle}}
*** {{BiomeLink|Badlands}}
*** {{BiomeLink|Eroded Badlands}}
*** {{BiomeLink|Wooded Badlands}}
*** {{BiomeLink|Desert}}
*** {{BiomeLink|Mangrove Swamp}}
*** {{BiomeLink|Warm Ocean}}
*** {{BiomeLink|Lukewarm Ocean}}
*** {{BiomeLink|Deep Lukewarm Ocean}}
*** {{BiomeLink|Nether Wastes}}
*** {{BiomeLink|Crimson Forest}}
*** {{BiomeLink|Warped Forest}}
*** {{BiomeLink|Soul Sand Valley}}
*** {{BiomeLink|Basalt Deltas}}
* When bred by a [[player]], the baby chicken variant will not be chosen by the current biome, but instead randomly selected from one of the parents' variants.

'''{{Animate|Warm Cow.png;Cold Cow.png|40px}} [[Cow]]'''
* New [[cow]] variants have been added, the variant is determined by the biome they spawn in.
**{{EntityLink|Temperate Cow}} – The pre-existing cow variant.
*** Spawns by default where the cold and warm cow variants do not spawn.
**{{EntityLink|Cold Cow}} – A variant that spawns in the following biomes:
*** {{BiomeLink|Old Growth Pine Taiga}}
*** {{BiomeLink|Old Growth Spruce Taiga}}
*** {{BiomeLink|Taiga}}
*** {{BiomeLink|Snowy Taiga}}
*** {{BiomeLink|Windswept Hills}}
*** {{BiomeLink|Windswept Gravelly Hills}}
*** {{BiomeLink|Windswept Forest}}
*** {{BiomeLink|Snowy Plains}}
*** {{BiomeLink|Ice Spikes}}
*** {{BiomeLink|Frozen Peaks}}
*** {{BiomeLink|Jagged Peaks}}
*** {{BiomeLink|Snowy Slopes}}
*** {{BiomeLink|Grove}}
*** {{BiomeLink|Stony Peaks}}
*** {{BiomeLink|Frozen River}}
*** {{BiomeLink|Cold Ocean}}
*** {{BiomeLink|Deep Cold Ocean}}
*** {{BiomeLink|Frozen Ocean}}
*** {{BiomeLink|Deep Frozen Ocean}}
*** {{BiomeLink|Deep Dark}}
*** {{BiomeLink|The End}}
*** {{BiomeLink|End Barrens}}
*** {{BiomeLink|Small End Islands}}
*** {{BiomeLink|End Midlands}}
*** {{BiomeLink|End Highlands}}
**{{EntityLink|Warm Cow}} – A variant that spawns in the following biomes:
*** {{BiomeLink|Savanna}}
*** {{BiomeLink|Savanna Plateau}}
*** {{BiomeLink|Windswept Savanna}}
*** {{BiomeLink|Jungle}}
*** {{BiomeLink|Sparse Jungle}}
*** {{BiomeLink|Bamboo Jungle}}
*** {{BiomeLink|Badlands}}
*** {{BiomeLink|Eroded Badlands}}
*** {{BiomeLink|Wooded Badlands}}
*** {{BiomeLink|Desert}}
*** {{BiomeLink|Mangrove Swamp}}
*** {{BiomeLink|Warm Ocean}}
*** {{BiomeLink|Lukewarm Ocean}}
*** {{BiomeLink|Deep Lukewarm Ocean}}
*** {{BiomeLink|Nether Wastes}}
*** {{BiomeLink|Crimson Forest}}
*** {{BiomeLink|Warped Forest}}
*** {{BiomeLink|Soul Sand Valley}}
*** {{BiomeLink|Basalt Deltas}}
* When bred by a [[player]], the baby cow variant will not be chosen by the current biome, but instead randomly selected from one of the parents' variants.

'''{{Animate|Warm Pig JE1 BE1.png;Cold Pig JE1 BE1.png|40px}} [[Pig]]'''
* New [[pig]] variants have been added, the variant is determined by the biome they spawn in.
**{{EntityLink|Temperate Pig}} – The pre-existing pig variant.
*** Spawns by default where the cold and warm pig variants do not spawn.
**{{EntityLink|Cold Pig}} – A variant that spawns in the following biomes:
*** {{BiomeLink|Old Growth Pine Taiga}}
*** {{BiomeLink|Old Growth Spruce Taiga}}
*** {{BiomeLink|Taiga}}
*** {{BiomeLink|Snowy Taiga}}
*** {{BiomeLink|Windswept Hills}}
*** {{BiomeLink|Windswept Gravelly Hills}}
*** {{BiomeLink|Windswept Forest}}
*** {{BiomeLink|Snowy Plains}}
*** {{BiomeLink|Ice Spikes}}
*** {{BiomeLink|Frozen Peaks}}
*** {{BiomeLink|Jagged Peaks}}
*** {{BiomeLink|Snowy Slopes}}
*** {{BiomeLink|Grove}}
*** {{BiomeLink|Stony Peaks}}
*** {{BiomeLink|Frozen River}}
*** {{BiomeLink|Cold Ocean}}
*** {{BiomeLink|Deep Cold Ocean}}
*** {{BiomeLink|Frozen Ocean}}
*** {{BiomeLink|Deep Frozen Ocean}}
*** {{BiomeLink|Deep Dark}}
*** {{BiomeLink|The End}}
*** {{BiomeLink|End Barrens}}
*** {{BiomeLink|Small End Islands}}
*** {{BiomeLink|End Midlands}}
*** {{BiomeLink|End Highlands}}
**{{EntityLink|Warm Pig}} – A variant that spawns in the following biomes:
*** {{BiomeLink|Savanna}}
*** {{BiomeLink|Savanna Plateau}}
*** {{BiomeLink|Windswept Savanna}}
*** {{BiomeLink|Jungle}}
*** {{BiomeLink|Sparse Jungle}}
*** {{BiomeLink|Bamboo Jungle}}
*** {{BiomeLink|Badlands}}
*** {{BiomeLink|Eroded Badlands}}
*** {{BiomeLink|Wooded Badlands}}
*** {{BiomeLink|Desert}}
*** {{BiomeLink|Mangrove Swamp}}
*** {{BiomeLink|Warm Ocean}}
*** {{BiomeLink|Lukewarm Ocean}}
*** {{BiomeLink|Deep Lukewarm Ocean}}
*** {{BiomeLink|Nether Wastes}}
*** {{BiomeLink|Crimson Forest}}
*** {{BiomeLink|Warped Forest}}
*** {{BiomeLink|Soul Sand Valley}}
*** {{BiomeLink|Basalt Deltas}}
* When bred by a [[player]], the baby pig variant will not be chosen by the current biome, but instead randomly selected from one of the parents’ variants.

'''[[Wolf]]'''
* Added six new sound variants.
** The variants are called Classic, Big, Cute, Puglin, Angry, Grumpy, and Sad. The existing wolf sounds are used for the Classic variant.
** Wolves receive a random sound variant when they spawn.<!-- Create table showing sounds for each type -->
** Sound variants are not related to texture variants.

=== World generation ===
'''[[Fallen tree]]'''
* Fallen trees are a new decorative variant of trees.
* Fallen trees come in four different wood type variants:
** [[Oak]]
** [[Spruce]]
** [[Birch]]
** [[Jungle tree|Jungle]]
* Birch fallen trees can come in a shorter version or a longer version.
* Some fallen trees can be decorated with [[mushroom]] or [[vines]].
* Fallen trees can be found in all biomes where their standing tree variant grow, except the following:
** {{BiomeLink|Meadow}}
** {{BiomeLink|Bamboo Jungle}}
** {{BiomeLink|River}}
** {{BiomeLink|Grove}}
** {{BiomeLink|Flower Forest}}
*** Has fallen birch trees but not fallen oak trees.
* Longer versions of fallen birch trees also generate.
** This version is up to 15&nbsp;blocks long, as opposed to the shorter version which can only reach 8&nbsp;blocks at most.

=== Gameplay ===
'''[[Sound]]s'''
* [[Dead bush]] blocks have a chance of playing ambient sounds when placed on top of two blocks that are any color of terracotta, sand or red sand blocks in any biome.
* [[Sand]], [[red sand]] and [[terracotta]] of any color have a chance of playing ambient sounds when surrounded by any one of them on at least 3 sides 8 blocks away.
** {{cd|block.sand.idle}} can be played in any biome.
** {{cd|block.sand.wind}} only plays when in [[desert]] or [[badlands]] biomes.

=== General ===
'''[[Language]]'''
* Added support for [[w:Kyrgyz language|Kyrgyz]] language.

== Changes ==
=== Blocks ===
'''General'''
* Any block in the simulation distance of a player or loaded by another source of chunk loading (such as [[ender pearl]]s) may now receive random ticks, instead of just 8 chunks around players.
** For example: if a chunk is loaded by an ender pearl or is in the spawn chunks, crops are able to grow, [[ice]] can melt, [[snow]] can fall, and a [[cauldron]] can be filled by rain.
** Mob spawning, lava spreading fire, and lightning strikes still occur in the previous radius of 8 chunks around players.

'''[[Beacon]]'''
* Beacons and their beams now render beyond 16 chunks up to the client render distance.
** To keep it easily visible at large distances, the beam is rendered thicker the further away it is from the player.
** The beam now renders up to 2048 blocks high, up from 1024.

'''[[Bubble Column]]'''
* Bubble columns produce less particles and sounds when entities that are unaffected by them are inside them.

'''[[Creaking Heart]]'''
* Creaking hearts correctly placed between Logs have a new dormant texture during the day.
** Dormant creaking hearts cannot spawn new [[creaking]]s or [[resin clump]]s.
* The transition between the awake and dormant states of creaking hearts is now based on the fixed day time.

'''[[Dead Bush]]'''
* Can now be placed on [[farmland]].

'''[[Eyeblossom]]'''
* The transition between the states of eyeblossoms is now based on the fixed day time.

'''[[Fire]]'''
* Will no longer burn or spread if no player is within 8 chunks.

'''[[Iron Bars]], [[Iron Block]], [[Iron Trapdoor]], [[Iron Door]], and [[Heavy Weighted Pressure Plate]]'''
* Added new break, place, step, fall and hit sounds.

'''[[Leaves]]'''
* The following blocks can now spawn falling leaf particles:
** Oak Leaves
** Spruce Leaves
** Birch Leaves
** Acacia Leaves
** Jungle Leaves
** Dark Oak Leaves
** Mangrove Leaves
** Azalea Leaves
** Flowering Azalea Leaves

'''[[Lodestone]]'''
* Changed crafting recipe to require an [[iron ingot]] instead of a [[netherite ingot]], making them renewable.
{{Crafting Table|
|A1=Chiseled Stone Bricks
|A2=Chiseled Stone Bricks
|A3=Chiseled Stone Bricks
|B1=Chiseled Stone Bricks
|B2=Iron Ingot
|B3=Chiseled Stone Bricks
|C1=Chiseled Stone Bricks
|C2=Chiseled Stone Bricks
|C3=Chiseled Stone Bricks
|Output=Lodestone
|ignoreusage = 1
}}
* Can now be found in [[ruined portal]] chests.

'''[[Pale Oak Leaves]] and [[Pale Oak Sapling]]'''
* Now have an updated map color.

'''[[Powder Snow]]'''
* Landing on powder snow with [[leather boots]] equipped after falling further than 2.5 blocks (more precisely ~2.69456... blocks) will now make entities fall through the snow.
** Jumping or falling less than 2.5 blocks allows the entity to land on top of the snow like before.

'''[[Short Grass]]'''
* Now generates slightly sparser in [[meadow]]s.

=== Items ===
'''[[Bundle]]'''
* Can now be found in some of the chests in [[village]]s.

'''[[Cake]] and [[Pumpkin Pie]]'''
* Can now be crafted using [[blue egg]]s or [[brown egg]]s.

'''[[Elytra]]'''
* Flight is now cancelled when gliding into climbable blocks like [[ladder]]s, [[scaffolding]], [[vines]], etc.

'''[[Saddle]]'''
* Saddles equipped onto [[pig]]s or [[strider]]s will now maintain properties such as custom name when dropped.
* Saddles equipped onto [[camel]]s and equines ([[horse]]s, [[donkey]]s, [[mule]]s) now remain visible if the mob equipped with them is inflicted with [[Invisibility]].
* Saddles equipped onto camels and equines no longer turn red when the mob wearing it takes damage.
* When enchanted now show the [[enchantment]] glint on mobs wearing it.
* [[Thorns]] and [[Curse of Binding]] enchantments now work on mobs that are wearing it.

[[File:Wall of spawn eggs.jpg|thumb|A collection of the new spawn egg textures.]]
'''[[Spawn Egg]]s'''
* Changed the visuals of all spawn eggs to make them easier to distinguish: each type of spawn egg now has its own unique icon instead of all just being colored variants of the same spotted egg.
** Each egg visual varies in shape to reflect the in-world properties of the mob it spawns: for example, smaller mobs tend to have a smaller spawn egg icon.
* Added textures for [[Programmer Art]] resource pack.

=== Mobs ===
'''General'''
* Farm animals can now spawn in [[badlands]].

'''[[Bee]]s'''
* Are now attracted to, and can be bred using [[wildflowers]] and [[cactus flower]]s.

'''[[Camel]]s'''
* Now spawn in [[desert]]s.

'''[[Cow]]s and [[Mooshroom]]s'''
* Textures have been changed.
* Nose now extrudes from model.
* Position of legs and horns changed now matches [[Bedrock Edition]].

'''[[Creaking]]s'''
* Can now be named using [[name tag]]s.
** Named creakings will persist through the day.
*** However, it will still be torn down if stuck with a player or if it is too far from its heart.
** Named creakings are still resistant to all damage, and can communicate with their hearts via particles.

'''[[Sheep]]'''
* Changed the rules for sheep coloring to be based on which biome they spawn in:
** Temperate biomes:
*** Common:
**** {{EntityLink|White sheep}}
*** Uncommon:
**** {{EntityLink|Black sheep}}
**** {{EntityLink|Gray sheep}}
**** {{EntityLink|Light gray sheep}}
**** {{EntityLink|Brown sheep}}
*** Rare:
**** {{EntityLink|Pink sheep}}
** Cold biomes:
*** Common:
**** {{EntityLink|Black sheep}}
*** Uncommon:
**** {{EntityLink|Gray sheep}}
**** {{EntityLink|Light gray sheep}} 
**** {{EntityLink|White sheep}}
**** {{EntityLink|Brown sheep}}
*** Rare:
**** {{EntityLink|Pink sheep}}
** Warm biomes:
*** Common:
**** {{EntityLink|Brown sheep}}
*** Uncommon:
**** {{EntityLink|Gray sheep}}
**** {{EntityLink|Light gray sheep}}
**** {{EntityLink|White sheep}}
**** {{EntityLink|Black sheep}}
*** Rare:
**** {{EntityLink|Pink sheep}}
* [[Sheep]] colors for temperate biomes is unchanged from current behavior.
* Sheep's wool undercoat is now also colored when dyed, matching existing behavior in {{el|be}}.
* Sheep can now eat [[fern]]s, matching {{el|be}}.

'''[[Villager]]s'''
* The changes to cartographer trades have been moved from [[Villager Trade Rebalance|experimental features]] and are now available during normal gameplay.
** Added seven new maps which cartographers can sell, each pointing to a different village or other structures in a different biome, depending on the biome they come from. These maps can help players who want to quickly find a specific location.
*** Village maps points to a village in a specific biome. Jungle explorer map points to a jungle pyramid. Swamp explorer map points to a swamp hut.
*** Cartographers from different village types will sell a different range of maps and colored banners.
** Some prices and quantities have also been adjusted.
{{anchor|Forementioned}}
[[File:Villager Trade Reblance Cartographer.png|thumb|500px|An image referring to how the different maps for the different village types are connected.]]
[[File:Village Graph.png|thumb|A graph showing where each type of cartographer's maps leads to]]
{{anchor|Biome-dependent cartographer trades}}{{anchor|Biome-dependent maps}}{{anchor|Village maps}}{{anchor|Cartographer}}
:: {| class="wikitable" style="text-align:center"
|+ Available new tradable maps
|-
! !! Desert !! Jungle !! Plains !! Savanna !! Snow !! Swamp !! Taiga
|-
! Group 1
| Savanna Village Map || Savanna Village Map || Savanna Village Map || Desert Village Map || Plains Village Map || Snowy Village Map || Plains Village Map
|-
! Group 2
| Plains Village Map || Desert Village Map || Taiga Village Map || Plains Village Map || Taiga Village Map || Taiga Village Map || Snowy Village Map
|-
! Group 3
| Jungle Explorer Map || Swamp Explorer Map || &ndash; || Jungle Explorer Map || Swamp Explorer Map || Jungle Explorer Map || Swamp Explorer Map
|}
{{TradeTable|title=Cartographer Economic Trades|profession=Cartographer|ignoreUsage=1
|{{TradeLine|lvl=Novice|slot=1|want=Paper|wantQuant=24|multi=0.05|maxTrades=16|xpGain=2}}
|{{TradeLine|lvl=Novice|slot=2|wantQuant=7|give=Empty Map|multi=0.05|maxTrades=12|xpGain=1}}
|{{TradeLine|lvl=Apprentice|slot=3|want=Glass Pane|wantQuant=11|multi=0.05|maxTrades=16|xpGain=10}}
|{{TradeLine|lvl=Apprentice|slot=4|wantQuant=8|want2=Compass|give=Explorer Map|giveSprite=Map|giveNoteText=The structure that the map leads to depends on the biome the villager is from. See [[#Forementioned|the table above]] for more details. Each of the three possible maps are counted as independent trades, so a villager trading multiple maps is possible.|multi=0.2|maxTrades=12|xpGain=5|weight=3}}
|{{TradeLine|lvl=Journeyman|slot=5|want=Compass|multi=0.05|maxTrades=12|xpGain=10}}
|{{TradeLine|lvl=Journeyman|slot=5|want2=Compass|wantQuant=13|give=Ocean Explorer Map|giveNote=explorer_map|giveNoteText={{in|java}}, all copies of the map traded by a particular villager lead to the same structure. In worlds that do not have the structure, this trade is not offered.
{{in|bedrock}}, Cartographers adopting the profession in the Nether or the End do not offer explorer maps.|multi=0.2|maxTrades=12|xpGain=10}}
|{{TradeLine|lvl=Journeyman|slot=6|wantQuant=12|want2=Compass|give=Trial Explorer Map|giveNote=explorer_map|multi=0.2|maxTrades=12|xpGain=10}}
|{{TradeLine|lvl=Expert|slot=7|wantQuant=7|give=Item Frame|maxTrades=12|multi=0.05|xpGain=15}}
|{{TradeLine|lvl=Expert|slot=8|wantQuant=3|multi=0.05|give=Any color Banner|maxTrades=12|xpGain=15|giveNoteText=The list of possible offers contains individual offers for each color, so multiple colors may be offered by the same villager as separate trades.|weight=16}}
|{{TradeLine|lvl=Master|slot=9|wantQuant=8|multi=0.05|give=Globe Banner Pattern|maxTrades=12|xpGain=30}}
|{{TradeLine|lvl=Master|slot=10|wantQuant=14|want2=Compass|multi=0.2|give=Woodland Explorer Map|maxTrades=12|xpGain=30}}
}}

[[File:25w07a and 1.21.70.23 - cartographer trades.jpg|thumb|New cartographer trade prices.]]
{{-}}

'''[[Wandering Trader]]s'''
* The changes to wandering trader trades have been moved from [[Villager Trade Rebalance|experimental features]] and are now available during normal gameplay.
** The Wandering Trader now has better prices, more trades and a larger amount of stock for many items.
** They will also now buy basic supplies from players.
** The Wandering Trader will offer to buy two items from this list:
***{{ItemLink|Water Bottle}}
***{{ItemLink|Water Bucket}}
***{{ItemLink|Milk Bucket}}
***{{ItemLink|Fermented Spider Eye}}
***{{ItemLink|Baked Potato}}
***{{BlockLink|Hay Bale}}
** Wandering Traders now have a chance of selling these items (in addition to their previous trades):
***[[Logs]] (Acacia, Birch, Dark Oak, Jungle, Oak, Spruce, Pale Oak or Cherry)
***Enchanted {{ItemLink|Iron Pickaxe}}
***{{ItemLink|Potion of Invisibility}}
** Trade list now made up by following trades, in order:
*** Buying Trade (new) × 2
*** Special Selling Trade × 2
*** Ordinary Selling Trade × 5
** Added new buying trades, some selling trades, and changed some existing selling trades:
:: {| class="wikitable"
|+ New trades of wandering traders
! Category
! Item wanted
! Quantity
! Item given
! Quantity
! Trades until disabled
|-
| Buying
| {{ItemLink|Baked Potato}}
| 4
| {{ItemLink|Emerald}}
| 1
| 2
|-
| Buying
| {{ItemLink|Fermented Spider Eye}}
| 1
| {{ItemLink|Emerald}}
| 3
| 2
|-
| Buying
| {{BlockLink|Hay Bale}}
| 1
| {{ItemLink|Emerald}}
| 1
| 2
|-
| Buying
| {{ItemLink|Milk Bucket}}
| 1
| {{ItemLink|Emerald}}
| 2
| 2
|-
| Buying
| {{ItemLink|Water Bottle}}
| 1
| {{ItemLink|Emerald}}
| 1
| 2
|-
| Buying
| {{ItemLink|Water Bucket}}
| 1
| {{ItemLink|Emerald}}
| 2
| 2
|-
| Special Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Acacia Log}}
| 8
| 4
|-
| Special Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Birch Log}}
| 8
| 4
|-
| Special Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Cherry Log}}
| 8
| 4
|-
| Special Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Dark Oak Log}}
| 8
| 4
|-
| Special Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Jungle Log}}
| 8
| 4
|-
| Special Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Oak Log}}
| 8
| 4
|-
| Special Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Spruce Log}}
| 8
| 4
|-
| Special Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Pale Oak Log}}
| 8
| 4
|-
| Special Selling
| {{ItemLink|Emerald}}
| 6–20
| {{ItemLink|Iron Pickaxe}} (Enchanted)
| 1
| 1
|-
| Special Selling
| {{ItemLink|Emerald}}
| 5
| {{ItemLink|Potion of Invisibility}} (Long)
| 1
| 1
|}
:: {| class="wikitable"
|+ Changed trades of wandering traders
! Category
! Item wanted
! Quantity
! Item given
! Quantity
! Trades until disabled
|-
| Special Selling
| {{ItemLink|Emerald}}
| 1
| {{ItemLink|Gunpowder}}
| 1 → 4
| 8 → 2
|-
| Special Selling
| {{ItemLink|Emerald}}
| 3 → 1
| {{BlockLink|Packed Ice}}
| 1
| 6
|-
| Special Selling → Ordinary Selling
| {{ItemLink|Emerald}}
| 5 → 3
| {{ItemLink|Bucket of Pufferfish}}
| 1
| 4
|-
| Special Selling → Ordinary Selling
| {{ItemLink|Emerald}}
| 5 → 3
| {{ItemLink|Bucket of Tropical Fish}}
| 1
| 4
|-
| Ordinary Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Lily Pad}}
| 2 → 5
| 5 → 2
|-
| Ordinary Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Brown Mushroom}}
| 1 → 3
| 12 → 4
|-
| Ordinary Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Red Mushroom}}
| 1 → 3
| 12 → 4
|-
| Ordinary Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Vines}}
| 1 → 3
| 12 → 4
|}

[[File:25w07a and 1.21.70.23 - wandering trader trades.jpg|thumb|New wandering trader trade prices.]]
{{-}}

'''[[Zombified Piglin]]'''
* Must now be killed by a [[player]] to drop its Player-specific loot.

=== World generation ===
'''[[Pale Garden]]'''
* Pale Garden biome now occupies more space that was previously taken by [[dark forest]]s.
* [[Woodland Mansion]]s can now generate in Pale Garden biome.

'''[[Village]]s'''
* Pigs and cows spawned in desert villages are now of the warm variant.

=== Gameplay ===
'''[[Advancement]]s'''
* The "Country Lode, Take Me Home" advancement has been moved from the Nether category to the Adventure category.

'''[[Creative]] mode'''
* The tab icon for the Spawn Eggs inventory tab has changed from the [[pig]] spawn egg to the [[creeper]] spawn egg.

'''[[End portal]] and [[exit portal]]'''
* When changing state, any blocks that are in its radius will be dropped as items and also make breaking sounds, rather than outright overwritten.<ref>{{Citation|url=https://cdn.skye.lol/diffs/25w02a_to_25w03a.html|title=25w02a to 25w03a|website=cdn.skye.lol|archive-url=https://web.archive.org/web/20250116170725/https://cdn.skye.lol/diffs/25w02a_to_25w03a.html|section=<code>EndPodiumFeature</code>}}</ref>

'''[[Narrator]]'''
* The volume of the narrator is now affected by the game's configured volume in the 'Voice' category.

'''[[Sound]]s'''
* Ambient block sounds in [[deserts]], [[badlands]] and [[pale gardens]] which are only used for ambience have been moved from <code>Blocks</code> to <code>Ambient/Environment</code> category.
* The breaking sound for <code>grass</code> sound type has been lowered, affecting all blocks using this sound.
* Blocks that are broken by a [[piston]] now play their breaking sound.

=== General ===
'''General'''
* If the game detects that the last startup did not complete normally, the fullscreen option will now be reset.
* Chunks loaded by a portal will now be re-loaded again automatically when the world is reopened.

'''[[Realms]]'''
* Uploading a world to Realms will now enable command blocks by default.
* It's now possible to upload hardcore singleplayer worlds to Realms.

'''[[Tooltip]]'''
* [[Crossbow]]s will now show all charged projectiles in their tooltip instead of just the first.
* Tooltips for [[fireworks]] and [[crossbows]] now show a compact form of multiple repeated stars or projectiles that are identical.

== Technical ==

=== Additions ===
==== Command format ====
'''{{cmd|test}}'''
* A new command used to create and run tests.
** Syntax:
*** {{cmd|test clearall [<radius>]}}
*** {{cmd|test clearthat}}
*** {{cmd|test clearthese}}
*** {{cmd|test create <test> [<width>] [<height> <depth>]}}
*** {{cmd|test locate <selector>}}
*** {{cmd|test resetclosest}}
*** {{cmd|test resetthese}}
*** {{cmd|test resetthat}}
*** {{cmd|test pos [<variable>]}}
*** {{cmd|test run <selector> [<numberOfTimes>] [<untilFailed>] [<rotationSteps>] [<testsPerRow>]}}
*** {{cmd|test runclosest [<numberOfTimes>] [<untilFailed>]}}
*** {{cmd|test runfailed [<numberOfTimes>] [<untilFailed>] [<rotationSteps>] [<testsPerRow>]}}
*** {{cmd|test runmultiple <selector> [<amount>]}}
*** {{cmd|test runthat [<numberOfTimes>] [<untilFailed>]}}
*** {{cmd|test runthese [<numberOfTimes>] [<untilFailed>]}}
*** {{cmd|test stop}}
*** {{cmd|test verify <tests>}}
** Parameters:
*** {{cd|radius}}:
**** The radius to clear tests within.
*** {{cd|test}}: 
**** The namespaced ID of a test.
*** {{cd|selector}}: 
**** A wildcard-enabled selector for test IDs
**** Supports * and ? for matching namespaced IDs
**** If namespace is not supplied, defaults to minecraft
**** Examples:
***** {{cd|*:*}} 
****** Matches all IDs
***** {{cd|*}}
****** Matches everything in the minecraft namespace
***** {{cd|custom:folder/*_test_?}} 
****** Matches IDs in the folder folder of the custom namespace, with a prefix followed by <code>_test_</code> followed by a single valid character
*** {{cd|width}}: 
**** The width of the test structure.
***** If omitted, {{cd|5}} is used.
*** {{cd|height}}: 
**** The height of the test structure .
***** If omitted, the {{cd|width}} is used.
*** {{cd|depth}}: 
**** The depth of the test structure.
***** If omitted, the {{cd|width}} is used.
*** {{cd|variable}}: 
**** The variable name to include in the copied code snippet.
*** {{cd|numberOfTimes}}: 
**** The number of times to repeat each test.
***** If omitted, {{cd|1}} is used.
*** {{cd|untilFailed}}: 
**** Boolean (default false) noting that the test should be stopped as soon as one iteration fails.
*** {{cd|rotationSteps}}: 
**** Number of extra 90 degree steps to apply to the test.
***** If omitted, {{cd|0}} is used.
*** {{cd|testsPerRow}}: 
**** Number of tests to place per row in a grid layout.
***** If omitted, {{cd|8}} is used.
* {{cmd|test clear*}}
** These subcommands clear the structures and blocks associated with the selected tests.
* {{cmd|test create}}
** This subcommand creates a test setup in the current location for the given test, preparing for a structure of the given size. 
** This gives a starting point for creating the structure for the test.
* {{cmd|test locate}}
** Attempts to locate the given test. 
*** Note that only loaded chunks are searched.
* {{cmd|test reset*}}
** These subcommands reset the structures for the selected tests, removing any surrounding barriers and placing the structure in from scratch.
* {{cmd|test pos}}
** Shows the local coordinates to the block pointed at in the test. 
** If the optional variable name is specified, this variable name is used in a code fragment obtained by clicking on the coordinates in the output message.
* {{cmd|test run*}}
** Runs one or more tests. 
*** If multiple tests are run at once, they are placed in a grid and run in parallel, although only up to a certain limit. Beyond that limit, tests are run in rounds where each round completes before any tests from the next round are started.
*** For each test, loads the given structure and runs the associated test. Each test location will have a beacon beam showcasing the test status.
**** Gray beacon = in progress
**** Red = fail (required test)
**** Orange = fail (optional test)
**** Green = success
*** If a test fails, the error is shown on a lectern book and an overlay.
* {{cmd|test stop}}
** Stops all running tests. 
*** Note that gameplay events triggered by tests may still remain.
* {{cmd|test verify*}}
** Verifies one or more tests by running multiple instances of the same test.

==== General ====
'''[[Block-based test]]s'''
* Use [[test block]]s in the test structure to run the test and indicate success or failure.

'''[[Data component format|Data components]]'''
* {{cd|blocks_attacks}} component
** When present, this item can be used like a Shield to block attacks to the holding player.
** Format: object with fields
*** {{cd|block_delay_seconds}} 
**** Non-negative float (default: {{cd|0}}).
**** The number of seconds that right-click must be held before successfully blocking attacks.
*** {{cd|bypassed_by}} – hashtagged damage type tag (optional)
**** If specified, blocking is bypassed by these damage types.
*** {{cd|damage_reductions}}
**** List of object with fields (optional)
**** Controls how much damage should be blocked in a given attack.
**** If not specified, all damage is blocked.
**** Each entry in the list contributes an amount of damage to be blocked, optionally filtered by damage type.
**** Each entry adds to blocked damage, determined by <code>clamp(base + factor * dealt_damage, 0, dealt_damage)</code>.
**** The final damage applied in the attack to the entity is determined by <code>dealt_damage - clamp(blocked_damage, 0, dealt_damage)</code>
**** Entry format:
***** {{cd|type}} – damage type id, list of damage type ids, or hash-prefixed damage type tag (optional).
****** This entry will only contribute to the blocked damage if the dealt damage type matches this field.
****** If not specified, any damage type will be accepted.
***** {{cd|base}} – float
****** Constant amount of damage to be blocked.
***** {{cd|factor}} – float
****** Fraction of the dealt damage that should be blocked.
***** {{cd|horizontal_blocking_angle}} – angle in degrees as a positive float 
****** Default: {{cd|90}}
****** The maximum angle between the user's facing and the incoming attack for the block to be effective.
****** If the blocked damage has no position, the compared angle will be assumed to be the maximum 180.
*** {{cd|disable_cooldown_scale}} 
**** Non-negative float (default: {{cd|1}}).
**** Multiplier applied to the number of seconds that the item will be on cooldown for when attacked by a disabling attack ({{cd|disable_blocking_for_seconds}} on the {{cd|weapon}} component).
**** If {{cd|0}}, this item can never be disabled by attacks.
*** {{cd|item_damage}}
**** Object with fields (optional)
**** Controls how much damage should be applied to the item from a given attack.
**** If not specified, a point of durability is removed for every point of damage dealt.
**** The final damage applied to the item is determined by: <math>floor(base + factor * dealt_damage)</math>.
**** The final value may be negative, causing the item to be repaired.
**** Format:
***** {{cd|threshold}} – non-negative float
****** The minimum amount of damage dealt by the attack before item damage is applied to the item.
***** {{cd|base}} – float
****** Constant amount of damage applied to the item, if threshold is passed.
***** {{cd|factor}} – float
****** Fraction of the dealt damage that should be applied to the item, if threshold is passed.
*** {{cd|block_sound}}
**** Sound event (optional).
**** If specified, this sound will be played when an attack is successfully blocked.
*** {{cd|disable_sound}}
**** Sound event (optional).
**** If specified, this sound will be played when the item goes on its disabled cooldown due to an attack.

* {{cd|break_sound}} component
** When present, this sound will be played when the item runs out of durability and breaks.
** If not present, no sound will be played on break.
** This component is present by default on every item type.
** Format: sound event
*** e.g. <code>break_sound='item.wolf_armor.break'</code>

* {{cd|potion_duration_scale}} component
** When present, for items that have the {{cd|potion_contents}} component, the duration of the applied effects will be scaled by this factor.
** This also applies to {{cd|custom_effects}} in the {{cd|potion_contents}} component, unlike the previous hard-coded scaling factor.
** If not specified, defaults to {{cd|1.0}}.
** Format: non-negative float
** e.g. {{cd|potion_duration_scale{{=}}0.25}}

* {{cd|provides_banner_patterns}} component
** When present, this item can be placed in the pattern slot of a Loom.
** Format: hash-prefixed banner pattern tag.
*** e.g. <code>provides_banner_patterns='#minecraft:pattern_item/globe'</code>

* {{cd|provides_trim_material}} component
** When present, this item will provide the specified trim material when used in a trimming recipe.
*** Note that to be used in the built-in smithing recipes, the item must also be in the {{cd|#trim_material}} tag.
*** As such, the trim material registry definition no longer specifies an item.
** Format: trim material id
*** e.g. <code>provides_trim_material='minecraft:iron'</code>

* {{cd|tooltip_display}} component
** This component allows the tooltips provided specifically by any given item component to be suppressed.
** This replaces the previous {{cd|show_in_tooltip}} fields, {{cd|hide_additional_tooltip}} and {{cd|hide_tooltip}} components.
** Format: object with fields:
*** {{cd|hide_tooltip}} - boolean (default: {{cd|false}}).
**** If true, the item will have no tooltip when hovered.
*** {{cd|hidden_components}} - list of item component ids (default: {{cd|[]}}).
**** The tooltips provided by any component in this list will be hidden.
**** If that component provides no tooltip, it will have no effect.

*{{cd|weapon}} component
** When present, the 'Item Used' statistic will be incremented for each attack with the item.
** The specified amount of damage can be done to the item with each attack.
** Format: object with fields:
*** {{cd|item_damage_per_attack}} – non-negative integer (default: {{cd|1}})
**** The amount to damage the weapon for each attack performed.
*** {{cd|disable_blocking_for_seconds}}
**** Non-negative float (default: {{cd|0}})
**** If non-zero, will disable a blocking Shield on successful attack for the specified amount of seconds.
** e.g. {{cd|weapon{{=}}{damage_per_attack:2}}}

'''Entity components'''
* <code>wolf/sound_variant</code>
** Namespaced ID from <code>wolf_sound_variant</code> registry.

'''[[Function test]]s'''
* Rely on built-in functions to run a test and indicate success or failure. 
** They have one additional field:
*** {{cd|function}}: 
**** The namespaced ID of the Test Function to run.

'''[[Game rule]]'''
* Added the {{cd|allowFireTicksAwayFromPlayer}} game rule.
** Default value: {{cd|false}}.
** When {{cd|true}}, Fire and Lava ticks can occur outside of an 8 chunk range of a player.

* Added the {{cd|tntExplodes}} game rule.
** When {{cd|false}}, [[TNT]] will not explode and cannot be primed by any means.
*** Trying to do so directly, like with a [[flint and steel]], will show a message on the action bar.
*** Powering a TNT block with redstone makes it simply vanish, as does blowing it up with a [[creeper]].
*** A TNT block on [[fire]] can burn up as if it was a [[plank]].
** Default value: {{cd|true}}

'''[[Game tests]]'''
* The Game Tests system is a new integrated system for testing aspects of the game.
* Each test is an asset defining some parameters for how the test gets executed, combined with a saved structure file containing a base setup.
* Generally, the test framework expects to run tests in a separate superflat world.

'''[[Items model definition]]'''
* Select Property
** {{cd|minecraft:component}}
*** New data source has been added to select item model: {{cd|component}}.
*** Returns value of component on item, if any.
*** Fields:
**** {{cd|component}} – namespaced ID of component type.
*** Possible values: depends on component type.

'''[[Tags]]'''
* '''Biome Tags'''
** Added {{cd|#spawns_cold_variant_farm_animals}} – all biomes where cold variant of farm animals spawn.
** Added {{cd|#spawns_warm_variant_farm_animals}} – all biomes where warm variants of farm animals spawn.

* '''Block Tags'''
** Added {{cd|#camels_spawnable_on}} – contains blocks that [[camel]]s can spawn on.
** Added {{cd|#edible_for_sheep}} – contains blocks that can be eaten by [[sheep]] to regrow their [[wool]].
** Added {{cd|#plays_ambient_desert_block_sounds}} – contains blocks that will play ambient desert block sounds.
** Added {{cd|#replaceable_by_mushrooms}} – exhaustive list of all blocks that can be replaced as a mushroom is placed or grows.
** Added {{cd|#sword_instantly_mines}} – blocks that are instantly mined by Swords.

* '''Entity Tags'''
** Added {{cd|#can_equip_saddle}} – contains entities that can be equipped with a saddle. This does not mean that the Saddle will function, just that it can be equipped into the saddle slot.
** Added {{cd|#can_wear_horse_armor}} – contains entity that can hold horse armor in their body slot.

* '''Item Tags'''
** Added {{cd|#book_cloning_target}} – item that can be crafted together with a Written Book to clone it.
** Added {{cd|#eggs}} – contains all variants of the [[egg]] item.
** Added {{cd|#flowers}} – corresponds to the {{cd|#flowers}} block tag.

* '''Structure tags'''
** Added {{cd|#on_savanna_village_maps}} – contains structures that can appear on savanna village maps.
** Added {{cd|#on_desert_village_maps}} – contains structures that can appear on desert village maps.
** Added {{cd|#on_plains_village_maps}} – contains structures that can appear on plains village maps.
** Added {{cd|#on_taiga_village_maps}} – contains structures that can appear on taiga village maps.
** Added {{cd|#on_snowy_village_maps}} – contains structures that can appear on snowy village maps.
** Added {{cd|#on_swamp_explorer_maps}} – contains structures that can appear on swamp explorer maps.
** Added {{cd|#on_jungle_explorer_maps}} – contains structures that can appear on jungle explorer maps.

'''[[Test environment definition|Test environments]]'''
* Test Environments are a way to group up tests and give them the right preconditions to run. 
* A test environment is an asset in the {{cd|test_environment}} registry. 
* Each test environment definition has a {{cd|type}} field that determines its setup:
** {{cd|all_of}} definitions 
*** Apply the setup from several sub-definitions in the {{cd|definitions}} field.
** {{cd|function}} definitions 
*** Use mcfunction files as setup and teardown.
*** {{cd|setup}}: 
**** Optional namespaced ID of the mcfunction to use for setup, if any.
*** {{cd|teardown}}: 
**** Optional namespaced ID of the mcfunction to use for teardown, if any.
** {{cd|game_rules}}: definitions 
*** Set any number of game rules.
*** {{cd|bool_rules}}: 
**** A list of boolean game rules to set and the value to set.
*** {{cd|int_rules}}: 
**** A list of integer game rules to set and the value to set.
*** Each rule is an object with two fields:
**** {{cd|rule}}: 
***** The exact name of the rule to set.
**** {{cd|value}}: 
***** The value to set
*** Game rules are reset to their default values after the test environment has completed.
** {{cd|weather}} definitions
*** Sets the weather state
*** {{cd|weather}}: 
**** The weather to set.
**** One of {{cd|clear}}, {{cd|rain}} and {{cd|thunder}}.
** {{cd|time_of_day}} definitions 
*** Set a given time of day.
*** {{cd|time}}: 
**** The time of day to set in number of ticks, as a non-negative integer.
* The game provides a single, empty test environment by default: {{cd|minecraft:default}}.

'''[[Test instance definition|Test instances]]'''
* Test instances are defined in the registry {{cd|test_instance}}. 
** They're small assets defining a test to run.
** Fields:
*** {{cd|environment}}:
**** Namespaced ID of the test environment to run this test as part of.
*** {{cd|structure}}: 
**** Namespaced ID of the structure to use for the test.
*** {{cd|max_ticks}}:
**** A positive integer representing the maximum number of ticks allowed to pass before the test is considered timed out.
*** {{cd|setup_ticks}}: 
**** Optional non-negative integer.
**** Default: {{cd|0}}
**** Represents a number of ticks to wait after placing the structure before starting the test.
*** {{cd|required}}: 
**** Optional boolean.
**** Default {{cd|true}}
**** Whether the test is considered required to pass for the full test suite to pass.
*** {{cd|rotation}}: 
**** Optional rotation to apply to the test structure.
**** One of {{cd|none}} (default), {{cd|clockwise_90}}, {{cd|180}} and {{cd|counterclockwise_90}}.
*** {{cd|manual_only}}:
**** Optional boolean.
**** Default {{cd|false}}
**** Set to {{cd|true}} for tests that are not included as part of automated test runs.
*** {{cd|sky_access}}: 
**** Whether the test needs clear access to the sky.
**** Default: {{cd|false}}
**** Tests are enclosed in barrier blocks.
**** If set to {{cd|true}}, the top is left open.
*** {{cd|max_attempts}}: 
**** Number of attempts to run the test.
**** Default: {{cd|1}}
*** {{cd|required_successes}}: 
**** Number of attempts that must succeed for the test to be considered successful .
**** Default: {{cd|1}}
*** {{cd|type}}: 
**** The type of test.
**** One of {{cd|block_based}} and {{cd|function}}.

=== Changes ===
==== Command format ====
'''General'''
* Arguments in commands that accept inline values like loot tables, predicates, modifiers, data components, formatted text ({{cmd|loot}}, {{cmd|give}}, {{cmd|tellraw}}, {{cmd|execute if predicate}}, data components in {{cmd|execute if items}}, etc.) have been reverted to accept numbers in place of booleans.

* Text components in commands such as {{cmd|tellraw}} or {{cmd|title}} are now specified with SNBT instead of JSON.
* Text style in the {{cmd|scoreboard}} command when specifying the styled number format is now specified with SNBT instead of JSON.
* The behavior of {{cmd|setblock}} and {{cmd|fill}} commands have changed in how they handle block entity data:
** If the block entity data is not specified, and the existing block has data, the block entity data will be preserved.
** If the block entity data is specified, the block entity data will be set to the specified value.
** To clear the block entity data explicitly, the block entity data must be specified as <code>{}</code>.
** The operation is now successful if either the block state changed or the block entity data changed.

'''{{cmd|bossbar}}, {{cmd|scoreboard}}''', '''and {{cmd|team}}'''
* Text component arguments are now resolved before use in context of entity held in {{cd|@s}}.

'''{{cmd|data}}'''
* Can now create and modify heterogeneous lists transparently.
* Can no longer traverse paths with an empty key (e.g. {{cmd|data get ... foo.''.bar''}})

'''{{cmd|fill}}'''
*  The replace option in the fill command is no longer terminal, and can be followed with additional options.

'''{{cmd|fill}}, {{cmd|clone}}, {{cmd|setblock}}, and {{cmd|place template}}'''
* Accepts a new option: <code>strict</code>.
** If specified, the command will place blocks as-is without triggering block updates and shape updates.
* New syntax for commands to use the new strict option, and more flexible use of replace:
** {{cd|fill|<from> <to> <block> keep}}
** {{cd|fill|<nowiki><from> <to> <block> [replace <filter>] [strict|destroy|hollow|outline]</nowiki>}}
** {{cd|clone|<nowiki>[from <sourceDimension>] <begin> <end> [to <targetDimension>] <destination> [strict] [[replace|masked|filtered <filter>] [force|move|normal]]</nowiki>}}
** {{cd|setblock|<nowiki><pos> <block> [destroy|keep|replace|strict]</nowiki>}}
** {{cd|place template <template> [<pos> [<rotation> [<mirror> [<integrity> [<seed> [strict]]]]]]}}

'''Item slots'''
* The {{cd|horse.saddle}} item slot has been renamed to {{cd|saddle}}, and now supports any entity that can equip a Saddle.
** Driven by the {{cd|equippable}} component.
** Only mobs that normally support saddles will support riding and rendering of the saddle.
** Items in the {{cd|saddle}} slot can apply attribute modifiers as with other equipment.

'''[[NBT format]]'''
* Any interface with NBT data within the game (SNBT representation, {{cmd|data}}) now supports heterogeneous lists, i.e. ones where elements are not of the same type
** Inserting or replacing into a list of a different type with {{cmd|data}} will no longer give an error.
** Inserting into an array type (e.g. <code>[I;1,2,3]</code>) is still type-restricted.
** This means that the 'wrapper' objects previously used to represent heterogeneous lists will no longer be observable by in-game means.
* The NBT file format is unchanged.
** Heterogeneous lists are transformed before storage to bypass NBT constraints.
*** Example transform: <code>['a', {'b':3}]</code> is stored as <code>[{'<nowiki/>':'a'},{'b':3}]</code>.
** Existing external tools will still be able to read NBT files as before, but heterogeneous lists will be displayed in the transformed form.
* No data produced by the game has changed: objects such as Text Components were already producing heterogeneous lists in this form.
* Note: these wrapper objects may never be observed in-game, they are only relevant to developers working with the NBT file or network format directly.

'''[[SNBT]] format'''
* SNBT (textual representation of NBT-like data) has been expanded to accept heterogeneous lists, i.e. ones where elements are not of the same type.
* NBT format is not changed
** If SNBT command argument transforms value to NBT (like arguments of {{cmd|/data}} or {{cmd|/summon}}), lists might be transformed to bypass NBT constraints
*** Example transform: <code>['a', {'b':3}]</code> is stored as <code>[{<nowiki>''</nowiki>:'a'},{'b':3}]</code>
** This transform is not reversed by {{cmd|/data}}
* The text format for describing object-like data in commands (like NBT, text components, predicates, etc.) has been extended.
* SNBT now also supports following operations:
** {{cd|bool(arg)}} - converts argument to boolean.
*** If argument is a boolean value, returns value directly.
*** If argument is a number value, returns true if it is non-zero.
** {{cd|uuid(str)}} - converts string representation of UUID to integer array.
* Implicit infinite float values (like {{Cd|1e1000}}) are now rejected.

* Number Format
** Either whole or fraction parts of a float number can be omitted
*** Examples: {{cd|.1}} and {{cd|1.}} are valid now
** Float numbers now use E notation
*** Example: both {{cd|1.2e3}} and {{cd|1.2E3}}, {{cd|1.2E+3}}, {{cd|12000e-1}} are now a valid way to represent {{cd|1200.0}}
** Integer numbers can now be prefixed with {{cd|0x}} to represent hexadecimal numbers and {{cd|0b}} to represent binary numbers
*** Example: {{cd|0xbad}} (equal to {{cd|2989}}), {{cd|0xCAFE}} (equal to {{cd|51966}}), {{cd|0b101}} (equal to {{cd|5}})
** Integer numbers now can't start with {{cd|0}}
*** Normally (e.g. in Java) it would mean number is in base-8, but this usage is not implemented, to avoid accidental misuse
** Numbers can now contain {{cd|_}} character between sequences of digits (but not at the start or the end of sequence)
*** Example: {{cd|0b10_01}}, {{cd|0xAB_CD}}, {{cd|1_2.3_4__5f}}, {{cd|1_2e3_4}}
** {{cd|NaN}}, {{cd|Inf}} or hexadecimal float representation are NOT supported
** Type suffixes have been extended:
*** Integer type suffixes ({{cd|b}} or {{cd|B}} - byte, {{cd|s}} or {{cd|S}} - short, {{cd|i}} or {{cd|I}} - integer, {{cd|l}} or {{cd|L}}) can now be prefixed with {{cd|s}} (signed) or {{cd|u}} unsigned
*** New suffixes only affect valid range when parsing - values are still stored as signed
**** Example: {{cd|240ub}} is equal to {{cd|-16sb}}, while {{cd|240sb}} does not parse
*** When a suffix is used without {{cd|u}} or {{cd|s}}, it defaults to signed for decimal numbers and unsigned for binary and hexadecimal numbers
*** Note: since {{cd|b}} is also a valid hexadecimal digit, byte sized hexadecimal values can only be written with a signed suffix, like {{cd|0x11ub}} or {{cd|0x11sb}}

* Strings
** Quoted strings can now use escape sequences beyond ', " and \:
*** Unicode escapes:
**** {{cd|\x}} – two digit escape, like {{cd|\x42}}
**** {{cd|\u}} – four digit escape, like {{cd|\u2603}}
**** {{cd|\U}} – eight digit escape, like {{cd|\U00002603}}
**** {{cd|\N{<name>}<nowiki/>}} – named Unicode character, like {{cd|\N{Snowman}<nowiki/>}}
*** Built-in escape sequences:
**** {{cd|\b}} – backspace, Unicode {{cd|\x08}}
**** {{cd|\s}} – space, Unicode {{cd|\x20}}
**** {{cd|\t}} – horizontal tab, Unicode {{cd|\x09}}
**** {{cd|\n}} – linefeed, Unicode {{cd|\u0a}}
**** {{cd|\f}} – form feed, Unicode {{cd|\u0c}}
**** {{cd|\r}} – carriage return, Unicode {{cd|\u0d}}
** Unquoted strings now can’t start with {{cd|0-9}}, {{cd|.}}, {{cd|+}}, {{cd|-}} to avoid accidental collision with numbers

* Number Arrays
** Values in arrays ({{cd|[B;]}}, {{cd|[I;]}}, {{cd|[L;]}}) without a suffix are now assumed to have suffix matching the type of the array
*** Example: {{cd|[B;1,2]}} is equivalent to {{cd|[B; 1b, 2b]}}
** Arrays can now also accept types smaller than the array type
*** Example: {{cd|[I;1b,2s,3]}} is valid and equivalent to {{cd|[I;1i,2i,3i]}}

* Lists
** Lists now accept trailing commas
*** Example: {{cd|[1,2,]}} is valid and equivalent to {{cd|[1,2]}}
*** Only one trailing comma is allowed, and it must come after a valid element - both {{cd|[,]}} and {{cd|[1,,]}} are invalid

* Compounds
** Compounds (maps) now accept trailing commas
*** Example: {{cd|{a:b,<nowiki>}</nowiki>}}
*** Only one trailing comma is allowed, and it must come after a valid key-value pair - both {{Cd|{,<nowiki>}</nowiki>}} and {{cd|{a:b,,<nowiki>}</nowiki>}} are invalid

==== General ====
'''[[Advancement definition]]'''
* The field {{cd|background}} no longer contains {{cd|textures/}} prefix and {{cd|.png}} suffix.

'''[[Atlas]]'''
* {{cd|minecraft:paletted_permutations}} sprite source
** New field:
*** {{cd|separator}}
**** Optional string (default: {{cd|_}}).
**** Value to be used when joining texture and permutation names to produce sprite name.

'''Biome effects'''
* {{cd|dry_foliage_color}} field
** Defines the color used for tinting blocks using dry foliage tinting.

'''[[Block entity format]]'''
* The {{cd|CustomName}} field will no longer be preserved when removed.
* The {{cd|LootTable}} field will no longer be preserved when removed.

* {{cd|campfire}}
** The {{cd|CookingTimes}} and {{cd|CookingTotalTimes}} fields will no longer be preserved when removed.
* {{cd|chiseled_bookshelf}}
** The {{cd|last_interacted_slot}} field now defaults to {{cd|-1}} if not specified.
* {{cd|end_gateway}}
** The {{cd|exit_portal}} field will no longer be preserved when removed.
* {{cd|furnace}}, {{cd|smoker}}, {{cd|blast_furnace}}
** The {{cd|RecipesUsed}} field will no longer be preserved when removed.
* {{cd|hopper}}
** The {{cd|TransferCooldown}} field now default to {{cd|-1}} if not specified.
* {{cd|jigsaw}}
** The {{cd|name}}, {{cd|target}}, and {{cd|pool}} fields now default to {{cd|minecraft:empty}} if not specified.
** The {{cd|final_state}} field now defaults to {{cd|minecraft:air}} if not specified.
* {{cd|sculk_shrieker}} 
** The {{cd|warning_level}} field now defaults to {{cd|0}} if not specified.
* {{cd|skull}}
** The {{cd|note_block_sound}} field will no longer be preserved when removed.
* {{cd|structure_block}}
** The {{cd|ignoreEntities}} and {{Cd|showboundingbox}} fields now default to {{cd|true}} if not specified.
** The {{cd|posY}} field now defaults to {{Cd|1}} if not specified.

'''[[Data component format|Data components]]'''
* {{cd|attribute_modifiers}} component
** Removed the {{cd|show_in_tooltip}} field, replaced by {{cd|tooltip_display}} component.
** This component now always uses its simplified form, with the modifiers field inlined to top-level.
*** e.g. <code>attribute_modifiers={modifiers:[...]}]</code> -> <code>attributes_modifiers=[...]</code>

* {{cd|can_place_on}} and {{cd|can_break}} components
** Removed the {{cd|show_in_tooltip}} field, replaced by {{cd|tooltip_display}} component.
** The predicates field has been inlined to top-level, and supports either a single element or list.
*** e.g. <code>can_place_on={predicates:[{blocks:'stone'},{blocks:'dirt'}]}]</code> -> <code>can_place_on=[{blocks:'stone'},{blocks:'dirt'}]]</code>
*** or: <code>can_place_on={predicates:[{blocks:'stone'}]}]</code> -> <code>can_place_on={blocks:'stone'}]</code>

* {{cd|dyed_color}} component
** Removed the {{cd|show_in_tooltip}} field, replaced by {{cd|tooltip_display}} component.
** This component now always uses its simplified form, with the RGB field inlined to top-level.
*** e.g. <code>dyed_color={rgb:12345}]</code> -> <code>dyed_color=12345]</code>
** The specified color now supports the RGB array format.
*** e.g. <code>dyed_color=[0.5, 1.0, 0.2]</code>

* {{cd|enchantments}} and {{cd|stored_enchantments}} components
** Removed the {{cd|show_in_tooltip}} field, replaced by {{cd|tooltip_display}} component.
** These components now always use their simplified form, with the levels field inlined to top-level.
*** e.g. <code>enchantments={levels:{sharpness:2}}]</code> -> <code>enchantments={sharpness:2}]</code>

*{{cd|equippable}} component
** Can now apply to saddle slot.
** Any mob can now have equipment added in the {{cd|body}} slot as long as the component allows it ({{cd|allowed_entities}}).
** Added new optional field: {{cd|equip_on_interact}} (boolean).
*** If {{cd|true}}, players can equip this item onto a target mob by right-clicking it (as long as this item can be equipped on the target at all).
*** The item will not be equipped if the target already has an item in the relevant slot.
*** If not specified, defaults to {{cd|false}}.

*{{cd|hide_additional_tooltip}} component
** Has been removed and replaced by use of the {{cd|tooltip_display}} component and {{cd|hidden_components}} field.
*** The following components previously covered by the {{cd|hide_additional_tooltip}} component may need to be hidden:
**** {{cd|minecraft:banner_patterns}}
**** {{cd|minecraft:bees}}
**** {{cd|minecraft:block_entity_data}}
***** Specifically, Mob Spawner and Trial Spawner block entity data will display the configured mob.
**** {{cd|minecraft:block_state}}
***** Specifically, the {{cd|honey_level}} property will be displayed in the tooltip for any item with this specified.
**** {{cd|minecraft:bundle_contents}}
**** {{cd|minecraft:charged_projectiles}}
**** {{cd|minecraft:container}}
**** {{cd|minecraft:container_loot}}
**** {{cd|minecraft:firework_explosion}}
**** {{cd|minecraft:fireworks}}
**** {{cd|minecraft:instrument}}
**** {{cd|minecraft:map_id}}
**** {{cd|minecraft:painting/variant}}
**** {{cd|minecraft:pot_decorations}}
**** {{cd|minecraft:potion_contents}}
**** {{cd|minecraft:tropical_fish/pattern}}
**** {{cd|minecraft:written_book_content}}
*** This additionally means that tooltips from the above listed components are no longer restricted to specific item types.
**** Note: for existing items in a world with the {{cd|hide_additional_tooltip}} component, any of the above listed components also present on the same item will be added to the list to hide in {{cd|tooltip_display}}.

* {{cd|hide_tooltip}} component
** Has been removed and replaced by use of the {{cd|tooltip_display}} component and {{cd|hide_tooltip}} field.

* {{cd|jukebox_playable}} component
** Removed the {{cd|show_in_tooltip}} field, replaced by {{cd|tooltip_display}} component.

*{{cd|tool}} component
** Added new optional field: {{cd|can_destroy_blocks_in_creative}} (boolean)
*** If false, players cannot break blocks while holding this tool in Creative Mode.
*** If not specified, defaults to {{cd|true}}.

* {{cd|trim}} component
** Removed the {{cd|show_in_tooltip}} field, replaced by {{cd|tooltip_display}} component.

* {{cd|unbreakable}} component
** Removed the {{cd|show_in_tooltip}} field, replaced by {{cd|tooltip_display}} component.

* Some existing components are now also transferred from spawning item to spawned entity:
** {{cd|minecraft:custom_name}} - any entity.
** {{cd|minecraft:potion_contents}} - Lingering Potion to Area Effect Cloud.
** {{cd|minecraft:potion_duration_scale}} - Lingering Potion to Area Effect Cloud.

'''[[Data pack]]'''
* The [[pack format]] version is now {{cd|71}}.
* Trim pattern and trim material items are no longer specified in the trim registries, but instead in the recipes and items respectively.
* The {{cd|potion}} entity type has been split into {{cd|splash_potion}} and {{cd|lingering_potion}}
* Filled Maps without any {{cd|map_id}} component no longer show an 'Unknown Map' tooltip (invalid IDs will still produce this tooltip)
* New command line argument {{cd|--renderDebugLabels}} is available for the client.
** Adds debug labels to relevant [[Opengl|OpenGL]] objects, making debugging rendering easier for developers.

'''[[Entity data]]'''
* Custom data (previously present only on [[marker]]s) is now available on all entities.
** It is exposed as a {{cd|minecraft:custom_data}} component, so it can be set by spawning items and matched by predicates.
** The component is currently stored in a field called {{cd|data}}.
** It is stored only if it's non-empty.

'''[[Entity format]]'''
* The {{cd|ArmorDropChances}}, {{cd|HandDropChances}}, and {{cd|body_armor_drop_chance}} fields have been merged into a {{cd|drop_chances}} field
** Format: map between equipment slot type and chance value
*** Valid equipment slots: {{cd|head}}, {{cd|chest}}, {{cd|legs}}, {{cd|feet}}, {{cd|mainhand}}, {{cd|offhand}}, {{cd|body}}.
** If not specified or removed, chances will be assumed as default ({{cd|0.085f}}).
** {{cd|e.g. drop_chances:{chest:0.1,feet:1.0}}}
* Drop chances with a default value will no longer be stored, and the {{cd|drop_chances}} field is removed entirely if all defaults.
* Area Effect Clouds have a new field: {{cd|potion_duration_scale}} (float).
** If not specified, defaults to {{cd|1.0}}.
** The duration of the potion effect applied is scaled by this factor.
** Area Effect Clouds created by Lingering Potions will have a scale of {{cd|0.25}}.
* The {{cd|ArmorItems}}, {{cd|HandItems}}, and {{cd|body_armor_item}} fields have been merged into an {{cd|equipment}} field.
** Format: 
*** Map between equipment slot type and item stack.
**** Valid equipment slots: {{cd|head}}, {{cd|chest}}, {{cd|legs}}, {{cd|feet}}, {{cd|mainhand}}, {{cd|offhand}}, {{cd|body}}, {{cd|saddle}}.
*** If not specified or removed, the entity will have no equipment.
*** e.g. {{cd|equipment:{chest:{id:'minecraft:diamond_chestplate'}}}}.
*** This affects all mobs and armor stands, but players are unaffected.
** The data format of saddles has been unified between mobs such as horses and pigs, becoming a new kind of equipment slot (and stored in the {{cd|equipment.saddle}} field)
*** This also replaces the boolean {{cd|Saddle}} flag from pigs and [[Strider|striders]].
*** The Saddle dropping on death is now affected by the {{cd|drop_chances}} field, as with other equipment slots.
** The {{cd|FallDistance}} field has been changed from float to double and is now called {{cd|fall_distance}}.
* The armor and off-hand equipment of players is now also stored in the {{cd|equipment}} field.
** Although items written into the Inventory using armor and off-hand slot numbers still work.
* {{cd|Pos}}, {{cd|Motion}}, and {{cd|Rotation}} values without the correct number of components (3, 3, and 2 respectively) will now be fully discarded, instead of only selecting the specified components.
* The {{cd|SleepingX}}, {{cd|SleepingY}}, and {{cd|SleepingZ}} fields have been collected into a single {{cd|sleeping_pos}} field.
** e.g. {{cd|sleeping_pos: [I;1,2,3]}}
* Block States in the entity data of arrows, [[minecart]]s, block displays, [[endermen]], falling blocks, primed TNT, or piston moving blocks are no longer allowed to be specified as an empty object.
* The {{cd|Tags}} field will no longer be preserved if removed.
* The {{cd|FallFlying}} field will no longer be preserved if removed.
** The {{cd|Health}} and {{cd|Air}} fields now default to their respective maximum value if not specified.

* {{cd|allay}}
** Removed the {{cd|CanDuplicate}} field (controlled by {{cd|DuplicationCooldown}}).
* {{cd|area_effect_cloud}}
** The {{cd|Duration}} field now defaults to {{cd|-1}} if not specified.
** If the {{cd|Duration}} field is {{cd|-1}}, the Area Effect Cloud will never run out.
** This means that an Area Effect Cloud summoned with no duration specified will no longer immediately disappear.
* {{cd|arrow}}, {{cd|spectral_arrow}}, {{cd|trident}}
** The {{cd|inBlockState}} and {{cd|SoundEvent}} fields will no longer be preserved when removed.
** The {{cd|damage}} field now defaults to {{cd|2}} if not specified.
* {{cd|block_display}}, {{cd|item_display}}, and {{cd|text_display}}
** The {{cd|glow_color_override}} field will no longer be preserved when removed.
** The {{cd|interpolation_duration}}, {{cd|teleport_duration}}, and {{cd|start_interpolation}} fields now default to {{cd|0}} if not specified.
** The {{cd|view_range}} field now defaults to {{cd|1}} if not specified.
** The {{cd|shadow_radius}} field now defaults to {{cd|0}} if not specified.
** The {{cd|shadow_strength}} field now defaults to {{cd|1}} if not specified.
** The {{cd|width}} and {{cd|height}} fields now default to {{cd|0}} if not specified.
* {{cd|cat}}
** The {{cd|CollarColor}} field now defaults to {{Cd|14}} (red) if not specified.
* {{cd|creeper}}
** The {{cd|Fuse}} field now defaults to {{cd|30}} if not specified.
** The {{cd|ExplosionRadius}} field now defaults to {{cd|3}} if not specified.
* {{cd|dolphin}}
** Removed {{cd|TreasurePosX}}, {{cd|TreasurePosY}}, {{cd|TreasurePosZ}} fields.
** The {{cd|Moistness}} field now defaults to {{cd|2400}} if not specified.
* {{cd|dragon_fireball}}, {{cd|wind_charge}}, {{cd|breeze_wind_charge}}, {{cd|wither_skull}}, {{cd|small_fireball}}, and {{cd|large_fireball}}
** The {{cd|acceleration_power}} field now defaults to {{cd|0.1}} if not specified.
* {{cd|ender_dragon}}
** The {{cd|DragonDeathTime}} field now defaults to {{cd|0}} if not specified.
* {{cd|evoker_fangs}}, {{cd|area_effect_cloud}}, and all projectiles
** The {{cd|Owner}} field will no longer be preserved when removed.
* {{cd|falling_block}}
** The {{cd|BlockState}} field can now be {{cd|air}} (will despawn immediately) - if otherwise not specified or invalid, defaults to {{cd|sand}}.
** The {{cd|HurtEntities}} field now defaults to {{cd|false}} if not specified (or {{cd|true}} if {{cd|BlockState}} is {{cd|anvil}}).
** The {{cd|FallHurtAmount}} field now defaults to {{cd|0}} if not specified.
** The {{cd|FallHurtMax}} field now defaults to {{cd|40}} if not specified.
** The {{cd|DropItem}} field now defaults to {{cd|true}} if not specified.
** The {{cd|TileEntityData}} field will no longer be preserved if removed.
* {{cd|firework_rocket}}
** The {{cd|ShotAtAngle}} field now defaults to <code>false</code> if not specified.
* {{cd|fox}}
** The {{cd|Trusted}} field now defaults to empty if not specified (and will no longer be merged with the previous state if modified by {{cmd|data}}).
* {{cd|ghast}}
** The {{cd|ExplosionPower}} field now defaults to {{cd|1}} if not specified.
* {{cd|goat}}
** The {{cd|HasLeftHorn}} and {{cd|HasRightHorn}} fields now default to true if not specified.
* {{cd|interaction}}
** The {{cd|width}} and {{cd|height}} fields now default to {{cd|1}} if not specified.
* {{cd|item}}
** The {{cd|Health}} field now defaults to {{cd|5}} if not specified.
** The {{cd|PickupDelay}} field now defaults to {{cd|0}} if not specified.
** The {{cd|Age}} field now defaults to {{cd|0}} if not specified.
** The {{cd|Owner}} and {{cd|Thrower}} fields will no longer be preserved when removed.
* {{cd|item_frame}} and {{cd|glow_item_frame}}
** The {{cd|ItemDropChance}} field now defaults to {{cd|1.0}} if not specified
* {{cd|item_frame}}, {{cd|glow_item_frame}}, {{cd|painting}}, and {{cd|leash_knot}}
** The {{cd|TileX}}, {{cd|TileY}}, and {{cd|TileZ}} fields have been collected into a single {{cd|block_pos}} field.
* {{cd|minecart}}, {{cd|*_minecart}}
** The {{cd|CustomDisplayTile}} field has been removed.
** {{cd|DisplayState}} will now always override the default displayed block state if specified.
** {{cd|DisplayOffset}} may now be specified to override the default offset even without a custom display block state set.
* {{cd|phantom}}
** The {{cd|Size}} field has been renamed to {{cd|size}}.
** The {{cd|AX}}, {{cd|AY}}, and {{cd|AZ}} fields have been collected into a single {{cd|anchor_pos}} field.
* {{cd|player}}
** The {{cd|SpawnX}}, {{cd|SpawnY}}, {{cd|SpawnZ}}, {{cd|SpawnAngle}}, {{cd|SpawnDimension}}, and {{cd|SpawnForced}} fields have been collected into a single {{cd|respawn}} field.
*** Format: object with fields
**** {{cd|pos}} - block position to spawn at.
**** {{cd|angle}} - float, angle to spawn with (default: {{cd|0.0}}).
**** {{cd|dimension}} - dimension id to spawn in (default {{cd|minecraft:overworld}}).
**** {{cd|forced}} - boolean, true if this spawn was set through commands (default: {{cd|false}}).
** The {{cd|enteredNetherPosition}} field has been renamed to {{cd|entered_nether_pos}}, and is now formatted as a list of doubles.
*** e.g. {{cd|entered_nether_pos: [1.0, 2.0, 3.0]}}
* {{cd|primed_tnt}}
** The {{cd|block_state}} field now defaults to {{cd|tnt}} if not specified.
** The {{cd|fuse}} field now defaults to {{cd|80}} if not specified.
** The {{cd|explosion_power}} field now defaults to {{cd|4}} if not specified.
* {{cd|shulker}}
** The {{cd|Color}} field now defaults to {{cd|16}} (no color) if not specified.
* {{cd|shulker_bullet}}
** The {{cd|Dir}} and {{cd|Target}} fields will no longer be preserved when removed.
* {{cd|skeleton}}
** The {{cd|StrayConversionTime}} field will no longer be preserved when removed.
* {{cd|small_fireball}} and {{cd|large_fireball}}
** The {{cd|ExplosionPower}} field now defaults to {{cd|1}} if not specified.
* {{cd|snow_golem}}
** The Pumpkin field now defaults to {{cd|true}} if not specified.
* {{cd|spectral_arrow}}
** The Duration field now defaults to {{cd|200}} if not specified.
* {{cd|tnt_minecart}}
** The {{cd|fuse}} field now defaults to {{cd|80}} if not specified.
** The {{cd|explosion_power}} field now defaults to {{cd|4}} if not specified.
** The {{cd|explosion_speed_factor}} field now defaults to {{cd|1}} if not specified.
* {{cd|trader_llama}}
** The {{cd|DespawnDelay}} field now defaults to {{cd|47999}}.
* {{cd|turtle}}
** The {{cd|HomePosX}}, {{cd|HomePosY}}, and {{cd|HomePosZ}} fields have been collected into a single {{cd|home_pos}} field.
** Removed {{cd|TravelPosX}}, {{cd|TravelPosY}}, and {{cd|TravelPosZ}} fields.
** The {{cd|HasEgg}} field has been renamed to {{cd|has_egg}}.
* {{cd|vex}}
** The {{cd|LifeTicks}} field has been renamed to {{cd|life_ticks}}.
** The {{cd|BoundX}}, {{cd|BoundY}}, and {{cd|BoundZ}} fields have been collected into a single {{cd|bound_pos}} field.
* {{cd|villager}}
** The {{cd|Gossips}} field will no longer be preserved when removed.
** The {{cd|FoodLevel}} and {{cd|Xp}} fields now default to {{cd|0}} if not specified.
** The {{cd|ConversionTime}} field will no longer be preserved when removed.
* {{cd|wandering_trader}}
** The {{cd|wander_target}} field will no longer be preserved when removed.
** The {{cd|DespawnDelay}} field now defaults to {{cd|0}} if not specified.
* {{cd|witch}}, {{cd|ravager}}, {{cd|pillager}}, {{cd|illusioner}}, {{cd|evoker}}, and {{cd|vindicator}}
** The {{cd|patrol_target}} field will no longer be preserved when removed.
* {{cd|wolf}}
** The {{cd|CollarColor}} field now defaults to <code>14</code> (red) if not specified.
* {{cd|zombie}}
** The {{cd|DrownedConversionTime}} field will no longer be preserved when removed.
* {{cd|zombie_villager}}
** The {{cd|Gossips}} field will no longer be preserved when removed.
** The {{cd|Xp}} field now defaults to {{cd|0}} if not specified.
** The {{cd|ConversionTime}} field will no longer be preserved when removed.

'''Entity variant components'''
* Entities now have a set of [[component]]s for configuring variants and other aspects of appearance.
* If those components are present on spawning item (like spawn eggs, mob buckets, minecraft:painting, minecraft:item_frame), they will be applied to new entity
* Components are currently not restored when spawn egg is picked from existing entity
* Added components:
** {{cd|axolotl/variant}} – one of {{cd|lucy}}, {{cd|wild}}, {{cd|gold}}, {{cd|cyan}}, {{cd|blue}}
** {{cd|cat/collar}} – one of 16 dye colors
** {{cd|cat/variant}} – namespaced id from {{cd|cat_variant}} registry
** {{cd|chicken/variant}} – namespaced id from {{cd|chicken_variant}} registry
** {{cd|cow/variant}} – namespaced id from {{cd|cow_variant}} registry
** {{cd|fox/variant}} – one of {{cd|red}}, {{cd|snow}}
** {{cd|frog/variant}} – namespaced id from {{cd|frog_variant}} registry
** {{cd|horse/variant}} – one of {{cd|white}}, {{cd|creamy}}, {{cd|chestnut}}, {{cd|brown}}, {{cd|black}}, {{cd|gray}}, {{cd|dark_brown}}
** {{cd|llama/variant}} – one of {{cd|creamy}}, {{cd|white}}, {{cd|brown}}, {{cd|gray}}
** {{cd|mooshroom/variant}} – one of {{cd|red}}, {{cd|brown}}
** {{cd|painting/variant}} – namespaced id from {{cd|painting_variant}} registry
** {{cd|parrot/variant}} – one of {{cd|red_blue}}, {{cd|blue}}, {{cd|green}}, {{cd|yellow_blue}}, {{cd|gray}}
** {{cd|pig/variant}} – namespaced id from {{cd|pig_variant}} registry
** {{cd|rabbit/variant}} – one of brown, {{cd|white}}, {{cd|black}}, {{cd|white_splotched}}, {{cd|gold}}, {{cd|salt}}, {{cd|evil}}
** {{cd|salmon/size}} – one of {{cd|small}}, {{cd|medium}}, {{cd|large}}
** {{cd|sheep/color}} – one of 16 dye colors
** {{cd|shulker/color}} – one of 16 dye colors
** {{cd|tropical_fish/base_color}} – one of 16 dye colors
** {{cd|tropical_fish/pattern}} – one of {{cd|kob}}, {{cd|sunstreak}}, {{cd|snooper}}, {{cd|dasher}}, {{cd|brinely}}, {{cd|spotty}}, {{cd|flopper}}, {{cd|stripey}}, {{cd|glitter}}, {{cd|blockfish}}, {{cd|betty}}, {{cd|clayfish}}
** {{cd|tropical_fish/pattern_color}} – one of 16 dye colors
** {{cd|villager/variant}} – one of {{cd|desert}}, {{cd|jungle}}, {{cd|plains}}, {{cd|savanna}}, {{cd|snow}}, {{cd|swamp}}, {{cd|taiga}}
** {{cd|wolf/collar}} – one of 16 dye colors
** {{cd|wolf/variant}} – namespaced id from {{cd|wolf_variant}} registry
* Mob buckets and paintings available in creative menu will now use new variants instead of {{cd|minecraft:entity_data}} component.
* Custom tooltips for [[bucket of tropical fish]] and [[painting]] items are now based on new components instead of {{cd|minecraft:bucket_entity_data}} and {{cd|minecraft:entity_data}}.
* Cat and Frog variants are now data-driven.
* Added uniform way to define variant selection rules.

'''Equipment assets'''
* Equipment assets may now define new layer types:
** {{cd|pig_saddle}} – equipment layer for Pig saddles
** {{cd|strider_saddle}} – equipment layer for Strider saddles
** {{cd|camel_saddle}} – equipment layer for Camel saddles
** {{cd|horse_saddle}} – equipment layer for Horse saddles
** {{cd|donkey_saddle}} – equipment layer for Donkey saddles
** {{cd|mule_saddle}} – equipment layer for Mule saddles
** {{cd|skeleton_horse_saddle}} – equipment layer for Skeleton Horse saddles
** {{cd|zombie_horse_saddle}} – equipment layer for Zombie Horse saddles
* The following textures have been moved to support the use of equipment assets for saddles:
** {{cd|entity/pig/pig_saddle.png}} →&nbsp;{{cd|entity/equipment/pig_saddle/saddle.png}}
** {{cd|entity/strider/strider_saddle.png}} →&nbsp;{{cd|entity/equipment/strider_saddle/saddle.png}}
* The following textures have been split from their base entity texture to support the use of equipment assets for saddles:
** {{cd|entity/camel/camel.png}} →&nbsp;{{cd|entity/equipment/camel_saddle/saddle.png}}
** {{cd|entity/horse/horse_<variant>.png}} →&nbsp;{{cd|entity/equipment/horse_saddle/saddle.png}}
** {{cd|entity/horse/donkey.png}} →&nbsp;{{cd|entity/equipment/donkey_saddle/saddle.png}}
** {{cd|entity/horse/mule.png}} →&nbsp;{{cd|entity/equipment/mule_saddle/saddle.png}}
** {{cd|entity/horse/horse_skeleton.png}} →&nbsp;{{cd|entity/equipment/skeleton_horse_saddle/saddle.png}}
** {{cd|entity/horse/horse_zombie.png}} →&nbsp;{{cd|entity/equipment/zombie_horse_saddle/saddle.png}}
* Equipment layers configured to be <code>dyeable</code> will now show if the <code>dyed_color</code> component is present on the item, even if the item is not in the <code>#dyeable</code> tag.

'''[[Items model definition]]'''
* Select Property
** {{cd|minecraft:component}} 
*** If the selected value comes from a registry and the current datapacks does not provide it, the entry will be silently ignored.
**** In previous snapshot, unrecognized elements caused the whole item model to be ignored.

* Boolean Property
** {{cd|minecraft:component}}
*** New conditional model property has been added to condition item model: {{cd|component}}
*** Uses component predicates (like ones used in item predicates) to match item components.
**** However, instead of encoding them as a map of {{cd|<predicate type>:<predicate value>}}, a single predicate is encoded in two fields.
*** Fields:
**** {{cd|predicate}} – type of component predicate (member of {{cd|minecraft:data_component_predicate_type}} registry)
**** {{cd|value}} – predicate-specific value

'''Loot Functions'''
* {{cd|toggle_tooltips}}
** Now supports any component id in the toggles map.
** Any component specified will be toggled in the {{cd|tooltip_display}} component.

'''Network protocol'''
* The client-bound {{cd|player_chat}} packet now contains an index increasing for every message sent to the client.
** The index starts at 0 when logging in (or is reset by configuration phase and the {{cd|login}} packet).
** For every message, the server should increment this value by 1.
** If this value updates in an unexpected way, the client will disconnect.
** As the protocol requires that every chat packet reaches the client in produced order, the goal is to enable faster detection of missed/reordered chat messages for custom server developers.
* The server-bound {{cd|chat}} and {{cd|chat_command_signed}} packets now contain a checksum byte along with the 'last seen' update.
** This is a simple hash of the 'last seen' signatures which should be reconstructed by the server, allowing quicker detection of de-synchronized state.
** This can be passed as {{cd|0}} to disable the check, for compatibility with protocol translation.

'''[[Particle format]]'''
* The particle type {{cd|tinted_leaves}} now has a parameter:
** {{cd|color}}
*** Tint color, specified either as packed int or list of 4 floats.

'''[[Predicate]]s'''
* Block predicates
** New optional fields have been added to block predicates: {{cd|components}} and {{cd|predicates}}.
** Their functionality and format are identical to the fields {{cd|components}} and {{cd|predicates}} on item predicates, but they operate on block entity components (when present).
*** When present, {{cd|components}} will match exact contents of block entity components.
*** When present, {{cd|predicates}} will match partial contents of block entity components.

* Entity predicates
** A new optional field was added to entity predicate: {{cd|components}}.
*** When present, predicate will match contents of entity components.
*** Format: 
**** Map of component type key to matching component values.
** A new optional field has been added to entity predicates: {{cd|predicates}}.
*** Its functionality and format is identical to the field {{cd|predicates}} on item predicates, but they operate on entity components.
**** When present, {{cd|predicates}} will match partial contents of entity components.
** The following entity sub-predicates have been removed and replaced with combination of {{cd|components}} predicate and variant entity components:
*** {{cd|minecraft:axolotl}}
*** {{cd|minecraft:fox}}
*** {{cd|minecraft:mooshroom}}
*** {{cd|minecraft:rabbit}}
*** {{cd|minecraft:horse}}
*** {{cd|minecraft:llama}}
*** {{cd|minecraft:villager}}
*** {{cd|minecraft:parrot}}
*** {{cd|minecraft:salmon}}
*** {{cd|minecraft:tropical_fish}}
*** {{cd|minecraft:painting}}
*** {{cd|minecraft:cat}}
*** {{cd|minecraft:frog}}
*** {{cd|minecraft:wolf}}
*** {{cd|minecraft:pig}}
** The field {{cd|color}} has been removed from {{cd|minecraft:sheep}} sub-predicate.
** The {{cd|stepping_on}} entity predicate can only evaluate to {{cd|true}} if the entity is on ground.

'''[[Recipe]]s'''
* {{cd|crafting_transmute}}
** The result field now supports specifying a count and a components patch to apply to the result.
** The components patch is applied to the final transmuted item.
** The new format is an object with fields:
*** {{cd|id}} – item id
*** {{cd|count}} – positive integer (default: {{cd|1}})
*** {{cd|components}} – a component patch object (default: empty)
*** e.g. <code><nowiki>"result": {"id": "minecraft:stick", "count": 3, "components": {"!minecraft:damage": {}, "minecraft:enchantment_glint_override": {}}}</nowiki></code>
** The field can still be defined as before as an inline item id (e.g. {{cd|"result": "minecraft:stick"}})

* {{cd|smithing_transform}} recipe type
** The {{cd|base ingredient}} field is no longer optional
*** Previously, if no base ingredient was given, the recipe would parse but never be usable.

* {{cd|smithing_trim}} recipe type
** The {{cd|base}}, {{cd|template}}, and {{cd|addition ingredient}} fields are no longer optional.
*** Previously, if these ingredients were not given, the recipe would parse but never be usable.
** Added new {{cd|pattern}} field, controlling which trim pattern will be applied in the recipe.
*** As such, the trim pattern registry definition no longer specifies the item.
*** Format: trim pattern id
**** e.g. <code>"pattern": "minecraft:bolt"</code>

'''[[Resource pack]]'''
* The [[pack format]] version is now {{cd|55}}.
* Added textures for new falling leaves particles.
* Added textures for new Wildflowers block.
* Added break, place, step, fall and hit sounds for Iron Blocks, Iron Bars, Iron Trapdoors, Iron Doors and Heavy Weighted Pressure Plates.
* Added the possibility to tint blocks based on a dry foliage color map.
* Added colormap texture for tinting dry foliage tinted blocks.
* Removed {{cd|spawn_egg.png}} and {{cd|spawn_egg_overlay.png}}.
* The texture <code>sheep_fur</code> has been renamed to <code>sheep_wool</code>.
* The texture <code>pig</code> has been renamed to <code>temperate_pig</code>.
* Added new textures for Pig variants:
** {{cd|cold_pig}}
** {{cd|warm_pig}}
* Changed the size of {{cd|temperate_pig}} texture.
* Pig variants can be data-driven by adding entries to {{cd|data/<namespace>/pig_variant/<id>.json}}
** This feature is experimental.
** Fields in file:
*** {{cd|model}} – one of: {{cd|normal}}, {{cd|cold}} .
*** {{cd|texture}} – texture id for this variant, resolves to {{cd|assets/<namespace>/textures/<path>.png}}.
*** {{cd|biome}} – single entry, list or a tag describing biomes in which this variant naturally spawns.
**** If not specified, this variant will only be selected if no other variant matches the current biome.
* Added new equipment asset layer type for Pigs and Striders, and moved saddle textures.
* Changed the size of {{cd|pig_saddle}} texture.
* The texture <code>cow</code> has been renamed to <code>temperate_cow</code>.
* Added new textures for cow variants.
** <code>cold_cow</code>
** <code>warm_cow</code>
* Changed the size of <code>temperate_cow</code> texture.
* Changed the size of <code>red_mooshroom</code> and <code>brown_mooshroom</code> textures.
* The temperate Cow has an updated model and texture.
** Cow models now have a snout.
** Cow models now have their legs mirrored.
* Cow variants can be data-driven adding entries to <code>data/<namespace>/cow_variant/<id>.json</code>.
** This feature is experimental.
** Fields in file:
*** <code>model</code> – one of: <code>normal</code>, <code>cold</code>, <code>warm</code>.
*** <code>asset_id</code> – namespaced id for this variant asset, resolves to <code>assets/<namespace>/textures/<path>.png</code>.
*** <code>spawn_conditions</code> – field described in uniform variant selection above.
* The texture <code>chicken</code> has been renamed to <code>temperate_chicken</code>.
* The <code>temperate_chicken</code> texture has been moved to a new folder:
** <code>entity/chicken.png</code> →&nbsp;<code>entity/chicken/temperate_chicken.png</code>
* Added new textures for chicken variants:
** <code>cold_chicken</code>
** <code>warm_chicken</code>
* Chicken variants can be data-driven adding entries to <code>data/<namespace>/chicken_variant/<id>.json</code>.
** This feature is experimental.
** Fields in file:
*** <code>model</code> – one of: <code>normal</code>, <code>cold</code>.
*** <code>asset_id</code> – namespaced id for this variant asset, resolves to <code>assets/<namespace>/textures/<path>.png</code>.
*** <code>spawn_conditions</code> – field described in uniform variant selection above.

* "Global" uniforms may now be defined in any shader, and the game will attempt to fill it.
** Currently, these are: {{cd|ModelViewMat}}, {{cd|ProjMat}}, {{cd|TextureMat}}, {{cd|ScreenSize}}, {{cd|ColorModulator}}, {{cd|Light0_Direction}}, {{cd|Light1_Direction}}, {{cd|GlintAlpha}}, {{cd|FogStart}}, {{cd|FogEnd}}, {{cd|FogColor}}, {{cd|FogShape}}, {{cd|LineWidth}}, {{cd|GameTime}}, {{cd|ModelOffset}}.
** The type of the uniform must match what it would normally be, or it'll be undefined behavior.

* Item rendering
** [[Item Display]]
*** {{cd|firstperson_lefthand}} and {{cd|thirdperson_lefthand}} transforms are now rendered the same as when held in hand.
** Item Entity
*** When on ground, model size is now taken into account when determining hovering motion.
**** That means that models should never clip into the block below, no matter what size they are.
*** Positioning of items in an item stack on ground now depends on model size and model type.
**** If model depth (Z coordinate) is below 1/16th of a block, item is rendered as flat stack of items.
**** Otherwise model is rendered as a cluster of items offset in all directions around center.
**** Previously, flat stack rendering happened only for models with {{cd|builtin/generated}} parent.

'''[[Server.jar]]'''
* Added the entry point {{cd|net.minecraft.gametest.Main}}.
** Automatically starts a server, runs all available game tests and then exits.
** Options:
*** {{cd|--help}} – Shows usage information
*** {{cd|--packs <path>}} – Set a folder of [[datapacks]] to include in the world
**** Any zip file or folder with a {{cd|pack.mcmeta}} file is included
*** {{cd|--report <path>}} – Exports results in a junit-like XML report at the given path
*** {{cd|--tests <selection>}} – Specify which tests to run with a selection - a wildcard expression matching namespace test instance IDs
**** If omitted, or used with an empty ID, runs all tests
*** {{cd|--universe <path>}} – The path to where the test server world will be created
**** Any existing folder will be replaced
**** Default: {{cd|gametestserver}}
*** {{cd|--verify <boolean>}} – Enables test verification
**** Runs the tests specified with {{cd|test}} or {{cd|testNamespace}} 100 times for each 90 degree rotation step
**** Default: {{cd|false}}
** Example usage: {{cd|java -DbundlerMainClass{{=}}"net.minecraft.gametest.Main" -jar server.jar --packs mytestpacks}}

'''[[Shaders]]'''
* Shader program definitions for core shaders and post-processing effects as JSON files have been removed.
* The shader programs themselves are still available and can be overridden.
* The post-processing effects are still configurable as JSON.
* Post-process Effect Definitions
** The field program was replaced with {{cd|vertex_shader}} and {{cd|fragment_shader}}.
*** {{cd|<namespace>:<path>}} will resolve to <code>assets/<namespace>/shaders/<path>.<vsh|fsh></code>.
** {{cd|type}} is now a required field for each {{cd|uniform}}.
*** Possible values are currently {{cd|int}}, {{cd|ivec3}}, {{cd|float}}, {{cd|vec2}}, {{cd|vec3}}, {{cd|vec4}}, {{cd|matrix4x4}}.
** {{cd|values}} in each {{cd|uniform}} is now optional.
*** Leaving it unset is not recommended and is used for runtime configuration of the blur effect.
** Leaving a uniform unspecified results in undefined behavior, the player must specify each one that will be used by the shaders.

'''[[Tag]]s'''
* Added {{cd|cactus_flower}} and {{cd|wildflowers}} to the {{cd|#bee_attractive}}, and {{cd|#flowers}} block tags, and the {{cd|#bee_food}} item tag.
* Added {{cd|d=and|bush|firefly_bush|leaf_litter|short_dry_grass|tall_dry_grass}} to the {{cd|#replaceable_by_trees}} block tag.
* Added {{cd|d=and|bush|leaf_litter|short_dry_grass|tall_dry_grass}} to the {{cd|#replaceable}} block tag.
* Added {{cd|leaf_litter}}, and {{cd|wildflowers}} to the {{cd|#inside_step_sound_blocks}} block tag.
* Added {{cd|cactus_flower}} to the {{cd|#enderman_holdable}} and {{cd|#wall_post_override}} block tags.
* Added {{cd|test_block}}, and {{cd|test_instance_block}} to the {{cd|#dragon_immune}}, and {{cd|#wither_immune}} block tags.
* Added {{cd|pale_garden}} to the {{cd|#has_structure/woodland_mansion}} biome tag.
* Added {{cd|d=and|cactus|campfire|dry_out|hot_floor|in_fire|lava|lightning_bolt|sweet_berry_bush}} to the {{cd|#bypasses_shield}} damage type tag.
* Changed the {{cd|#big_dripleaf_placeable}} block tag, effectively removing {{cd|pale_moss_block}} from the contents.
* Renamed {{cd|#dead_bush_may_place_on}} block tag to {{cd|#dry_vegetation_may_place_on}}, and added {{cd|farmland}}.
* Fixed the {{cd|#is_overworld}}, and {{cd|#has_structure/trial_chambers}} biome tags to contain all required biomes.
* Removed blocks that mine instantly without a tool from the {{cd|#mineable/axe}}, and {{cd|#sword_efficient}} block tags.
* Removed {{cd|#default_spawns}} and {{cd|#full_moon_spawns}} cat variant tags.

'''[[Text component format]]'''
* Text Components are no longer stored as JSON wrapped by a string.
* The format itself is the same as before, but inlined directly into the outer structure.
* For example, the item component <code>minecraft:custom_name="{"text":"Renamed item"}"</code> will become <code>minecraft:custom_name={text:'Renamed item'}</code>.
* This includes Text Components passed as arguments to commands such as {{cmd|tellraw}} or {{cmd|title}}.
** For example, {{cmd|tellraw @s '{"text":"Hello world"}'}} may become <code>tellraw @s {text:'Hello world'}}</code>.
* Note: in the case where Text Components are embedded in [[NBT format|NBT]], no distinction exists between boolean and integer types.
** To pass boolean arguments to translations, the string form must be used.
* For Text Components with the NBT type and interpret set to true, Text Components will be parsed from the given NBT directly rather than converting to string and parsing as JSON.

* Hover Events
** The <code>hoverEvent</code> field has been renamed to <code>hover_event</code>.
** For the <code>show_text</code> action:
*** <code>contents</code> field has been renamed to <code>value</code>.
*** e.g. <code>{action:'show_text',contents:'Hello world'} becomes {action:'show_text',value:'Hello world'}</code>
** For the <code>show_item</code> action:
*** The {{cd|text}} field has been renamed to {{cd|value}}.
*** The <code>contents</code> field has been inlined.
*** e.g. <code>{action:'show_item',contents:{id:'minecraft:stick',count:2}} becomes {action:'show_item',id:'minecraft:stick',count:2}</code>
*** If contents was specified only as an item id, it is replaced with the full format and inlined.
*** e.g. <code>{action:'show_item',contents:'minecraft:stick'}</code> becomes <code>{action:'show_item',id:'minecraft:stick'}</code>
** For the <code>show_entity</code> action:
*** The <code>contents</code> field has been inlined.
*** The <code>id</code> field has been renamed to <code>uuid</code>.
*** The <code>type</code> field has been renamed to <code>id</code>.
*** e.g. <code>{action:'show_entity',contents:{id:[I;0,0,0,0],type:'minecraft:pig'}} becomes {action:'show_entity',uuid:[I;0,0,0,0],id:'minecraft:pig'}</code>

* Click Events
** The <code>clickEvent</code> field has been renamed to <code>click_event</code>
** For the <code>open_url</code> action:
*** The <code>value</code> field has been renamed to <code>url</code>
*** The click event will no longer parse if not a valid URI with either <code>https://</code> or <code>http://</code> schemes, instead of simply not working.
*** e.g. <code>{action:'open_url',value:'https://minecraft.net'} becomes {action:'open_url',url:'https://minecraft.net'}</code>
** For the <code>run_command</code> action:
*** The <code>value</code> field has been renamed to <code>command</code>.
*** The click event will no longer parse if the command contains disallowed characters, instead of simply not working.
*** It is no longer required that the specified command field has a <code>/</code> prefix.
*** e.g. <code>{action:'run_command',value:'/say Hi'} becomes {action:'run_command',command:'/say Hi'}</code>.
** For the <code>suggest_command</code> action:
*** The value field has been renamed to command.
*** The click event will no longer parse if the command contains disallowed characters, instead of simply not working.
*** e.g. <code>{action:'suggest_command',value:'/help'} becomes {action:'suggest_command',command:'/help'}</code>
** For the <code>change_page</code> action:
*** The value field has been renamed to page.
*** The page value now requires a positive integer instead of a string.
*** e.g. <code>{action:'change_page',value:'1'} becomes {action:'change_page',page:1}</code>
** The <code>copy_to_clipboard</code> format is unchanged.

'''Uniform variant selection'''
* Variants that have spawn rules now use uniform approach for selecting.
** Selection process:
*** Every variant field {{cd|spawn_conditions}} that contain a list of entries.
*** Every entry has a condition and an integer priority.
*** Conditions for all variants for given entity type are evaluated for position where entity is being spawned.
*** Entries with priority lower than maximum priority of remaining entries are removed.
*** The game randomly picks one entry out of remaining ones.
*** If no conditions are remaining, variant remains unchanged from default.
** Entry format:
*** {{cd|priority}} – integer
*** {{cd|condition}} – optional structure
**** Fields:
***** {{cd|type}}
***** Additional fields dependent on {{cd|type}}.
**** If field is not present, condition is always true.

* Spawn conditions
** {{cd|minecraft:biome}}
*** Checks if entity is spawning in specific biomes.
*** Fields:
**** {{cd|biomes}} – single entry, list or a tag describing biomes.
** {{cd|minecraft:moon_brightness}}
*** Checks if current moon brightness is within certain range.
*** Fields:
**** {{cd|range}} – floating point range (a single number or an object like <code>{"min": 1, "max": 2}</code>).
** {{cd|minecraft:structure}}
*** Checks if entity is spawning in specific structures.
*** Fields:
**** {{cd|structures}} – single entry, list or a tag describing structures.

* Wolf Variants
** The fields {{cd|angry_texture}}, {{cd|tame_texture}}, and {{cd|wild_texture}} have been grouped in field {{cd|assets}} and renamed to {{cd|angry}}, {{cd|tame}}, and {{cd|wild}}.
** Added the field {{cd|spawn_conditions}}.

* Pig Variants
** {{cd|texture}} and {{cd|biome}} fields are replaced with {{cd|asset_id}} and {{cd|spawn_conditions}} respectively.
** Fields in file:
*** {{cd|asset_id}} – namespaced id for this variant asset, resolves to {{cd|assets/<namespace>/textures/<path>.png}}.
*** {{cd|spawn_conditions}} – field described in uniform variant selection above

* Cat variants
** Cat variants can be data-driven by adding entries to {{cd|data/<namespace>/cat_variant/<id>.json}}.
** This feature is experimental.
** Fields in file:
*** {{cd|asset_id}} – namespaced id for this variant asset, resolves to {{cd|assets/<namespace>/textures/<path>.png}}.
*** {{cd|spawn_conditions}} – field described in uniform variant selection above

* Frog variants
** Frog variants can be data-driven by adding entries to {{cd|data/<namespace>/frog_variant/<id>.json}}.
** This feature is experimental.
** Fields in file:
*** {{cd|asset_id}} – namespaced id for this variant asset, resolves to {{cd|assets/<namespace>/textures/<path>.png}}.
*** {{cd|spawn_conditions}} – field described in uniform variant selection above

'''[[Title screen]]'''
* The [[panorama]] was changed to showcase the [[Spring to Life]].


== Bugs ==
Referring to the ability to place dead bushes on farmland:

If the player attempts to place a seed on the same farmland block as an existing dead bush then the seed will override the dead bush and the dead bush will be broken without any particles or block drops.

== Fixes ==
{{fixes|project=MC|fixedin=25w02a,25w03a,25w04a,25w05a,25w06a,25w07a,25w08a,25w09a,25w09b,25w10a,1.21.5-pre1,1.21.5-pre2,1.21.5-pre3,1.21.5 Release Candidate 1,1.21.5 Release Candidate 2
|;From released versions before 1.21
|7697|Tridents or arrows shot through lava sometimes don't catch fire.
|13738|Invisible saddle when using invisibility potion on a horse, donkey or mule.
|55800|Successful "{{cmd|/fill air destroy}}" commands give error message and return 0 for result/success.
|56653|Zombified Piglins drop XP and rare drops if killed by anything while in angered state.
|80243|Saddles don't apply attribute modifiers when worn by entities.
|90212|You cannot hang on to climbable blocks while gliding with elytra.
|93185|The exit portal in the end generates at highest block at 0 0 which can make it generate incomplete.
|97244|The "{{cd|minecraft:enchant.thorns.hit}}" sound event doesn't play when non-player entities are damaged by the thorns enchantment.
|98271|The sound of blocking with a shield is only hearable by other players (not the person blocking).
|101556|Nether Portal teleport range is too large (equivalent to a full block).
|108495|Non-LivingBase entities can be on a team (and show color) but can't be targeted using {{cd|team{{=}}}}.
|113878|Attribute modifiers description for chest is misleading / "When on body" instead of "When on chest".
|117574|Using {{cmd|setblock}} or {{cmd|fill}} to re-place a block entity keeps old NBT (if no NBT specified) but clears inventories, even when the command fails.
|118092|Crafting recipe unlock toast says "New Recipes Unlocked!" even when only one recipe was unlocked.
|118470|Narrator plays at full volume when volume is off.
|122840|"{{cmd|/data remove}}" cannot delete {{cd|beam_target}} tag in End Crystals.
|128079|Statistic for using shears doesn't increase when mining certain blocks.
|135192|Boats are immediately sunken if there is a string on the surface of the water.
|141297|You cannot set lit state of redstone torches using {{cmd|setblock}}, debug stick and {{cd|BlockStateTag}}, to be to opposite of the situation it would be in.
|152382|End gateways and end portals don't fade away with render distance fog.
|153392|Unable to remove villager gossips using {{cmd|/data remove}}.
|157196|Tamed animals cannot be added to a team.
|160304|Sneaking on ice can change direction of movement to lines along axis.
|165421|Bubble columns have the opposite effect on wind charges.
|165461|Crossbow loading animation stops after loading, even when still holding down right click.
|165711|Eye of ender hitbox always lags behind the animation.
|167125|Rounding error on fall damage.
|168262|Dead bushes cannot be placed on farmland.
|170134|Minecraft uses several times more VRAM than needed after exploring terrain for a while.
|176233|Crossbows no longer have a transition after loading.
|177522|Wolf barking and whining sounds are subtitled as "Wolf pants".
|183329|Nether portal teleport overlay does not show up if the player has the nausea effect.
|183623|Hardcore worlds in the world menu have a comma after the red exclamation mark.
|184530|Player movement at low speeds is biased towards cardinal directions.
|184681|Customized worlds still say "Buffet world customization" since 20w21a.
|186241|World border faces are rendered incorrectly with "Fabulous!" graphics.
|189525|Armored entities from pre-1.9 worlds upgrade to dual wielding armor.
|190000|Saddles equipped on horses cannot be replaced without removing them first.
|193404|Changing a powered or activator rail to powered using a debug stick or {{cmd|setblock}} does not work.
|200311|Advancement background texture referencing is inconsistent with models.
|202226|{{cmd|recipe}} give or take for one recipe says "recipes".
|203550|Blocks broken by pistons do not play breaking sounds.
|220091|Summoning {{cd|falling_block}} entities with {{cd|BlockState}} NBT set to any air block ({{cd|air}}, {{cd|cave_air}}, {{cd|void_air}}) default to {{cd|sand}}.
|220672|Inconsistent pluralization in customize world preset heading source string.
|222876|"Buffet world customization" is incorrectly capitalized.
|226772|Shulker box opening / closing subtitle shows "Shulker".
|227097|End portals delete blocks that are inside of the portal.
|230445|End portals and end gateways are not rendered properly with the Blindness or Darkness effects.
|236100|End crystal beam appears to be black.
|239705|Sprinting forward while facing a certain angle pushes the player either to the left or to the right.
|241951|Player momentum on X and Z axis are cancelled separately at low values.
|248099|Mob pathfinding breaks after falling into water accidentally while walking.
|253721|Wrong logs when running {{cmd|op @a}}.
|255756|When the shield is broken between players, the attacking side has no shield breaking sound.
|256469|Invisible camels don't show their saddles.
|258253|Spawn egg particles use an uncolored spawn egg overlay.
|260440|Players can no longer activate swimming mode in water while flying with elytra.
|261385|Bubble columns act differently at the surface depending on non-air blocks.
|262928|The "{{cd|minecraft:entity.player.hurt}}" sound is no longer played when players receive thorns damage from guardians or elder guardians.
|262939|Changing dimensions or respawning with nausea effect active displays nether portal overlay.
|265514|HRTF stuck on even when directional audio is set to off in update 1.20.2.
|266912|Saddle equipping sounds aren't played when saddles are equipped on horses, donkeys, mules, or camels shortly after the said entity is summoned.
|267221|"{{cd|value}}" within "{{cd|change_page}}" {{cd|clickEvent}} json looks for a string instead of an integer.
|267323|Items fields with old boolean JSON formatting are cleared upon world update.
|268942|The swimming animation no longer displays when gliding with an elytra and swimming at the same time.
|269386|Flow Pottery Sherd is not in the correct spot in the creative inventory.
|269637|Horses can wear multiple saddles but not multiple horse armor.
|270043|Reduced armor glint applies to tridents.
|270192|The saddles of some entities stay visible through their death animation.
|270197|The saddle on pigs and striders stays visible through their death animation.
|270220|Granting all advancements results in prolonged, disruptive and loud audio spam.
|272100|Unused palette pixels in horse textures ({{cd|horse_[brown/chestnut/creamy/white].png}}).
|272790|Shulker boxes and other blocks in the end exit portal when it changes state are not dropped as items.
|279646|Toggling fullscreen with F11 does not visually update the fullscreen option in the video settings menu.
|;From 1.21
|273338|Flying boat glitch using string and rising bubble columns.
|274187|The sweeping attack from a sword enchanted with Fire Aspect can ignite other players with PVP disabled.
|274258|All horse textures contain an unused chest bag texture.
|;From 1.21.1
|276061|Decorated pot sherds don't visually update until relog when replacing with blank pot.
|;From 1.21.2
|275994|Having the pie chart open while the window is unfocused spams the logs.
|276861|The player can sometimes teleport through blocked end portals when moving very fast.
|277403|Flaming arrows and tridents still don't extinguish when water is placed in their location.
|277537|Pale moss carpets sometimes generate disjointed.
|277780|Minecraft resaves all maps with every autosave even after the 1st patch.
|277865|The animation of boats in bubble columns breaks when over a certain "Time" in {{cd|level.dat}}.
|277922|Boats in 1 block high downward bubble column will continue to rock back and forth.
|278040|Creaking swim pathfinding breaks after being submerged.
|278639|Tripwire hooks are not activated by shulker bullets.
|279340|Baby polar bears are too small.
|279390|Baby zombified piglin helmet clipping.
|;From 1.21.3
|277807|Teleporting the player's mount causes rotation de-sync, previously did not.
|278375|Feeding wheat or hay bale to llama or trader llama with maximum Temper causes item stack to be desynced.
|278376|Arrows and tridents act weirdly in one block deep bubble columns.
|278400|Arrows and tridents move after hitting a block in flowing lava.
|278455|Slow sideways movement in spectator mode is wrong at angles which aren't (close to) a multiple of 45°.
|;From 1.21.4
|278096|"Fabulous!" graphics and clouds disabled causes all particles to linger in frame buffer for one frame.
|278140|The {{cmd|fill}} command doesn't work properly with the directional states of several blocks placed adjacent to one another.
|278164|Click sound is played twice when you click a setting button and there's a slider under the mouse in the next screen.
|278204|Blaze fireballs now cause TNT minecarts to explode instantly.
|278249|Experience orb positions desync severely and abruptly correct themselves.
|278422|Reloading the world after removing {{cd|Owner}} tag from a sitting tamed wolf with {{cmd|data remove}} makes the wolf moving and sitting at the same time.
|278493|Tamed wolves which are angry at creakings remain angry when said creakings despawn.
|278502|Weeping and twisting vines disconnect.
|278552|{{cd|minecraft:entity.player.big_fall}} no longer plays the sound when falling from great height.
|278585|Players can get stuck when landing on the edge of powder snow.
|278591|Ender dragon spawn egg is no longer given when using pick block on the ender dragon entity.
|278615|Reinforcement zombified piglins are angry at you even if you killed the "caller" in one hit.
|278621|Client/server desync when placing powder snow while landing in it.
|278627|Players wearing leather boots will take fall damage when landing on the edge of powder snow.
|278634|Trying to {{cmd|setblock}} a '{{cd|waterlogged{{=}}true}}' state on ({{cd|glow_lichen}}, {{cd|resin_clump}}, {{cd|sculk_vein}}, etc.) produces an error.
|278659|Attacking a natural stationary creaking does not trigger sculk sensors.
|278673|The x-rotation of {{cmd|teleport}} is limited to ±90 degrees relative to the entity's original angle.
|278683|Mobs spawned from spawners or {{cmd|summon}} never drop their equipment.
|278708|Throwing ender pearls while mounted only dismounts you, without teleporting.
|278728|{{cd|smithing_transform}} recipes can't set an item's components back to default.
|278733|Breaking a double resin brick slab block only returns a single slab.
|278734|Sheep's heads stutter when they look up or down.
|278755|Teleporting far away while riding an entity softlocks the game.
|278801|The closed eyeblossom to gray dye recipe is not grouped with the other gray dye recipe.
|278841|Powder snow no longer slows down the player falling from a high place.
|279145|Shulker bullets are no longer affected by bubble columns.
|279152|Shulker bullets can't teleport through nether or end portals, end gateways.
|279196|Block loot tables cannot be removed with {{cmd|/data remove}}
|279364|{{cd|CustomName}} cannot be removed from block entities.
|279472|Void appears lower & more faded than before.
|279572|End portals and end gateways aren't affected by water, lava or powder snow fog.
|279653|Block Entity Data desynchronizes after subsequent setblock commands.
|279857|Piglins summoned by the {{cmd|/summon}} command do not pick up gold items.
}}

== Videos ==
{{youtube|r6Ja2ZxWbRE}}
{{Slicedlime|LcYGZuA7ev4|V3nqaMukxf8}}

== Trivia ==
* Unusually, this version’s number was not revealed during the snapshot phase, only being revealed with its [[1.21.5-pre1|first pre-release]].

== Gallery ==
<gallery>
File:1.21.5 animal-variations.png|The cow, the chicken, and the pig are joined by their new variations high up on a mountain.
File:1.21.5 pig-desert.jpeg|Warm pigs are amongst cactus flowers in a desert.
File:1.21.5 cold-chicken-creeper.png|A cold chicken can be seen in the forefront, with a creeper peaking out from behind a tree.
File:1.21.5 desert-village-chicken.png|A warm chicken in a desert village. A cat can be seen sitting on top of a villager's house.
File:1.21.5 fallen-tree-wolf.png|A wolf walking on top of a fallen oak tree.
File:1.21.5 spawn-eggs.png|Sunny and Noor are inspecting a collection of spawn eggs. A cartographer villager can also been seen peaking in through the window.
File:1.21.5 fallen-tree.png|A fallen birch tree with a brown mushroom growing on top of it.
File:1.21.5 frog-fireflybush.png|In the moonlit swamp, firefly bushes can be seen emitting particles. Meanwhile, a frog seems to be leaping towards the moon.
File:1.21.5 beacons.png|Three differently colored beacon beams are seen in the sky of a sunset scenery.
File:1.21.5 qc-test.png|Kai is seen testing curious behaviors with the new test blocks.
File:1.21.5 villager-test.png|A game test is running, where a villager is seen running through a maze to get to their bed.
</gallery>

== References ==
{{reflist}}

== Navigation ==
{{Navbox Java Edition versions|1.2x}}

[[de:1.21.5]]
[[es:Java Edition 1.21.5]]
[[fr:Édition Java 1.21.5]]
[[ja:Java Edition 1.21.5]]
[[pt:Edição Java 1.21.5]]
[[ru:1.21.5 (Java Edition)]]
[[uk:1.21.5 (Java Edition)]]
[[zh:Java版1.21.5]]