查看“方块描述”的源代码

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

== identifier ==
identifier 用于定义方块的标识符，是必选项。在中国版需要该选项全局唯一。
{| class="wikitable"
|+
!键
!值描述
!默认值
!值类型
|-
|identifier
|标识符（形如namespace:identier）
| -
|string
|}
<syntaxhighlight lang="json">
"identifier": "hyacinth:itemname"
</syntaxhighlight>

== state ==
state 用于定义方块所拥有的状态。
{| class="wikitable"
|+
!键
!值描述
!默认值
!值类型
|-
|state
|方块状态，每个状态的键值对格式为
{| class="wikitable"
|+
!键
!键类型
!值描述
!默认值
!值类型
|-
|状态名称（形如namespace:state）
|string
|该状态可能拥有的值
| -
|Any
|}
| -
|object
|}
对于一个拥有连续整数序列的状态，可用
<syntaxhighlight lang="json">
"values": {
    "min": min
    "max": max
}
</syntaxhighlight>
来为状态生成一个在[min, max]中的整数序列：
<syntaxhighlight lang="json">
"state": {
    "hyacinth:boolean_states": [true, false],
    "hyacinth:integer_states": {
        "values": {
            "min": 0,
            "max": 16   // 即生成一个0, 1, 2, ..., 16的序列
        }
    }
}
</syntaxhighlight>

== menu_category ==
menu_category 用于声明该方块所存在的分类栏或组，若省略该选项则方块不会存在于任何一处分类栏或组中。
{| class="wikitable"
|+
!键
!值描述
!默认值
!值类型
|-
|menu_category
|方块所存在的分类栏或组，值包含：
{| class="wikitable"
|+
!键
!值描述
!默认值
!值类型
|-
|category
|方块所存在的分类栏。
可选项有：
construction---建筑；
nature---自然；
item---物品；
equipment---工具；
none或省略---不存在于任意一处。
| -
|string
|-
|group
|方块所存在的组。
这些可折叠的组可以在语言文件中查询到。
| -
|string
|}
| -
|Object
|}
<syntaxhighlight lang="json">
"menu_category": {
    "category": "nature",
    "group": "itemGroup.name.coral"
}
</syntaxhighlight>

== is_experimental ==
is_experimental 用于声明该方块是否存在于实验性功能中。
{| class="wikitable"
|+
!键
!值描述
!默认值
!值类型
|-
|is_experimental
|是否为实验性功能
|false
|boolean
|}

== register_to_create_menu ==
register_to_create_menu 用于声明该方块是否出现在创造物品栏中，此选项仅中国版可用。
{| class="wikitable"
|+
!键
!值描述
!默认值
!值类型
|-
|register_to_create_menu
|是否注册至创造物品栏中（true/false）
|false
|boolean
|}
<syntaxhighlight lang="json">
"register_to_create_menu": true
</syntaxhighlight>

== category ==
category 用于声明该方块所存在的分类栏，此选项仅中国版可用。
{| class="wikitable"
|+
!键
!值描述
!默认值
!值类型
|-
|category
|方块所存在的分类栏，可选项有：
Construction---建筑；
Equipment---工具；
Nature---自然；
Items---工具；
|"Nature"
|string
|}
<syntaxhighlight lang="json">
"category": "Items"
</syntaxhighlight>

== base_block ==
base_block 用于声明该方块的类型以修改方块的基础行为，此选项仅中国版可用。
{| class="wikitable"
|+
!键
!值描述
!默认值
!值类型
|-
|base_block
|基类方块
{| class="wikitable"
|+
!值
!描述
|-
|mob_spawner
|自定义刷怪笼
|-
|portal
|自定义传送门
|-
|custom_crop_block
|自定义农作物
|-
|custom_heavy_block
|自定义重力方块
|-
|liquid
|自定义静态流体方块
|-
|flowing_liquid
|自定义动态流体方块
|}
| -
|String
|}
<syntaxhighlight lang="json">
"base_block": "portal"
</syntaxhighlight>