方块描述

Kevin2007留言 | 贡献2023年11月22日 (三) 00:44的版本

方块描述是基岩版我的世界数据驱动附加包中用于描述方块基本信息的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"