Skip to main content

Block Documentation - Block Description

The block "description" lives inside the "minecraft:block" section of a custom block's behavior pack JSON file, and contains a list of block characteristics that are applicable to all permutations of the block. The description MUST contain an identifier to identify the block by; the other fields are optional.

Parameters

NameTypeDefaultDescription
identifierStringnot setThe identifier for this block. The name must include a namespace and must not use the Minecraft namespace unless overriding a Vanilla block.
statesJSON Objectnot setMap of key/value pairs that maps the state name (key) to an array of all possible values for that state (value). Learn how to use block states in Block States and Permutations.
traitsJSON Objectnot set

Example

{
"format_version": "1.0.0",
"minecraft:block": {
"description": {
"identifier": "paladium:paladium_block"
},
"components": {
"minecraft:material_instances": {
"materials": {
"*": {
"texture": "paladium_block"
}
}
},
"minecraft:destructible_by_mining": {
"hardness": 5,
"tool_type": 3,
"tool_tier": 4
}
}
}
}