Add-On实体Entity Properties的用法

Ivo***

这篇文章参考自Bedrock Dev Wiki。

Mineraft基岩版1.16.230.52引入了"Entity properties"这个新功能，可以为Add-On的实体添加属性(property)。
这么一来，实体就能够储存变数，可以是数字、字串、布林值。
比起过去用行为包的各种组件伪装成「变数」，再用各种query侦测更方便的多；同样的，方块也有属性可以使用。
新建属性
属性要在行为包的实体档案的description物件进行注册，命名空间一律以property:开头。

在属性中枚举出一系列的数值，然后再进行操作。

{    "format_version":"1.16.0",    "minecraft:entity":{        "description":{            "identifier":"kanmusu:boku",            "is_spawnable":true,            "is_summonable":true,            "is_experimental":false,            "properties":{                //數字範圍的屬性                "property:number_range":{                    "values":{                        "min":0,                        "max":100                    },                    "client_sync":true                },                //第二種數字範圍的屬性                "property:number_enum":{                    "values":[                        1,                        2                                    },                //字串陣列的屬性                "property:string_enum":{                    "values":[                        "在水中",                        "在陸地"                                    },                //布林值的屬性                "property:boolean_enum":{                    "values":[                        true,                        false                                    }            }        },        "components":{},        "events":{}    }}

针对每个新增的属性，还可以设定二个值:

default代表的是预设值，如果不填写，则会使用阵列第一个值。

"property:number_range":{    "values":{        "min":0,        "max":100    },    "default":0}

client_sync则是让资源包也能读到这个属性。

"property:number_range":{    "values":{        "min":0,        "max":100    },    "client_sync":true}

存取、修改屬性

在行为包的event使用函数: "set_actor_property" 可修改属性的值。

"event:set_entity_property":{    "set_actor_property":{        "property:number_enum":2,        "property:string_enum":"'在水中'",        "property:boolean_enum":"!query.actor_property('property:boolean_enum')"    }}

別名 (Alias) 的用法

可以为实体定义别名，用/summon就能够召唤预先设定好属性数值的实体。

也可以单纯只是别名，而不赋值，例如下面的default_alias。

目前新增别名，背包会出现多余的生怪蛋。

{    "format_version":"1.16.0",    "minecraft:entity":{        "description":{            "identifier":"kanmusu:boku",            "is_spawnable":true,            "is_summonable":true,            "is_experimental":false,            "properties":{                //字串陣列的屬性                "property:scale":{                    "values":[                        "變大",                        "變小"                                    }            },            "aliases":{                "entity:default_alias":{},                "entity:first_alias":{                    "property:scale":"變大"                },                "entity:second_alias":{                    "property:scale":"變小"                }            }        },        "components":{},        "events":{}    }}

排序 (Permutation) 的用法

permutation是位于minecraft:entity物件内，与components同层级。

{    "format_version":"1.16.0",    "minecraft:entity":{        "description":{},        "permutations":[            {                //條件                "condition":"query.actor_property('property:scale') == '變大'",                "components":{                    //內含的組件                    "minecraft:scale":{                        "value":10                    }                }            },            {                //條件                "condition":"query.actor_property('property:scale') == '變小'",                "components":{                    //內含的組件                    "minecraft:scale":{                        "value":0.1                    }                }            }        ],        "components":{},        "events":{}    }}

实际应用例子

整篇讲下来，让我们来看看实际例子。我制作的boku生物程式码如下:

{

    "format_version": "1.16.0",

    "minecraft:entity": {

        "description": {

            "identifier": "kanmusu:boku",

            "is_spawnable": true,

            "is_summonable": true,

            "is_experimental": false,

"properties": {

                //字串陣列的屬性

                "property:scale": {

                    "values": [

                        "正常",

                        "變大",

                        "變小"

                }

            },

  "aliases": {

                //別名1

                "boku:big": {

                    "property:scale": "變大"

                },

                //別名2

                "boku:small": {

                    "property:scale": "變小"

                }

            }

        },

"permutations": [

            {

                //變大的條件

                "condition": "query.actor_property('property:scale') == '變大'",

                "components": {

                    //內含的組件

                    "minecraft:scale": {

                        "value": 10

                    }

                }

            },

            {

                //變小的條件

                "condition": "query.actor_property('property:scale') == '變小'",

                "components": {

                    //內含的組件

                    "minecraft:scale": {

                        "value": 0.1

                    }

                }

            }

        ],

   "components": {

            //預設大小

            "minecraft:scale": {

                "value": 1.0

            }

            //...(其餘組件在此省略)

        },

  "events": {

            "boku:enlarge": {

                "set_actor_property": {

                    "property:scale": "'變大'"

                }

            },

            "boku:shrink": {

                "set_actor_property": {

                    "property:scale": "'變小'"

                }

            }

        }

    }

}

因为属性预设的值是"正常"，permutation也没有写条件，所以正常生成是普通大小。

若使用/summon附加spawn event的指令，在召唤时执行赋值事件，这样会变大:

/summon kanmusu:boku ~ ~ ~ boku:enlarge

而用这条召唤，他会变小:
/summon kanmusu:boku ~ ~ ~ boku:shrink

permutation侦测到值的变化，就会自动执行设定好的组件，给予boku指定的大小。

当然我有定义别名，也可以直接用这二条:

/summon boku:second_alias

别名自动赋值，再交由permutation进行缩放。