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
Name | Default Value | Type | Description |
---|---|---|---|
identifier | not set | String | The identifier for this block. The name must include a namespace and must not use the Minecraft namespace unless overriding a Vanilla block. |
states | not set | JSON Object | Map 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. |
menu_category | not set | JSON Object | Specifies the menu category and group for the block, which determine where this block is placed in the inventory and crafting table container screens. If this field is omitted, the block will not appear in the inventory or crafting table container screens. |
menu_category Parameters
Name | Default Value | Type | Description |
---|---|---|---|
category | not set | String | Determines which category this block will be placed under in the inventory and crafting table container screens. Options are "construction", "nature", "equipment", "items", and "none". If omitted or "none" is specified, the block will not appear in the inventory or crafting table container screens. |
group | not set | Localization String | Specifies the language file key that maps to which expandable/collapsible group this block will be a part of within a category. If this field is omitted, or there is no group whose name matches the loc string, this block will be placed standalone in the given category. |
is hidden in commands | false | Boolean | Determines whether or not this block can be used with commands. Commands can use blocks by default, but you may use this to disable that functionality. |
Example
{
"format_version": "1.20.60",
"minecraft:block": {
"description": {
"identifier": "design:lavenderstone"
},
"components": {
"minecraft:loot": "loot_tables/chests/simple_dungeon.json",
"minecraft:destructible_by_mining": {
"seconds_to_destroy": 4
},
"minecraft:friction": 0.4,
"minecraft:map_color": "#00ff00",
"minecraft:flammable": {
"catch_chance_modifier": 50,
"destroy_chance_modifier": 0
},
"minecraft:light_emission": 15
}
}
}
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for