Block Documentation - Block Components

Below is a list of all the available Block Components within Minecraft: Bedrock Edition for use with Block JSON files.

Block Components List

Name Default Value Type Description
minecraft:breathability solid String Specifies whether the block is breathable by defining if the block is treated as a solid or as air. The default is solid if this component is omitted. Experimental toggles required: Holiday Creator Features
minecraft:collision_box true Boolean/JSON Object Defines the area of the block that collides with entities. If set to true, default values are used. If set to false, the block's collision with entities is disabled. If this component is omitted, default values are used. Experimental toggles required: Holiday Creator Features (in format versions before 1.19.50).
minecraft:crafting_table not set JSON Object Makes your block into a custom crafting table which enables the crafting table UI and the ability to craft recipes. Experimental toggles required: Holiday Creator Features (in format versions before 1.19.50).
minecraft:custom_components -- Array Sets an ordered list of custom component names bound in script to be executed on a block event. Experimental toggles required: Beta APIs.
minecraft:destructible_by_explosion true Boolean/JSON Object Describes the destructible by explosion properties for this block. If set to true, the block will have the default explosion resistance. If set to false, this block is indestructible by explosion. If the component is omitted, the block will have the default explosion resistance.
minecraft:destructible_by_mining true Boolean / JSON Object Describes the destructible by mining properties for this block. If set to true, the block will take the default number of seconds to destroy. If set to false, this block is indestructible by mining. If the component is omitted, the block will take the default number of seconds to destroy.
minecraft:display_name not set Localization string Specifies the language file key that maps to what text will be displayed when you hover over the block in your inventory and hotbar. If the string given can not be resolved as a loc string, the raw string given will be displayed. If this component is omitted, the name of the block will be used as the display name. Experimental toggles required: Holiday Creator Features (in format versions before 1.19.60).
minecraft:flammable false Boolean/JSON Object Describes the flammable properties for this block. If set to true, default values are used. If set to false, or if this component is omitted, the block will not be able to catch on fire naturally from neighbors, but it can still be directly ignited.
minecraft:friction 0.4 Decimal Describes the friction for this block in a range of (0.0-0.9). Friction affects an entity's movement speed when it travels on the block. Greater value results in more friction.
minecraft:geometry not set Identifier string The description identifier of the geometry to use to render this block. This identifier must match an existing geometry identifier in any of the loaded resource packs or be one of the currently supported Vanilla identifiers: minecraft:geometry.full_block or minecraft:geometry.cross. Experimental toggles required: Holiday Creator Features (in format versions before 1.19.40).
minecraft:light_dampening 15 Integer The amount that light will be dampened when it passes through the block, in a range (0-15). Higher value means the light will be dampened more.
minecraft:light_emission 0 Integer The amount of light this block will emit in a range (0-15). Higher value means more light will be emitted.
minecraft:loot not set Path string The path to the loot table, relative to the behavior pack.
minecraft:map_color not set String Sets the color of the block when rendered to a map. The color is represented as a hex value in the format "#RRGGBB". May also be expressed as an array of [R, G, B] from 0 to 255. If this component is omitted, the block will not show up on the map.
minecraft:material_instances not set JSON Object The material instances for a block. Maps face or material_instance names in a geometry file to an actual material instance. You can assign a material instance object to any of these faces: "up", "down", "north", "south", "east", "west", or "*". You can also give an instance the name of your choosing such as "my_instance", and then assign it to a face by doing "north":"my_instance". Experimental toggles required: Holiday Creator Features (in format versions before 1.19.40).
minecraft:placement_filter not set JSON Object Sets rules for under what conditions the block can be placed or survive. Experimental toggles required: Holiday Creator Features (in format versions before 1.19.60).
minecraft:selection_box Boolean / JSON Object true Defines the area of the block that is selected by the player's cursor. If set to true, default values are used. If set to false, this block is not selectable by the player's cursor. If this component is omitted, default values are used. Experimental toggles required: Holiday Creator Features (in format versions before 1.19.60).
minecraft:transformation rotation[0, 0, 0] Vector [a, b, c] The block's translation around the center of the cube in degrees. The rotation order is [x, y, z]. Angles need to be in multiples of 90. Experimental toggles required: Holiday Creator Features (in format versions before 1.19.80).

Unsupported features

Warning

These features were previously applicable but are no longer available.

Name Default Value Type Description
minecraft:unit_cube not set JSON Object Specified that a unit cube was to be used with tessellation. The render capabilities were succeeded be the minecraft:geometry.full_block description identifier.