Efe is sitting on a cushion in front of a camp fire in an abandoned camp in a dappled forest.

News

Escrito por: Java Team
Publicado: 15/9/26

Minecraft Java Edition 26.3

Minecraft Java 26.3 Released

Wilderness Bound is out now in Minecraft Java Edition! Pack your supplies and set off on an expedition into the dappled forest where the trails end and adventure begins. Seek out abandoned camps, build outposts among the poplar trees, sleep under the stars on straw beds, and share campfire stories atop cushions. Just remember that the wilderness rewards the prepared - and maps are lighter than regrets!

Happy camping!

New Features

Added Dappled Forest Biome
Added Poplar Trees
Added fallen Poplar Trees
Added Red Poplar Leaves, Orange Poplar Leaves, and Yellow Poplar Leaves blocks
Added Poplar wood set
Added Shelf Mushrooms
Added Red Shrubs
Added Abandoned Camp structures
Added new Explorer Maps
Added Cushions
Added Straw Beds
Added Wool Stairs and Wool Slabs for all Wool blocks
Added Concrete Stairs and Concrete Slabs for all Concrete blocks
Players in spectator mode can now interact with portals to teleport
Improvements to Realms, including the ability to create and manage Invite Codes
Added Gothic language support

Dappled Forest Biome

A new type of forest biome which can be found near cold biomes
Poplar Trees and fallen Poplar Trees generate here
Shelf Mushrooms can be found here, placed on Poplar Trees and fallen Poplar Trees
Red Shrubs generate here
The following passive and neutral mobs spawn in the Dappled Forest, using their cold variants where applicable:
- Sheep
- Chicken
- Cow
- Pig
- Rabbit
- Fox
A Dappled Forest variant of the new Abandoned Camp structure can be found here

Poplar Trees

A new type of tree which comes in three color variations:
- Red Poplar Leaves
- Orange Poplar Leaves
- Yellow Poplar Leaves
Each variant of the tree has its own variant of falling leaf particles matching the color of the leaves
Poplar Leaves drop Poplar Saplings which will randomly grow into any of the three different variants
Poplar Saplings can be found in trades with the Wandering Trader
Shelf Mushrooms and Leaf Litter naturally generate on or around Poplar Trees
The trunk of the trees are made of Poplar Logs
Poplar Logs can be crafted into a new set of Poplar wood blocks

Shelf Mushroom

A new type of mushroom that generates on Poplar Trees and fallen Poplar Trees
Can be found in two sizes, small and large
A small Shelf Mushroom can be grown into a large Shelf Mushroom by using Bone Meal
A large Shelf Mushroom drops two Shelf Mushroom items when broken
Can be used like other mushrooms to make Stews
Can be found in trades with the Wandering Trader
Shelf Mushrooms have a slight bounciness when stepped on, similar to Beds
The Shelf Mushroom makes a bouncing sound when a living entity bounces on it

Red Shrub

A new type of decorative plant block that can be found in small patches in the Dappled Forest
Can be used in the Composter
Using Bone Meal on a Red Shrub grows a Red Shrub in a random adjacent space if possible

Abandoned Camp Structure

A new kind of structure which can be found in the following biomes:
- Meadow
- Cherry Grove
- Forest
- Birch Forest
- Old Growth Birch Forest
- Flower Forest
- Windswept Forest
- Dappled Forest
- Taiga
- Snowy Taiga
- Old Growth Spruce Taiga
- Old Growth Pine Taiga
- Sparse Jungle
- Bamboo Jungle
- Swamp
- Savanna
- Wooded Badlands
- Pale Garden
Each of these biomes has its own variant of the structure with a design based on the biome
Certain structure pieces are generic for all biome variants of the structure
Various Chests and Barrels with loot can be found at Abandoned Camps

Cushion

The Cushion is an item that the player can place in the world and interact with to sit on
Can be crafted in 16 colored variants
Cushions are crafted by using 3 Wool Slabs of the same color

Cushion Placement Rules

A Cushion can be placed on any flat surface
Cushions always align horizontally to the grid, but vertically sit on top of the supporting surface
Cushions cannot be moved by pistons
Cushions break if the supporting block is removed
Cushions do not have collision and can overlap with other objects (except other Cushions)

Straw Bed

The Straw Bed is a new type of bed which can be used to sleep through the night without setting your spawn point
It can only be used once and will be destroyed after use
It cannot be used in the Nether or the End and will be destroyed if you try to sleep on it there
It is crafted by using 3 Hay Bales and will give you 4 Straw Beds
There's a new statistic in the Statistics window for the amount of times you've slept in a Straw Bed

Wool Stairs and Wool Slabs

Each colored Wool block now has a new Stair and Slab variant
Wool Stairs and Wool Slabs can be used like other Wool blocks to dampen vibrations

Concrete Stairs and Concrete Slabs

Each colored Concrete block now has a new Stair and Slab variant
Concrete Slabs and Stairs can also be crafted using a Stone Cutter

Abandoned Camp Explorer Maps

New Explorer Maps have been added to the Abandoned Camps
Added maps showing the location of other Abandoned Camps in the following biomes:
- Bamboo Jungle
- Cherry Grove
- Birch Forest
- Dappled Forest
- Flower Forest
- Pale Garden
- Swamp
- Windswept Forest
Added maps for the following structures:
- Ancient City
- Trial Chambers
- Mineshaft
- Desert Pyramid
- Jungle Pyramid
- Warm Ocean Ruins
- Woodland Mansion

Realms

Realm owners can now create and manage Invite Codes
- Each Realm can have up to five Invite Codes
- Invite Codes can be configured to be active/inactive and deleted
- The expiration of an Invite Code can also be configured
Players can now easily join a Realm by entering an Invite Code in a new "Join Realm" screen, found in the Realms main menu
Added render distance and simulation distance sliders to the Realm configuration settings
Added a new Realms introduction screen showcasing Realms key features
- Accessible from the "Add Realm" button
- Automatically shown when entering Realms if a trial is available

Changes

The Main Menu now has an updated background panorama showing the new Dappled Forest biome with an Abandoned Camp
Removed fallen leaf particles from Spruce Trees
Suspicious Stews can now be crafted with 2 of any mushroom
Mushroom Stew can now be crafted with 2 of any mushroom
The player icon on maps has been updated to always show the direction the player is facing
New Villager trades, unlocked from a Villager leveling up their profession, will now update even if the player is in the process of trading with them
Persistent mobs' random walk/swim behaviors will now deactivate when players are not nearby, in the same way as non-persistent mobs
Replaced the current "Improved Transparency" approach with a new order-independent transparency algorithm which is expected to be much better at solving translucency issues
Added a rebindable debug key combination "F3 + X" to toggle "Improved Transparency"
When using a Shield together with a Hoe or a Shovel, raising the Shield will take precedence over tilling and path making
Changed the Adventure Mode icon in the Game Mode Switcher to the Buried Treasure Map
Improvements to performance when trying to locate structures
Improvements to chunk generation performance

Explorer Maps

Explorer Maps are now their own items instead of renamed Filled Maps, and each has its own icon:
- Ocean Monument Map
- Woodland Mansion Map
- Buried Trial Chambers Map
- Jungle Pyramid Map
- Swamp Hut Map
- Desert Village Map
- Plains Village Map
- Savanna Village Map
- Snowy Village Map
- Taiga Village Map
- Buried Treasure Map
- Buried Ancient City Map
- Buried Mineshaft Map
- Desert Pyramid Map
- Abandoned Camp Map
- Warm Ocean Ruins Map
These items cannot be obtained from the Creative inventory
Existing Explorer Maps in old worlds are converted to the matching new item on load
The following Explorer Maps have been renamed to have more consistent naming
- Ocean Monument Explorer Map → Ocean Monument Map
- Swamp Hut Explorer Map → Swamp Hut Map
- Trial Chambers Explorer Map → Buried Trial Chambers Map
- Woodland Mansion Explorer Map → Woodland Mansion Map
- Jungle Pyramid Explorer Map → Jungle Pyramid Map
Explorer Maps can still be cloned in a Crafting Table, and the copies keep their own item type
Explorer Maps and Buried Treasure Maps can no longer be zoomed out, neither in a Crafting Table nor at a Cartography Table
- Buried Treasure Maps could previously be zoomed out at both
- Explorer Maps could previously be zoomed out at a Cartography Table
- Only maps in the #minecraft:extendable_maps tag can be zoomed out
Map and Empty Map have new icons

Order-independent Transparency (OIT)

Generally, translucent surfaces need to be rendered back-to-front to avoid visual issues
- In order to do so, the translucent geometry has to be sorted before rendering
- This is very expensive and even with perfect sorting of individual triangles, intersecting triangles are not possible to render correctly
Before this release, the "Improved Transparency" video setting attempted to mitigate translucency-related visual issues
- It did this by rendering different types of translucent objects (entities, particles, water, etc.) to different textures that were later combined to create the final image
- This allowed us to fix some of the issues with some performance impact
- However, it introduced some other less noticeable issues
Now, the "Improved Transparency" video setting will instead enable a new order-independent transparency algorithm (which we will refer to as OIT)
- This makes it possible to render translucent objects in any order without sorting
- It fixes all existing major translucency-related visual issues (such as certain objects disappearing when viewed through translucent objects)
- However, the algorithm is an approximation, and so it introduces some new minor visual artifacts (such as the color of clouds being somewhat incorrect when viewed through multiple layers of translucent surfaces)
We expect OIT to have a higher performance impact than the previous implementation of "Improved Transparency"
When "Improved Transparency" is turned off, the behavior hasn't meaningfully changed and the game will still prioritize performance over correctness while sorting geometry as necessary

Developer's Note: Special thanks to Rubén Osorio López, Jozufozu, and the Minecraft modding community in general for sharing the information that helped us to deliver this.

Minor Tweaks to Blocks, Items, and Entities

Endermen will now take damage from projectiles if they're riding something
Teleporting randomly after eating a Chorus Fruit now shows particles into the direction of the teleportation
Endermen and Shulkers no longer teleport onto Bedrock
Armadillos no longer try to roll up when submerged in liquids
Data set on a Spawn Egg will now transfer to a Mob Spawner when a player with operator permissions uses the Egg on the Spawner
Sherds dropped from breaking a Decorated Pot will now preserve data, for example custom names
Enchantments now apply to items being damaged from protecting an undead mob from the sun
Teleporting with an Ender Pearl now resets the momentum of the player being teleported

UI

Removed the Raw Input mouse setting
- Mouse input now always uses relative mouse mode while playing in-game
Key bindings now use physical keys instead of keyboard-layout-specific key codes
Borderless Fullscreen is now the default fullscreen mode
Switching between Borderless and Exclusive Fullscreen no longer requires restarting the game
The cursor is now confined to the window while Exclusive Fullscreen is active
The minimum window size is now 320 by 240 pixels
On macOS, holding a key while entering text now displays the native accent and candidate popup
On Linux systems, the game will now use and prefer Wayland natively if available
Fixed an issue where Realm owners could not select automatic region preference as their Realm region
Added a "Quit Shortcuts" option in Controls settings, which controls whether keyboard shortcuts can close the game (Alt + F4 on Windows/Linux, Cmd + Q and Cmd + W on macOS)
- On by default
On macOS, added a "Right Click Emulation" option in Controls settings, which treats Control + left-click as a right-click
- Off by default
On macOS, added a "Menu/Dock Visibility" option in Video Settings, which controls whether the macOS Menu bar and Dock can be revealed by moving the mouse to the edge of the screen while in fullscreen
Added support for Realms to use additional server regions in Canada, Mexico, South Africa, and Arizona, USA if they become available in the future

Debug Overlay

The debug overlay now supports a separate GUI scale from the rest of the game
- This is customizable through the Debug Options screen, F3 + F6
- The default scale is "Auto", which tries to stay at a higher resolution than normal
- Another option is "Unchanged", which matches your regular GUI scale
- The rest of the options work the same as in the normal "GUI Scale", controlling the scale directly
Added a "player_speed" debug entry that displays the speed of the player in blocks per tick
The debug overlay now shows the display refresh rate

World Options

The World Options button has been moved to where the Open to Lan button used to be, accessible from the pause menu
- The World Options screen is divided into two sections: "General" and "Multiplayer"
  - The "General" section contains the following options:
    - Default Game Mode: the default game mode of the world (equivalent to the /defaultgamemode command)
    - Personal Game Mode: your active game mode in the current world (equivalent to the /gamemode command, or F3 + F4)
    - Allow Commands: Controls whether you can use commands in this world or not
    - Difficulty: Controls the difficulty of the world (equivalent to the /difficulty command)
    - Edit Game Rules: Opens the Game Rules screen, which allows you to view and edit the game rules of the world
    - Restrictions: View your restrictions in the world
  - The "Multiplayer" section contains the following options:
    - LAN: changes the multiplayer scope of the world
    - Port: the port number to use when opening the world to LAN
    - Command Access: controls whether players that join your world can use commands or not
    - Force Game Mode: controls whether other players' game mode is forced to match the default game mode of the world or not
The Online button used to access the Online Options screen will now always be shown in the Options menu instead

Accessibility

Subtitles now point to the most recent sound in range

Creative Inventory

Reordered mineral item and block ordering to have non-tiered ingredients up first, then tiered ingredients that craft into equipment last
- Ingredients
  - Non-tiered minerals
  - Unrefined tiered minerals
  - Refined tiered minerals
    - Nuggets
    - Ingots
- Building Blocks
  - Non-tiered mineral blocks and variants
  - Refined tiered mineral blocks and variants
  - Copper block family
- Copper Blocks continue to be pushed to the end of the order in Building Blocks since they have a large list of content
Improved the ordering of the Natural Blocks tab so that all inner ordering of group content sequentially progresses from Overworld → Nether → End to stay consistent with other tabs

Technical Changes

The Data Pack version is now 121.0
The Resource Pack version is now 97.1
Some log lines that server software might look out for have been removed
- The Minecraft Server Management Protocol can be used instead
- If you are missing access to specific events, please create a feature request on the Feedback site
The definition field from the blocks.json data generation report has been removed
Terrain blocks are now rendered with MultiDrawIndirect on supported devices
level.dat now contains a version_history list with prior data versions of the file

Windowing and Input Backend

Minecraft now uses SDL3 instead of GLFW for window management, input, and platform integration
Keyboard input now uses SDL scancodes for physical key positions and SDL keycodes for layout-dependent text editing shortcuts

Server Properties

The white-list property is now true by default

Minecraft Server Management Protocol 3.1.0

Added notifications indicating when the server performs a full world upgrade on startup
- minecraft:notification/world/upgrade_started
- minecraft:notification/world/upgrade_progress
- minecraft:notification/world/upgrade_finished
- minecraft:notification/world/upgrade_failed

Data Pack Versions 108.0 through 121.0

Commands like /give, /unpublish, and /tick should now properly signal errors
Pottery sherds are now data-driven
Entries stored in the minecraft:pot_decorations component and minecraft:decorated_pot block entity are now full item stacks
Signs no longer automatically execute click events in custom text
Potion recipes are now data-driven
The minecraft:number_provider and minecraft:number_provider_type registries have been split into separate registries for integer calculations (minecraft:context_int_provider, minecraft:context_int_provider_type) and float calculations (minecraft:context_float_provider, minecraft:context_float_provider_type)
Loot table types that have a dedicated registry now support registry element and tag references
- This means that the majority of fields of such types that previously accepted single elements will now accept either a namespaced ID or an inline value, while fields that previously accepted lists can now accept an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID
- Affected types:
  - minecraft:advancement
  - minecraft:item_modifier
  - minecraft:loot_table
  - minecraft:context_int_provider
  - minecraft:context_float_provider
  - minecraft:predicate
  - minecraft:recipe
  - minecraft:slot_source
- Existing reference types for predicates, item modifiers, and slot sources are now obsolete and have been removed
The codec for element lists/tags now allows mixing inline values and references
- For example, item modifiers like [{type:set_count, ...}, "minecraft:some_modifier"] are now allowed
The following Block State fields have been renamed
- Name is now id
- Properties is now properties
The default Block State of a Block can now be referred to in a compact form directly by the Block id

Commands

Added posteffect

Allows adding or removing "post effects" to players
These are postprocessing shaders that are applied to the player's screen, after the game has finished normal rendering
Post effects exist on the client (in resource packs), not the server – the server cannot know if one will actually apply
Post effects themselves were already part of the resource pack format, but only a few hardcoded ones were available to use

Developer's Note: This now makes custom shaders fully available to use from resource packs, but please be aware that shaders are still subject to be changed at-will, and the features involved (the command, post effects, or shaders) may be redesigned in the future.

Syntax:

/posteffect add <player> <posteffect> - adds the post effect to the player, if it doesn't already exist
/posteffect clear <player> - removes all post effects from the player, if any exist
/posteffect list <target> - lists all post effects applied to the player, if any exist
/posteffect remove <player> <posteffect> - removes the post effect from the player, if it exists

Changes to publish

The gamemode argument has been removed
- Instead, the default game mode of the world should be set using the defaultgamemode command or the Game Mode button in the World Options screen, while player-specific game modes should be set using the gamemode command

Added compute

Evaluates minecraft:context_int_provider and minecraft:context_float_provider values in various contexts
In all contexts, origin is set to the current command context position, while this entity is set to @s
If the evaluation fails (for example due to division by zero), this command will fail

Syntax:

/compute <target> integer <int_provider> OR
/compute <target> float <float_provider> [<scale>], where:
- <target> - one of:
  - default - runs the provider in the minecraft:command_compute_default context, where only common arguments (position and this entity) are available
  - block <pos> - runs the provider in the minecraft:command_compute_position context, where block state and block position are set based on the block at position <pos>
  - entity <entity selector> - runs the provider in the minecraft:command_compute_entity context, where target_entity is set to the selector result
- <int_provider> - either an element of the minecraft:context_int_provider registry or an inline value
- <float_provider> - either an element of the minecraft:context_float_provider registry or an inline value
- <scale> - optional scale value, defaults to 1.0
  - The final result will be multiplied by <scale> and rounded towards negative infinity

Changes to data

Added new source to /data modify ... append|insert|merge|prepend|set called compute
It evaluates a minecraft:context_int_provider or minecraft:context_float_provider value and then provides the result either as an integer or a float tag
Example: /data modify storage foo bar set compute entity @n[type=minecraft:armor_stand] integer {type:score,target:{type:context,target:target_entity},score:baz}

Syntax:

compute <target> (integer <int_provider> | float <float_provider>), where the syntax of target, int_provider, float_provider is the same as in the /compute function
- Note: unlike /compute, there is no scale, since the result is directly stored as a float, instead of being returned from the command as an integer

Changes to give

When the amount of items passed to the give command is above the limit, the command will now signal an error instead of just printing an error message and returning 0

Changes to tellraw

The nbt component in a raw chat message will only be resolved up to 64k times

Changes to tick

The following subcommands will now signal an error instead of just printing an error message and returning 0:
- tick step
- tick step stop
- tick sprint stop

Changes to team

The result of the team join and team leave subcommands now reflects the exact count of entities that have joined or left (i.e. excluding entities for which teams have not changed)

Changes to item

Now takes a slot source as an argument in place of anywhere a slot was previously used
- It will be evaluated with the minecraft:command_slot_source loot type
- Can be a slot source in either inline or reference form
- Can be a slot source targeting multiple slots
- The replace sub-command has new semantics:
  - The contents of each destination slot are replaced with the corresponding source item one by one in the order they are provided by the slot source
  - When there are more destination slots than there are source items, the remaining slots are ignored
    - Example: replace [12345] with (ABC) → [ABC45]
  - When there are fewer destination slots than there are source items, the remaining items are ignored
    - Example: replace [123] with (ABCDE) → [ABC]
- String notation slot ranges in the form <slot_type> or <slot_type>.<slot_number> are still permitted
  - Can be a single slot, such as armor.chest
  - Can be multiple slots, such as container.*
  - Acts as shorthand for a minecraft:slot_range slot source using that slot range
    - Example: hotbar.4 is the same as {type:"minecraft:slot_range",slots:"hotbar.4"}
The entity argument in the from entity item source can now be a selector targeting multiple entities
- When more than a single entity is targeted, the slots sourced from each are concatenated
Added new fill and override sub-commands, each with syntax identical to /item replace
- /item fill
  - Fills each destination slot with a source item
  - When there are more destination slots than there are source items, the items repeat until every slot is filled
    - Example: fill [12345] with (ABC) → [ABCAB]
- /item override
  - Overrides the contents of each destination slot with the corresponding source item
  - When there are more destination slots than there are source items, the remaining slots are cleared
    - Example: override [12345] with (ABC) → [ABC__] (where _ represents an empty slot)

Changes to execute

Added new slots condition sub-command
- Counts the number of slots from the slot source that are present on the targeted block or entity
- The slot source will be evaluated with the minecraft:command_slot_source loot type
- Syntax:
  - /execute if|unless slots block <pos> <slot source>
  - /execute if|unless slots entity <targets> <slot source>
The items condition sub-command now takes a slot source as argument instead of a slot
- The slot source will be evaluated with the minecraft:command_slot_source loot type
- Syntax:
  - /execute if|unless items block <pos> <slot source> <item predicate>
  - /execute if|unless items entity <targets> <slot source> <item predicate>

Changes to place

The feature sub-command now allows inline definition of the Feature

Changes to spreadplayers

Whether a block is safe to spread a player to is now controlled by the #entities_can_teleport_to block tag

Changes to swing

When used on a player, the player's attack strength will no longer be reset
Added a new optional argument to set the swing animation to play
- Allowed values: none, whack, stab
- If omitted, defaults to whack
Added a new argument to set the duration of the swing animation, if provided
- Format: positive time value (by default in ticks)
- If omitted, defaults to 6t

Environment Attributes

Added minecraft:gameplay/natural_mob_spawns

Defines mob spawns in an Environment Attribute Source
During worldgen placement, only Dimensions and Biomes will apply this Environment Attribute
Format: object with fields:
- spawns_by_category - map of spawn category to weighted list of spawn data
  - Spawn data format: object with fields:
    - type - entity type, the entity to spawn
    - count - int provider, amount to spawn
- spawn_costs - map of entity type to object with fields:
  - energy_budget - float, energy change allowed per spawn
  - charge - float, how much existing mobs will attract or repulse other charged mobs
Available attribute modifiers:
- overlay
  - For each mob category, overrides the lower layer's spawn settings with the higher layer's, unless the category is not included
  - Merges each layer's spawn costs together, overriding the lower layer's spawn costs with the higher layer's if both define the same entity type
Default: Empty

Added minecraft:gameplay/creature_world_gen_spawn_probability

Sets the probability to run an iteration in which mobs defined to spawn in the creature mob category will spawn during world generation
Only Dimensions and Biomes will apply this Environment Attribute
Format: float with range [0,1)
Default: 0.1

Changed minecraft:gameplay/bed_rule

Field explodes has been renamed to destroy_on_use
Added destroy_on_leave - optional boolean, if true, the Bed will be destroyed when leaving it
- If omitted, defaults to false

Added minecraft:gameplay/straw_bed_rule

Same format as minecraft:gameplay/bed_rule, but used for the Straw Bed

Changed minecraft:visual/ambient_particles

Now supports interpolation between Timeline keyframes (probabilities will be crossfaded)
Introduced support for new modifier: append
- Unlike override which totally replaces the particle list, this modifier concatenates all elements with the layers below

Data Components

Added minecraft:provides_pottery_pattern

Describes the pottery pattern stored on a stack
Format:
- namespaced ID pointing to an element of the minecraft:decorated_pot_pattern registry

Added minecraft:cooking_fuel

Describes an item that can be used as fuel for a Furnace, Smoker, or Blast Furnace
Format: object with fields
- burn_time - inline integer number, or a namespaced ID pointing to an element of the minecraft:context_int_provider registry representing the time in ticks for which this fuel will burn
- speed_multiplier - inline float number, or a namespaced ID pointing to an element of the minecraft:context_float_provider registry representing the speed of the cooking/smelting
Cooking fuel items with remainders will be handled as follows:
- If there is fuel remaining in the fuel slot, the remainder item will be dropped on the ground
- If the fuel has run out, the remainder item will remain in the fuel slot

Added minecraft:brewing_fuel

Describes an item that can be used as fuel for a Brewing Stand
Format: object with fields
- uses - inline integer number, or a namespaced ID pointing to an element of the minecraft:context_int_provider registry representing the number of times this fuel will brew before being consumed
- speed_multiplier - inline float number, or a namespaced ID pointing to an element of the minecraft:context_float_provider registry representing the speed of the brewing
Brewing fuel items with remainders will be handled as follows:
- If there is fuel remaining in the fuel slot, the remainder item will be dropped on the ground
- If the fuel has run out, the remainder item will remain in the fuel slot
- This behavior matches items placed in the input and reagent slots of the brewing stand
Note: the #brewing_fuel item tag has been removed and will no longer function to register new brewing fuels

Changed minecraft:pot_decorations

Instead of taking a list of 4 item IDs, this component now takes an object with 4 optional item stack fields named:

back
left
right
front

Changed minecraft:trim_material

The format of inline material definitions has been updated as described below

Added minecraft:block_transformer

Allows an item to transform blocks into other blocks on player interaction
Format:
- a namespaced ID of a minecraft:block_transformer registry type

Added minecraft:sign_text_front and minecraft:sign_text_back

Two identical components that represent text on the front and back of a sign
Contents will be displayed in the item's tooltip
The format is the same as the front_text and back_text fields on the minecraft:sign and minecraft:hanging_sign block entities, i.e.
- messages - a list of text components
- filtered_messages - an optional list of text components, if omitted, it will be set to the same value as messages
  - messages and filtered_messages must have the same entry count
- color - optional dye color, default: black
- has_glowing_text - optional boolean, default: false

Added minecraft:waxed

A marker for blocks with contents that are waxed
No fields

Added minecraft:cushion/color

Applied to Cushion entities when they get placed using an item
Format: one of 16 dye colors

Added minecraft:compostable

Represents the ability to compost an item and how it adds layers to the composter
Format: object with fields
- layers - inline integer number, or namespaced ID pointing to an element of the minecraft:context_int_provider registry

Added minecraft:villager_food

Represents items that Villagers can eat. Villagers will pick up items with this component in addition to items in the #villager_picks_up tag.

Format: object with fields
- nutrition - positive integer, how much hunger the item satiates in the Villager once eaten

Added minecraft:mob_visibility

Represents the visibility percentage provided by an item with the appropriate minecraft:equippable component, modifying the range at which mobs are able to detect an entity.

Format: object with fields
- targeting_entity_types - an entity ID, a list of namespaced entity IDs, or a hash-prefixed entity tag to match
- visibility - float (between 0.0 and 10.0), with 0.0 reducing the range at which mobs detects the entity to 2 blocks while 10.0 increases the detection range tenfold
  - While multiple items with this component stack, the maximum vision will still never exceed 10.0

Added minecraft:attack_animation

The animation to play when the item is being used to attack something
Format: object with fields:
- type - swing animation type, one of none, whack, stab
- duration - non-negative integer, the length of the animation in ticks

Added minecraft:interact_animation

The animation to play when the item is being used to interact with something
Format: Same as minecraft:attack_animation

Changed minecraft:consumable

Added a new optional field to the teleport_randomly consume effect:
- directional_particles - boolean, whether to show a particle trail into the direction of the teleportation
  - If not present, defaults to true

Removed minecraft:swing_animation

This has been replaced by minecraft:attack_animation and minecraft:interact_animation
- Setting both of these new components to the same value will be functionally identical to the old component, except for:
  - The /swing command - animation type now specified by the command
  - Items being dropped by entities

Removed minecraft:map_color

Maps are no longer drawn as a tinted overlay, so there is nothing left for the color to apply to
Existing maps have the component stripped on load
See the Resource Pack section for the matching removal of the minecraft:map_color tint source

Trim Materials

The format of elements in the trim_material registry has been updated:

asset_name has been replaced with palette - Palette Texture ID to be used for this material
override_armor_assets has been removed
- Overrides are now defined in the Resource Pack Equipment Asset
See the Resource Pack section for details about Palette Texture IDs

Instruments

The format of elements in the instrument registry have been updated:

Added durability_damage field - optional non-negative integer, amount of durability to consume on each use
Updated use_duration field - can now be 0 for no cooldown

Entity Data

Added invulnerable_time tag which makes an entity temporarily invulnerable for a specific number of ticks

Block Entity Data

Changed minecraft:decorated_pot

The sherds field no longer stores a list of 4 item IDs. Instead, the new format is an object with 4 optional item stack fields named:

back
left
right
front

Changed minecraft:sign and minecraft:hanging_sign

By default, commands and other click events contained in Sign text are no longer executed when the block is clicked
- Additionally, text components on newly placed Signs are no longer resolved by default
- A new boolean field called allow_op_features (defaults to false) has been added to restore previous behavior
- Placed Signs and items with the minecraft:block_entity_data component containing Sign data stored in worlds saved before this version will have allow_op_features set to true
- Any newly created Sign will need to have that field set explicitly
Changed the rules for opening the Sign edit screen after a block is placed:
- Previously, the screen would open unless minecraft:block_entity_data was applied successfully
- Now, the screen will open only if it could be opened normally by clicking the block (i.e. it's not waxed and only has editable text on the front side)
Signs will now accept and return the minecraft:sign_text_front, minecraft:sign_text_back, and minecraft:waxed components

Changed minecraft:brewing_stand

The following fields are now stored as integers rather than shorts:

Changed the BrewTime field from a short to an integer, this is the amount of time that the current brewing process has taken so far
Changed the Fuel field from a byte to an integer, this is the amount of fuel remaining

The following new fields have been added:

total_brew_time - integer, the total amount of time the current brewing process will take
total_fuel - integer, represents the amount of fuel that was added in the last refuel
speed_multiplier - float, used to speed up or slow down the next brewing process

Changed minecraft:furnace, minecraft:smoker, and minecraft:blast_furnace

The following fields are now stored as integers rather than shorts:

Changed the cooking_time_spent field from a short to an integer, this is the amount of time that the current cooking process has taken so far
Changed the cooking_total_time field from a short to an integer, this is the total amount of time the current cooking process will take
Changed the lit_time_remaining field from a short to an integer, this is the amount of burn time remaining
Changed the lit_total_time field from a short to an integer, this is the total amount of burn time that was added in the last refuel

The following new fields have been added:

speed_multiplier - float, used to speed up or slow down the next brewing process

Advancements

Validation

Visible root advancements (i.e. ones that have a display field, but no parent field) must always declare a background field in the display structure
Only root advancements can have a background field in the display structure

Rewards

The loot sub-field in the rewards field now accepts an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a minecraft:loot_table type

Triggers

Multiple fields that accepted a list of loot conditions are now stricter:
- The previous functionality of a list of conditions being equivalent to a single minecraft:all_of condition has been removed
- Additionally, the type field is now mandatory (previously it defaulted to minecraft:entity_properties)
Some fields that previously accepted only inline loot conditions now also accept a namespaced ID of a minecraft:predicate
The player field, available on all triggers except minecraft:impossible, now accepts an inline value or a namespaced ID of a minecraft:predicate type
- To avoid duplication, this field is not mentioned in entries below

Changed minecraft:any_block_use

The location field now accepts an inline value or a namespaced ID of a minecraft:predicate type

Changed minecraft:bee_nest_destroyed

The block field has been renamed to blocks and now accepts a single namespaced ID, a list of namespaced IDs, or a hash-prefixed tag ID of a minecraft:block type
Added field state that matches block state properties (same format as minecraft:enter_block)

Changed minecraft:bred_animals

The child, parent, and partner fields now accept an inline value or a namespaced ID of a minecraft:predicate type

Changed minecraft:brewed_potion

The potion field now accepts a minecraft:potion_contents data component predicate

Changed minecraft:cured_zombie_villager

The villager and zombie fields now accept an inline value or a namespaced ID of a minecraft:predicate type

Changed minecraft:default_block_use

The location field now accepts an inline value or a namespaced ID of a minecraft:predicate type

Changed minecraft:effects_changed

The source field now accepts an inline value or a namespaced ID of a minecraft:predicate type

Changed minecraft:enter_block

The block field has been renamed to blocks and now accepts a single namespaced ID, a list of namespaced IDs, or a hash-prefixed tag ID of a minecraft:block type

Changed minecraft:fall_after_explosion

The cause field now accepts an inline value or a namespaced ID of a minecraft:predicate type

Changed minecraft:fishing_rod_hooked

The entity field now accepts an inline value or a namespaced ID of a minecraft:predicate type

Changed minecraft:placed_block

The location field now accepts an inline value or a namespaced ID of a minecraft:predicate type

Changed minecraft:item_used_on_block

The location field now accepts an inline value or a namespaced ID of a minecraft:predicate type

Changed minecraft:allay_drop_item_on_block

The location field now accepts an inline value or a namespaced ID of a minecraft:predicate type

Changed minecraft:player_killed_entity

The entity field now accepts an inline value or a namespaced ID of a minecraft:predicate type
The killing_blow.tags.id field now accepts a single namespaced ID, a list of namespaced IDs, or a hash-prefixed tag ID of a minecraft:damage_type type

Changed minecraft:entity_killed_player

The entity field now accepts an inline value or a namespaced ID of a minecraft:predicate type
The killing_blow.tags.id field now accepts a single namespaced ID, a list of namespaced IDs, or a hash-prefixed tag ID of a minecraft:damage_type type

Changed minecraft:kill_mob_near_sculk_catalyst

The entity field now accepts an inline value or a namespaced ID of a minecraft:predicate type
The killing_blow.tags.id field now accepts a single namespaced ID, a list of namespaced IDs, or a hash-prefixed tag ID of a minecraft:damage_type type

Changed minecraft:lightning_strike

The bystander and lightning fields now accept an inline value or a namespaced ID of a minecraft:predicate type

Changed minecraft:player_generates_container_loot

The loot_table field has been renamed to loot_tables and now accepts a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a minecraft:loot_table type
- If a tag or a list is used, the trigger will run when any listed loot table is generated

Changed minecraft:thrown_item_picked_up_by_player

The entity field now accepts an inline value or a namespaced ID of a minecraft:predicate type

Changed minecraft:thrown_item_picked_up_by_entity

The entity field now accepts an inline value or a namespaced ID of a minecraft:predicate type

Changed minecraft:player_hurt_entity

The entity field now accepts an inline value or a namespaced ID of a minecraft:predicate type
The damage.type.tags.id field now accepts a single namespaced ID, a list of namespaced IDs, or a hash-prefixed tag ID of a minecraft:damage_type type

Changed minecraft:entity_hurt_player

The damage.type.tags.id field now accepts a single namespaced ID, a list of namespaced IDs, or a hash-prefixed tag ID of a minecraft:damage_type type

Changed minecraft:player_interacted_with_entity

The entity field now accepts an inline value or a namespaced ID of a minecraft:predicate type

Changed minecraft:player_sheared_equipment

The entity field now accepts an inline value or a namespaced ID of a minecraft:predicate type

Changed minecraft:crafter_recipe_crafted

The recipe_id field has been renamed to recipes and now accepts a single namespaced ID, a list of namespaced IDs, or a hash-prefixed tag ID of a minecraft:recipe type
- If a tag or a list is used, the trigger will run when any listed recipe is used

Changed minecraft:recipe_crafted

The recipe_id field has been renamed to recipes and now accepts a single namespaced ID, a list of namespaced IDs, or a hash-prefixed tag ID of a minecraft:recipe type
- If a tag or a list is used, the trigger will run when any listed recipe is used

Changed minecraft:recipe_unlocked

The recipe field has been renamed to recipes and now accepts a single namespaced ID, a list of namespaced IDs, or a hash-prefixed tag ID of a minecraft:recipe type
- If a tag or a list is used, the trigger will run when any listed recipe is unlocked

Changed minecraft:slide_down_block

The block field has been renamed to blocks and now accepts a single namespaced ID, a list of namespaced IDs, or a hash-prefixed tag ID of a minecraft:block type

Changed minecraft:summoned_entity

The entity field now accepts an inline value or a namespaced ID of a minecraft:predicate type

Changed minecraft:tame_animal

The entity field now accepts an inline value or a namespaced ID of a minecraft:predicate type

Changed minecraft:target_hit

The projectile field now accepts an inline value or a namespaced ID of a minecraft:predicate type

Changed minecraft:villager_trade

The villager field now accepts an inline value or a namespaced ID of a minecraft:predicate type

Slot Sources

Slot sources can now be defined as files inside a Data Pack, within the slot_source folder
- Can be used in commands which take slot sources as arguments
minecraft:contents is no longer restricted to only selecting non-empty slots

Changed minecraft:group

The terms field now accepts an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a minecraft:slot_source type
The inline format of minecraft:group (previously only a list of inline slot sources) can now also accept a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a minecraft:slot_source type
- This format is now consistently available for all fields of a slot source (but not for stand-alone files)

Changed minecraft:filtered

The slot_source field now accepts an inline value or a namespaced ID of a minecraft:slot_source type

Changed minecraft:contents

The slot_source field now accepts an inline value or a namespaced ID of a minecraft:slot_source type

Changed minecraft:limit_slots

The slot_source field now accepts an inline value or a namespaced ID of a minecraft:slot_source type

Changed minecraft:slot_range

The source field has a new valid type container, which sources slots from a container or inventory provided through loot context
The source field is now optional
- Defaults to the container source type when absent

Loot Tables

Added till/rooted_dirt loot table for drops when Rooted Dirt is tilled with a hoe
Multiple block loot tables now reference predicates for checking if a tool has Silk Touch and is Shears instead of inlining a copy of those checks
The rolls field now accepts an inline value or a namespaced ID of a minecraft:context_int_provider type
The bonus_rolls field now accepts an inline value or a namespaced ID of a minecraft:context_float_provider type

Loot Table Types

Added minecraft:command_slot_source

Currently used to evaluate slot sources with the /item and /execute commands
It takes the following parameters:
- container, the container or inventory being evaluated
- origin, the position at which the command was executed
- this_entity, the @s entity of the command being executed (optional)

Added minecraft:command_compute_default

Currently used for the /compute default command
It takes the following parameters:
- origin, the position at which the command was executed
- this entity, the @s entity of the command being executed (optional)

Added minecraft:command_compute_position

Currently used for the /compute block command
It takes the following parameters:
- Everything included in minecraft:command_compute_default
- block_entity, the block entity of the block at the position given in a command
- block_state, the current state of the block at the position given in a command

Added minecraft:command_compute_entity

Currently used for the /compute entity command
It takes the following parameters:
- Everything included in minecraft:command_compute_default
- target_entity, the entity selected by the selector given in a command

Added minecraft:container_process

Currently used to evaluate cooking and brewing fuel values
It takes the following parameters:
- container, the container or inventory being evaluated
- block_entity, the block entity being fueled
- block_state, the current state of the block being fueled
- origin, the location of the block being fueled

Changed minecraft:advancement_location

Block entities are now available in context and can be matched by conditions like minecraft:match_block

Changed minecraft:block_interact

origin is now available in context, as the center of the block being interacted with

Loot Pool Entries

The conditions field in loot pool entries has been renamed to condition and now accepts an inline value or a namespaced ID of a minecraft:predicate type
The functions field in loot pool entries has been renamed to modifier and now accepts an inline value (including a list as a short form of minecraft:sequence) or a namespaced ID of a minecraft:item_modifier type
- This field is now present on all loot entries, including previously omitted minecraft:alternatives, minecraft:sequence, and minecraft:group

Changed minecraft:tag

The name field has been renamed to items and now accepts a single namespaced ID, a list of namespaced IDs, or a hash-prefixed tag ID of a minecraft:item type

Changed minecraft:loot_table

The value field now accepts a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a minecraft:loot_table type
Added expand field, working the same as in the minecraft:tag pool entry:
- if true, each entry inside the tag will be added to the outer pool, with weights equal to the weight of this entry
- if false, this pool entry will operate as a single entry in the outer pool
  - If this entry gets selected, it will return all items from all referenced loot tables

Loot Functions

The conditions field is now available in all loot functions and has been renamed to condition
- It now also accepts an inline value or a namespaced ID, but no longer an inline list of conditions
- The functionality of the old condition list format can be achieved by explicitly using the minecraft:all_of loot condition type
The function field (describing the function type) has been renamed to type

Changed minecraft:sequence

The functions field now accepts an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a minecraft:item_modifier type
Added an optional condition field which accepts an inline value or a namespaced ID of a minecraft:predicate type
The inline format of minecraft:sequence (previously only a list of inline functions) can now also accept a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a minecraft:item_modifier type
- This format is now consistently available for all fields of a loot function type (but not for stand-alone files), which means that every such field can accept an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a minecraft:item_modifier type

Changed minecraft:modify_contents

The modifier field now accepts an inline value or a namespaced ID of a minecraft:item_modifier type

Changed minecraft:set_attributes

Number providers in the amount sub-fields of the modifiers list now accept an inline value or a namespaced ID of a minecraft:context_float_provider type

Changed minecraft:enchanted_count_increase

The count field now accepts an inline value or a namespaced ID of a minecraft:context_float_provider type

Changed minecraft:enchant_with_levels

The levels field now accepts an inline value or a namespaced ID of a minecraft:context_int_provider type

Changed minecraft:set_custom_model_data

Elements in the floats list can now be an inline value or a namespaced ID of a minecraft:context_float_provider type
Elements in the colors list can now be an inline value or a namespaced ID of a minecraft:context_int_provider type

Changed minecraft:set_enchantments

Values in the enchantments map can now be an inline value or a namespaced ID of a minecraft:context_int_provider type

Changed minecraft:set_count

The count field now accepts an inline value or a namespaced ID of a minecraft:context_int_provider type

Changed minecraft:limit_count

The min and max fields inside the limit structure now accept an inline value or a namespaced ID of a minecraft:context_int_provider type
The limit field no longer accepts a single number

Changed minecraft:set_damage

The damage field now accepts an inline value or a namespaced ID of a minecraft:context_float_provider type

Changed minecraft:set_ominous_bottle_amplifier

The amplifier field now accepts an inline value or a namespaced ID of a minecraft:context_int_provider type

Changed minecraft:set_random_dyes

The number_of_dyes field now accepts an inline value or a namespaced ID of a minecraft:context_int_provider type

Changed minecraft:set_stew_effect

The duration field in the elements of the effects list now accepts an inline value or a namespaced ID of a minecraft:context_int_provider type

Changed minecraft:set_loot_table

Removed unused field type
The name field has been renamed to loot_table_id

Changed minecraft:exploration_map

The destination field is no longer optional and now accepts a single namespaced ID, a list of namespaced IDs, or a hash-prefixed tag ID of a minecraft:structure type
The map_color field has been removed
The function no longer changes the type of the item it is applied to - it now only adds map data to the existing item
- Previously it required a minecraft:map and produced a minecraft:filled_map
- The item to produce is now chosen by the loot entry or villager trade itself, so a data pack that produced exploration maps has to change its item from minecraft:map to minecraft:filled_map (or one of the explorer map items)
- If no matching structure is found, the item is left without a minecraft:map_id - use minecraft:filtered with minecraft:discard_item to drop those, as the vanilla loot tables and villager trades now do

Removed minecraft:reference

This function has become obsolete, as any field that takes a function now accepts (among other things) a namespaced ID to other functions

Predicates

The condition field (describing the predicate type) has been renamed to type

Changed minecraft:all_of

The terms field now accepts an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a minecraft:predicate type
Note: values of this type can no longer be shortened to a single list, a full object with the type minecraft:all_of needs to be used explicitly

Changed minecraft:any_of

The terms field now accepts an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a minecraft:predicate type

Changed minecraft:inverted

The term field now accepts an inline value or a namespaced ID of a minecraft:predicate type

Changed minecraft:random_chance

The chance field now accepts an inline value or a namespaced ID of a minecraft:context_float_provider type

Removed minecraft:value_check

This condition has been split into integer and float variants

Added minecraft:int_value_check

Checks a value against some range

Fields:

value - an inline value or a namespaced ID of a minecraft:context_int_provider type
test - one of:
- an inline value (including a single integer) or a namespaced ID of a minecraft:context_int_provider type
  - Will test if the result of value is equal to the provided test value
- an object with fields:
  - min - an optional inline value (including a single integer) or a namespaced ID of a minecraft:context_int_provider type
  - max - an optional inline value (including a single integer) or a namespaced ID of a minecraft:context_int_provider type
  - Will test if the result of value is between min and max (inclusive)

Added minecraft:float_value_check

Checks value against some range

Fields:

value - an inline value or a namespaced ID of a minecraft:context_float_provider type
test - one of:
- an inline value (including a single float) or a namespaced ID of a minecraft:context_float_provider type
  - Will test if the result of value is equal to the provided test value
- an object with fields:
  - min - an optional inline value (including a single float) or a namespaced ID of a minecraft:context_float_provider type
  - max - an optional inline value (including a single float) or a namespaced ID of a minecraft:context_float_provider type
  - Will test if the result of value is between min and max (inclusive)

Changed minecraft:time_check

The min and max fields inside the value structure now accept an inline value or a namespaced ID of a minecraft:context_int_provider type
The value field itself now accepts an inline value or a namespaced ID of a minecraft:context_int_provider type (previously only integers were allowed)

Changed minecraft:entity_scores

The min and max fields inside the values of the scores map now accept an inline value or a namespaced ID of a minecraft:context_int_provider type
The scores field itself now accepts an inline value or a namespaced ID of a minecraft:context_int_provider type (previously only integers were allowed)

Changed minecraft:damage_source_properties

The predicate.tags.id field now accepts a single namespaced ID, a list of namespaced IDs, or a hash-prefixed tag ID of a minecraft:damage_type type

Removed minecraft:reference

This condition has become obsolete, as any field that takes a loot condition now accepts (among other things) a namespaced ID to other conditions

Added Vanilla Predicates

New entries added to the previously empty minecraft:predicate:

minecraft:tool/can_silk_touch
minecraft:tool/can_shear
minecraft:block/fast_cooking

Added minecraft:match_block Condition Type

Matches block state and optionally block entity data and components (if present)

Fields (same as the elements of the minecraft:can_place_on component):

blocks - optional block id, list of namespaced block IDs, or hash-prefixed block tag to match
state - optional map of block state property keys to values to match
nbt - optional block entity NBT to match
- The match will fail if this field is present but no block entity is available in the context
components - optional map of exact components to match
- The match will fail if this field is present but no block entity is available in the context
predicates - optional map of component predicates to match
- The match will fail if this field is present but no block entity is available in the context

Removed minecraft:block_state_property Condition Type

This has been fully replaced by minecraft:match_block

Potion Predicates

The minecraft:potion_contents Data Component Predicate has been changed to allow matching on specific potion effects.

The previous predicate format used a list of potion types, the new format allows for more refined matching.

The following fields can be used in any combination, all are optional:

potions - a list of potion types or a potion tag to match
effects - a Collection Predicate of mob_effects predicates to match
- The Collection Predicate format is as follows:
  - contains - a list of mob_effects predicates to match
  - count - a list of options for matching a specific number of mob effect predicates, which follow the same format as the minecraft:effects entity sub-predicate
    - test - the mob_effects predicate to match
    - count - the number of matches required, or with min and max will match a range of counts
  - size - require the mob effects list to have a specific size, or with min and max will match a range of sizes

The mob_effects predicate format is a mapping of effect types to properties of that effect. All fields are optional, only the provided fields will be used for matching:

    {
        "minecraft: <effect type>": {
          "duration": <integer bounds representing a duration in ticks>,
          "amplifier": <integer bounds>,
          "ambient: true/false,
          "visible": true/false
        }
    )

Here is an example of matching on several different effects and criteria:

      "effects": {
        "minecraft:jump_boost": {
          "duration": 3600,
          "amplifier": 5,
          "ambient: true,
          "visible": true
        },
        "minecraft:speed": {
          "duration": {
            "min": 360,
            "max": "3600
          },
          "amplifier: {
            "min": 2
          }
        },
        "minecraft:resistance": {}
      }

All criteria are optional.

Number Providers

The minecraft:number_provider type has been split into two separate types: minecraft:context_int_provider (integer number providers) and minecraft:context_float_provider (float number providers)
Note: those new types should not be confused with the already existing minecraft:int_provider_type and minecraft:float_provider_type, which are context-free providers, used mostly for world generation

Integer Number Providers

Added the minecraft:context_int_provider registry
All calculations are performed using 32-bit integers
The result of calculations that provide invalid values (like division by zero) is undefined
Fields:
- type - a namespaced ID from minecraft:context_int_provider_type registry
- <type-specific fields>

Added Vanilla Integer Number Providers

minecraft:compostable/low
- returns 1 if the minecraft:block_state context parameter is an empty composter, otherwise has a 30% chance of returning 1
minecraft:compostable/low_medium
- returns 1 if the minecraft:block_state context parameter is an empty composter, otherwise has a 50% chance of returning 1
minecraft:compostable/medium
- returns 1 if the minecraft:block_state context parameter is an empty composter, otherwise has a 65% chance of returning 1
minecraft:compostable/medium_high
- returns 1 if the minecraft:block_state context parameter is an empty composter, otherwise has an 85% chance of returning 1
minecraft:compostable/always_add_one
- always returns 1
minecraft:cooking/time_bamboo
- Returns the burn time in ticks for Bamboo and Scaffolding
minecraft:cooking/time_blaze_rod
- Returns the burn time in ticks for Blaze Rods
minecraft:cooking/time_boats
- Returns the burn time in ticks for Boats
minecraft:cooking/time_coal
- Returns the burn time in ticks for Coal
minecraft:cooking/time_coal_block
- Returns the burn time in ticks for Coal Blocks
minecraft:cooking/time_dried_kelp_block
- Returns the burn time in ticks for Dried Kelp Blocks
minecraft:cooking/time_dry_plants
- Returns the burn time in ticks for various dry plants
minecraft:cooking/time_hanging_signs
- Returns the burn time in ticks for Hanging Signs
minecraft:cooking/time_lava_bucket
- Returns the burn time in ticks for Lava Buckets
minecraft:cooking/time_roots
- Returns the burn time in ticks for Mangrove Roots
minecraft:cooking/time_wood_blocks
- Returns the burn time in ticks for wood blocks
minecraft:cooking/time_wood_items_extra_small
- Returns the burn time in ticks for very small wood items such as Buttons
minecraft:cooking/time_wood_items_large
- Returns the burn time in ticks for large wood items such as Doors
minecraft:cooking/time_wood_items_small
- Returns the burn time in ticks for small wood items such as Bows
minecraft:cooking/time_wood_slabs
- Returns the burn time in ticks for wood slabs
minecraft:cooking/time_wool
- Returns the burn time in ticks for most Wool blocks
minecraft:cooking/time_wool_carpets
- Returns the burn time in ticks for Wool Carpets
minecraft:cooking/time_wool_slabs
- Returns the burn time in ticks for Wool Slabs and Cushions
minecraft:cooking/normal_burn_time_reduction_factor
- Returns the burn time reduction factor for cooking fuel when used in a normal furnace
minecraft:cooking/fast_burn_time_reduction_factor
- Returns the burn time reduction factor for cooking fuel when used in a block matching the block/fast_cooking predicate
minecraft:brewing/uses_default
- Returns the default number of brews provided by brewing fuel

Added minecraft:abs

Returns the absolute value of input
If the final result does not fit inside a 32-bit integer, the calculation will be canceled
Fields:
- input - an inline value or a namespaced ID of a minecraft:context_int_provider type

Added minecraft:avg

Evaluates multiple integer providers and returns the arithmetic mean of all results
Division rounds towards 0
Fields:
- inputs - an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a minecraft:context_int_provider type
  - Requires at least one value

Added minecraft:binomial

Makes n random coin flips with the probability of succeeding equal to p, then returns the number of successes
Fields:
- n - the number of coin flips, an inline value or a namespaced ID of a minecraft:context_int_provider type
- p - the probability of a single coin flip succeeding ([0.0, 1.0]), an inline value, or a namespaced ID of a minecraft:context_float_provider type

Added minecraft:conditional

Returns the value from on_true if its condition is fulfilled or on_false if not
Fields:
- condition - an inline value or a namespaced ID of a minecraft:predicate type
- on_true - an inline value or a namespaced ID of a minecraft:context_int_provider type which is executed if its condition is fulfilled
- on_false - an optional inline value or a namespaced ID of a minecraft:context_int_provider type
  - Defaults to a constant 0 if omitted

Added minecraft:constant

Returns a constant value
Fields:
- value - an integer
Can also be written inline as a plain number (foo: 1 is equivalent to foo: {type:"minecraft:constant",value:1})

Added minecraft:sub

Returns left minus right
If the final result does not fit inside a 32-bit integer, the calculation will be canceled
Fields:
- left - an inline value or a namespaced ID of a minecraft:context_int_provider type
- right - an inline value or a namespaced ID of a minecraft:context_int_provider type

Added minecraft:from_float

Evaluates a float provider and converts it to an integer value
Noninteger values will be truncated (i.e. rounded towards zero)
Values that don't fit inside a 32-bit integer (including NaN) are treated as errors and will cancel the calculation
Fields:
- input - an inline value or a namespaced ID of a minecraft:context_float_provider type

Added minecraft:max

Evaluates multiple integer providers and returns the largest of all results
Fields:
- inputs - an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a minecraft:context_int_provider type
  - Requires at least one value

Added minecraft:min

Evaluates multiple integer providers and returns the smallest of all results
Fields:
- inputs - an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a minecraft:context_int_provider type
  - Requires at least one value

Added minecraft:mod

Returns the modulus of left by right
Uses truncated integer division (rounds towards zero)
Division by zero is treated as an error and will cancel the calculation
Fields:
- left - an inline value or a namespaced ID of a minecraft:context_int_provider type
- right - an inline value or a namespaced ID of a minecraft:context_int_provider type

Added minecraft:floor_mod

Returns the modulus of left by right
Uses floored integer division (rounds towards negative infinity)
Division by zero is treated as an error and will cancel the calculation
Fields:
- left - an inline value or a namespaced ID of a minecraft:context_int_provider type
- right - an inline value or a namespaced ID of a minecraft:context_int_provider type

Added minecraft:environment_attribute

Fetches and provides the value of an Environment Attribute (minecraft:environment_attribute)
Fields
- attribute - the Environment Attribute ID to fetch (must be representable as an int)

Added minecraft:negate

Returns the negation of input
If the final result does not fit inside a 32-bit integer, the calculation will be canceled
Fields:
- input - an inline value or a namespaced ID of a minecraft:context_int_provider type

Added minecraft:number_dispatcher

Returns the first case which fulfills its condition or the default if none do
Fields:
- cases - a list of cases in the order that the dispatcher will try to execute them
  - Fields:
    - condition - an inline value or a namespaced ID of a minecraft:predicate type
    - value - an inline value or a namespaced ID of a minecraft:context_int_provider type which is executed if the condition is fulfilled
- default - an optional inline value or a namespaced ID of a minecraft:context_int_provider type
  - Defaults to a constant 0 if omitted

Added minecraft:pow

Returns base to the power of exponent
If the exponent is negative, the calculation will be canceled
If both the base and the exponent are zero, the calculation will be canceled
If the final result does not fit inside a 32-bit integer, the calculation will be canceled
Fields:
- base - an inline value or a namespaced ID of a minecraft:context_int_provider type
- exponent - an inline value or a namespaced ID of a minecraft:context_int_provider type

Added minecraft:mul

Evaluates multiple integer providers and returns the product of all results
If the final result does not fit inside a 32-bit integer, the calculation will be canceled
Fields:
- inputs - an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a minecraft:context_int_provider type
  - Requires at least one value

Added minecraft:div

Returns left divided by right
Uses truncated integer division (rounds towards zero)
Division by zero is treated as an error and will cancel the calculation
Fields:
- left - an inline value or a namespaced ID of a minecraft:context_int_provider type
- right - an inline value or a namespaced ID of a minecraft:context_int_provider type

Added minecraft:floor_div

Returns left divided by right
Uses floored integer division (rounds towards negative infinity)
Division by zero is treated as an error and will cancel the calculation
If the final result does not fit inside a 32-bit integer, the calculation will be canceled
Fields:
- left - an inline value or a namespaced ID of a minecraft:context_int_provider type
- right - an inline value or a namespaced ID of a minecraft:context_int_provider type

Added minecraft:score

Returns a score of the selected target
If the score is not present, the provider returns the value of fallback
Fields:
- score - objective name
- target - score holder (same format as in the number provider version)
- fallback - an optional inline value or a namespaced ID of a minecraft:context_int_provider type
  - Defaults to a constant 0 if omitted

Added minecraft:storage

Returns an integer value from a command storage
If the value is not present, is not a number, or the path returned multiple values, the provider returns the value of fallback
The conversion of numeric NBT values that are not an integer is undefined
Fields:
- storage - a namespaced ID of a command storage
- path - an NBT path
- fallback - an optional inline value or a namespaced ID of a minecraft:context_int_provider type
  - Defaults to a constant 0 if omitted

Added minecraft:add

Evaluates multiple integer providers and returns the sum of all results
If the final result does not fit inside a 32-bit integer, the calculation will be canceled
Fields:
- inputs - an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a minecraft:context_int_provider type
  - Requires at least one value

Added minecraft:uniform

Picks a random integer from a closed range
Fields:
- min - minimum value (inclusive), an inline value, or a namespaced ID of a minecraft:context_int_provider type
- max - maximum value (inclusive), an inline value, or a namespaced ID of a minecraft:context_int_provider type

Added minecraft:weighted_list

Returns a value from a distribution of weighted number providers
Fields:
- distribution - a list of objects with the following fields
  - Fields:
    - data - an inline value or a namespaced ID of a minecraft:context_int_provider type
    - weight - a positive integer

Float Number Providers

Added a minecraft:context_float_provider registry
All calculations are performed using single-precision floating-point numbers ("floats")
The result of calculations that produce NaN and Infinity is undefined
Format:
- type - a namespaced ID from minecraft:context_float_provider_type registry
- <type-specific fields>

Added Vanilla Float Number Providers

minecraft:cooking/speed_default
- Returns the default speed multiplier for cooking fuel
minecraft:cooking/normal_speed_multiplier
- Returns the speed multiplier for cooking fuel when used in a normal Furnace
minecraft:cooking/fast_speed_multiplier
- Returns the speed multiplier for cooking fuel when used in a block matching the block/fast_cooking predicate
minecraft:brewing/speed_default
- Returns the default speed multiplier for brewing fuel

Added minecraft:abs

Returns the absolute value of input
Fields:
- input - an inline value or a namespaced ID of a minecraft:context_float_provider type

Added minecraft:avg

Evaluates multiple float providers and returns the arithmetic mean of all results
Fields:
- inputs - an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a minecraft:context_float_provider type
  - Requires at least one value

Added minecraft:ceil

Returns the ceiling (i.e. rounded towards positive infinity) value of input
Fields:
- input - an inline value or a namespaced ID of a minecraft:context_float_provider type

Added minecraft:conditional

Returns the value from on_true if its condition is fulfilled or on_false if not
Fields:
- condition - an inline value or a namespaced ID of a minecraft:predicate type
- on_true - an inline value or a namespaced ID of a minecraft:context_float_provider type which is executed if its condition is fulfilled
- on_false - an optional inline value or a namespaced ID of a minecraft:context_float_provider type
  - Defaults to a constant 0.0 if omitted

Added minecraft:constant

Returns a constant value
Fields:
- value - a float
Can also be written inline as a plain number (foo: 1.0 is equivalent to foo: {type:"minecraft:constant",value:1.0})

Added minecraft:cos

Returns the cosine of input
Fields:
- input - argument in radians, an inline value, or a namespaced ID of a minecraft:context_float_provider type

Added minecraft:sub

Returns left minus right
Fields:
- left - an inline value or a namespaced ID of a minecraft:context_float_provider type
- right - an inline value or a namespaced ID of a minecraft:context_float_provider type

Added minecraft:enchantment_level

Evaluates Enchantment Level-Based (minecraft:enchantment_level_based_value_type) parameter
Fields:
- amount: A Level-Based Value giving a value based on the level of the Enchantment

Added minecraft:environment_attribute

Fetches and provides the value of an Environment Attribute (minecraft:environment_attribute)
Fields
- attribute - the Environment Attribute ID to fetch (must be representable as a float)

Added minecraft:floor

Returns the floored (i.e. rounded towards negative infinity) value of input
Fields:
- input - an inline value or a namespaced ID of a minecraft:context_float_provider type

Added minecraft:from_int

Evaluates an integer provider and converts it to a float value
Fields:
- input - an inline value or a namespaced ID of a minecraft:context_int_provider type

Added minecraft:length

Evaluates multiple float providers and returns the square root of the sum of squares
Fields:
- inputs - an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a minecraft:context_float_provider type
  - Requires at least one value

Added minecraft:max

Evaluates multiple float providers and returns the largest of all results
Fields:
- inputs - an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a minecraft:context_float_provider type
  - Requires at least one value

Added minecraft:min

Evaluates multiple float providers and returns the smallest of all results
Fields:
- inputs - an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a minecraft:context_float_provider type
  - Requires at least one value

Added minecraft:mod

Returns the modulus of left by right
Fields:
- left - an inline value or a namespaced ID of a minecraft:context_float_provider type
- right - an inline value or a namespaced ID of a minecraft:context_float_provider type

Added minecraft:negate

Returns the negation of input
Fields:
- input - an inline value or a namespaced ID of a minecraft:context_float_provider type

Added minecraft:number_dispatcher

Returns the first case which fulfills its condition or default if none do
Fields:
- cases - a list of cases in the order that the dispatcher will try to execute them
  - Fields:
    - condition - an inline value or a namespaced ID of a minecraft:predicate type
    - value - an inline value or a namespaced ID of a minecraft:context_float_provider type which is executed if the condition is fulfilled
- default - an optional inline value or a namespaced ID of a minecraft:context_float_provider type
  - Defaults to a constant 0.0 if omitted

Added minecraft:pow

Returns base to the power of exponent
Fields:
- base - an inline value or a namespaced ID of a minecraft:context_float_provider type
- exponent - an inline value or a namespaced ID of a minecraft:context_float_provider type

Added minecraft:mul

Evaluates multiple float providers and returns the product of all results
Fields:
- inputs - an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a minecraft:context_float_provider type
  - Requires at least one value

Added minecraft:div

Returns left divided by right
Fields:
- left - an inline value or a namespaced ID of a minecraft:context_float_provider type
- right - an inline value or a namespaced ID of a minecraft:context_float_provider type

Added minecraft:round

Returns the rounded (towards the nearest integer, with ties rounding towards positive infinity) value of input
Fields:
- input - an inline value or a namespaced ID of a minecraft:context_float_provider type

Added minecraft:sin

Returns the sine of input
Fields:
- input - argument in radians, an inline value, or a namespaced ID of a minecraft:context_float_provider type

Added minecraft:sqrt

Returns the square root of input
Fields:
- input - an inline value or a namespaced ID of a minecraft:context_float_provider type

Added minecraft:storage

Returns a float value from a command storage
If the value is not present, is not a number, or the path returned multiple values, the provider returns the value of fallback
The conversion of numeric NBT values that are not a float is undefined
Fields:
- storage - a namespaced ID of a command storage
- path - an NBT path
- fallback - an optional inline value or a namespaced ID of a minecraft:context_float_provider type
  - Defaults to a constant 0.0 if omitted

Added minecraft:add

Evaluates multiple float providers and returns the sum of all results
Fields:
- inputs - an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a minecraft:context_float_provider type
  - Requires at least one value

Added minecraft:truncate

Returns the truncated (rounded towards zero) value of input
Fields:
- input - an inline value or a namespaced ID of a minecraft:context_float_provider type

Added minecraft:uniform

Picks a random number from a range
Fields:
- min - minimum value, an inline value, or a namespaced ID of a minecraft:context_float_provider type
- max - maximum value, an inline value, or a namespaced ID of a minecraft:context_float_provider type

Added minecraft:weighted_list

Returns a value from a distribution of weighted number providers
Fields:
- distribution - a list of objects with the following fields
  - Fields:
    - data - an inline value or a namespaced ID of a minecraft:context_float_provider type
    - weight - a positive integer

Recipes

Potion Brewing Recipes

Potion brewing recipes are now data-driven. New recipes can be added via data packs, and vanilla recipes may be modified. Brewing recipes use the minecraft:brewing type.

The main contents are:

input - a potion ingredient with a required item field and an optional potion_contents field using a minecraft:potion_contents Data Component Predicate
reagent - a potion ingredient with a required item field and an optional potion_contents field using a minecraft:potion_contents Data Component Predicate
output - item stack, the resulting item

Here is an example of a vanilla recipe:

{
  "type": "minecraft:brewing",
  "input": {
    "item": "minecraft:potion",
    "potion_contents": {
      "potion": "minecraft:water"
    }
  },
  "output": {
    "components": {
      "minecraft:potion_contents": {
        "potion": "minecraft:awkward"
      }
    },
    "id": "minecraft:potion"
  },
  "reagent": {
    "item": "minecraft:nether_wart"
  }
}

Any items may be used in any of the 3 slots, for example:

{
  "type": "minecraft:brewing",
  "input": { "item": "minecraft:bucket" },
  "output": { "id": "minecraft:sulfur_cube_bucket" },
  "reagent": { "item": "minecraft:potent_sulfur" }
}

Cooking Recipes

The cookingtime field of all cooking recipes is no longer optional.

The recipes for Smokers and Blast Furnaces now use the same cooking time in their data definition as their Furnace counterparts.

The cooking time speedup is now done through the minecraft:cooking/speed_default Number Provider used by the furnace fuel components.

Custom Smoker and Blast Furnace recipes should be updated accordingly, by setting cookingtime to twice the previous value.

If a custom cooking recipe was previously relying on the default cookingtime value, 200 can be used to maintain the same timing.

Block Transformers

Added a minecraft:block_transformer registry containing rules for transforming a block into another block
Format: list of objects with fields:
- block_state_provider - Block State Provider, used to provide the state for the transformed block
  - If the Block State Provider returns no result (as by rule_based, for example), the next rule in the list will be attempted
  - The set of Block State Providers are the same as the Block State Providers used in World Generation
- sound - optional field, Sound Event to play on interaction, e.g. minecraft:item.axe.strip
  - If not present, defaults to play no Sound Event
- particle - optional field, particles to play on interaction
  - One of:
    - none
    - scrape
    - wax_on
    - wax_off
  - If not present, defaults to none
- disallowed_faces - optional field, list of directions specifying faces on the clicked Block that cannot be interacted with
  - One of:
    - up
    - down
    - north
    - south
    - east
    - west
  - If a disallowed face is interacted with, the next rule in the list will be attempted
  - If not present, defaults to an empty list
- loot - optional Loot Table, the Loot Table to use for dropping items on a successful transformation, e.g. minecraft:till/rooted_dirt
  - If not present, defaults to using no Loot Table
- drop_strategy - optional field, configures from where in the Block any loot should drop
  - One of:
    - from_middle - from the middle of the Block
    - clicked_face - from the face interacted with
  - If not present, defaults to from_middle
- update_from_neighbors - optional boolean, if the transformed block should update based on neighboring blocks. This allows e.g. fences to connect
  - If not present, defaults to true
- transform_type - optional field, configures how nearby blocks should be affected by the transformation
  - One of:
    - single_block - only affects the Block interacted with
    - copper_chest - if input and output blocks are both copper chests of any weathering state, waxed or unwaxed, this transformation will affect both sides of a double chest
  - If not present, defaults to single_block
- consume_on_use - optional boolean, determines if the item should be consumed or not
  - Only applies to stackable items
  - If not present, defaults to true
- item_damage_per_use - optional integer, determines how much damage the item takes with each use
  - Only applies to non-stackable items
  - If not present, defaults to 0
Default values in vanilla:
- minecraft:shovel - default value for shovels
- minecraft:axe - default value for axes
- minecraft:hoe - default value for hoes

World Generation

Cave Air is no longer generated in Nether caves

Biomes

Removed the spawners, spawn_costs, and creature_spawn_probability fields
- These values have been moved to the new Environment Attributes

Features

The worldgen/configured_feature registry has moved to worldgen/feature and configuration is now done inline in the root object rather than separated into a config field
Removed feature types:
- minecraft:coral_mushroom
- minecraft:kelp
- minecraft:seagrass
- minecraft:sea_pickle
- minecraft:nether_forest_vegetation
- minecraft:twisting_vines
- minecraft:weeping_vines
- minecraft:desert_well

Developer's Note: These feature types are no longer needed, since the features they previously hardcoded are now implemented with other, more configurable functionality.

Changed minecraft:coral_claw and minecraft:coral_tree

Added field feature, a Placed Feature that is used to place at every desired block position

Changed minecraft:stepped_column_cluster (renamed from minecraft:basalt_columns)

Now exposes more control over the feature functionality.

Format changes:

Renamed field reach to column_reach
Added fields:
- block- Block state provider, which block to place
- can_replace - Block predicate, which blocks can be replaced by the column
- continue_through - Block predicate, which pre-existing blocks to accept as part of a column
- cannot_place_on - Block ID, list of Block IDs, or hash-prefixed Block Tag ID, which blocks are avoided when starting placement
- column_count - int provider (between 1 and 150), the number of columns to generate
- cluster_reach - int provider (between 0 and 13), the size of the square to attempt to generate columns in
  - The effective reach is also limited by height

Changed minecraft:single_block_pillar (renamed from minecraft:basalt_pillar)

Now exposes more control over the feature functionality.

Added fields:
- block - Block state provider, which block to place
- can_replace - Block predicate, which blocks to replace
- direction - one of up and down, vertical direction of the pillar
- chance_to_continue - optional float between 0 and 1, probability that the pillar continues another block (assuming can_replace matches)
  - If omitted, defaults to 1
- cap_feature - optional Placed Feature, placed at the end of the pillar

Changed minecraft:random_neighbor_spread (renamed from minecraft:glowstone_blob)

Now exposes more control over the feature. Places blocks randomly in an area starting at the origin, each block placing so it has exactly one accepted neighbor.

Added fields:
- block - Block state provider, which block to place
- accepted_neighbors - Block ID, list of Block IDs, or hash-prefixed Block Tag, which blocks count as a valid neighbor
- can_replace - Block predicate, which blocks to replace
- attempts - int provider (between 1 and 3000), how many placement attempts to make
- xz_offset - int provider (between -16 and 16), what offsets to try along the x and z axes
- y_offset - int provider (between -16 and 16), what offsets to try along the y-axis

Changed minecraft:sculk_patch

Removed extra_rare_growths and catalyst_chance fields

Added minecraft:overlay

Places a set of features in the same location. Note that as opposed to the minecraft:sequence Feature Type, all features are placed regardless of individual placement success.

Format: object with fields:
- features - Placed Feature ID, non-empty list of Placed Feature IDs, or hash-prefixed Placed Feature Tag, the features to place

Added minecraft:projected_random_patchy_square

Generates a square where each block is randomly placed or not placed with its probability based on the distance from the center of the square, with the center more likely to generate than the edges. Each placed block can be projected downwards if the appropriate conditions are met.

Format: object with fields:
- block - Block state provider, which block to place
- project_through - Block Predicate, which blocks are considered "empty" and should be projected through
- size - int provider (between 1 and 16), determines the size of the square as measured from the center to the edge
- max_projection_height - non-negative integer, the maximum change in y level from the original height to the placement height for a block in the square

Added minecraft:end_podium

Places the End Podium
Two feature instances are now used to place the podium from in-game events:
- end_podium_active
- end_podium_inactive
Format: object with fields:
- active - boolean, whether the portal is active

Changed minecraft:template

Added field processors: Namespaced ID or inline definition of a structure processor list to apply to the template

Changed minecraft:tree

Added shelf_mushroom Tree Decorator Type

Places Shelf Mushrooms on logs with the specified probability
Format: object with fields:
- probability - float (between 0 and 1), the probability that any Shelf Mushrooms will be placed for a given feature

Added poplar_foliage_placer Foliage Placer Type

Places Leaf blocks for Poplar trees in a rhombus shape in one of two possible directions
Format: Common fields for all foliage placers plus:
- height - int provider (between 5 and 16), the height of the foliage
- side_hole_chance - float (between 0.0 and 1.0), the chance for blocks to be randomly removed at the edge of the foliage

Added poplar_trunk_placer Trunk Placer Type

Places Log blocks for Poplar trees in a straight shape with branches by the start of the foliage
Format: Common fields for all trunk placers plus:
- trunk_height_above_branches - int provider (between 0 and 8), the height of the trunk above the branches
- branch_amount - int provider (between 1 and 4), the amount of branches to create by the foliage

Placement Modifiers

Added minecraft:cuboid

Repeats a feature in a cuboid shape.

Added fields:
- xz_size - int provider (between 1 and 16), the size of the cuboid along x and z axes
- y_size - int provider (between 1 and 16), the size of the cuboid along the y-axis
- include_interior - optional boolean, whether to place interior blocks of the cuboid
  - If omitted, defaults to true
- include_edges - optional boolean, whether to place edge blocks of the cuboid
  - Setting this to false generates a somewhat "rounded" cuboid
  - If omitted, defaults to true

Added minecraft:random_chance

Gates the feature being placed behind a random chance.

Format: object with fields:
- chance - float (between 0 and 1), the chance that the feature gets placed

Added minecraft:randomly_selected

Randomly selects a Placement Modifier from a list and delegates placement to it.

Format: object with fields:
- placements - non-empty list of Placement Modifiers to pick from

Changed minecraft:offset (renamed from minecraft:random_offset)

Format changes:
- Removed fields xz_spread and y_spread
- Added fields x, y, z - integer providers (between -16 and 16), the axis-specific offset

Block State Providers

Block State Providers can now be defined as stand-alone types in the worldgen/block_state_provider registry and referenced by using a namespaced string for a field that expects a Block State Provider.

An inline Block State definition is now an accepted shorthand form for a minecraft:simple block state provider providing that state. The Block State has to be in the form of an object with fields, a shorthand Block ID is not allowed.

Renamed Provider Types

The following providers types have been renamed:

minecraft:dual_noise_provider renamed to minecraft:dual_noise
minecraft:noise_provider renamed to minecraft:noise
minecraft:noise_threshold_provider renamed to minecraft:noise_threshold
minecraft:randomized_int_state_provider renamed to minecraft:randomized_int
minecraft:rule_based_state_provider renamed to minecraft:rule_based
minecraft:simple_state_provider renamed to minecraft:simple
minecraft:weighted_state_provider renamed to minecraft:weighted

Added minecraft:copy_properties

Copies common Block State properties from the Block at the evaluated position to the resulting state

Format: object with fields:
- source - Block State Provider, the Block State which the copied properties are copied on top of
  - Only properties common between both the source and the target blocks will be copied

Added minecraft:random_block

Returns the default block state for a randomly chosen block.

Format: object with fields:
- blocks: Block ID, list of Block IDs, or hash-prefixed Block Tag, the set of blocks to randomly pick from

Changed minecraft:rotated

Now works on any block with axis or facing properties.

Format changes:
- Changed field state - now a Block State Provider
- Added field direction - optional direction, the direction to set
  - If omitted, a random direction is chosen

Changed minecraft:rule_based

If a rule yields no result, the following rules will be evaluated
If no rule or fallback yields a result, will now also yield no result

Noise Settings

The surface_rule field has been renamed to material_rule
- Format: inline Material Rule or Material Rule ID reference
The final_density field no longer has the beardifier Density Function implicitly added to the final result
Renamed preliminary_surface_level to chunk_surface_level
- This Density Function is no longer implicitly interpolated across the entire chunk
The aquifers_enabled field has been replaced by an optional aquifers object:
- If not present, no aquifers will be generated
- Fields:
  - barrier - Density Function, moved from noise_router.barrier
  - fluid_level_floodedness - Density Function, moved from noise_router.fluid_level_floodedness
  - fluid_level_spread - Density Function, moved from noise_router.fluid_level_spread
  - lava - Density Function, moved from noise_router.lava
  - surface_level - Density Function, duplicated from noise_router.preliminary_surface_level
  - exclusion - Density Function, any aquifer cell where this value is positive will have no fluid
The ore_veins_enabled field has been removed, and replaced by the minecraft:ore_vein Material Rule
The following fields from noise_router have been moved:
- barrier, fluid_level_floodedness, fluid_level_spread, lava - moved into aquifers field
- vein_toggle, vein_ridged, vein_gap - moved into the minecraft:ore_vein Material Rule
Removed noise.size_horizontal and noise.size_vertical fields, these are now specified in the interpolated density function
Added optional debug_functions field - list of objects with fields, Density Function values to show in the chunk_generation_stats debug entry
- Fields:
  - label - string, label to identify this Density Function
  - function - Density Function, the Density Function to compute and show at the player position
- If not specified, no density function values will be shown

Spawn Target

The spawn_target field has been updated to allow use of any Density Function, instead of just a subset of those defined within the noise_router field.

The suitability of a candidate spawn position is determined by evaluating, in some arbitrary n-dimensional space, the squared Euclidean distance to a set of target hypercubes.

For example, one axis might be temperature and the second erosion - and suitability determined by distance to the square between temperature=0.1, erosion=0.2 and temperature=0.3, erosion=0.5. This would prefer any candidate spawn within those ranges equally, while penalizing candidate spawns very far out of that range.

Format: list of target hypercubes

Target format: map between Density Function ID and a range on that axis:
- Range is specified as one of:
  - Float, an exact target value
  - Array of 2 floats, a range of target values in form [min, max]
  - An object with fields:
    - min - float, the minimum value of the target range
    - max - float, the maximum value of the target range

Material Rules

Material Rule Registry

A new data-driven registry has been introduced, loaded from data/<namespace>/worldgen/material_rule/<id>.json.

Elements in this registry define a pipeline for selecting what base block to place in the world at a given position.

The format is identical to that which was formerly written in the surface_rule field within Noise Settings files, with the following extensions:

Material Rules can now be specified either inline (as previously), or as an ID reference to an element in the worldgen/material_rule registry
Material Conditions can also now be specified as an ID reference to an element in the worldgen/material_condition registry

Material Condition Registry

A new data-driven registry has been introduced, loaded from data/<namespace>/worldgen/material_condition/<id>.json.

Elements in this registry define a condition that can be referenced within a Material Rule pipeline (e.g. testing biome or surface depth).

The format is identical to that which was formerly written within the condition Material Rule type, with the following extension:

Material Conditions can also now be specified as an ID reference to an element in the worldgen/material_condition registry

Added minecraft:ore_vein

Format: object with fields:
- ore_block - Block State, the ore block to place
- raw_ore_block - Block State, the raw ore block to place
- filler_block - Block State, the filler block to place
- raw_ore_chance - float between 0 and 1, the probability for a raw_ore_block to be placed instead of an ore_block
- density - Density Function, the probability between 0 and 1 for the ore vein to replace a block
  - If 0 or lower, no block will be replaced
- richness - Density Function, the probability between 0 and 1 for ore_block or raw_ore_block to be placed (as opposed to filler_block)
  - If 0 or lower, all blocks will be filler_block
  - If 1 or greater, no blocks will be filler_block
- filler_gap - Density Function, acts as an override to richness: if positive, filler_block will always be placed

Noises

The format of Noises (defined in the worldgen/noise registry, or inline in noise-based Block State Providers) has been updated.

Noises define a fractal Brownian motion (fBm) configuration with the following properties:

Produces output values (approximately) fitting a normal distribution
Unless otherwise specified, fits the output amplitude to [-1; 1]
- Due to the normal distribution, in practice this means that 99.7% of all samples will fit in that range - but values may still be encountered outside of this range
Parameterized by persistence=0.5, lacunarity=2.0
- i.e. between each octave, the amplitude is halved and the frequency doubled
Has stable seeding such that an octave can be boosted, muted, or added without affecting the rest of the octaves
Renamed firstOctave to base_octave
Added base_amplitude - positive float, a scale factor to apply to the noise output
- If not specified, defaults to 1.0
Added octave_count - integer between 1 and 32, the number of octaves to sample
Added normalize - boolean, or "legacy", controls how the output amplitude should be normalized
- If true, base_amplitude is the expected amplitude of the output (i.e. 99.7% of all samples in [-base_amplitude; base_amplitude])
- If false, base_amplitude is the amplitude of the first octave
- If "legacy", inherits the same normalization behavior as expressed by the previous format
  - This would generally fit to a range smaller than expected
- If not specified, defaults to true
- Note: normalization is not affected by the amplitude_modifiers field - as such, modifying the amplitude of a single octave will not affect the amplitude of others
Renamed amplitudes to amplitude_modifiers - list of floats, a scaling factor to apply to each octave
- The number of elements in this list must match octave_count
- As described above, this scaling factor bypasses normalization and will affect the output amplitude
- This field is no longer required - if not specified, defaults to all 1.0

Density Functions

Density Functions and noises are no longer evaluated with double-precision floating point values, but instead with single-precision
- This affects all intermediate steps, not just the final result

Developer's Note: _We are aware that the details of floating point rounding have been used in some Data Packs, and this change may affect specific configurations. We have introduced alternatives for the use-cases that we are aware of, but please do share with us on feedback.minecraft.net or in the feedback Discord if you encounter use-cases that are no longer possible to support.

Changed minecraft:constant

argument has been renamed to value

Changed minecraft:noise

The following fields have been introduced:

shift_x - optional Density Function, a domain warp to apply on x
- If not specified, no warping will be applied (equivalent to 0)
shift_y - optional Density Function, a domain warp to apply on y
- If not specified, no warping will be applied (equivalent to 0)
shift_z - optional Density Function, a domain warp to apply on z
- If not specified, no warping will be applied (equivalent to 0)

Removed minecraft:shifted_noise

Replaced by minecraft:noise

Changed minecraft:add, minecraft:mul, minecraft:min, and minecraft:max

argument1 has been renamed to left
argument2 has been renamed to right

Changed minecraft:abs, minecraft:square, minecraft:cube, minecraft:half_negative, minecraft:quarter_negative, minecraft:squeeze, minecraft:interpolated, minecraft:flat_cache, minecraft:cache_2d, minecraft:cache_once, minecraft:cache_all_in_cell, and minecraft:blend_density

argument has been renamed to input

Changed minecraft:shift_a, minecraft:shift_b, and minecraft:shift

argument has been renamed to noise

Added minecraft:sub

Performs subtraction between two arguments.

Format: object with fields:
- left - Density Function, the left-hand side of the operation
- right - Density Function, the right-hand side of the operation

Added minecraft:div

Performs division between two arguments.

Format: object with fields:
- left - Density Function, the left-hand side of the operation
- right - Density Function, the right-hand side of the operation

Changed minecraft:reciprocal (renamed from minecraft:invert)

No changes to the format

Added minecraft:negate

Negates the input.

Format: object with fields:
- input - Density Function, the function to negate

Added minecraft:lerp

Performs (unclamped) linear interpolation between two arguments based on an alpha.

Format: object with fields:
- alpha - Density Function, the interpolation factor (0=first, 1=second)
  - Any value outside of [0; 1] will extrapolate
- first - Density Function, the value at alpha=0
- second - Density Function, the value at alpha=1

Added minecraft:floor, minecraft:round, minecraft:ceil, and minecraft:truncate

Rounds the input value to an integer multiple of a given function in a type-dependent direction:

floor rounds towards negative infinity
round rounds towards the nearest integer (ties round up)
ceil rounds towards positive infinity
truncate rounds towards 0

Format: object with fields:

input - Density Function, the input to round
multiple - Density Function, the output will be rounded to an integer multiple of this value
- If not specified, defaults to constant 1 (i.e. rounding to integer)

Added minecraft:pow

Raises the given base value to an exponent.

Format: object with fields:
- base - Density Function, the base value
- exponent - Density Function, the exponent

Added minecraft:sqrt

Computes the square root of the given input.

Format: object with fields:
- input - Density Function, the value for which to compute the square root

Added minecraft:log

Computes the natural logarithm of the given input.

Format: object with fields:
- input - Density Function, the value for which to compute the natural logarithm

Added minecraft:sign

Computes the sign of the input:

If the input is positive, returns 1
If the input is 0, returns 0
If the input is negative, returns -1

Format: object with fields:

input - Density Function, the value of which to compute the sign

Added minecraft:distance_to_point

Computes the distance to a fixed point using the specified distance function.

Format: object with fields:
- point - array of 3 integers in form [x, y, z], the point to compute distance to
- metric - one of:
  - euclidean - i.e. sqrt(dx^2 + dy^2 + dz^2)
  - euclidean_squared - i.e. dx^2 + dy^2 + dz^2
  - manhattan - i.e. abs(dx) + abs(dy) + abs(dz)
  - chebyshev - i.e. max(abs(dx), abs(dy), abs(dz))

Changed minecraft:gradient (renamed from minecraft:y_clamped_gradient)

Format: object with fields:
- axis - x, y, or z, the axis over which to define this gradient
- tiling - one of:
  - clamp_to_edge - outside the gradient boundaries, the value at the nearest boundary will be used
  - repeat - the gradient will be repeated outside its boundaries
  - mirrored_repeat - the gradient will be repeated such that odd repetitions are mirrored, ensuring continuity between repetitions
- from_coordinate - int, the coordinate at which the gradient starts
- to_coordinate - int, the coordinate at which the gradient ends
  - Must not be equal to from_coordinate
- from_value - float, the value at which the gradient starts
- to_value - float, the value at which the gradient ends

Added minecraft:slice

Removes a dimension from the input domain by taking a "slice" along an axis with a specific coordinate. For example, with axis=y and coordinate=0, a slice will be taken along the XZ plane, with all values sampled at y=0.

Format: object with fields:
- axis - x, y, or z, the axis to remove
- coordinate - int, the fixed coordinate to be passed to the input function
- input - Density Function, the input function

Added minecraft:beardifier

Outputs the structure bearding density. Generally summed together with the base terrain density to produce ground below, carve air around, or bury structures.

Format: no fields

Changed minecraft:end_outer_islands (renamed from minecraft:end_islands)

No longer computes the density of the main island.

Changed minecraft:interpolated

Added fields:
- cell_size_xz - positive int, size in blocks of the interpolation grid cells on the XZ axes
- cell_size_y - positive int, size in blocks of the interpolation grid cells on the Y axis

Changed minecraft:cache (renamed from minecraft:cache_once)

No format change

Removed minecraft:cache_2d, minecraft:cache_all_in_cell, and minecraft:flat_cache

May be replaced with minecraft:cache
minecraft:slice may be used to always pick Y=0, as formerly handled by minecraft:flat_cache

Structure Pool Elements

Changed minecraft:feature_pool_element

Can now connect to Jigsaw blocks with any target name, instead of just minecraft:bottom

Structure Placements

Added minecraft:dimension_origin

Places a single instance of the structure at the dimension origin
- The dimension origin is defined as the spawn_target for noise settings based dimensions, otherwise Chunk (0, 0)
No additional fields

Block Predicates

Added minecraft:height_range

Checks the height of the position against a given range.

Format: object with fields:
- min_inclusive - Vertical Anchor, the minimum height required
- max_inclusive - Vertical Anchor, the maximum height required

Added minecraft:volume_match

Checks that every block in a volume matches a given Block Predicate.

Format: object with fields:
- min - list of 3 integers in range -16 to 16, the lower corner of the volume as an offset from the test position
- max - list of 3 integers in range -16 to 16, the upper corner of the volume as an offset from the test position
- match - Block Predicate to test on each position

Vertical Anchors

Added a new option for Vertical Anchors:
- relative_to_sea_level - specifies an offset to the sea level of the dimension

Rule Tests

These are the predicates used by ore Features (targets[].target), and rule Structure Processors (rules[].input_predicate and rules[].location_predicate).

Added minecraft:height_match

Checks the y-level of a block, returning true only if it's higher than or equal to min_inclusive and lower than or equal to max_inclusive
Format: object with fields:
- min_inclusive - int, the minimum y value of allowed blocks (inclusive)
- max_inclusive - int, the maximum y value of allowed blocks (inclusive)

Added minecraft:all_of

Checks a list of Rule Tests for whether all of them return true for the same block
Format: object with fields:
- rules - list of Rule Tests, the rules to test the block against

Added minecraft:any_of

Checks a list of Rule Tests for whether any of them returns true for the same block
Format: object with fields:
- rules - list of Rule Tests, the rules to test the block against

Added minecraft:not

Checks a Rule Test for whether it returns false for a given block
Format: object with fields:
- rule - Rule Test, the rule to test the block against

Carvers

The worldgen/configured_carver registry has been renamed to worldgen/carver

Changed minecraft:cave

All fields previously under the config field have been inlined to the top-level
Added count field - non-negative Int Provider, the number of Cave tunnels to create from a seed chunk
Renamed yScale to room_vertical_radius_multiplier
Added optional start_vertical_radius_multiplier field - Float Provider, acts as a multiplier for the vertical radius of the first segment in each tunnel
- If not specified, defaults to 1.0
Added thickness field - non-negative Float Provider, acts as a multiplier for the radius of carved tunnels
Added optional weird_thickness_bias field - Boolean
- If true, thickness will be multiplied by, with a 10% chance: random(0, 1) * random(0, 3) + 1
- If not specified, defaults to false
Removed replaceable field, carvers will replace any block (excluding features)
Removed lava_level field, fluids are now always selected by the aquifer or sea_level configuration in the dimension
Removed debug_settings field

Changed minecraft:canyon

All fields previously under the config field have been inlined to the top-level
Renamed and moved yScale to shape.y_scale
Removed replaceable field, carvers will replace any block (excluding features)
Removed lava_level field, fluids are now always selected by the aquifer or sea_level configuration in the dimension
Removed debug_settings field

Removed minecraft:nether_cave

Replaced by minecraft:cave

Int Providers

Added minecraft:very_biased_to_bottom Int Provider Type

Picks a random value in the provided range, with a quadratic bias towards the minimum value.

Format: object with fields:
- min_inclusive - integer, the minimum selected value (inclusive)
- max_inclusive - integer, the maximum selected value (inclusive)

Villager Trades

The given_item_modifiers field has been renamed to given_item_modifier
- Note: unlike other fields of type minecraft:item_modifier, this field does not support namespaced elements or tag IDs
The max_uses and xp fields now require an inline value of a minecraft:context_int_provider type
The count field in the wants and additional_wants structures now require an inline value of a minecraft:context_int_provider type
The reputation_discount field now requires an inline value of a minecraft:context_float_provider type

Particles

Added minecraft:red_poplar_leaves

Falls from Red Poplar Leaves blocks
Has no fields

Added minecraft:orange_poplar_leaves

Falls from Orange Poplar Leaves blocks
Has no fields

Added minecraft:yellow_poplar_leaves

Falls from Yellow Poplar Leaves blocks
Has no fields

Resource Pack Versions 89.0 through 97.1

Palette Textures

All armor trim palette textures have been moved from textures/trim/color_palettes/ to textures/palettes/trim/
- The base armor trim palette texture has instead been moved to textures/palettes/trim_base.png
Entity armor trim material textures are no longer generated into the minecraft:trims atlas with paletted_permutations, but rather generated on-demand
- The base palette ID is now specified in a new palette mcmeta section field
- This section has a single field: base_palette - the base Palette Texture ID to remap from
Item armor trim material textures are still generated with paletted_permutations as before

paletted_permutations Sprite Source

Palette Texture locations in the palette_key and permutations fields have been replaced by Palette Texture IDs - i.e. <namespace>:<path> now resolves to <namespace>:textures/palettes/<path>.png

Equipment Assets

A new optional trim_overrides field can be used to swap out the texture or palette used with specific trim materials or patterns for a given equipment asset. This replaces functionality formerly supported by override_armor_assets in the trim material, as well as custom atlas overrides.

Format: list of override entries with fields:
- when - object with fields, the material and/or pattern to match
  - material - optional Trim Material ID, the material to match (if specified)
  - pattern - optional Trim Pattern ID, the pattern to match (if specified)
  - At least one of material or pattern must be specified
  - If both are specified, both must match for the entry to be used
- texture - optional trim pattern asset ID, a replacement texture to use if this entry matches
  - Textures are specified in the same format as asset_id
  - If not specified, the default texture for the pattern will be used
- palette - optional palette ID, a replacement palette to use if this entry matches
  - If not specified, no palette remapping will be applied to the texture
- The first matching entry will always be selected
- At least one of texture or palette must be defined

Block Sprites

Added new Block textures:
- block/orange_poplar_leaves.png
- block/poplar_door_bottom.png
- block/poplar_door_top.png
- block/poplar_log.png
- block/poplar_log_top.png
- block/poplar_planks.png
- block/poplar_sapling.png
- block/poplar_shelf.png
- block/poplar_sign.png
- block/poplar_trapdoor.png
- block/red_poplar_leaves.png
- block/red_shrub.png
- block/shelf_mushroom_stage0.png
- block/shelf_mushroom_stage1.png
- block/straw_bed.png
- block/stripped_poplar_log.png
- block/stripped_poplar_log_top.png
- block/poplar_hanging_sign.png
- block/yellow_poplar_leaves.png

Item Sprites

Added new Item textures:
- item/abandoned_camp_map.png
- item/black_cushion.png
- item/blue_cushion.png
- item/brown_cushion.png
- item/buried_ancient_city_map.png
- item/buried_mineshaft_map.png
- item/buried_treasure_map.png
- item/buried_trial_chambers_map.png
- item/cyan_cushion.png
- item/desert_pyramid_map.png
- item/desert_village_map.png
- item/gray_cushion.png
- item/green_cushion.png
- item/jungle_pyramid_map.png
- item/light_blue_cushion.png
- item/light_gray_cushion.png
- item/lime_cushion.png
- item/magenta_cushion.png
- item/ocean_monument_map.png
- item/orange_cushion.png
- item/pink_cushion.png
- item/plains_village_map.png
- item/poplar_boat.png
- item/poplar_chest_boat.png
- item/poplar_door.png
- item/poplar_hanging_sign.png
- item/poplar_sign.png
- item/purple_cushion.png
- item/red_cushion.png
- item/savanna_village_map.png
- item/snowy_village_map.png
- item/swamp_hut_map.png
- item/taiga_village_map.png
- item/warm_ocean_ruins_map.png
- item/white_cushion.png
- item/woodland_mansion_map.png
- item/yellow_cushion.png
Removed Item textures:
- item/filled_map_markings.png
- item/light.png

UI Sprites

Added new UI textures:
- gui/hanging_signs/poplar.png
- gui/signs/poplar.png
- gui/realms/friends.png
- gui/realms/minigames.png
- gui/realms/private_server.png
- gui/sprites/widget/realms_button.png
- gui/sprites/widget/realms_button_disabled.png
- gui/sprites/widget/realms_button_highlighted.png

Entity Textures

Added new Entity textures:
- entity/boat/poplar.png
- entity/chest_boat/poplar.png
- entity/cushion/black_cushion.png
- entity/cushion/blue_cushion.png
- entity/cushion/brown_cushion.png
- entity/cushion/cyan_cushion.png
- entity/cushion/gray_cushion.png
- entity/cushion/green_cushion.png
- entity/cushion/light_blue_cushion.png
- entity/cushion/light_gray_cushion.png
- entity/cushion/lime_cushion.png
- entity/cushion/magenta_cushion.png
- entity/cushion/orange_cushion.png
- entity/cushion/pink_cushion.png
- entity/cushion/purple_cushion.png
- entity/cushion/red_cushion.png
- entity/cushion/white_cushion.png
- entity/cushion/yellow_cushion.png

Map Sprites

Added new Map textures:
- abandoned_camp.png
- ancient_city.png
- desert_pyramid.png
- mineshaft.png
- warm_ocean_ruins.png
The following Icons have been updated in order to show player rotation on the map:
- player.png
- player_off_limits.png
- player_off_map.png

Block Crumbling Overlay Textures

Added new block crumbling overlay textures that replace the existing ones for translucent blocks rendered with OIT:
- block/destroy_oit_stage_0.png
- block/destroy_oit_stage_1.png
- block/destroy_oit_stage_2.png
- block/destroy_oit_stage_3.png
- block/destroy_oit_stage_4.png
- block/destroy_oit_stage_5.png
- block/destroy_oit_stage_6.png
- block/destroy_oit_stage_7.png
- block/destroy_oit_stage_8.png
- block/destroy_oit_stage_9.png

Sounds

Added new sound events:
- block.shelf_mushroom.break
- block.shelf_mushroom.fall
- block.shelf_mushroom.place
- block.shelf_mushroom.step
- block.shelf_mushroom.bounce
- block.poplar_leaves.ambient
- block.straw_bed.break
- block.straw_bed.break_leave
- block.straw_bed.step
- block.straw_bed.place
- block.straw_bed.hit
- block.straw_bed.fall
- block.poplar_leaves.break
- block.poplar_leaves.fall
- block.poplar_leaves.place
- block.poplar_leaves.step
- block.poplar_leaves.hit
- block.red_shrub.break
- block.red_shrub.place
- entity.cushion.break
- entity.cushion.place
- entity.cushion.get_up
- entity.cushion.sit

Particles

Added new Particle textures:
- orange_poplar_1.png
- orange_poplar_2.png
- orange_poplar_3.png
- orange_poplar_4.png
- red_poplar_1.png
- red_poplar_2.png
- red_poplar_3.png
- red_poplar_4.png
- yellow_poplar_1.png
- yellow_poplar_2.png
- yellow_poplar_3.png
- yellow_poplar_4.png
- shelf_mushroom_particle.png
- straw_bed_particle.png

Item Models

Added optional shade_direction_override to block model elements
- Accepted values are cardinal directions (down, up, north, south, west, east)
- When set, this overrides directional shading for the element regardless of face orientation
Removed shade from block model elements
- Use shade_direction_override: "up" to get the previous shade: false behavior

Tint Sources

Removed minecraft:map_color
- The minecraft:map_color component it read no longer exists

Shaders & Post-process Effects

terrain.vsh and terrain.fsh shaders are refactored to support multi-draw
Some of the members in Globals and DynamicTransforms are shuffled to use less memory for those uniform blocks

Developer's Note: Although it is possible in Resource Packs, overriding Core Shaders is considered as unsupported and not an intended Resource Pack feature. These shaders exist as part of the internal implementation of the game, and as such, may change at any time as the game's internals evolve. We understand that overriding Core Shaders is used for very cool Resource Pack features, many of which lack supported alternatives. We would like to provide better, supported alternatives in the future.

Order-independent Transparency (OIT)-related Shader Changes

Added new shaders to support order-independent transparency:
- core/blit_depth.fsh
- core/oit_composite.fsh
- core/oit_depth_bounds_cull.fsh
- include/oit.glsl
- include/oit_add_transmittance.glsl
- include/oit_common.glsl
- include/oit_depth_bounds.glsl
- include/oit_depth_sample.glsl
- include/oit_sample.glsl
Extracted the texture sampling logic from core/terrain.fsh into include/texture_sampling.glsl
Renamed the following core shaders:
- core/rendertype_clouds.vsh → core/clouds.vsh
- core/rendertype_clouds.fsh → core/clouds.fsh
- core/rendertype_world_border.vsh → core/world_border.vsh
- core/rendertype_world_border.fsh → core/world_border.fsh
Updated core shaders to support order-independent transparency
- Introduced new defines:
  - OIT - If present, indicates that OIT is enabled
  - OIT_DEPTH_BOUNDS - If present, indicates that the depth bounds pass is being executed
  - OIT_TRANSMITTANCE - If present, indicates that the transmittance pass is being executed
  - OIT_ACCUMULATE - If present, indicates that the accumulate pass is being executed
  - OIT_ALPHA_ONLY - If present, indicates that either the depth bounds or transmittance pass is being executed
  - OIT_ADDITIVE - If present, indicates that the OIT algorithm should emulate additive blending for the executing pipeline
  - OIT_WAVELET_RANK - An integer internal to the OIT algorithm
  - OIT_COEFF_COUNT - An integer internal to the OIT algorithm
  - OIT_COEFF_ATTACHMENT_COUNT - An integer internal to the OIT algorithm
  - RENDERPEARL_DEPTH_IS_ZERO_TO_ONE - If present, indicates that the current rendering backend uses the depth range of [0, 1], it is available globally to all shaders independently of the OIT setting
  - RENDERPEARL_EXPLICIT_DEPTH_INVARIANCE - If present, indicates that an OIT shader should explicitly output a depth value because a device it is running on can produce a slightly different implicit value
  - Affected shaders:
    - core/block.fsh
    - core/block.vsh
    - core/clouds.fsh
    - core/clouds.vsh
    - core/entity.fsh
    - core/entity.vsh
    - core/item.fsh
    - core/item.vsh
    - core/particle.fsh
    - core/position_color.fsh
    - core/rendertype_beacon_beam.fsh
    - core/rendertype_clouds.fsh
    - core/rendertype_crumbling.fsh
    - core/rendertype_entity_shadow.fsh
    - core/rendertype_lightning.fsh
    - core/rendertype_lines.fsh
    - core/rendertype_world_border.fsh
    - core/terrain.fsh
    - core/terrain.vsh
    - core/text.fsh
    - core/world_border.fsh
    - core/world_border.vsh
Removed the old transparency post chain:
- post_effect/transparency.json
- shaders/post/transparency.fsh

New Core Shaders

core/integrate_depth.fsh was added and is used to integrate the "3d hud" and always-on-top gizmo depth buffers into the main depth buffer

Removed Core Shaders

core/text_background.fsh and core/text_background.vsh were removed and text background in Text Display Entities is now rendered using the text shaders

Shader Compilation Changes

Shaders are now compiled by ShaderC when using OpenGL as well, identically to when using Vulkan
Shader includes are now handled by ShaderC using #include instead of #moj_import
Shader inputs and outputs must have a location specified in shader source
- Vertex input names must still match expected names
- Vertex outputs are matched to fragment inputs solely by location, the name is now ignored
Introduced new define RENDERPEARL_INSTANCE_INDEX_INCLUDES_BASE_INSTANCE - A boolean indicating if gl_InstanceIndex follows Vulkan or OpenGL (gl_InstanceID) semantics

Developer's Note: Vertex inputs in previous versions using OpenGL were not allowed to specify a location. Compatibility can be preserved by only specifying locations when the "VULKAN" macro is defined.

Developer's Note: Vertex outputs and fragment inputs in previous versions were matched based on name alone. Compatibility can be preserved by continuing to use identical names.

Always-on Post Effect Support

A resource pack can now define a minecraft:end_of_frame post effect
It will be applied before other post effects, including the ones enabled by the new posteffect command
This post effect is always on as long as the resource pack is loaded, and cannot be controlled by the posteffect command
As usual with resource pack resources, in case of multiple packs defining this effect, the one from the last resource pack in the list will apply

Fixed bugs in 26.3

MC-4 - Item drops sometimes appear at the wrong location
MC-2157 - Particles emitted from dragon eggs when teleporting do not point in the correct direction
MC-5269 - Updating a server's address in the multiplayer menu does not update its status
MC-40597 - The interaction of the game's built-in fullscreen mode and macOS fullscreen can glitch the game window
MC-44654 - Some entities' positions are not updated on the client when teleported
MC-46421 - You cannot use Nether portals, End portals, and End gateways while in Spectator mode
MC-51859 - The line spacing of text within all hover tooltips is larger between the first and second lines
MC-58061 - Endermen can teleport onto signs
MC-59810 - Cannot break blocks while sprinting on macOS
MC-73162 - Breaking an entity that instantly breaks sometimes destroys the block behind it in Creative mode
MC-90148 - When a player gets out of a boat, the other passenger's head remains rotated sideways
MC-91006 - Some entities lose their name when placed or broken
MC-96365 - Boats and rafts retain their rotational momentum after exiting and entering them
MC-102732 - Arrows can visually bounce off of entities when barely missing them
MC-102836 - Endermen can teleport to some dangerous places
MC-102881 - Shulkers do not emit any particles when teleporting
MC-106416 - Endermen and entities eating chorus fruit can teleport outside the world border and into powder snow
MC-110989 - /spreadplayers considers signs to be valid blocks to be spread onto
MC-112580 - Structure blocks' GUI does not pause the game in singleplayer
MC-112744 - The Team NBT tag only exists for living entities
MC-113006 - Items reeled in with fishing rods do not move smoothly but appear to teleport
MC-116286 - /spreadplayers can spread entities on structure void
MC-121278 - Key combinations are mapped to the US keyboard layout even if using another layout
MC-121367 - The game doesn't use borderless fullscreen
MC-121375 - The Command (⌘) key on macOS is displayed as "Win" in the Key Binds screen
MC-122477 - Opening the chat sometimes appends the character the used key types to the message on Linux
MC-122717 - Success messages for some commands include unaffected entities, unlike the command result
MC-122731 - Camera movement stutters when turning in a boat
MC-127939 - Several keys are displayed as "scancode.number" in the Key Binds menu
MC-133407 - Key binds switch when upgrading from before 1.13 if not using a QWERTY keyboard
MC-148541 - /spreadplayers can spread players to seagrass near the surface of the water
MC-149058 - Using hotkeys to move items into the anvil UI appends the character the used key types to the new item name
MC-151857 - The success message of /give when affecting multiple players uses the wrong string
MC-154881 - Dropping an item from your hotbar at the same time as switching to another hotbar slot desyncs the second item
MC-159283 - Terrain generation fails in progressively shrinking rings centered around the End's center
MC-161885 - Many transparent things do not render behind slimes
MC-161898 - Transparent particles make other particles behind them invisible
MC-161926 - The block breaking animation is more transparent when mining ice or stained glass
MC-162159 - Riding boats above bubble columns causes players to teleport up 2 blocks
MC-168446 - Single dark oak and pale oak saplings accept bone meal despite not being able to grow
MC-168653 - Mobs, particles, clouds, water and transparent blocks don't render behind the transparent parts of shulker bullets
MC-174958 - /gamerule succeeds even when the value is not changed
MC-175180 - The Silent NBT tag still doesn't make some entities fully silent
MC-183446 - Endermen still avoid projectiles when riding minecarts or boats
MC-187669 - The world border is too dark with the "Improved Transparency" option enabled
MC-189953 - The Super key on macOS is displayed as "Win" in the Key Binds screen
MC-190203 - Transparent and specially rendered blocks, entities, clouds, water and particles don't render behind wind charges, and charged creeper, wither and breeze armor
MC-202197 - Entities' name tag background is rendered behind transparent things
MC-206356 - The motion of falling blocks is visually slow
MC-206540 - Increased input delay when riding an entity
MC-210117 - Sculk sensors don't detect ice and snow melting
MC-210584 - Water does not render behind items modified to use semi-transparent textures
MC-210734 - Translucent blocks and other entities render over invisible spiders' eyes regardless of positions
MC-212671 - Loot table entries of type tag with expand set to true do not apply loot functions to the items
MC-214113 - Endermen and shulkers can teleport onto the Nether roof
MC-218015 - Translucent blocks and other entities render over invisible endermen's eyes regardless of positions
MC-218156 - Shipwrecks and ocean ruins can generate with empty buried treasure maps
MC-222559 - Block hitboxes and entity hitboxes don't render behind semi-transparent entities
MC-222818 - You can ignite TNT in Adventure mode
MC-223321 - You can destroy turtle eggs by standing or jumping on them in spawn protection
MC-223323 - You can trample farmland in spawn protection
MC-223559 - Transparent blocks, particles, and clouds are not rendered behind semi-transparent marker armor stands
MC-224528 - Two splash texts use curly single quotes (’) instead of apostrophes (')
MC-227008 - Endermen constantly try to teleport when riding a vehicle under daylight
MC-228273 - Goats do not move correctly after they are tempted during a long jump
MC-229405 - The inside of boats blocks the rendering of most translucent objects with the "Improved Transparency" option enabled
MC-229831 - Enchanting tables' GUI has three pixels in the top right corner that shouldn't be there
MC-233888 - Pressing the Space or Enter keys to interact with elements results in the pressed key being executed again
MC-236497 - The head rotations of passengers in boats are not correctly displayed for other players
MC-237053 - Block breaking particles cannot be seen by other players
MC-237165 - Block breaking sounds cannot be heard by other players
MC-237679 - The head rotations of passengers in boats are constantly forced to turn in certain directions if the rider were to dismount the boat while moving left or right
MC-239401 - items/light.png never appears in-game; is pointlessly referenced by other game assets
MC-245030 - The "Bee buzzes" closed caption only appears when a bee buzzes for the first time
MC-247034 - Particles produced from entities growing cannot be seen by other players
MC-248600 - Particles produced from moving in powder snow cannot be seen by other players
MC-248666 - Particles produced from dragon eggs teleporting cannot be seen by other players
MC-249200 - Several entities constantly deviate visually from their actual positions on the client when teleported
MC-252369 - Data packs can fail to load due to a feature cycle when one does not exist
MC-252934 - Placing structures with paintings, item frames, or glow item frames logs Block-attached entity at invalid position: [BlockPosition]
MC-253023 - Breaking paintings, item frames, or glow item frames cannot trigger sculk shriekers
MC-254353 - A packet to remove the score is always broadcast when a score is reset
MC-254370 - The entity_scores predicate type cannot check all possible scores
MC-254547 - Villagers do not level up when exiting the world immediately after filling their experience bar
MC-254661 - /schedule clear requires a namespace in its function argument
MC-256073 - Miscolored pixel in tab_inventory.png
MC-256096 - Some entities on a team can harm teammates that walk into them when friendly fire is disabled
MC-256097 - Some entities on a team can harm their teammates when they explode when friendly fire is disabled
MC-258347 - Endermen no longer create an extra trail of particles when teleporting
MC-258579 - The player's head does not rotate with a delay from the camera in third person view while riding a vehicle
MC-259512 - Horizontal camera rotation lags when riding
MC-259583 - Brewing with a single bottle of dragon's breath does not return a glass bottle afterward
MC-259812 - Block and item displays, beds, clouds, signs, shulker boxes, and semi-transparent blocks and entities don't render behind text displays
MC-260780 - Shulker bullets always push fireballs south
MC-263100 - Cave biomes interfere with relief on exploration maps
MC-263708 - The Key Binds screen renders keypad keys the same as regular keys
MC-264003 - Boats carrying players sometimes stop abruptly when sliding along ice
MC-265423 - When villagers acquire enough experience to level up more than once, they only gain a single level
MC-265584 - TNT dispensed in bubble columns with soul sand right under visually moves through blocks above
MC-265743 - Entities, block entities, clouds and semi-transparent blocks are always rendered in front of text displays with see_through enabled
MC-266231 - Mouse buttons above 8 can't be set as key binds
MC-266429 - Holding Shift on macOS causes the hotbar scroll direction to reverse when scrolling with the mouse
MC-267902 - The failure message of /random when the specified range is too large states an incorrect maximum for the range
MC-268145 - cache_once density functions don't work
MC-268155 - Rendering gaps in the world under specific conditions
MC-268521 - The game window doesn't have a minimal width and height
MC-269968 - Can't scroll with the mouse while holding Shift on macOS (except in the hotbar)
MC-270706 - Trying to brew an uncraftable potion into a splash or lingering potion consumes the reagent but keeps the potion exactly as is
MC-270970 - The player's camera shakes when attempting to step up blocks with a boat above them
MC-271069 - Item entities appear to fly towards the player when picked up by a dolphin that isn't being rendered
MC-271297 - /fillbiome doesn't fail when no changes are made
MC-271723 - Translucent blocks and other entities render over invisible phantoms' eyes regardless of positions
MC-271724 - Translucent blocks and other entities render over invisible breezes' eyes regardless of positions
MC-272801 - Particles and translucent objects do not render when behind the ender dragon's death animation
MC-273327 - The #convertable_to_mud block tag misspells "convertible" as "convertable"
MC-273708 - Endermen taking environmental damage attempt to teleport when riding an entity
MC-274924 - Angry endermen suffocating while in boats or minecarts can attack their target from really far away
MC-275111 - Two animals in a boat look sideways instead of at the player when lured
MC-275532 - The abbreviation "fps" is inconsistently capitalized across strings
MC-276079 - Sending a swing packet to the client causes it to send one back to the server
MC-276692 - Lingering potions which land on the target's head do not grant their effects to the target
MC-277772 - Stained glass renders incorrectly through item models in stained glass with the "Improved Transparency" option enabled
MC-277906 - Ender pearls land incorrectly at high speeds
MC-278336 - The player model still flickers at very high speeds
MC-278557 - Exiting a spinning boat and then inserting a mob makes its head spin forever
MC-278771 - The incorrect command context is used when providing suggestions for redirected commands
MC-279185 - The selectWorld.load_folder_access string is missing an article before the word "folder"
MC-279285 - Experience orbs that have been stuck inside blocks rapidly accelerate toward the ground if they've been disturbed by a player's presence
MC-279395 - Trees can generate floating over ruined portals
MC-279561 - Resin brick walls without a center post are not solid
MC-279586 - Closed captions continue to fade when their sound plays again from farther away, causing visual delays in the overlay
MC-279819 - The mining speed factor of Mining Fatigue is inconsistent at level 3
MC-280250 - Projectiles sometimes desync when thrown or shot while moving
MC-293615 - Tooltip formatting of "[item] x [number]" is inconsistent across different types of items
MC-293755 - The ender dragon's neck and tail disconnect from its body when it turns
MC-295678 - Translucent blocks above water flicker when crossing chunk borders
MC-295756 - Pistons desync on the client, causing players to be moved differently compared to other entities
MC-296006 - Entities do not face the player correctly while in a boat
MC-296368 - The entity.happy_ghast.riding sound event displays no closed caption
MC-296773 - Taken screenshots are rendered as a black image on Intel graphics of Gen7 and Gen7.5 architecture
MC-297741 - Gravity-affected blocks in upwards bubble columns can visually clip through solid blocks above them
MC-298066 - Directly entering a bed from a mount places the player in the wrong place
MC-298431 - Boats are launched by slime blocks inconsistently
MC-298659 - Translucent blocks and some entities render above text displays with see_through enabled
MC-298762 - Phantoms deflect arrows shot from bows or crossbows
MC-299019 - Using a bed while riding a rideable mob causes the player to sleep either on the ground, or on top of the mob
MC-299460 - Saddled pigs in boats carried by happy ghasts can cause a desync when unequipping a carrot on a stick
MC-299582 - Special crafting recipes cannot be given or taken with /recipe and do not respect the limited_crafting game rule
MC-300000 - Players desync when teleporting all users riding a happy ghast
MC-300831 - /test locate always fails
MC-301804 - Test blocks' GUI does not pause the game in singleplayer
MC-302221 - Moving entities deflect arrows
MC-302271 - Sniffers stop sniffing after relog
MC-302537 - /give succeeds when trying to give more than 100 stacks of an item despite the failure message and no items being given
MC-302661 - Interacting with something while holding spears plays the spear jab animation
MC-302687 - Throwing items out of your inventory while holding spears plays the spear jab animation
MC-302705 - Having a spear in the main hand affects the hand animation speed for items held in the off hand
MC-303360 - Flat-cached shifted noise density functions are recalculated for every Y level
MC-303493 - The apply_impulse entity effect does not apply components of the impulse that would cause the affected entity to hit a solid block when used with a tick or location_changed advancement trigger
MC-303626 - Block hitboxes, particles, semi-transparent blocks and non-block items render behind entity hitboxes with the "Improved Transparency" option enabled
MC-303789 - Looking directly up with an apply_impulse enchantment entity effect will limit the impulse's effect on the X and Z axes to only apply on one of the two horizontal axes
MC-304195 - The arm overlay textures of parched have unused pixels not used by the model
MC-304213 - Zombies, husks and drowned hold out the incorrect arm when holding spears
MC-304594 - Spears can dismount interaction entities from their vehicles
MC-304719 - The InhabitedTime NBT tag for some chunks can be set to impossibly high values when a world is opened
MC-304920 - Spears in third person look wrong when the left hand is the main hand
MC-305214 - Arrows deflecting off of entities get offset
MC-305422 - Players can sometimes get kicked due to a waypoint packet the client fails to handle
MC-305535 - Elytra are activated after only single tapping the "Jump" key when the player is in lava
MC-305707 - /time reports success when no changes are made
MC-306012 - Armadillos can escape fenced areas when at the edge of the simulation distance
MC-306127 - Block outlines are no longer visible behind translucent items
MC-306156 - Breezes, slimes and players between translucent blocks or fluids appear behind them with the "Improved Transparency" option enabled
MC-306231 - Boats are filled with water when viewed through translucent blocks with the "Improved Transparency" option enabled
MC-306318 - Translucent items render through the head of players with a translucent item equipped on their head with the "Improved Transparency" option enabled
MC-306619 - Cannot jump while sneaking while using a Chinese input method
MC-306778 - The fog color no longer transitions smoothly when the weather changes at night while under the Night Vision effect
MC-306891 - Sneaking and then opening the chat forces the IME to switch to the corresponding CJK mode
MC-307122 - The hanging roots drop from hoeing rooted dirt appears to be hardcoded
MC-307206 - Std140Builder incorrectly pads vec3s and ivec3s
MC-307285 - Translucent blocks don't render behind sulfur cubes
MC-307319 - Low performance with the Vulkan rendering backend on Intel Arc GPUs (especially on Linux)
MC-307345 - The smoke particles produced by potent sulfur do not render behind stained glass
MC-307376 - The CPU and GPU isn't fully utilized; the framerate is stuck at 25-35 fps
MC-307384 - Screen tearing occurs with the Vulkan rendering backend in fullscreen mode with lower framerates, even if VSync is enabled
MC-307449 - Spawners with their light limits set no longer spawn mobs underground at night time
MC-307452 - Significant performance regression with the Vulkan rendering backend
MC-307596 - The OpenGL rendering backend seems to be very laggy
MC-307616 - Typo in a log message in ActiveProfiler: "aprox"
MC-307618 - Typo in a log message in SoundEngine: "disapeared"
MC-307625 - The glowing effect is not visible on block displays displaying End portals or End gateways
MC-307648 - "non-heap" is misspelled as "non-head" in the system details section of crash reports
MC-307660 - Typo in a log message in GameRenderer: "coudln't"
MC-307709 - The texture of upward facing sulfur spikes' merged tip has a single wrong pixel at the very top
MC-307890 - Some textures of geyser plume particles use the wrong color in some spots
MC-307902 - Partially transparent blocks inside sulfur cubes don't render correctly
MC-307918 - Sculk patches can cause errors in the log during world generation
MC-307933 - Deepslate ores can generate on the surface by replacing tuff around sulfur springs
MC-307938 - Low performance with the Vulkan rendering backend on AMD GPUs
MC-307996 - The game cannot use hardware acceleration on devices lacking the fillModeNonSolid Vulkan feature
MC-308008 - The success message of /tag reports that it affected more entities than it did
MC-308009 - The success message of /scoreboard players enable reports that it affected more players than it did
MC-308011 - The success message of /recipe reports that it affected more players than it did
MC-308012 - The success message of /enchant reports that it affected more entities than it did
MC-308013 - The success message of /effect reports that it affected more entities than it did
MC-308014 - The success message of /clear reports that it affected more players than it did
MC-308125 - Scroll wheel tilting/sideways scrolling appears to move the selected hotbar slot the wrong way
MC-308127 - The "Friends Screen" key bind overrides debug hotkeys using the same key
MC-308222 - World generation heightmaps do not persist properly through chunk saving and loading
MC-308254 - Dying to a sulfur cube with a magma block doesn't increment the player's killed_by:sulfur_cube statistic
MC-308314 - Custom player heads do not render their texture properly when inside a sulfur cube
MC-308344 - Validation error when compiling shaders containing in/out array or matrix variables with the Vulkan rendering backend
MC-308405 - /unpublish succeeds when the game is not published despite the failure message
MC-308406 - Item models are shown incorrectly in the smithing table menu's armor stand
MC-308460 - Some of the stems in wildflowers and pink petals render brighter
MC-308469 - Hitting the ender dragon's head hitbox no longer causes the ender dragon to take more damage
MC-308490 - The "regular" sulfur cube archetype produces stone sounds, despite no longer using stone blocks
MC-308593 - Animated blocks (notably water and lava) render incorrectly on some graphics
MC-308647 - The resource packs screen can cache font glyphs incorrectly after toggling the "Font Settings" option
MC-308694 - Using /defaultgamemode changes everyone's game mode to the one set in "Settings for Other Players" in LAN worlds
MC-308699 - Switching the host's game mode causes new LAN players to ignore the forced game mode
MC-308749 - Exiting and rejoining the same LAN session resets your game mode
MC-308752 - Frame presentation stutters heavily with the OpenGL rendering backend on Intel Arc if a GUI is opened in borderless fullscreen mode
MC-308765 - Ender pearls don't cancel the player's velocity
MC-308789 - Pointed dripstone and sulfur spikes can be destroyed by tridents in Adventure mode
MC-308798 - Dolphins take much longer to pick up items
MC-308804 - The input method does not switch to the corresponding CJK mode in the Create New World screen
MC-308809 - Full-width spaces take up more space on signs now
MC-308830 - Placing beds does not send block updates to the foot half's neighboring blocks
MC-308836 - Obfuscated text no longer keeps a consistent width
MC-308849 - Creakings can take knockback
MC-308851 - The chat_restriction.disabled_by_profile.action string is improperly capitalized
MC-308866 - Unable to change online settings when in a world
MC-308914 - End portals or End gateways held by glowing endermen do not glow
MC-308915 - End portals and End gateways do not glow when inside glowing minecarts
MC-308916 - Glowing TNT that renders as an End portal or End gateway does not glow
MC-308917 - Items with the end_cube special model type do not show a glowing outline where expected
MC-308961 - When changing the game mode using debug hotkeys while in the World Options screen, the "Game Mode" button does not update
MC-309081 - Decorated pots and chorus flowers can be destroyed by projectiles in Adventure mode
MC-309262 - Falling blocks disappear for a split second when landing
MC-309298 - Sending chat messages while having the "Chat Delay" option set to a nonzero value can sometimes kick you from the game
MC-309479 - The game crashes during the loading screen with the message "Failed to wait for frame completion" on some systems
MC-309501 - Dropped shelves rotate off-center
MC-309565 - Block outlines are rendered behind translucent elements if the "High Contrast Block Outlines" option is enabled
MC-309872 - The system freezes when pressing the Windows key with the "Exclusive Fullscreen" option enabled
MC-309875 - New translations for the tooltip of the "Improved Transparency" option are wrongly backported
MC-309891 - The chat_restriction.disabled_by_launcher string lacks a period, unlike similar strings
MC-309893 - The gamerule.minecraft.fire_spread_radius_around_player.description string lacks a period, unlike similar strings
MC-309897 - The gui.report_to_server string is improperly capitalized
MC-309898 - The editGamerule.inGame.discardChanges.title string is improperly capitalized
MC-309901 - The structure_block.position.x string is improperly capitalized
MC-309902 - Some strings contain stray spaces adjacent to line breaks
MC-309903 - The "Isn't It Iron Pick" advancement name is missing a question mark
MC-309907 - The word "whoosh" is misspelled as "woosh" in the subtitles.block.bubble_column.upwards_inside string
MC-309908 - The subtitles.entity.copper_golem.no_item_get string is missing an article before the word "item"
MC-309911 - The words "blocks" and "seconds" in the commands.worldborder.set.grow string are always pluralized
MC-309914 - The commands.op.failed string has awkward and inconsistent adverb placement, unlike similar strings
MC-309915 - The commands.kick.owner.failed string is missing articles before the words "server" and "LAN"
MC-309916 - Some /stopwatch strings incorrectly capitalize the word "Stopwatch" mid-sentence, which is inconsistent with other commands
MC-309918 - The commands.perf.started string is missing a hyphen between the words "10" and "second" and an article before the word "10"
MC-309919 - The mco.errorMessage.6002 string is improperly capitalized
MC-309920 - The mco.configure.world.close.question.line1 string is improperly capitalized
MC-309921 - The mco.snapshot.subscription.info string uses the "to" preposition instead of "with"
MC-309922 - The advMode.trackOutput string is improperly capitalized
MC-309923 - The gamerule.minecraft.entity_drops.description string is improperly capitalized
MC-309924 - The argument.enum.invalid string surrounds the placeholder with double quotes instead of single quotes, unlike every other command
MC-309925 - The mount.onboard string is improperly capitalized
MC-309926 - The selectWorld.edit.backupSize string is improperly capitalized
MC-309927 - The gui.friends.error.unauthorized string lacks a period, unlike similar strings
MC-309928 - The multiplayer.confirm_command.signature_required string lacks a period
MC-309937 - The argument.pos.outofbounds string ends with a period, unlike similar strings
MC-309938 - The quickplay.error.invalid_identifier string is missing an article before the word "world"
MC-309940 - The datapackFailure.safeMode.failed.title string ends with a period, unlike similar title strings
MC-310041 - Under specific conditions, chunk loading frequently fails
MC-310057 - Pressing the "Advancements" key bind while its menu was opened from the pause menu closes both menus
MC-310062 - Armadillos stop following players holding spider eyes after relog
MC-310076 - Mobs sometimes stop just far enough away from the player to be unable to attack them
MC-310182 - Some descriptive tooltip strings lack a period, unlike similar strings
MC-310184 - The commands.bossbar.set.max.unchanged string abbreviates "maximum" to "max", unlike similar strings
MC-310186 - The options.languageWarning string lacks a period, unlike similar strings
MC-310187 - The commands.bossbar.get.visible.visible string uses "shown" instead of "visible", unlike similar strings
MC-310188 - Some /tag list success strings always pluralize the word "tags"
MC-310232 - Resizing the game window in the Realms players menu misplaces UI elements
MC-310233 - Some strings that contain percentages have spaces before the percentage sign, unlike similar strings
MC-310236 - Some strings use an ampersand instead of the word "and", unlike similar strings
MC-310289 - Entity collisions fully above an entity's hitbox are ignored when stepping up blocks
MC-310300 - Other windows cannot be displayed on top of the game window even with the "Exclusive Fullscreen" option disabled
MC-310337 - The game log outputs the incorrect minimum format version requiring the pack_format field in pack.mcmeta
MC-310372 - Tripwires depowering breaks cross-chunk block tick processing order
MC-310476 - Projectiles only collide outright with the world border when underwater
MC-310595 - The Option key on macOS is displayed as "Alt" in the Key Binds screen
MC-310676 - The savanna_lamp_post_01 village structure contains a trailing closing square bracket in the jigsaw block's NBT
MC-310684 - Camels stop following players holding cacti after relog
MC-310787 - Villagers do not level up until the trading window is closed for several seconds
MC-310939 - Interacting with camels with two passengers is preferred over using items
MC-310962 - The trading UI opens and immediately closes when interacting with a villager whose trades were altered with commands
MC-311094 - Villager discounts do not apply until the trading window is closed and reopened
MC-311113 - The game does not hand off focus when clicking links on Wayland
MC-311186 - The water overlay and fog does not render when the player's head is inside a block underwater
MC-311235 - Upgrading a world from before 26.1 can cause data from other worlds to get saved inside it
MC-311245 - Ruined portals can generate replacing End portal frames
MC-311271 - Some loot context parameters are missing from the generic loot context type
MC-311272 - The game crashes when referenced loot context parameters are not provided by certain loot tables
MC-311323 - Locating a structure creates an empty region file for every candidate chunk in ungenerated terrain
MC-311414 - Players can teleport arbitrary distances by using a desynced carrot on a stick on a pig
MC-311419 - Breaking a falling block with another one on top causes the top block to briefly become invisible when landing, revealing unlit block particles
MC-311453 - Particles from feeding flowers to brown mooshrooms cannot be seen by other players
MC-311454 - Particles from water evaporating in the Nether are not properly displayed
MC-311579 - The player can see through blocks when inside snow layers
MC-311593 - Spears' charging animation jitters from another player's perspective when swapping to a spear and charging it in the same tick
MC-311722 - Pressing Windows+↓ in fullscreen mode incorrectly restores the game window to a borderless windowed state

Get the Release

To install the Release, open up the Minecraft Launcher and click play! Make sure your Launcher is set to the "Latest Release" option.

Cross-platform server jar:

Minecraft server jar

Report bugs here:

Minecraft issue tracker!

Want to give feedback?

For any feedback and suggestions, head over to the Feedback site. If you're feeling chatty, join us over at the official Minecraft Discord.

Newest News

Catch up on the latest Minecraft news & game updates!

Minecraft: Java y Bedrock

Minecraft Dungeons II

Minecraft Dungeons

Minecraft Legends

Minecraft Education

Marketplace

Suscripciones

Comercialización

Descargas

Noticias

Más allá del juego

Seguir a Minecraft

Portal de aprendizaje del creador

Empieza aquí

Enlaces útiles

Oportunidades de empleo

Minecraft Java Edition 26.3

New Features

Dappled Forest Biome

Poplar Trees

Shelf Mushroom

Red Shrub

Abandoned Camp Structure

Cushion

Cushion Placement Rules

Straw Bed

Wool Stairs and Wool Slabs

Concrete Stairs and Concrete Slabs

Abandoned Camp Explorer Maps

Realms

Changes

Explorer Maps

Order-independent Transparency (OIT)

Minor Tweaks to Blocks, Items, and Entities

UI

Debug Overlay

World Options

Accessibility

Creative Inventory

Technical Changes

Windowing and Input Backend

Server Properties

Minecraft Server Management Protocol 3.1.0

Data Pack Versions 108.0 through 121.0

Commands

Added posteffect

Changes to publish

Added compute

Changes to data

Changes to give

Changes to tellraw

Changes to tick

Changes to team

Changes to item

Changes to execute

Changes to place

Changes to spreadplayers

Changes to swing

Environment Attributes

Added minecraft:gameplay/natural_mob_spawns

Added minecraft:gameplay/creature_world_gen_spawn_probability

Changed minecraft:gameplay/bed_rule

Added minecraft:gameplay/straw_bed_rule

Changed minecraft:visual/ambient_particles

Data Components

Added minecraft:provides_pottery_pattern

Added minecraft:cooking_fuel

Added minecraft:brewing_fuel

Changed minecraft:pot_decorations

Changed minecraft:trim_material

Added minecraft:block_transformer

Added minecraft:sign_text_front and minecraft:sign_text_back

Added minecraft:waxed

Added minecraft:cushion/color

Added minecraft:compostable

Added minecraft:villager_food

Added minecraft:mob_visibility

Added minecraft:attack_animation

Added minecraft:interact_animation

Changed minecraft:consumable