Minecraft:Java Edition 1.17

1.17, the first release of Minecraft:Caves & Cliffs, is a major update to Template:JE announced at Minecraft:Minecraft Live 2020<ref name="Recap">Template:Mcnet</ref> and released on June 8, 2021.<ref name="Announced"> This update adds Minecraft:amethyst geodes 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>Template:Mcnet</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 1.18.<ref>Template:Cite</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

Blocks

Template:Animate 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 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 Minecraft:Azalea

• Has variants with either no blossoms or pink blossoms.
• Bush-like blocks that can be planted on Minecraft:dirt and Minecraft:grass blocks.
• 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:flowers by the game (for example, Minecraft:bees can pollinate them).

File:Azalea Leaves.png 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:flowers by the game (for example, Minecraft:bees can pollinate them).

File:Block of Amethyst JE3 BE1.png 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.

Template:Animate 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 Template:Control, or applied with a Minecraft:dispenser to wax them.
  • Yellow particles are formed when waxing the block.
• Minecraft:Axes can be Template:Control 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.

Template:Animate Block of raw metal

• Minecraft:Raw copper, Minecraft:raw gold, and Minecraft:raw iron can be crafted into the respective block of raw metal.

File:Budding Amethyst JE3 BE1.png 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 Minecraft:Calcite

• An off-white stone that generates in amethyst geodes, between Minecraft:smooth basalt and amethyst.

Template:Animate 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 pickles, 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.

Template:Animate 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 Template:Ctrl with the vine.
• Grow from glow berries when placed on the underside of a block.

File:Cobbled Deepslate.png 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.

Template:Animate 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.

Template:Animate 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.

Template:Animate 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.

Template:Animate 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.

File:Deepslate.png 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 Minecraft:Cobbled deepslate slab
• File:Cobbled Deepslate Stairs JE3.png Minecraft:Cobbled deepslate stairs
• File:Cobbled Deepslate Wall (ewU) JE3.png Minecraft:Cobbled deepslate wall
• File:Polished Deepslate JE2 BE1.png Minecraft:Polished deepslate
• File:Polished Deepslate Slab JE2.png Minecraft:Polished deepslate slab
• File:Polished Deepslate Stairs JE2.png Minecraft:Polished deepslate stairs
• File:Polished Deepslate Wall (ewU) JE2.png Minecraft:Polished deepslate wall
• File:Deepslate Bricks JE2 BE1.png Minecraft:Deepslate bricks
• File:Cracked Deepslate Bricks JE1 BE1.png Minecraft:Cracked deepslate bricks
• File:Deepslate Brick Slab JE2.png Minecraft:Deepslate brick slab
• File:Deepslate Brick Stairs JE2.png Minecraft:Deepslate brick stairs
• File:Deepslate Brick Wall (ewU) JE2.png Minecraft:Deepslate brick wall
• File:Deepslate Tiles JE2 BE1.png Minecraft:Deepslate tiles
• File:Cracked Deepslate Tiles JE1 BE1.png Minecraft:Cracked deepslate tiles
• File:Deepslate Tile Slab JE2.png Minecraft:Deepslate tile slab
• File:Deepslate Tile Stairs JE2.png Minecraft:Deepslate tile stairs
• File:Deepslate Tile Wall (ewU) JE2.png Minecraft:Deepslate tile wall
• File:Chiseled Deepslate JE2 BE1.png Minecraft:Chiseled deepslate

Template:Animate Deepslate Minecraft:ores

• 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.

Template:Animate 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 blocks, 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 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 clusters can also be found rarely in regular caves.
• Can be crafted from 4 Minecraft:pointed dripstone.

File:Glow Item Frame JE1 BE3.png 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:maps.

File:Glow Lichen (D) JE2.png 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 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 Minecraft:Infested deepslate

• An infested variant of deepslate.
• Spawns a Minecraft:silverfish when mined.

Template:Animate Minecraft:Light block

• A new Minecraft:waterloggable source of light, originally from Template:BE.
• Only available with commands such as Template:Cmd.
• Behaves like air and it is visible only when the item is held, similar to Minecraft:barriers.
  • 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 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.

File:Moss Block JE1 BE1.png 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:Hoes are the appropriate tool to collect it.
• Minecraft:Small dripleaf can be planted on it.

File:Moss Carpet.png 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.

Template:Animate 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:tridents 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 Template:Hp of damage, and falling from 3 blocks deals Template:Hp 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 Template:Hp of damage, and one falling from 3 blocks deal Template:Hp of damage.
  • They drip Minecraft:water or Minecraft:lava into Minecraft:cauldrons 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.

Template:Animate Minecraft:Potted azalea

• Obtained by planting an Minecraft:azalea into a pot.

File:Powder Snow JE1 BE1.png 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.
  • Minecraft:Players 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:horses 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:strays, Minecraft:polar bears, Minecraft:snow golems, and Minecraft:withers) 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. Template:ItemSprite
• Entities on fire melt powder snow when colliding.

File:Rooted Dirt JE1 BE1.png 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.
• Template:Control 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.

Template:Animate Minecraft:Sculk sensor

• A redstone component that detects vibrations.
• Currently, it does not generate naturally, available only from commands such as Template:Cmd, 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 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 Minecraft:Smooth basalt

• A Minecraft:basalt variant that composes the outer layer of amethyst geodes.
• Can be obtained by smelting basalt.

Template:Animate 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 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.

File:Tuff.png Minecraft:Tuff

• A deep grayish stone that generates in blobs between levels 0 and 16.

Items

File:Amethyst Shard JE2 BE1.png 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 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:axolotls, also similarly to fish.

Template:Animate Minecraft:Bundle

• Available only from commands such as Template:Cmd.
• Used to store other items (except Minecraft:shulker boxes) 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 pearls, 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 Template:Ctrl 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:items 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.

File:Copper Ingot JE2 BE1.png 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 Minecraft:Glow berries

• Can be eaten, restoring Template:Hunger.
• Grow on cave vines.
  • Once harvested the vines lose their glow berry texture.

File:Glow Ink Sac JE1 BE1.png 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:signs.

File:Powder Snow Bucket JE1 BE1.png 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:cauldrons with powder snow.

File:Raw Copper JE3 BE2.png 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 ingots.

File:Raw Gold JE3 BE2.png 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 ingots.
• Minecraft:Piglins attempt to pick up raw gold.

File:Raw Iron JE3 BE2.png 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 ingots.

Minecraft:Spawn eggs

• File:Axolotl Spawn Egg JE1 BE1.png Minecraft:Axolotl spawn egg.
• File:Goat Spawn Egg JE1 BE2.png Minecraft:Goat spawn egg.
• File:Glow Squid Spawn Egg JE1 BE1.png Minecraft:Glow squid spawn egg.

File:Spyglass (item) JE3 BE1.png 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 Template:Key.
• There is a unique animation for using the spyglass, which is visible in a third-person perspective or by another player.

Mobs

Template:Animate Minecraft:Axolotl

• Has Template:Hp 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 Template:Frac 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:guardians, Minecraft:elder guardians, Minecraft:squids, Minecraft:glow squids, and Minecraft:fish, dealing Template:Hp 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 Minecraft:Glow squid

• Has Template:Hp health.
• Originates from the mob of the same name Template:In.
• 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:axolotls 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:vexes, Minecraft:blazes, eyes of Minecraft:spiders, Minecraft:drowned and Minecraft:endermen do.
• Stops glowing for a short time and swims away quickly after taking damage.

File:Goat JE1 BE1.png Minecraft:Goat

• Has Template:Hp health.
• Spawns in mountain biomes.
  • Currently a place holder until the new mountains are added.
• Goats can ram other mobs and Minecraft:armor stands to knock them a few blocks.
  • Mobs rammed by goats don't retaliate.
• Can jump higher than other Minecraft:mobs 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 Template:Nbt compound field that can contain any data.

World generation

Template:Animate 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 portals in the 1.16 snapshots.

File:Azalea Tree.png 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 logs and Minecraft:rooted dirt.

Biomes

File:BiomeSprite dripstone-caves.png Minecraft:Dripstone caves

File:Dripstone Caves.png

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 blocks.
• Minecraft:Dripstone clusters are abundant here, often forming pillars.

File:BiomeSprite lush-caves.png Minecraft:Lush caves

File:Lush Caves.png

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 blocks, Minecraft:moss carpets, Minecraft:spore blossoms, Minecraft:glow berry vines, big and Minecraft:small dripleaf.
• Moss covers the ceilings and floors.
• Minecraft:Axolotls can spawn here.
• Clay pools generate inside.

Command format

Template:Cmd

• 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.

Template:Cmd

• Modifies the Minecraft:inventory of a Minecraft:block or Minecraft:entity.
  • This command has three forms:
    • Template:Cd – same as old Template:Cd
    • Template:Cd – modifies item (without copying).
    • Template:Cd – copies item for source to target(s), optionally applying modifier
  • Possible sources and targets: Template:Cd or Template:Cd
  • For example, Template:Cd copies the first item from player's enderchest to the first slot of the container player is currently standing on.
  • Replaced Template:Cmd.

Template:Cmd

• 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 modifiers

• Reuse functions syntax of a Minecraft:loot table to describe item modification in Template:Cmd command.
• The function part of loot tables can now be defined as separate Minecraft:data pack resource in Template:Cd directory.
  • Such files can contain a single function (i.e single Minecraft:JSON object) or an array of functions.

Minecraft:Game rules

• freezeDamage
  • Whether entities take damage from freezing inside of Minecraft:powder snow.
• playersSleepingPercentage
  • 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:Advancements

• Added 11 new advancements:

• Adds new advancement triggers.
  • started_riding
    • Triggered when player starts riding a vehicle or entity starts riding vehicle currently ridden by player.
  • lightning_strike
    • Triggers for any player on the server when lightning finishes (i.e. entity disappears).
  • using_item
    • 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 tables

• New condition: Template:Cd
  • Checks range of value.
  • Parameters:
    • Template:Cd – see "New value providers" section (currently combination of random generators and score)
    • Template:Cd – min/max range
• New functions:
  • Template:Cd
    • Modifies enchantments on item.
    • Parameters:
      • Template:Cd – map of enchantment id to level value (can be score or random number)
      • Template:Cd – if Template:Cd, change is relative to current level. If Template:Cd, level is replaced with current value (default behavior)
  • Template:Cd
    • Sets tags needed for banner patterns. Parameters:
      • Template:Cd - list of pattern objects:
        • Template:Cd - name of pattern (square_bottom_left, bricks, etc.)
        • Template:Cd - name of color (light_gray, etc.)
      • Template:Cd - if true, new elements are appended to existing ones instead of replacing
• New value providers: Template:Cd
  • Returns scaled scoreboard value.
  • Parameters:
    • Template:Cd – scoreboard name
    • Template:Cd – same as Template:Cd in Template:Cd predicate
    • Template:Cd – scaling factor (float)

General

File:Monochrome Mojang Studios Logo.png

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 Template:Key shortcut to generate and persist performance metrics from in-game, similar to Template:Cmd.
  • Metrics are saved in Minecraft:.minecraft/debug/profiling/<timestamp>.zip.
  • 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 packs

• Added Template:Nbt, Template:Nbt and Template:Nbt to worldgen/noise_settings/*.json.

Minecraft:Language

• Added Russian (Pre-revolutionary) language.
• Added Chinese Traditional (Hong Kong) language.

Minecraft:NBT

• Added Template:Cd 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: Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd and Template:Cd.

Minecraft:Predicate

• Added lightning_bolt sub-predicate.

Minecraft:server.properties arguments

• resource-pack-prompt
  • Adds a custom message to be shown on resource pack prompt when require-resource-pack 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 Template:Code 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:Splashes

• Added the following splash text:
  • "[this splash text has been delayed until part 2]"
  • "Contains simulated goats!"
  • "Home-made!"
  • "There's <<a cat on ,my keyboard!~"Template: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:Tags

• Added the Template:Cd entity type tag.
  • Contains drowned, guardian and elder guardian.
  • Axolotls are always hostile towards entities in this tag.
• Added the Template:Cd 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 Template:Cd item tag.
  • Contains the Minecraft:bucket of tropical fish.
  • Items in this tag can be used to tempt axolotls.
• Added the Template:Cd 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 Template:Cd block states set to false.
• Added the Template:Cd 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 Template:Cd 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 Template:Cd block tag.
  • Contains cauldrons, water cauldrons, lava cauldrons, and powder snow cauldrons.
  • This tag is used in certain pathfinding processes.
• Added the Template:Cd block tag.
  • Contains the cave vines body block and cave vines head block.
• Added the Template:Cd item tag.
  • Contains all pickaxes.
• Added the Template:Cd block and item tags.
  • Contain the normal and deepslate variants of each ore type.
• Added the Template:Cd 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 Template:Cd block tag.
  • Contains deepslate and tuff.
• Added the Template:Cd block tag.
  • Contains Minecraft:dirt, Minecraft:coarse dirt, Minecraft:podzol, Minecraft:rooted dirt, Minecraft:grass blocks, Minecraft:mycelium, and Minecraft:moss blocks.
  • 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 Template:Cd block tag.
  • Contains the Template:Cd block tag and dirt.
  • Used in dripstone generation to determine what dripstone can replace and what pointed dripstone can generate on.
• Added the Template:Cd block tag.
  • Contains Minecraft:bedrock, Minecraft:monster spawner, Minecraft:chest, and Minecraft:end portal frame.
• Added the Template:Cd item tag.
  • Contains sweet berries and glow berries.
• Added the Template:Cd entity type tag.
  • Contains Minecraft:striders, Minecraft:blazes, and Minecraft:magma cubes.
  • Entities in this tag take 5 times more damage from the freezing effect.
• Added the Template:Cd entity type tag.
  • Contains Minecraft:strays, Minecraft:polar bears, Minecraft:snow golems, and Minecraft:withers.
  • Entities in this tag cannot be frozen.
• Added the Template:Cd 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 Template:Cd tag type.
• Added the Template:Cd block tag.
  • Includes Minecraft:bedrock, Minecraft:water, Minecraft:lava, Minecraft:ice, Minecraft:packed ice, and Minecraft:blue ice.
• Added the Template:Cd 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 Template:Cd 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 Template:Cd block tag.
  • Contains snow and powder snow.
  • Blocks in this tag create snow stepping noises while the player walks in them.
• Added the Template:Cd block tag.
  • Includes the #features_cannot_replace block tag and the #leaves block tag.
• Added the Template:Cd block tag.
  • Contains the #moss_replaceable block tag, clay, gravel and sand.
• Added Template:Cd, Template:Cd, Template:Cd, and Template:Cd block tags.
  • Blocks with these tags can be destroyed more quickly with the matching tool.
• Added the Template:Cd block tag.
  • Contains the #base_stone_overworld block tag, the #cave_vines block tag, and the #dirt block tag.
• Added Template:Cd, Template:Cd, and Template:Cd block tags.
  • If a block requires the correct tool to drop, these tags determine which tier of that tool is required.
• Added the Template:Cd block and item tag.
  • Contains the Template:Cd block and item tag.
  • Blocks in this tag prevent Minecraft:sculk sensors 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 Template:Cd 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 Template:Cd entity tag.
  • Contains foxes, rabbits, endermites, and silverfish.
  • Entities in this tag can walk on top of powder snow.
• Added the Template:Cd block tag.
  • Contains Minecraft:clay and Minecraft:moss blocks.
  • Minecraft:Small dripleaf can be placed on blocks in this tag.
• Added the Template:Cd block tag.
  • Contains Minecraft:snow, Minecraft:snow blocks and Minecraft:powder snow.
  • Blocks in this tag turn blocks with a snowy variant below them (like grass) into said snow variant.
• Added the Template:Cd block tag.
  • Contains stone, granite, diorite, and andesite.
• Added the Template:Cd 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:Anvils

• The maximum length a name of an item can have after being renamed has been increased from 35 characters to 50 characters.

Minecraft:Banners

• 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>Template:Bug</ref>
• Removed some stray pixels from the GUI texture.

Minecraft:Cakes

• Have a variation called "Cake with Candle".
  • Can be created by Template:Control 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:Cauldrons

• 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 Template:Ctrl 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.

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>Template:Bug</ref>

Minecraft:Grass path

• Renamed to "Dirt Path", as per Template:BE.
  • The block ID has also been changed to Template:Cd.
• Can now be made with dirt, coarse dirt, rooted dirt, mycelium, and podzol by using a shovel.

Minecraft:Infested blocks

• Instead of breaking instantly, infested blocks now take half of the time to break compared to their regular counterparts.
• Pickaxes are the assigned tool for breaking them.

Lapis Lazuli Block

• Renamed to "Block of Lapis Lazuli".

Minecraft:Lectern

• Slightly shrunk top part to prevent z-fighting with Minecraft:fire.<ref>Template:Bug</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:Ores

• Texture changes (all Minecraft:Overworld ores except diamond) had the shape of the "ore pattern" in the stone changed to make them visually distinct for colorblind players:

Name	Old texture	New texture	Deepslate texture
Minecraft:Coal ore	File:Coal Ore JE2 BE2.png	File:Coal Ore JE5.png	File:Deepslate Coal Ore JE1.png
Minecraft:Diamond ore	File:Diamond Ore JE3 BE3.png	File:Diamond Ore JE5.png	File:Deepslate Diamond Ore JE2.png
Minecraft:Emerald ore	File:Emerald Ore JE3 BE2.png	File:Emerald Ore JE4 BE3.png	File:Deepslate Emerald Ore JE1.png
Minecraft:Gold ore	File:Gold Ore JE3 BE2.png	File:Gold Ore JE7.png	File:Deepslate Gold Ore JE2.png
Minecraft:Iron ore	File:Iron Ore JE3.png	File:Iron Ore JE6.png	File:Deepslate Iron Ore JE2.png
Minecraft:Lapis lazuli ore	File:Lapis Lazuli Ore JE2 BE2.png	File:Lapis Lazuli Ore JE4.png	File:Deepslate Lapis Lazuli Ore JE3.png
Minecraft:Redstone ore	File:Redstone Ore JE2 BE2.png	File:Redstone Ore JE4.png	File:Deepslate Redstone Ore JE2.png

• Minecraft:Emerald ore can now replace Minecraft:granite, Minecraft:andesite, Minecraft:diorite, Minecraft:tuff, and Minecraft:deepslate upon generating.

Minecraft:Pistons

• Minecraft:Particles now appear if a block is broken by a piston or sticky piston.
  • Sounds, however, do not play.<ref>Template:Bug</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 swastika to be displayed.<ref>Template:Bug</ref>

Minecraft:Rails

• Are now able to be Minecraft:waterlogged.
• No longer broken by flowing Minecraft:water and Minecraft:lava.

Minecraft:Signs

• 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 lit Minecraft:block state had been added to indicate whether the sign text is lit up.
  • Regular Minecraft:ink sacs 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 Template:Key key.
• All invisible blocks are now displayed as small cubes by save mode Minecraft:structure blocks; previously barriers and light blocks would not display at all.<ref>Template:Bug</ref><ref>Template:Bug</ref>
  • Variants of air still all appear identical and are not distinguished.<ref>Template:Bug</ref>

	Minecraft:Air, Minecraft:cave air and Minecraft:void air	Minecraft:Structure void	Minecraft:Barrier	Minecraft:Light block
Before	File:Air (shown) JE2.png	File:Structure Void (shown) JE2.png	File:Blank.png	File:Blank.png
After	File:Air (shown) JE2.png	File:Structure Void (shown) JE3.png	File:Barrier (shown) JE1.png	File:Light (shown) JE1.png

Items

Minecraft:Bone meal

• Added sounds for using bone meal.

Minecraft:Clock

• The texture has been changed from File:Clock JE2 BE2.gif to File:Clock JE3.gif

Minecraft:Compass and Minecraft:lodestone compass

• The texture has been changed from File:Compass JE2 BE1.gif to File:Compass JE3.gif

Minecraft:Firework rockets

• Simple firework rockets with one gunpowder can now be crafted using the recipe book.

Minecraft:Jungle doors

• Changed the texture of the jungle door item to reflect the block texture in the Texture Update.<ref>Template:Bug</ref>

Pufferfish

• The strength of the Minecraft:Poison effect has been decreased from IV to II.<ref>Template:Bug</ref>

Minecraft:Shulker boxes

• Now drop their items when destroyed as entities.

Minecraft:Spawn eggs

• The spawn egg dispenser behavior now catches any exceptions that could be thrown when spawning the entity.

Minecraft:Spectral arrows

• Fired spectral arrows are now entirely golden to reflect the item texture in the Texture Update.<ref>Template:Bug</ref>

Minecraft:Sugar cane

• Changed the texture of the sugar cane item to better reflect biome tinting added in 1.7.2.<ref>Template:Bug</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:Cats

• 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:Endermites

• Endermen are now aggressive toward non-pearl-spawned endermites.

Minecraft:Foxes

• 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 potatoes instead of normal Minecraft:potatoes if on fire when killed or killed by a fire source.

Minecraft:Llama

• No longer spit at players in Minecraft:Peaceful mode.

Minecraft:Polar bears

• 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:Shulkers

• 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:strays when they are inside Minecraft:powder snow after Template:Convert.

Minecraft:Slime

• The maximum size that slimes can be summoned with is now 128.

Minecraft:Squid

• Now Minecraft:leads work with them.

Minecraft:Villagers and Minecraft:zombie villagers

• Moved the librarian top overlay texture to correct side of torso.<ref>Template:Bug</ref>
• Mason villagers can now sell 4 Minecraft:dripstone blocks for an Minecraft:emerald.
• Can now accept a filled Minecraft:cauldron as a valid workstation.

Minecraft:Wandering traders

• Added the following trades:
  • Sells 2 Minecraft:small dripleafs for an emerald.
  • Sells 2 Minecraft:pointed dripstones for an emerald.
  • Sells 2 Minecraft:rooted dirt for an emerald.
  • Sells 2 Minecraft:moss blocks for an emerald.

Non-mob entities

Minecraft:Experience orbs

• 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:Minecarts

• Can now move in water, but move considerably slower than they do on land.

Minecraft:Paintings

• Changed the back texture to reflect the texture of the planks in the Texture Update.

World generation

Minecraft:Biomes

• Biome-specific sky colors now blend more smoothly.

A 1.17 Mineshaft with ceiling supports and oak log supports from the ground

A 1.17 mineshaft

Minecraft:Mineshafts

• Mineshaft pieces no longer generate if they were fully floating in the air.
• Corridors now generate with wooden Minecraft:logs 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:Strongholds

• No longer generate exposed in oceans; they are covered by the seabed.

Minecraft:Shipwrecks

• Minecraft:Moss blocks can be found in chests.

Command format

Template:Cmd

• Removes debug report command.
• Replaced by F3+L and Template:Cmd.

Template:Cmd

• The give command can give only up to 100 stacks of items at a time (e.g. 6400 stone or 100 iron swords)

Template:Cmd

• New syntax:
  • Template:Cmd
    • Same as old version of Template:Cmd.
  • Template:Cmd
    • Copies item for source to target(s), optionally applying modifier.
  • Template:Cmd
    • Modifies item (without copying).

Template:Cmd

• Removed Template:Cmd command.
• Replaced with Template:Cmd.

Template:Cmd

• 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:Advancements

• Added source condition to effects_changed 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.

Template:EffectLink

• Glowing is now based on the outline of all layers on an entity, not just the base layer.

Minecraft:Loot tables

• Loot tables can now access Minecraft:scoreboard values by Minecraft:UUID.
• Loot table values inside random number generators can now be nested.
• Changed condition: Template:Cd
  • Template:Cd parameter has now been replaced with Template:Cd. It can either contain value from old Template:Cd field (like Template:Cd) or be a score holder name in form {"name": "..."}.
• Changed function: Template:Cd
  • This function now has Template:Cd parameter. If Template:Cd, change is relative to current damage. If Template:Cd, damage is replaced with current value (default behavior)
• Changed function: Template:Cd
  • This function now has Template:Cd parameter. If Template:Cd, change is relative to current item count. If Template:Cd, item count is replaced with current value (default behavior)
• Changed function: Template:Cd
  • Template:Cd parameter can now be set to {"storage": <namespaced id>}, 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:cauldrons under the sky now slowly fills with Minecraft:powder snow.

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:Subtitles

• Changed Shulker bullet explodes to Shulker Bullet explodes.
• Changed Shulker bullet breaks to Shulker Bullet breaks.
• 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:modders.
• Updated required Java version to Java 16.<ref>Template:Mcnet</ref>

Minecraft:Creative inventory

• The redstone tab has been reordered to prioritize highly-used blocks.
• Minecraft:Slime blocks and Minecraft:honey blocks 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>Template:Bug</ref>
• Changed the format from Template:Cd to Template:Cd.
• Now scroll faster when holding Template:Key.
  • They scroll even faster when holding Template:Key and one or both of the Template:Key keys together.

Minecraft:Custom dimensions

• Added Template:Code and Template:Code variables to dimension types, allowing for the height limit to be increased in custom worlds settings.

Data and Minecraft:resource packs Template:Resource pack format/value

• Data pack version is also changed to 7.

Dedicated Minecraft:servers

• A dedicated server can enforce custom resource packs by setting Template:Cd in Template:Cd. 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 Template:Cd 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:Languages

• Removed the Gothic, Kabyle, Maori, Mohawk, Nuk, Ojibwe, and Talossan languages as their translations were incomplete.

Minecraft:Materials

• Removed the coral material.
• Added the moss material.

Minecraft:Options screen

• Buttons tied to a set of values can now be scrolled through.
• Clicking Template:Key on a menu button changes it to the previous value.
• The Minecraft:debug mode can now be accessed only by holding Template:Key instead of Template:Key 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 passenger, stepping_on and lightning_bolt properties to entity_properties predicate
• Added looking_at (entity currently viewed by player) condition to player sub-predicate.
• Expanded item field on item predicate to items.
  • Now accepts an array of item types.
• Expanded block field on block predicate to blocks.
  • 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 packs

• Improved performance when using many overrides on an item model.
• toasts.png 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:Servers

• Removed the Template:Cd 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:Skins

• Legacy skin handling now has improved skin validation.

Minecraft:Splashes

• 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 play_time.
• Included time when game paused for "Time with World Open" (total_world_time).

Minecraft:Tags

• Added azalea leaves and azalea leaves flowers to the Template:Cd block and item tags.
• Added azaleas and flowering azaleas to the Template:Cd block and item tags.
• Added flowering azalea leaves and flowering azaleas to the Template:Cd block and item tags.
• Added potted azalea bushes and potted flowering azaleas bushes to the Template:Cd block tag.
• Added deepslate and tuff to the Template:Cd block tag and deepslate to the Template:Cd item tags.
• Added deepslate gold ore to the Template:Cd block and item tags.
• Added all copper slab and stair variants, as well as various deepslate variants to the Template:Cd block and item tags.
• Added cave vines and cave vines plant to the Template:Cd block tag.
• Added tinted glass to the Template:Cd block tag.
• Added raw gold and raw gold blocks to the Template:Cd item tag.
• Added raw gold blocks to the Template:Cd block tag.
• Added cave vines and cave vines plant to the Template:Cd block tag.
• Changed the Template:Cd block tags to use the Template:Cd 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

Template:Fixes Other

• Improved desync issues when exiting a boat over a high latency connection.<ref name="article_1.17-rc1">Template:Mcnet</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>

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 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 1.1, having only one minor update (1.17.1) released.