Java Edition 25w04a

Minecraft 25w04a
Edition	Java Edition
Release date	January 22, 2025
Type	Snapshot
Snapshot for	1.21.5
Downloads	Client (.json); Server
Obfuscation maps	Client; Server
Protocol version	dec: 1073742055; hex: 400000E7
Data version	4308
Resource pack format	49
Data pack format	64
Minimum Java version	Java SE 21

25w04a is the third snapshot for Java Edition 1.21.5, released on January 22, 2025,^[1] which adds new data components and fixes bugs.

Additions[edit | edit source]

General[edit | edit source]

Data component format

blocks_attacks component
- When present, this item can be used like a Shield to block attacks to the holding player.
- Format: object with fields
  - block_delay_seconds
    - Non-negative float (default: 0).
    - The number of seconds that right-click must be held before successfully blocking attacks.
  - disable_cooldown_scale
    - Non-negative float (default: 1).
    - Multiplier applied to the number of seconds that the item will be on cooldown for when attacked by a disabling attack (disable_blocking_for_seconds on the weapon component).
    - If 0, this item can never be disabled by attacks.
  - damage_reductions
    - List of object with fields (optional)
    - Controls how much damage should be blocked in a given attack.
    - If not specified, all damage is blocked.
    - Each entry in the list contributes an amount of damage to be blocked, optionally filtered by damage type.
    - Each entry adds to blocked damage, determined by clamp(base + factor * dealt_damage, 0, dealt_damage).
    - The final damage applied in the attack to the entity is determined by dealt_damage - clamp(blocked_damage, 0, dealt_damage)
    - Entry format:
      - type - damage type id, list of damage type ids, or hash-prefixed damage type tag (optional).
        This entry will only contribute to the blocked damage if the dealt damage type matches this field.
        
        If not specified, any damage type will be accepted.
      - base - float
        Constant amount of damage to be blocked.
      - factor - float
        Fraction of the dealt damage that should be blocked.
  - item_damage
    - Object with fields (optional)
    - Controls how much damage should be applied to the item from a given attack.
    - If not specified, a point of durability is removed for every point of damage dealt.
    - The final damage applied to the item is determined by: $f l o o r (b a s e + f a c t o r * d e a l t_{d} a m a g e)$ .
    - The final value may be negative, causing the item to be repaired.
    - Format:
      - threshold - non-negative float
        The minimum amount of damage dealt by the attack before item damage is applied to the item.
      - base - float
        Constant amount of damage applied to the item, if threshold is passed.
      - factor - float
        Fraction of the dealt damage that should be applied to the item, if threshold is passed.
  - block_sound
    - Sound event (optional).
    - If specified, this sound will be played when an attack is successfully blocked.
  - disable_sound
    - Sound event (optional).
    - If specified, this sound will be played when the item goes on its disabled cooldown due to an attack.

break_sound component
- When present, this sound will be played when the item runs out of durability and breaks.
- If not present, no sound will be played on break.
- This component is present by default on every item type.
- Format: sound event
  - e.g. break_sound='item.wolf_armor.break'

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

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

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

Language

Added support for Kyrgyz language.

Tags

Added the #can_wear_horse_armor entity tag.
- Contains entity that can hold horse armor in their body slot.

Changes[edit | edit source]

Items[edit | edit source]

Crossbows

Will now show all charged projectiles in their tooltip instead of just the first

Command format[edit | edit source]

SNBT

SNBT (textual representation of NBT-like data) has been expanded to accept heterogenous lists, i.e. ones where elements are not of the same type.
NBT format is not changed
- If SNBT command argument transforms value to NBT (like arguments of /data or /summon), lists might be transformed to bypass NBT constraints
  - Example transform: ['a', {'b':3}] is stored as [{'':'a'},{'b':3}]
- This transform is not reversed by /data

General[edit | edit source]

Advancement definition

The field background no longer contains textures/ prefix and .png suffix.

Atlas

minecraft:paletted_permutations sprite source
- New field:
  - separator
    - Optional string (default: _).
    - Value to be used when joining texture and permutation names to produce sprite name.

Data component format

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

hide_tooltip component
- Has been removed and replaced by use of the tooltip_display component and hide_tooltip field.

attribute_modifiers component
- Removed the show_in_tooltip field, replaced by tooltip_display component.
- This component now always uses its simplified form, with the modifiers field inlined to top-level.
  - e.g. attribute_modifiers={modifiers:[...]}] -> attributes_modifiers=[...]

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

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

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

jukebox_playable component
- Removed the show_in_tooltip field, replaced by tooltip_display component.

trim component
- Removed the show_in_tooltip field, replaced by tooltip_display component.

unbreakable component
- Removed the show_in_tooltip field, replaced by tooltip_display component.

weapon component
- can_disable_blocking field was replaced with disable_blocking_for_seconds.
- disable_blocking_for_seconds
  - Non-negative float (default: 0)
  - If non-zero, will disable a blocking Shield on successful attack for the specified amount of seconds.

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

Data pack

The pack format version is now 64.
Trim pattern and trim material items are no longer specified in the trim registries, but instead in the recipes and items respectively.
The potion entity type has been split into splash_potion and lingering_potion
Filled Maps without any map_id component no longer show an 'Unknown Map' tooltip (invalid IDs will still produce this tooltip)

Entity variant components

Cat and Frog variants are now data-driven.
Added uniform way to define variant selection rules.

Items model definition

Select Property
- minecraft:component
  - If the selected value comes from a registry and the current datapacks does not provide it, the entry will be silently ignored.
    - In previous snapshot, unrecognized elements caused the whole item model to be ignored.

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

Loot Functions

toggle_tooltips
- Now supports any component id in the toggles map.
- Any component specified will be toggled in the tooltip_display component.

Particle format

The particle type tinted_leaves now has a parameter:
- color
  - Tint color, specified either as packed int or list of 4 floats.

Recipes

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

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

Resource pack

The pack format version is now 49.

Reversion of bug fixes

“	After consideration, we have decided to revert both fixed bugs. While we do want to revisit these mechanics in the future, it's clear that these recent fixes alone didn't quite hit the mark and caused too many negative side-effects for parkour, speedbridging, and movement in general.	„
	— Developer's Note

The reverted bug fixes include:

MC-152728 — The player continues sprinting when performing actions that slow them down
MC-271065 — Diagonal movement is not normalized when crouching or using certain items

Tags

Renamed #bypasses_shield damage type tag to #bypasses_blocking.
Removed #default_spawns and #full_moon_spawns cat variant tags.
Added test_block, and test_instance_block to the #dragon_immune, and #wither_immune block tags.

Uniform variant selection

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

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

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

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

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

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

Fixes[edit | edit source]

47 issues fixed

From released versions before 1.21

MC-98271 – The sound of blocking with a shield is only hearable by other players (not the person blocking).
MC-101556 – Nether Portal teleport range is too large (equivalent to a full block).
MC-165421 – Bubble columns have the opposite effect on wind charges.
MC-165461 – Crossbow loading animation stops after loading, even when still holding down right click.
MC-176233 – Crossbows no longer have a transition after loading.
MC-200311 – Advancement background texture referencing is inconsistent with models.
MC-255756 – When the shield is broken between players, the attacking side has no shield breaking sound.
MC-279646 – Toggling fullscreen with F11 does not visually update the fullscreen option in the video settings menu.

From 1.21.1

MC-276061 – Decorated pot sherds don't visually update until relog when replacing with blank pot.

From 1.21.3

MC-278400 – Arrows and tridents move after hitting a block in flowing lava.

From 1.21.4

MC-279653 – Block Entity Data desynchronizes after subsequent setblock commands.

From the 1.21.5 development versions

MC-279217 – Arrows and tridents constantly spin after hitting a block in flowing lava.
MC-279218 – The minecraft:enchant.thorns.hit sound does not play when mobs or players are killed by the Thorns enchantment.
MC-279225 – Players jitter and land slightly too high up when landing on powder snow while wearing leather boots.
MC-279232 – SNBT text components prevent mixing text styles in lists.
MC-279389 – The minecraft:entity.arrow.hit_player sound is played when player is hit by an arrow shot by himself.
MC-279454 – hide_additional_tooltip no longer hides author and generation on written books.

From the previous development version

MC-279480 – The "test_instance_block.reset_success" string incorrectly spells the word "succeeded" as "succeded".
MC-279481 – Leaf litter no longer generates in forests or wooded badlands.
MC-279482 – Elements within the test block and test instance block menus are not selected in order when using the TAB key.
MC-279483 – Test blocks set to start mode show the "Message:" text despite no text field being present.
MC-279485 – Test block and test instance block menus have blurred backgrounds.
MC-279486 – Some strings displayed within the test instance block interface are untranslatable.
MC-279487 – The "Test Instance ID" and "Test Structure Size" text within the test instance block interface are positioned too far to the right.
MC-279488 – Leaf litter generates very sparsely in Dark Forests.
MC-279489 – An unexpected error occurs when attempting to create tests with large sizes.
MC-279490 – No command feedback messages are displayed when attempting to reset tests that don't exist.
MC-279491 – The "commands.test.no_tests" raw translation key is displayed when using "/test run..." commands in situations where no tests exist.
MC-279492 – An unexpected error occurs when attempting to locate tests that don't exist.
MC-279493 – No command feedback messages are displayed when using the "/test create" command.
MC-279498 – Test blocks and test instance blocks aren't part of the "#minecraft:dragon_immune" or "#minecraft:wither_immune" tags.
MC-279502 – Axolotl variants are no longer saved when bucketing.
MC-279504 – "minecraft:enchantments" component does not work on the select property of Item Models.
MC-279505 – Horse-esque mobs that disallow horse armor still show an non-interactive slot.
MC-279511 – Using "minecraft:always_pass" while the player is inside the test zone breaks the world.
MC-279518 – Test environment accepts minecraft:raining instead of minecraft:weather.
MC-279519 – Some words within some test command strings are always pluralized.
MC-279522 – GameTest entrypoint doesn't load zip datapacks.
MC-279527 – GameTest entrypoint doesn't load custom tests from datapacks.
MC-279538 – The key name of the test instances field that represents the namespaced ID of the test environment is different from the changelog.
MC-279539 – Villager variant is not applied to spawned zombie villagers.
MC-279553 – Players using items no longer turn their body in the moving direction while moving diagonally.
MC-279570 – Some piston operations don't send neighbor updates.
MC-279573 – The "test_instance_block.error.no_test" string is missing the word "no".
MC-279588 – Test instance field typo 'sky_accesss'.
MC-279599 – /test pos is offset by one on the y and z axis.
MC-279601 – "test.error.expected_entity_at_pos" translation is missing.