Minecraft: Java Edition 26.3

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