Java Edition 1.21.4

Minecraft 1.21.4
Edition	Java Edition
Official name	The Garden Awakens
Release date	December 3, 2024
Development versions	Snapshots (3) ; Pre-releases (3) ; Release candidates (3) ; (View all)
Downloads	Client (.json); Server
Obfuscation maps	Client; Server
Protocol version	769
Data version	4189
Resource pack format	46
Data pack format	61
Minimum Java version	Java SE 21
◄ 1.21.3	1.21.5 ►

There is a guide for this update!

See Java Edition guides/The Garden Awakens for a guide to all of the new features introduced in The Garden Awakens.

1.21.4, the release of The Garden Awakens, is a game drop for Java Edition, released on December 3, 2024.^[1] It adds the creaking, the Pale Garden, and pale oak wood, and fixes bugs.

Additions

1.21.4 block and item additions

Blocks

Creaking Heart

A creaking heart is a “living” block generating in pale oak trees, covered on all sides by pale oak wood logs.
Can be found activated in the pale garden biome.
Only activates when placed between two pale oak logs in the same orientation and can't be deactivated unless the block is broken.
- Emits subtle eerie sounds when it is active and surrounded by any types of logs, stripped logs, wood, or stripped wood on all 6 directions.
Sends a trail of particles towards the connected creaking when the creaking gets hit by the player or projectiles.
- Particle speed is affected by the distance of the creaking from the heart block.
- Attacking a creaking causes its creaking heart to exude 2 to 3 resin clumps.
Mining the block is most efficiently done with an axe, but it only drops when using a Silk Touch tool.
- When the creaking heart block is destroyed, the connected creaking is removed.
- Naturally placed creaking hearts drop 20-24 experience when broken by a player, with or without Silk Touch.
  - A naturally spawned creaking heart does not drop experience when broken in Creative mode.
- Breaking a creaking heart block drops 1–3 resin clumps, and it is affected by Fortune enchantment.
Can also be crafted using 2 pale oak logs and a block of resin.

Eyeblossom

New flowers that generate in the pale garden biome.
- They exist in two variants: closed and open.
- Eyeblossoms transition between the two variants based on the time of day.
  - During the night, eyeblossoms become open.
  - During the day, they become closed.
- In dimensions that do not have a day/night cycle, they remain as-is.
- Eyeblossoms planted on the ground communicate with each other, helping each other to open or close.
- Open eyeblossoms have glowing eyes during the night.
- Can be obtained by bonemealing the grass in the pale garden biome or bonemealing an existing eyeblossom.
- Bees get poisoned if they are fed eyeblossoms.
- Suspicious stew made from eyeblossom has Blindness or Nausea effect depending on the variant.
- Gray or orange dye can be crafted from closed and open eyeblossoms, respectively.
- Wandering traders can sell open eyeblossoms.

Pale Hanging Moss

Generates naturally in the pale garden biome under the foliage of pale oaks.
- Does not grow randomly, but can be bonemealed to grow down.
When attached to a pale oak log or leaves, it emits ambient sounds.
It only drops when using shears or a tool enchanted with Silk Touch.
- Breaks instantly when mined.
Can be sold by the wandering trader.

Pale Moss Block

Generates naturally in the pale garden biome.
- Pale moss blocks can be bonemealed to spread to compatible blocks.
Can be sold by the wandering trader.

Pale Moss Carpet

Generates naturally in the pale garden biome.
- When placed, pale moss carpet grows up to two blocks on the solid faces of any block that borders it.
- Pale moss carpet can be bonemealed to grow to full on all solid faces of any block that borders it.

Pale Oak Leaves

A new type of leaves, generated in pale oak trees.
Emits gray (color) pale_oak_leaves particles falling underneath, similar to cherry leaves.

Pale Oak Log

A new type of log, generated as a part of pale oak trees.
Can be crafted into pale planks and wood.
Has a stripped log variant, wood variant and stripped wood variant.
- The stripped variant can be used to craft hanging signs.

Pale Oak Planks

Crafted from pale oak logs.
Can be used to craft respective buttons, doors, fences, fence gates, pressure plates, signs, slabs, stairs, and trapdoors.
Can be used to craft pale oak boats and pale oak boats with chests.
Can be used to craft wooden blocks or items (e.g. chest and sticks)

4

Pale Oak Sapling

A new type of sapling which grows into a pale oak tree when planted.
Drops underneath pale oak leaves.
Can be sold by the wandering trader.
Can break off a fully grown one and plant it to grow a pale oak tree.
Can be placed in flower pots.

Resin Clump

A multi-face block.
Dropped by the creaking heart when it is destroyed.
Placed around the creaking heart when its creaking is attacked.
Can be crafted into a block of resin.
Can be hardened into resin brick items in a furnace.
Can be found in loot chests in woodland mansions.
Can be placed on any full face of a neighboring block.
Can be waterlogged.

Block of Resin

Crafted from resin clump.
Can be used to craft a creaking heart using two pale oak logs.

Resin Bricks

Crafted from resin brick.
Can be used to craft chiseled, slabs, stairs, and walls variants.
Mining the block is most efficiently done with a pickaxe.

Items

Resin Brick

Can be smelted from resin clump items in a furnace.
Can be used to craft resin bricks.
Can be used to trim armor.

Ingredients	Smelting recipe
Resin Clump + Any fuel

Spawn Eggs

Creaking spawn egg.

Mobs

Creaking

Spawns at night in the pale garden biome if there is a creaking heart block that has been generated in a pale oak tree.
- Is not affected by light levels but spawns and despawns based on day/night cycle.
- There's a variation in how long time it takes for each creaking heart to spawn a creaking.
The creaking heart may decide to remove or replace its associated creaking when:
- It turns day.
- The creaking is too far away from the heart.
- A player intersects with the creaking for a few seconds.
The melee attacks deal 3HP damage.
It follows and attacks players up to 32 blocks away from its creaking heart block.
- An activated creaking doesn't move if a player in Survival or Adventure mode is looking at it.
  - Creakings also have full knockback resistance in that state.
- A player wearing a carved pumpkin on their head can look at a creaking without it freezing in place.
The following characteristics apply for naturally spawning creaking:
- Reacts only to damage caused by mobs and projectiles, by swaying in place.
- Ignores cactus, sweet berry bushes and powder snow damage and can walk through/over them.
- Has a twitching animation.
- Is fire-resistant.
- When hit, a particle trail is shown between the creaking and the creaking heart block it is connected to.
- When the creaking heart block the creaking is connected to is destroyed, the creaking is removed, with no loot or experience dropped from the mob.
Cannot enter boats.
Creaking spawned from a creaking heart cannot go through portals.
The creaking spawn egg spawns a creaking mob that is not connected to a creaking heart. This creaking mob persists through day and night, loads and saves, and takes damage from attacks and other damage sources.
- Has 1HP health point.
- A creaking summoned from the creaking heart cannot be spawned with a spawn egg or summoned with commands, but can only exist as a part of the creaking heart block.
Their eyes are visible when they have the Invisibility effect.

Non-mob entities

Pale Oak Boat

A new type of boat, crafted with pale oak planks.
Can be used to craft a variant with a chest.

World generation

Pale oak

A new type of tree which can be grown from pale oak saplings in a 2x2 configuration.
- Generates naturally in the pale garden biome.
Player grown pale oak trees grow without any decorations.
Naturally generated pale oak trees have pale hanging moss hanging from the foliage, pale moss patches on the ground, and creaking heart blocks can generate in them.

Pale garden

A new biome which contains pale oaks and pale moss blocks/carpet.
It is a variation of the dark forest biome, with pale oak trees instead of dark oak trees.
Animal mobs do not spawn naturally.
The grass in the pale garden has a desaturated, grayish look, the sky is a smoky gray, and water is a pale light blue.
- Any tinted leaves places in the biome also get a desaturated, gray look.
Has no music, and currently playing music gradually fades out if the player enters one.
A particle is emitted in the pale garden.

Pale moss patch

Vegetation patch feature consisting of pale moss and other plants found in the pale garden.

General

New language

Added support for Popoloca language.

Changes

Blocks

Bells, Lanterns, Soul Lanterns, Copper doors, Iron Doors, Heavy Weighted Pressure Plates, Light Weighted Pressure Plates, Polished Blackstone Pressure Plates, Stone Pressure Plates and Brewing Stands

Now drop when broken with any tool.

Ender Chests

Now drops obsidian when mined with an incorrect tool.

Nether Bricks

Changed the texture of normal, chiseled, cracked and red nether bricks to match the pattern of other brick blocks.

Sculk Sensors

Are now activated from resin clumps being placed by a creaking heart, with a frequency of 13.

Items

Elytra

A subtitle for flying has been added.
Opening your elytra, along with other things like crouching, ends your sprint.

Spawn Eggs

Similar to block items, spawn eggs for entities that could execute operator-only commands now have a warning in tooltip.

Suspicious Stew

Changed durations of the suspicious stew effects to match Bedrock Edition:
- Fire Resistance: 3 seconds
- Blindness: 11 seconds
- Weakness: 7 seconds
- Regeneration: 7 seconds
- Jump Boost: 5 seconds
- Wither: 7 seconds
- Poison: 11 seconds

Mobs

General

The way mobs decide to replace their equipped items with items on the ground was changed.
- If the item belongs in an armor slot, replace the item if any of the following conditions apply.
  - The new item has a higher base armor value.
  - The new item has a higher base armor toughness value.
  - The new item has more enchantments.
  - The new item is less damaged.
  - The new item has a custom name while the old one doesn't.
- If the item belongs in the main hand slot, replace the item if any of the following conditions apply.
  - The new item is a preferred weapon while the old one isn't.
    - If the old item is a preferred weapon while the new item isn't, do not replace the item.
  - The new item has a higher base damage value.
  - The new item has more enchantments.
  - The new item is less damaged.
  - The new item has a custom name while the old one doesn't.

Baby Cats and Wolves

Now get a collar with the color that is a mix between the parents collar color if possible.

Bees

Instead of breeding, they get withered when fed wither roses, and poisoned by open eyeblossoms– both of these do not anger bees.
- Bees aren't poisoned by or attracted to closed eyeblossoms, and can not interact with closed eyeblossoms.
Leashed bees no longer enter beehives or bee nests.

Drowned

Prefer to pick tridents from the ground as opposed to other items.

Pillagers and Piglins

Prefer to pick crossbows from the ground as opposed to other items.

Skeletons, Strays and Bogged

Prefer to pick bows from the ground as opposed to other items.

Non-mob entities

Experience orb

Physics were changed. They are now bouncy when falling from a height.^[2]

World generation

Woodland mansions

Loot chests can now contain resin clumps.

Gameplay

Damage

Players no longer receive 3 seconds of damage immunity when spawning, respawning, or joining a world or server.

Effects

Water Breathing and Conduit Power effects now increase the oxygen while underwater instead of only preventing it from decreasing.

General

Title screen

The panorama was changed to showcase pale gardens.

Technical

Additions

General

Entity format

Added optional field explosion_speed_factor that controls the amount of added damage depending on the speed of the minecart.
- Default value: 1.0.

Items model definitions

minecraft:banner special model type.
- Renders a banner with patterns from minecraft:banner_patterns component.
- Fields:
  - color - color of banner base, one of 16 predefined colors.

minecraft:bed special model type.
- Renders a whole bed.
- Fields:
  - texture - namespaced ID for texture, without textures/entity/bed/ prefix and .png suffix.

minecraft:block_state property.
- Returns value for some property from minecraft:block_state component.
- Fields:
  - block_state_property - string key to select from component.
- Values: any string.

minecraft:broken boolean property.
- Returns true if the item is damageable and has only one use remaining before breaking.
- No fields.

minecraft:bundle/fullness numeric property.
- Returns weight of bundle_contents component or 0 if not present.
- No fields.

minecraft:bundle/has_selected_item boolean property.
- Returns true if bundle is "open", i.e. it has selected item visible in GUI.
- No fields.

minecraft:bundle/selected_item item model type.
- Renders selected stack in minecraft:bundle_contents component, if present, otherwise does nothing.

minecraft:carried boolean property.
- Returns true if item is carried between slots in GUI.
- No fields.

minecraft:charge_type property.
- Returns charge type stored in minecraft:charged_projectiles component.
- No fields.
- Values:
  - none - if there are no projectiles or component is not present.
  - rocket - if there is at least one firework rocket.
  - arrow - any other case.

minecraft:chest special model type.
- Renders a single chest.
- Fields:
  - texture - namespaced ID for texture, without textures/entity/chest/ prefix and .png suffix.
  - openness - float, 0.0 (default) - fully closed, 1.0 - fully open.

minecraft:compass numeric property.
- Returns angle, scaled to 0..1 in x-z plane between holder position and target.
- If target is not valid (not present, in other dimension or to close to holder position) random value is returned.
- Fields:
  - target - one of:
    - spawn - points at world spawn.
    - lodestone - points at location stored in lodestone_tracker component.
    - recovery - points at last player death location.
    - none - always returns an invalid target.
  - wobble - if true, value oscillates for some time around target before settling.
    - Default: true

minecraft:composite item model type.
- Renders multiple sub-models.
- All models are rendered in the same space.
- Fields:
  - models: a list of item models to render.

minecraft:condition item model type.
- Renders an item model depending on boolean property.
- Fields:
  - property: type of property.
  - <property-specific> - additional fields depending on property type, added inline.
  - on_true - item model to render when property is true.
  - on_false - item model to render when property is false.

minecraft:conduit special model type.
- Renders a conduit.
- No fields.

minecraft:constant tint source type.
- Returns a constant RGB color.
- Fields:
  - value - A packed integer RGB value (e.g. -1) or an array of RGB values (e.g. [ 1, 1, 1 ]).

minecraft:context_dimension property type.
- Returns the ID of the dimension in context, if any.
- No fields.
- Values: namespaced dimension ID (like minecraft:overworld).

minecraft:context_entity_type property type.
- Returns holding entity type, if present.
- No fields.
- Values: namespaced entity type ID.

minecraft:cooldown numeric property.
- Returns remaining cooldown for item, scaled to 0..1.
- No fields.

minecraft:count numeric property.
- Returns stack size.
- Fields:
  - normalize: boolean.
    - Default: true
    - If true, returns count divided by max_stack_size component, clamped to 0..1.
    - If false, returns count clamped to 0..max_stack_size.

minecraft:crossbow/pull numeric property.
- Returns crossbow-specific use time.
- No fields.

minecraft:custom_model_data boolean property.
- Returns value from flags list in minecraft:custom_model_data component.
- Fields:
  - index - index for field in flags.
    - Default: 0

minecraft:custom_model_data numeric property.
- Returns value from floats list in minecraft:custom_model_data component.
- Fields:
  - index - index for field in floats.
    - Default: 0

minecraft:custom_model_data property.
- Returns value from strings list in minecraft:custom_model_data component.
- Fields:
  - index - index for field in strings.
    - Default: 0
- Values: any string.

minecraft:custom_model_data tint source type.
- Returns value from colors list in minecraft:custom_model_data component.
- Fields:
  - index - index for field in colors.
    - Default: 0

minecraft:damage numeric property.
- Returns value for damage component.
- Fields:
  - normalize: boolean
    - Default: true
    - If true, returns value of damage divided by max_damage component, clamped to 0..1.
    - If false, returns value of damage, clamped to 0..max_damage.

minecraft:damaged boolean property.
- Returns true if the item is damageable and has been used at least once.
- No fields.

minecraft:decorated_pot special model type.
- Renders a decorated pot.
- Uses values from minecraft:pot_decorations component.
- No fields.

minecraft:display_context property.
- Returns context this item is rendered in.
- No fields.
- Values:
  - none
  - thirdperson_lefthand
  - thirdperson_righthand
  - firstperson_lefthand
  - firstperson_righthand
  - head
  - gui
  - ground
  - fixed

minecraft:dye tint source type.
- Returns value from minecraft:dyed_color component or default if not present.
- Fields:
  - default - RGB value.

minecraft:empty item model type.
- Does not render anything.
- No fields.

minecraft:extended_view boolean property
- Returns true if player has requested extended details by holding shift key down.
  - Note: not a keybind, can't be rebound.
- Only works when item is displayed in UI.
- No fields.

minecraft:firework tint source type.
- Returns average of colors from minecraft:firework_explosion component or default color if there are none.
- Fields:
  - default: RGB value.

minecraft:fishing_rod/cast boolean property.
- Returns true if there is a fishing bobber attached to currently used fishing rod.
- No fields.

minecraft:grass tint source type.
- Returns grass color at specific climate parameters, based on textures/colormap/grass.png.
- Same colors as ones selected by downfall and temperature in biome configuration.
- Fields:
  - temperature - float in 0..1 (inclusive) range.
  - downfall - float in 0..1 (inclusive) range.

minecraft:hanging_sign special model type.
- Renders a hanging sign.
- Fields:
  - wood_type - one of oak, spruce, birch, acacia, cherry, jungle, dark_oak, pale_oak, mangrove, bamboo, crimson, warped.
  - texture - optional namespaced ID for texture, without textures/entity/signs/hanging/ prefix and .png suffix.
    - If not present, it is derived from wood_type.

minecraft:has_component boolean property.
- Returns true if the given component is present on the item.
- Fields:
  - component - component type.
  - ignore_default - if default component value should be handled as "no component".
- Default: false.

minecraft:head special model type.
- Renders a head.
- Uses profile from minecraft:profile component when applicable.
- Fields:
  - kind - one of skeleton, wither_skeleton, player, zombie, creeper, piglin, dragon.
  - texture - optional namespaced ID for texture, without textures/entity/ prefix and .png suffix.
    - If absent, default texture is used, depending on kind of field.
    - Additionally, if present, minecraft:profile component is ignore.
  - animation - float controlling head animation (e.g. piglin ears or ender dragon jaw).
    - Default: 0.0

minecraft:keybind_down boolean property.
- Returns true if keybind is currently active.
- Fields:
  - keybind - keybind ID, same as value in keybind text component.

minecraft:local_time property.
- Returns the current time formatted according to a given pattern.
- The value is updated every second.
- For full format documentation for locale, time zone and pattern, see ICU (International Components for Unicode) documentation.
- Fields:
  - locale - optional value describing locale
- Examples:
  - en_US: English language (used for things like week names), formating as in USA.
  - cs_AU@numbers=thai;calendar=japanese: Czech language, Australian formatting, Thai numerals and Japanese calendar.
- Default value is "", which means "root" locale (a set of defaults, including English names)
  - time_zone - optional value describing time zone.
    - If not present, defaults to timezone set on client.
    - Examples:
      - Europe/Stockholm.
      - GMT+0:45.
  - pattern - describes format to be used for time formatting
    - Examples:
      - yyyy-MM-dd - 4-digit year number, then 2-digit month number, then 2-digit day of month number, all zero-padded if needed, separated by -.
      - HH:mm:ss - current time (hours, minutes, seconds), 24-hour cycle, all zero-padded to 2 digits of needed, separated by :.
- Values: any string.

minecraft:main_hand property.
- Returns main hand of holding player.
- No fields.
- Values: left, right

minecraft:map_color tint source type.
- Return value from minecraft:map_color component or default color if component is not present.
- Fields:
  - default: RGB value.

minecraft:model item model type.
- Renders a plain model from models directory.
- Fields:
  - model: namespaced ID of model in models (like minecraft:block/yellow_glazed_terracotta)
  - tints: a list of tint sources to apply to elements of rendered model (first entry applies to tintindex 0, second one - 1, etc.)
- Format:
  - type: type of tint source (see below)
  - <type-specific> - additional fields depending on tint source type.

minecraft:potion tint source type.
- Returns color from minecraft:potion_contents component:
  - If component is present:
    - custom color, if there is one present in component.
    - default color, if effect list is empty.
    - average of effect colors, otherwise.
  - Default color, otherwise.
- Fields:
  - default: RGB value.

minecraft:range_dispatch item model type.
- Renders an item model based on numeric property.
- Replacement for old overrides section from block models.
- Selects last entry with threshold less or equal to property value.
- Fields:
  - property: type of property.
  - <property-specific> - additional fields depending on property type.
  - scale - factor to multiply property value with.
    - Default: 1.0
  - entries - list of entries in format:
    - threshold - float value.
    - model - item model to render when entry is selected.
    - Note: order of fields does not matter, list is sorted by threshold in ascending order before use.
  - fallback - item model to render if no entries were less or equal to property value.
    - If not present, placeholder "missing" model is rendered instead.

minecraft:select item model type.
- Renders an item model based on discrete property.
- Fields:
  - property: type of property.
  - <property-specific> - additional fields depending on property type, added inline.
  - cases - list of cases to match in format:
    - when - value to match against property, type depends on property.
      - Could be a single value or a list of values.
    - model - item model to render when case is selected.
  - fallback - item model to render if none of the cases matched the value.
    - If not present, placeholder "missing" model is rendered instead.

minecraft:selected boolean property
- Returns true if item is selected on a hotbar.
- No fields.

minecraft:shield special model type.
- Renders a shield.
- Uses patterns from minecraft:banner_patterns component and color from minecraft:base_color component.
- No fields.

minecraft:shulker_box special model type.
- Renders a shulker box.
- Fields:
  - texture - namespaced ID for texture, without textures/entity/shulker/ prefix and .png suffix.
  - openness - float, 0.0 (default) - fully closed, 1.0 - fully open.
  - orientation - orientation for rendering.
    - Default: up

minecraft:special item model type.
- Renders a special (not data-driven) model.
- Fields:
  - model: special model instance.
    - Format:
      - type - type of special model.
      - <type-specific> - additional fields depending on tint source type.
  - base: namespaced ID of model in models, providing transformations, particle texture and GUI light.

minecraft:standing_sign special model type.
- Renders a standing sign.
- Fields:
  - wood_type - one of oak, spruce, birch, acacia, cherry, jungle, dark_oak, pale_oak, mangrove, bamboo, crimson, warped.
  - texture - optional namespaced ID for texture, without textures/entity/signs/ prefix and .png suffix.
    - If not present, it is derived from wood_type.

minecraft:team tint source type.
- Returns team color of context entity, if any.
- Fields:
  - default - RGB value to return when there is no context entity, entity is not in a team or team has no color.

minecraft:time numeric property
- Returns value of day time (used for clock), scaled to 0..1.
- Fields:
  - wobble - if true, value oscillates for some time around target before settling.
    - Default: true
  - source - time source, possible values:
    - daytime - time of day
    - moon_phase - moon phase
    - random - random value

minecraft:trident special model type.
- Renders a trident.
- No fields.

minecraft:trim_material property.
- Returns value of material field from minecraft:trim component, if present.
- No fields.
- Values: namespaced ID.

minecraft:use_cycle numeric property.
- Returns remaining use ticks modulo period.
- Fields:
  - period - positive float.
    - Default: 1.0

minecraft:use_duration numeric property.
- Returns item use ticks.
- Fields:
  - remaining - if true, returned value is remaining use ticks, if false - ticks so far.
    - Default: false

minecraft:using_item boolean property.
- Returns true if player is currently using this item.
- No fields.

minecraft:view_entity boolean property.
- When not spectating, returns true if context entity is the local player entity, i.e. one controlled by client.
- When spectating, returns true if context entity is the spectated entity.
- If context entity is not present, returns false.
- No fields.

Raw JSON text format

Added optional shadow_color style field to text components, which overrides the shadow properties of text.
- Format:
  - A packed integer ARGB value (e.g. -1).
  - An array of RGBA values (e.g. [1, 1, 1, 1]).
- If specified as 0, the shadow is never displayed for this text.
- If specified as a non-zero value, the shadow is always displayed with this color.

Tags

Added the #bee_attractive block tag.
- Denotes all blocks that bees may pollinate.
Added #skeleton_preferred_weapons, #piglin_preferred_weapons, #pillager_preferred_weapons and #drowned_preferred_weapons item tags.
- For specifying preferred weapons types for these mobs when picking up items.
Added the #wither_skeleton_disliked_weapons item tag.
- For weapons that wither skeletons don't want to pick up.

Changes

Command format

/attribute

A subcommand to reset the base value of an attribute to its default value for the target entity was added. If the attribute does not exist on the entity, the command fails.
Syntax:
- /attribute <target> <attribute> base reset
Parameters:
- target: The entity to update the attribute for
- attribute: The attribute ID to update.
Suggestions are now shown for /attribute modifier IDs existing on the target in the /attribute command.

General

Biome effects

Have a new format for music using a weighted list.
- The list can be empty indicating no music should play in this biome.
Have a new optional field: music_volume.
- The game smoothly transitions between the current music volume and the new volume when entering the biome:

"music": [
    {
      "data": {
        "max_delay": 24000,
        "min_delay": 12000,
        "replace_current_music": false,
        "sound": "minecraft:music.overworld.forest"
      },
      "weight": 1
    }
  ],
  "music_volume": 1.0,

Block entity

Item blocks with minecraft:block_entity_data component now set block entity data only if id tag matches type of placed block entity.
- Additionally, a warning is added to item tooltip if placing such item might directly or indirectly lead to command execution with high permission level.

Client.jar

New entry point net.minecraft.client.data.Main is present in client jar, with similar command line structure as data generator in server jar.
- Available options: --client - generates assets directory.

Configured feature

The simple_block feature type has a new optional field: schedule_tick.
- If set to true, the block is scheduled to tick.

Data component format

minecraft:custom_model_data
- Now has more fields to accommodate new uses by various model property getters.
- Fields:
  - floats - list of floats.
  - flags - list of booleans.
  - strings - list of strings.
  - colors - list of RGB color values.

Data pack

The pack format version is now 61.
The tooltip warning on item blocks with the minecraft:block_entity_data component can no longer be hidden by any other component.
Field model in minecraft:equippable component has been renamed to asset_id.
Field item_model_index in trim_material registry has been removed (no longer needed for model rendering).
Removed the winter_drop feature flag and built-in data pack.
Renamed CookTime to cooking_time_spent.
Renamed CookTimeTotal to cooking_total_time.
Renamed BurnTime to lit_time_remaining.
Added the field lit_total_time representing the total time the furnace should be lit.

Dynamic textures

Player skin and cape textures are now produced in the debug folder if loaded.

Entity format

The TNTFuse field of TNT minecarts has been renamed to fuse.

Fonts

GNU Unifont
- Updated to version 16.0.01.

GUI sprites

The toast/system sprite layout has been updated to use standard nine-slicing functionality.
The toast/tutorial sprite is now scaled for taller toasts, and as such has nine-slice scaling in the default resource pack.
The advancements/box_obtained and advancements/box_unobtained GUI sprites are now configured to scale with nine-slicing.
Empty slot sprites, such as those for the armor slots in the inventory, have been renamed and moved from items into the gui/sprites/container/slot directory.
- empty_armor_slot_helmet -> helmet.
- empty_armor_slot_chestplate -> chestplate.
- empty_armor_slot_leggings -> leggings.
- empty_armor_slot_boots -> boots.
- empty_slot_sword -> sword.
- empty_slot_pickaxe -> pickaxe.
- empty_slot_axe -> axe.
- empty_slot_shovel -> shovel.
- empty_slot_hoe -> hoe.
- empty_slot_smithing_template_armor_trim -> smithing_template_armor_trim.
- empty_slot_smithing_template_netherite -> smithing_template_netherite_upgrade.
- empty_slot_amethyst_shard -> amethyst_shard.
- empty_slot_diamond -> diamond.
- empty_slot_emerald -> emerald.
- empty_slot_ingot -> ingot.
- empty_slot_lapis_lazuli -> lapis_lazuli.
- empty_slot_quartz -> quartz.
- empty_slot_redstone_dust -> redstone_dust.
The empty slot sprites in the loom have been split from their background and moved:
- container/loom/banner_slot -> container/slot/banner.
- container/loom/pattern_slot -> container/slot/banner_pattern.
- container/loom/dye_slot -> container/slot/dye.
The empty slot sprites in the brewing stand have been split from the container background:
- container/slot/brewing_fuel.
- container/slot/potion.
The empty slot sprites in the horse/llama inventories have been split from their background, cropped, and moved:
- container/horse/armor_slot -> container/slot/horse_armor.
- container/horse/llama_armor_slot -> container/slot/llama_armor.
- container/horse/saddle_slot -> container/slot/saddle.

Item models

New format has been introduced for describing item models. See Items model definition.
Item models are selected based on minecraft:item_model component.
- Model for item with item_model=foo:bar is stored in /assets/foo/items/bar.json.

Format of file is

{ 
  "model": {
    "type": <item model type>,
    <item model type specific fields>
  } 
}

overrides section has been removed from existing block models.
There are no longer any hardcoded paths in models directory - models are now only used if referenced by definitions in items or blockstates directories.
Models in models/item that only redirect to a block model have been removed.
- In such cases, the item model refers to the models/block model directly.
A new field has been added to the client-side item info format (i.e. files in /assets/*/items/*.json).
- hand_animation_on_swap - boolean field describing if down-and-up animation should be played in first-person view when item stack is changed (either type, count or components)
  - Default: true
  - Only value from new item is taken into account.
  - Does not control "pop" animation in GUI when item is picked or changes count.

Item modifiers

minecraft:set_custom_model_data
- Now has more fields to accommodate more complex component structure.
- Fields:
  - floats - optional list operation of number providers.
  - flags - optional list operation of boolean values.
  - strings - optional list operation of string values.
  - colors - optional list operation of RGB values or number providers.
- List operation uses same format as explosions field in set_fireworks modifier.
- For example
```
{
  "function": "set_custom_model_data",
  "floats": {
    "values": [2],
    "mode": "replace_all"
  }
}
```
  sets replaces floats with value 2.

Missing textures and models

If a model which the game uses directly (as opposed to template models) fails to specify a texture to use for particles, an error is now printed to the game log^[3].
If a model does not attempt to route a texture reference to an actual texture file, an error is logged once again^[4].

Particles

trail particle has a new required field: duration.
- Indicates, in ticks, how long the particle takes to fly from the start to the target.

Protocol

Client now sends the minecraft:player_loaded packet once the loading terrain screen has closed after initially loading into the world, and after closing the loading screen when respawning.

Resource pack

The pack format version is now 46.
Added the following new block models and textures:
- chiseled_resin_bricks
- closed_eyeblossom
- open_eyeblossom
  - Additionally uses open_eyeblossom_emissive texture layer.
- resin_block
- resin_bricks
- resin_clump
Added the following non-top-level block models:
- cross_emissive
- flower_pot_cross_emissive
Added the following new item models and textures:
- resin_brick
- resin_clump
Added new armor trim color palette: trims/color_palettes/resin.
Invalid minecraft:filled_map items in an item frame (map item without the map_id component) no longer change the size of the frame.
The equipment directory has been moved one level up, i.e. models/equipment/ becomes equipment/.
broken_elytra model and texture has been renamed to elytra_broken.
The UV mapping of the magma cube texture has been updated.
All blocks that previously rendered only block entity (banners, heads, beds, chests, conduits, decorated pots, shulker boxes and signs) now also render normal block model over it (same as existing behavior of bells, enchantment tables, etc.).
- Rendered block entity still can't be removed or data-driven, this change only affects previously ignored block models.

Server.jar

Data generator in server jar (net.minecraft.data.Main) no longer generates assets directory.
- --client option has been removed from command line for this entry point.

Tags

Added resin_bricks, resin_brick_slab, resin_brick_wall, resin_brick_stairs, and chiseled_resin_bricks to the #mineable/pickaxe block tag.
Added resin_brick_slab, resin_brick_stairs, and resin_brick_wall into the #slabs, #stairs, and #walls block and item tags respectively.
Added resin_clump to the #replaceable block tag.
Added resin_brick to the #trim_materials item tag.
Added potted_open_eyeblossom, and potted_closed_eyeblossom to the #flower_pots block tag.
Added open_eyeblossom, and closed_eyeblossom to the #small_flowers block and item tags.
Added pale_moss_block to the #sniffer_diggable_block block tag.
Added #small_flowers, and pale_moss_carpet to the #replaceable_by_trees block tag.
Replaced snow with #snow in the #overworld_carver_replaceables block tag.
Removed the copper doors from the #needs_stone_tool block tag.
Removed moss_carpet, pale_moss_carpet, and #small_flowers block tags from the #sword_efficient block tag.
Removed the #tall_flowers block and item tags.
Removed the #flowers and #trim_templates item tags.
Put the contents of the removed #tall_flowers block tag into the #flowers block tag.
Put the contents of the removed #flowers item tag into the #bee_food item tag.

Fixes

206 issues fixed

From released versions before 1.21

MC-212 – Fall damage is ignored for a couple of seconds when reloading into LAN or singleplayer worlds.
MC-10025 – Burn time indicator of a furnace not working correctly after reloading the world.
MC-12829 – Flying through climbable blocks in creative mode slows you down.
MC-16132 – Cave carvers don't cut through snow blocks.
MC-21650 – Player is immune to damage for a few seconds after saving the world and returning.
MC-49071 – The title of written books is not displayed in item frames unless renamed with anvils.
MC-50614 – Villager trading window is not closed when villager leaves interaction range.
MC-55347 – Title with long duration shows in other world.
MC-59308 – Dark/pale oak leaves sometimes do not generate centered on the tree.
MC-65931 – The pick block function doesn't work with entities while in survival or adventure mode.
MC-71990 – The 'Hat' layer of a player skin is not shown in the tab list under certain conditions.
MC-72846 – Altering the time of day using commands is delayed.
MC-74408 – The brewing stand GUI does not have container sprites for the fuel and potion output slots.
MC-86153 – Ctrl + Pick Block gives new item even if picked item already exists in inventory.
MC-99848 – Sprinting isn't canceled upon receiving the blindness effect.
MC-111516 – Player flickers/turns invisible when flying at high speeds.
MC-128225 – '/data remove' can't remove the NBT "CustomName".
MC-134002 – Blocks at y=-64 don't render on a map.
MC-138100 – /data remove doesn't work for the Jukebox's RecordItem tag.
MC-150224 – Rabbits can occasionally get stuck on the edges of blocks.
MC-152728 – The player continues sprinting when performing actions that slow them down.
MC-158205 – Ender Dragon doesn't take damage from melee attacks unless hit a certain way.
MC-158872 – Models use model of last matched predicate, not closest match.
MC-159508 – Ctrl + Pick block on beehives and nests does not copy their honey levels.
MC-160001 – Skulls, signs, hanging signs, banners and decorated pots have no breaking/sprinting particles.
MC-160051 – Players can prevent fire damage by reloading world/re-joining server.
MC-165778 – Maps ignore blocks at the lowest block position (y = -64 in the Overworld) with no block above.
MC-166072 – Custom Trident model ignores "layer0" and "elements" section.
MC-166614 – Advancements menu doesn't render titles fully when they're longer than roughly 30 characters.
MC-177078 – Sound event minecraft:entity.minecart.inside does not have an associated subtitle.
MC-177082 – block.[block type].fall sounds have no subtitles.
MC-177084 – Ambient sounds when flying with elytra have no subtitles.
MC-177091 – Skeleton horse underwater jump sound has no subtitle.
MC-179815 – Data command doesn't remove leash from a mob.
MC-181438 – Elytra visual shuddering when using slow falling.
MC-186105 – Rain particles look lighter than they should with graphics set to Fabulous!
MC-186341 – Command autocomplete doesn't consider parts after a slash.
MC-191096 – Fences and walls can no longer be placed in invalid block states by using /setblock or /fill.
MC-191698 – Cannot set "shape" block state of stairs with /setblock.
MC-192498 – /fill and /setblock cannot set different directional block states of several blocks, such as glass panes and iron bars.
MC-192791 – Doors' block states cannot be set if another door half exists.
MC-192943 – Cannot set the in_wall block state of fence gates with /setblock or /fill.
MC-192956 – Cannot setblock chest type other than single without other adjacent chest.
MC-192959 – Cannot setblock a directional state on redstone wire nor tripwire.
MC-193176 – Most mobs with CanPickUpLoot prefer swords over axes and will downgrade their weapon.
MC-193313 – Mob item pick up behavior is not distinct resulting in mobs constantly dropping and picking up items.
MC-193315 – /setblock and /fill resets the instrument block state of note blocks.
MC-193336 – Heads/skulls don't render when held by an enderman or as block display entities.
MC-197857 – Villagers trying to claim claimed beds.
MC-200508 – No subtitle for fish swim.
MC-201940 – After dying, Ender Dragon body part hitboxes do not move upwards with the main hitbox.
MC-202250 – Sprinting particles appear when sprinting inside of boats in shallow water.
MC-203146 – No subtitle for item.crossbow.loading_middle.
MC-204124 – Underwater minecart riding sound does not have a subtitle.
MC-206684 – Spyglass particles have no associated texture.
MC-207605 – /data remove entity [tamed wolf] Owner does not remove ownership of the wolf.
MC-215992 – Inconsistency with blackstone and stone pressure plate drops compared to buttons.
MC-218873 – Lanterns and soul lanterns require a pickaxe to drop despite being able to break the block on which they are mounted and them drop.
MC-225367 – Magma Cube's layers UV mapping overlaps.
MC-229142 – Spyglass texture doesn't allow override through resource pack.
MC-236295 – The game does not report absent particle texture references in models to the output log.
MC-248264 – /data remove can't remove ArmorItems.
MC-249079 – Sculk veins are not mirrored correctly from behind.
MC-254356 – Dying to a minecart with TNT ignited by a blaze fireball doesn't count as the blaze's kill.
MC-255254 – Use /setblock can't place snowy grass block.
MC-256649 – Hanging signs aren't rendered when held by endermen or as block display entities.
MC-256822 – Advancement description text cuts words in weird places if title is too short.
MC-260216 – Decorated pots aren't rendered when held by endermen or as block display entities.
MC-264541 – Nine_sliced sprite glitch.
MC-265033 – Slots with item outline textures behave inconsistently when items are placed inside of these slots.
MC-265305 – Unused pixels in magmacube.png UV texture map & Used section removed in previous fix.
MC-265637 – /execute on origin doesn't work on Area Effect Cloud's owner after rejoining.
MC-265788 – The "Start free Snapshot Realm" element can be selected or remain selected causing its tooltip to erroneously be visible when other interfaces are open.
MC-266019 – Large bold text can have gaps in the middle of characters.
MC-266991 – Exposed Copper Bulb has inconsistent pixels.
MC-267095 – Nether Brick block texture misalignment.
MC-267192 – "download.pack.failed" string exceeds the prompt box when the Force Unicode Font is turned off.
MC-267343 – Sprinting isn't canceled upon riding entities.
MC-267730 – Text wall when trying to join a server.
MC-267878 – Tutorial hint for movement may not fit all the required text if controls are changed.
MC-268364 – Wind Charges don't ignite TNT minecarts.
MC-268522 – The last language option is not deselected if you reach the bottom of the list and exit the menu.
MC-268822 – There are no shadows on text displayed within the singleplayer, multiplayer, and realms list menus.
MC-269616 – Telemetry Data scroll bar does not have a background.
MC-269749 – Report Player scroll bar does not have a background.
MC-269935 – Advancement box textures use nine-slice scaling, but seemingly cannot be configured.
MC-270136 – Thrown projectiles with custom_model_data do not maintain proper particles when breaking.
MC-270529 – Air's model does not define a particle texture, causing issues.
MC-271169 – The "Isn't It Scute?" advancement is granted when unleashing an armadillo while holding a brush.
MC-271218 – Empty Offers:{} NBT doesn't disable trades anymore.
MC-271786 – Empty block states in noise_provider does not cause validation to fail, causing crash.
MC-272105 – Decorated Pot is missing the "contents" implicit data component type.
MC-272245 – You can get the advancement "Shear Brilliance" when you use shears on a leashed wolf.

From 1.21

MC-272062 – Dimension padding doesn't affect the start piece.
MC-272994 – Allays assigned to a player can be set on fire with sweeping and fire aspect.
MC-273407 – Block entity items with custom block states keep them as components when placed.
MC-273450 – Mobs with CanPickUpLoot:1b behave inconsistently with the mace / trident.
MC-273522 – Mobs with CanPickUpLoot no longer pick up enchanted items after picking up an unenchanted item.
MC-273635 – Trial spawners forget their designated mob when placed by player out of creative mode, assigned by spawn eggs.
MC-273710 – Wild foxes "trust" the player after being leashed to a fence.
MC-273861 – When a leashed bee enters a hive, the leash disappears.
MC-274268 – Trial Spawner keeps flashing after cooldown ends.
MC-274571 – The advancement "Little Sniffs" can be obtained by unleashing the snifflet and not feeding it.
MC-275011 – Instant mine does not work when standing inside of cobwebs.

From 1.21.1

MC-275338 – Sprint particles can be seen if you mount a minecart (with no rail below it) while running.
MC-275952 – Riding a minecart above the water with Frost Walker boots on will also give the Frost Walker effect.
MC-276110 – honey_level model predicate range is 1 for level 5 and 0 for levels 1-4.
MC-276115 – New Bee Nest and Beehive item models don't use the block parent.
MC-276123 – Display entity shadow_radius updates for all display entities.
MC-276412 – Custom item models set to a shield and various other items all create invisible items.
MC-276529 – Converting a villager into a witch does not close the trading GUI.
MC-276654 – item_model item component breaks on trident.
MC-276794 – There are no shadows on text displayed within the social interactions list menu.
MC-276799 – There are no shadows on text displayed within the superflat customization or preset lists.
MC-276962 – JVM crash occurs when minimizing maximized window.
MC-277368 – The "message(s) selected" text within the "Select Chat Messages to Report" menu is positioned too close to the header separator.
MC-277373 – There are no shadows on text used to display the names of categories within the key binds menu.
MC-277374 – There are no shadows on text used to display the names of lists within the resource pack and data pack menus.
MC-277408 – There are no shadows on text used to display the description of report categories within the "Select Report Category" menu.
MC-277440 – There are no shadows on text used to display the speed at which a world is being uploaded within the realms menu.
MC-277441 – There are no shadows on text used to display the start date and time left of your realm subscription within the realms menu.
MC-277443 – There are no shadows on text displayed when connecting to realms.
MC-277444 – There are no shadows on text used to display the names of text boxes within the realms settings menu.
MC-277477 – There are no shadows on text used to display the description of advancements within the advancements menu.
MC-277478 – The "Layer Material" and "Height" text within the "Superflat Customization" menu is positioned too close to the header separator.
MC-277479 – There are no shadows on text used to display the names of game rules within the game rules menu.
MC-277480 – There are no shadows on placeholder text displayed within the "Please describe what happened" box within the reporting menu.
MC-277499 – Most empty slot icons ignore "scaling" parameter in mcmeta files.
MC-277510 – When grass or mycelium grows under powder snow the grass is not snowy.
MC-277617 – The base damage of the Power enchantment was reduced in 1.21.

From 1.21.2

MC-275215 – Experiments warning goes off the screen if viewed at low window size.
MC-275274 – Missing sound for event: minecraft:block.spawner.fall.
MC-275339 – Bad contrast in bundle interface with dark blocks.
MC-275917 – Consumable blocking animation is broken in first person.
MC-276389 – The "Can hold a mixed stack of items" text within bundle tooltips doesn't have a shadow.
MC-276697 – Neutral mobs don't pathfind correctly to their target after being unleashed.
MC-276728 – Tridents and spyglasses appear dark in the inventory if given a custom item model for a block.
MC-276730 – Bundles appear dark in the inventory if given a custom item model for a block and then scrolled through.
MC-276731 – Items which use entity models will not render another entity model if specified via item model component.
MC-276732 – Colors will carry over from item ID to target model.
MC-276764 – Eggs with custom models use the particles from that model, but snowballs do not.
MC-276769 – Missing texture when throwing eggs with certain template models.
MC-276771 – Missing texture when a damageable item with one of several template models is destroyed.
MC-276828 – Minecraft no longer prints an error to the game log when a model fails to define a texture.
MC-276847 – Bundles given the model of a different bundle will not preserve their color when scrolled through.
MC-276969 – TNT Minecarts with explosion_power set to 0 can still break blocks.
MC-276986 – Missing pixel in open bundle texture.
MC-277042 – Blue and Red open bundle are inconsistent with the other colors.
MC-277066 – Creakings do not show particles leading to the creaking heart if Particles are set to Minimal.
MC-277071 – Middle clicking on a creaking spawned naturally through a creaking heart doesn't give you the spawn egg.
MC-277072 – You can use bone meal on pale moss carpets in situations where nothing grows.
MC-277074 – The entity shadows of creakings are slightly too large in relation to the size of their models.
MC-277076 – Pale hanging moss doesn't have an assigned tool.
MC-277082 – Creakings take knockback from wind charges.
MC-277092 – The eyes of creakings aren't visible when creakings have the invisibility effect.
MC-277094 – Pale oak hanging sign uses a totally different palette to the rest of the wood set.
MC-277101 – Destroying a creaking heart with player-activated TNT does not grant the Monster Hunter advancement.
MC-277113 – Pale oak sign item and block texture is inconsistent with the other signs.
MC-277115 – Creaking mob can spawn inside block.
MC-277123 – You can get soft locked if a creaking falls in a hole with you.
MC-277129 – The Creaking "slides" on the ground when not aggro towards the player.
MC-277132 – Pale oak sign item textures are inconsistent.
MC-277134 – Pale chest boat item is incorrect.
MC-277140 – The statistics screen does not visually differentiate the creaking and creaking_transient entities.
MC-277145 – The 2 brightest pixel colors on pale oak boat items are wrong.
MC-277149 – Creakings are affected by knockback from mace smash attacks.
MC-277152 – The statistic for killing a creaking doesn't increment when breaking a creaking heart.
MC-277154 – Sculk sensors are not activated upon creakings dying through their creaking hearts being destroyed.
MC-277164 – Music plays in the pale garden.
MC-277169 – Creaking moves while a player is looking at it while moving a certain way and looking through pale moss.
MC-277202 – Differences in the highlight effect of empty slot outlines in the GUI.
MC-277213 – Subtitles for cave sounds, creaking heart idle sounds, and pale hanging moss idle sounds are identical but are shown separately.
MC-277214 – The sound event associated with the "Creaking sees player" subtitle doesn't exist.
MC-277226 – Creakings not linked to any heart display wrong subtitles when attacked with non-damaging projectiles.
MC-277243 – Creakings take knockback from Punch bows.
MC-277264 – The Creaking can be knocked back by zoglins.
MC-277268 – Pufferfish have no hit delay on creakings; they make a loud buzzing noise constantly.
MC-277271 – Sniffers can't dig into pale moss.
MC-277275 – Crash upon loading chunks when teleporting.
MC-277305 – Creakings are able to be pushed around by entities and players when standing on soul sand and mud.
MC-277363 – Creakings cannot rotate their heads independently from their bodies.
MC-277387 – Evokers run away from creakings faster than other illagers.
MC-277399 – The hand animation isn't played when constantly emptying items from bundles.
MC-277413 – The empty state sprite for the oxygen bar takes a little longer to start displaying compared to Bedrock Edition.
MC-277533 – Bundles can remain in the open state when taken out from saved hotbars.
MC-277549 – Arrows summoned with custom motion don't render correctly.
MC-277557 – Creaking Heart has inconsistent and miscolored pixels.
MC-277651 – Arrows and tridents glitch when in an explosion or wind charge burst.
MC-277657 – Arrows are not correctly affected by rising bubble columns.
MC-277658 – Tridents glitch up and down in rising bubble columns.
MC-277682 – Arrows and tridents glitch after shooting/throwing them onto magma/soul sand blocks underwater.
MC-277742 – Creakings activate for a brief moment when switching from Creative to Spectator mode.
MC-277754 – Chunks on the corner of the rendering distance are not synchronized between client and server for the terrain.
MC-277776 – Baby cats and ocelots size is changed.
MC-277815 – Creakings on a team can still be observed and stopped by teammate players.
MC-277833 – Creakings can attack players in the same team as them.
MC-277871 – Creaking Hearts do not have a unique place sound.
MC-277916 – Containers are locked when upgrading a world from certain versions.

From 1.21.3

MC-277889 – Villagers' iron golem detection range is increased for villagers upgraded from 1.21.1 or earlier.
MC-277892 – Clicking on the selected recipe a second time in the stonecutter GUI turns the result item into a ghost item.
MC-277959 – Reloading chunks can break translucency sorting.
MC-277961 – Experience orbs incorrectly bounce up.
MC-278058 – Breeze entity model rods no longer spin around when it is moving.
MC-278071 – "minecraft.used:minecraft.trident" doesn't increase when throwing a trident.
MC-278102 – Recipe book icons no longer visually indicate that an item has multiple recipes.
MC-278257 – Oxygen bar animation can be interrupted by applying water breathing.

Videos

Videos made by Slicedlime:

Trivia

1.21.4 had the same number of snapshots, pre-releases, and release candidates released for it, with three of each having been released.
1.21.4 took the shortest time of all named versions to release after the previous named version, releasing just 42 days after 1.21.2.

References

↑ "Minecraft Java Edition 1.21.4" – Minecraft.net, December 3, 2024.
↑ This was added alongside a fix for a bug which unintentionally made them bouncy several versions earlier. MC-277961
↑ MC-236295
↑ MC-276828

Navigation

[1] "Minecraft Java Edition 1.21.4" – Minecraft.net, December 3, 2024.

[2] This was added alongside a fix for a bug which unintentionally made them bouncy several versions earlier. MC-277961

[3] MC-236295

[4] MC-276828

[1]

[2]

[3]

[4]