Block Format History
1.21.50
Components
Versioned
- Updated
minecraft:destructible_by_mining
- Released
item_specific_speeds
parameter from experimental
- Released
1.21.40
Components
Versioned
- Released
minecraft:redstone_conductivity
from experimental
1.21.30
Components
experimental
Upcoming Creator Features
- Updated
minecraft:destructible_by_mining
- Added
item_specific_speeds
which determines thedestroy_speed
for eachitem
descriptor in an array.
- Added
- Added
minecraft:redstone_conductivity
- Contains
redstone_conductor
which determines whether this block conducts redstone. - Contains
allows_wire_to_step_down
which determines whether redstone wire can travel down the side of this block.
- Contains
1.21.10
Components
Versioned
- Released
minecraft:custom_components
from experimental - Released
minecraft:entity_fall_on
from experimental - Released
minecraft:tick
from experimental
1.20.80
experimental
Holiday Creator Features
Versioned
- Removed
events
Components
experimental
Beta APIs
- Added
minecraft:custom_components
- Lists all the custom components that should be applied to this block.
- Added
minecraft:entity_fall_on
- Contains
min_fall_distance
which determines the minimum distance an entity must fall to trigger the entity fall on event.
- Contains
- Renamed
minecraft:queued_ticking
tominecraft:tick
- Removed
on_tick
parameter
- Removed
experimental
Holiday Creator Features
Versioned
- Removed
minecraft:on_fall_on
trigger - Removed
minecraft:on_interact
trigger - Removed
minecraft:on_placed
trigger - Removed
minecraft:on_player_destroyed
trigger - Removed
minecraft:on_player_placing
trigger - Removed
minecraft:on_step_off
trigger - Removed
minecraft:on_step_on
trigger - Removed
minecraft:random_ticking
trigger
Events
experimental
Holiday Creator Features
Versioned
- Removed
add_mob_effect
response - Removed
damage
response - Removed
decrement_stack
response - Removed
die
response - Removed
play_effect
response - Removed
play_sound
response - Removed
remove_mob_effect
response - Removed
run_command
response - Removed
set_block
response - Removed
set_block_at_pos
response - Removed
set_block_state
response - Removed
spawn_loot
response - Removed
swing
response - Removed
teleport
response - Removed
transform
response - Removed
trigger
response
1.20.60
Components
- Updated
minecraft:geometry
- Added
culling
parameter which determines which culling rules to apply to this block's model.
- Added
experimental
Holiday Creator Features
Versioned
- Removed
minecraft:unit_cube
1.20.20
Description
- Released
traits
from experimental
Traits
Versioned
- Released
minecraft:placement_direction
from experimental - Released
minecraft:placement_position
from experimental
1.20.10
Description
- Renamed
properties
tostates
Components
- Updated
minecraft:geometry
- Added Molang permutation condition support to
bone_visibility
entries.
- Added Molang permutation condition support to
Events
experimental
Upcoming Creator Features
- Renamed
set_block_property
response toset_block_state
1.20.0
Description
experimental
Upcoming Creator Features
- Added
traits
- Block traits are shortcuts for creators to add vanilla states and value setters to data-driven blocks.
Traits
- Added
minecraft:placement_direction
- Can enable the states
minecraft:cardinal_direction
andminecraft:facing_direction
.
- Can enable the states
- Added
minecraft:placement_position
- Can enable the states
minecraft:block_face
andminecraft:vertical_half
.
- Can enable the states
1.19.80
Components
Versioned
- Added
minecraft:transformation
- Contains
rotation
,scale
andtranslation
which determine the transformation of the block's model and collisions.
- Contains
- Updated
minecraft:geometry
- Added
bone_visibility
parameter which determines whether the cubes of bones are visible based on boolean values.
- Added
experimental
Holiday Creator Features
- Removed
minecraft:part_visibility
1.19.70
Description
- Released
properties
from experimental
Permutations
- Released from experimental
- Blocks will now fail to load if a
condition
parameter is not a valid Molang permutation condition.
1.19.60
Components
Versioned
- Released
minecraft:display_name
from experimental - Released
minecraft:placement_filter
from experimental - Released
minecraft:selection_box
from experimental
1.19.50
Components
Versioned
- Released
minecraft:crafting_table
from experimental - Released
minecraft:collision_box
from experimental
experimental
Holiday Creator Features
- Removed
minecraft:breathability
1.19.40
Description
- Updated
menu_category
- Added
is_hidden_in_commands
parameter which determines whether the block is treated as invalid when used in commands.
- Added
Components
Versioned
- Released
minecraft:geometry
from experimental - Released
minecraft:material_instances
from experimental - Removed
minecraft:breathability
- Renamed
minecraft:block_light_filter
tominecraft:light_dampening
1.19.30
Description
- Added
menu_category
- Contains
category
which determines which tab this block is placed into. - Contains
group
which determines which other items this block is grouped with.
- Contains
Components
experimental
Holiday Creator Features
- Removed
minecraft:creative_category
- Updated
minecraft:display_name
- No longer prepends
tile.
and no longer appends.name
to the given display name.
- No longer prepends
1.19.20
Components
Versioned
- Renamed
minecraft:block_light_emission
tominecraft:light_emission
- Now determines emitted light in integer light levels (0-15) rather than decimal (0.0-1.0).
- Replaced
minecraft:destroy_time
withminecraft:destructible_by_mining
- Setting to
false
prevents the block from being destroyed through mining. - Setting to
true
allows the block to be mined and destroyed instantly. - Setting to an object allows
seconds_to_destroy
to be determined.
- Setting to
- Replaced
minecraft:explosion_resistance
withminecraft:destructible_by_explosion
- Setting to
false
prevents the block from being destroyed through explosion. - Setting to
true
allows the block to be destroyed through explosion easily. - Setting to an object allows
explosion_resistance
to be determined.
- Setting to
- Value of
minecraft:friction
now represents movement resistance instead of movement.
experimental
Holiday Creator Features
- Removed
minecraft:unwalkable
- Renamed
minecraft:aim_collision
tominecraft:selection_box
1.19.10
Components
Versioned
- Renamed
minecraft:block_light_filter
tominecraft:light_dampening
- Updated
minecraft:flammable
- Can now be set to a boolean, with
false
meaning the block is non-flammable andtrue
using the default flammability values. - Renamed
flame_odds
parameter tocatch_chance_modifier
- Renamed
burn_odds
parameter todestroy_chance_modifier
- Can now be set to a boolean, with
experimental
Holiday Creator Features
- Renamed
minecraft:block_collision
tominecraft:collision_box
- Updated
minecraft:crafting_table
- Renamed
custom_description
parameter totable_name
- Renamed
- Renamed
minecraft:ticking
tominecraft:queued_ticking
- Replaced
range
parameter withinterval_range
which is now measured in ticks rather than seconds.
- Replaced
experimental
Upcoming Creator Features
- Updated
minecraft:part_visibility
- Renamed
rules
parameter toconditions
- Renamed
1.18.30
Components
experimental
Holiday Creator Features
- Removed
minecraft:breakonpush
- Removed
minecraft:immovable
- Removed
minecraft:onlypistonpush
- Removed
minecraft:preventsjumping
1.18.10
Components
Versioned
- Renamed
minecraft:block_light_absorption
tominecraft:block_light_filter
experimental
Holiday Creator Features
- Renamed
minecraft:entity_collision
tominecraft:block_collision
- Renamed
minecraft:pick_collision
tominecraft:aim_collision
1.18.0
Components
experimental
Holiday Creator Features
- Added
minecraft:crafting_table
- Contains
crafting_tags
which determines which recipes are supported by tag. - Contains
custom_description
which will be displayed in the UI instead of "Crafting Table".
- Contains
1.17.30
Components
experimental
Upcoming Creator Features
- Added
minecraft:part_visibility
- Determines whether direct children of bones in a model are visible based on molang permutation conditions.
1.17.20
Components
experimental
Holiday Creator Features
- Added
minecraft:creative_category
- Determines where this block appears in the creative menu.
1.16.210
Events
experimental
Holiday Creator Features
- Updated
decrement_stack
response- Added
ignore_game_mode
parameter which determines whether the stack will be decremented when the player is in creative mode.
- Added
1.16.100
experimental
Holiday Creator Features
Versioned
- Added
events
Description
- Removed
is_experimental
- Removed
register_to_creative_menu
Components
experimental
Holiday Creator Features
Versioned
- Added
minecraft:breakonpush
- Determines whether this block will break when a piston attempts to push it.
- Added
minecraft:breathability
- Determines whether the block causes suffocation (
solid
) or is breathable (air
).
- Determines whether the block causes suffocation (
- Added
minecraft:display_name
- Determines a localization id for this block which will be used in the format
tile.<id>.name
.
- Determines a localization id for this block which will be used in the format
- Added
minecraft:entity_collision
- Determines the entity collision box of this block.
- Can be set to false to remove the collision completely.
- Contains
origin
which determines the starting position of the box. - Contains
size
which determines the dimensions of the box from theorigin
.
- Added
minecraft:geometry
- Defines the geometry identifier that this block should use as its model.
- Added
minecraft:immovable
- Determines whether this block is immovable by pistons.
- Added
minecraft:material_instances
- Contains rendering configuration for use with the
minecraft:geometry
orminecraft:unit_cube
components.
- Contains rendering configuration for use with the
- Added
minecraft:on_fall_on
trigger - Added
minecraft:on_interact
trigger - Added
minecraft:on_placed
trigger - Added
minecraft:on_player_destroyed
trigger - Added
minecraft:on_player_placing
trigger - Added
minecraft:on_step_off
trigger - Added
minecraft:on_step_on
trigger - Added
minecraft:onlypistonpush
- Determines whether this block can only be pushed by pistons and not pulled by sticky pistons.
- Added
minecraft:pick_collision
- Determines the player selection bounds for this block.
- Can be set to false to remove the collision completely.
- Contains
origin
which determines the starting position of the box. - Contains
size
which determines the dimensions of the box from theorigin
.
- Added
minecraft:placement_filter
- Determines where the block can be placed by the player and survive without popping off.
- Contains
conditions
of which at least one must match. - Each condition may contain
allowed_faces
and/orblock_filter
.
- Added
minecraft:preventsjumping
- Determines whether entities have limited jumping abilities when on this block.
- Added
minecraft:random_ticking
trigger - Added
minecraft:rotation
- Rotates this block's collision boxes and model by axis-aligned angles.
- Added
minecraft:ticking
- Determines the interval at which this block will tick, with pending tick data saved.
- Contains
looping
which determines whether ticking will continue indefinitely. - Contains
range
which determines the random delay of the interval. - Contains
on_tick
which can trigger an event when this block ticks.
- Added
minecraft:unit_cube
- Causes this block to display as a full block unit in size.
- Added
minecraft:unwalkable
- Determines whether entities should avoid walking over this block.
Events
experimental
Holiday Creator Features
Versioned
- Added
add_mob_effect
response - Added
damage
response - Added
decrement_stack
response - Added
die
response - Added
play_effect
response - Added
play_sound
response - Added
remove_mob_effect
response - Added
run_command
response - Added
set_block
response - Added
set_block_at_pos
response - Added
set_block_property
response - Added
spawn_loot
response - Added
swing
response - Added
teleport
response - Added
transform
response - Added
trigger
response
1.10.0
Description
- Added
identifier
- Defines the identifier of the block. Must have a namespace that isn't
minecraft
.
- Defines the identifier of the block. Must have a namespace that isn't
- Added
is_experimental
- Only registers the block if the
Use Experimental Gameplay
toggle is enabled in world settings.
- Only registers the block if the
- Added
register_to_creative_menu
- Causes the block to appear in the
Construction
category of the creative menu. - Custom blocks cannot be added to the recipe book at this time.
- Causes the block to appear in the
Components
- Added
minecraft:block_light_absorption
- Determines how much light (in integer light levels from 0-15) will be absorbed when passing through the block.
- Added
minecraft:block_light_emission
- Determines how much light (as a float from 0.0-1.0) is emitted by this block.
- Added
minecraft:destroy_time
- Determines how long it takes to mine this block in survival or adventure mode.
- Added
minecraft:explosion_resistance
- Determines how resistant this block is to explosions.
- Added
minecraft:flammable
- Contains
burn_odds
which determines how likely this block is to be destroyed when on fire. - Contains
flame_odds
which determines how likely this blocks is to catch on fire when fire is nearby.
- Contains
- Added
minecraft:friction
- Determines the movement speed of entities on this block.
- Note that this is not a measure of resistance unlike in modern formats.
- Added
minecraft:loot
- Determines the path of the loot table that will be dropped when this block is destroyed.
- This component is ignored if the used tool has the
Silk Touch
enchantment.
- Added
minecraft:map_color
- Determines the color this block appears as on a map.