Shared Constructs

JSON结构体可在附加组件系统的多个位置中使用。

方块描述符

方块描述符可用于检查符合指定属性的方块。例如，方块描述符被用于放置过滤器组件中，用于确定自定义方块可以放置在哪些类型的方块上。

标识符对象示例

json

{
    "name": "wiki:my_block"
}

置换对象示例

json

{
    "name": "wiki:my_block",
    "states": {
        "wiki:my_state": 5
    }
}

标签对象示例

json

{
    "tags": "q.any_tag('minecraft:is_axe_item_destructible', 'wiki:my_tag')"
}

范围对象定义了介于两个数字之间的区间。

范围对象示例

json

{
    "min": 2,
    "max": 4
}

当提供范围对象时，系统会在最小值和最大值之间（包含边界值）随机选取一个数值。每次使用范围对象时都会重新随机取值，不会保留之前的随机结果。最大值不得小于最小值，但可以等于最小值以固定取值。

分数对象通过分子和分母定义分数。

分数对象示例

json

{
    "numerator": 3,
    "denominator": 5
}

该对象实际使用的值是通过分子除以分母（numerator ÷ denominator）计算得出的结果。分子和分母都必须至少为1，且分母不能等于分子。

（注：根据技术文档翻译规范，保留了所有JSON字段名和代码块内容不变，仅对说明性文字进行了本地化处理。专业术语如"block descriptors"译为"方块描述符"、"permutation"译为"置换"等均采用Minecraft中文社区通用译法。）