Edit

Share via


Block Components Documentation

Block Components Description
minecraft:collision_box Defines the area of the block that collides with entities.
minecraft:crafting_table Makes your block into a custom crafting table which enables the crafting table UI and the ability to craft recipes.
minecraft:destructible_by_explosion Describes the destructible by explosion properties for this block.
minecraft:destructible_by_mining Describes the destructible by mining properties for this block.
minecraft:destruction_particles [Note: This component is currently experimental].
minecraft:display_name Specifies the language file key that maps to what text will be displayed when you hover over the block in your inventory and hotbar.
minecraft:embedded_visual The description identifier of the geometry and material used to render this block when it it is embedded inside of another block (for example, a flower inside of a flower pot).
minecraft:entity_fall_on Configures what distance an entity must fall onto this block to cause the onEntityFallOn block custom component event to be sent to script.
minecraft:flammable Describes the flammable properties for this block.
minecraft:flower_pottable When added to a block type, indicates that this block can be placed inside a flower pot.
minecraft:friction Describes the friction for this block in a range of (0.0-0.9).
minecraft:geometry The description identifier of the geometry to use to render this block.
minecraft:item_visual The description identifier of the geometry and material used to render the item of this block.
minecraft:light_dampening The amount that light will be dampened when it passes through the block, in a range (0-15).
minecraft:light_emission The amount of light this block will emit in a range (0-15).
minecraft:liquid_detection The definitions for how a block behaves when detecting liquid.
minecraft:loot The path to the loot table, relative to the behavior pack.
minecraft:map_color Sets the color of the block when rendered to a map.
minecraft:material_instances The material instances for a block.
minecraft:movable The description identifier of the movable component
Experimental toggles required: Upcoming Creator Features (in format versions before 1.21.100)
minecraft:placement_filter Sets rules for under what conditions the block can be placed/survive
minecraft:precipitation_interactions Component that determines how the block will interact with rain and snow
Experimental toggles required: Upcoming Creator Features (in format versions before 1.21.120)
minecraft:random_offset This component defines a random offset for the block, seeded based on the block's position and the specified range and steps.
minecraft:redstone_conductivity The basic redstone properties of a block; if the component is not provided the default values are used.
minecraft:redstone_producer If added to a block, indicates that it produces a redstone signal.
minecraft:replaceable A block with this component can be replaced when another block is placed in the same block position.
Experimental toggles required: Upcoming Creator Features (in format versions before 1.21.60)
minecraft:selection_box Defines the area of the block that is selected by the player's cursor.
minecraft:support Defines the support shape of the block.
minecraft:tick Causes the block to tick based on a regular interval equal to a number of ticks randomly chosen from the internal_range parameter.
minecraft:transformation The block's translation, rotation and scale with respect to the center of its world position

Internal/Deprecated Components

These components are either deprecated or internal to Minecraft and not usable in custom content.

Block Components Description
bone_visibility A JSON object that contains a list of key/value pairs that map from bone name in the specified geometry file (key) to a boolean that tells whether the bone should be visible or not (value).
breathability Determines whether the block is breathable by defining if the block is treated as a solid or as air.
custom_components Sets an ordered list of custom component names which are bound in script to be executed upon a block event.
queued_ticking Triggers the specified event, either once, or at a regular interval equal to a number of ticks randomly chosen from the interval_range provided.
random_ticking Triggers the specified event randomly based on the random tick speed gamerule.
unit_cube Specifies that a unit cube is to be used with tessellation.