View source for Minecraft:Java Edition 1.17

{{log4j vulnerability}}
{{Infobox version
| title = Minecraft 1.17
| name = [[Minecraft:Caves & Cliffs]]: Part&#160;I
| edition = Java
| image = Java Edition 1.17.jpg
| image2 = Java Edition 1.17.png
| date = June 8, 2021
| jsonhash = 44fa141917df947ed5a138f5cfe667a34f7bbaca
| clienthash = 1cf89c77ed5e72401b869f66410934804f3d6f52
| serverhash = 0a269b5f2c5b93b1712d0f5dc43b6182b9ab254e
| clientmap = 227d16f520848747a59bef6f490ae19dc290a804
| servermap = 84d80036e14bc5c7894a4fad9dd9f367d3000334
| otherdl = {{dl|622bf0fd298e1e164ecd05d866045ed5941283cf|custom|name=CavesAndCliffsPreview.zip|title=Data pack}}<ref group=note>Re-enables features set to release for [[Minecraft:Java Edition 1.18|1.18]].</ref>
| prevparent = 1.16
| prev = 1.16.5
| next = 1.17.1
| nextparent = 1.18
}}
{{relevant guide|Java Edition guides/Caves & Cliffs: Part I}}

'''1.17''', the first release of '''[[Minecraft:Caves & Cliffs]],''' is a major update to {{JE}} announced at [[Minecraft:Minecraft Live 2020]]<ref name="Recap">{{Mcnet|minecraft-live-the-recap|Minecraft Live: The Recap|October 3, 2020}}</ref> and released on June 8, 2021.<ref name="Announced"> This update adds [[Minecraft:amethyst geode]]s along with amethyst blocks and items, [[Minecraft:copper ore]] and its derived forms, [[Minecraft:deepslate]] and its variants, and the [[Minecraft:goat]], [[Minecraft:glow squid]], and [[Minecraft:axolotl]] mobs.</ref>

On April 14, 2021, Mojang Studios announced that the update would be split into two updates due to the amount and complexity of content, as well as team health.<ref>{{Mcnet|a-caves---cliffs-announcement|A Caves & Cliffs Announcement}}</ref> Multiple features such as revamped [[Minecraft:mountain]] and [[Minecraft:cave]] generation, and increased world height were removed in [[Minecraft:21w15a]], and were subsequently released in [[Minecraft:Java Edition 1.18|1.18]].<ref>{{cite|url=http://web.archive.org/web/20210414155447/https://help.minecraft.net/hc/en-us/articles/360059400852|title=Minecraft: Caves & Cliffs Update FAQ (Archived from the original on April 14, 2021)|website=feedback.minecraft.net}}</ref> A [[Minecraft:data pack]] was included in the [[Minecraft:Minecraft.net]] article for 21w15a that re-enabled the removed features, and subsequent snapshots updated this data pack.

== Additions ==
{{Additions table
|Block of Copper
|Waxed Block of Copper
|Exposed Copper
|Waxed Exposed Copper
|Weathered Copper
|Waxed Weathered Copper
|Oxidized Copper
|Waxed Oxidized Copper
|Cut Copper
|Waxed Cut Copper
|Exposed Cut Copper
|Waxed Exposed Cut Copper
|Weathered Cut Copper
|Waxed Weathered Cut Copper
|Oxidized Cut Copper
|Waxed Oxidized Cut Copper
|Cut Copper Slab
|Waxed Cut Copper Slab
|Exposed Cut Copper Slab
|Waxed Exposed Cut Copper Slab
|Weathered Cut Copper Slab
|Waxed Weathered Cut Copper Slab
|Oxidized Cut Copper Slab
|Waxed Oxidized Cut Copper Slab
|Cut Copper Stairs
|Waxed Cut Copper Stairs
|Exposed Cut Copper Stairs
|Waxed Exposed Cut Copper Stairs
|Weathered Cut Copper Stairs
|Waxed Weathered Cut Copper Stairs
|Oxidized Cut Copper Stairs
|Waxed Oxidized Cut Copper Stairs
|Small Amethyst Bud
|Medium Amethyst Bud
|Large Amethyst Bud
|Amethyst Cluster
|Amethyst Shard
|Block of Amethyst
|Budding Amethyst
|Calcite
|Tuff
|Copper Ore
|Copper Ingot
|Lightning Rod
|Spyglass
|Tinted Glass
|Candle
|White Candle
|Light Gray Candle
|Gray Candle
|Black Candle
|Brown Candle
|Red Candle
|Orange Candle
|Yellow Candle
|Lime Candle
|Green Candle
|Cyan Candle
|Light Blue Candle
|Blue Candle
|Purple Candle
|Magenta Candle
|Pink Candle
|Powder Snow
|Powder Snow Bucket
|Dripstone Block
|Pointed Dripstone
|Sculk Sensor
|Bucket of Axolotl
|Axolotl Spawn Egg Revision 1
|Glow Lichen
|Glow Ink Sac
|Glow Item Frame
|Glow Squid Spawn Egg Revision 1
|Azalea
|Flowering Azalea
|Azalea Leaves
|Flowering Azalea Leaves
|Small Dripleaf
|Big Dripleaf
|Hanging Roots
|Rooted Dirt
|Moss Block
|Moss Carpet
|Spore Blossom
|Glow Berries
|Deepslate
|Polished Deepslate
|Chiseled Deepslate
|Deepslate Bricks
|Deepslate Tiles
|Cobbled Deepslate Slab
|Polished Deepslate Slab
|Deepslate Brick Slab
|Deepslate Tile Slab
|Cobbled Deepslate Stairs
|Polished Deepslate Stairs
|Deepslate Brick Stairs
|Deepslate Tile Stairs
|Cobbled Deepslate Wall
|Polished Deepslate Wall
|Deepslate Brick Wall
|Deepslate Tile Wall
|Cobbled Deepslate
|Deepslate Diamond Ore
|Deepslate Gold Ore
|Deepslate Iron Ore
|Deepslate Redstone Ore
|Deepslate Lapis Lazuli Ore
|Smooth Basalt
|Cracked Deepslate Bricks
|Cracked Deepslate Tiles
|Deepslate Coal Ore
|Deepslate Copper Ore
|Deepslate Emerald Ore
|Infested Deepslate
|Light 0
|Light 1
|Light 2
|Light 3
|Light 4
|Light 5
|Light 6
|Light 7
|Light 8
|Light 9
|Light 10
|Light 11
|Light 12
|Light 13
|Light 14
|Light
|Goat Spawn Egg Revision 1
|Raw Copper
|Raw Gold
|Raw Iron
|Block of Raw Copper
|Block of Raw Gold
|Block of Raw Iron
|Bundle}}

=== Blocks ===
'''{{Animate|Small Amethyst Bud (U) JE1.png; Medium Amethyst Bud (U) JE1.png; Large Amethyst Bud (U) JE1.png|32px}} [[Minecraft:Amethyst bud]]'''
* Grows from [[Minecraft:budding amethyst]], which is found in amethyst geodes.
* Starts out tiny, but grows into medium after a while, large after even more time, and eventually becomes an [[Minecraft:amethyst cluster]].
* Unlike crops, each growth stage is a separate block instead of a block state.
* Drops only when mined with a [[Minecraft:Silk Touch]] pickaxe.

'''[[File:Amethyst Cluster (U) JE1.png|32px]] [[Minecraft:Amethyst cluster]]'''
* The final, mature stage of the amethyst bud, which grows from budding amethyst in amethyst geodes.
* Drops amethyst shards if broken, in an amount affected by [[Minecraft:Fortune]], but can also be picked up with Silk Touch.
** Breaking by hand, [[Minecraft:piston]], breaking the support block or other means drops only 2 amethyst shards instead of 4 that would be dropped by using any [[Minecraft:pickaxe]].
* Emits a light level of 5.

'''[[File:Azalea JE2 BE2.png|32px]] [[Minecraft:Azalea]]'''
* Has variants with either no blossoms or pink blossoms.
* Bush-like blocks that can be planted on [[Minecraft:dirt]] and [[Minecraft:grass block]]s.
* Both azaleas can grow from moss blocks when [[Minecraft:bone meal]] is used on them.
* The variant with pink blossoms is seen as small [[Minecraft:flower]]s by the game (for example, [[Minecraft:bee]]s can pollinate them).

'''[[File:Azalea Leaves.png|32px]] [[Minecraft:Azalea leaves]]'''
* Has variants with either no blossoms or pink blossoms.
* Yield azalea and sticks on decay.
* The variant with pink blossoms is seen as small [[Minecraft:flower]]s by the game (for example, [[Minecraft:bee]]s can pollinate them).

'''[[File:Block of Amethyst JE3 BE1.png|32px]] [[Minecraft:Block of amethyst]]'''
* A decorative block found in amethyst geodes.
* Unlike budding amethyst, the block of amethyst can be obtained when mined.
* Can also be crafted with 4 amethyst shards.

{{Crafting Table
|A1=Amethyst Shard
|A2=Amethyst Shard
|B1=Amethyst Shard
|B2=Amethyst Shard
|Output=Block of Amethyst
}}

'''{{Animate|Copper Block JE1 BE1.png; Exposed Copper Block JE1 BE1.png; Weathered Copper Block JE1 BE1.png; Oxidized Copper Block JE1 BE1.png|32px}} [[Minecraft:Block of copper]]'''
* Can be crafted with 9 copper ingots, and can also be crafted back into 9 copper ingots.
* Oxidizes and changes texture to a turquoise-green over time.
* Can be stopped from oxidizing by combining it with a honeycomb to create a waxed block of copper.
* [[Minecraft:Honeycomb]] can also be {{Control|used}}, or applied with a [[Minecraft:dispenser]] to wax them.
** Yellow particles are formed when waxing the block.
* [[Minecraft:Axe]]s can be {{Control|used}} to scrape off wax and oxidation (one stage at a time).
** White particles are formed when scraping off wax from the block.
* [[Minecraft:Lightning]] may clean oxidation, reverting the oxidation process by one or several stages.
** Chances of cleaning and number of reverted stages are higher the closer to the struck block.
* Can be crafted into cut copper.
* There are 8 variants in total.

{{Crafting Table
|A1=Copper Ingot
|A2=Copper Ingot
|A3=Copper Ingot
|B1=Copper Ingot
|B2=Copper Ingot
|B3=Copper Ingot
|C1=Copper Ingot
|C2=Copper Ingot
|C3=Copper Ingot
|Output=Block of Copper
}}

'''{{Animate|Block of Raw Copper JE2 BE2.png; Block of Raw Gold JE3 BE2.png; Block of Raw Iron JE3 BE2.png|32px}} [[Minecraft:Block of Mineral#Raw Metal|Block of raw metal]]'''
* [[Minecraft:Raw copper]], [[Minecraft:raw gold]], and [[Minecraft:raw iron]] can be crafted into the respective block of raw metal.

{{Crafting Table
|A1=Raw Copper
|A2=Raw Copper
|A3=Raw Copper
|B1=Raw Copper
|B2=Raw Copper
|B3=Raw Copper
|C1=Raw Copper
|C2=Raw Copper
|C3=Raw Copper
|Output=Block of Raw Copper
}}

'''[[File:Budding Amethyst JE3 BE1.png|32px]] [[Minecraft:Budding amethyst]]'''
* Generates amethyst buds/clusters on any side that is exposed either to air or a water source block.
* Cannot be obtained when mined, even with Silk Touch, and does not drop anything.
* Breaks immediately if pushed by a [[Minecraft:piston]] or sticky piston.
** Cannot be pulled by sticky pistons.
* Generates in amethyst geodes.

'''[[File:Calcite JE4 BE1.png|32px]] [[Minecraft:Calcite]] '''
* An off-white stone that generates in amethyst geodes, between [[Minecraft:smooth basalt]] and [[Minecraft:Block of Amethyst|amethyst]].

'''{{Animate|Candle JE1 BE1.png; White Candle.png; Light Gray Candle.png; Gray Candle.png; Black Candle.png; Brown Candle.png; Red Candle.png; Orange Candle.png; Yellow Candle.png; Lime Candle.png; Green Candle.png; Cyan Candle.png; Light Blue Candle.png; Blue Candle.png; Purple Candle.png; Magenta Candle.png; Pink Candle.png|32px}} [[Minecraft:Candle]]'''
* Crafted with [[Minecraft:honeycomb]] and [[Minecraft:string]].
* Comes with 16 dyed types and a yellowish non-dyed type. 
* Can be lit by any item that produces fire.
* Up to 4 can be placed in a single block, similar to [[Minecraft:sea pickle]]s, for a maximum light level of 12.
** Only candles of the same color can be placed on the same block.
* Only one can be placed on an uneaten cake and lit.
** If any of the cake is consumed, the candle pops off.
* Can be placed underwater, but cannot be lit.

{{Crafting Table
|A1=String
|A2=Honeycomb
|Output=Candle
}}

'''{{Animate|Cave Vines (head) JE1 BE1.png; Cave Vines (berries) JE1 BE1.png|32px}} [[Minecraft:Cave vines]]'''
* A natural light source, with a [[Minecraft:light]] level of 14.
* Drop [[Minecraft:glow berries]].
** Growth can be sped up using [[Minecraft:bone meal]].
** Berries can be harvested by {{ctrl|interacting}} with the vine.
* Grow from glow berries when placed on the underside of a block.

'''[[File:Cobbled Deepslate.png|32px]] [[Minecraft:Cobbled deepslate]]'''
* Drops from [[Minecraft:deepslate]] when mined with a pickaxe without [[Minecraft:Silk Touch]].
* Can be used interchangeably with [[Minecraft:cobblestone]] and [[Minecraft:blackstone]] in crafting recipes of basic tools, furnaces and brewing stands.
* Can be crafted into respective stairs, slabs and walls, [[Minecraft:polished deepslate]], [[Minecraft:chiseled deepslate]], [[Minecraft:deepslate bricks]], and [[Minecraft:deepslate tiles]], which can be used to craft their respective stairs, slabs, and walls (excluding chiseled deepslate).
** Deepslate bricks and deepslate tiles can also be smelted into their cracked variants.
* Can be smelted back into deepslate.

'''{{Animate|Copper Ore JE2 BE2.png; Deepslate Copper Ore JE2 BE2.png|32px}} [[Minecraft:Copper ore]]'''
* Generates randomly underground in small blobs.
* Copper ore generates uniformly between levels 0 and 64.
* Drops [[Minecraft:raw copper]] when mined.
* Can be smelted into a copper ingot.

'''{{Animate|Cut Copper JE2 BE1.png; Exposed Cut Copper JE1 BE1.png; Weathered Cut Copper JE1 BE1.png; Oxidized Cut Copper JE1 BE1.png|32px}} [[Minecraft:Cut copper]]'''
* Can be made into stair and slab variants.
* Oxidizes and changes texture over time.
* Can be stopped from oxidizing by combining it with a honeycomb to create Waxed Cut Copper.
* There are 8 variants in total.

{{Crafting Table
|A1=Block of Copper
|A2=Block of Copper
|B1=Block of Copper
|B2=Block of Copper
|Output=Cut Copper
}}

'''{{Animate|Cut Copper Slab JE2 BE1.png; Exposed Cut Copper Slab JE1 BE1.png; Weathered Cut Copper Slab JE1 BE1.png; Oxidized Cut Copper Slab JE1 BE1.png|32px}} [[Minecraft:Cut copper slab]]'''
* Oxidizes and changes texture over time.
* Can be stopped from oxidizing by combining it with a honeycomb to create a Waxed Cut Copper Slab.
* There are 8 variants in total.

{{Crafting Table
|A2=Cut Copper
|B2=Cut Copper
|C2=Cut Copper
|Output=Cut Copper Slab
}}

'''{{Animate|Cut Copper Stairs (N) JE2 BE1.png; Exposed Cut Copper Stairs (N) JE1 BE1.png; Weathered Cut Copper Stairs (N) JE1 BE1.png; Oxidized Cut Copper Stairs (N) JE1 BE1.png|32px}} [[Minecraft:Cut copper stairs]]'''
* Oxidizes and changes texture over time.
* Can be stopped from oxidizing by combining it with a honeycomb to create Waxed Cut Copper Stairs.
* There are 8 variants in total.

{{Crafting Table
|A1=Cut Copper
|A2=Cut Copper
|A3=Cut Copper
|B2=Cut Copper
|B3=Cut Copper
|C3=Cut Copper
|Output=Cut Copper Stairs
}}

'''[[File:Deepslate.png|32px]] [[Minecraft:Deepslate]]'''
* A dark-gray stone that generates in blobs between heights 0 and 16.
* Has a hardness value greater than that of [[Minecraft:stone]] but can be mined with any [[Minecraft:pickaxe]].
* Drops [[Minecraft:cobbled deepslate]] when mined.
* Can be obtained only with a [[Minecraft:Silk Touch]] pickaxe, or by smelting cobbled deepslate.
* There are 19 variants in total, including
:* [[File:Cobbled Deepslate Slab JE3.png|32px]] [[Minecraft:Cobbled deepslate slab]]
:* [[File:Cobbled Deepslate Stairs JE3.png|32px]] [[Minecraft:Cobbled deepslate stairs]]
:* [[File:Cobbled Deepslate Wall (ewU) JE3.png|32px]] [[Minecraft:Cobbled deepslate wall]]
:* [[File:Polished Deepslate JE2 BE1.png|32px]] [[Minecraft:Polished deepslate]]
:* [[File:Polished Deepslate Slab JE2.png|32px]] [[Minecraft:Polished deepslate slab]]
:* [[File:Polished Deepslate Stairs JE2.png|32px]] [[Minecraft:Polished deepslate stairs]]
:* [[File:Polished Deepslate Wall (ewU) JE2.png|32px]] [[Minecraft:Polished deepslate wall]]
:* [[File:Deepslate Bricks JE2 BE1.png|32px]] [[Minecraft:Deepslate bricks]]
:* [[File:Cracked Deepslate Bricks JE1 BE1.png|32px]] [[Minecraft:Cracked deepslate bricks]]
:* [[File:Deepslate Brick Slab JE2.png|32px]] [[Minecraft:Deepslate brick slab]]
:* [[File:Deepslate Brick Stairs JE2.png|32px]] [[Minecraft:Deepslate brick stairs]]
:* [[File:Deepslate Brick Wall (ewU) JE2.png|32px]] [[Minecraft:Deepslate brick wall]]
:* [[File:Deepslate Tiles JE2 BE1.png|32px]] [[Minecraft:Deepslate tiles]]
:* [[File:Cracked Deepslate Tiles JE1 BE1.png|32px]] [[Minecraft:Cracked deepslate tiles]]
:* [[File:Deepslate Tile Slab JE2.png|32px]] [[Minecraft:Deepslate tile slab]]
:* [[File:Deepslate Tile Stairs JE2.png|32px]] [[Minecraft:Deepslate tile stairs]]
:* [[File:Deepslate Tile Wall (ewU) JE2.png|32px]] [[Minecraft:Deepslate tile wall]]
:* [[File:Chiseled Deepslate JE2 BE1.png|32px]] [[Minecraft:Chiseled deepslate]]

'''{{Animate|Deepslate Coal Ore JE1 BE2.png; Deepslate Copper Ore JE2 BE2.png; Deepslate Lapis Lazuli Ore JE3 BE2.png; Deepslate Iron Ore JE2 BE1.png; Deepslate Gold Ore JE2 BE1.png; Deepslate Redstone Ore JE2 BE1.png; Deepslate Diamond Ore JE2 BE1.png; Deepslate Emerald Ore JE1 BE1.png|32px}} Deepslate [[Minecraft:ore]]s'''
* Added deepslate variants of all ores, including iron, gold, copper, coal, diamond, redstone, emerald, and lapis lazuli.
* Takes twice as long to mine as normal ores.
* Has the texture of [[Minecraft:deepslate]] replacing the normal stone texture.
* Takes place of ores that generate in deepslate.
* Can be used in blasting and smelting recipes like normal ores.
** These recipes can be unlocked in the recipe book with deepslate ores as well.

'''{{Animate|Big Dripleaf (S) JE2.png; Small Dripleaf JE3.png|x32px}} [[Minecraft:Dripleaf]]'''
* Allows an entity to stay on it for 1.5 seconds (30 ticks) before the entity falls through it.
** The tilt happens in 3 stages: unstable, partial, and full. These can be seen in the F3 debug menu.
*** All the stages are solid except the full stage, which is when the player falls through.
*** When nobody is standing on it, it is set to none stage.
** The tilt can also be triggered by hitting the plant with a projectile.
** The tilt can be prevented by powering it with [[Minecraft:redstone]], but hitting it with a projectile still causes it to tilt.
* Comes in two sizes: small and big. Small can be applied [[Minecraft:bone meal]] to grow into big.
** Small dripleaf can be obtained only with [[Minecraft:shears]] (otherwise breaks) and can be planted on [[Minecraft:clay]] or [[Minecraft:moss block]]s, or underwater on clay and dirt blocks.
** Big dripleaf can be obtained with any tool or by hand and can be planted on grass, dirt, and moss blocks.
* Both sizes can be found inside [[Minecraft:lush caves]], which can currently only be accessed through the single biome, caves, or floating islands world types.
** It is available in Survival through the [[Minecraft:wandering trader]].

'''[[File:Dripstone Block JE1 BE1.png|32px]] [[Minecraft:Dripstone block]]'''
* A decoration block.
* Appears to be made of the same materials as stalactites and stalagmites but as a full cube.
* Generates mainly in the [[Minecraft:dripstone caves]] biome, which is currently available only through single biome, caves, or floating islands world types.
** [[Minecraft:Dripstone cluster]]s can also be found rarely in regular caves.
* Can be crafted from 4 [[Minecraft:pointed dripstone]].

{{Crafting Table
|A1=Pointed Dripstone
|A2=Pointed Dripstone
|B1=Pointed Dripstone
|B2=Pointed Dripstone
|Output=Dripstone Block
}}

'''[[File:Glow Item Frame JE1 BE3.png|32px]] [[Minecraft:Glow item frame]]'''
* Placeable entities that appear to glow.
* Do not affect the light level, but appear as if lit up themselves.
* Items placed inside also glow.
* Crafted using an [[Minecraft:item frame]] and a [[Minecraft:glow ink sac]].
* Includes application to [[Minecraft:map]]s.

{{Crafting Table
|A1=Item Frame
|B1=Glow Ink Sac
|Output=Glow Item Frame
}}

'''[[File:Glow Lichen (D) JE2.png|32px]] [[Minecraft:Glow lichen]]'''
* A naturally occurring light source found rarely in caves, growing on any face of a block.
* Has a light level of 7.
* Obtained with [[Minecraft:shears]], otherwise breaks.
* Does not spread naturally, although [[Minecraft:bone meal]] can be used to spread it horizontally (or vertically if on the side of a block).
** It spreads to adjacent spaces, up to 4.
* Can be waterlogged.
* Unlike [[Minecraft:vines]], it does not pop off when underwater, and is not climbable.
* Up to 6 can be put on the same block space, merging into one block.

'''[[File:Hanging Roots JE2 BE2.png|32px]] [[Minecraft:Hanging roots]]'''
* Decorative blocks that can be placed only on the underside of a block.
* Obtained with [[Minecraft:shears]], otherwise breaks.
* It can also be obtained using a [[Minecraft:hoe]] on [[Minecraft:rooted dirt]] turning it into normal [[Minecraft:dirt]].

'''[[File:Deepslate.png|32px]] [[Minecraft:Infested deepslate]]'''
* An infested variant of deepslate.
* Spawns a [[Minecraft:silverfish]] when mined.

'''{{Animate|Light 0 JE3.png; Light 1 JE3.png; Light 2 JE3.png; Light 3 JE3.png; Light 4 JE3.png; Light 5 JE3.png; Light 6 JE3.png; Light 7 JE3.png; Light 8 JE3.png; Light 9 JE3.png; Light 10 JE3.png; Light 11 JE3.png; Light 12 JE3.png; Light 13 JE3.png; Light 14 JE3.png; Light 15 JE3.png|32px}} [[Minecraft:Light block]]'''
* A new [[Minecraft:waterlog]]gable source of light, originally from {{BE}}.
* Only available with commands such as {{cmd|give}}.
* Behaves like air and it is visible only when the item is held, similar to [[Minecraft:barrier]]s.
** Unlike barriers, light blocks can only be targeted when holding the item.
* The light level it is emitting can be changed by interacting with it.

'''[[File:Lightning Rod (U) JE3.png|32px]] [[Minecraft:Lightning rod]]'''
* Can be crafted with 3 copper ingots.
* [[Minecraft:Lightning]] strikes within a 32-block radius get redirected to the lightning rod.
** Turns completely white when struck by lightning.
* Gives off a redstone signal with a strength of 15 if hit by lightning.
* Can be activated directly by throwing a trident with Channeling at it during a [[Minecraft:thunderstorm]], though this does not produce a redstone signal.

{{Crafting Table
|B1=Copper Ingot
|B2=Copper Ingot
|B3=Copper Ingot
|Output=Lightning Rod
}}

'''[[File:Moss Block JE1 BE1.png|32px]] [[Minecraft:Moss block]]'''
* An opaque block with a grass-like texture on all sides.
* Can be fertilized with bone meal to grow [[Minecraft:grass]], [[Minecraft:tall grass]], moss carpets, and both types of azaleas on it and in its vicinity.
* Can be fertilized with bone meal to grow over (expand) across stone surfaces, but not grass surfaces. 
* Breaks when pushed by a piston or sticky piston.
* Can be combined with [[Minecraft:cobblestone]] or [[Minecraft:stone bricks]] to make the mossy versions of those blocks.
** [[Minecraft:Vines]] can still be used, in addition to moss blocks.
* [[Minecraft:Hoe]]s are the appropriate tool to collect it.
* [[Minecraft:Small dripleaf]] can be planted on it.

'''[[File:Moss Carpet.png|32px]] [[Minecraft:Moss carpet]]'''
* Same texture as the moss block, but one pixel thick.
* Can be crafted with moss blocks, or be obtained by applying bone meal to them.

{{Crafting Table
|A1=Moss Block
|B1=Moss Block
|Output=Moss Carpet
}}

'''{{Animate|Pointed Dripstone Tip (D) JE1 BE1.png; Pointed Dripstone Tip Merge (D) JE1 BE1.png; Pointed Dripstone Frustum (D) JE1 BE1.png; Pointed Dripstone Middle (D) JE1 BE1.png; Pointed Dripstone Base (D) JE1 BE1.png|32px}} [[Minecraft:Pointed dripstone]]'''
* Can be either placed on a ceiling to create a stalactite or on top of a block to create a stalagmite.
** Can be combined to form longer stalactites and stalagmites.
* Thrown [[Minecraft:trident]]s break pointed dripstone. They also break when pushed directly or with a block by a [[Minecraft:piston]].
* Stalagmites break if not attached to something below. 
* Stalagmites hurt [[Minecraft:entities]] that fall on top of them more than normal fall damage.
** Damage is relative to height: For example, jumping on a stalagmite deals {{hp|2}} of damage, and falling from 3 blocks deals {{hp|8}} of damage.
* Stalactites can fall or break if unsupported, and break apart on impact, hurting entities they fall on.
** Damage is relative to height: For example, one falling from 2 blocks deals {{hp|2}} of damage, and one falling from 3 blocks deal {{hp|4}} of damage.
** They drip [[Minecraft:water]] or [[Minecraft:lava]] into [[Minecraft:cauldron]]s if a source block is placed above the stalactite, and gradually fill the cauldron. Water drips even without any water above the block (as does lava in [[Minecraft:the Nether]]) but this effect alone does not fill the cauldron.
* If a stalactite is hanging from a dripstone block with a water source above, it slowly grows both the stalactite from above and a stalagmite from below.
** Growth speed is random but very slow; a single growth step can take several in-game days.

'''{{Animate|Potted Azalea JE1 BE1.png; Potted Flowering Azalea JE1 BE1.png|32px}} [[Minecraft:Potted azalea]]'''
* Obtained by planting an [[Minecraft:azalea]] into a pot.

'''[[File:Powder Snow JE1 BE1.png|32px]] [[Minecraft:Powder snow]]'''
* A variant of snow, [[Minecraft:entities]] that walk over it sink into it.
* [[Minecraft:Leather boots]] can be worn to prevent entities from sinking into powder snow blocks.<!--Tested, works with anything that can have armor items, including mobs that normally don't wear armor, like cows.-->
** [[Minecraft:Player]]s can still [[Minecraft:crouch]] to descend with leather boots. Wearing leather boots also allows powder snow to be "climbed", like [[Minecraft:water]] or [[Minecraft:scaffolding]]. They also prevent fall damage when landing on powder snow.
** [[Minecraft:Leather horse armor]] also protects [[Minecraft:horse]]s from freeze damage.
* When inside a powder snow block, a frosty vignette appears around the player's screen and any entity (with the exception of [[Minecraft:stray]]s, [[Minecraft:polar bear]]s, [[Minecraft:snow golem]]s, and [[Minecraft:wither]]s) inside starts freezing and taking damage after a short time.
** Wearing any piece of [[Minecraft:leather armor]] stops the freeze effect.
* Can be collected and placed with a [[Minecraft:bucket]]. {{ItemSprite|Powder Snow Bucket}}
* Entities on fire melt powder snow when colliding.

'''[[File:Rooted Dirt JE1 BE1.png|32px]] [[Minecraft:Rooted dirt]]'''
* A dirt-like decorative block with roots on its texture.
* Similar to [[Minecraft:coarse dirt]], neither [[Minecraft:mycelium]] nor [[Minecraft:grass]] spread to it.
* {{Control|Using}} [[Minecraft:bone meal]] on any side grows [[Minecraft:hanging roots]] underneath.
* Tilling rooted dirt with a hoe now converts it into dirt, and pops out hanging roots.

{{Crafting Table
|A1=Hanging Roots
|B1=Dirt
|Output=
}}

'''{{Animate|Sculk Sensor JE1.gif; Sculk Sensor BE2.gif|32px}} [[Minecraft:Sculk sensor]]'''
* A redstone component that detects vibrations.
* Currently, it does not generate naturally, available only from commands such as {{cmd|give}}, but natural generation is planned for future versions.
* Senses vibrations such as block placement, footsteps, and projectiles, and emits a redstone signal.
* [[File:Vibration JE1 BE1.gif|32px]] Emits particles when it senses a vibration nearby.
* A [[Minecraft:comparator]] connected to it emits different signal strengths based on what caused the signal.
* Does not detect ambient [[Minecraft:weather]] such as [[Minecraft:rain]].
* [[Minecraft:Wool]] blocks between the sensor and the cause of the sound prevent the sensor from detecting the sound.

'''[[File:Smooth Basalt JE1 BE1.png|32px]] [[Minecraft:Smooth basalt]]'''
* A [[Minecraft:basalt]] variant that composes the outer layer of amethyst geodes.
* Can be obtained by smelting basalt.

'''{{Animate|Spore Blossom JE1.png; Spore Blossom JE1 (facing NWU).png|32px}} [[Minecraft:Spore blossom]]'''
* Available only in [[Minecraft:Creative]] or in [[Minecraft:buffet]] / [[Minecraft:custom]] worlds with the currently unused [[Minecraft:lush caves]] biome.
* Can be placed only on the underside of a block.
* Sends green particles downward when opened.
* Particles appear in the air around the block.

'''[[File:Tinted Glass JE2 BE1.png|32px]] [[Minecraft:Tinted glass]]'''
* A black variant of glass that is transparent to players, but does not let light through.
* Can be crafted with 4 amethyst shards and a glass block.
** Stained glass cannot be used to craft tinted glass.
* Drops itself if mined without [[Minecraft:Silk Touch]] or even by hand, unlike [[Minecraft:glass]].

{{Crafting Table
|A2=Amethyst Shard
|B1=Amethyst Shard
|B2=Glass
|B3=Amethyst Shard
|C2=Amethyst Shard
|Output=Tinted Glass
}}

'''[[File:Tuff.png|32px]] [[Minecraft:Tuff]]'''
* A deep grayish stone that generates in blobs between levels 0 and 16.

=== Items ===
'''[[File:Amethyst Shard JE2 BE1.png|32px]] [[Minecraft:Amethyst shard]]'''
* Obtained from breaking amethyst clusters.
* The amount dropped can be increased with the [[Minecraft:Fortune]] enchantment.
* Can be used to craft tinted glass, blocks of amethyst, and spyglasses.

'''[[File:Bucket of Axolotl JE1 BE1.png|32px]] [[Minecraft:Bucket of axolotl]]'''
* Obtained by using a water bucket on an axolotl, similar to fish.
* Can be used to carry around and empty out [[Minecraft:axolotl]]s, also similarly to fish.

'''{{Animate|Bundle JE2 BE2.png; Bundle Filled JE2.png|32px}} [[Minecraft:Bundle]]'''
* Available only from commands such as {{cmd|give}}.
* Used to store other items (except [[Minecraft:shulker box]]es) inside of it.
* Can hold only one stack of items, but is able to hold different types of items inside of it.
** Items with smaller stacks, such as [[Minecraft:ender pearl]]s, take up more room in a bundle, and non-stackable items take up the whole bundle.
* The bundle's contents can be opened by pressing {{ctrl|use}} while holding it, throwing out its entire content into the world. When destroyed as an entity, it drops the items it currently has as well.
** Right-clicking a bundle in the inventory empties one item from the bundle.
* The player receives a tutorial when first having a bundle in the inventory.
* Even though bundles are not stackable, bundles can be nested.
** Can hold up to 16 bundles.
** Only empty bundles can be placed in other bundles without using commands.
* Has a GUI when hovering over it.
** Shows contained [[Minecraft:item]]s in its GUI's [[Minecraft:inventory]] slots when hovering over it, as well as fullness as a number. 
* Note: Bundles can hold any amount of any item if added using commands.

{{Crafting Table
|A1=String
|B1=Rabbit Hide
|C1=String
|A2=Rabbit Hide
|C2=Rabbit Hide
|A3=Rabbit Hide
|B3=Rabbit Hide
|C3=Rabbit Hide
|Output=Bundle
}}

'''[[File:Copper Ingot JE2 BE1.png|32px]] [[Minecraft:Copper ingot]]'''
* Obtained by smelting raw copper or copper ore.
* Used to craft blocks of copper, lightning rods, and spyglasses.

'''[[File:Glow Berries JE1 BE1.png|32px]] [[Minecraft:Glow berries]]'''
* Can be eaten, restoring {{hunger|2}}.
* Grow on cave vines.
** Once harvested the vines lose their glow berry texture.

'''[[File:Glow Ink Sac JE1 BE1.png|32px]] [[Minecraft:Glow ink sac]]'''
* Dropped by glow squids when killed.
* Can be used to craft glow item frames.
* Can be used to make text glow on [[Minecraft:sign]]s.

'''[[File:Powder Snow Bucket JE1 BE1.png|32px]] [[Minecraft:Powder snow bucket]]'''
* Obtained by using a [[Minecraft:bucket]] on [[Minecraft:powder snow]].
* Can be used to place a powder snow block wherever it is used, or can be used to fill [[Minecraft:cauldron]]s with powder snow.

'''[[File:Raw Copper JE3 BE2.png|32px]] [[Minecraft:Raw copper]]'''
* Drops from [[Minecraft:copper ore]] when mined with a stone pickaxe or higher without [[Minecraft:Silk Touch]].
* Can be smelted into [[Minecraft:copper ingot]]s.

'''[[File:Raw Gold JE3 BE2.png|32px]] [[Minecraft:Raw gold]]'''
* Drops from [[Minecraft:gold ore]] when mined with an iron pickaxe or higher without Silk Touch.
* Can be smelted into [[Minecraft:gold ingot]]s.
* [[Minecraft:Piglin]]s attempt to pick up raw gold.

'''[[File:Raw Iron JE3 BE2.png|32px]] [[Minecraft:Raw iron]]'''
* Drops from [[Minecraft:iron ore]] when mined with a stone pickaxe or higher without Silk Touch.
* Can be smelted into [[Minecraft:iron ingot]]s.

'''[[Minecraft:Spawn egg]]s'''
* [[File:Axolotl Spawn Egg JE1 BE1.png|32px]] [[Minecraft:Axolotl spawn egg]].
* [[File:Goat Spawn Egg JE1 BE2.png|32px]] [[Minecraft:Goat spawn egg]].
* [[File:Glow Squid Spawn Egg JE1 BE1.png|32px]] [[Minecraft:Glow squid spawn egg]].

'''[[File:Spyglass (item) JE3 BE1.png|32px]] [[Minecraft:Spyglass]]'''
* Crafted with 2 copper ingots and an amethyst shard.
* When used, it zooms in on wherever the player is looking but limits their view to a square.
** The scope [[Minecraft:texture]] is a [[Minecraft:glass]] square with a [[Minecraft:copper]] border.
** The overlay that limits the view can be removed with a [[Minecraft:resource pack]] or by pressing {{key|F1}}.
* There is a unique animation for using the spyglass, which is visible in a third-person perspective or by another player.

{{Crafting Table
|B1=Amethyst Shard
|B2=Copper Ingot
|B3=Copper Ingot
|Output=Spyglass
}}

=== Mobs ===
'''{{Animate|Lucy Axolotl JE2.png; Wild Axolotl JE1.png; Gold Axolotl JE2.png; Cyan Axolotl JE2.png; Blue Axolotl JE2.png|32px}} [[Minecraft:Axolotl]]'''
* Has {{Hp|14}} health.
* Can only spawn in complete darkness and where there's a natural stone block less than 5 blocks below the spawning space.
* The first amphibian added to ''Minecraft''.
** Dry out and start taking damage after 5 minutes of being out of water.
* Can be caught using a [[Minecraft:water bucket]], like [[Minecraft:fish]].
* Can be bred using [[Minecraft:buckets of tropical fish]].
* Come in five different colors (leucistic, yellow, brown, cyan, and blue, with blue being the rarest).<ref name="Recap" />
** Blue axolotls are very rare, as they don't naturally spawn, only appearing with a {{frac|1|1200}} chance when breeding.
* Plays dead when damaged on water, receiving [[Minecraft:Regeneration]] I.
** This regeneration ability is likely based on how real axolotls can regrow lost limbs.
* Attacks [[Minecraft:drowned]], [[Minecraft:guardian]]s, [[Minecraft:elder guardian]]s, [[Minecraft:squid]]s, [[Minecraft:glow squid]]s, and [[Minecraft:fish]], dealing {{hp|2}} damage.
** They have a two-minute cooldown after hunting non-hostile targets such as [[Minecraft:fish]] and squids.
** They prioritise attacking hostile mobs over passive ones.
* If a player kills a mob an axolotl is in combat with, the player gets a Regeneration I effect and is rid of [[Minecraft:Mining Fatigue]], if they had it.
* When an axolotl is held with a lead on the ground, it begins walking at an exaggeratedly fast speed.

'''[[File:Glow Squid JE1.gif|32px]] [[Minecraft:Glow squid]]'''
* Has {{Hp|10}} health.
* Originates from [[Minecraft:MCE:Glow Squid|the mob of the same name]] {{in|Earth}}.
* Underwater mob that behaves like a regular [[Minecraft:squid]]. 
* Can only spawn in complete darkness and where there's a natural stone block less than 5 blocks below the spawning space.
* Is attacked by [[Minecraft:axolotl]]s without provocation.
* Drops glow ink sacs when killed.
* Does not affect the light level, but appears as if lit up. Glows in the same way that [[Minecraft:magma cube]] cores, [[Minecraft:vex]]es, [[Minecraft:blaze]]s, eyes of [[Minecraft:spider]]s, [[Minecraft:drowned]] and [[Minecraft:endermen]] do.
* Stops glowing for a short time and swims away quickly after taking damage.

'''[[File:Goat JE1 BE1.png|32px]] [[Minecraft:Goat]]'''
* Has {{Hp|10}} health.
* Spawns in [[Minecraft:Windswept Hills|mountain]] biomes.
** Currently a place holder until the new mountains are added.
* Goats can ram other mobs and [[Minecraft:armor stand]]s to knock them a few blocks.
** Mobs rammed by goats don't retaliate.
* Can jump higher than other [[Minecraft:mob]]s to avoid obstacles, up to 10 blocks high.
* Takes reduced fall damage.
* Avoids [[Minecraft:powder snow]] by jumping over it.
* Can be bred with [[Minecraft:wheat]] to produce a baby goat.
* A [[Minecraft:bucket]] can be used on them to get [[Minecraft:milk]].
* Do not [[Minecraft:drop]] anything.
* They have a 2% chance of spawning as a screaming goat, which are more hostile and make different noises.

=== Non-mob entities ===
'''[[Minecraft:Marker]]'''
* Entity meant for custom use cases like map making and data packs.
** Only exists on the server side, is never sent to clients.
** Does not do any updates of their own.
** Has a {{nbt|compound|data}} compound field that can contain any data.

=== World generation ===
'''{{Animate|Amethyst Geode JE4 BE1.png; Amethyst Geode uncracked JE3 BE1.png|x32px}} [[Minecraft:Amethyst geode]]'''
* A new feature found uncommonly underground (can rarely appear exposed to the surface close to sea level).
* Contains blocks of amethyst and budding amethyst blocks, which are encased in a shell of calcite and smooth basalt.
** Also generates with a small air pocket nearby that may open into the geode.
* Generates between Y=70 and Y=0.
* Overrides standard caves and ravines, but is overridden by mineshafts.
* Currently has a high generation rate, presumably for testing purposes as with [[Minecraft:ruined portal]]s in the 1.16 snapshots.

'''[[File:Azalea Tree.png|32px]] [[Minecraft:Azalea tree]]'''
* Generate above [[Minecraft:lush caves]], either on the surface or underground. Lush caves do not generate in normal worlds.
* Consist of [[Minecraft:azalea leaves]] (both variants), [[Minecraft:oak log]]s and [[Minecraft:rooted dirt]].

==== Biomes ====
'''[[File:BiomeSprite dripstone-caves.png|16px]] [[Minecraft:Dripstone caves]]'''
[[File:Dripstone Caves.png|thumb|180px|A dripstone caves biome.]]
* Currently available only in [[Minecraft:buffet]] or [[Minecraft:custom]] worlds, as cave biomes were delayed to 1.18.
* Contains [[Minecraft:pointed dripstone]] (both stalactites and stalagmites) and [[Minecraft:dripstone block]]s.
* [[Minecraft:Dripstone cluster]]s are abundant here, often forming pillars.

'''[[File:BiomeSprite lush-caves.png|16px]] [[Minecraft:Lush caves]]'''
[[File:Lush Caves.png|thumb|226x226px|A lush caves biome.]]
* Currently available only in [[Minecraft:buffet]] or [[Minecraft:custom]] worlds, as cave biomes were delayed to 1.18.
* Contain [[Minecraft:moss block]]s, [[Minecraft:moss carpet]]s, [[Minecraft:spore blossom]]s, [[Minecraft:glow berry]] vines, [[Minecraft:Big Dripleaf|big]] and [[Minecraft:small dripleaf]].
* Moss covers the ceilings and floors.
* [[Minecraft:Axolotl]]s can spawn here.
* Clay pools generate inside.

=== Command format ===
'''{{cmd|debug function}}'''
* New debug subcommand executes command with same syntax as function.
** Every executed command, message (even if it would be normally invisible), result or error is stored to file.
** Cannot be run from inside functions.

'''{{cmd|item}}'''
* Modifies the [[Minecraft:inventory]] of a [[Minecraft:block]] or [[Minecraft:entity]].
** This command has three forms:
*** {{cd|/item <target> replace <item stack> [<count>]}} – same as old {{cd|/replaceitem}}
*** {{cd|/item <target> modify <modifier>}} – modifies item (without copying). 
*** {{cd|/item <target> copy <nowiki><source></nowiki> [<modifier>]}} – copies item for source to target(s), optionally applying modifier
** Possible sources and targets: {{cd|entity <selector> <slot>}} or {{cd|block <x> <y> <z> <slot>}}
** For example, {{cd|/item block ~ ~ ~ container.0 copy entity @s enderchest.0}} copies the first item from player's enderchest to the first slot of the container player is currently standing on.
** Replaced {{cmd|replaceitem}}.

'''{{cmd|perf}}'''
* Starts a recording for 10 seconds capturing metrics such as tick durations, used heap sizes and other more detailed stats.
* Executing again before the 10-second limit ends the recording early.

'''[[Minecraft:Item modifier]]s'''
* Reuse functions syntax of a [[Minecraft:loot table]] to describe item modification in {{cmd|item}} command.
* The function part of loot tables can now be defined as separate [[Minecraft:data pack]] resource in {{cd|item_modifiers}} directory.
** Such files can contain a single function (i.e single [[Minecraft:JSON]] object) or an array of functions.

'''[[Minecraft:Game rule]]s'''
* <code>freezeDamage</code>
** Whether entities take damage from freezing inside of [[Minecraft:powder snow]].
* <code>playersSleepingPercentage</code>
** Controls what percentage of players must sleep to skip the night.
** When set to 0 or a negative value, a single player is sufficient to skip the night. The sleeping animation occurs as normal.
** When set over 100, the night cannot be skipped.
** Set to 100 by default.

=== Gameplay ===
'''[[Minecraft:Advancement]]s'''
* Added 11 new advancements:
{{Load advancements|Whatever Floats Your Goat!;Wax On;Wax Off;The Cutest Predator;The Healing Power of Friendship;Glow and Behold!;Light as a Rabbit;Surge Protector;Is It a Bird?;Is It a Balloon?;Is It a Plane?}}
* Adds new advancement triggers.
** <code>started_riding</code>
*** Triggered when player starts riding a vehicle or entity starts riding vehicle currently ridden by player.
** <code>lightning_strike</code>
*** Triggers for any player on the server when lightning finishes (i.e. entity disappears).
** <code>using_item</code>
*** Triggered for every tick of using items (like crossbows, spyglass, fishing rods, etc).

'''[[Minecraft:Death messages]]'''
* Added 6 new death messages:
** "<player> froze to death"
** "<player> was frozen to death by <entity>"
** "<player> was skewered by a falling stalactite"
** "<player> was skewered by a falling stalactite whilst fighting <entity>"
** "<player> was impaled on a stalagmite"
** "<player> was impaled on a stalagmite whilst fighting <entity>"

'''[[Minecraft:Loot table]]s'''
* New condition: {{cd|value_check}}
** Checks range of value.
** Parameters: 
*** {{cd|value}} – see "New value providers" section (currently combination of random generators and score) 
*** {{cd|range}} – min/max range
* New functions: 
** {{cd|set_enchantments}}
*** Modifies enchantments on item.
*** Parameters:
**** {{cd|enchantments}} – map of enchantment id to level value (can be score or random number)
**** {{cd|add}} – if {{cd|true}}, change is relative to current level. If {{cd|false}}, level is replaced with current value (default behavior)
** {{cd|set_banner_pattern}}
*** Sets tags needed for banner patterns. Parameters:
**** {{cd|patterns}} - list of pattern objects:
***** {{cd|pattern}} - name of pattern (square_bottom_left, bricks, etc.)
***** {{cd|color}} - name of color (light_gray, etc.)
**** {{cd|append}} - if true, new elements are appended to existing ones instead of replacing
* New value providers: {{cd|score}}
** Returns scaled scoreboard value.
** Parameters:
*** {{cd|score}} – scoreboard name
*** {{cd|target}} – same as {{cd|target}} in {{cd|score}} predicate
*** {{cd|scale}} – scaling factor (float)

=== General ===
[[File:Monochrome Mojang Studios Logo.png|thumb|right|The alternative Mojang Studios loading screen that appears when the Monochrome Logo option is turned on]]
'''Accessibility'''
* Added an alternative solid black background color for the [[Minecraft:Mojang Studios]] loading screen, toggleable with the “Monochrome Logo” accessibility category in [[Minecraft:options]].

'''[[Minecraft:Controls]]'''
* Added {{key|F3+L}} shortcut to generate and persist performance metrics from in-game, similar to {{cmd|debug}}.
** Metrics are saved in <samp>[[Minecraft:.minecraft]]/debug/profiling/<''timestamp''>.zip</samp>.
** Pressing F3+L while in the game starts a recording for 10 seconds capturing metrics such as tick.
** Pressing F3+L before the 10 second limit ends the recording early.
** Also include reports for the integrated server on single-player worlds.

'''[[Minecraft:Data pack]]s'''
* Added {{Nbt|boolean|aquifers_enabled}}, {{Nbt|boolean|deepslate_enabled}} and {{Nbt|boolean|noise_caves_enabled}} to <code>worldgen/noise_settings/*.json</code>.

'''[[Minecraft:Language]]'''
* Added Russian (Pre-revolutionary) language.
* Added Chinese Traditional (Hong Kong) language.

'''[[Minecraft:NBT]]'''
* Added {{cd|HasVisualFire}} NBT tag.
** Entities with this tag visually appear on fire, even if they are not actually on fire.

'''[[Minecraft:Particles]]'''
* Added 15 new particle types: {{cd|dripping_dripstone_lava}}, {{cd|dripping_dripstone_water}}, {{cd|dust_color_transition}}, {{cd|electric_spark}}, {{cd|falling_dripstone_lava}}, {{cd|falling_dripstone_water}}, {{cd|falling_spore_blossom}}, {{cd|glow}}, {{cd|glow_squid_ink}}, {{cd|scrape}}, {{cd|snowflake}}, {{cd|spore_blossom_air}}, {{cd|vibration}}, {{cd|wax_off}} and {{cd|wax_on}}.

'''[[Minecraft:Predicate]]'''
* Added <code>lightning_bolt</code> sub-predicate.

'''<samp>[[Minecraft:server.properties]]</samp> arguments'''
* <code>resource-pack-prompt</code>
** Adds a custom message to be shown on resource pack prompt when <code>require-resource-pack</code> is used.
** Expects chat component syntax, can contain multiple lines.

'''[[Minecraft:Shaders]]'''
* Are now included for all supported render states.
* Any shader except for the {{code|blit}} shader can also be replaced in resource packs.
* For now replacing these shaders is not officially supported and the way it works may change in the future.
* Current rendering engine uses a system similar to the post-processing shader pipeline. There are some differences between both systems that cater to the slightly different requirements.

'''[[Minecraft:Splash]]es'''
* Added the following splash text:
** "<nowiki>[this splash text has been delayed until part 2]</nowiki>"
** "Contains simulated goats!"
** "Home-made!"
** "There's <<a cat on ,my keyboard!~"{{sic}}
** "The cutest predator you'll ever meet!"
** "Now you are thinking with pistons!"
** "Get to the coppah!"
** "Board game version also available!"
** "Honey, I waxed the copper!"
** "Plant-based light sources!"
** "Made by "real" people!"

'''[[Minecraft:Tag]]s'''
* Added the {{cd|axolotl_always_hostiles}} entity type tag.
** Contains drowned, guardian and elder guardian.
** Axolotls are always hostile towards entities in this tag.
* Added the {{cd|axolotl_hunt_targets}} entity type tag.
** Contains [[Minecraft:tropical fish]], [[Minecraft:pufferfish]], [[Minecraft:salmon]], [[Minecraft:cod]], [[Minecraft:squid]], and [[Minecraft:glow squid]].
** Axolotls exhibit the cooldown-based "hunt" behavior towards entities in this tag.
* Added the {{cd|axolotl_tempt_items}} item tag.
** Contains the [[Minecraft:bucket of tropical fish]].
** Items in this tag can be used to tempt axolotls.
* Added the {{cd|candle_cakes}} block tag.
** Contains all 17 types of candle cake.
** Blocks in this tag are considered candle cakes and can be lit if they have the {{cd|lit}} block states set to false.
* Added the {{cd|candles}} block and item tags.
** Contains all 17 types of candles.
** Blocks in this tag are considered candles and can be lit if they have the {{cd|lit|waterlogged|d=and}} block states and both are false.
** Cakes use this tag to determine if a candle item can be placed on it or not.
* Added the {{cd|cauldrons}} block tag.
** Contains cauldrons, water cauldrons, lava cauldrons, and powder snow cauldrons.
** This tag is used in certain pathfinding processes.
* Added the {{cd|cave_vines}} block tag.
** Contains the cave vines body block and cave vines head block.
* Added the {{cd|cluster_max_harvestables}} item tag.
** Contains all pickaxes.
* Added the {{cd|coal_ores|copper_ores|diamond_ores|emerald_ores|iron_ores|lapis_ores|redstone_ores|d=and}} block and item tags.
** Contain the normal and deepslate variants of each ore type.
* Added the {{cd|crystal_sound_blocks}} block tag.
** Contains amethyst blocks and budding amethyst.
** Blocks in this tag play the "amethyst block chime" sound repeatedly for a short amount of time after being stepped on, gradually decreasing in volume.
* Added the {{cd|deepslate_ore_replaceables}} block tag.
** Contains deepslate and tuff.
* Added the {{cd|dirt}} block tag.
** Contains [[Minecraft:dirt]], [[Minecraft:coarse dirt]], [[Minecraft:podzol]], [[Minecraft:rooted dirt]], [[Minecraft:grass block]]s, [[Minecraft:mycelium]], and [[Minecraft:moss block]]s.
** Grass, tall grass, ferns, tall ferns, sweet berry bushes, saplings, flowers, azaleas, sugar cane, and dead bushes can be placed in blocks in this tag.
** Pumpkins and melons can grow onto blocks in this tag.
* Added the {{cd|dripstone_replaceable_blocks}} block tag.
** Contains the {{cd|base_stone_overworld}} block tag and dirt.
** Used in dripstone generation to determine what dripstone can replace and what pointed dripstone can generate on.
* Added the {{cd|features_cannot_replace}} block tag.
** Contains [[Minecraft:bedrock]], [[Minecraft:monster spawner]], [[Minecraft:chest]], and [[Minecraft:end portal frame]].
* Added the {{cd|fox_food}} item tag.
** Contains sweet berries and glow berries.
* Added the {{cd|freeze_hurts_extra_types}} entity type tag.
** Contains [[Minecraft:strider]]s, [[Minecraft:blaze]]s, and [[Minecraft:magma cube]]s.
** Entities in this tag take 5 times more damage from the freezing effect.
* Added the {{cd|freeze_immune_entity_types}} entity type tag.
** Contains [[Minecraft:stray]]s, [[Minecraft:polar bear]]s, [[Minecraft:snow golem]]s, and [[Minecraft:wither]]s.
** Entities in this tag cannot be frozen.
* Added the {{cd|freeze_immune_wearables}} item tag.
** Contains leather horse armor, leather boots, leather pants, leather tunic, and leather cap.
** Having an item in this tag in an armor slot prevents entities from freezing.
* Added new {{cd|game_events}} tag type.
* Added the {{cd|geode_invalid_blocks}} block tag.
** Includes [[Minecraft:bedrock]], [[Minecraft:water]], [[Minecraft:lava]], [[Minecraft:ice]], [[Minecraft:packed ice]], and [[Minecraft:blue ice]].
* Added the {{cd|ignored_by_piglin_babies}} item tag.
** Contains leather.
** Baby piglins do not attempt to pick up items in this tag. Adult piglins are unaffected. Baby piglins still follow the other rules adult piglins follow.
*** If an item is in this tag while simultaneously being recognized as a wanted item by piglins, this tag takes precedence.
* Added the {{cd|ignore_vibrations_sneaking}} game event tag.
** Contains the step, swim, falling, and shooting projectile events.
** Game events in this tag are ignored by sculk sensors if the source entity is sneaking.
* Added the {{cd|inside_step_sound_block}} block tag.
** Contains snow and powder snow.
** Blocks in this tag create snow stepping noises while the player walks '''in''' them.
* Added the {{cd|lava_pool_stone_replaceables}} block tag.
** Includes the [[Minecraft:Tag#blocks features_cannot_replace|#features_cannot_replace]] block tag and the [[Minecraft:Tag#blocks leaves|#leaves]] block tag.
* Added the {{cd|lush_ground_replaceable}} block tag.
** Contains the <code>[[Minecraft:Tag#blocks moss_replaceable|#moss_replaceable]]</code> block tag, clay, gravel and sand.
* Added {{cd|mineable/axe}}, {{cd|mineable/hoe}}, {{cd|mineable/pickaxe}}, and {{cd|mineable/shovel}} block tags.
** Blocks with these tags can be destroyed more quickly with the matching tool.
* Added the {{cd|moss_replaceable}} block tag.
** Contains the [[Minecraft:Tag#blocks base_stone_overworld|#base_stone_overworld]] block tag, the [[Minecraft:Tag#blocks cave_vines|#cave_vines]] block tag, and the [[Minecraft:Tag#blocks dirt|#dirt]] block tag.
* Added {{cd|needs_stone_tool}}, {{cd|needs_iron_tool}}, and {{cd|needs_diamond_tool}} block tags.
** If a block requires the correct tool to drop, these tags determine which tier of that tool is required.
* Added the {{cd|occludes_vibration_signals}} block and item tag.
** Contains the {{cd|wool}} block and item tag.
** Blocks in this tag prevent [[Minecraft:sculk sensor]]s from hearing vibrations if the block is between the sculk sensor and the vibration.
** As thrown entities, items in this tag do not trigger vibrations.
* Added the {{cd|piglin_food}} item tag.
** Contains raw and cooked porkchop.
** Piglins can eat items in this tag.
*** Eating refers to the [[Minecraft:piglin]] seeking out and picking up an item without appearing in its inventory, thus vanishing.
* Added the {{cd|powder_snow_walkable_mobs}} entity tag.
** Contains foxes, rabbits, endermites, and silverfish.
** Entities in this tag can walk on top of powder snow.
* Added the {{cd|small_dripleaf_placeable}} block tag.
** Contains [[Minecraft:clay]] and [[Minecraft:moss block]]s.
** [[Minecraft:Small dripleaf]] can be placed on blocks in this tag.
* Added the {{cd|snow}} block tag.
** Contains [[Minecraft:snow]], [[Minecraft:snow block]]s and [[Minecraft:powder snow]].
** Blocks in this tag turn blocks with a snowy variant below them (like grass) into said snow variant.
* Added the {{cd|stone_ore_replaceables}} block tag.
** Contains stone, granite, diorite, and andesite.
* Added the {{cd|vibrations}} game event tag.
** Contains every game event.
** Game events in this tag trigger sculk sensors.

'''Textures'''
* Removed some unused textures, including:
** The texture for the zombie villager before 1.9.
** The "arrow.png" placed outside of the [[Minecraft:arrow]] folder that included the purple arrow texture.
** The ruby item texture.
** The piglin leather armor models.
** The footprint [[Minecraft:particles]].

== Changes ==
=== Blocks ===
'''[[Minecraft:Anvil]]s'''
* The maximum length a name of an item can have after being renamed has been increased from 35 characters to 50 characters.

'''[[Minecraft:Banner]]s'''
* The unused "base" pattern has been renamed to the "field" pattern and given proper translation strings (its ID is still "base").

'''[[Minecraft:Beacon]] '''
* Beacon beams are now visible up to 1343 blocks away from the source instead of 256 blocks.

'''[[Minecraft:Blackstone]], [[Minecraft:gilded blackstone]], [[Minecraft:polished blackstone bricks]], and [[Minecraft:cracked polished blackstone bricks]] as well as stair, slab and wall variants'''
* Slightly changed the texture.

'''[[Minecraft:Brewing stand]]'''
* Changed potion icon in the brewing stand GUI to reflect the new bottle texture in the [[Minecraft:Texture Update]].<ref>{{bug|MC-150784}}</ref>
* Removed some stray pixels from the GUI texture.

'''[[Minecraft:Cake]]s'''
* Have a variation called "Cake with Candle".
** Can be created by {{control|using}} a [[Minecraft:candle]] on an uneaten cake.
** The candle on the cake comes in 17 colors, depending on the color of the candle used to create it.
** The candle pops off when any of the cake is eaten.

'''[[Minecraft:Cauldron]]s'''
* Can now be filled with lava and powder snow.
** Lava-filled cauldrons can damage players and mobs inside of them, and give off a [[Minecraft:redstone comparator]] signal of strength 3.
** Powder snow cauldrons are formed when cauldrons are under the sky during [[Minecraft:snowfall]].
** Can also be filled with powder snow by {{ctrl|using}} a powder snow bucket on it.
* Have been split into normal, water, lava, and powder snow cauldrons. 

'''[[Minecraft:Composter]]'''
* Some items are now compostable:
** 30% chance: non-flowering azalea leaves, glow berries, moss carpet, small dripleaf, hanging roots.
** 50% chance: flowering azalea leaves, glow lichen.
** 65% chance: spore blossoms, non-flowering azalea, moss blocks, big dripleaf.
** 85% chance: flowering azalea.

'''[[Minecraft:Dispenser]]'''
* Can now place [[Minecraft:powder snow]] using a [[Minecraft:powder snow bucket]].
** Also can remove it using a [[Minecraft:bucket]].
* Can be used to wax copper blocks with [[Minecraft:Honeycomb]]. 

'''[[Minecraft:End portal (block)|End portals]]'''
* Now render on the bottom face.

'''[[Minecraft:Grass block]]'''
* Changed part of the dirt of the side texture of snowy grass to match regular grass.<ref>{{bug|MC-1483}}</ref>

'''[[Minecraft:Grass path]]'''
* Renamed to "Dirt Path", as per {{BE}}. 
** The block ID has also been changed to {{cd|dirt_path}}.
* Can now be made with dirt, coarse dirt, rooted dirt, mycelium, and podzol by using a shovel.

'''[[Minecraft:Infested block]]s'''
* Instead of breaking instantly, infested blocks now take half of the time to [[Minecraft:Hardness|break]] compared to their regular counterparts.
* Pickaxes are the assigned tool for breaking them.

'''[[Minecraft:Block of Lapis Lazuli|Lapis Lazuli Block]]'''
* Renamed to "Block of Lapis Lazuli".

'''[[Minecraft:Lectern]]'''
* Slightly shrunk top part to prevent z-fighting with [[Minecraft:fire]].<ref>{{bug|MC-214568}}</ref>

'''[[Minecraft:Mycelium]]'''
* Grass, tall grass, ferns, tall ferns, sweet berry bushes, saplings, flowers, azaleas, sugar cane, dead bushes, and bamboo can now be placed on these blocks.
* Pumpkins and melons can now grow onto these blocks.

'''[[Minecraft:Ore]]s'''
* Texture changes (all [[Minecraft:Overworld]] ores except [[Minecraft:diamond ore|diamond]]) had the shape of the "ore pattern" in the stone changed to make them visually distinct for colorblind players:

:: {| class="wikitable" data-description="Natural Blocks"
! Name
! Old texture
! New texture
! Deepslate texture
|-realisticmode
| [[Minecraft:Coal ore]]
| [[File:Coal Ore JE2 BE2.png|80px]]
| [[File:Coal Ore JE5.png|80px]]
| [[File:Deepslate Coal Ore JE1.png|80px]]
|-
| [[Minecraft:Diamond ore]]
| [[File:Diamond Ore JE3 BE3.png|80px]]
| [[File:Diamond Ore JE5.png|80px]]
| [[File:Deepslate Diamond Ore JE2.png|80px]]
|-
| [[Minecraft:Emerald ore]]
| [[File:Emerald Ore JE3 BE2.png|80px]]
| [[File:Emerald Ore JE4 BE3.png|80px]]
| [[File:Deepslate Emerald Ore JE1.png|80px]]
|-
| [[Minecraft:Gold ore]]
| [[File:Gold Ore JE3 BE2.png|80px]]
| [[File:Gold Ore JE7.png|80px]]
| [[File:Deepslate Gold Ore JE2.png|80px]]
|-
| [[Minecraft:Iron ore]]
| [[File:Iron Ore JE3.png|80px]]
| [[File:Iron Ore JE6.png|80px]]
| [[File:Deepslate Iron Ore JE2.png|80px]]
|-
| [[Minecraft:Lapis lazuli ore]]
| [[File:Lapis Lazuli Ore JE2 BE2.png|80px]]
| [[File:Lapis Lazuli Ore JE4.png|80px]]
| [[File:Deepslate Lapis Lazuli Ore JE3.png|80px]]
|-
| [[Minecraft:Redstone ore]]
| [[File:Redstone Ore JE2 BE2.png|80px]]
| [[File:Redstone Ore JE4.png|80px]]
| [[File:Deepslate Redstone Ore JE2.png|80px]]
|}
* [[Minecraft:Emerald ore]] can now replace [[Minecraft:granite]], [[Minecraft:andesite]], [[Minecraft:diorite]], [[Minecraft:tuff]], and [[Minecraft:deepslate]] upon generating.

'''[[Minecraft:Piston]]s'''
* [[Minecraft:Particles]] now appear if a block is broken by a piston or sticky piston.
** Sounds, however, do not play.<ref>{{bug|MC-203550}}</ref>
* Breaks Budding Amethyst if pushed/pulled with a piston/sticky piston.

'''[[Minecraft:Pumpkin]]'''
* Changed one pixel on the pumpkin's top texture to remove the possibility for a small [[Minecraft:wikipedia:Swastika|swastika]] to be displayed.<ref>{{bug|MC-197561}}</ref>

'''[[Minecraft:Rail]]s'''
* Are now able to be [[Minecraft:waterlog]]ged.
* No longer broken by flowing [[Minecraft:water]] and [[Minecraft:lava]].

'''[[Minecraft:Sign]]s'''
* Changed the textures of acacia, birch, dark oak, jungle, oak, and spruce signs to reflect new textures in the [[Minecraft:Texture Update]].
* Can now be tinted with glow ink sacs to make the text glow.
** Glowing signs do not affect the light level, but appear as if the text itself is illuminated.
** A new <code>lit</code> [[Minecraft:block state]] had been added to indicate whether the sign text is lit up.
** Regular [[Minecraft:ink sac]]s can be used to remove the glowing effect.
** Now has sounds for being dyed.

'''[[Minecraft:Smoker]]'''
* Changed the top texture of the smoker to fix a stray pixel in the bottom left corner.

'''[[Minecraft:Stonecutter]]'''
* Can be used to craft the different [[Minecraft:copper block]] variants.

'''[[Minecraft:Structure block]]'''
* Default mode of structure blocks is now "Load". "Data" is now hidden by default.
* "Data" can be accessed by clicking the mode button while holding the {{key|Alt}} key.
* All invisible blocks are now displayed as small cubes by save mode [[Minecraft:structure block]]s; previously barriers and light blocks would not display at all.<ref>{{bug|MC-102220}}</ref><ref>{{bug|MC-221833}}</ref>
** Variants of air still all appear identical and are not distinguished.<ref>{{bug|MC-221834}}</ref>
{| class="wikitable" style="text-align:center"
!
! [[Minecraft:Air]], [[Minecraft:cave air]] and [[Minecraft:void air]]
! [[Minecraft:Structure void]]
! [[Minecraft:Barrier]]
! [[Minecraft:Light block]]
|-
! Before
| [[File:Air (shown) JE2.png|80px]]
| [[File:Structure Void (shown) JE2.png|80px]]
| [[File:Blank.png|80px]]
| [[File:Blank.png|80px]]
|-
! After
| [[File:Air (shown) JE2.png|80px]]
| [[File:Structure Void (shown) JE3.png|80px]]
| [[File:Barrier (shown) JE1.png|80px]]
| [[File:Light (shown) JE1.png|80px]]
|}

=== Items ===
'''[[Minecraft:Bone meal]]'''
* Added sounds for using bone meal.

'''[[Minecraft:Clock]]'''
* The texture has been changed from [[File:Clock JE2 BE2.gif|32px]] to [[File:Clock JE3.gif|32px]]

'''[[Minecraft:Compass]] and [[Minecraft:lodestone compass]]'''
* The texture has been changed from [[File:Compass JE2 BE1.gif|32px]] to [[File:Compass JE3.gif|32px]]

'''[[Minecraft:Firework rocket]]s'''
* Simple firework rockets with one gunpowder can now be crafted using the recipe book.

'''[[Minecraft:Jungle door]]s'''
* Changed the texture of the jungle door item to reflect the block texture in the Texture Update.<ref>{{bug|MC-160195}}</ref>

'''[[Minecraft:Pufferfish (item)|Pufferfish]]'''
* The strength of the [[Minecraft:Poison]] effect has been decreased from IV to II.<ref>{{Bug|MC-197276}}</ref>

'''[[Minecraft:Shulker box]]es'''
* Now drop their items when destroyed as entities.

'''[[Minecraft:Spawn egg]]s'''
* The spawn egg dispenser behavior now catches any exceptions that could be thrown when spawning the entity.

'''[[Minecraft:Spectral arrow]]s'''
* Fired spectral arrows are now entirely golden to reflect the item texture in the Texture Update.<ref>{{bug|MC-150054}}</ref>

'''[[Minecraft:Sugar cane]]'''
* Changed the texture of the sugar cane item to better reflect biome tinting added in [[Minecraft:Java Edition 1.7.2|1.7.2]].<ref>{{bug|MC-216227}}</ref>

'''[[Minecraft:Suspicious stew]]'''
* Can now be eaten even if the player is at full [[Minecraft:hunger]].

=== Mobs ===
'''[[Minecraft:Bee]]'''
* Now can pollinate [[Minecraft:cave vines]].

'''[[Minecraft:Cat]]s'''
* Changed the texture of the siamese cat type, mostly brightening it.

'''[[Minecraft:Drowned]]'''
* Now have a chance of dropping a [[Minecraft:copper ingot]] instead of a [[Minecraft:gold ingot]].

'''[[Minecraft:Endermen]]'''
* Can now pick up rooted dirt.

'''[[Minecraft:Endermite]]s'''
* Endermen are now aggressive toward non-pearl-spawned endermites.

'''[[Minecraft:Fox]]es'''
* Eat glow berries.

'''[[Minecraft:Guardian]] and [[Minecraft:elder guardian]]'''
* Removed some stray pixels from the texture file.
* Now drop cooked cod or salmon instead of raw cod or salmon if on [[Minecraft:fire]] when killed or killed by a fire source.

'''[[Minecraft:Husk]], [[Minecraft:zombie]], and [[Minecraft:zombie villager]]'''
* Now drop [[Minecraft:baked potato]]es instead of normal [[Minecraft:potato]]es if on fire when killed or killed by a fire source.

'''[[Minecraft:Llama]]'''
* No longer spit at players in [[Minecraft:Peaceful]] mode.

'''[[Minecraft:Polar bear]]s'''
* Now drop cooked cod or salmon instead of raw cod or salmon if on [[Minecraft:fire]] when killed or killed by a fire source.

'''[[Minecraft:Shulker]]s'''
* If a shulker is hit by another shulker's projectile, it now has a chance of spawning a new shulker. Shulkers are more likely to spawn new shulkers when there are fewer shulkers nearby.

'''[[Minecraft:Skeletons]]'''
* Begin the process of turning into [[Minecraft:stray]]s when they are inside [[Minecraft:powder snow]] after {{convert|7|second|game tick}}.

'''[[Minecraft:Slime]]'''
* The maximum size that slimes can be summoned with is now 128.

'''[[Minecraft:Squid]]'''
* Now [[Minecraft:lead]]s work with them.

'''[[Minecraft:Villager]]s and [[Minecraft:zombie villager]]s'''
* Moved the librarian top overlay texture to correct side of torso.<ref>{{bug|MC-145501}}</ref>
* Mason villagers can now sell 4 [[Minecraft:dripstone block]]s for an [[Minecraft:emerald]].
* Can now accept a filled [[Minecraft:cauldron]] as a valid workstation.

'''[[Minecraft:Wandering trader]]s'''
* Added the following trades:
** Sells 2 [[Minecraft:small dripleaf]]s for an emerald.
** Sells 2 [[Minecraft:pointed dripstone]]s for an emerald.
** Sells 2 [[Minecraft:rooted dirt]] for an emerald.
** Sells 2 [[Minecraft:moss block]]s for an emerald.

=== Non-mob entities ===
'''[[Minecraft:Experience orb]]s'''
* Now sometimes merge when in large quantities, to improve performance.
** Merging does not affect the amount of experience gathered from collecting the merged orbs.
* No longer follow dead players.

'''[[Minecraft:Minecart]]s'''
* Can now move in water, but move considerably slower than they do on land.

'''[[Minecraft:Painting]]s'''
* Changed the back texture to reflect the texture of the planks in the Texture Update.

=== World generation ===
'''[[Minecraft:Biome]]s'''
* Biome-specific sky colors now blend more smoothly.

[[File:21w07a Mineshaft.jpg|alt=A 1.17 Mineshaft with ceiling supports and oak log supports from the ground |thumb|A 1.17 mineshaft]]
'''[[Minecraft:Mineshaft]]s'''
* Mineshaft pieces no longer generate if they were fully floating in the air.
* Corridors now generate with wooden [[Minecraft:log]]s as pillars for support, or chains and oak fences as hanging support if needed.
* Cobwebs no longer generate floating without an adjacent block.
* [[Minecraft:Glow berries]] can be found in mineshaft [[Minecraft:chest]] minecarts.

'''[[Minecraft:Stronghold]]s'''
* No longer generate exposed in oceans; they are covered by the seabed.

'''[[Minecraft:Shipwreck]]s'''
* [[Minecraft:Moss block]]s can be found in chests.

=== Command format ===
'''{{cmd|debug}}'''
* Removes debug report command.
* Replaced by F3+L and {{cmd|perf}}.

'''{{cmd|give}}'''
* The give command can give only up to 100 stacks of items at a time (e.g. 6400 stone or 100 iron swords)

'''{{cmd|item}}'''
* New syntax:
** {{cmd|item replace <target> with <item stack> [<count>]}}
*** Same as old version of {{cmd|item}}.
** {{cmd|item replace <target> from <nowiki><source></nowiki> [<modifier>]}}
*** Copies item for source to target(s), optionally applying modifier.
** {{cmd|item modify <target> <modifier>}}
*** Modifies item (without copying).

'''{{cmd|replaceitem}}'''
* Removed {{cmd|replaceitem}} command.
* Replaced with {{cmd|item replace}}.

'''{{cmd|spawnpoint}}'''
* Can no longer set a player's spawn point to areas that are out of the world.

=== Gameplay ===
'''[[Minecraft:Absorption]] effect'''
* The yellow absorption hearts now stay yellow if the player has the Poison or Wither effects, instead of appearing empty.

'''[[Minecraft:Advancement]]s'''
* Added <code>source</code> condition to <code>effects_changed</code> trigger.
* Glow berries are now required for "A Balanced Diet".
* Goats and axolotls are now required for "Two by Two" and available for "The Parrots and the Bats".
* The advancement for obtaining diamond armor is now capitalized as "Cover Me with Diamonds", as opposed to "Cover Me With Diamonds".

'''Build limit'''
* The message for letting the player know they are attempting to build beyond the build limit no longer says "blocks" at the end.

'''{{EffectLink|Glowing}}'''
* Glowing is now based on the outline of all layers on an entity, not just the base layer.

'''[[Minecraft:Loot table]]s'''
* Loot tables can now access [[Minecraft:scoreboard]] values by [[Minecraft:UUID]].
* Loot table values inside random number generators can now be nested.
* Changed condition: {{cd|score}}
** {{cd|entity}} parameter has now been replaced with {{cd|target}}. It can either contain value from old {{cd|entity}} field (like {{cd|this}}) or be a score holder name in form <code>{"name": "..."}</code>.
* Changed function: {{cd|set_damage}}
** This function now has {{cd|add}} parameter. If {{cd|true}}, change is relative to current damage. If {{cd|false}}, damage is replaced with current value (default behavior)
* Changed function: {{cd|set_count}}
** This function now has {{cd|add}} parameter. If {{cd|true}}, change is relative to current item count. If {{cd|false}}, item count is replaced with current value (default behavior)
* Changed function: {{cd|copy_nbt}}
** {{cd|source}} parameter can now be set to <code>{"storage": <namespaced id>}</code>, to access command storage.

'''NBT data'''
* All projectile entity data now has a field called HasBeenShot.
** If this field is false, during the next tick the projectile fires a projectile shot game event, causing any nearby sculk sensors to react.

'''[[Minecraft:Recipe book]]'''
* Some recipe-unlocking advancements had criteria names changed.
* The [[Minecraft:chiseled nether bricks]] recipe is now unlocked by having a nether brick slab instead of a nether brick block.
* The [[Minecraft:chiseled polished blackstone]] crafting recipe is now unlocked by having a polished blackstone slab, instead of polished blackstone.
* The recipes for stonecutting diorite into polished diorite slabs and stairs now unlocks when the player has diorite as opposed to polished diorite.
* The recipe for crafting mossy stone bricks from moss blocks or vines is now unlocked with moss blocks or vines, respectively, rather than mossy cobblestone.
* Simple firework rockets with one gunpowder can now be crafted using the recipe book.
* The recipes for mossy stone bricks are now grouped, as are the recipes for mossy cobblestone.

'''[[Minecraft:Snowfall]]'''
* During snowfall, [[Minecraft:cauldron]]s under the sky now slowly fills with [[Minecraft:powder snow]].

'''[[Minecraft:Mob spawning|Spawning]]'''
* Added a new mob cap category, underground water creature.
** Used by axolotls and glow squids.
** Have a cap of 5, are friendly, are not persistent and despawn at 128 blocks or more from the player.

'''[[Minecraft:Spectator]] mode'''
* It is now possible to see while inside [[Minecraft:lava]].

'''[[Minecraft:Subtitle]]s'''
* Changed <code>Shulker bullet explodes</code> to <code>Shulker Bullet explodes</code>.
* Changed <code>Shulker bullet breaks</code> to <code>Shulker Bullet breaks</code>.
* Changed the subtitles for stripping logs and wood from "Axe scrapes" to "Axe strips".
** "Axe scrapes" is now used for copper blocks.

=== General ===
'''Block models'''
* Made the vine's block model much simpler. 

'''Code'''
* Unused parts of code (unused static fields and methods) are no longer removed.
** Although this does not affect the game itself, it adds more information for [[Minecraft:mod]]ders.
* Updated required Java version to Java 16.<ref>{{Mcnet|minecraft-snapshot-21w19a|Minecraft Snapshot 21w19a|May 12, 2021}}</ref>

'''[[Minecraft:Creative inventory]]'''
* The redstone tab has been reordered to prioritize highly-used blocks.
* [[Minecraft:Slime block]]s and [[Minecraft:honey block]]s are moved to the redstone tab.
* Redstone items/blocks have been grouped and ordered in the following way (from top to bottom): Essentials, Unique activators, Miscellaneous, Common activators, and Openables.
** The category for the recipe book advancements for these recipes has moved as well.

'''[[Minecraft:Credits]]'''
* Updated the credits, which were brought over from ''Bedrock Edition''; as a result, the credits are significantly longer, as they include people and corporations that did not work on ''Java Edition''.<ref>{{bug|MC-226535||Java Edition is using credits from Bedrock now|Works As Intended}}</ref>
* Changed the format from {{cd|.txt}} to {{cd|.json}}.
* Now scroll faster when holding {{key|Space}}.
** They scroll even faster when holding {{key|Space}} and one or both of the {{key|Ctrl}} keys together.

'''[[Minecraft:Custom dimension]]s'''
* Added {{code|height}} and {{code|min_y}} variables to dimension types, allowing for the height limit to be increased in custom worlds settings.<!--
** The minimum value of {{cd|min_y}} is -2047 and the maximum value of {{cd|height}} is 2048. {{verify|type=change}}-->

'''[[Minecraft:Data Pack|Data]] and [[Minecraft:resource pack]]s'''
{{Resource pack format/value|7}}
* Data pack version is also changed to 7.

'''Dedicated [[Minecraft:server]]s'''
* A dedicated server can enforce custom resource packs by setting {{cd|require-resource-pack}} in {{cd|server.properties}}. When this option is used, players are prompted for a response and get disconnected if they decline the required pack.

'''Entity storage'''
* Entities have been extracted from main (terrain) chunks and are now stored in separate {{cd|entities}} directory (similar to POI storage). Those new files are still region files with NBT.

'''Game library updates'''
* Rendering is now using OpenGL 3.2 core profile.
** All fixed-function rendering has been replaced with shader-based rendering.
* The game now uses javabridge 1.1.23 instead of 1.0.22.
* Authlib was updated from 2.2.30 to 2.3.31.

'''[[Minecraft:Language]]s'''
* Removed the Gothic, Kabyle, Maori, Mohawk, Nuk, Ojibwe, and Talossan languages as their translations were incomplete.

'''[[Minecraft:Material]]s'''
* Removed the coral material.
* Added the moss material.

'''[[Minecraft:Options]] screen'''
* Buttons tied to a set of values can now be scrolled through.
* Clicking {{key|Shift}} on a menu button changes it to the previous value.
* The [[Minecraft:debug mode]] can now be accessed only by holding {{key|Alt}} instead of {{key|Shift}} while clicking on the world type button.

'''[[Minecraft:Narrator]]'''
* GUI narration now includes position and usage of hovered or focused element.

'''[[Minecraft:Obfuscation map]]'''
* Changed the license included in the obfuscation map.

'''[[Minecraft:Predicate]]'''
* Added <code>passenger</code>, <code>stepping_on</code> and <code>lightning_bolt</code> properties to <code>entity_properties</code> predicate
* Added <code>looking_at</code> (entity currently viewed by player) condition to <code>player</code> sub-predicate.
* Expanded <code>item</code> field on <code>item</code> predicate to <code>items</code>.
** Now accepts an array of item types.
* Expanded <code>block</code> field on <code>block</code> predicate to <code>blocks</code>.
** Now accepts an array of block types.

'''Protocol'''
* While connecting to a server, the client sends a handshake packet with "hostname" and "port" field directly padded with address given in address text field directly, instead of converting them to the real hostname and port.

'''[[Minecraft:Resource pack]]s'''
* Improved performance when using many overrides on an item model.
* <samp>toasts.png</samp> GUI texture has a new icon for the bundle tutorial.
* Users who previously permanently declined server resource packs now still are shown the pack prompt if the pack is mandatory, instead of being immediately disconnected.

'''[[Minecraft:Server]]s'''
* Removed the {{cd|max-build-height}} server setting.
* Changed the error message for failing to connect to the authentication servers. Now says they are "not reachable" instead of "down for maintenance".

'''[[Minecraft:Skin]]s'''
* Legacy skin handling now has improved skin validation.

'''[[Minecraft:Splash]]es'''
* Changed the splash "Now Java 8!" to "Now Java 16!"
* Changed the splash "OpenGL 2.1 (if supported)!" to "Now on OpenGL 3.2 core profile!"
* Removed "Woo, /v/!"

'''[[Minecraft:Statistics]]'''
* Renamed the statistic for play time to <code>play_time</code>.
* Included time when game paused for "Time with World Open" (<code>total_world_time</code>).

'''[[Minecraft:Tag]]s'''
* Added azalea leaves and azalea leaves flowers to the {{cd|leaves}} block and item tags.
* Added azaleas and flowering azaleas to the {{cd|saplings}} block and item tags.
* Added flowering azalea leaves and flowering azaleas to the {{cd|flowers}} block and item tags.
* Added potted azalea bushes and potted flowering azaleas bushes to the {{cd|flower_pots}} block tag.
* Added deepslate and tuff to the {{cd|base_stone_overworld}} block tag and deepslate to the {{cd|stone_crafting_materials|stone_tool_materials|d=and}} item tags.
* Added deepslate gold ore to the {{cd|gold_ores}} block and item tags.
* Added all copper slab and stair variants, as well as various deepslate variants to the {{cd|slabs|stairs|walls|d=and}} block and item tags.
* Added cave vines and cave vines plant to the {{cd|climbable}} block tag.
* Added tinted glass to the {{cd|impermeable}} block tag.
* Added raw gold and raw gold blocks to the {{cd|piglin_loved}} item tag.
* Added raw gold blocks to the {{cd|guarded_by_piglins}} block tag.
* Added cave vines and cave vines plant to the {{cd|bee_growables}} block tag.
* Changed the {{cd|bamboo_plantable_on|enderman_holdable|d=and}} block tags to use the {{cd|dirt}} block tag, removing other mentions of dirt blocks from the tags.

'''Technical'''
* Java requirement changed from version 8 to version 16.

'''Text'''
* Changed the strings "Chat disabled by launcher option, cannot send message" and "Chat not allowed by account settings, cannot send message" to "Chat disabled by launcher option. Cannot send message" and "Chat not allowed by account settings. Cannot send message", respectively.

'''Textures'''
* Removed stray pixels from the recipe book GUI button.

'''[[Minecraft:Title screen]]'''
* The main menu background is now in an [[Minecraft:amethyst geode]].

'''Translation strings'''
* The "World Type" string no longer contains a colon (":"). The colon is still visible in-game, however.
* Changed "Use VSync" to "VSync".
* Removed the unused string for enabling VBOs, "Use VBOs".
* Added strings, "Mode", "Type", "Triggering", and "Track output". These are read out by the narrator for buttons in the [[Minecraft:command block]] UI.

'''World selection'''
* Added unique warnings for downgrading a world.

== Fixes ==
{{Fixes|fixedin=1.17,1.17 Release Candidate 2,1.17 Release Candidate 1,1.17 Pre-release 5,1.17 Pre-release 4,1.17 Pre-release 3,1.17 Pre-release 2,1.17 Pre-release 1,21w20a,21w19a,21w18a,21w17a,21w16a,21w15a,21w14a,21w13a,21w11a,21w10a,21w08b,21w08a,21w07a,21w06a,21w05b,21w05a,21w03a,20w51a,20w49a,20w48a,20w46a,20w45a|otherissuescount=4
|;old
|610|Grass / Flowers / Snow are placed incorrectly in newly created chunks.
|1483|Snow covered grass/podzol/mycelium block side texture does not match original block.
|2490|TNT animation ends at 80 ticks, ignores fuse length changes.
|3366|End portal appears transparent from below.
|3587|Last use of an anvil causes player to drop their item.
|3615|Lava and water are completely transparent at certain height levels.
|8017|Arrows and tridents are not being slowed down by webs but eggs and snowballs are.
|9591|Players are able to create ghost lily pads.
|12363|Lava / water / powder snow bucket desync when using it while rapidly turning.
|18880|The Absorption effect has no texture for poison/wither hearts (appears empty instead).
|19690|Reducing <code>maxHealth</code> / <code>max_health</code> can cause fake death.
|29318|Client misses inventory updates while player is manipulating items - causes invisible items.
|29522|<code>stat.playOneMinute</code> adds a value of 1 every tick.
|32452|Fog generates only in the centre of the screen.
|46650|When flying through blocks in spectator mode in {{key|F5}}, the camera zooms in and out a lot.
|53518|Endermen don't attack endermites spawned using spawn eggs or {{cmd|summon}}.
|55775|Statistics screen sometimes doesn't show up to date information.
|65587|Lag spike while loading player head textures/player skins.
|68129|Smooth lighting doesn't work properly underwater.
|70738|Killing guardian with lava does not give cooked fish.
|70850|False negatives during occlusion culling.
|71530|Spectators can't see through lava.
|73104|Server address field editing bug.
|79888|Beacon beam can be seen when you have blindness effect.
|80468|Inconsistency between block names.
|84121|Shape of glow effect is based on mob's base layer.
|85967|Vines placed without a support block using {{cmd|setblock}} cannot be interacted with.
|86313|Off-hand slot sometimes doesn't play item pickup animation.
|86645|Scroll bar goes higher than chat overlay.
|87019|Only visible slots are updated clientside when you are inside an inventory.
|89078|Command block GUI takes a brief time to update (output bar shown when disabled, mode buttons in wrong state).
|89880|Spawner with weight <code>0</code> crashes the game.
|91522|Shulker rendering position desync and generates ghost shulker when destroying shulker-ridden boat or minecart.
|91888|Hotkeying books on enchantment table causing client-side item count inaccuracy.
|92349|Players cannot tempt animals with food while other players are closer to the animal.
|92867|Setting JSON text value to <code>null</code> throws exceptions and crashes.
|93243|Fog Rendering On AMD Graphics Cards & Integrated Graphics.
|96114|Shulker can lift up mobs.
|96322|Shulkers are unable to attack from boat.
|98219|Experience orbs follow dead players.
|99098|Shulker open and close hitbox is not updated, when they ride boat, minecart or mobs.
|99189|Client overrides map data of map with id 0 when a new map is created.
|99259|The wither health bar doesn't go up during spawn.
|99680|Heart jittering effect doesn't take absorption into account.
|101244|Can't scan for LAN worlds on macOS.
|102220|Barrier Blocks are not shown when "Show Invisible Blocks" is selected in Save Structure Blocks.
|102269|Polar bears drop raw fish instead of cooked fish when killed with fire or lava.
|103430|Vines breaking too slow (enchanted shears).
|104897|End crystals placed on exit portals generated before 1.9 do not respawn the ender dragon.
|105035|Floating mineshafts generating incorrectly in shade.
|105080|Ender Dragon is respawned if all Exit End Portal blocks are removed / legacy scanning is done for worlds with new dragon fight.
|105344|Shulkers in boats and minecarts do not sit up if previousely attached to blocks sideways.
|106417|Shulkers can be pushed outside of the world border by a piston.
|106613|Shulker no longer continue close or open when it hurt in the peaceful mode.
|106690|Servers sends <code>SPacketMaps</code> packets even if the map data did not change.
|108469|Chunk-wise entity lists often don't get updated correctly (entities disappear).
|108636|There are a number of unused texture files.
|108717|Shulkers cannot be pushed back.
|110903|Cannot remove horse saddle using {{cmd|replaceitem}}.
|111196|Using a monster spawner to spawn shulkers spawns white shulkers.
|111534|The firework rocket use statistic doesn't count rockets used for elytra boosting.
|112147|Lava burning items or XP orbs sound muted when "Friendly Creatures" slider is turned off.
|113177|Shulkers cannot be pushed inside non-solid blocks.
|114796|Overworld nether portals outside of the world border (up to ~128m from the border) are considered valid.
|117653|Recipes and advancements are not granted while most GUIs are open.
|118757|Increasing Game State Rain Level values make the game increasingly laggier and distorts UI.
|119051|Random transparent line in shulker box GUI texture.
|121897|Gaps in an animation's used frames throws <code>ArrayIndexOutOfBoundsException</code>.
|123587|Kicked from the game when reaching y levels over 30,000,000.
|124109|Horses glitched with glowing effect.
|124667|Air can be used in custom recipes, causing a crash.
|125675|Seagrass placed on the ocean floor can replace ocean monument parts.
|125858|Grass / flowers / snow / trees are placed incorrectly in Superflat World.
|126997|Undyed shulker box still uses cauldron's water when right clicking.
|127201|{{cmd|replaceitem}} makes quite an obnoxious sound, which is not heard by the person whose items are being replaced.
|127692|Experience build up in furnace when using a hopper which can cause severe lag.
|130098|Debug world spawns player at y{{=}}2 instead at y{{=}}70 where all the blocks are.
|130449|Cartographer villager freezes or crashes the game when unlocking explorer maps.
|130523|Void World spawns you at y{{=}}0 even if you entered 64 air blocks in customization.
|130584|When a structure loads, water sources in the structure spread into waterloggable blocks.
|131564|Models that have locked uv in blockstates ignore texture rotation.
|133691|Blocks cannot be placed normally on a full cauldron.
|135552|Dead entities are saved to chunk.
|135561|Failed to create OpenGL context on some Linux systems with Nvidia driver.
|136497|XP orbs causing severe lag.
|136560|<code>minecraft.used:minecraft.elytra</code> not functioning.
|136647|Leads don't work with Squids.
|136681|Debug Stick use statistic increases when not allowed to use it.
|136776|Some NBT tags are not kept when fish or axolotl mobs are caught in water buckets.
|137452|Bamboo grows in lots of inappropriate places in Bamboo Jungles.
|139265|Shulkers do not teleport correctly when going through a portal.
|141034|<code>taiga_fisher_cottage_1</code> is filled with water.
|142711|Baby turtles take damage when pushed against ceiling.
|143732|Undead mobs that are halfway in sand blocks dont burn in daylight.
|143821|Using an empty map in creative mode can create an additional map with ID 0.
|145501|Librarian and zombie librarian torso top texture is incorrect.
|147589|Vines no longer randomly generate in jungles.
|147729|Crafting via the recipe book can delete items if picking up items while crafting.
|148071|If you switch to a crossbow after charging another bow/crossbow, the crossbow you switched to will go weird for a second in the hotbar.
|148206|Hand punching animation is played after eating crops while looking at a block.
|148432|Sound spam while in water and lava at the same time.
|148758|The loading screen is incorrect when reloading the resource packs with {{key|F3+T}}.
|148809|Structure block data length limited to 12.
|149495|Pufferfish triggers tripwire without colliding with it upon reloading the game.
|149777|Crash when loading world: <code>java.util.ConcurrentModificationException</code> when using Java 11 or above.
|149799|When a crossbow is loaded and in the offhand, you do not see it anymore if you carry an item in the main hand.
|150054|Spectral arrow texture on item and entity aren't consistent.
|150784|Brewing Stand bottle outline incorrect.
|151270|Teleporting an entity from another dimension can cause UUID duplication in entity sections.
|152265|Starting server outputs "unable to resolve BlockEntity for ItemStack" errors.
|153254|Baby zombies/piglins take damage when pushed against ceiling by bubble columns.
|154006|Overworld wood signs use the outdated wood texture on all sides.
|154094|Lectern running {{cmd|clear}} turns items into ghost items.
|155043|Game output/log gets spammed with <code>Fetching packet for removed entity ...</code> warnings.
|156109|Turtles do not follow players in Creative mode holding seagrass.
|157116|Food that are plantable counts towards using when right click on the ground.
|158466|Server Crash (<code>Exception ticking world: ConcurrentModificationException</code>).
|160195|Jungle door inventory texture is outdated.
|160388|Painting back texture has not been updated with the texture update.
|160994|Blocks broken by pistons do not display breaking particles.
|161334|Shulker boxes cannot be opened if next to a shulker mob.
|161592|Entities lose their scores when switching dimensions.
|162910|Additional map is created when using an empty map in Creative in a newly created world.
|162953|<code>NativeImage</code> bounds checks are incorrect.
|163673|Baby husks, piglins, zombies, zombie villagers, and zombified piglins take damage when jumping into a space with a solid block above it.
|163945|Intersecting structures can create corrupted block entities (spawner / chest).
|165208|Text and other UI elements are completely black when being affected by night vision and the void/blindness simultaneously.
|165846|Pufferfish can take suffocation damage when bloating.
|165924|Snow particles render darker / almost transparent if the block light level is 7 or more.
|166187|Some mobs still try to hit players in Peaceful.
|167113|Snow golems take damage from block that aren't technically in its head.
|167853|Observer doesn't detect when a grass block changes to dirt if a tree grows on top.
|167977|Podzol generated from giant spruce trees is not snowy if it has snow above it.
|168398|Guardian beam is darker.
|168900|Shulkers teleport with original dimension coordinates after passing through portals.
|169717|Blocks in recipe book groups are rendered in front of item tooltips.
|169900|Incorrect jigsaw setting in <code>snowy_small_house_8</code>.
|169945|Skeletons do not burn in minecarts while being exposed to daylight.
|170443|Banner copying recipe ignores existence of other items in crafting grid.
|170653|Fireworks fired from a dispenser get stuck in the air when removing the block they crashed into.
|170659|Loss of precision in <code>entity_scores</code> conditions.
|171229|Loading animation not displaying correctly after optimizing world.
|171852|Putting item in a spectator's hand plays sound "Gear equips" for other players.
|172304|Piglins, piglin brutes, hoglins, zoglins and axolotls can attack their own teammates.
|172362|Lava item burning sound does not play sometimes.
|172466|Entities misaligning when growing up.
|173745|Lower part of end gateway block beam renders incorrectly.
|173834|Glowing damaged iron golem outline shows cracks.
|174216|Shulkers riding a vehicle sometimes appear in the ground after reopening world.
|174685|Drowned arm texture is reversed by the model.
|174701|Leash knot sound effect plays when loading singleplayer world.
|174876|Shulker spawn egg spawns shulker inside soul sand, snow layers, farmland, grass path and honey block.
|175959|One door is open in <code>taiga_shepherds_house_1</code>.
|175964|Setblock command run by book in lectern to clear inventory run in command block causes ghost items.
|176614|Swimming and doing certain actions make the player look very odd/does not have animations for swimming + doing certain actions.
|176615|It is possible to destroy netherite items with lava by putting them inside a container.
|177539|When flattening a grass block into a path immediately after the grass block grows from dirt, the shovel sound doesn't play.
|177622|One log in <code>taiga_butcher_shop_1</code> seems to be misrotated - causing the side roof to look asymmetrical.
|177624|Entrance in <code>snowy_medium_house_2</code> is asymmetrical.
|177630|Infested Stone blocks are mined instantly with Silk Touch.
|179116|Burning item sound ignores lava hitbox level.
|180529|TrueType fonts crash on Intel Graphics.
|181889|Equipping sound plays when mobs picking up non-armor items.
|182455|Entity shadow texture glitching with resource pack.
|182954|"block.minecraft.banner.base.<color>" displays raw translation string (is untranslated).
|183067|Shulkers can push marker armor stands.
|183540|Ancient debris is not grouped together with other ores in the Creative inventory.
|183547|Stone and polished blackstone buttons/pressure plates are located at opposite ends of the spectrum of buttons in the Creative inventory despite being identical in behavior.
|183771|Gamemode switcher icons in the F3+F4 menu are not centered.
|183884|Shulkers are afraid of being next to another shulker.
|183917|Min and max are both required in entity_scores condition.
|185357|Removing a plant from a flower pot still plays generic armor equipping sound/shows Gear equips in subtitles.
|185359|Using a bucket in Survival mode still plays generic armor equipping sound/shows Gear equips in subtitles.
|185360|Milking a mooshroom for stew still plays armor equip sound/shows Gear equips subtitle.
|185605|Kelp generates on top of magma blocks.
|186172|Shulkers open into blocks when unable to teleport.
|186864|Leather armor can appear white.
|186879|Standing in fire and water spams the extinguish sound.
|187544|'Cover Me With Diamonds' advancement improperly capitalized.
|187664|World border uses float to determine its size, making some border sizes inaccessible, and cannot be set to 30 million or beyond.
|188044|Using a banner on a filled cauldron plays hand animation.
|188448|Food pops off of campfire when extinguished.
|189336|{{key|Shift}}ing around servers in the server list crashes the game (<code>ArrayIndexOutOfBoundsException</code>).
|189482|LAN World screen buttons are selected in the wrong order when using {{key|Tab}}.
|189535|Catching a fish in a bucket on creative mode doesn't give player new bucket.
|189565|Some entities do not render inside of spawners and producing error log spam in console, potentially causing lag.
|189885|New byte <code>previousGamemode</code> is read incorrectly.
|189888|When the window size is changed on the main menu, a white flash appears.
|190128|Using a flint and steel to ingite TNT is not tracked by the in-game stats.
|190247|Mob death cloud particles do not show up when killing a mob shortly after the world is loaded.
|190454|Desync when a player rides a horse riding another mob, and that mob dies.
|190677|Shulkers are notaligned to the grid for a split second after being spawned in.
|190774|Stonecutter saw spins both ways simultaneously.
|190896|Lag when opening a shipwreck chest containing buried treasure map.
|190952|Apostrophe in "Developers of Mo' Creatures" heading is inconsistent with other apostrophes in credits.
|191338|Name color for Minecart with Command Block is incorrect.
|191714|Player is dismounted when standing on farmland while riding a horse/boat while the farmland turns to dirt, causing a desync.
|192591|Name color for Structure Void is incorrect.
|192594|<code>plains_stable_1</code> misplaced blocks.
|192629|<code>plains_stable_2</code> misplaced blocks.
|192876|Misplaced trapdoor on <code>taiga_decoration_6</code>.
|192879|Wall incorrectly placed on certain taiga houses.
|192889|When placing certain heads or putting them in entities' head slot the game stutters.
|192930|Zombies picking up items play the gear equipping sound and subtitle.
|193071|Eating food items that return empty containers still play gear equipping sound.
|193386|Shulkers spawned attached to the groud attaches themselves to a wall after another shulker is spawned.
|194089|Shulkers at some Y positions refuse to get a Peek value.
|194183|Some experience points do not go towards Mending repair, even if the Mending gear is not fully repaired.
|194675|While spectating a creeper, enderman, spider or cave spider, UI elements are rendered completely white.
|194685|Collecting water from cauldrons with glass bottles in Creative mode is still inconsistent.
|194686|Collecting water from cauldrons with buckets in Creative mode is still inconsistent.
|195125|<code>plains_animal_pen_1</code> misplaced block.
|195126|<code>plains_animal_pen_3</code> misplaced blocks.
|195351|Comparator in compare mode can schedule unneeded tileticks.
|195461|The upper part of potted cactus/bamboo texture is not visible if there is a half block above it.
|195640|Suspicious stew inedible with full hunger.
|195806|Smoker's top and bottom textures have inconsistently colored pixels.
|195827|<code>datapackFailure.title</code> line in <samp>en_us.json</samp> file has double spaces between the translation string and the equivalent text.
|196298|Arrows fired into the side of bamboo or pointed dripstone never despawn.
|196425|"Off" is not completely capitalized for the Distortion Effects and FOV Effects sliders, which is inconsistent with other sliders.
|196500|Banners are rendered too bright in the inventory.
|196542|Small cleanup for skylight propagation code.
|196638|Placing an armor stand logs warning "Trying to add entity with duplicated UUID".
|197009|Referencing empty item tag in recipe can crash client.
|197073|Turtles laying eggs on red sand produce normal sand particles.
|197140|Jack o'lantern does not come after carved pumpkin in Creative inventory.
|197179|Baby piglins that pick up leather do not despawn, cluttering the Nether with unnecessary baby piglins.
|197276|Pufferfish gives Poison IV instead of II.
|197328|Entities sometimes don't render behind the water surface on Fast or Fancy graphics.
|197524|Border chunks do not enforce neighbors to be loaded, causing light updates to get stuck.
|197561|Carved pumpkins and jack o'lanterns create swastikas.
|197616|Certain custom biome settings cause game to spam "<code>Received invalid biome id: -1</code>" in the console, causing major lag or freeze.
|197805|Minecraft crashes every time when attempt to craft something (caused by BungeeCord or Paper).
|197883|Jigsaw Structures causing <code>DataFixer</code> spam.
|197942|Leaves change to stone near Lava Pool (Recurrence of MC-48340).
|197947|Creative mode player constantly gets extinguished while standing in constant fire in rain, making constant sound.
|198129|<code>ReplaceBlobsFeature</code> changed from 1.16.1 to 1.16.2, affecting Basalt Delta generation.
|198200|Crash when leaving out processors in a template pool: <code>java.lang.IllegalArgumentException</code>: bound must be positive.
|198414|If the angle in {{cmd|spawnpoint}} is set to &plusmn;infinity, and the player dies, it will kick the player, and upon rejoin will crash the game.
|198432|Pufferfish phases through blocks after reloading world.
|198514|Creating a superflat world with nothing but air crashes the game.
|198535|<code>time_check</code> predicate condition requires both <code>min</code> and <code>max</code> value.
|198725|Crash when clicking "Presets" after setting the superflat preset with a non-existent biome.
|198805|Floating pixel in the tailfin of a guardian/elder guardian.
|198807|Making piglins and piglin brutes angry at certain entities (like dropped items) crashes the game.
|198864|World border does not render below y0 / above y255.
|198957|End Portal Frames change to Stone near Lava Pool.
|199065|Zombies that die while on fire do not drop baked potatoes.
|199237|Back of ladder is incorrectly mirrored.
|199239|Vines appear incorrectly mirrored when viewed from behind.
|199242|Texture planes of crop models appear incorrectly mirrored from behind.
|199356|chatDelay in options.txt has a space between the colon and the value.
|199543|Parity issue: Vine sounds.
|199702|"<code>netherrack_replace_blobs</code>" of large size can cause inconsistent generation.
|199988|When accessing a UI of a structure block from {{cmd|setblock}} the texture changes from data to save.
|200001|Holding a loaded crossbow in offhand and using a mainhand item inconsistently combines animation in third person.
|200009|Crash when using a non-mushroom block in a huge mushroom feature's cap.
|200195|Boats do not try dismounting the player on land.
|200696|Clock's texture does not match the new gold color pallete.
|200906|Pufferfish hitbox incorrect when reloading world.
|201269|Constantly teleporting player to a phantom crashes the game/kicks the player.
|201316|The {{cmd|give}} command can create so many items that the game will freeze.
|201748|Chain model planes are incorrectly mirrored on the rear.
|201751|Chain section on lanterns is incorrectly mirrored from behind.
|201753|Sea pickle green top sections do not render correctly from behind.
|201840|Optional function tags sometimes don't run even when the tag exists.
|202186|Houses in Zombie Villages disappear when spawned using {{cmd|locate}}.
|202202|Servers are unable to prevent a player from dismounting a vehicle, causing a desync.
|202246|Drowned navigation causes memory leak/performance degredation.
|202249|Angering passive mobs in new nether chunks very far away from previously generated chunks, then entering a nether portal causes server to completely freeze.
|202543|Ancient debris comes after netherite block in creative inventory.
|202760|<code>area_effect_cloud</code> does not enforce a maximum radius.
|203131|Setting the weight in Template Pool to high values will lag world and can cause out of memory error.
|203300|Nether Gold Ore is not grouped with Nether Quartz Ore in creative inventory.
|203373|Shulker bullet subtitles are not capitalized correctly.
|203374|Falling blocks broken by shulkers have a strong directional bias.
|203397|Ceiling vines rotate when other vines are placed in the same block space.
|205477|Occasional desync when trying to enter/exit a boat while the server is lagging.
|205735|Baby cows can suffocate on stairs.
|205797|Zoglins attack <code>Marker</code> armor stands and Invisible armor stands.
|206560|Pufferfish react to <code>Marker</code> armor stands and Invisible armor stands.
|207125|Loaded crossbow in offhand does not show breaking block hand animation.
|207173|Entering only colons into the multiplayer "Direct Connection" menu and pressing {{Keys|Enter}} crashes the game.
|207324|Mobs and particles sometimes don't fully render behind stained or tinted glass.
|207405|Nether stars can be blown up while being inside of a bundle/shulker box.
|208082|Game stalls when any message is displayed in chat while playing with an expired session.
|208430|Minecraft crashes when loading resource pack due to "<code>tessellating block model</code>".
|208639|Chiseled Blackstone Recipe unlocks when you get polished blackstone, not polished blackstone slab.
|208745|Explorer maps & filled maps turn blank after entering the nether or end.
|209361|Game crashes upon instantly click-replacing the block underneath a bamboo sapling with another bamboo.
|209625|Baby llamas suffocate when below a solid block while standing on top of a carpet.
|209819|Server crash when pathfinding to player that is teleporting away.
|210408|{{cmd|spawnpoint}} allows players to set their spawnpoint to out-of-bounds coordinates, which crashes the game when trying to respawn.
|210791|Dropping an item on a shulker launches the item off.
|211064|Loading in a TrueTypeFont with an out-of-bounds size crashes the game.
|211513|Trident returning to owner not in the same world can cause permanent player kick.
|212123|Player lighting is inconsistent in the inventory and appears darker on the front.
|212168|{{key|Ctrl}} + Pick Block does not copy block state "{{cd|lit}}".
|212291|Client can dismount vehicles independently from the server, causing a de-sync.
|212449|Fish/(glow) squid spawned using {{code|/summon}} dry out instantly.
|212736|Some world border faces are rendered mirrored, resulting in incorrect corners.
|213062|A ruined portal generated in an end portal.
|214568|Setting a lectern on fire causes z-fighting.
|214589|End gateway exit portals can be set to high coordinates, kicking the player.
|214629|FOV decreases when underwater regardless of FOV Effects accessibility setting.
|214693|Tripwire texture is not mirrored correctly from behind.
|214694|Tripwire which is part of a tripwire hook is not mirrored correctly from behind.
|214879|Selecting nothing and pressing {{key|Ctrl+C}} clears clipboard.
|215534|Spectating a mob with a shader whilst having a carved pumpkin equipped turns the screen completely white.
|216227|Sugar cane item texture is no longer accurate from 13w36a forward.
|216510|The world border red effect, affects the brightness of a mob's shader.
|218023|Netherite blocks are not grouped with iron and gold blocks in the Creative inventory.
|218112|<code>SynchedEntityData</code> is using locks incorrectly.
|218888|{{key|Shift}} Clicking items into inventory prevents the relevant advancement from triggering.
|218972|The glowing effect outline omits parts of entities if the entity is invisible.
|220335|Beacon beam is not affected by water fog.
|220694|Name color for knowledge book is incorrect.
|220698|The <code>ExplosionPower</code> of ghast fireballs is uncapped, causing a freeze / crash.
|222189|Piston lag escalates massively with the total tile entity count.
|223227|Floating water caves in caves under the ocean.
|223322|Chorus flowers can be broken with projectiles in spawn protection.
|223552|Credits not alphabetically ordered.
|223558|<code>minecraft.used:minecraft.glass_bottle</code> doesn't increase when taking water from a cauldron using a glass bottle.
|223563|<code>minecraft.used:minecraft.glass_bottle</code> doesn't increase when collecting honey from a beehive or bee nest.
|223602|Glowing translucent entities often don't merge their outlines with other glowing entities.
|223638|<code>minecraft.used:minecraft.shears</code> doesn't increase when carving a pumpkin.
|223639|<code>minecraft.used:minecraft.shears</code> doesn't increase when collecting honeycombs from a beehive or bee nest.
|223755|<code>minecraft.used:minecraft.water_bucket</code> doesn't increase when filling a cauldron with a water bucket.
|224778|Game crashes when there is a block with no <code>facing</code> block state in <code>#wall_corals</code> and a warm ocean tries to generate.
|225077|Vines can spread upward to non-full blocks.
|225815|A spawner has been replaced from a block of Stone.
|;private
|136551|Servers able to bypass EULA blacklist.<ref>{{cite|url=https://web.archive.org/web/0/https://www.minecraft.net/en-us/article/minecraft-snapshot-21w13a|title=Minecraft Snapshot 21w13a|author=Adrian Östergård|website=minecraft.net|date=Mar 31, 2021}}</ref>
|213869|Exploit related to experience.
|224580|Duplication exploit with dolphins.
|225360|Cannot resolve SRV records: unknown host.
}}
'''Other'''
* Improved desync issues when exiting a boat over a high latency connection.<ref name="article_1.17-rc1">{{Mcnet|minecraft-1-17-release-candidate-1|Minecraft 1.17 Release Candidate 1|June 4, 2021}}</ref>
* Fixed crashes.<ref name="article_1.17-rc1"/>
* 2 private issues were fixed.<ref>https://www.reddit.com/r/Minecraft/comments/nub794/a_new_challenger_arrives_minecraft_117_release/h0wlnsc?utm_source=share&utm_medium=web2x&context=3</ref></onlyinclude>

== Videos ==
{{slicedlime|4yieNs8mwIs|6DdPEPrcGtY|WnHyOVVdlDg|JWF1WH0qpFU|WBP7J_ZgzyQ}}

== Trivia ==
* This update hosts the largest addition of new blocks into the ''Java Edition'', adding a total of 103 (not counting light blocks by its sixteen different block states). This surpasses [[Minecraft:Java Edition 1.16|1.16]], which added 74 different block variants.
* Out of all first-of-the-week snapshots for 1.17, no snapshot was delayed (or released early).
* 1.17 features the fewest subsequent minor revisions of any major update since [[Minecraft:Java Edition 1.1|1.1]], having only one minor update (1.17.1) released.

== Notes ==
{{notelist}}

== References ==
{{reflist}}

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

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