Java Edition 25w02a

{
 "title": "Minecraft 25w02a",
 "images": [
 "25w02a.jpg",
 "Java Edition 25w02a.png"
 ],
 "rows": [
 {
 "field": "''(link to Java Edition article, displayed as Java Edition)''",
 "label": "(link to Edition article, displayed as Edition)"
 },
 {
 "field": "January 8, 2025",
 "label": "Release date"
 },
 {
 "field": "(link to Snapshot article, displayed as Snapshot)",
 "label": "(link to Version types article, displayed as Type)"
 },
 {
 "field": "(link to Java Edition 1.21.5 article, displayed as 1.21.5)",
 "label": "Snapshot for"
 },
 {
 "field": "[https://piston-data.mojang.com/v1/objects/5dc770c10d3769f9f3437a2bd7029b10b9c0d780/client.jar Client] ([https://piston-meta.mojang.com/v1/packages/02a2ae8e2c54cfc39402997bae1bbb2ccc956c84/25w02a.json .json])<br />[https://piston-data.mojang.com/v1/objects/d9bf4ff75df54a19c19cb4fbc37f020a734904e5/server.jar Server]",
 "label": "(link to Tutorial:Installing a version#Manual version installation article, displayed as Downloads)"
 },
 {
 "field": "[https://piston-data.mojang.com/v1/objects/2a5d0ba89d8a9293c37821e4d9c192571a98ceda/client.txt Client]<br />[https://piston-data.mojang.com/v1/objects/fea3bf04f0775c6413e0283e4398c09c38d752fa/server.txt Server]",
 "label": "(link to Obfuscation map article, displayed as Obfuscation maps)"
 },
 {
 "field": " <span style=\"font-size:smaller\"><abbr title=\"decimal\">dec</abbr>: </span>1073742053<br /> <span style=\"font-size:smaller\"><abbr title=\"hexadecimal\">hex</abbr>: </span>400000E5",
 "label": "(link to Protocol version article, displayed as Protocol version)"
 },
 {
 "field": "4298",
 "label": "(link to Data version article, displayed as Data version)"
 },
 {
 "field": "47",
 "label": "<span style=\"white-space: normal;\">(link to Pack format#List of pack formats article, displayed as Resource pack format)</span>"
 },
 {
 "field": "62",
 "label": "<span style=\"white-space: normal;\">(link to Pack format#List of pack formats article, displayed as Data pack format)</span>"
 },
 {
 "field": "<span class=\"plainlinks\">[https://en.wikipedia.org/wiki/Java_version_history#Java_SE_21_.28LTS.29 Java SE 21]</span>",
 "label": "<span style=\"white-space: normal;\">Minimum Java version</span>"
 }
 ],
 "invimages": [],
 "footer": "<table style=\"margin: auto; word-break: break-word;\">\n<tr style=\"background: inherit;\">\n<td style=\"padding: 0.4em\" rowspan=\"2\">[[Java Edition 1.21.4|<span style=\"margin-right:-0.35em\">◄</span>◄  1.21.4]]</td>\n<td style=\"padding: 0.4em\">'''[[Java Edition 1.21.5|1.21.5]]'''</td>\n<td style=\"padding: 0.4em\" >[[Java Edition 1.21.6| 1.21.6 <span style=\"margin-right:-0.35em\">►</span>►]]</td>\n</tr>\n<tr style=\"background: inherit;\">\n\n<td style=\"padding: 0.4em\">''' 25w02a'''</td>\n<td style=\"padding: 0.4em\">\n[[Java Edition 25w03a| 25w03a ►]]\n</td>\n</tr>\n</table>"
}

25w02a is the first snapshot for Java Edition 1.21.5 released on January 8, 2025,^[1] which adds leaf litter, wildflowers, new pig variants and fixes bugs. This is the first snapshot released in 2025.

👁 Image
👁 Image
👁 Image
👁 Image
Leaf litter

• A new type of decorative block which can be found in forests, dark forests and wooded badlands.
• Can have different amounts of leaves in one block space.
  • Up to four leaf litter pieces can be placed in the same block space like pink petals.
  • Placing a leaf litter into an already placed leaf litter block increases the amount of leaves.
• Can be placed in four orientations.
• Can be created by smelting any type of Leaves block.
• Can be used as fuel for smelting.
• Has unique block sounds.

👁 Image
👁 Image
👁 Image
👁 Image
Wildflowers

• A new type of flower which grow in birch forests, old growth birch forests and meadows.
• Can have different amounts of flowers in one block space.
  • Up to four wildflowers can be placed in the same block space like pink petals.
  • Placing a wildflower into an already placed wildflowers block increases the amount of flowers.
  • Using bone meal on wildflowers will produce more Wildflowers.
• Can be placed in four orientations.
• Can be crafted into yellow dye.

Pig

• 👁 Image
  👁 Image
  New pig variants have been added, the variant is determined by the biome they spawn in.
  • 👁 Image
    Temperate Pig - The pre-existing pig variant.
    • Spawns by default where the cold and warm pig variants do not spawn.
  • 👁 Image
    Cold Pig - A variant that spawns in the following biomes:
    • 👁 Image
      Old Growth Pine Taiga
    • 👁 Image
      Old Growth Spruce Taiga
    • 👁 Image
      Taiga
    • 👁 Image
      Snowy Taiga
    • 👁 Image
      Windswept Hills
    • 👁 Image
      Windswept Gravelly Hills
    • 👁 Image
      Windswept Forest
  • 👁 Image
    Warm Pig - A variant that spawns in the following biomes:
    • 👁 Image
      Savanna
    • 👁 Image
      Savanna Plateau
    • 👁 Image
      Windswept Hills^[2]
    • 👁 Image
      Jungle
    • 👁 Image
      Sparse Jungle
    • 👁 Image
      Bamboo Jungle
    • 👁 Image
      Eroded Badlands
    • 👁 Image
      Wooded Badlands
    • 👁 Image
      Badlands
• When bred by a player, a baby pig variant will not be chosen by the current biome, but instead randomly selected from one of the parents' variants.

Data components minecraft:weapon

• When present, the 'Item Used' statistic will be incremented for each attack with the item.
• The specified amount of damage can be done to the item with each attack.
• Format: object with fields:
  • damage_per_attack - non-negative integer (default: 1)
    • The amount to damage the weapon for each attack performed.
  • can_disable_blocking - boolean (default: false)
    • If true, will disable a blocking Shield on successful attack.
• e.g. weapon={damage_per_attack:2}

minecraft:potion_duration_scale

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

Tags

• Block Tags
  • Added #replaceable_by_mushrooms - exhaustive list of all blocks that can be replaced as a mushroom is placed or grows.
  • Added #sword_instantly_mines - blocks that are instantly mined by Swords.

• Item Tags
  • Added #book_cloning_target - item that can be crafted together with a Written Book to clone it.

• Biome Tags
  • Added #spawns_cold_variant_farm_animals - all biomes where cold variant of farm animals spawn.
  • Added #spawns_warm_variant_farm_animals - all biomes where warm variants of farm animals spawn.

Bubble column

• Bubble columns produce less particles and sounds when entities that are unaffected by them are inside them.

Creaking heart

• Creaking hearts correctly placed between logs have a new dormant texture during the day.
  • Dormant creaking hearts cannot spawn new creakings or resin clumps.
• The transition between the awake and dormant states of creaking hearts is now based on the fixed day time.

Eyeblossom

• The transition between the states of eyeblossoms is now based on the fixed day time.

Iron bars, iron block, iron trapdoor, iron door and heavy weighted pressure plate

• Added new break, place, step, fall and hit sounds.

Leaves

• The following blocks can now spawn falling leaf particles:
  • 👁 Image
    Oak Leaves
  • 👁 Image
    Spruce Leaves
  • 👁 Image
    Birch Leaves
  • 👁 Image
    Acacia Leaves
  • 👁 Image
    Jungle Leaves
  • 👁 Image
    Dark Oak Leaves
  • 👁 Image
    Mangrove Leaves
  • 👁 Image
    Azalea Leaves
  • 👁 Image
    Flowering Azalea Leaves

Lodestone

• Changed crafting recipe to require an iron ingot instead of a netherite ingot, making them renewable.

• Can now be found in ruined portal chests.

Pale oak leaves and pale oak sapling

• Now have an updated map color.

Elytra

• Flight is now cancelled when gliding into climbable blocks like ladders, scaffolding, vines etc.

General

• Farm animals can now spawn in badlands.

Bee

• Is now attracted to, and can be bred using wildflowers.

Creaking

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

Zombified piglin

• Must now be killed by a player to drop its Player-specific loot.

Pale garden

• Now occupies more space that was previously taken by dark forests.
• Woodland mansions can now generate in Pale Garden biome.

Short grass

• Now generates slightly sparser in meadows.

Narrator

• The volume of the narrator is now affected by the game's configured volume in the 'Voice' category.

Player movement

• Moving diagonally by holding down two movement keys no longer increases the player's speed.^[3]

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

/fill

• The replace option in the fill command is no longer terminal, and can be followed with additional options.

/fill, /clone, /setblock and /place template

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

General

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

Data components minecraft:tool

• Added new optional field: can_destroy_blocks_in_creative (bool)
  • If false, players cannot break blocks while holding this tool in Creative Mode.
  • If not specified, defaults to true.

Data pack

• The pack format version is now 62.

Entity format

• The ArmorDropChances, HandDropChances, and body_armor_drop_chance fields have been merged into a drop_chances field
  • Format: map between equipment slot type and chance value
    • Valid equipment slots: head, chest, legs, feet, mainhand, offhand, body.
  • If not specified or removed, chances will be assumed as default (0.085f).
  • e.g. drop_chances:{chest:0.1,feet:1.0}
• Drop chances with a default value will no longer be stored, and the drop_chances field is removed entirely if all defaults.
• Area effect clouds have a new field: potion_duration_scale (float).
  • If not specified, defaults to 1.0.
  • The duration of the potion effect applied is scaled by this factor.
  • Area effect clouds created by lingering potions will have a scale of 0.25.

Realms

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

Recipes

• crafting_transmute
  • The result field now supports specifying a count and a components patch to apply to the result.
  • The components patch is applied to the final transmuted item.
  • The new format is an object with fields:
    • id - item id
    • count - positive integer (default: 1)
    • components - a component patch object (default: empty)
    • e.g. "result": {"id": "minecraft:stick", "count": 3, "components": {"!minecraft:damage": {}, "minecraft:enchantment_glint_override": {}}}
  • The field can still be defined as before as an inline item id (e.g. "result": "minecraft:stick")

Resource pack

• The pack format version is now 47.
• Added textures for new falling leaves particles.
• Added textures for new wildflowers block.
• Added break, place, step, fall and hit sounds for iron blocks, iron bars, iron Trapdoors, iron doors and heavy weighted pressure plates.
• Added new textures for pig variants:
  • cold_pig
  • warm_pig
• Changed the size of pig texture.
• Pig variants can be data-driven by adding entries to data/<namespace>/pig_variant/<id>.json
  • This feature is experimental
• Fields in file:
  • model - one of: normal, cold .
  • texture - texture id for this variant, resolves to assets/<namespace>/textures/<path>.png.
  • biome - single entry, list or a tag describing biomes in which this variant naturally spawns.
    • If not specified, this variant will only be selected if no other variant matches the current biome.

Tags

• Added wildflowers to the #bee_attractive, and #flowers block tags, and the #bee_food item tag.
• Added wildflowers, and leaf_litter to the #inside_step_sound_blocks block tag.
• Added leaf_litter to the #replaceable_by_trees block tag.
• Changed the #big_dripleaf_placeable block tag, effectively removing pale_moss_block from the contents.
• Added pale_garden to the #has_structure/woodland_mansion biome tag.

Text component format

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

• Hover Events
  • The hoverEvent field has been renamed to hover_event.
  • The legacy value field (which was parsed from a rendered text component) is no longer supported.
  • For the show_text action:
    • contents field has been renamed to text.
    • e.g. {action:'show_text',contents:'Hello world'} becomes {action:'show_text',text:'Hello world'}
  • For the show_item action:
    • The contents field has been inlined.
    • e.g. {action:'show_item',contents:{id:'minecraft:stick',count:2}} becomes {action:'show_item',id:'minecraft:stick',count:2}
    • If contents was specified only as an item id, it is replaced with the full format and inlined.
    • e.g. {action:'show_item',contents:'minecraft:stick'} becomes {action:'show_item',id:'minecraft:stick'}
  • For the show_entity action:
    • The contents field has been inlined.
    • The id field has been renamed to uuid.
    • The type field has been renamed to id.
    • e.g. {action:'show_entity',contents:{id:[I;0,0,0,0],type:'minecraft:pig'}} becomes {action:'show_entity',uuid:[I;0,0,0,0],id:'minecraft:pig'}

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

78 issues fixed

From released versions before 1.21

• MC-7697 – Tridents or arrows shot through lava sometimes don't catch fire.
• MC-55800 – Successful "/fill air destroy" commands give error message and return 0 for result/success.
• MC-56653 – Zombified Piglins drop XP and rare drops if killed by anything while in angered state.
• MC-90212 – You cannot hang on to climbable blocks while gliding with elytra.
• MC-93185 – The exit portal in the end generates at highest block at 0 0 which can make it generate incomplete.
• MC-97244 – The "minecraft:enchant.thorns.hit" sound event doesn't play when non-player entities are damaged by the thorns enchantment.
• MC-113878 – Attribute modifiers description for chest is misleading / "When on body" instead of "When on chest".
• MC-117574 – Using /setblock or /fill to re-place a block entity keeps old NBT (if no NBT specified) but clears inventories, even when the command fails.
• MC-118092 – Crafting recipe unlock toast says "New Recipes Unlocked!" even when only one recipe was unlocked.
• MC-118470 – Narrator plays at full volume when volume is off.
• MC-128079 – Statistic for using shears doesn't increase when mining certain blocks.
• MC-135192 – Boats are immediately sunken if there is a string on the surface of the water.
• MC-141297 – You cannot set lit state of redstone torches using /setblock, debug stick and BlockStateTag, to be to opposite of the situation it would be in.
• MC-160304 – Sneaking on ice can change direction of movement to lines along axis.
• MC-167125 – Rounding error on fall damage.
• MC-183329 – Nether portal teleport overlay does not show up if the player has the nausea effect.
• MC-183623 – Hardcore worlds in the world menu have a comma after the red exclamation mark.
• MC-184530 – Player movement at low speeds is biased towards cardinal directions.
• MC-184681 – Customized worlds still say "Buffet world customization" since 20w21a.
• MC-193404 – Changing a powered or activator rail to powered using a debug stick or /setblock does not work.
• MC-202226 – /recipe give or take for one recipe says "recipes".
• MC-220672 – Inconsistent pluralization in customize world preset heading source string.
• MC-222876 – "Buffet world customization" is incorrectly capitalized.
• MC-226772 – Shulker box opening / closing subtitle shows "Shulker".
• MC-239705 – Sprinting forward while facing a certain angle pushes the player either to the left or to the right.
• MC-241951 – Player momentum on X and Z axis are cancelled separately at low values.
• MC-248099 – Mob pathfinding breaks after falling into water accidentally while walking.
• MC-253721 – Wrong logs when running /op @a.
• MC-260440 – Players can no longer activate swimming mode in water while flying with elytra.
• MC-261385 – Bubble columns act differently at the surface depending on non-air blocks.
• MC-262928 – The "minecraft:entity.player.hurt" sound is no longer played when players receive thorns damage from guardians or elder guardians.
• MC-262939 – Changing dimensions or respawning with nausea effect active displays nether portal overlay.
• MC-265514 – HRTF stuck on even when directional audio is set to off in update 1.20.2.
• MC-267221 – "value" within "change_page" clickEvent json looks for a string instead of an integer.
• MC-267323 – Items fields with old boolean JSON formatting are cleared upon world update.
• MC-268942 – The swimming animation no longer displays when gliding with an elytra and swimming at the same time.
• MC-270220 – Granting all advancements results in prolonged, disruptive and loud audio spam.
• MC-271065 – Diagonal movement is not normalized when crouching or using certain items.

From 1.21

• MC-273338 – Flying boat glitch using string and rising bubble columns.
• MC-274187 – The sweeping attack from a sword enchanted with Fire Aspect can ignite other players with PVP disabled.

From 1.21.2

• MC-275994 – Having the pie chart open while the window is unfocused spams the logs.
• MC-277403 – Flaming arrows and tridents still don't extinguish when water is placed in their location.
• MC-277537 – Pale moss carpets sometimes generate disjointed.
• MC-277780 – Minecraft resaves all maps with every autosave even after the 1st patch.
• MC-277865 – The animation of boats in bubble columns breaks when over a certain "Time" in level.dat.
• MC-277922 – Boats in 1 block high downward bubble column will continue to rock back and forth.
• MC-278040 – Creaking swim pathfinding breaks after being submerged.
• MC-278639 – Tripwire hooks are not activated by shulker bullets.

From 1.21.3

• MC-277807 – Teleporting the player's mount causes rotation de-sync, previously did not.
• MC-278375 – Feeding wheat or hay bale to llama or trader llama with maximum Temper causes item stack to be desynced.
• MC-278376 – Arrows and tridents act weirdly in one block deep bubble columns.
• MC-278455 – Slow sideways movement in spectator mode is wrong at angles which aren't (close to) a multiple of 45°.

From 1.21.4

• MC-278096 – "Fabulous!" graphics and clouds disabled causes all particles to linger in frame buffer for one frame.
• MC-278140 – The /fill command doesn't work properly with the directional states of several blocks placed adjacent to one another.
• MC-278164 – Click sound is played twice when you click a setting button and there's a slider under the mouse in the next screen.
• MC-278204 – Blaze fireballs now cause TNT minecarts to explode instantly.
• MC-278249 – Experience orb positions desync severely and abruptly correct themselves.
• MC-278422 – Reloading the world after removing Owner tag from a sitting tamed wolf with /data remove makes the wolf moving and sitting at the same time.
• MC-278493 – Tamed wolves which are angry at creakings remain angry when said creakings despawn.
• MC-278502 – Weeping and twisting vines disconnect.
• MC-278552 – minecraft:entity.player.big_fall no longer plays the sound when falling from great height.
• MC-278585 – Players can get stuck when landing on the edge of powder snow.
• MC-278591 – Ender dragon spawn egg is no longer given when using pick block on the ender dragon entity.
• MC-278615 – Reinforcement zombified piglins are angry at you even if you killed the "caller" in one hit.
• MC-278621 – Client/server desync when placing powder snow while landing in it.
• MC-278627 – Players wearing leather boots will take fall damage when landing on the edge of powder snow.
• MC-278634 – Trying to /setblock a 'waterlogged=true' state on (glow_lichen, resin_clump, sculk_vein, etc.) produces an error.
• MC-278659 – Attacking a natural stationary creaking does not trigger sculk sensors.
• MC-278683 – Mobs spawned from spawners or /summon never drop their equipment.
• MC-278708 – Throwing ender pearls while mounted only dismounts you, without teleporting.
• MC-278728 – smithing_transform recipes can't set an item's components back to default.
• MC-278733 – Breaking a double resin brick slab block only returns a single slab.
• MC-278734 – Sheep's heads stutter when they look up or down.
• MC-278755 – Teleporting far away while riding an entity softlocks the game.
• MC-278801 – The closed eyeblossom to gray dye recipe is not grouped with the other gray dye recipe.
• MC-278841 – Powder snow no longer slows down the player falling from a high place.
• MC-279145 – Shulker bullets are no longer affected by bubble columns.
• MC-279152 – Shulker bullets can't teleport through nether or end portals, end gateways.