1.20, the first release of Trails & Tales, is a major update to Java Edition released on June 7, 2023, exactly one year after the previous major update, 1.19. Originally announced at Minecraft Live 2022 on October 15, 2022, the name of the update was revealed at Minecraft Monthly on March 2, 2023.

Additions

Blocks

Bamboo Mosaic

• A plank variant exclusive to the bamboo wood set.
• Crafted by arranging 2 bamboo slabs in a vertical strip.
• Can be used to craft respective stairs and slabs variant.

Bamboo Planks

• Crafted using 1 block of bamboo (stripped or unstripped) to craft 2 bamboo planks.
• Can be used to craft respective buttons, doors, fences, fence gates, pressure plates, signs, slabs, stairs, and trapdoors.
• Can be used to craft bamboo rafts and bamboo raft with chests.
• Can be used to craft wooden blocks or items, (eg. chest).

Block of Bamboo

• New log-like block.
• Block of bamboo can be crafted from 9 bamboo and can be stripped like other wood logs.
• Bamboo planks crafted from block of bamboo yield only 2 planks compared to 4 for wood logs.

Calibrated Sculk Sensor

• A new variant of sculk sensor which allows players to filter vibrations based on their frequency level.
• Does not spawn naturally.
• Can only be crafted with 1 sculk sensor and 3 amethyst shards in the crafting table.
• One side of the calibrated sculk sensor can receive a redstone signal as an input.
  • The strength of that redstone signal is the only vibration frequency the sculk sensor will listen to.
• Detects vibrations up to 16 blocks radius, instead of 8 blocks.
• Lasts 10 game ticks when in Active phase, instead of 30.

Cherry Leaves

• A new type of leaves, generated in cherry trees.
• Emits pink (
   #D193B4) cherry_leaves particles falling underneath.

Cherry Log

• A new type of log, generated as a part of cherry trees.
• Can be crafted into cherry planks and wood.
• Has a stripped variant as well , wood and stripped wood.
  • The stripped variant can be used to craft cherry hanging sign.

Cherry Planks

• Crafted from cherry logs.
• Can be used to craft respective buttons, doors, fences, fence gates, pressure plates, signs, slabs, stairs, and trapdoors.
• Can be used to craft cherry boats and cherry boat with chests.
• Can be used to craft wooden blocks or items (chest for example).

Cherry Sapling

• A new type of sapling which grows into a cherry tree when planted.
• Drops underneath cherry leaves.
• Can break off a fully grown one and plant it to grow a cherry tree.
• Can be placed in flower pots.

Chiseled Bookshelf

• Can be crafted with 6 planks and 3 wooden slabs.
• Can store up to six books, enchanted books, written books, books and quills or knowledge books.
  • Books in chiseled bookshelves can be added or removed from any slot by targeting the specific slot.
  • Books are directly added and removed, so there is no interface.
• Can be used with a redstone comparators (giving a signal strength matching that of the slot that was last interacted with).
• Can be used with a hopper and dropper.
• Do not increase the power of enchanting tables.
• Require a Silk Touch axe to mine.

Decorated Pot

• Can be crafted with any of the 20 pottery sherds or brick items, in a rhombic crafting configuration.
  • The type of crafting material decides which picture will display on its respective side of the decorated pot (e.g. an "arms up" pottery sherd in the top slot will display on the back).
    • The brick item will not have a picture, and will instead be blank.
  • The materials used in crafting will be displayed on the tooltip.
• Very fragile and easy to break.
  • Will break apart into its crafting materials when broken using any block-breaking tool.
  • Will drop itself when broken using an empty hand or a block-breaking tool with Silk Touch, or when moved by pistons.
• Has a property named cracked.
  • Is used to determine the sounds the block will use upon breaking.

Hanging Sign

• A more expensive version of normal signs, which can be crafted with 2 chains and 6 stripped logs, yielding 6 of them.
• Has a total of 11 variants: oak, spruce, birch, jungle, acacia, dark oak, mangrove, crimson, warped, bamboo, and cherry.
• Can be hung up in the following ways:
  • Underneath a block that provides support in the center, like a fence or an iron bar.
    • When the hanging sign is placed underneath a non-full block, or when placed while sneaking, the chains will take on an upside-down v-shape. Signs in this configuration can be placed in 16 different angles, similar to an armor stand.
  • Underneath a full block.
    • When the hanging sign is placed underneath a full block, the chains will be on parallel sides of the sign. Signs in this configuration can be placed in the 4 cardinal directions, North, South, East, and West.
  • Attached to the solid side of a block.
    • When attached to the side of a block, its chains will be parallel, hanging onto a horizontal bar sticking out from the side of said block. Hanging signs in this configuration will display text perpendicular to the side of the block they were attached to.
  • Attached to the side or underneath another hanging sign.
    • This will display the same way as being placed underneath a non-full block.
• Cannot be placed directly on the ground without support from the side or above.
  • However, hanging signs that have a horizontal bar will not break when the supporting block is removed.
• If it is hanging underneath a block and that block is broken, the hanging sign will also break immediately.
• Unlike regular signs, the space available for text is much smaller.
• Text can be dyed with any color of dye and tinted with glow ink sacs to make text glow.

Piglin Head

• Piglins will now drop their heads when killed by a charged creeper.
• The piglin head will flap its ears when powered by redstone, or when worn by a player while walking, similar to the ender dragon head.

Pink Petals

• A new type of surface block, which generates naturally in cherry groves.
• Renewable when applying a bone meal to an existing set of pink petals or to the ground of cherry groves.
• Similar to sea pickle, pink petals can be placed up to 4 in one dirt-related block.
• Can be placed directionally.
• Can be crafted into pink dye.

Pitcher Plant

• A type of plant which grows from the pitcher pod after 4 stages (5 stages in total).
• If grown fully, it will only drop itself when broken, otherwise it drops the pod.
• Can be crafted into two cyan dye.
• Cannot be placed in a flower pot.
• Can be destroyed by ravagers.

Sniffer Egg

• Can be found in the suspicious sand loot table found at warm ocean ruins.
• Dropped when two sniffers breed.
• Hatches into a baby snifflet.
  • When placed on a moss block, it will hatch after approximately 10 minutes.
  • On all other blocks, it will hatch in approximately 20 minutes.

Suspicious Gravel

• Looks similar to gravel, with a rougher texture.
• Affected by gravity, although it vanishes when landing.
• Generates naturally in cold ocean ruins and trail ruins, with different archaeological loot tables.
• Has shovel as an assigned tool.
  • Drops nothing when mined or moved, even if mining with Silk Touch.
• Brushing the suspicious gravel with a brush will extract objects.
  • Has 4 stages of extraction (displayed through the texture), and will "recover" gradually when brushing is stopped.
  • Turns to regular gravel once extraction is done.
  • Only naturally generated suspicious gravel will drop an object; If placed it will not drop anything.
• Can have bamboo planted on it.

Suspicious Sand

• Looks similar to sand, with a rougher texture.
• Affected by gravity, although it vanishes when landing.
• Generates naturally in warm ocean ruins, desert temples and desert wells, with different archaeological loot tables.
• Has shovel as an assigned tool.
  • Drops nothing when mined or moved, even if mining with Silk Touch.
• Brushing the suspicious sand with a brush will extract objects.
  • Has 4 stages of extraction (displayed through the texture), and will "recover" gradually when brushing is stopped.
  • Turns to regular sand once extraction is done.
  • Only naturally generated suspicious sand will drop an object; If placed it will not drop anything.
• Can have cactus and sugar cane planted on it.

Torchflower

• A new type of flower, which grows from torchflower seeds after 2 stages (3 stages in total).
• Doesn't emit light, despite the name.
• If it's in its third growth stage, it will only drop itself when broken, otherwise it will drop its seed.
• Can be crafted into an orange dye.
• Can be planted in a flower pot.
• Can be used to craft suspicious stew, giving the player Night Vision.
• Can be used to tempt and breed bees.

Items

Brush

• An item which can be used in the new archaeology system.
• Can be crafted with a stick, a copper ingot and a feather in a vertical line, respectively.
• Consumes 1 durability point when extracting an item from suspicious sand or suspicious gravel successfully.
• Has no effect when brushing anything other than suspicious sand or suspicious gravel.

Music Disc

• Added a new music disc by Aaron Cherof titled "Relic".
  • Can only be obtained when brushing suspicious gravels within trail ruins, with a ¹⁄₁₂ chance of appearing as a rare loot.
  • Gives a comparator output signal strength of 14 when in a Jukebox.

Pitcher Pod

• Can be planted on farmland and grows into a pitcher plant.
• Can only be obtained if a sniffer digs up a pitcher pod.
• Drops pitcher plant when fully grown, otherwise drops itself.
• Can be picked up and planted by farmer villagers.

Pottery Sherds

• An item found by using a brush on suspicious sand or suspicious gravel.
• There are currently 20 known varieties:
  • Angler Pottery Sherd
  • Archer Pottery Sherd
  • Arms up Pottery Sherd
  • Blade Pottery Sherd
  • Brewer Pottery Sherd
  • Burn Pottery Sherd
  • Danger Pottery Sherd
  • Explorer Pottery Sherd
  • Friend Pottery Sherd
  • Heart Pottery Sherd
  • Heartbreak Pottery Sherd
  • Howl Pottery Sherd
  • Miner Pottery Sherd
  • Mourner Pottery Sherd
  • Plenty Pottery Sherd
  • Prize Pottery Sherd
  • Sheaf Pottery Sherd
  • Shelter Pottery Sherd
  • Skull Pottery Sherd
  • Snort Pottery Sherd

Smithing Templates

• New item series for trimming armor and upgrading diamond armor to netherite, with sixteen varieties of armor trims.
  • Netherite Upgrade
  • Armor trims:
    • Coast Armor Trim
    • Dune Armor Trim
    • Eye Armor Trim
    • Host Armor Trim
    • Raiser Armor Trim
    • Rib Armor Trim
    • Sentry Armor Trim
    • Shaper Armor Trim
    • Silence Armor Trim
    • Snout Armor Trim
    • Spire Armor Trim
    • Tide Armor Trim
    • Vex Armor Trim
    • Ward Armor Trim
    • Wayfinder Armor Trim
    • Wild Armor Trim
• They can be obtained randomly from chests generated in their respective structures.
  • Exceptions:
    • While randomly generated in other rooms, a netherite upgrade smithing template is also guaranteed in every treasure room in a bastion remnant.
    • 1 eye armor trim is guaranteed in every stronghold library chest.
    • A single tide armor trim is sometimes dropped by elder guardians upon death.
    • Host, raiser, shaper and wayfinder trims are found by brushing Suspicious Sand and Suspicious Gravel in Trail Ruins.
  • Some armor trims are rarer than others, with a higher or lower chance of generating depending on the set rarity.
  • The following common armor trims always generate 2 templates in a chest when found:
    • Dune
    • Coast
    • Wild
    • Sentry
• Consumed when used to upgrade an item in the smithing table.
• Cannot be crafted directly, but a copy can be made by crafting in the following pattern:
  • 7 diamonds, in a U shape.
  • 1 block of material that the template is made out of, placed in the center slot of the crafting grid.
  • 1 smithing template, placed in the remaining top middle slot.

Spawn Eggs

• Camel spawn egg
• Sniffer spawn egg.

Torchflower Seeds

• A new type of seed, which can be planted on farmland and grows into a torchflower.
• Can only be obtained if a sniffer digs up a torchflower seed.
• Can be used to tempt and breed chickens and parrots.
• Can be used in composters.
• Can be used to breed and tempt sniffers.
• Can be picked up and planted by farmer villagers.

Mobs

Camel

• A rideable entity, which can be equipped with a saddle and ridden by two players.
• Has 32 × 16 health points.
• Spawns naturally in desert villages.
• Can be bred with cacti, and will follow players holding a cactus on hand.
• Mobs that are 2 blocks tall and lower cannot reach the player (except spiders) when the player is riding it, due to its height.
• Can walk over 1.5 block tall obstacles (such as fences and blocks with a slab on top).
• Will randomly sit down.
  • While sitting, it is difficult to convince them to move.
• Can either walk slowly or sprint quickly.
• Can also dash forward (if the player uses the jump key while riding it) but will lose stamina for a while.
  • When it loses stamina, it cannot sprint or dash again for a few seconds.
  • A dash can extend more than 10 blocks when executed perfectly.

Sniffer

• A new passive mob, which is also the mob vote winner of Minecraft Live 2022.
• Considered to be the first "ancient" mob.
• Very large (2x2 full blocks).
• Has 14 × 7 health points.
• Cannot spawn naturally.
• Often sniffs in the air and occasionally digs for torchflower seeds.
  • The digging has a cooldown of 8 minutes.
  • The last 20 dug blocks are remembered with a sniffer_explored_positions memory, and are not eligible for digging again.
• Can be bred and tempted with torchflower seeds, laying a sniffer egg.

Non-mob entities

Cherry boat

• A new type of boat, crafted with cherry planks.
• Can be used to craft a variant with a Chest.

Raft

• A new type of boat, crafted with bamboo planks.
• Can be used to craft a variant with a chest.
• They function the same way as ordinary boats, but have a unique look to them.
  • A raft's model is higher than a boat.

World generation

Cherry

• New type of tree variant that is found in cherry groves, can be grown from cherry saplings.
• Occasionally generated with a bee nest.
• Tree trunks fork or bend high up, and are then covered up in large, round canopies of cherry leaves.
• The concept was proposed in 2013 by Patrick Geuder,^[1][2] but was ultimately not added at the time.

Cherry Grove

• A new biome which contains cherry trees.
• Located in the mountains, like meadows.
• Pigs, sheep, rabbits, and bees can spawn here.

Trail Ruins

• A buried generated structure from a lost culture.
• Generates in taigas, snowy taigas, old growth taigas (both types), old growth birch forests, and jungles.
• Comprised of a tower, a path across the bottom, and a few additional rooms attached to the side.
• Contains suspicious gravel, as well as mud bricks and several colors of terracotta and glazed terracotta.
• Four armor trims and seven pottery sherds can be found here.
• In the suspicious gravel, the player can find:
  • Wooden hoe
  • Coal
  • Wheat
  • Gold nugget
  • Seeds
  • Beet seeds
  • String
  • Oak hanging sign
  • Spruce hanging sign
  • Blue glass pane
  • Red glass pane
  • Yellow glass pane
  • Light blue glass pane
  • Purple glass pane
  • Magenta glass pane
  • Pink glass pane
  • Blue dye
  • Yellow dye
  • Orange dye
  • Light blue dye
  • White dye
  • Brick
  • Green candles
  • Red candles
  • Purple candles
  • Brown candles
  • Leash
  • Dead bush
  • Clay block
  • Burn Pottery Sherd
  • Danger Pottery Sherd
  • Friend Pottery Sherd
  • Heart Pottery Sherd
  • Heartbreak Pottery Sherd
  • Howl Pottery Sherd
  • Sheaf Pottery Sherd
  • Host Armor Trim
  • Raiser Armor Trim
  • Shaper Armor Trim
  • Wayfinder Armor Trim
• Rare loot items and common loot items each have their own dedicated archaeological loot table.

Command format

/return

• A new command that can be used to control execution flow inside functions and change their return value. Effects:
  • Skip remaining separate top-level commands in the currently executing function (if any).
  • The result value of the function command that triggered the execution is changed from the number of commands executed to the value.
  • The result value of the return command is also the value.
• Syntax: /return <value>
  • value: An integer return value.

Gameplay

Advancements

• Added eight new advancements:
  • Smells interesting
    • Obtain a Sniffer Egg
  • Little sniffs
    • Feed a Snifflet
  • Planting the past
    • Plant any Sniffer seed
  • Crafting a new look
    • Craft a trimmed armor at a Smithing Table
  • Smithing with style
    • Apply these smithing templates at least once: Spire, Snout, Rib, Ward, Silence, Vex, Tide, Wayfinder
  • Respecting the remnants
    • Brush a Suspicious block to obtain a Pottery Sherd
  • Careful restoration
    • Make a Decorated Pot out of 4 Pottery Sherds
  • The Power of Books
    • Read the power signal of a Chiseled Bookshelf using a Comparator.

General

Advancements

• Added recipe_crafted advancement trigger; triggered when crafting a recipe.
  • Conditions:
    • recipe_id: The resource location of the recipe crafted.
    • ingredients: An array of predicates for the item stacks used in the recipe.
      • A single item stack can only be used to fulfill one predicate.
      • Each predicate needs to be fulfilled to trigger the advancement. This allows for seperation between recipes that have same identifier but use different ingredients.
      • This field is optional. When not provided, or left empty, only the recipe_id will dictate the success of the trigger.

Data pack

• Added registry trim_pattern and trim_material, which defines trim patterns and materials respectively, to allow adding them via data packs.
  • These are synchronized to clients when they join the server, but the accompanying resource pack is required on the client to make them visible.
  • The paths to these textures are inferred based on the filename of the pattern json, and will try to find the textures within the same namespace as the trim pattern's name field.
• trim_pattern defines following data:
  • asset_id: a namespaced ID used to infer texture locations and localization.
  • template_item: the ID of the smithing template item used to apply the trim pattern.
  • description: a text component used for displaying the pattern name of an armor trim when hovering an armor item stack.
• trim_material defines following data:
  • asset_name: a string used as a suffix for armor trim texture locations.
  • ingredient: the ID of the ingredient item used to apply the trim material.
  • item_model_index: a float number which defines the item model override each armor item model should target to change their visuals for this material.
  • description: a text component used for displaying the material name of an armor trim when hovering an armor itemstack.
    • The style defined in this description is applied to the armor trim pattern description as well.
  • override_armor_materials: an optional map of armor material to overriden color palette.
    • Map key is the armor material that this trim material wants to override with a different color palette.
    • Map value is the name of the color palette that will be used when this trim material is applied to an armor piece with the corresponding armor material.

Font

• Added unihex glyph provider.
  • A new glyph provider for reading Unifont HEX files.
    • HEX format describes bitmap font glyphs.
      • Height of every glyph is 16 pixels.
      • Width of glyph can be 8, 16, 24 or 32 pixels.
    • Every line is made of two hexadecimal numbers separated by :.
    • First value describes codepoint - it must have 4, 5 or 6 hex digits.
    • Second value describes glyph as a stream of bits, line by line.
  • When rendering, empty columns on left and right side of glyph are removed.
    • Custom glyph widths can be set with size_overrides.
  • Provider requires two fields:
    • hex_file: Path to ZIP archive containing one or more *.hex files (files in archive with different extensions are ignored).
    • size_overrides: List of codepoint ranges that should have width different that auto-detected (based on empty space in glyph). Fields:
      • from, to: Start and end of codepoint range (inclusive).
      • left, right: Integers describing position of left-most and right-most columns of glyph in range.
        • Any bits in columns outside this range will be discarded.
• Added reference glyph provider.
  • New glyph provider can be used to include providers from other fonts.
    • Providers are guaranteed to be loaded only once, no matter how many times they are included.
  • Provider has one field id, that describes other font to be included in currently loaded one.
    • Inclusion is performed after all fonts are loaded, so it will include all providers for a given font defined in all datapacks.

Languages

• Added Lao.^{[note 1]}
• Added Yakut.^{[note 1]}

Loot tables

• Added sniffer_digging: contains torchflower_seeds, and pitcher_pod.
  • Controls what can be found by sniffers when digging.

Music

• Added new ambient soundtracks, all by Aaron Cherof.^{[note 2]}
  • "A Familiar Room" plays in survival mode (all biomes), as well as the menu screens.
  • "Bromeliad" play in bamboo jungle, cherry grove, flower forest, forest, jungle, sparse jungle, as well as the menu screens.
  • "Crescent Dunes" plays in desert, all types of badlands, as well as the menu screens.
  • "Echo in the Wind" plays in cherry grove, flower forest, lush caves, all types of badlands, as well as the menu screens.

Particles

• Added cherry_leaves, which will appear underneath the cherry leaves.

player.dat format

• Added new flag (value 128) to HideFlags NBT field for hiding armor trim item tooltips.

Recipe

• Added smithing_transform, and smithing_trim recipe serializers for the updated netherite upgrade and the new armor trim recipe respectively.

Resource pack

• Added paletted_permutations, which is a new type of atlas configuration source used to dynamically generate new textures in memory based on a set of color palettes.
  • Color palettes allow to swap out the colors of a texture without having to supply all files for the variants of a texture in a resource pack.
  • This is useful for things like armor trims. It can change the their color directly without create a new texture for each color.
  • The paletted_permutations source has a set of required parameters:
    • textures: a list of namespaced locations of base textures.
      • These textures will be used to generate variants of them that have been modified by color palettes.
    • palette_key: a namespaced location of a color palette key file.
      • A color palette key is used to define the set of key pixel colors we want to swap out with the color palettes defined below.
    • permutations: a map of permutations from suffix to a namespaced location of a color palette file.
      • The suffix is appended at the beginning to the resource location of the output variant textures, with a _ character separating the suffix and the base texture name.
      • The color palette is a texture file with a set of pixels that are used for replacing pixels that match the color palette key in each base texture.
      • The number of pixels in each color palette must be the same as that of the palette_key defined for this source.
      • Key matching is done by comparing the RGB values of each pixel in the palette_key to the RGB values of each pixel in the color palette.
      • Alpha channel is ignored for key matching, but in the resulting texture the alpha channel is multiplied with the color palette's alpha channel.
      • Pixels that do not match the palette_key are copied over to the resulting texture as-is.
  • After defining a paletted_permutations source, those namespaced output textures can be referenced in other resources in resource pack.
    • For example, if the following paletted_permutations source exists:

      • {
            "type": "paletted_permutations",
            "textures": [
                "minecraft:item/leather_helmet",
                "minecraft:item/leather_chestplate",
                "minecraft:item/leather_leggings",
                "minecraft:item/leather_boots"
            ],
            "palette_key": "minecraft:colormap/color_palettes/leather_armor_color_key",
            "permutations": {
                "red": "minecraft:colormap/color_palettes/red",
                "green": "minecraft:colormap/color_palettes/green",
                "blue": "minecraft:colormap/color_palettes/blue"
            }
        }
        

    • The resulting textures can be referenced in other resources like this:

      • {
            "textures": {
                "layer0": "minecraft:item/leather_helmet_red",
                "layer1": "minecraft:item/leather_chestplate_green",
                "layer2": "minecraft:item/leather_boots_blue"
            }
        }
        

Splashes

• Added splashes:
  • This sand is sus
  • Remember to brush your... ...teeth
  • Has working bookshelves!
  • Sniff sniff...
  • Place hanging sign here
  • Joule is neat too!

Tags

• Added biome tag:
  • #has_structure/trail_ruins: contains taiga, snowy_taiga, old_growth_pine_taiga, old_growth_spruce_taiga, old_growth_birch_forest, and jungle.
• Added block tags:
  • #all_hanging_signs: contains the ceiling_hanging_signs, and wall_hanging_signs tags.
  • #bamboo_blocks: contains bamboo_block, and stripped_bamboo_block.
  • #ceiling_hanging_signs: contains all ceiling versions of hanging sign blocks.
  • #cherry_logs: contains cherry_log, cherry_wood, stripped_cherry_log, and stripped_cherry_wood.
  • #combination_step_sound_blocks: contains #wool_carpets, crimson_roots, moss_carpet, nether_sprouts, snow, and warped_roots.
    • Controls which blocks can produce a combination of step sounds.
  • #enchantment_power_provider: contains bookshelf.
  • #enchantment_power_transmitter: contains #replaceable.
    • Contains blocks that do not invalidate enchanting bonuses when placed between an enchanting table and bookshelves.
  • #maintains_farmland: contains pumpkin_stem, attached_pumpkin_stem, melon_stem, attached_melon_stem, beetroots, carrots, potatoes, torchflower_crop, torchflower, pitcher_crop, and wheat
    • Contains blocks that will not cause farmland to be converted into dirt when placed on top of it.
  • #replaceable: contains air, water, lava, grass, fern, dead_bush, seagrass, tall_seagrass, fire, soul_fire, snow, vine, glow_lichen, light, tall_grass, large_fern, structure_void, void_air, cave_air, bubble_column, warped_roots, nether_sprouts, crimson_roots, and hanging_roots.
    • Contains blocks on which another block can be placed.
  • #replaceable_by_trees: contains #leaves, grass, fern, dead_bush, vine, glow_lichen, sunflower, lilac, rose_bush, peony, tall_grass, large_fern, hanging_roots, pitcher_plant, water, seagrass, tall_seagrass, warped_roots, nether_sprouts, and crimson_roots.
    • Contains changeable blocks that growing trees can replace.
  • #sniffer_diggable_block: contains dirt, grass_block, podzol, coarse_dirt, rooted_dirt, moss_block, mud, and muddy_mangrove_roots.
  • #sniffer_egg_hatch_boost: contains moss_block.
  • #stone_buttons: contains stone_button, and polished_blackstone_button.
  • #sword_efficient: contains #leaves, #saplings, #small_flowers, #crops, grass, fern, dead_bush, vine, glow_lichen, sunflower, lilac, rose_bush, peony, tall_grass, large_fern, hanging_roots, pitcher_plant, brown_mushroom, red_mushroom, sugar_cane, pumpkin, carved_pumpkin, jack_o_lantern, melon, attached_pumpkin_stem, attached_melon_stem, lily_pad, cocoa, pitcher_crop, sweet_berry_bush, cave_vines, cave_vines_plant, spore_blossom, moss_carpet, pink_petals, big_dripleaf, big_dripleaf_stem, small_dripleaf, nether_wart, warped_fungus, warped_roots, nether_sprouts, crimson_fungus, weeping_vines, weeping_vines_plant, twisting_vines, twisting_vines_plant, crimson_roots, chorus_plant, and chorus_flower.
    • Contains blocks that break faster with a sword.
  • #trail_ruins_replaceable: contains gravel.
  • #wall_hanging_signs: contains all wall versions of hanging sign blocks.
• Added item tags:
  • #bamboo_blocks: contains bamboo_block, and stripped_bamboo_block.
  • #bookshelf_books: contains book, written_book, writable_book, enchanted_book, and knowledge_book.
  • #breaks_decorated_pots: contains #tools.
  • #cherry_logs: contains cherry_log, cherry_wood, stripped_cherry_log, and stripped_cherry_wood.
  • #decorated_pot_ingredients: contains brick, and #decorated_pot_sherds.
  • #decorated_pot_sherds: contains angler_pottery_sherd, archer_pottery_sherd, arms_up_pottery_sherd, blade_pottery_sherd, brewer_pottery_sherd, burn_pottery_sherd, danger_pottery_sherd, explorer_pottery_sherd, friend_pottery_sherd, heart_pottery_sherd, heartbreak_pottery_sherd, howl_pottery_sherd, miner_pottery_sherd, mourner_pottery_sherd, plenty_pottery_sherd, prize_pottery_sherd, sheaf_pottery_sherd, shelter_pottery_sherd, skull_pottery_sherd, and snort_pottery_sherd.
  • #hanging_signs: contains all hanging sign items.
  • #noteblock_top_instruments: contains zombie_head, skeleton_skull, creeper_head, dragon_head, wither_skeleton_skull, piglin_head, and player_head.
  • #sniffer_food: contains torchflower_seeds.
  • #stone_buttons: contains stone_button, and polished_blackstone_button.
  • #trim_materials: contains amethyst_shard, copper_ingot, diamond, emerald, gold_ingot, iron_ingot, lapis_lazuli, netherite_ingot, quartz, and redstone.
  • #trim_templates: contains coast_armor_trim_smithing_template, dune_armor_trim_smithing_template, eye_armor_trim_smithing_template, host_armor_trim_smithing_template, raiser_armor_trim_smithing_template, rib_armor_trim_smithing_template, sentry_armor_trim_smithing_template, shaper_armor_trim_smithing_template, silence_armor_trim_smithing_template, snout_armor_trim_smithing_template, spire_armor_trim_smithing_template, tide_armor_trim_smithing_template, vex_armor_trim_smithing_template, ward_armor_trim_smithing_template, wayfinder_armor_trim_smithing_template, and wild_armor_trim_smithing_template.
  • #trimmable_armor: contains chainmail_boots, chainmail_chestplate, chainmail_helmet, chainmail_leggings, diamond_boots, diamond_chestplate, diamond_helmet, diamond_leggings, golden_boots, golden_chestplate, golden_helmet, golden_leggings, iron_boots, iron_chestplate, iron_helmet, iron_leggings, leather_helmet, leather_chestplate, leather_leggings, leather_boots, netherite_boots, netherite_chestplate, netherite_helmet, netherite_leggings, and turtle_helmet.
  • #villager_plantable_seeds: contains wheat_seeds, potato, carrot, beetroot_seeds, torchflower_seeds, and pitcher_pod.
    • Contains seeds that villagers will use to farm.

Changes

Blocks

Beds, Carpets, and Wool

• Colored variants can now be dyed any other color.

Block of Amethyst

• Added a new behavior called vibration resonance when it is placed adjacent to sculk sensors.
  • If that sculk sensor receives a vibration, the block of amethyst will re-emit its frequency as a separate vibration at its location.
  • Sculk shriekers and wardens are triggered by vibrations emitted by a resonating amethyst block.
• Added to the "Redstone Blocks" tab in the Creative inventory.

Buttons

• Polished blackstone button now breaks in the same time as other buttons.

Dead Coral

• Dead coral blocks are now listed in the same order as the live corals in the Creative inventory.

Enchanting Table

• A replaceable block between them and bookshelves no longer invalidates bonuses.

Jukebox

• Added to the "Redstone Blocks" tab in the Creative inventory.

Mangrove Roots and Muddy Mangrove Roots

• Are now grouped with logs rather than leaves in the Creative inventory.

Note Block

• Mob heads can now be placed on top of note blocks without sneaking.
• When placing a mob head on a note block, that note block will now play one of the ambient sounds of that mob when played by a player or powered by redstone.

Player Head

• Now can contain a  note_block_sound NBT tag.
  • Must be a resource location for a valid sound event.
  • When present, this determines the sound a note block makes when the head is placed on top of it.

Sculk Sensor

• Vibration frequencies of many actions in the game have been tweaked and greatly simplified to prevent unwanted interference, as following:

Action	Frequency Value
Movement in any medium (land, water and air)	1
Landing on any surface (land or water)	2
Item interactions	3
Gliding with an elytra or unique mob actions (Ravager roar, Wolf shaking, etc)	4
Dismounting a mob or equipping gear	5
Mounting a mob or interacting with a mob	6
Mobs and players getting damaged	7
Consuming items (drinking and eating)	8
Blocks 'deactivating' (door close, chest close, button unpress, etc)	9
Blocks 'activating' (door open, chest open, button press, etc)	10
Blocks changing (cauldron water level rising, adding food to campfire, etc)	11
Blocks being destroyed	12
Blocks being placed	13
Mobs and players teleporting or spawning	14
Mobs and players dying or an explosion	15

• Default redstone output has been modified to be more reliable for distance calculations.
• Now strongly powers the block they are placed on.
• Can now be activated by sniffers digging.
• If a vibration is scheduled to be received by a Sculk Sensor, it will stay queued until all adjacent chunks are loaded and ticking.
  • This prevents vibration resonance setups from breaking when unloading their chunks from a distance.
• Now lasts 30 game ticks when in Active phase instead of 40.
• Now lasts 10 game ticks when in Cooldown phase instead of 1.

Sculk Shrieker

• Scream sounds will no longer be heard if block is waterlogged.
• Added to the "Redstone Blocks" tab in the Creative inventory.
• If a vibration is scheduled to be received by a Sculk Shrieker, it will stay queued until all adjacent chunks are loaded and ticking.
  • This prevents vibration resonance setups from breaking when unloading their chunks from a distance.

Signs

• Sign text can now be edited by interacting with it after being placed in the world.
  • Previous dye and glow ink sac effects are kept after editing.
  • Signs can not be edited by players in Adventure mode.
• Both sides of the sign can now have separate text and colors.
  • By default, a sign will prompt the player to input the front side's text when placed.
  • To apply text to the back-side, the player must walk to the other side and interact with that face to edit it.
• Signs can now also be waxed with honeycomb, preventing any further edits to its text.
  • Signs with non-text chat components can not be edited, even if the sign is not waxed.
• Signs save text even if the edit screen is closed by the player being moved far away.

Items

Armors

• Now can be visually customized with a variety of unique trims at the smithing table.
• Purely visual with no gameplay benefits, and can only be applied to helmets, chestplates, leggings and boots.
  • All trim patterns are visually the same on an armor's item icon, but the color will still change based on the trim material.
  • The name of the trim pattern will be displayed on the item's tooltip.
• Armor trim has 2 properties: pattern and material.
  • Pattern: Defined by the smithing template used to apply the trim, and represents the visual pattern of the trim.
  • Material: Defined by what ingredient is used to apply the trim, and represents the color of the trim.
    • Available ingredients:
      • Amethyst Shard
      • Copper Ingot
      • Diamond
      • Emerald
      • Gold Ingot
      • Iron Ingot
      • Lapis Lazuli
      • Nether Quartz
      • Netherite Ingot
      • Redstone Dust

Fish Buckets

• Are now listed in the same order as the fish items in the Creative inventory.

Potions

• Wither effect particle colors have been adjusted to make them more distinguishable.
• Potion of Slow Falling has had its color tweaked to make it more distinguishable from the Potion of Invisibility.

Wither Rose

• Is now grouped with other small flowers in the Creative inventory.

Mobs

Elder guardian

• Drops Tide Armor Trim upon death.

Slimes and magma cubes

• Are now affected by the Jump Boost effect.

Non-mob entities

Display

• Previous values are now always discarded if interpolation_duration is 0.
• Made sure that render properties are applied at the same time (so block_state is applied at the same time as transformation, i.e. at next tick after receiving update).
• Entities are not rendered unless initial data is received. That means display entities might not show on the first tick.
  • Due to how game handles updates, changes to entities made after summoning might be delivered to clients with later tick.
• item_display items have been rotated 180 degrees around Y axis to better match transformation applied when rendering items on armor stand head and in item frames.
  • For reference, order of transformations applied to model (starting from innermost) is item_transform, rotate Y 180, transformation field, entity orientation (billboard option + Rotation field + Pos field).

World generation

Ancient City

• Chests now contain Ward Armor Trim and Silence Armor Trim.

Bastion Remnant

• Chests now contain Netherite Upgrade and Snout Armor Trim.

Desert Pyramid

• Chests now contain Dune Armor Trim.
• Now includes a new room filled with sand and suspicious sand.
  • Some sand will appear exposed, and can be found at the same height as blue terracotta.
  • Suspicious sand is visible on the top layer of the newly added room.
• In the suspicious sand, the player can find:
  • Diamond
  • Emerald
  • Tnt
  • Gunpowder
  • Archer Pottery Sherd
  • Miner Pottery Sherd
  • Prize Pottery Sherd
  • Skull Pottery Sherd

Desert Well

• Now includes suspicious sand underwater.
• In the suspicious sand, the player can find:
  • Brick
  • Stick
  • Emerald
  • Suspicious Stew
  • Arms up Pottery Sherd
  • Brewer Pottery Sherd

End City

• Chests now contain Spire Armor Trim.

Jungle Temple

• Chests now contain Wild Armor Trim.

Nether Fortress

• Chests now contain Rib Armor Trim.

Ocean Ruins (cold)

• Now include suspicious gravel blocks.
• In the suspicious gravel, the player can find:
  • Emerald
  • Iron axe
  • Coal
  • Gold Nugget
  • Wheat
  • Wooden hoe
  • Blade Pottery Sherd
  • Explorer Pottery Sherd
  • Mourner Pottery Sherd
  • Plenty Pottery Sherd

Ocean Ruins (warm)

• Now include suspicious sand blocks.
• In the suspicious sand, the player can find:
  • Wooden hoe
  • Emerald
  • Coal
  • Gold Nugget
  • Wheat
  • Angler Pottery Sherd
  • Shelter Pottery Sherd
  • Snort Pottery Sherd

Pillager Outpost

• Chests now contain Sentry Armor Trim.

Shipwreck

• Chests now contain Coast Armor Trim.

Stronghold

• Chests now contain Eye Armor Trim.

Woodland mansion

• Chests now contain Vex Armor Trim.

Command format

/data

• string data sources now accept negative boundaries, which are interpreted as index counted from the end of the string.

Gameplay

Advancements

• The cherry grove is now required to be visited for the "Adventuring Time" advancement.
• Camels and sniffers are now required for the "Two by Two" advancement.
• The "The Parrots and the Bats" advancement can be granted by breeding sniffers and camels now.
• The "A Seedy Place" advancement can be granted by planting torchflower seeds and pitcher pods now.
• The "Glow and Behold!" advancement can be obtained by using a glow ink sac on a hanging sign now.
  • The description now says "Make the text of any sign glow".

Smithing Table functionality

• Redesigned: it is now a workstation for physical equipment upgrades and modifications.
• Added a slot used by smithing templates to the left of the old 2 slots.
• Smithing templates define what type of upgrade that will be making to equipment.
  • It specifies both what type of items that can upgrade, and which ingredients are valid to customize the upgrade.
• Netherite equipment crafting now also requires a netherite upgrade smithing template.

General

Advancements

• All fields in placed_block, item_used_on_block, and allay_drop_item_on_block advancement triggers have been collapsed to a single location field.
  • New location is similar to the player field - it's a list of loot conditions/predicates.
  • All conditions in this list must match for a trigger to run.
• Conditions are evaluated in a new loot context called advancement_location. It has access to:
  • Player as this entity.
  • Position of the placed/interacted block.
  • Block state of the placed/interacted block.
  • Held/used item as "tool".
• Migration guide:
  • Contents of old location field should be migrated to a location_check condition.
  • Contents of item field should be migrated to a match_tool condition.
  • Contents of block and state fields should be migrated to a block_state_property condition.
• Advancement fields now have a new boolean field called sends_telemetry_event.

Credits

• Updated to add some Mojang employees.
• Can be scrolled upwards by pressing ↑ now.

Damage type

• Added outside_border, and generic_kill.
  • Players outside the world border are now hurt by the damage type outside_border instead of in_wall.
  • Forcibly removing an entity using i.e. the /kill command now uses damage type generic_kill instead of out_of_world.

Data packs

• The data pack version is now 15.

Death messages

• Changed death message used for the /kill command.
  • Changed from "<player> fell out of the world" to "<player> was killed".
• Changed death message used for deaths caused by the world border.
  • Changed from "<player> suffocated in a wall" to "<player> left the confines of this world".

Debug screen

• Font textures are included in debug texture dump (F3 + S).

Feature Flags

• Removed update_1_20 feature flag and built-in datapack.
  • All features and changes from the "Update 1.20" experimental pack are now part of the game.

Game Events

• piston_contract game event has been removed in favor of block_deactivate.
• piston_extend and dispense_fail game events have been removed in favor of block_activate.
• Many game events have new vibration frequencies:

Game event	Frequency Value
step, swim, and flap	1
projectile_land, hit_ground, and splash	2
item_interact_finish, projectile_shoot, and instrument_play	3
entity_roar, entity_shake, and elytra_glide	4
entity_dismount, and equip	5
entity_mount, entity_interact, and shear	6
entity_damage	7
drink, and eat	8
container_close, block_close, block_deactivate, and block_detach	9
container_open, block_open, block_activate, block_attach, prime_fuse, and note_block_play	10
block_change	11
block_destroy, and fluid_pickup	12
block_place, and fluid_place	13
entity_place, lightning_strike, and teleport	14
entity_die, and explode	15

Loading World Screens

• Changed chunk colormap colors a little.

Loot tables

• Added new loot table function called reference.
  • New function reference allows functions to call sub-functions (similar to reference condition).
  • Fields: name - location of function to call
• Random sequences for loot tables are now deterministic.
  • The game now uses named random sequences to deterministically produce loot for loot tables.
  • Each random sequence produces a unique sequence based on the world seed and sequence identifier, which means a loot table will produce the same results when ran with the same parameters in the same world.
  • The identifier of the random sequence to use for a loot table is specified as a resource location in a new field called random_sequence.
  • The ID of the random sequence is an optional field. If no sequence name is given, loot is drawn using a non-deterministic random source.

Menu screen

• Game will now display message box on startup if user enabled text-to-speech functionality, but it is not available.

Music

• The places where the following existing music can be played are changed:^{[note 3]}
  • "Aerie", "Firebugs", and "Labyrinthine" can no longer be played in the menu screens, and all types of jungle biomes.

Options

• GUI can be scaled on the Video Settings screen by holding Ctrl and scrolling the mouse wheel.

Predicates

• Condition alternative has been renamed to any_of.
• Added new condition all_of that passes only when all sub-conditions pass.
  • It has the same syntax as any_of.

Recipe

• Ingredients in array form are now also allowed in smithing_trim, and smithing_transform recipes on fields template, base and addition.
  • Those fields also allow empty arrays, which signalize that slot needs to be left empty.

Resource packs

• The resource pack version is now 15.
  • Updated the sprite layout of minecraft.png
  • Removed the overriding minecraft.png from the Programmer Art resource pack.
  • Updated the sprite layout of invite_icon.png.
  • legacy_unicode glyph provider has been removed.
  • Bitmaps used by uniform font have been removed.
• uniform font has been updated to use Unifont 15.0.06.
  • That changes shape of multiple characters, while also adding support for new ones.
  • Combining characters no longer include circle overlayed over them.
  • During the updates of Unifont, some CJK unified ideographs in Plane 2 were added to the basic Unifont font files for coverage of the General Standard Chinese Characters set, and some in Plane 3, notably the character biang from Biangbiang noodles.
  • Updated Hangul syllables and related characters, now with an overall bigger appearance.
  • Minor updates to full-width punctuation and symbols in the range U+FF00 to U+FFEF.
  • Minor updates to other individual glyphs, notably a much improved skunk glyph (U+1F9A8).^[3]
• Added second level of organization of entries in credits.json on top of titles, called disciplines.

server.properties

• Changes in encoding.
  • The file is now read in UTF-8 initially, with previous encoding (ISO 8859-1/Latin 1) as a fallback.
  • File is now written with UTF-8 encoding.

Sounds

• Step sounds can now combine for blocks walked through and stepped on.
  • Occurs for carpets, snow, nether sprouts as well as warped and crimson roots.
    • The top-most block the player is walking on is played as normal.
    • The block underneath is played at a lower volume and pitch.
• Walking on a block will now always play a step sound.
  • It was previously not the case if the player was walking along the edge of a block with air or fluid beside it.
• Walking on the ocean floor will produce a step sound for the block the player is walking on, but at a lower volume and pitch.

Structure Post-processors

• A capped post-processor has been added which can limit how many blocks a delegated post-processor randomly transform in a structure.
  • This can be used to configure a structure piece to have an exact amount of specific blocks, instead of using random distribution.
  • It has following required parameters:
    • delegate - A post-processor which performs the actual block transformation.
    • limit - Maximum amount of blocks that the delegated post-processor can transform.
      • The blocks inside a structure are all randomly passed to the delegated post-processor until it has transformed the limited amount.
      • Either constant or random number generator sampled during post-processing.
• Previously a rule could specify an optional fixed output_nbt which would be added to the processed output block entity; this field has now been changed to reference a block_entity_modifier.
  • Existing block_entity_modifiers are:
    • passthrough: Retains existing fields on the block entity.
      • This is the default if no block_entity_modifier is specified.
    • append_static: Similar to previous output_nbt this provides fixed fields to add to the block entity.
      • A minor change is that this modifier appends configured fields to the processed block instead of replacing existing fields.
    • clear: Removes any existing fields on the block entity.
    • append_loot: Appends a loot table and seed to the block entity through required parameter:
      • loot_table: Referenced loot table to add to block entity as LootTable field.
      • Field LootTableSeed is also added to the block entity using random seeded by block position.

Tags

• Added #all_hanging_signs to the #all_signs block tag.
• Added #bamboo_blocks, bamboo mosaic slab and bamboo mosaic stairs to the #mineable/axe block tag.
• Added bamboo_boat, and cherry_boat into the #boats item tag.
• Added bamboo_button, and cherry_button into the #wooden_buttons block and item tags.
• Added bamboo_chest_boat, and cherry_chest_boat into the #chest_boats item tag.
• Added bamboo_door, and cherry_door into the #wooden_doors block and item tags.
• Added bamboo_fence_gate, and cherry_fence_gate into the #fence_gates block and item tags.
• Added bamboo_fence, and cherry_fence into the #wooden_fences block and item tags.
• Added bamboo_mosaic_slab to #slabs block and item tags.
• Added bamboo_mosaic_stairs to #stairs block and item tags.
• Added bamboo_planks, and cherry_planks into the #planks block and item tags.
• Added bamboo_pressure_plate, and cherry_pressure_plate into the #wooden_pressure_plates block and item tags.
• Added bamboo_sign, and cherry_sign into the #standing_signs block tag and #signs item tag.
• Added bamboo_slab, and cherry_slab into the #wooden_slabs block and item tags.
• Added bamboo_stairs, and cherry_stairs into the #wooden_stairs block and item tags.
• Added bamboo_trapdoor, and cherry_trapdoor into the #wooden_trapdoors block and item tags.
• Added bamboo_wall_sign, and cherry_wall_sign into the #wall_signs block tag.
• Added cherry_grove into the #is_overworld, and #is_mountain biome tags.
• Added cherry_leaves into the #leaves block and item tag.
• Added cherry_leaves, and pink_petals into the #flowers block and item tag.
• Added cherry_leaves, and pink_petals into the #mineable/hoe block tag.
• Added cherry_log into the #overworld_natural_logs block tag.
• Added #cherry_logs into the #logs_that_burn block and item tag.
• Added cherry_sapling into the #saplings block and item tag.
• Added crimson_hanging_sign, and warped_hanging_sign to the #non_flammable_wood item tag.
• Added generic_kill to #bypasses_invulnerability, and #bypasses_resistance damage type tags.
• Added generic_kill, and outside_border to #bypasses_armor damage type tag.
• Added music_disc_relic to the #music_discs item tag.
• Added pink_petals into the #inside_step_sound_blocks block tag.
• Added pitcher_plant to the #tall_flowers block and item tags.
• Added potted_torchflower to the #flower_pots block tag.
• Added suspicious_gravel to the #bamboo_plantable_on, and #overworld_carver_replaceables block tags.
• Added suspicious_gravel, and suspicious_sand to the #mineable/shovel block tag.
• Added suspicious_sand into the #sand block and item tag.
• Added torchflower into the #small_flowers block and item tags.
• Added torchflower_crop, and pitcher_crop into the #crops block tag.
• Changed flower_pot in the #flower_pots block tag to potted_cherry_sapling.
• Removed the #sand block tag from the #sculk_replaceable block tag, replacing it with sand, and red_sand.
• Removed stone_button, and polished_blackstone_button from the #buttons block and item tags, replacing them with the newly added #stone_buttons.
• Removed stone_button from the #mineable/pickaxe block tag, replacing it with the newly added #stone_buttons.
• Removed #replaceable_plants, in favor of #replaceable_by_trees.
• Removed moss_carpet, snow, nether_sprouts, warped_roots, crimson_roots, and #wool_carpets from the #inside_step_sound_blocks block tag, in favor of #combination_step_sound_blocks.

Telemetry

• Added new property: launcher_name.
  • A new global property sent with every event.
  • This is set based on the minecraft.launcher.brand system property.
  • This will help developers troubleshoot game launch related bugs more effectively, as they will be able to see whether the issue originated in the Minecraft launcher or a third-party program.
• Added new property realms_map_content to event world_loaded.
  • When loading into a Realms Map Content world (Minigame), the world_loaded event will receive the name of that map.
  • This is to help developers understand how Java Realms users interact with Java Realms adventure or minimap content.
• Added new optional event advancement_made.
  • This event is triggered when a player completes an advancement.
  • This allows developers to see the advancement ID and the time when the advancement was completed, and helps them as a studio understand player progress and limits, which informs their game design.
• Added new optional event game_load_times.
  • An event that is triggered when the game client is loaded, and includes the time it took for the client to load.
  • This is so that developers can work on improving and reducing the time it takes to load the game client.

Title screen

• The Panorama was changed to showcase a cherry grove biome.
• The Minecraft logo was changed.
  • Made Java Edition text bigger.
  • Made Minecraft text smaller.
• The Minceraft easter egg now has its own logo texture.
• The format of the Invite icon was slightly changed.
• The Minecraft Realms logo was changed.

General

• The game's application icon has been changed from crafting table to grass block.
  • Uses dirt icon for snapshots.
• Added native support for ARM64 machine architecture on Windows.
  • Needs to manually specify a native Java Executable in the launcher currently.
• Removed the server & port arguments as their functionality has been replaced by Quick Play.
• Added support for four new command line arguments that allow the game to be launched directly into a world.
• quickPlayPath takes a specified path for logging (relative to the run directory)
  • If a path is provided the following will be logged upon joining a world:
    • type: is either singleplayer, multiplayer, or realms
    • identifier: represents the world you want to join
      • For singleplayer, the folder name of the world
      • For multiplayer, the IP address of the server
      • For realms, the Realms ID
    • port: represents the server port and is only logged for multiplayer
    • name: The name of the world
    • gamemode: The gamemode of the world
    • lastPlayedTime: The time you joined the world
  • Example:
    • --quickPlayPath "quickPlay/log.json" will resolve into .minecraft/quickPlay/log.json
• quickPlaySingleplayer, quickPlayMultiplayer and quickPlayRealms all take their respective identifier
  • If one of these arguments is provided, the game will try to launch directly into the given world
  • Examples:
    • --quickPlaySingleplayer "New World"
    • --quickPlayMultiplayer "localhost:25565"
    • --quickPlayRealms "1234"
• Improved performance of the light engine.
• To improve safety, the game will now detect symbolic links used inside world directory.
  • If the target of a symbolic link is not on the user-configured allow-list, the game will not proceed with loading the world.
    • Note: world directory itself can still be linked.
  • The list of allowed symbolic link targets is stored in file allowed_symlinks.txt in client or server top directory.
  • The file consists of entries (one per line) with following formats allowed:
    • Lines starting with # are comments and are ignored.
    • [type]pattern, where type can be glob, regex or prefix.
      • prefix matches start of path with given pattern (so for /test paths /test, /test/, and /test/foo.txt would match).
      • regex matches regular expression against whole path.
      • glob uses OS-specific path matching mechanism (for example *.txt would usually match files with txt extension).
      • Note: paths will use OS-specific separators.
    • pattern, which uses default prefix type.

Fixes

240 issues fixed

From released versions before 1.20

• MC-180 – When reaching the other side of a nether portal the animation plays forever until stepped out of.
• MC-572 – Anvils sometimes destroy items when falling on them even if they aren't placed successfully.
• MC-1133 – Whether or not a player experiences some effect is calculated based on the block under the center of the player.
• MC-1310 – Dispensed boats and rafts get stuck inside of dispensers used to place them.
• MC-2215 – Encoding errors in server.properties.
• MC-2474 – Transparent blocks placed between bookshelves and enchanting tables negate bonuses received from bookshelves.
• MC-2604 – Walking on non-solid blocks with no collision plays their respective walking sounds.
• MC-18060 – Several realms strings are untranslatable.
• MC-21520 – Death message for /kill is "<player> fell out of the world"
• MC-30939 – Nether portal continues emitting light, even if portal is broken.
• MC-35078 – Breaking animation is one frame off.
• MC-48923 – Slime/magma cubes not affected by jump boost potion effect.
• MC-74955 – Fences play sound when jumping and walking/sprinting beside them.
• MC-107224 – World border death message states "suffocated in a wall"
• MC-108045 – Minecraft not using latest unifont unicode chart; characters are missing.
• MC-120158 – Anvils and other falling_blocks with HurtEntities set to true kill items and xp orbs.
• MC-121788 – Jump boost, slow falling and levitation don't apply to ridden horses, pigs or striders until after a relog.
• MC-123081 – Placing an end crystal when entering The End prevents Ender Dragon from spawning.
• MC-124327 – Changing the name of an item and then emptying the text field in an anvil doesn't make the rename unavailable, keeps last non-empty name on output item.
• MC-127394 – Minecraft does not render characters in Unicode mb4 range.
• MC-130089 – Turtle eggs break weird at block edges.
• MC-132076 – Lowercase Letters in controls menu + "Not Bound" is missing.
• MC-138358 – Levers on top of item frames Z-fighting with blocks in item frames.
• MC-146582 – When entering spectator mode while standing on the ground, the player moves down by 0.19051 blocks, which makes you fall down.
• MC-151882 – Favicon in game window shows old crafting table texture.
• MC-152258 – Riding an entity with slow falling will not stop fall damage.
• MC-155084 – Horses' armor, reins, and bridles experience z-fighting.
• MC-157727 – The small cube in honey/slime blocks isn't displayed in inventory.
• MC-158154 – Players can bounce on beds even when not directly touching it.
• MC-159633 – Command feedback messages are unnecessarily created during function execution.
• MC-159637 – Mobs with passengers have broken movements.
• MC-160332 – Horses with non-player passengers have improper orientation when walking.
• MC-162253 – Lag spike when crossing certain chunk borders.
• MC-165221 – 3D Modeled Potions are not rendered correctly in the "GUI Display".
• MC-165562 – Command suggestion report "incorrect argument" when cursor is at the start of a node without suggestions.
• MC-165773 – /execute run does not cause syntax error when arguments are missing.
• MC-166260 – Light from fire that has gone out lingers at the border of chunks.
• MC-169498 – Empty top subchunks don't update skylight in some cases.
• MC-170010 – Sky-lightmaps not properly initialized.
• MC-170012 – Lightmaps are missing for initial skylight.
• MC-172980 – Block light updates don't cross chunk borders properly when updated.
• MC-175504 – Single quotation marks are not supported in NBT paths.
• MC-176309 – Illusioner has a few misplaced pixels left in their texture.
• MC-179867 – Unicode Characters swapped in Minecraft.
• MC-181280 – Incorrect textures can sometimes be displayed.
• MC-188295 – Placing fallling blocks using /setblock can cause a client-side lag spike in some circumstances.
• MC-188595 – "gamemode" string in F3 + N description is inconsistent with "game mode" string in F3 + F4 description
• MC-193749 – Nether portals play the trigger sound again when the other dimension is loaded.
• MC-195781 – The "Include entities:" string displayed within the structure block GUI is improperly capitalized.
• MC-195825 – "datapacks" string is inconsistent with "data pack" string in datapackFailure.title text.
• MC-197241 – Players can change the color of a wolf's collar even if they're not its owner.
• MC-197772 – Missing textures in minecraft:uniform font.
• MC-198202 – Options background texture does not match dirt texture.
• MC-199752 – Polished Blackstone Button takes longer to break than other buttons.
• MC-201647 – Entity riding an entity can cause location/coordinate desync.
• MC-203039 – Incorrect use of colon in options.hideMatchedNames.tooltip.
• MC-203317 – There is a missing torch in one of the Stronghold rooms leaving a Light source.
• MC-203399 – Hoppers use the side texture on the bottom.
• MC-203406 – Kelp and seagrass models appear to reference biome tints despite not using any.
• MC-206548 – Leash knot subtitles are not properly capitalized.
• MC-207251 – Sculk sensors and shriekers do not work correctly when cloned, generated on superflat worlds or placed with custom structures.
• MC-207290 – Sculk sensors don't detect vibrations while walking on the edge of a block.
• MC-207803 – Security Issue: Can connect to a server twice for remote access to other players
• MC-212271 – Glow squid and squid show Z-fighting.
• MC-213936 – "Minecart moving" event does not trigger the right vibration frequency.
• MC-217447 – "Walking" on nether wart produces stone footstep sounds instead of nether wart sounds.
• MC-220096 – Graphics warning button(s) improperly capitalized.
• MC-224433 – Clouds texture contains semi-transparent background.
• MC-224648 – Pressed buttons placed on painting can cause z-fighting.
• MC-224976 – NativeImage.setPixelRGBA throws exception with message getPixelRGBA.
• MC-225742 – When light emitting blocks generate as ores, they do not emit light.
• MC-226344 – Changing the Owner tag of a projectile doesn't affect the outcome of the projectile unless the world is reloaded.
• MC-226454 – The "Light as a Rabbit" advancement description has no space after the ellipsis.
• MC-230792 – Cat's tail shows Z-Fighting.
• MC-230916 – "Potted Flowering Azalea Bush Plant" uses the wrong texture.
• MC-236117 – Music disc texture isn't centered properly.
• MC-236606 – Lightning bolt related string lacks capitalization.
• MC-237042 – Killing players in the sneaking state that have their sneak option set to "Toggle" in their accessibility settings, results in other players not being able to see them in this state when they respawn.
• MC-237556 – Legs of black cat model are white at the top.
• MC-237960 – New potion effect GUI doesn't work when using Programmer Art.
• MC-240098 – Minecraft can't be correctly profiled to Windows 11 version.
• MC-241314 – Filled cauldrons' bottom faces are still culled when they should not be.
• MC-241326 – Thomas Guimbretière's name is listed twice and misspelt in the credits.
• MC-241347 – Purple glazed terracotta still uses old sword design.
• MC-241725 – In the credits, an opening parenthesis is missing for Riley Manns.
• MC-241730 – In the credits, a closing parenthesis is missing for Konrad Jówko.
• MC-241732 – In the credits, "Lionbridge" is misspelt in one place.
• MC-241733 – In the credits, "Insight" is misspelt in one place.
• MC-241736 – Company names are still inconsistent and partly misspelled in the credits.
• MC-241741 – Certain names are listed twice in the credits.
• MC-241803 – credits.json: Line 2632 has typo in (C instead of O).
• MC-241850 – Miscolored pixels on double chest.
• MC-242105 – When landing on some non-full blocks while touching a thin block, impact particles use the thin block's texture.
• MC-245819 – Lighting can still occasionally lag behind world generation.
• MC-246459 – Drowned have some transparent pixels within their inner body texture.
• MC-249047 – The minecraft:ui.button.click sound isn't played when joining realms through double-clicking on them.
• MC-249341 – Some Mojang employees are not mentioned in the credits.
• MC-249450 – Sculk shriekers placed with NBT don't receive signals from nearby sculk sensors.
• MC-249508 – Light emitted from cave vines and glow lichens upon world generation still sometimes doesn't propagate across chunk borders.
• MC-249514 – Button UV appears to be upside-down.
• MC-250197 – Glass bottles are inconsistently referred to throughout some advancement description strings.
• MC-250571 – Gamerule description strings within the world creation menu consist of inconsistent concluding punctuation.
• MC-251536 – Desert zombie villager feet still mismatch the sides of the feet.
• MC-251537 – Desert (zombie) villager has solid-color on inner of arm, unlike other villagers.
• MC-251538 – Desert villager missing some pixels for the sandals.
• MC-252099 – Incorrect texture mapping in potted mangrove propagule (mirror effect).
• MC-252216 – 65540: Invalid scancode -1 logged in key bind menu when an option is unbound.
• MC-252389 – When landing (or jumping) on wool with your hitbox over the edge, it produces a vibration.
• MC-252408 – Chat restriction strings consist of inconsistent concluding punctuation.
• MC-252786 – SculkSensorBlockEntity and SculkShriekerBlockEntity leak VibrationListeners on update.
• MC-254410 – /setidletimeout set to a timer longer than 35791 disconnects idle player immediately.
• MC-254506 – Font file of some Korean completed font area is wrong.
• MC-254588 – Miscolored pixel on slowness effect icon.
• MC-256419 – Incomplete commands run through aliases don't produce errors.
• MC-256424 – Game mode is sometimes referred to as "gamemode".
• MC-256477 – Knowledge books can't be placed in chiseled bookshelves.
• MC-256488 – Bamboo Raft and Raft with Chest models float above ground.
• MC-256503 – Camel can swim sitting down.
• MC-256506 – Camels riding entities get permanently stuck in dash mode.
• MC-256540 – The top texture of the camel's front left leg contains some redundant gray pixels.
• MC-256551 – Baby camels have a visible inventory.
• MC-256585 – Z-fighting occurs on the text of hanging signs.
• MC-256688 – Birch wall hanging sign uses "snare" instrument when placed under note block, instead of "bass" as other hanging signs.
• MC-256833 – Ridable entities that can be steered build up fall damage when on climbable blocks.
• MC-257052 – You cannot double-click on languages within the "Language" menu to select them.
• MC-257178 – Chiseled Bookshelf redstone behavior is inconsistent.
• MC-257246 – Horses do not make step_wood sounds when walking on Nether wood, cherry wood, bamboo wood, or stems.
• MC-257268 – The dashing animations of camels sometimes aren't displayed for other players.
• MC-257269 – Sculk sensor detects player walking between carpet and wool.
• MC-257336 – Some chiseled bookshelf interaction subtitles are improperly capitalized.
• MC-257370 – Buckets of fish are not sorted in the same order as the fish items.
• MC-257512 – Dead tube coral in creative inventory is in wrong order.
• MC-257778 – Bamboo Mosaic Slabs and Stairs are not in the #slabs and #stairs block and item tags.
• MC-258360 – Horse armor loses its NBT data when equipped on horses via right-clicking.
• MC-258461 – The "Detect structure size and position:" string displayed within the structure block GUI is improperly capitalized.
• MC-258926 – Space is no longer treated as padding in fonts.
• MC-258939 – Non-atomic cached state can cause multithreaded crashes.
• MC-259201 – The tops and bottoms of donkeys' ears are miscolored.
• MC-259364 – The item.minecraft.smithing_template.netherite_upgrade.base_slot_description string is missing a serial comma.
• MC-259873 – Skeleton/Zombie Horse's chests are outdated.
• MC-259879 – Display entities with a rather large shadow_radius value can cause performance issues.
• MC-259912 – Saddled horses can infinitely retain Levitation effect.
• MC-259978 – Minecraft telemetry data detected Windows 11 as Windows 10.
• MC-260020 – Reloading the world resets the Brown Mooshroom's given flower.
• MC-260036 – Can't plant cactus and sugar cane on suspicious sand.
• MC-260038 – Sniffer does not have smooth animation transitions for some of its animations, like sniffing.
• MC-260042 – Cannot waterlog a decorated pot by using a water bucket or dispenser.
• MC-260043 – Decorated Pots don't play breaking sound in creative mode.
• MC-260047 – Decorated pots from the creative inventory and new blank decorated pots with no NBT will match their texture to the last decorated pot you crafted.
• MC-260053 – When rotating a decorated pot with the debug stick, it will spawn a decorated pot item.
• MC-260061 – Sniffer's ears and head z-fight.
• MC-260069 – Growing cherry trees inside each other causes their leaves to decay.
• MC-260075 – Player holds brush by ferrule in third person.
• MC-260080 – Sniffers play their walking animations after the "NoAI" NBT tag is applied to them.
• MC-260081 – Sniffers don't play their walking animations when they are damaged.
• MC-260086 – Entities riding sniffers are positioned too low down.
• MC-260090 – Sniffers ignore the minecraft:generic.movement_speed attribute.
• MC-260093 – Particles spawned by brushes in the left hand move in the wrong direction.
• MC-260105 – The name tags of sniffers are partly inside their models.
• MC-260146 – Pink petals are not next to other flowers in the creative inventory.
• MC-260152 – Sculk sensors are not activated by sniffers digging.
• MC-260197 – Item drop from Decorated Pot has no pickup delay.
• MC-260202 – The sound of using the brush isn't affected by blocks.
• MC-260219 – Sniffer eating sounds aren't played when feeding them the last item of torchflower seeds within a stack.
• MC-260221 – Sniffers can still dig when floated by levitation status effect.
• MC-260233 – Suspicious Sand has no assigned tool.
• MC-260237 – Sniffers can sniff while panicking.
• MC-260238 – Sniffer digging particles are produced slightly too high up.
• MC-260240 – Sniffers that are in love sometimes don't attempt to approach one another to breed.
• MC-260247 – Sniffers constantly play their walking animations when they're pushed into blocks.
• MC-260251 – The walking animations of sniffers don't change in relation to their movement speed.
• MC-260252 – Sniffer walking animation is broken when walking on ice.
• MC-260279 – Jukebox is not in the Redstone Blocks tab in the creative inventory.
• MC-260282 – Sniffers can sniff out and follow players in spectator mode.
• MC-260296 – Pink petal block models are not optimized.
• MC-260301 – Decorated Pots drop from setblock/fill air replace.
• MC-260307 – Cherry Grove biome has empty music sound event.
• MC-260315 – Parity Issue: Pottery Sherds have different textures compared to Bedrock.
• MC-260317 – Sniffers try to sniff out obstructed blocks they can't reach.
• MC-260320 – Parity Issue: Snifflets (Baby Sniffers) have an inconsistent model with Bedrock.
• MC-260326 – Dying sniffers continue to dig.
• MC-260347 – Falling suspicious sand does not break when reopening the world.
• MC-260348 – Sniffers will never dig in normal mud despite being a "sniffer_diggable" block.
• MC-260401 – When Brush is broken in offhand, the broken Particle is the Item in mainhand.
• MC-260409 – Cherry Grove biome is not in the #is_overworld biome tag.
• MC-260411 – Re-summoned dragons don't spawn end gateways when exiting the world before killing the dragon.
• MC-260435 – Sniffers don't play their walking animation when moving through cobwebs.
• MC-260454 – Decorated pots are translated off-center when displayed on head.
• MC-260459 – Baby sniffers don't sound high pitched when sniffing.
• MC-260465 – The torchflower crop still has an age 2 blockstate that looks like the regular torchflower.
• MC-260466 – Torchflower doesn't maintain farmland used to grow it.
• MC-260467 – Torchflower is not grouped with other small flowers in the creative inventory.
• MC-260468 – Wither rose is not grouped with other small flowers in the creative inventory.
• MC-260478 – Torchflower crop hitboxes don't change in size according to their age.
• MC-260503 – Sniffers refuse to dig into soil with a non-solid block on top.
• MC-260527 – The coordinates of the sniffer "minecraft:sniffer_explored_positions" tag do not check the dimension.
• MC-260602 – /data modify from string index failure does not return 0 for /execute store success.
• MC-260632 – Riding an entity that is far away causes client/server desync.
• MC-260653 – Markers, interaction, and display entities can prevent pressure plates from deactivating.
• MC-260678 – Potion of Invisibility looks too similar to the Potion of Slow Falling.
• MC-260693 – potted_torchflower is still not part of the #flower_pots block tag.
• MC-260711 – Some words within /datapack list command feedback messages are always pluralized.
• MC-260712 – Some words within /scoreboard command feedback messages are always pluralized.
• MC-260713 – Some words within /team command feedback messages are always pluralized.
• MC-260715 – Some words within /bossbar command feedback messages are always pluralized.
• MC-260716 – Some words within /fill, /fillbiome, and /clone command feedback messages are always pluralized.
• MC-260750 – Magma blocks use unnecessary random ticking for an outdated feature, causing performance issues.
• MC-260757 – Updating a large amount of Iron Bars causes the game to hang in-game or during the Saving world screen.
• MC-260777 – Sniffers ignore some dangerous blocks while sniffing and pathfinding resulting in them being damaged.
• MC-260778 – Sniffer tries to sniff out blocks outside the world border.
• MC-260779 – Sniffers can dig into blocks outside the world border.
• MC-260799 – The word "Sand" is not capitalized in the brush subtitle.
• MC-260810 – Villagers can't pick up torchflower seeds, despite being able to farm torchflowers.
• MC-260834 – "Alpha" can play during gameplay.
• MC-260839 – Mobs can replace weapons held in their main hand with armor.
• MC-260849 – Sniffer can't get into minecart.
• MC-260885 – Display entities summoned with initial transformation interpolate incorrectly from default transformation during next transformation.
• MC-260897 – Display entity's previous state of interpolation doesn't work as expected.
• MC-260898 – Brushes can be used through entities.
• MC-260903 – Less recent attacker can be credited for kill.
• MC-260974 – Aggressive mobs can't control "vehicle" mobs.
• MC-260992 – Cannot return to title screen from Realms screen (except using ESC).
• MC-261020 – Double-clicking on a Realm to join it no longer works.
• MC-261024 – /execute if loaded does not guarantee entities are loaded.
• MC-261029 – Progress bar for uploading a world to Realms is much larger than normal.
• MC-261080 – Player can fall through scaffolding when loading a world.
• MC-261275 – Sniffers drop moss blocks when killed.
• MC-261294 – Jack o'lantern can be placed on the player or armor stand head without commands and without appearing the blur.
• MC-261417 – The hitboxes of sniffers are not adjusted when they lay down.
• MC-261433 – Shield doesn't block TNT explosion.
• MC-261487 – Z-fighting occurs on the backs of sniffers' heads.
• MC-261626 – Reversed Comma doesn't render properly when using the Unicode font.
• MC-261804 – Expired Key preventing players from logging in on servers.
• MC-261857 – Using the "/setblock", "/fill", or "/clone" commands to create little amounts of blocks in completely isolated areas causes large client-side stutters.
• MC-261900 – Sniffers cannot properly pathfind into water while burning.
• MC-262067 – The type of sniffer digging particles that are produced is determined by the block that sniffers are located on instead of the block that sniffers are digging.
• MC-262069 – Sniffers continue digging after their target block is destroyed.
• MC-262440 – Sniffers can sniff while in love and pathfinding to their lover.
• MC-262518 – The mco.configure.world.uninvite.player string contains an unnecessary space before the question mark.
• MC-262684 – Game icon has low resolution.

Trivia

• This update has the shortest time span between the first snapshot and the change of its panorama. (14 days or 2 snapshots)
• The name of the update was not announced until March 2, 2023.
• According to Mojang developer Gnembon, not having too many features for the update pre-announced made it easier mentally for the development team, while also giving them more freedom to theme the update into something well received and welcomed by the community.^[4]
  • Being more relaxed while developing this update, the Mojang team also had greater mental capacity to tackle older issues in the game, such as fixing the bug with horse breeding and adding hopper/dropper support for jukeboxes.^[5]
• Archaeology was originally planned to be a feature of the 1.17 update.
• Unused textures for the calibrated sculk sensor were first found in 20w49a and later removed in 21w13a.
• This update is the first to use the experiments system on Java Edition.
  • Versions Java Edition 1.19.3 and Java Edition 1.19.4 are versions that added experimental features of 1.20.
• This update was released exactly one year after Java Edition 1.19 and exactly six years after Java Edition 1.12.
• This is the first Major update to have just 1 release candidate since Java Edition 1.16 in 2020.
• As of current, this is the most recent Java Edition update to have "Removed Herobrine" featured on the official patch notes, following almost three years of absence since Java Edition 1.16.2.

References

Notes