方块描述

方块描述是基岩版我的世界数据驱动附加包中用于描述方块基本信息的JSON文本。

identifier

identifier 用于定义方块的标识符，是必选项。在中国版需要该选项全局唯一。

键	值描述	默认值	值类型
identifier	标识符（形如namespace:identier）	-	string

"identifier": "hyacinth:itemname"

state

state 用于定义方块所拥有的状态。

键	值描述	默认值	值类型
state	方块状态，每个状态的键值对格式为 键 键类型 值描述 默认值 值类型 状态名称（形如namespace:state） string 该状态可能拥有的值 - Any	-	object

对于一个拥有连续整数序列的状态，可用

"values": {
    "min": min
    "max": max
}

来为状态生成一个在[min, max]中的整数序列：

"state": {
    "hyacinth:boolean_states": [true, false],
    "hyacinth:integer_states": {
        "values": {
            "min": 0,
            "max": 16   // 即生成一个0, 1, 2, ..., 16的序列
        }
    }
}

menu_category

menu_category 用于声明该方块所存在的分类栏或组，若省略该选项则方块不会存在于任何一处分类栏或组中。

键	值描述	默认值	值类型
menu_category	方块所存在的分类栏或组，值包含： 键 值描述 默认值 值类型 category 方块所存在的分类栏。 可选项有： construction---建筑； nature---自然； item---物品； equipment---工具； none或省略---不存在于任意一处。 - string group 方块所存在的组。 这些可折叠的组可以在语言文件中查询到。 - string	-	Object

"menu_category": {
    "category": "nature",
    "group": "itemGroup.name.coral"
}

is_experimental

is_experimental 用于声明该方块是否存在于实验性功能中。

键	值描述	默认值	值类型
is_experimental	是否为实验性功能	false	boolean

register_to_create_menu

register_to_create_menu 用于声明该方块是否出现在创造物品栏中，此选项仅中国版可用。

键	值描述	默认值	值类型
register_to_create_menu	是否注册至创造物品栏中（true/false）	false	boolean

"register_to_create_menu": true

category

category 用于声明该方块所存在的分类栏，此选项仅中国版可用。

键	值描述	默认值	值类型
category	方块所存在的分类栏，可选项有： Construction---建筑； Equipment---工具； Nature---自然； Items---工具；	"Nature"	string

"category": "Items"

base_block

base_block 用于声明该方块的类型以修改方块的基础行为，此选项仅中国版可用。

键	值描述	默认值	值类型
base_block	基类方块 值 描述 mob_spawner 自定义刷怪笼 portal 自定义传送门 custom_crop_block 自定义农作物 custom_heavy_block 自定义重力方块 liquid 自定义静态流体方块 flowing_liquid 自定义动态流体方块	-	String

"base_block": "portal"