概览
minecraft:behavior.go_home 是一个实体组件:写在自定义生物的 components 对象中,或其中某个组件组里。 让生物走回家园位置的 AI 目标,默认是它生成的地方。海龟用它回到自己的海滩。
字段
| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
speed_multiplier | number | 1 | 回家时的速度倍率。 |
interval | integer | 120 | 每刻有 N 分之 1 的几率开始,N 就是这个数字。 |
goal_radius | number | 0.5 | 生物需要靠近到多近才算到达,可防止它在目标点附近来回抖动。 |
calculate_new_path_radius | number | 2 | 生物离当前路径终点这么近时,会重新规划回家的路径。 |
on_home | ActorDefinitionTrigger[] | 无 | 生物到家时触发的事件。 |
on_failed | ActorDefinitionTrigger[] | 无 | 生物回家失败时触发的事件。 |
priority | integer | 0 | 数字越小越先执行:两个目标冲突时,priority 更小的那个胜出。范围:0 到 … |
control_flags | Goal's control flags[] | 无 | 此目标接管哪些身体部分(移动、看向、跳跃),占用相同部分的目标不能同时运行。 |
示例
写在 BP/entities/<name>.json 的 components 对象中(值为默认值或占位值):
BP/entities/<name>.json
{
"minecraft:behavior.go_home": {
"speed_multiplier": 1,
"interval": 120,
"goal_radius": 0.5,
"calculate_new_path_radius": 2,
"on_home": [],
"on_failed": [],
"priority": 0,
"control_flags": []
}
}