BLOCKS DOCUMENTATION
Version: 1.16.100.56

This is documentation for a beta release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.
Be sure to check the documentation once the release is out of beta if your add-on isn't working properly. Resource and Behavior Packs created for the beta are not guaranteed to work on the final release.

Index#

Blocks#

Block Definition Properties#

These properties are part of the Block Definition. This helps the system determine how to parse and initialize this block.

Name	Type	Default Value	Description
format_version

Code Example

Example

{
  "format_version": "1.16.0",
  "minecraft:block": {
    "description": {
      "identifier": "design:lavenderstone"
    },
    "components": {
      "minecraft:loot": "loot_tables/chests/simple_dungeon.json",
      "minecraft:destroy_time": 4.0,
      "minecraft:friction": 0.6,
      "minecraft:map_color": "#00ff00",
      "minecraft:flammable": {
        "flame_odds": 50,
        "burn_odds": 0
    },
      "minecraft:block_light_emission": 1.0
    }
  }
}

Block Description Properties#

Name	Type	Default Value	Description
identifier	String		The identifier for this block. The name must include a namespace and must not use the Minecraft namespace unless overriding a Vanilla block.

minecraft:on_fall_on#

Name	Type	Default Value	Description
condition	String		The condition of event to be executed on the block.
event	String		The event executed on the block.
min_fall_distance	Decimal		The minimum distance in blocks that an actor needs to fall to trigger this event.
target	String	self	The target of event executed on the block.

minecraft:on_interact#

Name	Type	Default Value	Description
condition	String		The condition of event to be executed on the block.
event	String		The event executed on the block.
target	String	self	The target of event executed on the block.

minecraft:on_placed#

Name	Type	Default Value	Description
condition	String		The condition of event to be executed on the block.
event	String		The event executed on the block.
target	String	self	The target of event executed on the block.

minecraft:on_player_placing#

Name	Type	Default Value	Description
condition	String		The condition of event to be executed on the block.
event	String		The event executed on the block.
target	String	self	The target of event executed on the block.

minecraft:on_step_off#

Name	Type	Default Value	Description
condition	String		The condition of event to be executed on the block.
event	String		The event executed on the block.
target	String	self	The target of event executed on the block.

minecraft:on_step_on#

Name	Type	Default Value	Description
condition	String		The condition of event to be executed on the block.
event	String		The event executed on the block.
target	String	self	The target of event executed on the block.

minecraft:flammable#

Name	Type	Default Value	Description
burn_odds	Integer	0	How likely the block will be destroyed by flames when on fire.
flame_odds	Integer	0	How likely the block will catch flame when next to a fire.

minecraft:material_instances#

Maps face or material_instance names in a geometry file to an actual material instance. Material instance can either be a full material instance or a name to another already defined instance

"minecraft:material_instances" : {
    "*": {
      "texture": "log",
      "render_method" : "opaque"
    },
    "ends" : {
      "texture": "log_top",
      "render_method" : "opaque"
    },
    "up" : "ends",
    "some_face_material_name" : "ends"
  }

minecraft:ticking#

Name	Type	Default Value	Description
Trigger			on_tick condition# The condition of event to be executed on the block. event# The type of event executed on the block. range# The Range between which the component will trigger his event. target# The target of event executed on the block.
looping	Boolean	true	Does the event loop
range	Array	[10, 10]	The Range between which the component will trigger his event.

minecraft:random_ticking#

Name	Type	Default Value	Description
Trigger			on_tick condition# The condition of event to be executed on the block. event# The type of event executed on the block. range# The Range between which the component will trigger his event. target# The target of event executed on the block.

minecraft:entity_collision#

Name	Type	Default Value	Description
origin	Array	[-8.0, 0.0, -8.0]	Minimal position Bounds of the collision box
size	Array	[16.0, 16.0, 16.0]	Size of each side of the box of the component

minecraft:pick_collision#

Name	Type	Default Value	Description
origin	Array	[-8.0, 0.0, -8.0]	Minimal position Bounds of the collision box
size	Array	[16.0, 16.0, 16.0]	Size of each side of the box of the component

minecraft:block_light_absorption#

The amount of light this block will absorb.

minecraft:block_light_emission#

The amount of light this block will emit in a range [0.0, 1.0].

minecraft:breakonpush#

When pushed by a piston the block breaks

minecraft:destroy_time#

Sets the destroy time property for the block. Greater numbers result in greater mining times.

minecraft:entity_collision#

Can only be set to false, it disables the collision of the block with entities

minecraft:explosion_resistance#

Sets the explosion resistance for this block.

minecraft:friction#

Property describing the friction for this block. Friction effects an entities movements when it walks on the block.

minecraft:geometry#

The geometry definition name to use.

minecraft:immovable#

An Immovable block cannot be pushed by pistons

minecraft:loot#

The path of the loot table that this component will use when the block is destroyed.

minecraft:map_color#

A color represented as a hex value. This will be the color rendered to a map.

minecraft:onlypistonpush#

Blocks with those components won't stick to stickyPistons

minecraft:pick_collision#

Can only be set to false, it disables the collision of the block with entities

minecraft:placement_filter#

Sets rules for under what conditions the block can be placed/survive

conditions#

List of conditions where the block can be placed/survive

allowed_faces#

List of any of the following strings: up, down, north, south, east, west, side, all

block_filter#

List of blocks (can use tags to specify them) that this block can be placed against in the allowed_faces direction

minecraft:preventsjumping#

this component makes it so actors can't jump when walking on this block

minecraft:rotation#

This is the block's rotation around the center of the cube in degrees. The rotation order is x-y-z.

minecraft:unit_cube#

Specifies that a unit cube is to be used with tessellation.

minecraft:unwalkable#

this component sets a block as unwalkable. Most mobs will not try to jump over it if the value is set to true