Minecraft:Java Edition 25w04a

25w04a is the third Minecraft:snapshot for Minecraft:Java Edition 1.21.5, released on January 22, 2025,<ref>Template:Snap</ref> which adds new data components and fixes bugs.

Additions

General

Minecraft:Data component format

• Template:Cd component
  • When present, this item can be used like a Shield to block attacks to the holding player.
  • Format: object with fields
    • Template:Cd
      • Non-negative float (default: Template:Cd).
      • The number of seconds that right-click must be held before successfully blocking attacks.
    • Template:Cd
      • Non-negative float (default: Template:Cd).
      • Multiplier applied to the number of seconds that the item will be on cooldown for when attacked by a disabling attack (Template:Cd on the Template:Cd component).
      • If Template:Cd, this item can never be disabled by attacks.
    • Template:Cd
      • 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:
        • Template:Cd - 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.
        • Template:Cd - float
          • Constant amount of damage to be blocked.
        • Template:Cd - float
          • Fraction of the dealt damage that should be blocked.
    • Template:Cd
      • 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: <math>floor(base + factor * dealt_damage)</math>.
      • The final value may be negative, causing the item to be repaired.
      • Format:
        • Template:Cd - non-negative float
          • The minimum amount of damage dealt by the attack before item damage is applied to the item.
        • Template:Cd - float
          • Constant amount of damage applied to the item, if threshold is passed.
        • Template:Cd - float
          • Fraction of the dealt damage that should be applied to the item, if threshold is passed.
    • Template:Cd
      • Sound event (optional).
      • If specified, this sound will be played when an attack is successfully blocked.
    • Template:Cd
      • Sound event (optional).
      • If specified, this sound will be played when the item goes on its disabled cooldown due to an attack.

• Template:Cd 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'

• Template:Cd 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'

• Template:Cd 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 Template:Cd tag.
    • As such, the trim material registry definition no longer specifies an item.
  • Format: trim material id
    • e.g. provides_trim_material='minecraft:iron'

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

Minecraft:Language

• Added support for Kyrgyz language.

Minecraft:Tags

• Added the Template:Cd entity tag.
  • Contains entity that can hold horse armor in their body slot.

Changes

Items

Minecraft:Crossbow

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

Command format

Minecraft: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 Template:Cmd or Template:Cmd), lists might be transformed to bypass NBT constraints
    • Example transform: Template:Cd is stored as Template:Cd
  • This transform is not reversed by Template:Cmd

General

Minecraft:Advancement definition

• The field Template:Cd no longer contains Template:Cd prefix and Template:Cd suffix.

Minecraft:Atlas

• Template:Cd sprite source
  • New field:
    • Template:Cd
      • Optional string (default: Template:Cd).
      • Value to be used when joining texture and permutation names to produce sprite name.

Minecraft:Data component format

• Template:Cd component
  • Has been removed and replaced by use of the Template:Cd component and Template:Cd field.
    • The following components previously covered by the Template:Cd component may need to be hidden:
      • Template:Cd
      • Template:Cd
      • Template:Cd
        • Specifically, Mob Spawner and Trial Spawner block entity data will display the configured mob.
      • Template:Cd
        • Specifically, the Template:Cd property will be displayed in the tooltip for any item with this specified.
      • Template:Cd
      • Template:Cd
      • Template:Cd
      • Template:Cd
      • Template:Cd
      • Template:Cd
      • Template:Cd
      • Template:Cd
      • Template:Cd
      • Template:Cd
      • Template:Cd
      • Template:Cd
      • Template:Cd
    • 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 Template:Cd component, any of the above listed components also present on the same item will be added to the list to hide in Template:Cd.

• Template:Cd component
  • Has been removed and replaced by use of the Template:Cd component and Template:Cd field.

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

• Template:Cd component
  • Removed the Template:Cd field, replaced by Template:Cd 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]

• Template:Cd and Template:Cd components
  • Removed the Template:Cd field, replaced by Template:Cd 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'}]

• Template:Cd and Template:Cd components
  • Removed the Template:Cd field, replaced by Template:Cd 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}]

• Template:Cd component
  • Removed the Template:Cd field, replaced by Template:Cd component.

• Template:Cd component
  • Removed the Template:Cd field, replaced by Template:Cd component.

• Template:Cd component
  • Removed the Template:Cd field, replaced by Template:Cd component.

• Template:Cd component
  • Template:Cd field was replaced with Template:Cd.
  • Template:Cd
    • Non-negative float (default: Template:Cd)
    • 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:
  • Template:Cd - any entity.
  • Template:Cd - Lingering Potion to Area Effect Cloud.
  • Template:Cd - Lingering Potion to Area Effect Cloud.

Minecraft:Data pack

• The Minecraft:pack format version is now Template:Cd.
• Trim pattern and trim material items are no longer specified in the trim registries, but instead in the recipes and items respectively.
• The Template:Cd entity type has been split into Template:Cd and Template:Cd
• Filled Maps without any Template:Cd 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.

Minecraft:Items model definition

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

Loot Functions

• Template:Cd
  • Now supports any component id in the toggles map.
  • Any component specified will be toggled in the Template:Cd component.

Minecraft:Particle format

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

Minecraft:Recipes

• Template:Cd recipe type
  • The Template:Cd ingredient field is no longer optional
    • Previously, if no base ingredient was given, the recipe would parse but never be usable.

• Template:Cd recipe type
  • The Template:Cd, Template:Cd, and Template:Cd ingredient fields are no longer optional.
    • Previously, if these ingredients were not given, the recipe would parse but never be usable.
  • Added new Template:Cd 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"

Minecraft:Resource pack

• The Minecraft:pack format version is now Template:Cd.

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.

The reverted bug fixes include:

• Template:Bug
• Template:Bug

Minecraft:Tags

• Renamed Template:Cd damage type tag to Template:Cd.
• Removed Template:Cd and Template:Cd cat variant tags.
• Added Template:Cd, and Template:Cd to the Template:Cd, and Template:Cd block tags.

Uniform variant selection

• Variants that have spawn rules now use uniform approach for selecting.
  • Selection process:
    • Every variant field Template:Cd 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:
    • Template:Cd - integer
    • Template:Cd - optional structure
      • Fields:
        • Template:Cd
        • Additional fields dependent on Template:Cd.
      • If field is not present, condition is always true.

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

• Wolf Variants
  • The fields Template:Cd, Template:Cd and Template:Cd have been grouped in field Template:Cd and renamed to Template:Cd, Template:Cd and Template:Cd.
  • Added the field Template:Cd.

• Pig Variants
  • Template:Cd and Template:Cd fields are replaced with Template:Cd and Template:Cd respectively.
  • Fields in file:
    • Template:Cd - namespaced id for this variant asset, resolves to Template:Cd.
    • Template:Cd - field described in uniform variant selection above

• Cat variants
  • Cat variants can be data-driven by adding entries to Template:Cd.
  • This feature is experimental.
  • Fields in file:
    • Template:Cd - namespaced id for this variant asset, resolves to Template:Cd.
    • Template:Cd - field described in uniform variant selection above

• Frog variants
  • Frog variants can be data-driven by adding entries to Template:Cd.
  • This feature is experimental.
  • Fields in file:
    • Template:Cd - namespaced id for this variant asset, resolves to Template:Cd.
    • Template:Cd - field described in uniform variant selection above