跳到主要内容

AI 意向组件

AI 意向组件(AI Goal Components)规定了实体的 AI,规定 AI 后可以使得实体拥有“想要做什么事情”的能力。

minecraft:behavior.admire_item​

通用
该特性在中国版和国际版均可用。
1.16.0+
该特性在游戏版本1.16.0+下可用。
需要前置组件
要使用该组件,请事先定义minecraft:admire_item组件。

使生物欣赏被标记为可欣赏的物品。

另见:minecraft:admire_item组件。

  • minecraft:behavior.admire_item 数据类型图标minecraft:behavior.admire_item
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • admire_item_sound 数据类型图标admire_item_sound
      字符串
      :欣赏物品时播放的音效事件名。
    • sound_interval 数据类型图标sound_interval
      JSON 数组
      :已弃用:1.16.0-26.20
      该特性已被弃用,只能在游戏版本1.16.0-26.20下使用。
      两次音效之间随机等待的秒数区间,写作[最小值, 最大值]。默认值为[0, 0]。
    • sound_interval 数据类型图标sound_interval
      JSON 对象
      :26.20+
      该特性在游戏版本26.20+下可用,但该版本对于当前的中国版版本过高。
      两次音效之间随机等待的秒数区间。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为0。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为0。
    • on_admire_item_start 数据类型图标on_admire_item_start
      JSON 对象
      :开始欣赏物品时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
      • target 数据类型图标target
        字符串
        :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
    • on_admire_item_stop 数据类型图标on_admire_item_stop
      JSON 对象
      :停止欣赏物品时触发的事件,结构同上。

minecraft:behavior.aquatic_charge_attack​

通用
该特性在中国版和国际版均可用。
未知
已尝试查找该特性的加入版本,但未能确定。

使水生生物向目标发起冲刺攻击。

  • minecraft:behavior.aquatic_charge_attack 数据类型图标minecraft:behavior.aquatic_charge_attack
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • attack_reach 数据类型图标attack_reach
      浮点数
      :在碰撞箱基础上向外扩张的判定距离,单位为方块。默认值为0.05。
    • charge_speed 数据类型图标charge_speed
      浮点数
      :冲刺时的绝对速度。默认值为0.06。
    • max_charge_distance 数据类型图标max_charge_distance
      浮点数
      :发起冲刺的最大距离,单位为方块。默认值为16。
    • charge_overshoot_distance 数据类型图标charge_overshoot_distance
      浮点数
      :冲刺时瞄准目标后方多远的距离。默认值为1.5。
    • charge_cooldown_time 数据类型图标charge_cooldown_time
      JSON 数组
      :两次冲刺之间随机等待的秒数区间,写作[最小值, 最大值]。默认值为[2, 6]。
    • knockback_force 数据类型图标knockback_force
      浮点数
      :命中时施加给目标的击退力。默认值为2。

minecraft:behavior.avoid_block​

通用
该特性在中国版和国际版均可用。
1.18.30+
该特性在游戏版本1.18.30+下可用。

使生物避开指定的方块。

  • minecraft:behavior.avoid_block 数据类型图标minecraft:behavior.avoid_block
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • target_blocks 数据类型图标target_blocks
      JSON 数组
      :要避开的方块列表。
      • string 数据类型图标
        字符串
        :方块 ID。
    • target_selection_method 数据类型图标target_selection_method
      字符串
      :方块的搜索方式。可选值为nearest(最近)与random(随机)。默认值为nearest。
    • search_range 数据类型图标search_range
      整数
      :水平方向搜索的最大距离,单位为方块。默认值为0。
    • search_height 数据类型图标search_height
      整数
      :垂直方向搜索的最大距离,单位为方块。默认值为0。
    • tick_interval 数据类型图标tick_interval
      整数
      :每隔多少刻执行一次该行为。默认值为1。
    • walk_speed_modifier 数据类型图标walk_speed_modifier
      浮点数
      :行走速度的乘数,1.0表示维持原速。默认值为1。
    • sprint_speed_modifier 数据类型图标sprint_speed_modifier
      浮点数
      :疾跑速度的乘数。默认值为1。
    • avoid_block_sound 数据类型图标avoid_block_sound
      字符串
      :避开方块时播放的音效事件名。
    • sound_interval 数据类型图标sound_interval
      JSON 数组
      :两次音效之间随机等待的秒数区间,写作[最小值, 最大值]。默认值为[3, 8]。
    • on_escape 数据类型图标on_escape
      JSON 数组
      :成功避开时触发的事件列表。
      • object 数据类型图标
        JSON 对象
        :一个事件。
        • event 数据类型图标event
          字符串
          :事件 ID。
        • target 数据类型图标target
          字符串
          :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。

minecraft:behavior.avoid_mob_type​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物避开特定类型的实体。

  • minecraft:behavior.avoid_mob_type 数据类型图标minecraft:behavior.avoid_mob_type
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • entity_types 数据类型图标entity_types
      JSON 数组
      :要避开的实体条件列表。
      • object 数据类型图标
        JSON 对象
        :一项条件。
        • filters 数据类型图标filters
          JSON 对象
          :实体需满足的条件。见实体过滤器。
        • max_dist 数据类型图标max_dist
          浮点数
          :触发躲避的最大距离,单位为方块。
        • walk_speed_multiplier 数据类型图标walk_speed_multiplier
          浮点数
          :躲避时行走速度的乘数。
        • sprint_speed_multiplier 数据类型图标sprint_speed_multiplier
          浮点数
          :躲避时疾跑速度的乘数。
        • check_if_outnumbered 数据类型图标check_if_outnumbered
          布尔值
          :是否仅在对方数量占优时躲避。
    • max_dist 数据类型图标max_dist
      浮点数
      :搜索躲避目标的最大距离,单位为方块。默认值为3。
    • max_flee 数据类型图标max_flee
      浮点数
      :1.4.0+
      该特性在游戏版本1.4.0+下可用。
      逃到距目标多远时停止逃跑,单位为方块。默认值为10。
    • sprint_distance 数据类型图标sprint_distance
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      距目标多近时开始疾跑,单位为方块。默认值为7。
    • avoid_target_xz 数据类型图标avoid_target_xz
      整数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      逃跑目标点在水平方向上的选取范围,单位为方块。默认值为16。
    • avoid_target_y 数据类型图标avoid_target_y
      整数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      逃跑目标点在垂直方向上的选取范围,单位为方块。默认值为7。
    • ignore_visibility 数据类型图标ignore_visibility
      布尔值
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      为true时逃跑途中不考虑视线是否被遮挡。默认值为false。
    • remove_target 数据类型图标remove_target
      布尔值
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      为true时逃跑期间清除当前攻击目标。默认值为false。
    • probability_per_strength 数据类型图标probability_per_strength
      浮点数
      :按对方力量决定停止躲避的概率。默认值为1。
    • walk_speed_multiplier 数据类型图标walk_speed_multiplier
      浮点数
      :行走速度的乘数。默认值为1。
    • sprint_speed_multiplier 数据类型图标sprint_speed_multiplier
      浮点数
      :疾跑速度的乘数。默认值为1。
    • river_speed_multiplier 数据类型图标river_speed_multiplier
      浮点数
      :沿河流逃跑时的速度乘数。默认值为0.75。
    • avoid_mob_sound 数据类型图标avoid_mob_sound
      字符串
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      躲避时播放的音效事件名。
    • sound_interval 数据类型图标sound_interval
      JSON 数组
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      两次音效之间随机等待的秒数区间,写作[最小值, 最大值]。默认值为[3, 8]。
    • on_escape_event 数据类型图标on_escape_event
      JSON 对象
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      成功逃脱时触发的事件,结构同其他行为的event加target。

minecraft:behavior.barter​

通用
该特性在中国版和国际版均可用。
1.16.0+
该特性在游戏版本1.16.0+下可用。
需要前置组件
要使用该组件,请事先定义minecraft:barter组件。

使生物进行以物易物。

另见:minecraft:barter组件。

  • minecraft:behavior.barter 数据类型图标minecraft:behavior.barter
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。

minecraft:behavior.beg​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物注视并跟随手持其喜爱食物的玩家。

  • minecraft:behavior.beg 数据类型图标minecraft:behavior.beg
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • items 数据类型图标items
      JSON 数组
      :该生物喜爱的物品列表。
      • object 数据类型图标
        JSON 对象
        :一项物品描述符。也可直接写物品 ID 字符串。
        • name 数据类型图标name
          字符串
          :物品 ID。
    • look_distance 数据类型图标look_distance
      浮点数
      :乞求时可保持的最大距离,单位为方块。默认值为8。
    • look_time 数据类型图标look_time
      JSON 对象
      :每次注视玩家持续时间的区间,单位为秒。
      26.40+
      该特性在游戏版本26.40+下可用,但该版本对于当前的中国版版本过高。
      :只接受带min与max值的对象,更早的格式版本仍可写作[最小值, 最大值]。
      • min 数据类型图标min
        整数
        :区间下限。默认值为2。
      • max 数据类型图标max
        整数
        :区间上限。默认值为4。

minecraft:behavior.break_door​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物破坏阻挡其寻路的门,需配合minecraft:annotation.break_door组件。

  • minecraft:behavior.break_door 数据类型图标minecraft:behavior.break_door
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。

minecraft:behavior.breed​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
需要前置组件
要使用该组件,请事先定义minecraft:breedable组件。

使生物寻找同类进行繁殖。

另见:minecraft:breedable组件。

  • minecraft:behavior.breed 数据类型图标minecraft:behavior.breed
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

minecraft:behavior.celebrate​

通用
该特性在中国版和国际版均可用。
1.13.3+
该特性在游戏版本1.13.3+下可用。

使生物在触发后进行庆祝,例如袭击者攻下村庄后的欢呼。

  • minecraft:behavior.celebrate 数据类型图标minecraft:behavior.celebrate
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • celebration_sound 数据类型图标celebration_sound
      字符串
      :庆祝时播放的音效事件名。默认值为celebrate。
    • duration 数据类型图标duration
      浮点数
      :庆祝持续的秒数。默认值为30。
    • jump_interval 数据类型图标jump_interval
      JSON 数组
      :两次跳跃之间随机等待的秒数区间。默认值为[1, 3.5]。
    • sound_interval 数据类型图标sound_interval
      JSON 数组
      :两次音效之间随机等待的秒数区间。默认值为[2, 7]。
    • on_celebration_end_event 数据类型图标on_celebration_end_event
      JSON 对象
      :庆祝结束时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
      • target 数据类型图标target
        字符串
        :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。

备注:区间参数在 schema 中写作min与max,原版多数写作range_min与range_max,两种写法均可解析。


minecraft:behavior.celebrate_survive​

通用
该特性在中国版和国际版均可用。
1.18.30+
该特性在游戏版本1.18.30+下可用。

使生物在袭击中存活后进行庆祝,并周期性放出烟花。

  • minecraft:behavior.celebrate_survive 数据类型图标minecraft:behavior.celebrate_survive
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • duration 数据类型图标duration
      浮点数
      :庆祝持续的秒数。默认值为30。
    • fireworks_interval 数据类型图标fireworks_interval
      JSON 数组
      :两次烟花之间随机等待的秒数区间。默认值为[10, 20]。
    • on_celebration_end_event 数据类型图标on_celebration_end_event
      JSON 对象
      :庆祝结束时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
      • target 数据类型图标target
        字符串
        :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。

minecraft:behavior.charge_attack​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物向目标发起冲锋,例如恼鬼的突进。

  • minecraft:behavior.charge_attack 数据类型图标minecraft:behavior.charge_attack
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • min_distance 数据类型图标min_distance
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      距目标小于该距离时不发起冲锋,单位为方块。默认值为2。
    • max_distance 数据类型图标max_distance
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      距目标大于该距离时不发起冲锋,单位为方块。默认值为3。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      冲向目标时的速度乘数。默认值为1。
    • success_rate 数据类型图标success_rate
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      未处于攻击状态时发起冲锋的概率。默认值为0.1428。
    • sound_event 数据类型图标sound_event
      字符串
      :冲锋时播放的音效事件名。默认值为charge。

minecraft:behavior.charge_held_item​

通用
该特性在中国版和国际版均可用。
1.10.0+
该特性在游戏版本1.10.0+下可用。

使生物为手持物品蓄力,例如猪灵拉弓。

  • minecraft:behavior.charge_held_item 数据类型图标minecraft:behavior.charge_held_item
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • items 数据类型图标items
      JSON 数组
      :会触发蓄力的物品列表,该项为必填。
      • string 数据类型图标
        字符串
        :物品 ID。

minecraft:behavior.circle_around_anchor​

通用
该特性在中国版和国际版均可用。
1.6.0+
该特性在游戏版本1.6.0+下可用。

使生物围绕一个锚点盘旋,例如幻翼在空中绕圈。

  • minecraft:behavior.circle_around_anchor 数据类型图标minecraft:behavior.circle_around_anchor
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • goal_radius 数据类型图标goal_radius
      浮点数
      :距锚点多近即视为到达,单位为方块。默认值为0.5。
    • angle_change 数据类型图标angle_change
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      选择下一个锚点时朝向改变的角度。默认值为15。
    • radius_range 数据类型图标radius_range
      JSON 数组
      :与锚点的水平距离范围,写作[最小值, 最大值]。默认值为[5, 15]。
    • radius_change 数据类型图标radius_change
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      成功调整半径时增加的距离,单位为方块。默认值为1。
    • radius_adjustment_chance 数据类型图标radius_adjustment_chance
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      每刻调整半径的概率。默认值为0.004。
    • height_above_target_range 数据类型图标height_above_target_range
      JSON 数组
      :高于目标高度的范围,写作[最小值, 最大值]。默认值为[0, 0]。
    • height_offset_range 数据类型图标height_offset_range
      JSON 数组
      :相对锚点的垂直偏移范围,写作[最小值, 最大值]。默认值为[0, 0]。
    • height_adjustment_chance 数据类型图标height_adjustment_chance
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      每刻调整高度的概率。默认值为0.002857。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :飞向下一位置时的速度乘数。默认值为1。

minecraft:behavior.controlled_by_player​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
需要前置组件
要使用该组件,请事先定义minecraft:item_controllable组件、minecraft:movement组件和minecraft:rideable组件。

使被玩家骑乘的实体接受玩家的方向控制。

另见:minecraft:item_controllable组件、minecraft:movement组件、minecraft:rideable组件、EntityMovementComponent 类、EntityRideableComponent 类。

  • minecraft:behavior.controlled_by_player 数据类型图标minecraft:behavior.controlled_by_player
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • mount_speed_multiplier 数据类型图标mount_speed_multiplier
      浮点数
      :1.16.0+
      该特性在游戏版本1.16.0+下可用。
      被控制时的移动速度乘数。默认值为1。
    • fractional_rotation 数据类型图标fractional_rotation
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      每刻朝玩家视角转动的比例。默认值为0.5。
    • fractional_rotation_limit 数据类型图标fractional_rotation_limit
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      每刻可转动的最大角度,单位为度。默认值为5。

minecraft:behavior.croak​

通用
该特性在中国版和国际版均可用。
1.19.0+
该特性在游戏版本1.19.0+下可用。

使生物周期性发出鸣叫,青蛙使用该行为。

  • minecraft:behavior.croak 数据类型图标minecraft:behavior.croak
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • duration 数据类型图标duration
      JSON 数组
      :每次鸣叫持续的秒数区间,也可直接写固定值。默认值为[4.5, 4.5]。
    • interval 数据类型图标interval
      JSON 数组
      :两次鸣叫之间随机等待的秒数区间,也可直接写固定值。默认值为[10, 20]。
    • filters 数据类型图标filters
      JSON 对象
      :允许鸣叫的条件。见实体过滤器。

minecraft:behavior.defend_trusted_target​

通用
该特性在中国版和国际版均可用。
1.13.0+
该特性在游戏版本1.13.0+下可用。

使生物保护已获得其信任的对象,例如狐狸保护信任的玩家。

  • minecraft:behavior.defend_trusted_target 数据类型图标minecraft:behavior.defend_trusted_target
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • entity_types 数据类型图标entity_types
      JSON 数组
      :被视为有效攻击目标的实体条件列表。
      • object 数据类型图标
        JSON 对象
        :一项条件。
    • within_radius 数据类型图标within_radius
      浮点数
      :在被保护对象周围多大的范围内发起攻击,单位为方块。默认值为0。
    • must_see 数据类型图标must_see
      布尔值
      :为true时只把视野内的实体作为目标。默认值为false。
    • must_see_forget_duration 数据类型图标must_see_forget_duration
      浮点数
      :目标离开视野多少秒后放弃。默认值为3。
    • attack_interval 数据类型图标attack_interval
      整数
      :两次攻击之间的秒数。默认值为0。
    • aggro_sound 数据类型图标aggro_sound
      字符串
      :保护期间偶尔播放的音效事件名。
    • on_defend_start 数据类型图标on_defend_start
      JSON 对象
      :开始保护时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
      • target 数据类型图标target
        字符串
        :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。

minecraft:behavior.defend_village_target​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物攻击村庄的入侵者,铁傀儡使用该行为。

  • minecraft:behavior.defend_village_target 数据类型图标minecraft:behavior.defend_village_target
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • entity_types 数据类型图标entity_types
      JSON 数组
      :被视为入侵者的实体条件列表。
      • object 数据类型图标
        JSON 对象
        :一项条件。
    • attack_chance 数据类型图标attack_chance
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      每刻发起攻击的概率。默认值为0.05。
    • attack_owner 数据类型图标attack_owner
      布尔值
      :1.21.80+
      该特性在游戏版本1.21.80+下可用。
      为true时该实体可以攻击自己的主人。默认值为false。
    • must_reach 数据类型图标must_reach
      布尔值
      :1.21.80+
      该特性在游戏版本1.21.80+下可用。
      为true时要求存在通往目标的完整路径。默认值为false。
    • must_see 数据类型图标must_see
      布尔值
      :1.21.80+
      该特性在游戏版本1.21.80+下可用。
      为true时只把视野内的实体作为目标。默认值为false。
    • must_see_forget_duration 数据类型图标must_see_forget_duration
      浮点数
      :1.21.80+
      该特性在游戏版本1.21.80+下可用。
      目标离开视野多少秒后放弃。默认值为3。
    • persist_time 数据类型图标persist_time
      浮点数
      :1.21.80+
      该特性在游戏版本1.21.80+下可用。
      目标不再可见后仍继续攻击的秒数。默认值为0。
    • within_radius 数据类型图标within_radius
      浮点数
      :1.21.80+
      该特性在游戏版本1.21.80+下可用。
      距目标的最大跟随距离,超出则放弃。默认值为0。

minecraft:behavior.delayed_attack​

通用
该特性在中国版和国际版均可用。
1.11.0+
该特性在游戏版本1.11.0+下可用。

让生物在攻击动画播放到一定进度时才结算伤害,劫掠兽使用该行为。

  • minecraft:behavior.delayed_attack 数据类型图标minecraft:behavior.delayed_attack
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • attack_duration 数据类型图标attack_duration
      浮点数
      :攻击动画的播放时长,单位为秒。默认值为0.75。
    • hit_delay_pct 数据类型图标hit_delay_pct
      浮点数
      :动画播放到多少比例时结算伤害,1.0表示动画结束。默认值为0.5。
    • attack_once 数据类型图标attack_once
      布尔值
      :为true时该行为在实体整个生命周期内只执行一次。默认值为false。
    • attack_types 数据类型图标attack_types
      字符串
      :该实体攻击的目标类型。
    • can_spread_on_fire 数据类型图标can_spread_on_fire
      布尔值
      :1.20.30+
      该特性在游戏版本1.20.30+下可用。
      为true时,着火的实体空手攻击会点燃目标。默认值为false。
    • reach_multiplier 数据类型图标reach_multiplier
      浮点数
      :以碰撞箱尺寸为基础计算攻击距离的乘数。默认值为1.5。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :接近目标时的移动速度乘数。默认值为1。
    • track_target 数据类型图标track_target
      布尔值
      :为true时即使没有固定感知组件也能追踪目标。默认值为true。
    • require_complete_path 数据类型图标require_complete_path
      布尔值
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      为true时要求存在通往目标的完整路径。默认值为false。
    • random_stop_interval 数据类型图标random_stop_interval
      整数
      :以1/N的概率中断攻击,N为该值。默认值为0。
    • min_path_time 数据类型图标min_path_time
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      重新计算攻击路径的最短基础间隔,单位为秒。默认值为0.2。
    • max_path_time 数据类型图标max_path_time
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      重新计算攻击路径的最长基础间隔,单位为秒。默认值为0.55。
    • path_inner_boundary 数据类型图标path_inner_boundary
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      距目标小于该距离时按inner_boundary_time_increase延长重算间隔。默认值为16。
    • path_outer_boundary 数据类型图标path_outer_boundary
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      距目标大于该距离时按outer_boundary_time_increase延长重算间隔。默认值为32。
    • inner_boundary_time_increase 数据类型图标inner_boundary_time_increase
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      目标靠近时追加的重算间隔,单位为秒。默认值为0.25。
    • outer_boundary_time_increase 数据类型图标outer_boundary_time_increase
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      目标远离时追加的重算间隔,单位为秒。默认值为0.5。
    • path_fail_time_increase 数据类型图标path_fail_time_increase
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      寻路失败时追加的重算间隔,单位为秒。默认值为0.75。
    • melee_fov 数据类型图标melee_fov
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      感知有效目标时使用的视场角,单位为度。默认值为90。
    • x_max_rotation 数据类型图标x_max_rotation
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      注视目标时俯仰方向的最大转角,单位为度。默认值为30。
    • y_max_head_rotation 数据类型图标y_max_head_rotation
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      注视目标时水平方向的最大转角,单位为度。默认值为30。
    • sound_event 数据类型图标sound_event
      字符串
      :攻击时播放的音效事件名。默认值为attack.strong。
    • on_attack 数据类型图标on_attack
      JSON 对象
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      成功攻击时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
      • target 数据类型图标target
        字符串
        :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
    • on_kill 数据类型图标on_kill
      JSON 对象
      :1.21.80+
      该特性在游戏版本1.21.80+下可用。
      击杀目标时触发的事件,结构同上。

minecraft:behavior.dig​

通用
该特性在中国版和国际版均可用。
1.19.0+
该特性在游戏版本1.19.0+下可用。

使生物钻入地面并停留一段时间,监守者使用该行为。

  • minecraft:behavior.dig 数据类型图标minecraft:behavior.dig
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • duration 数据类型图标duration
      浮点数
      :钻地持续的秒数。默认值为0。
    • idle_time 数据类型图标idle_time
      浮点数
      :最后一次扰动后、开始钻地前需保持静止的秒数。默认值为0。
    • allow_dig_when_named 数据类型图标allow_dig_when_named
      布尔值
      :为true时已被命名的实体也能钻地。默认值为false。
    • digs_in_daylight 数据类型图标digs_in_daylight
      布尔值
      :为true时实体见到阳光就开始钻地。默认值为false。
    • suspicion_is_disturbance 数据类型图标suspicion_is_disturbance
      布尔值
      :为true时发现可疑位置也算扰动,会推迟钻地。默认值为false。
    • vibration_is_disturbance 数据类型图标vibration_is_disturbance
      布尔值
      :为true时振动也算扰动,会推迟钻地。默认值为false。
    • on_start 数据类型图标on_start
      JSON 对象
      :1.19.10+
      该特性在游戏版本1.19.10+下可用。
      开始钻地时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
      • target 数据类型图标target
        字符串
        :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。

minecraft:behavior.door_interact​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物能够手动开关门。

  • minecraft:behavior.door_interact 数据类型图标minecraft:behavior.door_interact
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

minecraft:behavior.dragonchargeplayer​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
需要前置组件
要使用该组件,请事先定义minecraft:behavior.dragonscanning组件。
限定实体类型
该组件仅对末影龙可用。

使末影龙向玩家发起俯冲冲锋。

另见:minecraft:behavior.dragonscanning组件。

  • minecraft:behavior.dragonchargeplayer 数据类型图标minecraft:behavior.dragonchargeplayer
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • active_speed 数据类型图标active_speed
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      冲锋进行中或已开始时的移动速度。默认值为3。
    • flight_speed 数据类型图标flight_speed
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      未冲锋时的飞行速度。默认值为0.6。
    • turn_speed 数据类型图标turn_speed
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      执行该行为时的转向速度。默认值为0.7。
    • target_zone 数据类型图标target_zone
      JSON 数组
      :已弃用:1.15.0-26.0
      该特性已被弃用,只能在游戏版本1.15.0-26.0下使用。
      可使用该行为的距离区间,写作[最小值, 最大值],单位为方块。默认值为[10, 150]。
    • target_zone 数据类型图标target_zone
      JSON 对象
      :26.0+
      该特性在游戏版本26.0+下可用,但该版本对于当前的中国版版本过高。
      可使用该行为的距离区间,单位为方块。默认值为{"min": 10, "max": 150}。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为10。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为150。
    • continue_charge_threshold_time 数据类型图标continue_charge_threshold_time
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      目标脱离target_zone超过该秒数后停止冲锋。默认值为0.5。

minecraft:behavior.dragondeath​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对末影龙可用。

控制末影龙死亡时的升空与消散过程。

  • minecraft:behavior.dragondeath 数据类型图标minecraft:behavior.dragondeath
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

minecraft:behavior.dragonflaming​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对末影龙可用。

使末影龙在停驻时先咆哮、再喷吐龙息。

  • minecraft:behavior.dragonflaming 数据类型图标minecraft:behavior.dragonflaming
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • cooldown_time 数据类型图标cooldown_time
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      两次「咆哮并喷吐」循环之间的间隔,单位为秒。默认值为10。
    • roar_time 数据类型图标roar_time
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      咆哮持续的秒数。默认值为2。
    • flame_time 数据类型图标flame_time
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      咆哮结束后喷吐龙息持续的秒数。默认值为0.5。
    • ground_flame_count 数据类型图标ground_flame_count
      整数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      起飞前在地面喷吐龙息的次数。默认值为4。
    • smoke_color 数据类型图标smoke_color
      字符串
      :龙息烟雾的颜色,写作十六进制色值。默认值为#DC00EF。
    • smoke_radius 数据类型图标smoke_radius
      浮点数
      :烟雾的扩散半径。默认值为5。
    • smoke_time 数据类型图标smoke_time
      浮点数
      :烟雾持续的时间。默认值为10。

minecraft:behavior.dragonholdingpattern​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对末影龙可用。

使末影龙在祭坛上方盘旋等待。

  • minecraft:behavior.dragonholdingpattern 数据类型图标minecraft:behavior.dragonholdingpattern
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

minecraft:behavior.dragonlanding​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对末影龙可用。

使末影龙降落到祭坛上。

  • minecraft:behavior.dragonlanding 数据类型图标minecraft:behavior.dragonlanding
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

minecraft:behavior.dragonscanning​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对末影龙可用。

使末影龙扫描周围,寻找可供攻击的目标。

  • minecraft:behavior.dragonscanning 数据类型图标minecraft:behavior.dragonscanning
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

minecraft:behavior.dragonstrafeplayer​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对末影龙可用。

使末影龙绕玩家盘旋并伺机发射火球。

  • minecraft:behavior.dragonstrafeplayer 数据类型图标minecraft:behavior.dragonstrafeplayer
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • active_speed 数据类型图标active_speed
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      该行为进行中的移动速度。默认值为0.6。
    • flight_speed 数据类型图标flight_speed
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      未执行该行为时的飞行速度。默认值为0.6。
    • turn_speed 数据类型图标turn_speed
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      执行该行为时的转向速度。默认值为0.7。
    • target_zone 数据类型图标target_zone
      JSON 数组
      :已弃用:1.15.0-26.0
      该特性已被弃用,只能在游戏版本1.15.0-26.0下使用。
      可使用该行为的距离区间,写作[最小值, 最大值],单位为方块。默认值为[10, 150]。
    • target_zone 数据类型图标target_zone
      JSON 对象
      :26.0+
      该特性在游戏版本26.0+下可用,但该版本对于当前的中国版版本过高。
      可使用该行为的距离区间,单位为方块。默认值为{"min": 10, "max": 150}。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为10。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为150。
    • fireball_range 数据类型图标fireball_range
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      盘旋时可发射火球的最大距离,单位为方块。默认值为64。
    • view_angle 数据类型图标view_angle
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      目标需处于当前朝向多少度以内才发射火球,单位为度。默认值为10。
    • target_in_range_and_in_view_time 数据类型图标target_in_range_and_in_view_time
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      目标需持续处于射程与视野内的秒数。默认值为0.25。
    • switch_direction_probability 数据类型图标switch_direction_probability
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      每刻在顺时针与逆时针之间切换的概率。默认值为0.125。

minecraft:behavior.dragontakeoff​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对末影龙可用。

使末影龙结束停驻、重新起飞盘旋。

  • minecraft:behavior.dragontakeoff 数据类型图标minecraft:behavior.dragontakeoff
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

minecraft:behavior.drink_milk​

通用
该特性在中国版和国际版均可用。
1.19.10+
该特性在游戏版本1.19.10+下可用。

使生物在满足条件时饮用牛奶。

  • minecraft:behavior.drink_milk 数据类型图标minecraft:behavior.drink_milk
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • cooldown_seconds 数据类型图标cooldown_seconds
      浮点数
      :该行为的冷却秒数。默认值为5。
    • filters 数据类型图标filters
      JSON 对象
      :允许饮用牛奶的条件。见实体过滤器。

minecraft:behavior.drink_potion​

通用
该特性在中国版和国际版均可用。
1.12.0+
该特性在游戏版本1.12.0+下可用。

使生物在满足条件时饮用指定的药水。

  • minecraft:behavior.drink_potion 数据类型图标minecraft:behavior.drink_potion
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • potions 数据类型图标potions
      JSON 数组
      :可饮用的药水列表。
      • object 数据类型图标
        JSON 对象
        :一种药水。
        • id 数据类型图标id
          整数
          :药水的注册 ID。默认值为-1。
        • chance 数据类型图标chance
          浮点数
          :选中该药水的概率,取值0.0-1.0。默认值为1。
        • filters 数据类型图标filters
          JSON 对象
          :允许选择该药水的条件。见实体过滤器。
    • speed_modifier 数据类型图标speed_modifier
      浮点数
      :饮用期间施加给生物的速度修正。默认值为0。

备注:id为药水的注册 ID,具体数值随版本变化,建议以官方示例或实际测试为准。


minecraft:behavior.drop_item_for​

通用
该特性在中国版和国际版均可用。
1.8.0+
该特性在游戏版本1.8.0+下可用。
需要前置组件
要使用该组件,请事先定义minecraft:navigation组件。

使生物靠近目标并向其投下物品,例如猫向玩家赠送礼物。

另见:minecraft:navigation.walk等导航组件。

  • minecraft:behavior.drop_item_for 数据类型图标minecraft:behavior.drop_item_for
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • entity_types 数据类型图标entity_types
      JSON 数组
      :可作为投赠对象的实体条件列表。
      • object 数据类型图标
        JSON 对象
        :一项条件。
    • loot_table 数据类型图标loot_table
      字符串
      :决定掉落内容的战利品表路径。
    • drop_item_chance 数据类型图标drop_item_chance
      浮点数
      :每次尝试投下物品的概率,取值0.0-1.0。默认值为1。
    • offering_distance 数据类型图标offering_distance
      浮点数
      :希望与目标保持的投赠距离,单位为方块。默认值为1。
    • cooldown 数据类型图标cooldown
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      该行为的冷却秒数。默认值为0.25。
    • seconds_before_pickup 数据类型图标seconds_before_pickup
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      投下的物品需经过多少秒才能被拾取。默认值为0。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。
    • goal_radius 数据类型图标goal_radius
      浮点数
      :距目标点多近即视为到达,单位为方块。默认值为0.5。
    • target_range 数据类型图标target_range
      JSON 数组
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      寻找落点时在[x, y, z]三个方向上的搜索范围。默认值为[1, 1, 1]。
    • search_range 数据类型图标search_range
      整数
      :搜索落点的水平距离,单位为方块。默认值为0。
    • search_height 数据类型图标search_height
      整数
      :搜索落点的垂直距离,单位为方块。默认值为1。
    • search_count 数据类型图标search_count
      整数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      每刻随机检查的方块数量。默认值为0。
    • max_head_look_at_height 数据类型图标max_head_look_at_height
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      投赠时头部注视的最大高度,单位为方块。默认值为10。
    • minimum_teleport_distance 数据类型图标minimum_teleport_distance
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      目标距离超过该值时实体改为传送,单位为方块。默认值为2。
    • teleport_offset 数据类型图标teleport_offset
      JSON 数组
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      传送落点相对目标的偏移,写作[x, y, z]。默认值为[0, 1, 0]。
    • time_of_day_range 数据类型图标time_of_day_range
      JSON 数组
      :允许执行该行为的时间范围,0.0为正午、0.5为午夜。默认值为[0, 1]。
    • on_drop_attempt 数据类型图标on_drop_attempt
      JSON 对象
      :尝试投下物品时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
      • target 数据类型图标target
        字符串
        :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。

minecraft:behavior.eat_block​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物啃食指定的方块并替换为另一方块,羊吃草即使用该行为。

  • minecraft:behavior.eat_block 数据类型图标minecraft:behavior.eat_block
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • eat_and_replace_block_pairs 数据类型图标eat_and_replace_block_pairs
      JSON 数组
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      被啃食方块与替换方块的对应关系列表。
      • object 数据类型图标
        JSON 对象
        :一组对应。
        • eat_block 数据类型图标eat_block
          字符串
          :被啃食的方块 ID。
        • replace_block 数据类型图标replace_block
          字符串
          :啃食后替换成的方块 ID。
    • success_chance 数据类型图标success_chance
      字符串
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      每刻成功啃食的概率,填 Molang 表达式。默认值为0.02。
    • time_until_eat 数据类型图标time_until_eat
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      啃食动画持续的秒数。默认值为1.8。
    • on_eat 数据类型图标on_eat
      JSON 对象
      :啃食完成后触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
      • target 数据类型图标target
        字符串
        :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。

minecraft:behavior.eat_carried_item​

通用
该特性在中国版和国际版均可用。
1.13.0+
该特性在游戏版本1.13.0+下可用。

使生物吃掉口中携带的物品。

  • minecraft:behavior.eat_carried_item 数据类型图标minecraft:behavior.eat_carried_item
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • delay_before_eating 数据类型图标delay_before_eating
      浮点数
      :开始进食前的等待秒数。默认值为0。

minecraft:behavior.eat_mob​

通用
该特性在中国版和国际版均可用。
1.19.0+
该特性在游戏版本1.19.0+下可用。

使生物吞食其他生物,青蛙吃史莱姆即使用该行为。

  • minecraft:behavior.eat_mob 数据类型图标minecraft:behavior.eat_mob
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • eat_animation_time 数据类型图标eat_animation_time
      浮点数
      :吞食动画持续的秒数。默认值为1。
    • eat_mob_sound 数据类型图标eat_mob_sound
      字符串
      :吞食时播放的音效事件名。
    • loot_table 数据类型图标loot_table
      字符串
      :吞食后掉落内容的战利品表路径。
    • pull_in_force 数据类型图标pull_in_force
      浮点数
      :把被捕食者拉向自己的力。默认值为1。
    • reach_mob_distance 数据类型图标reach_mob_distance
      浮点数
      :开始吞食所需的距离,单位为方块。默认值为1。
    • run_speed 数据类型图标run_speed
      浮点数
      :冲向目标时的速度。默认值为1。

minecraft:behavior.emerge​

通用
该特性在中国版和国际版均可用。
1.19.0+
该特性在游戏版本1.19.0+下可用。

使生物从地下钻出,监守者使用该行为。

  • minecraft:behavior.emerge 数据类型图标minecraft:behavior.emerge
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • duration 数据类型图标duration
      浮点数
      :钻出过程的持续秒数。默认值为5。
    • cooldown_time 数据类型图标cooldown_time
      浮点数
      :再次使用该行为前的冷却秒数。默认值为0.5。
    • on_done 数据类型图标on_done
      JSON 对象
      :即将结束时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
      • target 数据类型图标target
        字符串
        :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。

minecraft:behavior.equip_item​

通用
该特性在中国版和国际版均可用。
1.18.30+
该特性在游戏版本1.18.30+下可用。

使生物拾起并装备地面上的物品。

  • minecraft:behavior.equip_item 数据类型图标minecraft:behavior.equip_item
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

minecraft:behavior.explore_outskirts​

通用
该特性在中国版和国际版均可用。
1.10.0+
该特性在游戏版本1.10.0+下可用。
需要前置组件
要使用该组件,请事先定义minecraft:dweller组件和minecraft:navigation组件。

使村民到村庄外围探索。

另见:minecraft:dweller组件、minecraft:navigation.walk等导航组件。

  • minecraft:behavior.explore_outskirts 数据类型图标minecraft:behavior.explore_outskirts
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • dist_from_boundary 数据类型图标dist_from_boundary
      JSON 数组
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      距村庄边界的距离范围,写作[x, y, z]。默认值为[5, 0, 5]。
    • explore_dist 数据类型图标explore_dist
      浮点数
      :超出村庄边界后继续探索的距离,单位为方块。默认值为5。
    • max_travel_time 数据类型图标max_travel_time
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      前往探索点的最长时间,单位为秒。默认值为60。
    • min_dist_from_target 数据类型图标min_dist_from_target
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      距探索点多近即视为到达,单位为方块。默认值为2.25。
    • min_perimeter 数据类型图标min_perimeter
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      村庄的最小周长,低于该值不执行该行为。默认值为1。
    • min_wait_time 数据类型图标min_wait_time
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      选择下一个探索点前的最短等待秒数。默认值为3。
    • max_wait_time 数据类型图标max_wait_time
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      选择下一个探索点前的最长等待秒数。默认值为0。
    • next_xz 数据类型图标next_xz
      整数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      新探索点在水平方向上的随机范围,单位为方块。默认值为5。
    • next_y 数据类型图标next_y
      整数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      新探索点在垂直方向上的随机范围,单位为方块。默认值为3。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。
    • timer_ratio 数据类型图标timer_ratio
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      等待时长在最短与最长之间的取值比例。默认值为2。

minecraft:behavior.fertilize_farm_block​

通用
该特性在中国版和国际版均可用。
1.18.30+
该特性在游戏版本1.18.30+下可用。

使生物对农田方块施肥,促进作物生长。

  • minecraft:behavior.fertilize_farm_block 数据类型图标minecraft:behavior.fertilize_farm_block
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • goal_radius 数据类型图标goal_radius
      浮点数
      :距目标点多近即视为到达,单位为方块。默认值为1.5。
    • max_fertilizer_usage 数据类型图标max_fertilizer_usage
      整数
      :对同一方块最多施肥的次数。默认值为1。
    • search_cooldown_max_seconds 数据类型图标search_cooldown_max_seconds
      浮点数
      :再次搜索前的最长冷却秒数。默认值为8。
    • search_count 数据类型图标search_count
      整数
      :每刻随机检查的方块数量。默认值为9。
    • search_height 数据类型图标search_height
      整数
      :搜索的垂直距离,单位为方块。默认值为1。
    • search_range 数据类型图标search_range
      整数
      :搜索的水平距离,单位为方块。默认值为1。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为0.5。

minecraft:behavior.find_cover​

通用
该特性在中国版和国际版均可用。
1.13.0+
该特性在游戏版本1.13.0+下可用。

使生物寻找遮蔽物躲藏。

  • minecraft:behavior.find_cover 数据类型图标minecraft:behavior.find_cover
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。
    • cooldown_time 数据类型图标cooldown_time
      浮点数
      :该行为的冷却秒数。默认值为0。

minecraft:behavior.find_mount​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物寻找可骑乘的目标并骑上去。

  • minecraft:behavior.find_mount 数据类型图标minecraft:behavior.find_mount
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • within_radius 数据类型图标within_radius
      整数
      :在多大范围内寻找坐骑,单位为方块。默认值为0。
    • avoid_water 数据类型图标avoid_water
      布尔值
      :为true时不会走进水中去找坐骑。默认值为false。
    • start_delay 数据类型图标start_delay
      整数
      :开始行动前等待的刻数。默认值为0。
    • max_failed_attempts 数据类型图标max_failed_attempts
      整数
      :寻找坐骑的最大尝试次数。默认值为20。
    • mount_distance 数据类型图标mount_distance
      浮点数
      :与坐骑之间需要达到的距离,单位为方块,-1表示不限。默认值为-1。
    • target_needed 数据类型图标target_needed
      布尔值
      :为true时只有拥有攻击目标才会寻找坐骑。默认值为false。

minecraft:behavior.find_underwater_treasure​

通用
该特性在中国版和国际版均可用。
1.5.0+
该特性在游戏版本1.5.0+下可用。

使生物前往海底遗迹寻找宝箱,海豚使用该行为。

  • minecraft:behavior.find_underwater_treasure 数据类型图标minecraft:behavior.find_underwater_treasure
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • search_range 数据类型图标search_range
      整数
      :在遗迹中搜索宝箱的范围。默认值为0。
    • stop_distance 数据类型图标stop_distance
      浮点数
      :距目标多远时停下,单位为方块。默认值为2。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

minecraft:behavior.fire_at_target​

通用
该特性在中国版和国际版均可用。
1.21.30+
该特性在游戏版本1.21.30+下可用。

使生物向目标发射弹射物,旋风人使用该行为。

  • minecraft:behavior.fire_at_target 数据类型图标minecraft:behavior.fire_at_target
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • projectile_def 数据类型图标projectile_def
      字符串
      :作为弹射物的实体定义 ID。
    • attack_range 数据类型图标attack_range
      JSON 数组
      :要求目标所处的距离区间,写作[最小值, 最大值],单位为方块。默认值为[0, 0]。
    • attack_cooldown 数据类型图标attack_cooldown
      浮点数
      :该行为的冷却秒数。默认值为0.5。
    • filters 数据类型图标filters
      JSON 对象
      :允许执行该行为的条件。见实体过滤器。
    • pre_shoot_delay 数据类型图标pre_shoot_delay
      浮点数
      :发射前的准备秒数。默认值为0.75。
    • post_shoot_delay 数据类型图标post_shoot_delay
      浮点数
      :发射后到行为结束的秒数。默认值为0.2。
    • ranged_fov 数据类型图标ranged_fov
      浮点数
      :感知目标时使用的视场角,单位为度。默认值为90。
    • max_head_rotation_x 数据类型图标max_head_rotation_x
      浮点数
      :注视目标时俯仰方向的最大转角,单位为度。默认值为30。
    • max_head_rotation_y 数据类型图标max_head_rotation_y
      浮点数
      :注视目标时水平方向的最大转角,单位为度。默认值为30。
    • owner_anchor 数据类型图标owner_anchor
      整数
      :弹射物的生成锚点。0为原点、1为眼睛高度、2为实体中心。默认值为2。
    • owner_offset 数据类型图标owner_offset
      JSON 数组
      :相对锚点的生成偏移,写作[x, y, z]。默认值为[0, 0, 0]。
    • target_anchor 数据类型图标target_anchor
      整数
      :瞄准目标的锚点,取值同owner_anchor。默认值为2。
    • target_offset 数据类型图标target_offset
      JSON 数组
      :相对目标锚点的偏移,写作[x, y, z]。默认值为[0, 0, 0]。

minecraft:behavior.flee_sun​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物躲避阳光,沼骸与僵尸类实体使用该行为。

  • minecraft:behavior.flee_sun 数据类型图标minecraft:behavior.flee_sun
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

minecraft:behavior.float​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使实体在水中向上浮动,避免沉底。

  • minecraft:behavior.float 数据类型图标minecraft:behavior.float
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • chance_per_tick_to_float 数据类型图标chance_per_tick_to_float
      浮点数
      :1.21.130+
      该特性在游戏版本1.21.130+下可用。
      每刻施加向上推力的概率。默认值为0.8。
    • sink_with_passengers 数据类型图标sink_with_passengers
      布尔值
      :1.19.50+
      该特性在游戏版本1.19.50+下可用。
      为true时只要还有乘客就持续下沉。默认值为false。
    • time_under_water_to_dismount_passengers 数据类型图标time_under_water_to_dismount_passengers
      浮点数
      :1.21.130+
      该特性在游戏版本1.21.130+下可用。
      载具头部没入水中多少秒后让乘客下船。默认值为0。

minecraft:behavior.float_tempt​

通用
该特性在中国版和国际版均可用。
1.21.80+
该特性在游戏版本1.21.80+下可用。

使浮空的生物被手持特定物品的玩家吸引。

  • minecraft:behavior.float_tempt 数据类型图标minecraft:behavior.float_tempt
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • items 数据类型图标items
      JSON 数组
      :可以吸引该生物的物品列表。
      • string 数据类型图标
        字符串
        :物品 ID。
    • within_radius 数据类型图标within_radius
      浮点数
      :在多大范围内能被吸引,单位为方块。默认值为0。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。
    • stop_distance 数据类型图标stop_distance
      浮点数
      :追随玩家时保持的距离,单位为方块。
    • can_get_scared 数据类型图标can_get_scared
      布尔值
      :为true时玩家移动过快会让生物受惊而停止跟随。默认值为false。
    • can_tempt_vertically 数据类型图标can_tempt_vertically
      布尔值
      :为true时垂直距离也计入判定。默认值为false。
    • can_tempt_while_ridden 数据类型图标can_tempt_while_ridden
      布尔值
      :为true时身上有骑乘者也能被吸引。默认值为false。
    • tempt_sound 数据类型图标tempt_sound
      字符串
      :被吸引期间播放的音效事件名。
    • sound_interval 数据类型图标sound_interval
      JSON 数组
      :两次音效之间随机等待的刻数区间。
    • on_tempt_start 数据类型图标on_tempt_start
      JSON 对象
      :开始被吸引时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
      • target 数据类型图标target
        字符串
        :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
    • on_tempt_end 数据类型图标on_tempt_end
      JSON 对象
      :停止被吸引时触发的事件,结构同上。

minecraft:behavior.float_wander​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物在空中随意漂浮游荡,蝙蝠使用该行为。

  • minecraft:behavior.float_wander 数据类型图标minecraft:behavior.float_wander
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • float_duration 数据类型图标float_duration
      JSON 数组
      :已弃用:1.2.0-26.40
      该特性已被弃用,只能在游戏版本1.2.0-26.40下使用。
      每次漂浮持续的时间区间,写作[最小值, 最大值],单位为秒。默认值为[0, 0]。
    • float_duration 数据类型图标float_duration
      JSON 对象
      :26.40+
      该特性在游戏版本26.40+下可用,但该版本对于当前的中国版版本过高。
      每次漂浮持续的时间区间,单位为秒。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为0。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为0。
    • xz_dist 数据类型图标xz_dist
      整数
      :在水平方向上寻找落点的距离,单位为方块。默认值为10。
    • y_dist 数据类型图标y_dist
      整数
      :在垂直方向上寻找落点的距离,单位为方块。默认值为7。
    • y_offset 数据类型图标y_offset
      浮点数
      :在选定落点上叠加的高度偏移,单位为方块。默认值为0。
    • random_reselect 数据类型图标random_reselect
      布尔值
      :为true时移动途中会随机重新选择落点。默认值为false。
    • must_reach 数据类型图标must_reach
      布尔值
      :为true时落点必须可达才有效。默认值为false。
    • float_wander_has_move_control 数据类型图标float_wander_has_move_control
      布尔值
      :1.21.70+
      该特性在游戏版本1.21.70+下可用。
      为true时该行为自带移动控制。默认值为true。
    • use_home_position_restriction 数据类型图标use_home_position_restriction
      布尔值
      :1.21.70+
      该特性在游戏版本1.21.70+下可用。
      为true时遵守minecraft:home的限制范围。默认值为true。
    • navigate_around_surface 数据类型图标navigate_around_surface
      布尔值
      :1.21.80+
      该特性在游戏版本1.21.80+下可用。
      为true时优先在表面附近寻找落点。默认值为false。
    • surface_xz_dist 数据类型图标surface_xz_dist
      整数
      :1.21.80+
      该特性在游戏版本1.21.80+下可用。
      检查表面时的水平距离,单位为方块。默认值为8。
    • surface_y_dist 数据类型图标surface_y_dist
      整数
      :1.21.80+
      该特性在游戏版本1.21.80+下可用。
      检查表面时的垂直距离,单位为方块。默认值为8。
    • additional_collision_buffer 数据类型图标additional_collision_buffer
      布尔值
      :1.21.80+
      该特性在游戏版本1.21.80+下可用。
      为true时在实体周围增加一圈避让缓冲。默认值为false。
    • allow_navigating_through_liquids 数据类型图标allow_navigating_through_liquids
      布尔值
      :1.21.80+
      该特性在游戏版本1.21.80+下可用。
      为true时允许穿过液体寻路。默认值为false。

minecraft:behavior.follow_caravan​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物跟随行进队伍中的其他实体,羊驼使用该行为。

  • minecraft:behavior.follow_caravan 数据类型图标minecraft:behavior.follow_caravan
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • entity_types 数据类型图标entity_types
      JSON 数组
      :队伍中可以跟随的实体条件列表。
      • object 数据类型图标
        JSON 对象
        :一项条件。
    • entity_count 数据类型图标entity_count
      整数
      :队伍中允许的实体数量。默认值为1。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

备注:原版把entity_types写成单个对象,schema 中为数组,两种写法均可解析。


minecraft:behavior.follow_mob​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物跟随附近的其他生物。

  • minecraft:behavior.follow_mob 数据类型图标minecraft:behavior.follow_mob
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • search_range 数据类型图标search_range
      整数
      :搜索可跟随目标的范围,单位为方块。默认值为0。
    • stop_distance 数据类型图标stop_distance
      浮点数
      :与被跟随者保持的距离,单位为方块。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。
    • filters 数据类型图标filters
      JSON 对象
      :1.21.80+
      该特性在游戏版本1.21.80+下可用。
      可作为跟随目标的实体条件。见实体过滤器。
    • preferred_actor_type 数据类型图标preferred_actor_type
      字符串
      :1.21.80+
      该特性在游戏版本1.21.80+下可用。
      优先跟随的实体 ID,省略时随机选择。
    • use_home_position_restriction 数据类型图标use_home_position_restriction
      布尔值
      :1.21.80+
      该特性在游戏版本1.21.80+下可用。
      为true时遵守minecraft:home的限制范围。默认值为false。

minecraft:behavior.follow_owner​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物跟随其主人,如悦灵跟随给予它物品的玩家。

  • minecraft:behavior.follow_owner 数据类型图标minecraft:behavior.follow_owner
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • start_distance 数据类型图标start_distance
      浮点数
      :距主人多远时开始跟随,单位为方块。默认值为10。
    • stop_distance 数据类型图标stop_distance
      浮点数
      :距主人多近时停止跟随,单位为方块。默认值为2。
    • max_distance 数据类型图标max_distance
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      距主人超过该距离后不再跟随,单位为方块。默认值为60。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。
    • can_teleport 数据类型图标can_teleport
      布尔值
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      为true时距离过远会传送到主人身边。默认值为true。
    • post_teleport_distance 数据类型图标post_teleport_distance
      整数
      :1.21.20+
      该特性在游戏版本1.21.20+下可用。
      传送后与主人保持的距离,单位为方块。默认值为3。
    • ignore_vibration 数据类型图标ignore_vibration
      布尔值
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      为true时感知到振动后仍继续跟随。默认值为false。

minecraft:behavior.follow_parent​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使幼年实体跟随其父母。

  • minecraft:behavior.follow_parent 数据类型图标minecraft:behavior.follow_parent
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

minecraft:behavior.follow_target_leader​

通用
该特性在中国版和国际版均可用。
26.20+
该特性在游戏版本26.20+下可用,但该版本对于当前的中国版版本过高。

使生物跟随符合条件的目标作为领队。

  • minecraft:behavior.follow_target_leader 数据类型图标minecraft:behavior.follow_target_leader
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • leader_filters 数据类型图标leader_filters
      JSON 对象
      :可作为领队的实体条件。见实体过滤器。
    • within_radius 数据类型图标within_radius
      浮点数
      :搜索领队的最大距离,单位为方块。默认值为0。
    • follow_distance 数据类型图标follow_distance
      浮点数
      :与目标保持的距离,单位为方块。默认值为0。
    • search_cooldown 数据类型图标search_cooldown
      整数
      :两次搜索之间的间隔,单位为刻。默认值为20。
    • always_look_for_leader 数据类型图标always_look_for_leader
      布尔值
      :为true时即使没有目标也持续寻找领队。默认值为false。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

minecraft:behavior.go_and_give_items_to_noteblock​

通用
该特性在中国版和国际版均可用。
1.19.0+
该特性在游戏版本1.19.0+下可用。

使生物把物品投向音符盒。

  • minecraft:behavior.go_and_give_items_to_noteblock 数据类型图标minecraft:behavior.go_and_give_items_to_noteblock
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • listen_time 数据类型图标listen_time
      整数
      :在音符盒处继续投掷物品的秒数。默认值为30。
    • reach_block_distance 数据类型图标reach_block_distance
      浮点数
      :距音符盒多近时开始投掷,单位为方块。默认值为3。
    • run_speed 数据类型图标run_speed
      浮点数
      :冲向音符盒时的速度。默认值为1。
    • throw_force 数据类型图标throw_force
      浮点数
      :投掷力度。默认值为0.2。
    • vertical_throw_mul 数据类型图标vertical_throw_mul
      浮点数
      :在投掷力度之上叠加的垂直分量乘数。默认值为1.5。
    • throw_sound 数据类型图标throw_sound
      字符串
      :投掷时播放的音效事件名。默认值为charge。
    • on_item_throw 数据类型图标on_item_throw
      JSON 数组
      :投掷物品时触发的事件列表。
      • object 数据类型图标
        JSON 对象
        :一个事件。
        • event 数据类型图标event
          字符串
          :事件 ID。
        • target 数据类型图标target
          字符串
          :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。

minecraft:behavior.go_and_give_items_to_owner​

通用
该特性在中国版和国际版均可用。
1.19.0+
该特性在游戏版本1.19.0+下可用。

使生物把物品投向其主人。

  • minecraft:behavior.go_and_give_items_to_owner 数据类型图标minecraft:behavior.go_and_give_items_to_owner
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • reach_mob_distance 数据类型图标reach_mob_distance
      浮点数
      :距主人多近时开始投掷,单位为方块。默认值为3。
    • run_speed 数据类型图标run_speed
      浮点数
      :冲向主人时的速度。默认值为1。
    • throw_force 数据类型图标throw_force
      浮点数
      :投掷力度。默认值为0.2。
    • vertical_throw_mul 数据类型图标vertical_throw_mul
      浮点数
      :在投掷力度之上叠加的垂直分量乘数。默认值为1.5。
    • throw_sound 数据类型图标throw_sound
      字符串
      :投掷时播放的音效事件名。默认值为charge。
    • on_item_throw 数据类型图标on_item_throw
      JSON 数组
      :投掷物品时触发的事件列表。
      • object 数据类型图标
        JSON 对象
        :一个事件。
        • event 数据类型图标event
          字符串
          :事件 ID。
        • target 数据类型图标target
          字符串
          :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。

minecraft:behavior.go_home​

通用
该特性在中国版和国际版均可用。
1.5.0+
该特性在游戏版本1.5.0+下可用。

使生物返回其「家」的位置,需配合minecraft:home组件。

  • minecraft:behavior.go_home 数据类型图标minecraft:behavior.go_home
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • interval 数据类型图标interval
      整数
      :再次尝试回家前的随机间隔,单位为刻。默认值为120。
    • goal_radius 数据类型图标goal_radius
      浮点数
      :距家多近即视为到达,单位为方块。默认值为0.5。
    • calculate_new_path_radius 数据类型图标calculate_new_path_radius
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      距终点多近时重新计算路径,单位为方块。默认值为2。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。
    • on_home 数据类型图标on_home
      JSON 数组
      :到家时触发的事件列表。
      • object 数据类型图标
        JSON 对象
        :一个事件。
        • event 数据类型图标event
          字符串
          :事件 ID。
        • target 数据类型图标target
          字符串
          :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
        • filters 数据类型图标filters
          JSON 对象
          :触发条件。见实体过滤器。
    • on_failed 数据类型图标on_failed
      JSON 数组
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      回家失败时触发的事件列表,结构同上。

minecraft:behavior.guardian_attack​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对守卫者与远古守卫者可用。

使守卫者与远古守卫者发动魔法攻击。

  • minecraft:behavior.guardian_attack 数据类型图标minecraft:behavior.guardian_attack
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • magic_damage 数据类型图标magic_damage
      整数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      魔法攻击的基础伤害。默认值为1。
    • elder_extra_magic_damage 数据类型图标elder_extra_magic_damage
      整数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      远古守卫者额外增加的魔法伤害。默认值为2。
    • hard_mode_extra_magic_damage 数据类型图标hard_mode_extra_magic_damage
      整数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      困难难度下额外增加的魔法伤害。默认值为2。
    • min_distance 数据类型图标min_distance
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      目标距离小于该值时停止该行为,单位为方块。默认值为3。
    • sound_delay_time 数据类型图标sound_delay_time
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      开始攻击后延迟多少秒播放音效。默认值为0.5。
    • x_max_rotation 数据类型图标x_max_rotation
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      俯仰方向的最大转角,单位为度。默认值为90。
    • y_max_head_rotation 数据类型图标y_max_head_rotation
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      水平方向的最大转角,单位为度。默认值为90。

minecraft:behavior.harvest_farm_block​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
需要前置组件
要使用该组件,请事先定义minecraft:inventory组件和minecraft:navigation组件。

使村民收割成熟的作物。

另见:minecraft:inventory组件、minecraft:navigation.walk等导航组件、EntityInventoryComponent 类。

  • minecraft:behavior.harvest_farm_block 数据类型图标minecraft:behavior.harvest_farm_block
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • goal_radius 数据类型图标goal_radius
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      距目标点多近即视为到达,单位为方块。默认值为1.5。
    • search_range 数据类型图标search_range
      整数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      搜索农田的水平距离,单位为方块。默认值为16。
    • search_height 数据类型图标search_height
      整数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      搜索农田的垂直距离,单位为方块。默认值为1。
    • search_count 数据类型图标search_count
      整数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      每刻随机检查的方块数量。默认值为0。
    • max_seconds_before_search 数据类型图标max_seconds_before_search
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      开始搜索前允许等待的最长秒数。默认值为1。
    • search_cooldown_max_seconds 数据类型图标search_cooldown_max_seconds
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      搜索失败后再次搜索前的最长冷却秒数。默认值为8。
    • seconds_until_new_task 数据类型图标seconds_until_new_task
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      成功收割后进入下一任务前的冷却秒数。默认值为0.5。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为0.5。

minecraft:behavior.hide​

通用
该特性在中国版和国际版均可用。
1.18.10+
该特性在游戏版本1.18.10+下可用。

使生物移动到并躲藏在其兴趣点处。

  • minecraft:behavior.hide 数据类型图标minecraft:behavior.hide
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • poi_type 数据类型图标poi_type
      字符串
      :要寻找的兴趣点类型。可选值为bed(床)、meeting_area(集会点)、jobsite(工作站点)。
    • duration 数据类型图标duration
      浮点数
      :躲藏的持续秒数。默认值为1。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。
    • timeout_cooldown 数据类型图标timeout_cooldown
      浮点数
      :被打断后再次使用该行为前的冷却秒数。默认值为8。

minecraft:behavior.hold_ground​

通用
该特性在中国版和国际版均可用。
1.13.3+
该特性在游戏版本1.13.3+下可用。

使生物在目标进入一定距离后停下并固守原地。

  • minecraft:behavior.hold_ground 数据类型图标minecraft:behavior.hold_ground
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • min_radius 数据类型图标min_radius
      浮点数
      :目标需进入该距离才执行该行为,单位为方块。默认值为10。
    • broadcast 数据类型图标broadcast
      布尔值
      :为true时把当前目标广播给同类实体。默认值为false。
    • broadcast_range 数据类型图标broadcast_range
      浮点数
      :广播的范围,单位为方块。默认值为0。
    • within_radius_event 数据类型图标within_radius_event
      JSON 对象
      :目标进入范围时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
      • target 数据类型图标target
        字符串
        :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。

minecraft:behavior.hover​

通用
该特性在中国版和国际版均可用。
1.14.0+
该特性在游戏版本1.14.0+下可用。

使实体在空中悬停。

  • minecraft:behavior.hover 数据类型图标minecraft:behavior.hover
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

minecraft:behavior.hurt_by_target​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物把伤害来源设为目标进行反击。

  • minecraft:behavior.hurt_by_target 数据类型图标minecraft:behavior.hurt_by_target
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • entity_types 数据类型图标entity_types
      JSON 数组
      :可作为反击目标的实体条件列表。
      • object 数据类型图标
        JSON 对象
        :一项条件。
    • hurt_owner 数据类型图标hurt_owner
      布尔值
      :为true时也会攻击主人以及属于同一主人的实体。默认值为false。

minecraft:behavior.inspect_bookshelf​

通用
该特性在中国版和国际版均可用。
1.10.0+
该特性在游戏版本1.10.0+下可用。

使村民查看书架。

  • minecraft:behavior.inspect_bookshelf 数据类型图标minecraft:behavior.inspect_bookshelf
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • goal_radius 数据类型图标goal_radius
      浮点数
      :距目标点多近即视为到达,单位为方块。默认值为0.5。
    • search_range 数据类型图标search_range
      整数
      :搜索书架的距离,单位为方块。默认值为0。
    • search_height 数据类型图标search_height
      整数
      :搜索书架的高度,单位为方块。默认值为1。
    • search_count 数据类型图标search_count
      整数
      :每刻随机检查的方块数量。默认值为10。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

minecraft:behavior.investigate_suspicious_location​

通用
该特性在中国版和国际版均可用。
1.19.0+
该特性在游戏版本1.19.0+下可用。

使生物前往可疑位置进行调查,监守者使用该行为。

  • minecraft:behavior.investigate_suspicious_location 数据类型图标minecraft:behavior.investigate_suspicious_location
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • goal_radius 数据类型图标goal_radius
      浮点数
      :距目标点多近即视为到达,单位为方块。默认值为1.5。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

minecraft:behavior.jump_around_target​

通用
该特性在中国版和国际版均可用。
1.21.30+
该特性在游戏版本1.21.30+下可用。

使生物围绕目标跳跃移动,旋风人使用该行为。

  • minecraft:behavior.jump_around_target 数据类型图标minecraft:behavior.jump_around_target
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • filters 数据类型图标filters
      JSON 对象
      :允许执行该行为的条件。见实体过滤器。
    • jump_angles 数据类型图标jump_angles
      JSON 数组
      :允许使用的跳跃角度列表,单位为度。默认值为[40, 55, 60, 75, 80]。
    • max_jump_velocity 数据类型图标max_jump_velocity
      浮点数
      :跳跃的最大速度。默认值为1.4。
    • prepare_jump_duration 数据类型图标prepare_jump_duration
      浮点数
      :起跳前的准备秒数。默认值为0.5。
    • jump_cooldown_duration 数据类型图标jump_cooldown_duration
      浮点数
      :两次跳跃之间的冷却秒数。默认值为0.5。
    • jump_cooldown_when_hurt_duration 数据类型图标jump_cooldown_when_hurt_duration
      浮点数
      :受伤后跳跃的冷却秒数。默认值为0.1。
    • last_hurt_duration 数据类型图标last_hurt_duration
      浮点数
      :判定「近期受伤」的秒数,受伤后的跳跃改用较短的冷却。默认值为2。
    • valid_distance_to_target 数据类型图标valid_distance_to_target
      JSON 数组
      :已弃用:1.21.30-26.20
      该特性已被弃用,只能在游戏版本1.21.30-26.20下使用。
      允许起跳的目标距离区间写作[最小值, 最大值],单位为方块。默认值为[4, 20]。
    • valid_distance_to_target 数据类型图标valid_distance_to_target
      JSON 对象
      :26.20+
      该特性在游戏版本26.20+下可用,但该版本对于当前的中国版版本过高。
      允许起跳的目标距离区间,单位为方块。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为4。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为20。
    • landing_distance_from_target 数据类型图标landing_distance_from_target
      JSON 数组
      :已弃用:1.21.30-26.20
      该特性已被弃用,只能在游戏版本1.21.30-26.20下使用。
      落点与目标的距离区间写作[最小值, 最大值],单位为方块。默认值为[4, 8]。
    • landing_distance_from_target 数据类型图标landing_distance_from_target
      JSON 对象
      :26.20+
      该特性在游戏版本26.20+下可用,但该版本对于当前的中国版版本过高。
      落点与目标的距离区间,单位为方块。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为4。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为8。
    • landing_position_spread_degrees 数据类型图标landing_position_spread_degrees
      整数
      :选择落点时的散布角度,单位为度。默认值为90。
    • required_vertical_space 数据类型图标required_vertical_space
      整数
      :头顶需要留空的方块数。默认值为4。
    • line_of_sight_obstruction_height_ignore 数据类型图标line_of_sight_obstruction_height_ignore
      整数
      :视线受阻时,低于该高度的遮挡物可忽略,单位为方块。默认值为4。
    • snap_to_surface_block_range 数据类型图标snap_to_surface_block_range
      整数
      :在落点上下多大范围内贴合表面,单位为方块。默认值为10。
    • check_collision 数据类型图标check_collision
      布尔值
      :为true时计算跳跃时会检查碰撞。默认值为false。
    • entity_bounding_box_scale 数据类型图标entity_bounding_box_scale
      浮点数
      :跳跃期间临时施加给碰撞箱的缩放。默认值为0.7。

minecraft:behavior.jump_to_block​

通用
该特性在中国版和国际版均可用。
1.18.30+
该特性在游戏版本1.18.30+下可用。

使生物跳向指定的方块,青蛙使用该行为。

  • minecraft:behavior.jump_to_block 数据类型图标minecraft:behavior.jump_to_block
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • cooldown_range 数据类型图标cooldown_range
      JSON 数组
      :已弃用:1.18.30-26.20
      该特性已被弃用,只能在游戏版本1.18.30-26.20下使用。
      两次跳跃之间的冷却秒数区间写作[最小值, 最大值]。默认值为[10, 20]。
    • cooldown_range 数据类型图标cooldown_range
      JSON 对象
      :26.20+
      该特性在游戏版本26.20+下可用,但该版本对于当前的中国版版本过高。
      两次跳跃之间的冷却秒数区间,单位为秒。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为10。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为20。
    • forbidden_blocks 数据类型图标forbidden_blocks
      JSON 数组
      :不能跳向的方块列表,元素写作{ "name": 方块 ID }。
    • preferred_blocks 数据类型图标preferred_blocks
      JSON 数组
      :优先跳向的方块列表,写法同上。
    • preferred_blocks_chance 数据类型图标preferred_blocks_chance
      浮点数
      :优先选择偏好方块的附加概率,取值0.0-1.0。默认值为1。
    • max_velocity 数据类型图标max_velocity
      浮点数
      :跳跃的最大速度。默认值为1.5。
    • minimum_distance 数据类型图标minimum_distance
      整数
      :与目标方块的最小距离,单位为方块。默认值为2。
    • minimum_path_length 数据类型图标minimum_path_length
      整数
      :通往目标方块的最短路径长度,单位为方块。默认值为5。
    • search_width 数据类型图标search_width
      整数
      :搜索框的宽度,单位为方块,取值1-15。默认值为8。
    • search_height 数据类型图标search_height
      整数
      :搜索框的高度,单位为方块,取值1-15。默认值为10。
    • scale_factor 数据类型图标scale_factor
      浮点数
      :跳跃期间碰撞箱的缩放系数。默认值为0.7。

minecraft:behavior.knockback_roar​

通用
该特性在中国版和国际版均可用。
1.11.0+
该特性在游戏版本1.11.0+下可用。

使生物咆哮并把周围的实体击退,劫掠兽使用该行为。

  • minecraft:behavior.knockback_roar 数据类型图标minecraft:behavior.knockback_roar
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • attack_time 数据类型图标attack_time
      浮点数
      :开始咆哮到产生击退之间的延迟秒数。默认值为0.5。
    • duration 数据类型图标duration
      浮点数
      :咆哮持续的秒数。默认值为1。
    • cooldown_time 数据类型图标cooldown_time
      浮点数
      :该行为的冷却秒数。默认值为0.1。
    • knockback_damage 数据类型图标knockback_damage
      整数
      :咆哮造成的伤害。默认值为6。
    • knockback_range 数据类型图标knockback_range
      整数
      :击退作用的半径,单位为方块。默认值为4。
    • knockback_horizontal_strength 数据类型图标knockback_horizontal_strength
      整数
      :1.17.20+
      该特性在游戏版本1.17.20+下可用。
      水平击退强度。默认值为4。
    • knockback_vertical_strength 数据类型图标knockback_vertical_strength
      整数
      :1.17.20+
      该特性在游戏版本1.17.20+下可用。
      垂直击退强度。默认值为4。
    • knockback_height_cap 数据类型图标knockback_height_cap
      浮点数
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      垂直击退的高度上限。默认值为0.4。
    • damage_filters 数据类型图标damage_filters
      JSON 对象
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      会受到伤害的实体条件。见实体过滤器。
    • knockback_filters 数据类型图标knockback_filters
      JSON 对象
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      会被击退的实体条件。见实体过滤器。
    • on_roar_end 数据类型图标on_roar_end
      JSON 对象
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      咆哮结束时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
      • target 数据类型图标target
        字符串
        :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。

minecraft:behavior.lay_down​

通用
该特性在中国版和国际版均可用。
1.8.0+
该特性在游戏版本1.8.0+下可用。

使生物躺下休息,熊猫使用该行为。

  • minecraft:behavior.lay_down 数据类型图标minecraft:behavior.lay_down
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • interval 数据类型图标interval
      整数
      :可以进入躺下状态的随机间隔,单位为刻。默认值为120。
    • random_stop_interval 数据类型图标random_stop_interval
      整数
      :退出躺下状态的随机间隔,单位为刻。默认值为120。

minecraft:behavior.lay_egg​

通用
该特性在中国版和国际版均可用。
1.5.0+
该特性在游戏版本1.5.0+下可用。

使生物在指定方块上产卵,海龟与青蛙使用该行为。

  • minecraft:behavior.lay_egg 数据类型图标minecraft:behavior.lay_egg
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • egg_type 数据类型图标egg_type
      字符串
      :1.18.10+
      该特性在游戏版本1.18.10+下可用。
      产下的卵对应的方块 ID。默认值为minecraft:turtle_egg。
    • target_blocks 数据类型图标target_blocks
      JSON 数组
      :1.18.10+
      该特性在游戏版本1.18.10+下可用。
      可以在其上方产卵的方块列表。默认值为[ "minecraft:sand" ]。
    • target_materials_above_block 数据类型图标target_materials_above_block
      JSON 数组
      :1.18.10+
      该特性在游戏版本1.18.10+下可用。
      目标方块上方允许存在的材质列表。默认值为[ "air" ]。
    • lay_seconds 数据类型图标lay_seconds
      浮点数
      :1.18.10+
      该特性在游戏版本1.18.10+下可用。
      产卵过程持续的秒数。默认值为10。
    • lay_egg_sound 数据类型图标lay_egg_sound
      字符串
      :1.18.10+
      该特性在游戏版本1.18.10+下可用。
      产卵时播放的音效事件名。默认值为lay_egg。
    • allow_laying_from_below 数据类型图标allow_laying_from_below
      布尔值
      :1.18.10+
      该特性在游戏版本1.18.10+下可用。
      为true时允许从目标方块下方产卵。默认值为false。
    • use_default_animation 数据类型图标use_default_animation
      布尔值
      :1.18.10+
      该特性在游戏版本1.18.10+下可用。
      为true时播放默认的产卵动画。默认值为true。
    • search_range 数据类型图标search_range
      整数
      :搜索产卵位置的距离,单位为方块。默认值为0。
    • search_height 数据类型图标search_height
      整数
      :搜索产卵位置的高度,单位为方块。默认值为1。
    • goal_radius 数据类型图标goal_radius
      浮点数
      :距目标点多近即视为到达,单位为方块。默认值为0.5。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。
    • on_lay 数据类型图标on_lay
      JSON 对象
      :产卵时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
      • target 数据类型图标target
        字符串
        :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。

minecraft:behavior.leap_at_target​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对猫、豹猫、狼与蜘蛛类实体可用。

使生物向目标扑跃。

  • minecraft:behavior.leap_at_target 数据类型图标minecraft:behavior.leap_at_target
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • yd 数据类型图标yd
      浮点数
      :扑跃时达到的高度,单位为方块。默认值为0。
    • must_be_on_ground 数据类型图标must_be_on_ground
      布尔值
      :为true时只有站在地面上才会扑跃。默认值为true。
    • set_persistent 数据类型图标set_persistent
      布尔值
      :1.16.0+
      该特性在游戏版本1.16.0+下可用。
      为true时锁定玩家为目标后转为持久实体。默认值为false。

schema 把该组件标注为仅敌对生物可用,但 26.60 的原版包中猫、豹猫、狼也在使用,此处按原版书写。


minecraft:behavior.look_at_entity​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物注视附近的特定实体。

  • minecraft:behavior.look_at_entity 数据类型图标minecraft:behavior.look_at_entity
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • angle_of_view_horizontal 数据类型图标angle_of_view_horizontal
      整数
      :水平方向的视场角,单位为度。默认值为360。
    • angle_of_view_vertical 数据类型图标angle_of_view_vertical
      整数
      :垂直方向的视场角,单位为度。默认值为360。
    • look_distance 数据类型图标look_distance
      浮点数
      :可注视的最远距离,单位为方块。默认值为8。
    • look_time 数据类型图标look_time
      JSON 数组
      :已弃用:1.2.0-26.0
      该特性已被弃用,只能在游戏版本1.2.0-26.0下使用。
      每次注视持续时间的区间,写作[最小值, 最大值],单位为秒。默认值为[2, 4]。
    • look_time 数据类型图标look_time
      JSON 对象
      :26.0+
      该特性在游戏版本26.0+下可用,但该版本对于当前的中国版版本过高。
      每次注视持续时间的区间,单位为秒。默认值为{"min": 2, "max": 4}。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为2。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为4。
    • probability 数据类型图标probability
      浮点数
      :每刻开始注视的概率,取值0.0-1.0。默认值为0.02。
    • filters 数据类型图标filters
      JSON 对象
      :可以被注视的实体条件。见实体过滤器。

minecraft:behavior.look_at_player​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物注视附近的玩家。

  • minecraft:behavior.look_at_player 数据类型图标minecraft:behavior.look_at_player
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • angle_of_view_horizontal 数据类型图标angle_of_view_horizontal
      整数
      :水平方向的视场角,单位为度。默认值为360。
    • angle_of_view_vertical 数据类型图标angle_of_view_vertical
      整数
      :垂直方向的视场角,单位为度。默认值为360。
    • look_distance 数据类型图标look_distance
      浮点数
      :可注视的最远距离,单位为方块。默认值为8。
    • look_time 数据类型图标look_time
      JSON 数组
      :已弃用:1.2.0-26.0
      该特性已被弃用,只能在游戏版本1.2.0-26.0下使用。
      每次注视持续时间的区间,写作[最小值, 最大值],单位为秒。默认值为[2, 4]。
    • look_time 数据类型图标look_time
      JSON 对象
      :26.0+
      该特性在游戏版本26.0+下可用,但该版本对于当前的中国版版本过高。
      每次注视持续时间的区间,单位为秒。默认值为{"min": 2, "max": 4}。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为2。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为4。
    • probability 数据类型图标probability
      浮点数
      :每刻开始注视的概率,取值0.0-1.0。默认值为0.02。

minecraft:behavior.look_at_target​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物注视其当前攻击目标。

  • minecraft:behavior.look_at_target 数据类型图标minecraft:behavior.look_at_target
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • angle_of_view_horizontal 数据类型图标angle_of_view_horizontal
      整数
      :水平方向的视场角,单位为度。默认值为360。
    • angle_of_view_vertical 数据类型图标angle_of_view_vertical
      整数
      :垂直方向的视场角,单位为度。默认值为360。
    • look_distance 数据类型图标look_distance
      浮点数
      :可注视的最远距离,单位为方块。默认值为8。
    • look_time 数据类型图标look_time
      JSON 数组
      :已弃用:1.2.0-26.0
      该特性已被弃用,只能在游戏版本1.2.0-26.0下使用。
      每次注视持续时间的区间,写作[最小值, 最大值],单位为秒。默认值为[2, 4]。
    • look_time 数据类型图标look_time
      JSON 对象
      :26.0+
      该特性在游戏版本26.0+下可用,但该版本对于当前的中国版版本过高。
      每次注视持续时间的区间,单位为秒。默认值为{"min": 2, "max": 4}。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为2。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为4。
    • probability 数据类型图标probability
      浮点数
      :每刻开始注视的概率,取值0.0-1.0。默认值为0.02。

minecraft:behavior.look_at_trading_player​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物注视正在与其交易的玩家。

  • minecraft:behavior.look_at_trading_player 数据类型图标minecraft:behavior.look_at_trading_player
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • angle_of_view_horizontal 数据类型图标angle_of_view_horizontal
      整数
      :水平方向的视场角,单位为度。默认值为360。
    • angle_of_view_vertical 数据类型图标angle_of_view_vertical
      整数
      :垂直方向的视场角,单位为度。默认值为360。
    • look_distance 数据类型图标look_distance
      浮点数
      :可注视的最远距离,单位为方块。默认值为8。
    • look_time 数据类型图标look_time
      JSON 数组
      :已弃用:1.2.0-26.0
      该特性已被弃用,只能在游戏版本1.2.0-26.0下使用。
      每次注视持续时间的区间,写作[最小值, 最大值],单位为秒。默认值为[2, 4]。
    • look_time 数据类型图标look_time
      JSON 对象
      :26.0+
      该特性在游戏版本26.0+下可用,但该版本对于当前的中国版版本过高。
      每次注视持续时间的区间,单位为秒。默认值为{"min": 2, "max": 4}。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为2。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为4。
    • probability 数据类型图标probability
      浮点数
      :每刻开始注视的概率,取值0.0-1.0。默认值为0.02。

minecraft:behavior.make_love​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对村民可用。

使生物寻找配偶并进入求爱状态,需配合minecraft:breedable组件。

  • minecraft:behavior.make_love 数据类型图标minecraft:behavior.make_love
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

minecraft:behavior.melee_attack​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物接近并近战攻击目标。

  • minecraft:behavior.melee_attack 数据类型图标minecraft:behavior.melee_attack
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • reach_multiplier 数据类型图标reach_multiplier
      浮点数
      :以碰撞箱尺寸为基础计算攻击距离的乘数,0表示不进行近战攻击。默认值为2。
    • cooldown_time 数据类型图标cooldown_time
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      两次攻击之间的冷却秒数。默认值为1。
    • attack_once 数据类型图标attack_once
      布尔值
      :1.6.0+
      该特性在游戏版本1.6.0+下可用。
      为true时该行为在实体整个生命周期内只执行一次。默认值为false。
    • attack_types 数据类型图标attack_types
      字符串
      :该实体攻击的目标类型。
    • can_spread_on_fire 数据类型图标can_spread_on_fire
      布尔值
      :1.20.30+
      该特性在游戏版本1.20.30+下可用。
      为true时,着火的实体空手攻击会点燃目标。默认值为false。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :接近目标时的移动速度乘数。默认值为1。
    • track_target 数据类型图标track_target
      布尔值
      :为true时即使没有固定感知组件也能追踪目标。默认值为false。
    • require_complete_path 数据类型图标require_complete_path
      布尔值
      :1.9.0+
      该特性在游戏版本1.9.0+下可用。
      为true时要求存在通往目标的完整路径。默认值为false。
    • random_stop_interval 数据类型图标random_stop_interval
      整数
      :以1/N的概率中断攻击,N为该值。默认值为0。
    • min_path_time 数据类型图标min_path_time
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      重新计算攻击路径的最短基础间隔,单位为秒。默认值为0.2。
    • max_path_time 数据类型图标max_path_time
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      重新计算攻击路径的最长基础间隔,单位为秒。默认值为0.55。
    • path_inner_boundary 数据类型图标path_inner_boundary
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      距目标小于该距离时追加inner_boundary_time_increase的重算间隔。默认值为16。
    • path_outer_boundary 数据类型图标path_outer_boundary
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      距目标大于该距离时追加outer_boundary_time_increase的重算间隔。默认值为32。
    • inner_boundary_time_increase 数据类型图标inner_boundary_time_increase
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      目标靠近时追加的重算间隔,单位为秒。默认值为0.25。
    • outer_boundary_time_increase 数据类型图标outer_boundary_time_increase
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      目标远离时追加的重算间隔,单位为秒。默认值为0.5。
    • path_fail_time_increase 数据类型图标path_fail_time_increase
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      寻路失败时追加的重算间隔,单位为秒。默认值为0.75。
    • melee_fov 数据类型图标melee_fov
      浮点数
      :1.6.0+
      该特性在游戏版本1.6.0+下可用。
      感知有效目标时使用的视场角,单位为度。默认值为90。
    • x_max_rotation 数据类型图标x_max_rotation
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      注视目标时俯仰方向的最大转角,单位为度。默认值为30。
    • y_max_head_rotation 数据类型图标y_max_head_rotation
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      注视目标时水平方向的最大转角,单位为度。默认值为30。
    • on_attack 数据类型图标on_attack
      JSON 对象
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      成功攻击时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
      • target 数据类型图标target
        字符串
        :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
    • on_kill 数据类型图标on_kill
      JSON 对象
      :1.21.80+
      该特性在游戏版本1.21.80+下可用。
      击杀目标时触发的事件,结构同上。

minecraft:behavior.melee_box_attack​

通用
该特性在中国版和国际版均可用。
1.20.50+
该特性在游戏版本1.20.50+下可用。

使生物以矩形判定范围进行近战攻击。

  • minecraft:behavior.melee_box_attack 数据类型图标minecraft:behavior.melee_box_attack
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • horizontal_reach 数据类型图标horizontal_reach
      浮点数
      :在实体碰撞箱基础上向外扩展的判定距离,单位为方块。默认值为0.8。
    • cooldown_time 数据类型图标cooldown_time
      浮点数
      :两次攻击之间的冷却秒数。默认值为1。
    • attack_once 数据类型图标attack_once
      布尔值
      :为true时该行为在实体整个生命周期内只执行一次。默认值为false。
    • attack_types 数据类型图标attack_types
      字符串
      :该实体攻击的目标类型。
    • can_spread_on_fire 数据类型图标can_spread_on_fire
      布尔值
      :为true时,着火的实体空手攻击会点燃目标。默认值为false。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :接近目标时的移动速度乘数。默认值为1。
    • track_target 数据类型图标track_target
      布尔值
      :为true时即使没有固定感知组件也能追踪目标。默认值为false。
    • require_complete_path 数据类型图标require_complete_path
      布尔值
      :为true时要求存在通往目标的完整路径。默认值为false。
    • random_stop_interval 数据类型图标random_stop_interval
      整数
      :以1/N的概率中断攻击,N为该值。默认值为0。
    • min_path_time 数据类型图标min_path_time
      浮点数
      :重新计算攻击路径的最短基础间隔,单位为秒。默认值为0.2。
    • max_path_time 数据类型图标max_path_time
      浮点数
      :重新计算攻击路径的最长基础间隔,单位为秒。默认值为0.55。
    • path_inner_boundary 数据类型图标path_inner_boundary
      浮点数
      :距目标小于该距离时追加inner_boundary_time_increase的重算间隔。默认值为16。
    • path_outer_boundary 数据类型图标path_outer_boundary
      浮点数
      :距目标大于该距离时追加outer_boundary_time_increase的重算间隔。默认值为32。
    • inner_boundary_time_increase 数据类型图标inner_boundary_time_increase
      浮点数
      :目标靠近时追加的重算间隔,单位为秒。默认值为0.25。
    • outer_boundary_time_increase 数据类型图标outer_boundary_time_increase
      浮点数
      :目标远离时追加的重算间隔,单位为秒。默认值为0.5。
    • path_fail_time_increase 数据类型图标path_fail_time_increase
      浮点数
      :寻路失败时追加的重算间隔,单位为秒。默认值为0.75。
    • melee_fov 数据类型图标melee_fov
      浮点数
      :感知有效目标时使用的视场角,单位为度。默认值为90。
    • x_max_rotation 数据类型图标x_max_rotation
      浮点数
      :注视目标时俯仰方向的最大转角,单位为度。默认值为30。
    • y_max_head_rotation 数据类型图标y_max_head_rotation
      浮点数
      :注视目标时水平方向的最大转角,单位为度。默认值为30。
    • on_attack 数据类型图标on_attack
      JSON 对象
      :成功攻击时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
      • target 数据类型图标target
        字符串
        :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
    • on_kill 数据类型图标on_kill
      JSON 对象
      :1.21.80+
      该特性在游戏版本1.21.80+下可用。
      击杀目标时触发的事件,结构同上。

minecraft:behavior.mingle​

通用
该特性在中国版和国际版均可用。
1.10.0+
该特性在游戏版本1.10.0+下可用。

使生物与其他同类聚在一起交流,村民使用该行为。

  • minecraft:behavior.mingle 数据类型图标minecraft:behavior.mingle
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • mingle_partner_type 数据类型图标mingle_partner_type
      字符串
      :1.12.0+
      该特性在游戏版本1.12.0+下可用。
      可以交流的实体类型,如minecraft:villager_v2。
    • mingle_distance 数据类型图标mingle_distance
      浮点数
      :1.12.0+
      该特性在游戏版本1.12.0+下可用。
      与交流对象保持的距离,单位为方块。默认值为2。
    • duration 数据类型图标duration
      浮点数
      :每次交流持续的秒数。默认值为1。
    • cooldown_time 数据类型图标cooldown_time
      浮点数
      :该行为的冷却秒数。默认值为0。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

minecraft:behavior.mount_pathing​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
需要前置组件
要使用该组件,请事先定义minecraft:rideable组件。

使骑乘中的实体朝目标移动。

另见:minecraft:rideable组件、EntityRideableComponent 类。

  • minecraft:behavior.mount_pathing 数据类型图标minecraft:behavior.mount_pathing
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • target_dist 数据类型图标target_dist
      浮点数
      :与目标保持的距离,单位为方块。默认值为0。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。
    • track_target 数据类型图标track_target
      布尔值
      :为true时只要目标有效就持续追击。默认值为false。

minecraft:behavior.move_around_target​

通用
该特性在中国版和国际版均可用。
1.21.30+
该特性在游戏版本1.21.30+下可用。

使生物在目标周围游走,旋风人使用该行为。

  • minecraft:behavior.move_around_target 数据类型图标minecraft:behavior.move_around_target
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • filters 数据类型图标filters
      JSON 对象
      :允许执行该行为的条件。见实体过滤器。
    • destination_position_range 数据类型图标destination_position_range
      JSON 数组
      :已弃用:1.21.30-26.20
      该特性已被弃用,只能在游戏版本1.21.30-26.20下使用。
      落点与目标之间的距离区间写作[最小值, 最大值],单位为方块。默认值为[4, 8]。
    • destination_position_range 数据类型图标destination_position_range
      JSON 对象
      :26.20+
      该特性在游戏版本26.20+下可用,但该版本对于当前的中国版版本过高。
      落点与目标之间的距离区间,单位为方块。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为4。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为8。
    • destination_pos_spread_degrees 数据类型图标destination_pos_spread_degrees
      浮点数
      :1.21.80+
      该特性在游戏版本1.21.80+下可用。
      选择落点时的散布角度,单位为度。默认值为90。
    • height_difference_limit 数据类型图标height_difference_limit
      浮点数
      :与目标允许的最大高度差,单位为方块。默认值为10。
    • horizontal_search_distance 数据类型图标horizontal_search_distance
      整数
      :搜索落点的水平距离,单位为方块。默认值为5。
    • vertical_search_distance 数据类型图标vertical_search_distance
      整数
      :搜索落点的垂直距离,单位为方块。默认值为5。
    • movement_speed 数据类型图标movement_speed
      浮点数
      :移动时的速度。默认值为0.6。

minecraft:behavior.move_indoors​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物向室内移动,村民在夜晚使用该行为。

  • minecraft:behavior.move_indoors 数据类型图标minecraft:behavior.move_indoors
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :移动时的速度乘数。默认值为0.8。
    • timeout_cooldown 数据类型图标timeout_cooldown
      浮点数
      :1.11.0+
      该特性在游戏版本1.11.0+下可用。
      寻路失败后再次使用该行为前的冷却秒数。默认值为8。

minecraft:behavior.move_outdoors​

通用
该特性在中国版和国际版均可用。
1.18.30+
该特性在游戏版本1.18.30+下可用。

使生物向室外移动。

  • minecraft:behavior.move_outdoors 数据类型图标minecraft:behavior.move_outdoors
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • search_range 数据类型图标search_range
      整数
      :搜索室外位置的水平范围,单位为方块。默认值为15。
    • search_height 数据类型图标search_height
      整数
      :搜索室外位置的垂直范围,单位为方块。默认值为5。
    • search_count 数据类型图标search_count
      整数
      :搜索失败前尝试的随机位置数量。默认值为10。
    • goal_radius 数据类型图标goal_radius
      浮点数
      :距目标点多近即视为到达,单位为方块。默认值为2。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :移动时的速度乘数。默认值为0.5。
    • timeout_cooldown 数据类型图标timeout_cooldown
      浮点数
      :寻路失败后再次使用该行为前的冷却秒数。默认值为8。

minecraft:behavior.move_through_village​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对铁傀儡可用。

使生物在村庄中来回走动。

  • minecraft:behavior.move_through_village 数据类型图标minecraft:behavior.move_through_village
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • only_at_night 数据类型图标only_at_night
      布尔值
      :为true时只在夜间走动。默认值为false。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

schema 把该组件标注为仅村民可用,但 26.60 的原版包中只有铁傀儡使用,此处按原版书写。


minecraft:behavior.move_to_block​

通用
该特性在中国版和国际版均可用。
1.14.0+
该特性在游戏版本1.14.0+下可用。

使生物移动到指定的方块处并停留一段时间。

  • minecraft:behavior.move_to_block 数据类型图标minecraft:behavior.move_to_block
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • target_blocks 数据类型图标target_blocks
      JSON 数组
      :要前往的方块列表。
      • string 数据类型图标
        字符串
        :方块 ID。
    • target_block_filters 数据类型图标target_block_filters
      JSON 对象
      :方块需满足的条件。见实体过滤器。
    • target_selection_method 数据类型图标target_selection_method
      字符串
      :方块的选择方式。可选值为nearest(最近)与random(随机)。默认值为nearest。
    • target_offset 数据类型图标target_offset
      JSON 数组
      :目标位置相对方块的偏移,写作[x, y, z]。默认值为[0, 0, 0]。
    • search_range 数据类型图标search_range
      整数
      :搜索方块的距离,单位为方块。默认值为0。
    • search_height 数据类型图标search_height
      整数
      :搜索方块的高度,单位为方块。默认值为1。
    • goal_radius 数据类型图标goal_radius
      浮点数
      :距目标多近即视为到达,单位为方块。默认值为0.5。
    • stay_duration 数据类型图标stay_duration
      浮点数
      :到达后需要停留的刻数。默认值为0。
    • start_chance 数据类型图标start_chance
      浮点数
      :1.18.10+
      该特性在游戏版本1.18.10+下可用。
      每次尝试时启动该行为的概率。默认值为1。
    • tick_interval 数据类型图标tick_interval
      整数
      :尝试执行该行为的平均间隔,单位为刻。默认值为20。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。
    • on_reach 数据类型图标on_reach
      JSON 数组
      :到达方块时触发的事件列表。
      • object 数据类型图标
        JSON 对象
        :一个事件。
        • event 数据类型图标event
          字符串
          :事件 ID。
        • target 数据类型图标target
          字符串
          :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
    • on_stay_completed 数据类型图标on_stay_completed
      JSON 数组
      :在方块处停留完成后触发的事件列表,结构同上。

minecraft:behavior.move_to_land​

通用
该特性在中国版和国际版均可用。
1.5.0+
该特性在游戏版本1.5.0+下可用。

使生物离开水域移动到陆地上,青蛙使用该行为。

  • minecraft:behavior.move_to_land 数据类型图标minecraft:behavior.move_to_land
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • search_range 数据类型图标search_range
      整数
      :搜索陆地的水平距离,单位为方块。默认值为0。
    • search_height 数据类型图标search_height
      整数
      :搜索陆地的垂直距离,单位为方块。默认值为1。
    • search_count 数据类型图标search_count
      整数
      :1.8.0+
      该特性在游戏版本1.8.0+下可用。
      每刻随机检查的方块数量。默认值为10。
    • goal_radius 数据类型图标goal_radius
      浮点数
      :距目标点多近即视为到达,单位为方块。默认值为0.5。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

minecraft:behavior.move_to_lava​

通用
该特性在中国版和国际版均可用。
1.21.80+
该特性在游戏版本1.21.80+下可用。实际加入版本存疑。

定义实体在陆地上时返回熔岩的行为。

  • minecraft:behavior.move_to_lava 数据类型图标minecraft:behavior.move_to_lava
    JSON 对象
    :根对象。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • goal_radius 数据类型图标goal_radius
      浮点数
      :判定到达目标的范围,单位为方块。默认值为0.5。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。
    • search_count 数据类型图标search_count
      整数
      :每刻随机选取的方块数量。默认值为10。
    • search_height 数据类型图标search_height
      整数
      :搜索熔岩的垂直范围,单位为方块。默认值为1。
    • search_range 数据类型图标search_range
      整数
      :搜索熔岩的水平范围,单位为方块。默认值为0。

minecraft:behavior.move_to_liquid​

通用
该特性在中国版和国际版均可用。
1.18.10+
该特性在游戏版本1.18.10+下可用。

使生物寻找并移动到液体方块处。

  • minecraft:behavior.move_to_liquid 数据类型图标minecraft:behavior.move_to_liquid
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • material_type 数据类型图标material_type
      字符串
      :要寻找的液体材质。可选值为any(任意液体)、water、lava。默认值为any。
    • search_range 数据类型图标search_range
      整数
      :搜索液体的水平距离,单位为方块。默认值为0。
    • search_height 数据类型图标search_height
      整数
      :搜索液体的垂直距离,单位为方块。默认值为1。
    • search_count 数据类型图标search_count
      整数
      :每刻随机检查的方块数量。默认值为10。
    • goal_radius 数据类型图标goal_radius
      浮点数
      :距目标点多近即视为到达,单位为方块。默认值为0.5。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

minecraft:behavior.move_to_poi​

通用
该特性在中国版和国际版均可用。
1.18.10+
该特性在游戏版本1.18.10+下可用。

使生物移动到指定类型的兴趣点处。

  • minecraft:behavior.move_to_poi 数据类型图标minecraft:behavior.move_to_poi
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • poi_type 数据类型图标poi_type
      字符串
      :要寻找的兴趣点类型。可选值为bed(床)、meeting_area(集会点)、jobsite(工作站点)。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

minecraft:behavior.move_to_random_block​

通用
该特性在中国版和国际版均可用。
1.12.0+
该特性在游戏版本1.12.0+下可用。

使生物移动到附近随机的方块位置。

  • minecraft:behavior.move_to_random_block 数据类型图标minecraft:behavior.move_to_random_block
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • block_distance 数据类型图标block_distance
      浮点数
      :目标方块与实体的距离上限,单位为方块。默认值为16。
    • within_radius 数据类型图标within_radius
      浮点数
      :距目标方块多近即视为到达,单位为方块。默认值为0。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

minecraft:behavior.move_to_village​

通用
该特性在中国版和国际版均可用。
1.12.0+
该特性在游戏版本1.12.0+下可用。

使生物移动到最近的村庄。

  • minecraft:behavior.move_to_village 数据类型图标minecraft:behavior.move_to_village
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • search_range 数据类型图标search_range
      整数
      :1.13.0+
      该特性在游戏版本1.13.0+下可用。
      搜索村庄的距离,单位为方块;小于等于0时找最近的村庄。默认值为0。
    • goal_radius 数据类型图标goal_radius
      浮点数
      :距目标点多近即视为到达,单位为方块。默认值为1.5。
    • cooldown_time 数据类型图标cooldown_time
      浮点数
      :1.13.0+
      该特性在游戏版本1.13.0+下可用。
      该行为的冷却秒数。默认值为8。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

minecraft:behavior.move_to_water​

通用
该特性在中国版和国际版均可用。
1.4.0+
该特性在游戏版本1.4.0+下可用。

使生物寻找并移动到水域。

  • minecraft:behavior.move_to_water 数据类型图标minecraft:behavior.move_to_water
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • search_range 数据类型图标search_range
      整数
      :搜索水域的水平距离,单位为方块。默认值为0。
    • search_height 数据类型图标search_height
      整数
      :搜索水域的垂直距离,单位为方块。默认值为1。
    • search_count 数据类型图标search_count
      整数
      :1.8.0+
      该特性在游戏版本1.8.0+下可用。
      每刻随机检查的方块数量。默认值为10。
    • goal_radius 数据类型图标goal_radius
      浮点数
      :距目标点多近即视为到达,单位为方块。默认值为0.5。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

minecraft:behavior.move_towards_dwelling_restriction​

通用
该特性在中国版和国际版均可用。
1.18.30+
该特性在游戏版本1.18.30+下可用。

使生物回到其居住地的限制范围内。

  • minecraft:behavior.move_towards_dwelling_restriction 数据类型图标minecraft:behavior.move_towards_dwelling_restriction
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :移动时的速度乘数。默认值为1。

minecraft:behavior.move_towards_home_restriction​

通用
该特性在中国版和国际版均可用。
1.18.30+
该特性在游戏版本1.18.30+下可用。

使生物回到其「家」的限制范围内。

  • minecraft:behavior.move_towards_home_restriction 数据类型图标minecraft:behavior.move_towards_home_restriction
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :移动时的速度乘数。默认值为1。

minecraft:behavior.move_towards_restriction​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物回到行为限制的范围内。

  • minecraft:behavior.move_towards_restriction 数据类型图标minecraft:behavior.move_towards_restriction
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :移动时的速度乘数。默认值为1。

备注:官方 schema 未收录该组件,参数按同类限制类行为整理。


minecraft:behavior.move_towards_target​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物朝其攻击目标靠近。

  • minecraft:behavior.move_towards_target 数据类型图标minecraft:behavior.move_towards_target
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • within_radius 数据类型图标within_radius
      浮点数
      :希望与目标保持的距离,单位为方块。默认值为0。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

minecraft:behavior.nap​

通用
该特性在中国版和国际版均可用。
1.13.0+
该特性在游戏版本1.13.0+下可用。

使生物打盹,狐狸使用该行为。

  • minecraft:behavior.nap 数据类型图标minecraft:behavior.nap
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • can_nap_filters 数据类型图标can_nap_filters
      JSON 对象
      :允许打盹的条件。见实体过滤器。
    • wake_mob_exceptions 数据类型图标wake_mob_exceptions
      JSON 对象
      :即使靠近也不会吵醒该实体的生物条件。见实体过滤器。
    • cooldown_min 数据类型图标cooldown_min
      浮点数
      :再次打盹前的最短等待秒数。默认值为0。
    • cooldown_max 数据类型图标cooldown_max
      浮点数
      :再次打盹前的最长等待秒数。默认值为0。
    • mob_detect_dist 数据类型图标mob_detect_dist
      浮点数
      :检测附近生物的水平距离,单位为方块。默认值为6。
    • mob_detect_height 数据类型图标mob_detect_height
      浮点数
      :检测附近生物的垂直距离,单位为方块。默认值为6。

minecraft:behavior.nearest_attackable_target​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物把最近的可攻击实体设为目标。

  • minecraft:behavior.nearest_attackable_target 数据类型图标minecraft:behavior.nearest_attackable_target
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • entity_types 数据类型图标entity_types
      JSON 数组
      :可作为目标的实体条件列表。
      • object 数据类型图标
        JSON 对象
        :一项条件。
        • filters 数据类型图标filters
          JSON 对象
          :实体需满足的条件。见实体过滤器。
        • max_dist 数据类型图标max_dist
          浮点数
          :该类型目标的最大距离,单位为方块。
        • max_height 数据类型图标max_height
          浮点数
          :该类实体可作为目标的高度上限,-1表示不限制。默认值为-1。
        • max_flee 数据类型图标max_flee
          浮点数
          :逃离该类实体时距其多远停止,单位为方块。默认值为10。
        • cooldown 数据类型图标cooldown
          整数
          :再次选中该类实体前需要等待的秒数。默认值为0。
        • priority 数据类型图标priority
          整数
          :该实体类型在候选列表中的优先级,数值越小越优先。默认值为0。
        • must_see 数据类型图标must_see
          布尔值
          :为true时该类实体必须可见才会被选中。
        • must_see_forget_duration 数据类型图标must_see_forget_duration
          整数
          :看不见该类实体后多少秒放弃,单位为秒。默认值为3。
        • check_if_outnumbered 数据类型图标check_if_outnumbered
          布尔值
          :为true时检查该类实体的数量是否占优。默认值为false。
        • reevaluate_description 数据类型图标reevaluate_description
          布尔值
          :为true时,对方一旦不再满足条件就停止将其作为目标。默认值为false。
        • walk_speed_multiplier 数据类型图标walk_speed_multiplier
          浮点数
          :接近该目标时的行走速度乘数。
        • sprint_speed_multiplier 数据类型图标sprint_speed_multiplier
          浮点数
          :接近该目标时的疾跑速度乘数。
    • must_see 数据类型图标must_see
      布尔值
      :为true时只把视野内的实体作为目标。默认值为false。
    • must_reach 数据类型图标must_reach
      布尔值
      :为true时要求存在通往目标的路径。默认值为false。
    • must_see_forget_duration 数据类型图标must_see_forget_duration
      浮点数
      :目标离开视野多少秒后放弃。默认值为3。
    • within_radius 数据类型图标within_radius
      浮点数
      :距目标的最大跟随距离,单位为方块。默认值为0。
    • persist_time 数据类型图标persist_time
      浮点数
      :1.6.0+
      该特性在游戏版本1.6.0+下可用。
      目标不可见后仍继续攻击的秒数。默认值为0。
    • reselect_targets 数据类型图标reselect_targets
      布尔值
      :为true时允许改用更近的目标。默认值为false。
    • attack_owner 数据类型图标attack_owner
      布尔值
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      为true时可以攻击自己的主人。默认值为false。
    • set_persistent 数据类型图标set_persistent
      布尔值
      :1.16.0+
      该特性在游戏版本1.16.0+下可用。
      为true时锁定玩家为目标后转为持久实体。默认值为false。
    • attack_interval 数据类型图标attack_interval
      JSON 数组
      :已弃用:1.21.130-26.0
      该特性已被弃用,只能在游戏版本1.21.130-26.0下使用。
      两次搜索目标之间的秒数区间,写作[最小值, 最大值]。默认值为[0, 0]。
    • attack_interval 数据类型图标attack_interval
      JSON 对象
      :26.0+
      该特性在游戏版本26.0+下可用,但该版本对于当前的中国版版本过高。
      两次搜索目标之间的秒数区间。默认值为{"min": 0, "max": 0}。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为0。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为0。
    • scan_interval 数据类型图标scan_interval
      整数
      :1.6.0+
      该特性在游戏版本1.6.0+下可用。
      未设置attack_interval时的扫描间隔,单位为刻。默认值为10。
    • target_search_height 数据类型图标target_search_height
      浮点数
      :1.6.0+
      该特性在游戏版本1.6.0+下可用。
      搜索目标的垂直距离,-1表示不限。默认值为-1。
    • target_invisible_multiplier 数据类型图标target_invisible_multiplier
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      目标护甲覆盖率对该距离判定的修正系数。默认值为0.7。
    • target_sneak_visibility_multiplier 数据类型图标target_sneak_visibility_multiplier
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      目标潜行时距离判定的修正系数。默认值为0.8。
    • target_acquisition_probability 数据类型图标target_acquisition_probability
      浮点数
      :1.21.130+
      该特性在游戏版本1.21.130+下可用。
      接受找到的目标的概率,取值0.0-1.0。默认值为1。

minecraft:behavior.nearest_prioritized_attackable_target​

通用
该特性在中国版和国际版均可用。
1.13.0+
该特性在游戏版本1.13.0+下可用。

使生物按优先级选择可攻击的目标。

  • minecraft:behavior.nearest_prioritized_attackable_target 数据类型图标minecraft:behavior.nearest_prioritized_attackable_target
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • entity_types 数据类型图标entity_types
      JSON 数组
      :可作为目标的实体条件列表,各项可带priority。
      • object 数据类型图标
        JSON 对象
        :一项条件。
        • filters 数据类型图标filters
          JSON 对象
          :实体需满足的条件。见实体过滤器。
        • max_dist 数据类型图标max_dist
          浮点数
          :该类型目标的最大距离,单位为方块。
        • max_height 数据类型图标max_height
          浮点数
          :该类实体可作为目标的高度上限,-1表示不限制。默认值为-1。
        • max_flee 数据类型图标max_flee
          浮点数
          :逃离该类实体时距其多远停止,单位为方块。默认值为10。
        • cooldown 数据类型图标cooldown
          整数
          :1.20.0+
          该特性在游戏版本1.20.0+下可用。
          再次选中该类实体前需要等待的秒数。默认值为0。
        • priority 数据类型图标priority
          整数
          :该实体类型在候选列表中的优先级,数值越小越优先。默认值为0。
        • must_see 数据类型图标must_see
          布尔值
          :为true时该类实体必须可见才会被选中。
        • must_see_forget_duration 数据类型图标must_see_forget_duration
          整数
          :看不见该类实体后多少秒放弃,单位为秒。默认值为3。
        • check_if_outnumbered 数据类型图标check_if_outnumbered
          布尔值
          :为true时检查该类实体的数量是否占优。默认值为false。
        • reevaluate_description 数据类型图标reevaluate_description
          布尔值
          :为true时,对方一旦不再满足条件就停止将其作为目标。默认值为false。
        • walk_speed_multiplier 数据类型图标walk_speed_multiplier
          浮点数
          :接近该目标时的行走速度乘数。
        • sprint_speed_multiplier 数据类型图标sprint_speed_multiplier
          浮点数
          :接近该目标时的疾跑速度乘数。
    • must_see 数据类型图标must_see
      布尔值
      :为true时只把视野内的实体作为目标。默认值为false。
    • must_reach 数据类型图标must_reach
      布尔值
      :为true时只把可寻路到达的实体作为目标。默认值为false。
    • must_see_forget_duration 数据类型图标must_see_forget_duration
      浮点数
      :目标离开视野多少秒后放弃。默认值为3。
    • within_radius 数据类型图标within_radius
      浮点数
      :距目标的最大跟随距离,单位为方块。默认值为0。
    • persist_time 数据类型图标persist_time
      浮点数
      :目标不可见后仍继续攻击的秒数。默认值为0。
    • reselect_targets 数据类型图标reselect_targets
      布尔值
      :为true时允许改用更近的目标。默认值为false。
    • hurt_owner 数据类型图标hurt_owner
      布尔值
      :为true时也会攻击伤害主人的实体。默认值为false。
    • set_persistent 数据类型图标set_persistent
      布尔值
      :1.16.0+
      该特性在游戏版本1.16.0+下可用。
      为true时锁定玩家为目标后转为持久实体。默认值为false。
    • attack_interval 数据类型图标attack_interval
      整数
      :选择目标的间隔秒数。默认值为0。
    • scan_interval 数据类型图标scan_interval
      整数
      :扫描目标的间隔,单位为刻。默认值为10。
    • target_search_height 数据类型图标target_search_height
      浮点数
      :搜索目标的垂直距离,-1表示不限。默认值为-1。

minecraft:behavior.ocelot_sit_on_block​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物坐到当前所在的方块上。

  • minecraft:behavior.ocelot_sit_on_block 数据类型图标minecraft:behavior.ocelot_sit_on_block
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

minecraft:behavior.ocelotattack​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物以潜行接近再冲刺的方式发动攻击,豹猫与猫使用该行为。

  • minecraft:behavior.ocelotattack 数据类型图标minecraft:behavior.ocelotattack
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • cooldown_time 数据类型图标cooldown_time
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      两次攻击之间的秒数。默认值为1。
    • max_distance 数据类型图标max_distance
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      可使用该行为的最大距离,单位为方块。默认值为15。
    • max_sneak_range 数据类型图标max_sneak_range
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      开始潜行的最大距离,单位为方块。默认值为15。
    • max_sprint_range 数据类型图标max_sprint_range
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      开始冲刺的最大距离,单位为方块。默认值为4。
    • reach_multiplier 数据类型图标reach_multiplier
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      以碰撞箱尺寸为基础计算攻击距离的乘数。默认值为2。
    • sneak_speed_multiplier 数据类型图标sneak_speed_multiplier
      浮点数
      :潜行时的速度乘数。默认值为0.6。
    • sprint_speed_multiplier 数据类型图标sprint_speed_multiplier
      浮点数
      :冲刺时的速度乘数。默认值为1.33。
    • walk_speed_multiplier 数据类型图标walk_speed_multiplier
      浮点数
      :既不潜行也不冲刺时的速度乘数。默认值为0.8。
    • x_max_rotation 数据类型图标x_max_rotation
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      注视目标时俯仰方向的最大转角,单位为度。默认值为30。
    • y_max_head_rotation 数据类型图标y_max_head_rotation
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      注视目标时水平方向的最大转角,单位为度。默认值为30。

minecraft:behavior.offer_flower​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物向附近的另一只生物献花,铁傀儡使用该行为。

  • minecraft:behavior.offer_flower 数据类型图标minecraft:behavior.offer_flower
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • filters 数据类型图标filters
      JSON 对象
      :1.19.50+
      该特性在游戏版本1.19.50+下可用。
      允许献花的条件。见实体过滤器。
    • chance_to_start 数据类型图标chance_to_start
      浮点数
      :1.19.50+
      该特性在游戏版本1.19.50+下可用。
      每刻开始献花的概率。默认值为0.000125。
    • max_offer_flower_duration 数据类型图标max_offer_flower_duration
      浮点数
      :1.19.50+
      该特性在游戏版本1.19.50+下可用。
      献花持续的秒数。默认值为20。
    • search_area 数据类型图标search_area
      JSON 数组
      :1.19.50+
      该特性在游戏版本1.19.50+下可用。
      搜索献花对象的范围,写作[x, y, z]。默认值为[6, 2, 6]。
    • max_rotation_x 数据类型图标max_rotation_x
      浮点数
      :1.19.50+
      该特性在游戏版本1.19.50+下可用。
      俯仰方向的最大转角,单位为度。默认值为30。
    • max_head_rotation_y 数据类型图标max_head_rotation_y
      浮点数
      :1.19.50+
      该特性在游戏版本1.19.50+下可用。
      水平方向的最大转角,单位为度。默认值为30。

minecraft:behavior.open_door​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物能够开门并穿过。

  • minecraft:behavior.open_door 数据类型图标minecraft:behavior.open_door
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • close_door_after 数据类型图标close_door_after
      布尔值
      :为true时通过后会关门。默认值为true。

备注:该行为要求实体的寻路组件允许开门(can_open_doors为true),否则生物不会尝试开门。


minecraft:behavior.owner_hurt_by_target​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物在主人被攻击时把攻击者设为目标。

  • minecraft:behavior.owner_hurt_by_target 数据类型图标minecraft:behavior.owner_hurt_by_target
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • entity_types 数据类型图标entity_types
      JSON 数组
      :可作为目标的实体条件列表。
      • object 数据类型图标
        JSON 对象
        :一项条件。
        • filters 数据类型图标filters
          JSON 对象
          :实体需满足的条件。见实体过滤器。
        • max_dist 数据类型图标max_dist
          浮点数
          :该类型目标的最大距离,单位为方块。
        • max_height 数据类型图标max_height
          浮点数
          :该类实体可作为目标的高度上限,-1表示不限制。默认值为-1。
        • max_flee 数据类型图标max_flee
          浮点数
          :逃离该类实体时距其多远停止,单位为方块。默认值为10。
        • cooldown 数据类型图标cooldown
          整数
          :再次选中该类实体前需要等待的秒数。默认值为0。
        • priority 数据类型图标priority
          整数
          :该实体类型在候选列表中的优先级,数值越小越优先。默认值为0。
        • must_see 数据类型图标must_see
          布尔值
          :为true时该类实体必须可见才会被选中。
        • must_see_forget_duration 数据类型图标must_see_forget_duration
          整数
          :看不见该类实体后多少秒放弃,单位为秒。默认值为3。
        • check_if_outnumbered 数据类型图标check_if_outnumbered
          布尔值
          :为true时检查该类实体的数量是否占优。默认值为false。
        • reevaluate_description 数据类型图标reevaluate_description
          布尔值
          :为true时,对方一旦不再满足条件就停止将其作为目标。默认值为false。
        • walk_speed_multiplier 数据类型图标walk_speed_multiplier
          浮点数
          :接近该类实体时的行走速度乘数。默认值为1。
        • sprint_speed_multiplier 数据类型图标sprint_speed_multiplier
          浮点数
          :接近该类实体时的疾跑速度乘数。默认值为1。

minecraft:behavior.owner_hurt_target​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物在主人攻击某实体时把该实体设为目标。

  • minecraft:behavior.owner_hurt_target 数据类型图标minecraft:behavior.owner_hurt_target
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • entity_types 数据类型图标entity_types
      JSON 数组
      :可作为目标的实体条件列表。
      • object 数据类型图标
        JSON 对象
        :一项条件。
        • filters 数据类型图标filters
          JSON 对象
          :实体需满足的条件。见实体过滤器。
        • max_dist 数据类型图标max_dist
          浮点数
          :该类型目标的最大距离,单位为方块。
        • max_height 数据类型图标max_height
          浮点数
          :该类实体可作为目标的高度上限,-1表示不限制。默认值为-1。
        • max_flee 数据类型图标max_flee
          浮点数
          :逃离该类实体时距其多远停止,单位为方块。默认值为10。
        • cooldown 数据类型图标cooldown
          整数
          :再次选中该类实体前需要等待的秒数。默认值为0。
        • priority 数据类型图标priority
          整数
          :该实体类型在候选列表中的优先级,数值越小越优先。默认值为0。
        • must_see 数据类型图标must_see
          布尔值
          :为true时该类实体必须可见才会被选中。
        • must_see_forget_duration 数据类型图标must_see_forget_duration
          整数
          :看不见该类实体后多少秒放弃,单位为秒。默认值为3。
        • check_if_outnumbered 数据类型图标check_if_outnumbered
          布尔值
          :为true时检查该类实体的数量是否占优。默认值为false。
        • reevaluate_description 数据类型图标reevaluate_description
          布尔值
          :为true时,对方一旦不再满足条件就停止将其作为目标。默认值为false。
        • walk_speed_multiplier 数据类型图标walk_speed_multiplier
          浮点数
          :接近该类实体时的行走速度乘数。默认值为1。
        • sprint_speed_multiplier 数据类型图标sprint_speed_multiplier
          浮点数
          :接近该类实体时的疾跑速度乘数。默认值为1。

minecraft:behavior.panic​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物受到伤害后惊慌逃跑。26.60起生物被困住时不再每刻反复停止与启动该意向。

  • minecraft:behavior.panic 数据类型图标minecraft:behavior.panic
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • damage_sources 数据类型图标damage_sources
      JSON 数组
      :1.16.0+
      该特性在游戏版本1.16.0+下可用。
      会引发惊慌的伤害来源类型列表,如all。
      • string 数据类型图标
        字符串
        :伤害来源类型。
    • ignore_mob_damage 数据类型图标ignore_mob_damage
      布尔值
      :1.9.0+
      该特性在游戏版本1.9.0+下可用。
      为true时被其他生物伤害不会惊慌。默认值为false。
    • force 数据类型图标force
      布尔值
      :为true时只有找不到玩家才会停止惊慌。默认值为false。
    • prefer_water 数据类型图标prefer_water
      布尔值
      :1.5.0+
      该特性在游戏版本1.5.0+下可用。
      为true时优先逃向水中。默认值为false。
    • panic_sound 数据类型图标panic_sound
      字符串
      :惊慌时播放的音效事件名。
    • sound_interval 数据类型图标sound_interval
      JSON 数组
      :两次音效之间随机等待的刻数区间。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :惊慌时的移动速度乘数。默认值为1。

minecraft:behavior.pet_sleep_with_owner​

通用
该特性在中国版和国际版均可用。
1.8.0+
该特性在游戏版本1.8.0+下可用。

使已驯服的宠物睡在主人身边。

  • minecraft:behavior.pet_sleep_with_owner 数据类型图标minecraft:behavior.pet_sleep_with_owner
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • search_range 数据类型图标search_range
      整数
      :搜索主人的距离,单位为方块。默认值为0。
    • search_height 数据类型图标search_height
      整数
      :允许与主人相隔的高度,单位为方块。默认值为1。
    • goal_radius 数据类型图标goal_radius
      浮点数
      :距主人多近即视为到达,单位为方块。默认值为0.5。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

minecraft:behavior.pickup_items​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物拾取地面上的物品。

  • minecraft:behavior.pickup_items 数据类型图标minecraft:behavior.pickup_items
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • can_pickup_any_item 数据类型图标can_pickup_any_item
      布尔值
      :1.16.0+
      该特性在游戏版本1.16.0+下可用。
      为true时任何物品都会拾取。默认值为false。
    • can_pickup_to_hand_or_equipment 数据类型图标can_pickup_to_hand_or_equipment
      布尔值
      :1.16.0+
      该特性在游戏版本1.16.0+下可用。
      为true时可以把物品放到手上或装备栏。默认值为true。
    • pickup_based_on_chance 数据类型图标pickup_based_on_chance
      布尔值
      :1.16.0+
      该特性在游戏版本1.16.0+下可用。
      为true时按难度决定是否拾取。默认值为false。
    • pickup_same_items_as_in_hand 数据类型图标pickup_same_items_as_in_hand
      布尔值
      :为true时只拾取与手中相同的物品。默认值为false。
    • stop_if_holding_item 数据类型图标stop_if_holding_item
      布尔值
      :为true时手中已有物品就不再拾取。默认值为false。
    • track_target 数据类型图标track_target
      布尔值
      :为true时持续追逐有效目标。默认值为false。
    • excluded_items 数据类型图标excluded_items
      JSON 数组
      :1.17.30+
      该特性在游戏版本1.17.30+下可用。
      不会拾取的物品列表。
      • string 数据类型图标
        字符串
        :物品 ID。
    • max_dist 数据类型图标max_dist
      整数
      :搜索物品的最大距离,单位为方块。默认值为1。
    • search_height 数据类型图标search_height
      整数
      :搜索物品的垂直距离,单位为方块。默认值为1。
    • cooldown_after_being_attacked 数据类型图标cooldown_after_being_attacked
      整数
      :被攻击后多少秒内停止拾取。默认值为0。
    • goal_radius 数据类型图标goal_radius
      浮点数
      :距物品多近即视为到达,单位为方块。默认值为0.5。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。
    • on_pickup_item_start 数据类型图标on_pickup_item_start
      JSON 对象
      :26.20+
      该特性在游戏版本26.20+下可用,但该版本对于当前的中国版版本过高。
      开始走向物品时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
      • target 数据类型图标target
        字符串
        :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
    • on_pickup_item_end 数据类型图标on_pickup_item_end
      JSON 对象
      :26.20+
      该特性在游戏版本26.20+下可用,但该版本对于当前的中国版版本过高。
      拾取完成或放弃时触发的事件,结构同上。

minecraft:behavior.place_block​

通用
该特性在中国版和国际版均可用。
1.21.100+
该特性在游戏版本1.21.100+下可用。

使生物放置携带的方块,铜傀儡使用该行为。

  • minecraft:behavior.place_block 数据类型图标minecraft:behavior.place_block
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • placeable_carried_blocks 数据类型图标placeable_carried_blocks
      JSON 数组
      :允许从身上放置的方块列表,元素写作{ "block": 方块描述 }。
    • randomly_placeable_blocks 数据类型图标randomly_placeable_blocks
      JSON 数组
      :可随机放置的方块列表,元素含block、filter与weight。
    • can_place 数据类型图标can_place
      JSON 对象
      :允许放置的条件。见实体过滤器。
    • chance 数据类型图标chance
      浮点数
      :每刻尝试放置的概率。默认值为1。
    • affected_by_griefing_rule 数据类型图标affected_by_griefing_rule
      布尔值
      :为true时受「允许破坏方块」游戏规则影响。默认值为true。
    • xz_range 数据类型图标xz_range
      JSON 数组
      :尝试放置的水平范围,写作[最小值, 最大值]。默认值为[-2, 2]。
    • y_range 数据类型图标y_range
      JSON 数组
      :尝试放置的垂直范围,写作[最小值, 最大值]。默认值为[0, 3]。
    • on_place 数据类型图标on_place
      JSON 对象
      :成功放置时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
      • target 数据类型图标target
        字符串
        :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。

minecraft:behavior.play​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使生物寻找同伴一起玩耍,村民的幼年个体使用该行为。

  • minecraft:behavior.play 数据类型图标minecraft:behavior.play
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • friend_types 数据类型图标friend_types
      JSON 数组
      :1.19.40+
      该特性在游戏版本1.19.40+下可用。
      可作为玩伴的实体条件列表。
      • object 数据类型图标
        JSON 对象
        :一项条件。
        • filters 数据类型图标filters
          JSON 对象
          :实体需满足的条件。见实体过滤器。
        • max_dist 数据类型图标max_dist
          浮点数
          :该类实体可作为目标的最大距离,单位为方块。默认值为16。
        • max_height 数据类型图标max_height
          浮点数
          :该类实体可作为目标的高度上限,-1表示不限制。默认值为-1。
        • max_flee 数据类型图标max_flee
          浮点数
          :逃离该类实体时距其多远停止,单位为方块。默认值为10。
        • cooldown 数据类型图标cooldown
          整数
          :再次选中该类实体前需要等待的秒数。默认值为0。
        • priority 数据类型图标priority
          整数
          :该实体类型在候选列表中的优先级,数值越小越优先。默认值为0。
        • must_see 数据类型图标must_see
          布尔值
          :为true时该类实体必须可见才会被选中。
        • must_see_forget_duration 数据类型图标must_see_forget_duration
          整数
          :看不见该类实体后多少秒放弃,单位为秒。默认值为3。
        • check_if_outnumbered 数据类型图标check_if_outnumbered
          布尔值
          :为true时检查该类实体的数量是否占优。默认值为false。
        • reevaluate_description 数据类型图标reevaluate_description
          布尔值
          :为true时,对方一旦不再满足条件就停止将其作为目标。默认值为false。
        • walk_speed_multiplier 数据类型图标walk_speed_multiplier
          浮点数
          :接近该类实体时的行走速度乘数。默认值为1。
        • sprint_speed_multiplier 数据类型图标sprint_speed_multiplier
          浮点数
          :接近该类实体时的疾跑速度乘数。默认值为1。
    • chance_to_start 数据类型图标chance_to_start
      浮点数
      :1.19.40+
      该特性在游戏版本1.19.40+下可用。
      每刻开始玩耍的概率。默认值为0.0025。
    • friend_search_area 数据类型图标friend_search_area
      JSON 数组
      :1.19.40+
      该特性在游戏版本1.19.40+下可用。
      搜索玩伴的范围,写作[x, y, z]。默认值为[6, 3, 6]。
    • follow_distance 数据类型图标follow_distance
      整数
      :1.19.40+
      该特性在游戏版本1.19.40+下可用。
      与玩伴保持的距离,单位为方块。默认值为2。
    • max_play_duration_seconds 数据类型图标max_play_duration_seconds
      浮点数
      :1.19.40+
      该特性在游戏版本1.19.40+下可用。
      一次玩耍持续的秒数。默认值为50。
    • random_pos_search_range 数据类型图标random_pos_search_range
      整数
      :1.19.40+
      该特性在游戏版本1.19.40+下可用。
      在地面上搜索随机位置的距离,单位为方块。默认值为16。
    • random_pos_search_height 数据类型图标random_pos_search_height
      整数
      :1.19.40+
      该特性在游戏版本1.19.40+下可用。
      搜索随机位置的高度,单位为方块。默认值为3。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

备注:friend_search_area的类型在文档中标的与示例不符,此处按原版的三元数组书写。


minecraft:behavior.play_dead​

通用
该特性在中国版和国际版均可用。
1.18.30+
该特性在游戏版本1.18.30+下可用。
限定实体类型
该组件仅对美西螈可用。

使实体在受伤后装死,以避免被攻击者继续追击。

  • minecraft:behavior.play_dead 数据类型图标minecraft:behavior.play_dead
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • apply_regeneration 数据类型图标apply_regeneration
      布尔值
      :装死期间是否获得生命恢复效果。默认值为false。
    • damage_sources 数据类型图标damage_sources
      JSON 数组
      :会触发装死的伤害类型。可选值为none、override、contact、entity_attack、projectile、suffocation、fall、fire、fire_tick、lava、drowning、block_explosion、entity_explosion、void、self_destruct、magic、wither、starve、anvil、thorns、falling_block、piston、fly_into_wall、magma、fireworks、lightning、charging、temperature、freezing、stalactite、stalagmite、ram_attack、sonic_boom、campfire、soul_campfire、mace_smash、all。默认值为空数组。
      • string 数据类型图标
        字符串
        :一个伤害类型。
    • duration 数据类型图标duration
      浮点数
      :装死持续的时间,单位为秒。默认值为1。
    • filters 数据类型图标filters
      JSON 对象
      :装死需满足的额外条件。实体需满足的条件。见实体过滤器。
    • force_below_health 数据类型图标force_below_health
      整数
      :生命值低于该值时受伤必定装死。默认值为0。
    • random_damage_range 数据类型图标random_damage_range
      JSON 对象
      :随机附加伤害的区间,用于让装死显得更真实。
      • min 数据类型图标min
        整数
        :区间下限。默认值为0。
      • max 数据类型图标max
        整数
        :区间上限。默认值为0。
    • random_start_chance 数据类型图标random_start_chance
      浮点数
      :受伤时装死的概率。默认值为1。

minecraft:behavior.player_ride_tamed​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
需要前置组件
要使用该组件,请事先定义minecraft:rideable组件。

使玩家可以骑乘已驯服的该实体。

另见:minecraft:rideable组件、EntityRideableComponent 类。

  • minecraft:behavior.player_ride_tamed 数据类型图标minecraft:behavior.player_ride_tamed
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

minecraft:behavior.raid_garden​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使实体前往农田啃食或掠夺指定方块,直到吃饱为止。

  • minecraft:behavior.raid_garden 数据类型图标minecraft:behavior.raid_garden
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • blocks 数据类型图标blocks
      JSON 数组
      :实体前去啃食的方块列表。默认值为空数组。
      • string 数据类型图标
        字符串
        :方块 ID。
    • eat_delay 数据类型图标eat_delay
      整数
      :两次啃食之间的间隔,单位为秒。默认值为2。
    • full_delay 数据类型图标full_delay
      整数
      :吃饱后再次产生进食欲望所需的冷却,单位为秒。默认值为100。
    • goal_radius 数据类型图标goal_radius
      浮点数
      :距目标多近即视为到达,单位为方块。默认值为0.5。
    • initial_eat_delay 数据类型图标initial_eat_delay
      整数
      :1.13.0+
      该特性在游戏版本1.13.0+下可用。
      到达目标后开始啃食前的等待时间,单位为秒。默认值为0。
    • max_to_eat 数据类型图标max_to_eat
      整数
      :一次最多啃食的方块数量,小于等于0表示不设上限。默认值为6。
    • search_height 数据类型图标search_height
      整数
      :搜索作物时的垂直范围,单位为方块。默认值为1。
    • search_range 数据类型图标search_range
      整数
      :搜索作物时的水平范围,单位为方块。默认值为0。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

备注:max_to_eat 设为0表示不限制啃食数量,狐狸即如此配置。


minecraft:behavior.ram_attack​

通用
该特性在中国版和国际版均可用。
1.18.30+
该特性在游戏版本1.18.30+下可用。

使实体通过助跑冲撞的方式攻击目标。

  • minecraft:behavior.ram_attack 数据类型图标minecraft:behavior.ram_attack
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • baby_knockback_modifier 数据类型图标baby_knockback_modifier
      浮点数
      :幼年个体击退强度的修正系数。默认值为0.3333333。
    • cooldown_range 数据类型图标cooldown_range
      JSON 对象
      :两次冲撞之间的冷却区间,单位为秒。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为0。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为0。
    • knockback_force 数据类型图标knockback_force
      浮点数
      :冲撞造成的击退力度。默认值为5。
    • knockback_height 数据类型图标knockback_height
      浮点数
      :冲撞造成的击退垂直分量。默认值为0.1。
    • min_ram_distance 数据类型图标min_ram_distance
      整数
      :可以发起冲撞的最小距离,单位为方块。默认值为4。
    • on_start 数据类型图标on_start
      JSON 数组
      :发起冲撞时触发的事件列表。默认值为空数组。
      • object 数据类型图标
        JSON 对象
        :一个事件。
        • event 数据类型图标event
          字符串
          :事件 ID。
        • filters 数据类型图标filters
          JSON 对象
          :实体需满足的条件。见实体过滤器。
        • target 数据类型图标target
          字符串
          :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
    • pre_ram_sound 数据类型图标pre_ram_sound
      字符串
      :冲锋前播放的声音定义 ID。
    • ram_distance 数据类型图标ram_distance
      整数
      :进入冲锋状态的距目标距离,单位为方块。默认值为7。
    • ram_impact_sound 数据类型图标ram_impact_sound
      字符串
      :冲撞命中时播放的音效事件名。
    • ram_speed 数据类型图标ram_speed
      浮点数
      :冲锋阶段的移动速度。默认值为2。
    • run_speed 数据类型图标run_speed
      浮点数
      :助跑阶段的移动速度。默认值为1。

备注:原版山羊把pre_ram_sound与ram_impact_sound分别写成pre_ram与ram_impact,对应sound_definitions.json中的声音定义。


minecraft:behavior.random_breach​

通用
该特性在中国版和国际版均可用。
1.4.0+
该特性在游戏版本1.4.0+下可用。

使水生生物随机浮出水面换气。

  • minecraft:behavior.random_breach 数据类型图标minecraft:behavior.random_breach
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • cooldown_time 数据类型图标cooldown_time
      浮点数
      :两次浮出水面之间的等待时间,单位为秒。默认值为0。
    • interval 数据类型图标interval
      整数
      :每刻以1/interval的概率触发该行为。默认值为120。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。
    • xz_dist 数据类型图标xz_dist
      整数
      :水平方向上搜索目标位置的距离,单位为方块,至少为1。默认值为10。
    • y_dist 数据类型图标y_dist
      整数
      :垂直方向上搜索目标位置的距离,单位为方块,至少为1。默认值为7。

minecraft:behavior.random_fly​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使实体随机飞行。

  • minecraft:behavior.random_fly 数据类型图标minecraft:behavior.random_fly
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • can_land_on_trees 数据类型图标can_land_on_trees
      布尔值
      :为true时允许降落在树上而非地面。默认值为true。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :1.21.0+
      该特性在游戏版本1.21.0+下可用。
      执行该行为时的移动速度乘数。默认值为1。
    • xz_dist 数据类型图标xz_dist
      整数
      :水平方向上搜索目标位置的距离,单位为方块,至少为1。默认值为10。
    • y_dist 数据类型图标y_dist
      整数
      :垂直方向上搜索目标位置的距离,单位为方块,至少为1。默认值为7。

备注:原版鹦鹉还写了avoid_damage_blocks与y_offset两个参数,均未被 schema 收录,行为未见于官方文档。


minecraft:behavior.random_hover​

通用
该特性在中国版和国际版均可用。
1.14.0+
该特性在游戏版本1.14.0+下可用。

使实体在贴近地面的高度上随机悬浮移动。

  • minecraft:behavior.random_hover 数据类型图标minecraft:behavior.random_hover
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • hover_height 数据类型图标hover_height
      JSON 对象
      :1.18.10+
      该特性在游戏版本1.18.10+下可用。
      悬浮高度区间,单位为方块。
      • min 数据类型图标min
        整数
        :区间下限。默认值为0。
      • max 数据类型图标max
        整数
        :区间上限。默认值为0。
    • interval 数据类型图标interval
      整数
      :每刻以1/interval的概率触发该行为。默认值为120。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。
    • xz_dist 数据类型图标xz_dist
      整数
      :水平方向上搜索目标位置的距离,单位为方块,至少为1。默认值为10。
    • y_dist 数据类型图标y_dist
      整数
      :垂直方向上搜索目标位置的距离,单位为方块,至少为1。默认值为7。
    • y_offset 数据类型图标y_offset
      浮点数
      :在选定的目标位置基础上额外偏移的高度,单位为方块。默认值为0。

备注:hover_height在 schema 里是含min/max的对象,原版写成[1, 4]这样的二元数组,两种写法都能解析。


minecraft:behavior.random_look_around​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使实体随机环顾四周。

  • minecraft:behavior.random_look_around 数据类型图标minecraft:behavior.random_look_around
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • look_time 数据类型图标look_time
      JSON 对象
      :每次注视的持续时间区间,单位为秒。
      • min 数据类型图标min
        整数
        :区间下限。默认值为2。
      • max 数据类型图标max
        整数
        :区间上限。默认值为4。
    • max_angle_of_view_horizontal 数据类型图标max_angle_of_view_horizontal
      浮点数
      :1.19.50+
      该特性在游戏版本1.19.50+下可用。
      相对初始朝向,向右可转的最大角度,单位为度。默认值为180。
    • min_angle_of_view_horizontal 数据类型图标min_angle_of_view_horizontal
      浮点数
      :1.19.50+
      该特性在游戏版本1.19.50+下可用。
      相对初始朝向,向左可转的最大角度,单位为度。默认值为-180。
    • probability 数据类型图标probability
      浮点数
      :触发该行为的概率。默认值为0.02。

minecraft:behavior.random_look_around_and_sit​

通用
该特性在中国版和国际版均可用。
1.13.0+
该特性在游戏版本1.13.0+下可用。

使实体随机坐下并在坐姿下环顾四周。需要有对应的坐下动画才能生效。

  • minecraft:behavior.random_look_around_and_sit 数据类型图标minecraft:behavior.random_look_around_and_sit
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • continue_if_leashed 数据类型图标continue_if_leashed
      布尔值
      :1.19.50+
      该特性在游戏版本1.19.50+下可用。
      为true时被拴住的实体也会持续执行该行为。默认值为false。
    • continue_sitting_on_reload 数据类型图标continue_sitting_on_reload
      布尔值
      :1.20.40+
      该特性在游戏版本1.20.40+下可用。
      为true时区块重新加载后保持坐下状态。默认值为false。
    • max_angle_of_view_horizontal 数据类型图标max_angle_of_view_horizontal
      浮点数
      :1.19.50+
      该特性在游戏版本1.19.50+下可用。
      相对初始朝向,向右可转的最大角度,单位为度。默认值为180。
    • max_look_count 数据类型图标max_look_count
      整数
      :环顾时注视方向数量的上限。默认值为2。
    • max_look_time 数据类型图标max_look_time
      整数
      :每个方向注视时间的上限,单位为刻。默认值为40。
    • min_angle_of_view_horizontal 数据类型图标min_angle_of_view_horizontal
      浮点数
      :1.19.50+
      该特性在游戏版本1.19.50+下可用。
      相对初始朝向,向左可转的最大角度,单位为度。默认值为-180。
    • min_look_count 数据类型图标min_look_count
      整数
      :环顾时注视方向数量的下限。默认值为1。
    • min_look_time 数据类型图标min_look_time
      整数
      :每个方向注视时间的下限,单位为刻。默认值为20。
    • probability 数据类型图标probability
      浮点数
      :触发该行为的概率。默认值为0.02。
    • random_look_around_cooldown 数据类型图标random_look_around_cooldown
      整数
      :1.19.50+
      该特性在游戏版本1.19.50+下可用。
      再次触发前的冷却时间,单位为秒。默认值为0。

minecraft:behavior.random_search_and_dig​

通用
该特性在中国版和国际版均可用。
1.19.70+
该特性在游戏版本1.19.70+下可用。
限定实体类型
该组件仅对嗅探兽可用。

使实体在附近寻找符合条件的方块,前往挖掘并按战利品表产出物品。

  • minecraft:behavior.random_search_and_dig 数据类型图标minecraft:behavior.random_search_and_dig
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • cooldown_range 数据类型图标cooldown_range
      JSON 对象
      :两次挖掘之间的冷却区间,单位为秒。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为0。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为0。
    • digging_duration_range 数据类型图标digging_duration_range
      JSON 对象
      :单次挖掘的持续时间区间,单位为秒。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为0。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为0。
    • find_valid_position_retries 数据类型图标find_valid_position_retries
      整数
      :在搜索范围内寻找有效目标位置的尝试次数。默认值为5。
    • goal_radius 数据类型图标goal_radius
      浮点数
      :距目标多近即视为到达,单位为方块。默认值为1.5。
    • item_table 数据类型图标item_table
      字符串
      :1.20.40+
      该特性在游戏版本1.20.40+下可用。
      产出物品所用的战利品表路径,相对于行为包根目录。
    • on_digging_start 数据类型图标on_digging_start
      JSON 对象
      :开始挖掘时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
      • filters 数据类型图标filters
        JSON 对象
        :实体需满足的条件。见实体过滤器。
      • target 数据类型图标target
        字符串
        :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
    • on_fail_during_digging 数据类型图标on_fail_during_digging
      JSON 对象
      :挖掘过程中失败时触发的事件,结构同上。
    • on_fail_during_searching 数据类型图标on_fail_during_searching
      JSON 对象
      :搜索过程中失败时触发的事件,结构同上。
    • on_item_found 数据类型图标on_item_found
      JSON 对象
      :挖到物品时触发的事件,结构同上。
    • on_searching_start 数据类型图标on_searching_start
      JSON 对象
      :开始搜索时触发的事件,结构同上。
    • on_success 数据类型图标on_success
      JSON 对象
      :整个行为成功结束时触发的事件,结构同上。
    • search_range_xz 数据类型图标search_range_xz
      整数
      :搜索范围的边长,单位为方块。默认值为10。
    • search_range_y 数据类型图标search_range_y
      整数
      :搜索范围的高度,单位为方块。默认值为7。
    • spawn_item_after_seconds 数据类型图标spawn_item_after_seconds
      浮点数
      :挖掘开始后经过多少秒产出物品。默认值为0。
    • spawn_item_pos_offset 数据类型图标spawn_item_pos_offset
      浮点数
      :物品生成位置沿实体朝向前移的距离,单位为方块。默认值为0。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :搜索阶段的移动速度乘数。默认值为1。
    • target_blocks 数据类型图标target_blocks
      JSON 数组
      :1.20.40+
      该特性在游戏版本1.20.40+下可用。
      允许挖掘的方块列表,会覆盖默认列表。默认值为空数组。
      • string 数据类型图标
        字符串
        :方块 ID,也可写成含name、states、tags的对象。
    • target_dig_position_offset 数据类型图标target_dig_position_offset
      浮点数
      :1.20.10+
      该特性在游戏版本1.20.10+下可用。
      挖掘判定点沿实体朝向前移的距离,单位为方块。默认值为2.25。

minecraft:behavior.random_sitting​

通用
该特性在中国版和国际版均可用。
1.8.0+
该特性在游戏版本1.8.0+下可用。

使实体随机坐下一段时间。

  • minecraft:behavior.random_sitting 数据类型图标minecraft:behavior.random_sitting
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • cooldown 数据类型图标cooldown
      浮点数
      :两次坐下之间的冷却,单位为秒。默认值为100。
    • min_sit_time 数据类型图标min_sit_time
      浮点数
      :最短坐下的时间,单位为秒。默认值为10。
    • start_chance 数据类型图标start_chance
      浮点数
      :开始该行为的概率,取值 0 到 1。默认值为0.1。
    • stop_chance 数据类型图标stop_chance
      浮点数
      :停止该行为的概率,取值 0 到 1。默认值为0.3。

minecraft:behavior.random_stroll​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使实体随机四处闲逛。

  • minecraft:behavior.random_stroll 数据类型图标minecraft:behavior.random_stroll
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • interval 数据类型图标interval
      整数
      :1.4.0+
      该特性在游戏版本1.4.0+下可用。
      每刻以1/interval的概率触发该行为。默认值为120。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :1.4.0+
      该特性在游戏版本1.4.0+下可用。
      执行该行为时的移动速度乘数。默认值为1。
    • xz_dist 数据类型图标xz_dist
      整数
      :水平方向上搜索目标位置的距离,单位为方块,至少为1。默认值为10。
    • y_dist 数据类型图标y_dist
      整数
      :垂直方向上搜索目标位置的距离,单位为方块,至少为1。默认值为7。

minecraft:behavior.random_swim​

通用
该特性在中国版和国际版均可用。
1.4.0+
该特性在游戏版本1.4.0+下可用。

使实体在水中随机游动。

  • minecraft:behavior.random_swim 数据类型图标minecraft:behavior.random_swim
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • avoid_surface 数据类型图标avoid_surface
      布尔值
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      为true时实体从水面下方游过,不会浮到水面。默认值为true。
    • interval 数据类型图标interval
      整数
      :每刻以1/interval的概率触发该行为。默认值为120。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。
    • xz_dist 数据类型图标xz_dist
      整数
      :水平方向上搜索目标位置的距离,单位为方块,至少为1。默认值为10。
    • y_dist 数据类型图标y_dist
      整数
      :垂直方向上搜索目标位置的距离,单位为方块,至少为1。默认值为7。

minecraft:behavior.ranged_attack​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
需要前置组件
要使用该组件,请事先定义minecraft:shooter组件。

使实体通过远程射击攻击目标。启用蓄力连发时,charge_shoot_trigger必须大于0。

另见:minecraft:shooter组件。

  • minecraft:behavior.ranged_attack 数据类型图标minecraft:behavior.ranged_attack
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • attack_interval 数据类型图标attack_interval
      浮点数
      :已弃用:1.15.0-26.40
      该特性已被弃用,只能在游戏版本1.15.0-26.40下使用。
      两次攻击之间的秒数。默认值为0。
    • attack_interval 数据类型图标attack_interval
      JSON 对象
      :26.40+
      该特性在游戏版本26.40+下可用,但该版本对于当前的中国版版本过高。
      两次攻击之间的间隔区间,单位为秒,取代attack_interval_min与attack_interval_max。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为-1。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为-1。
    • attack_interval_min 数据类型图标attack_interval_min
      浮点数
      :已弃用:未知-26.40
      该特性已被弃用,只能在游戏版本未知-26.40下使用。
      两次攻击间隔的下限。默认值为0。
    • attack_interval_max 数据类型图标attack_interval_max
      浮点数
      :已弃用:未知-26.40
      该特性已被弃用,只能在游戏版本未知-26.40下使用。
      两次攻击间隔的上限。默认值为0。
    • attack_radius 数据类型图标attack_radius
      浮点数
      :已弃用:未知-26.50
      该特性已被弃用,只能在游戏版本未知-26.50下使用。
      可以发起攻击的最大距离,26.50起由attack_range取代。默认值为0。
    • attack_radius_min 数据类型图标attack_radius_min
      浮点数
      :已弃用:未知-26.50
      该特性已被弃用,只能在游戏版本未知-26.50下使用。
      目标进入攻击范围的最小距离,26.50起由attack_range取代。默认值为0。
    • attack_range 数据类型图标attack_range
      JSON 对象
      :26.50+
      该特性在游戏版本26.50+下可用,但该版本对于当前的中国版版本过高。
      可以发起攻击的距离区间,单位为方块。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为0。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为0。
    • burst_interval 数据类型图标burst_interval
      浮点数
      :蓄力连发时每发之间的间隔,单位为秒。默认值为0。
    • burst_shots 数据类型图标burst_shots
      整数
      :蓄力连发时的每次射击发数。默认值为1。
    • charge_charged_trigger 数据类型图标charge_charged_trigger
      浮点数
      :在charge_shoot_trigger基础上再蓄力多少秒才算蓄满。默认值为0。
    • charge_shoot_trigger 数据类型图标charge_shoot_trigger
      浮点数
      :开始筹备连发前需要蓄力多少秒(随后翻倍)。目标离开视线时蓄力会衰减。默认值为0。
    • in_range_movement_mode 数据类型图标in_range_movement_mode
      字符串
      :26.50+
      该特性在游戏版本26.50+下可用,但该版本对于当前的中国版版本过高。
      进入攻击距离后如何移动。可选值为hold_position(原地不动)、follow_target(跟随目标)。
    • ranged_fov 数据类型图标ranged_fov
      浮点数
      :1.6.0+
      该特性在游戏版本1.6.0+下可用。
      用于发现目标的视野角度,单位为度。默认值为90。
    • set_persistent 数据类型图标set_persistent
      布尔值
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      为true时瞄准玩家后不再被自然清除。默认值为false。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :追击目标时的移动速度乘数。默认值为1。
    • swing 数据类型图标swing
      布尔值
      :1.18.30+
      该特性在游戏版本1.18.30+下可用。
      为true时开火会触发手臂摆动动画(依赖variable.attack_time)。默认值为false。
    • target_in_sight_time 数据类型图标target_in_sight_time
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      发现目标后需要持续看见多少秒才会开始追击。默认值为1。
    • x_max_rotation 数据类型图标x_max_rotation
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      瞄准时每次最多旋转的角度(X 轴),单位为度。默认值为30。
    • y_max_head_rotation 数据类型图标y_max_head_rotation
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      瞄准时头部每次最多旋转的角度(Y 轴),单位为度。默认值为30。

minecraft:behavior.receive_love​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对村民可用。

使村民停下等待其他村民前来繁殖。

  • minecraft:behavior.receive_love 数据类型图标minecraft:behavior.receive_love
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

minecraft:behavior.restrict_open_door​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使实体在夜间留在室内,不去开关门。

  • minecraft:behavior.restrict_open_door 数据类型图标minecraft:behavior.restrict_open_door
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

minecraft:behavior.restrict_sun​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使实体在晴朗的白天自动躲避阳光。

  • minecraft:behavior.restrict_sun 数据类型图标minecraft:behavior.restrict_sun
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

备注:该组件在 schema 中只有priority与control_flags两个字段,行为逻辑依赖实体自身的组件配置。


minecraft:behavior.rise_to_liquid_level​

通用
该特性在中国版和国际版均可用。
1.16.0+
该特性在游戏版本1.16.0+下可用。

使实体在液体中维持在距液面固定深度的位置。

  • minecraft:behavior.rise_to_liquid_level 数据类型图标minecraft:behavior.rise_to_liquid_level
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • liquid_y_offset 数据类型图标liquid_y_offset
      浮点数
      :1.18.10+
      该特性在游戏版本1.18.10+下可用。
      目标位置距液面下沉的距离,单位为方块。正值使目标位置更靠下。默认值为0。
    • rise_delta 数据类型图标rise_delta
      浮点数
      :1.18.10+
      该特性在游戏版本1.18.10+下可用。
      低于目标位置时每刻向上移动的距离。默认值为0。
    • sink_delta 数据类型图标sink_delta
      浮点数
      :1.18.10+
      该特性在游戏版本1.18.10+下可用。
      高于目标位置时每刻向下移动的距离。默认值为0。

minecraft:behavior.roar​

通用
该特性在中国版和国际版均可用。
1.19.0+
该特性在游戏版本1.19.0+下可用。

使实体依据minecraft:anger_level中的数据向其他实体咆哮,怒气值越过阈值后触发。

  • minecraft:behavior.roar 数据类型图标minecraft:behavior.roar
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • duration 数据类型图标duration
      浮点数
      :咆哮的持续时间,单位为秒。默认值为0。

minecraft:behavior.roll​

通用
该特性在中国版和国际版均可用。
1.8.0+
该特性在游戏版本1.8.0+下可用。

使实体向前翻滚。

  • minecraft:behavior.roll 数据类型图标minecraft:behavior.roll
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • probability 数据类型图标probability
      浮点数
      :触发该行为的概率。默认值为0.02。

minecraft:behavior.run_around_like_crazy​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使实体漫无目的地狂奔。

  • minecraft:behavior.run_around_like_crazy 数据类型图标minecraft:behavior.run_around_like_crazy
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

minecraft:behavior.scared​

通用
该特性在中国版和国际版均可用。
1.18.10+
该特性在游戏版本1.18.10+下可用。

使实体在雷雨天气时表现出害怕。

  • minecraft:behavior.scared 数据类型图标minecraft:behavior.scared
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • sound_delay 数据类型图标sound_delay
      整数
      :生效期间以1/sound_delay的概率播放音效的间隔。默认值为0。

minecraft:behavior.send_event​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使实体向另一个实体发送事件。常用于施展法术。

  • minecraft:behavior.send_event 数据类型图标minecraft:behavior.send_event
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • event_choices 数据类型图标event_choices
      JSON 数组
      :可选的事件方案列表,每次激活时随机挑选一个。默认值为空数组。
      • object 数据类型图标
        JSON 对象
        :一种事件方案。
        • cast_duration 数据类型图标cast_duration
          浮点数
          :施法持续时间,单位为秒。默认值为0。
        • cooldown_time 数据类型图标cooldown_time
          浮点数
          :该方案的冷却时间,单位为秒。默认值为0。
        • do_casting 数据类型图标do_casting
          布尔值
          :为true时播放施法动作。默认值为true。
        • filters 数据类型图标filters
          JSON 对象
          :实体需满足的条件。见实体过滤器。
        • look_at_target 数据类型图标look_at_target
          布尔值
          :1.16.100+
          该特性在游戏版本1.16.100+下可用。
          为true时施法期间注视目标。默认值为true。
        • max_activation_range 数据类型图标max_activation_range
          浮点数
          :触发该方案的最大距离,单位为方块。默认值为32。
        • min_activation_range 数据类型图标min_activation_range
          浮点数
          :触发该方案的最小距离,单位为方块。默认值为1。
        • particle_color 数据类型图标particle_color
          字符串
          :施法粒子的颜色,可写十六进制颜色字符串或[R, G, B]数组。
        • sequence 数据类型图标sequence
          JSON 数组
          :施法过程中按顺序执行的动作。默认值为空数组。
          • object 数据类型图标
            JSON 对象
            :一个动作。
            • base_delay 数据类型图标base_delay
              浮点数
              :相对上一个动作的延迟,单位为秒。默认值为0。
            • event 数据类型图标event
              字符串
              :要发送的事件 ID。
            • sound_event 数据类型图标sound_event
              字符串
              :同时播放的音效事件名。
        • start_sound_event 数据类型图标start_sound_event
          字符串
          :开始施法时播放的音效事件名。
        • weight 数据类型图标weight
          浮点数
          :该方案被选中的权重。默认值为0。

minecraft:behavior.share_items​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使实体把身上的物品分给其他实体。

  • minecraft:behavior.share_items 数据类型图标minecraft:behavior.share_items
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • entity_types 数据类型图标entity_types
      JSON 对象
      :可以分享物品的实体条件,可写成数组或单个对象。
      • filters 数据类型图标filters
        JSON 对象
        :实体需满足的条件。见实体过滤器。
      • max_dist 数据类型图标max_dist
        浮点数
        :搜索该类实体的最大距离,单位为方块。默认值为16。
      • max_height 数据类型图标max_height
        浮点数
        :该类实体可作为目标的高度上限,-1表示不限制。默认值为-1。
      • max_flee 数据类型图标max_flee
        浮点数
        :逃离该类实体时距其多远停止,单位为方块。默认值为10。
      • cooldown 数据类型图标cooldown
        整数
        :对这类实体分享物品后的冷却时间,单位为秒。默认值为0。
      • priority 数据类型图标priority
        整数
        :该实体类型在候选列表中的优先级,数值越小越优先。默认值为0。
      • must_see 数据类型图标must_see
        布尔值
        :是否必须看见对方才会前往。
      • must_see_forget_duration 数据类型图标must_see_forget_duration
        整数
        :看不见对方后多少秒放弃,单位为秒。默认值为3。
      • check_if_outnumbered 数据类型图标check_if_outnumbered
        布尔值
        :为true时仅在对方数量占优时分享。默认值为false。
      • reevaluate_description 数据类型图标reevaluate_description
        布尔值
        :为true时,对方一旦不再满足条件就停止将其作为目标。默认值为false。
      • walk_speed_multiplier 数据类型图标walk_speed_multiplier
        浮点数
        :走向该类实体时的行走速度乘数。默认值为1。
      • sprint_speed_multiplier 数据类型图标sprint_speed_multiplier
        浮点数
        :走向该类实体时的疾跑速度乘数。默认值为1。
    • goal_radius 数据类型图标goal_radius
      浮点数
      :距目标多近即视为到达,单位为方块。默认值为0.5。
    • max_dist 数据类型图标max_dist
      整数
      :搜索分享对象的整体最大距离,单位为方块。默认值为1。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

minecraft:behavior.silverfish_merge_with_stone​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对蠹虫可用。

使实体像蠹虫一样钻入石头方块。

  • minecraft:behavior.silverfish_merge_with_stone 数据类型图标minecraft:behavior.silverfish_merge_with_stone
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

minecraft:behavior.silverfish_wake_up_friends​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对蠹虫可用。

使实体惊动附近方块中的同类,让它们钻出来。

  • minecraft:behavior.silverfish_wake_up_friends 数据类型图标minecraft:behavior.silverfish_wake_up_friends
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

minecraft:behavior.skeleton_horse_trap​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对马、骡、驴与骷髅马可用。

使实体像骷髅马陷阱一样,在玩家靠近时召唤闪电与一群骷髅马。

  • minecraft:behavior.skeleton_horse_trap 数据类型图标minecraft:behavior.skeleton_horse_trap
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • duration 数据类型图标duration
      浮点数
      :陷阱的存活时间,单位为秒。超时未被触发则从世界中移除。默认值为1。
    • within_radius 数据类型图标within_radius
      浮点数
      :触发陷阱所需的玩家距离,单位为方块。默认值为0。

minecraft:behavior.sleep​

通用
该特性在中国版和国际版均可用。
1.10.0+
该特性在游戏版本1.10.0+下可用。

使拥有床的实体前往床上睡觉。

  • minecraft:behavior.sleep 数据类型图标minecraft:behavior.sleep
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • can_sleep_while_riding 数据类型图标can_sleep_while_riding
      布尔值
      :1.19.0+
      该特性在游戏版本1.19.0+下可用。
      为true时骑乘其他实体也能执行该行为。默认值为false。
    • cooldown_time 数据类型图标cooldown_time
      浮点数
      :再次使用该行为前的冷却时间,单位为秒。默认值为0。
    • sleep_collider_height 数据类型图标sleep_collider_height
      浮点数
      :睡觉时碰撞箱的高度。默认值为1。
    • sleep_collider_width 数据类型图标sleep_collider_width
      浮点数
      :睡觉时碰撞箱的宽度。默认值为1。
    • sleep_y_offset 数据类型图标sleep_y_offset
      浮点数
      :睡觉时碰撞箱在垂直方向上的偏移。默认值为1。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。
    • timeout_cooldown 数据类型图标timeout_cooldown
      浮点数
      :1.11.0+
      该特性在游戏版本1.11.0+下可用。
      内部超时或失败后重新使用该行为前的冷却,单位为秒。默认值为8。

minecraft:behavior.slime_attack​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使实体在攻击过程中周期性进入疲惫状态。

  • minecraft:behavior.slime_attack 数据类型图标minecraft:behavior.slime_attack
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • grow_tired_cooldown_time 数据类型图标grow_tired_cooldown_time
      浮点数
      :两次进入疲惫状态之间的冷却,单位为秒。默认值为15。
    • set_persistent 数据类型图标set_persistent
      布尔值
      :1.16.0+
      该特性在游戏版本1.16.0+下可用。
      为true时瞄准玩家后不再被自然清除。默认值为false。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :追击目标时的移动速度乘数。默认值为1。
    • x_max_rotation 数据类型图标x_max_rotation
      浮点数
      :瞄准时每次最多旋转的角度(X 轴),单位为度。默认值为10。
    • y_max_rotation 数据类型图标y_max_rotation
      浮点数
      :瞄准时每次最多旋转的角度(Y 轴),单位为度。默认值为10。

minecraft:behavior.slime_float​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对史莱姆与岩浆怪可用。

使史莱姆与岩浆怪在水中或熔岩中浮起。

  • minecraft:behavior.slime_float 数据类型图标minecraft:behavior.slime_float
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • jump_chance_percentage 数据类型图标jump_chance_percentage
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      在液体中跳跃的概率。默认值为0.8。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      在液体中移动时的速度乘数。默认值为1.2。

minecraft:behavior.slime_keep_on_jumping​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使实体像史莱姆一样持续跳跃前进。

  • minecraft:behavior.slime_keep_on_jumping 数据类型图标minecraft:behavior.slime_keep_on_jumping
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      跳跃时的移动速度乘数。默认值为1。

minecraft:behavior.slime_random_direction​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使实体像史莱姆一样随机改变移动方向。

  • minecraft:behavior.slime_random_direction 数据类型图标minecraft:behavior.slime_random_direction
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • add_random_time_range 数据类型图标add_random_time_range
      整数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      在min_change_direction_time基础上随机追加的时间上限,单位为秒。默认值为3。
    • min_change_direction_time 数据类型图标min_change_direction_time
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      两次改变方向之间的最短时间,单位为秒。默认值为2。
    • turn_range 数据类型图标turn_range
      整数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      改变方向时的最大转角,单位为度。默认值为360。

备注:原版未显式写出任何参数,全部使用默认值。


minecraft:behavior.snacking​

通用
该特性在中国版和国际版均可用。
1.8.0+
该特性在游戏版本1.8.0+下可用。

使实体停下来吃附近找到的食物。

  • minecraft:behavior.snacking 数据类型图标minecraft:behavior.snacking
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • items 数据类型图标items
      JSON 数组
      :允许啃食的物品列表。默认值为空数组。
      • string 数据类型图标
        字符串
        :物品 ID,也可写成含name的对象。
    • snacking_cooldown 数据类型图标snacking_cooldown
      浮点数
      :两次进食之间的冷却,单位为秒。默认值为7.5。
    • snacking_cooldown_min 数据类型图标snacking_cooldown_min
      浮点数
      :冷却时间的最小值,单位为秒。默认值为0.5。
    • snacking_stop_chance 数据类型图标snacking_stop_chance
      浮点数
      :停止进食的概率,取值 0 到 1。默认值为0.00167。

minecraft:behavior.sneeze​

通用
该特性在中国版和国际版均可用。
1.8.0+
该特性在游戏版本1.8.0+下可用。

使实体打喷嚏,并掉落物品、惊吓附近的生物。

  • minecraft:behavior.sneeze 数据类型图标minecraft:behavior.sneeze
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • cooldown_time 数据类型图标cooldown_time
      浮点数
      :两次打喷嚏之间的冷却,单位为秒。默认值为0。
    • drop_item_chance 数据类型图标drop_item_chance
      浮点数
      :打喷嚏时掉落物品的概率。默认值为1。
    • entity_types 数据类型图标entity_types
      JSON 对象
      :会被喷嚏惊吓的实体条件,可写成数组或单个对象。
      • filters 数据类型图标filters
        JSON 对象
        :实体需满足的条件。见实体过滤器。
      • max_dist 数据类型图标max_dist
        浮点数
        :该类实体的搜索距离,单位为方块。默认值为16。
      • max_height 数据类型图标max_height
        浮点数
        :该类实体可作为目标的高度上限,-1表示不限制。默认值为-1。
      • max_flee 数据类型图标max_flee
        浮点数
        :逃离该类实体时距其多远停止,单位为方块。默认值为10。
      • cooldown 数据类型图标cooldown
        整数
        :再次选中该类实体前需要等待的秒数。默认值为0。
      • priority 数据类型图标priority
        整数
        :该实体类型在候选列表中的优先级,数值越小越优先。默认值为0。
      • must_see 数据类型图标must_see
        布尔值
        :为true时该类实体必须可见才会被选中。
      • must_see_forget_duration 数据类型图标must_see_forget_duration
        整数
        :看不见该类实体后多少秒放弃,单位为秒。默认值为3。
      • check_if_outnumbered 数据类型图标check_if_outnumbered
        布尔值
        :为true时检查该类实体的数量是否占优。默认值为false。
      • reevaluate_description 数据类型图标reevaluate_description
        布尔值
        :为true时,对方一旦不再满足条件就停止将其作为目标。默认值为false。
      • walk_speed_multiplier 数据类型图标walk_speed_multiplier
        浮点数
        :接近该类实体时的行走速度乘数。默认值为1。
      • sprint_speed_multiplier 数据类型图标sprint_speed_multiplier
        浮点数
        :接近该类实体时的疾跑速度乘数。默认值为1。
    • loot_table 数据类型图标loot_table
      字符串
      :掉落物品所用的战利品表路径,相对于行为包根目录。
    • prepare_sound 数据类型图标prepare_sound
      字符串
      :喷嚏即将发生时的音效事件名。
    • prepare_time 数据类型图标prepare_time
      浮点数
      :打喷嚏前的准备时间,单位为秒。默认值为1。
    • probability 数据类型图标probability
      浮点数
      :打喷嚏的概率。默认值为0.02。
    • sound 数据类型图标sound
      字符串
      :打喷嚏时的音效事件名。
    • within_radius 数据类型图标within_radius
      浮点数
      :会惊吓到生物的距离,单位为方块。默认值为0。

minecraft:behavior.sniff​

通用
该特性在中国版和国际版均可用。
1.19.0+
该特性在游戏版本1.19.0+下可用。

使实体探测sniffing_radius范围内最近的玩家,并更新minecraft:suspect_tracking组件的状态。

  • minecraft:behavior.sniff 数据类型图标minecraft:behavior.sniff
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • cooldown_range 数据类型图标cooldown_range
      JSON 对象
      :两次嗅探之间的冷却区间,单位为秒。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为0。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为0。
    • duration 数据类型图标duration
      浮点数
      :单次嗅探的持续时间,单位为秒。默认值为1。
    • sniffing_radius 数据类型图标sniffing_radius
      浮点数
      :探测半径,单位为方块。默认值为5。
    • suspicion_radius_horizontal 数据类型图标suspicion_radius_horizontal
      浮点数
      :玩家进入该水平半径内时,对其的怒气值上升,单位为方块。默认值为3。
    • suspicion_radius_vertical 数据类型图标suspicion_radius_vertical
      浮点数
      :玩家进入该垂直半径内时,对其的怒气值上升,单位为方块。默认值为3。

minecraft:behavior.sonic_boom​

通用
该特性在中国版和国际版均可用。
1.19.0+
该特性在游戏版本1.19.0+下可用。

使实体发动音波攻击。

  • minecraft:behavior.sonic_boom 数据类型图标minecraft:behavior.sonic_boom
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • attack_cooldown 数据类型图标attack_cooldown
      浮点数
      :两次音波攻击之间的冷却,单位为秒。默认值为5。
    • attack_damage 数据类型图标attack_damage
      浮点数
      :音波造成的伤害。默认值为30。
    • attack_range_horizontal 数据类型图标attack_range_horizontal
      浮点数
      :可以对目标造成伤害的水平距离,单位为方块。默认值为15。
    • attack_range_vertical 数据类型图标attack_range_vertical
      浮点数
      :可以对目标造成伤害的垂直距离,单位为方块。默认值为20。
    • attack_sound 数据类型图标attack_sound
      字符串
      :发动攻击的音效事件名。
    • charge_sound 数据类型图标charge_sound
      字符串
      :蓄力时的音效事件名。
    • duration 数据类型图标duration
      浮点数
      :该行为的持续时间,单位为秒。默认值为0。
    • duration_until_attack_sound 数据类型图标duration_until_attack_sound
      浮点数
      :从开始到播放攻击音效的时长,单位为秒。默认值为1.7。
    • knockback_height_cap 数据类型图标knockback_height_cap
      浮点数
      :击退垂直分量的上限。默认值为0。
    • knockback_horizontal_strength 数据类型图标knockback_horizontal_strength
      浮点数
      :击退的水平力度。默认值为0。
    • knockback_vertical_strength 数据类型图标knockback_vertical_strength
      浮点数
      :击退的垂直力度。默认值为0。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :追击目标时的移动速度乘数。默认值为1。

minecraft:behavior.squid_dive​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对鱿鱼可用。

允许鱿鱼在水中下潜。

  • minecraft:behavior.squid_dive 数据类型图标minecraft:behavior.squid_dive
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

minecraft:behavior.squid_flee​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对鱿鱼可用。

使鱿鱼向外游走逃离。

  • minecraft:behavior.squid_flee 数据类型图标minecraft:behavior.squid_flee
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

minecraft:behavior.squid_idle​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对鱿鱼可用。

使鱿鱼在原地附近游动徘徊。

  • minecraft:behavior.squid_idle 数据类型图标minecraft:behavior.squid_idle
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

minecraft:behavior.squid_move_away_from_ground​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对鱿鱼可用。

允许鱿鱼离开地面方块并回到水中。

  • minecraft:behavior.squid_move_away_from_ground 数据类型图标minecraft:behavior.squid_move_away_from_ground
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

minecraft:behavior.squid_out_of_water​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对鱿鱼可用。

使鱿鱼离开水面后紧贴地面不动。

  • minecraft:behavior.squid_out_of_water 数据类型图标minecraft:behavior.squid_out_of_water
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

minecraft:behavior.stalk_and_pounce_on_target​

通用
该特性在中国版和国际版均可用。
1.13.0+
该特性在游戏版本1.13.0+下可用。

使实体悄悄接近目标,进入范围后扑向目标,落地时若仍足够接近则造成伤害。

  • minecraft:behavior.stalk_and_pounce_on_target 数据类型图标minecraft:behavior.stalk_and_pounce_on_target
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • interest_time 数据类型图标interest_time
      浮点数
      :进入扑击范围后蓄势的时间,单位为秒。默认值为2。
    • leap_dist 数据类型图标leap_dist
      浮点数
      :扑击时朝目标方向跃出的距离,单位为方块。默认值为0.8。
    • leap_height 数据类型图标leap_height
      浮点数
      :扑击时跃起的高度,单位为方块。默认值为0.9。
    • max_stalk_dist 数据类型图标max_stalk_dist
      浮点数
      :放弃追踪的最大距离,单位为方块。默认值为10。
    • pounce_max_dist 数据类型图标pounce_max_dist
      浮点数
      :可以开始扑击的最大距离,单位为方块。默认值为5。
    • set_persistent 数据类型图标set_persistent
      布尔值
      :1.16.0+
      该特性在游戏版本1.16.0+下可用。
      为true时瞄准玩家后不再被自然清除。默认值为false。
    • stalk_speed 数据类型图标stalk_speed
      浮点数
      :接近目标时的移动速度。默认值为1.2。
    • strike_dist 数据类型图标strike_dist
      浮点数
      :落地后仍能造成伤害的最大距离,单位为方块。默认值为2。
    • stuck_blocks 数据类型图标stuck_blocks
      JSON 对象
      :扑击失败时会陷进去的方块条件。见实体过滤器。
    • stuck_time 数据类型图标stuck_time
      浮点数
      :陷进方块后的停留时间,单位为秒。默认值为2。

minecraft:behavior.stay_near_noteblock​

通用
该特性在中国版和国际版均可用。
1.19.0+
该特性在游戏版本1.19.0+下可用。

使实体在听到最近敲响的 note block 后靠近它,并尝试把手上的物品丢过去。

  • minecraft:behavior.stay_near_noteblock 数据类型图标minecraft:behavior.stay_near_noteblock
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • listen_time 数据类型图标listen_time
      整数
      :听到 note block 后保持在附近的时间,单位为秒。默认值为30。
    • speed 数据类型图标speed
      浮点数
      :走向方块时的移动速度。默认值为1。
    • start_distance 数据类型图标start_distance
      浮点数
      :距方块多远时开始执行该行为,单位为方块。默认值为10。
    • stop_distance 数据类型图标stop_distance
      浮点数
      :尝试到达的距方块距离,单位为方块。默认值为2。

minecraft:behavior.stay_while_sitting​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使实体处于坐下状态时待在原地,不执行其他行为。

  • minecraft:behavior.stay_while_sitting 数据类型图标minecraft:behavior.stay_while_sitting
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

minecraft:behavior.stomp_attack​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使实体通过踩踏造成范围伤害。

  • minecraft:behavior.stomp_attack 数据类型图标minecraft:behavior.stomp_attack
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • attack_once 数据类型图标attack_once
      布尔值
      :1.6.0+
      该特性在游戏版本1.6.0+下可用。
      为true时该行为在实体整个生命周期内只触发一次。默认值为false。
    • attack_types 数据类型图标attack_types
      字符串
      :该实体会攻击的实体类型。
    • can_spread_on_fire 数据类型图标can_spread_on_fire
      布尔值
      :1.20.30+
      该特性在游戏版本1.20.30+下可用。
      为true时着火的空手实体命中后会点燃目标。默认值为false。
    • cooldown_time 数据类型图标cooldown_time
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      两次攻击之间的冷却,单位为秒。默认值为1。
    • inner_boundary_time_increase 数据类型图标inner_boundary_time_increase
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      目标超出path_inner_boundary时,寻路重算间隔的增量,单位为秒。默认值为0.25。
    • max_path_time 数据类型图标max_path_time
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      寻路重算间隔的基础上限,单位为秒。默认值为0.55。
    • min_path_time 数据类型图标min_path_time
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      寻路重算间隔的基础下限,单位为秒。默认值为0.2。
    • no_damage_range_multiplier 数据类型图标no_damage_range_multiplier
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      与实体基础体积相乘得到「无伤害范围」,目标处于该范围内时该行为进入冷却。默认值为2。
    • on_attack 数据类型图标on_attack
      JSON 对象
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      攻击命中时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
        • filters 数据类型图标filters
          JSON 对象
          :实体需满足的条件。见实体过滤器。
        • target 数据类型图标target
          字符串
          :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
    • on_kill 数据类型图标on_kill
      JSON 对象
      :1.21.80+
      该特性在游戏版本1.21.80+下可用。
      击杀目标时触发的事件,结构同上。
    • outer_boundary_time_increase 数据类型图标outer_boundary_time_increase
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      目标超出path_outer_boundary时,寻路重算间隔的增量,单位为秒。默认值为0.5。
    • path_fail_time_increase 数据类型图标path_fail_time_increase
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      无法沿当前路径移动时,寻路重算间隔的增量,单位为秒。默认值为0.75。
    • path_inner_boundary 数据类型图标path_inner_boundary
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      超过该距离时按inner_boundary_time_increase增加间隔,单位为方块。默认值为16。
    • path_outer_boundary 数据类型图标path_outer_boundary
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      超过该距离时按outer_boundary_time_increase增加间隔,单位为方块。默认值为32。
    • random_stop_interval 数据类型图标random_stop_interval
      整数
      :以1/N的概率中断当前攻击,N取该值。默认值为0。
    • reach_multiplier 数据类型图标reach_multiplier
      浮点数
      :与实体基础体积相乘得到造成伤害前的最小目标距离。默认值为2。
    • require_complete_path 数据类型图标require_complete_path
      布尔值
      :1.9.0+
      该特性在游戏版本1.9.0+下可用。
      为true时必须存在从实体到目标的完整寻路路径。默认值为false。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :追击目标时的移动速度乘数。默认值为1。
    • stomp_range_multiplier 数据类型图标stomp_range_multiplier
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      与实体基础体积相乘得到踩踏的范围伤害半径。默认值为2。
    • track_target 数据类型图标track_target
      布尔值
      :为true时即使没有硬编码的感知组件也会追踪目标。默认值为false。
    • x_max_rotation 数据类型图标x_max_rotation
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      瞄准时每次最多旋转的角度(X 轴),单位为度。默认值为30。
    • y_max_head_rotation 数据类型图标y_max_head_rotation
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      瞄准时头部每次最多旋转的角度(Y 轴),单位为度。默认值为30。

minecraft:behavior.stomp_turtle_egg​

通用
该特性在中国版和国际版均可用。
1.5.0+
该特性在游戏版本1.5.0+下可用。

使实体前往踩踏海龟蛋。

  • minecraft:behavior.stomp_turtle_egg 数据类型图标minecraft:behavior.stomp_turtle_egg
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • goal_radius 数据类型图标goal_radius
      浮点数
      :距目标多近即视为到达,单位为方块。默认值为0.5。
    • interval 数据类型图标interval
      整数
      :每刻以1/interval的概率触发该行为。默认值为120。
    • search_count 数据类型图标search_count
      整数
      :每刻在搜索范围内随机抽查的方块数量,0表示全部检查。默认值为10。
    • search_height 数据类型图标search_height
      整数
      :搜索海龟蛋时的垂直范围,单位为方块。默认值为1。
    • search_range 数据类型图标search_range
      整数
      :搜索海龟蛋时的水平范围,单位为方块。默认值为0。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。

minecraft:behavior.stroll_towards_village​

通用
该特性在中国版和国际版均可用。
1.13.3+
该特性在游戏版本1.13.3+下可用。

使实体在搜索范围内前往村庄中的随机位置。

  • minecraft:behavior.stroll_towards_village 数据类型图标minecraft:behavior.stroll_towards_village
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • cooldown_time 数据类型图标cooldown_time
      浮点数
      :再次使用该行为前的冷却时间,单位为秒。默认值为8。
    • goal_radius 数据类型图标goal_radius
      浮点数
      :距目标多近即视为到达,单位为方块。默认值为1.5。
    • search_range 数据类型图标search_range
      整数
      :搜索村庄的距离,小于等于0表示不限距离、直接取最近的村庄。默认值为0。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为1。
    • start_chance 数据类型图标start_chance
      浮点数
      :开始该行为的概率,取值 0 到 1。默认值为1。

minecraft:behavior.summon_entity​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使实体通过召唤其他实体来攻击目标。

  • minecraft:behavior.summon_entity 数据类型图标minecraft:behavior.summon_entity
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • summon_choices 数据类型图标summon_choices
      JSON 数组
      :可用的召唤方案列表,每次激活时按权重随机挑选。默认值为空数组。
      • object 数据类型图标
        JSON 对象
        :一种召唤方案。
        • cast_duration 数据类型图标cast_duration
          浮点数
          :施法持续时间,单位为秒,-1表示不施法。默认值为-1。
        • cooldown_time 数据类型图标cooldown_time
          浮点数
          :该方案的冷却时间,单位为秒。默认值为0。
        • do_casting 数据类型图标do_casting
          布尔值
          :为true时播放施法动作。默认值为true。
        • filters 数据类型图标filters
          JSON 对象
          :实体需满足的条件。见实体过滤器。
        • max_activation_range 数据类型图标max_activation_range
          浮点数
          :触发该方案的最大距离,单位为方块。默认值为32。
        • min_activation_range 数据类型图标min_activation_range
          浮点数
          :触发该方案的最小距离,单位为方块。默认值为1。
        • particle_color 数据类型图标particle_color
          字符串
          :施法粒子的颜色,可写十六进制颜色字符串或[R, G, B]数组。
        • sequence 数据类型图标sequence
          JSON 数组
          :召唤过程中按顺序执行的步骤。默认值为空数组。
          • object 数据类型图标
            JSON 对象
            :一个召唤步骤。
            • base_delay 数据类型图标base_delay
              浮点数
              :相对上一个步骤的延迟,单位为秒。默认值为0。
            • delay_per_summon 数据类型图标delay_per_summon
              浮点数
              :每个被召唤实体之间的延迟,单位为秒。默认值为0。
            • entity_lifespan 数据类型图标entity_lifespan
              浮点数
              :被召唤实体的存活时间,单位为秒,-1表示永久。默认值为-1。
            • entity_type 数据类型图标entity_type
              字符串
              :被召唤实体的标识符。
            • num_entities_spawned 数据类型图标num_entities_spawned
              整数
              :召唤数量。默认值为1。
            • shape 数据类型图标shape
              字符串
              :召唤排列方式,可选值为circle、line。
            • size 数据类型图标size
              浮点数
              :召唤排列的尺寸,含义随shape变化。默认值为1。
            • sound_event 数据类型图标sound_event
              字符串
              :召唤时播放的音效事件名。
            • summon_cap 数据类型图标summon_cap
              整数
              :场上同时存在的被召唤实体数量上限。默认值为0。
            • summon_cap_radius 数据类型图标summon_cap_radius
              浮点数
              :统计召唤数量上限时的半径,单位为方块。默认值为0。
            • summon_event 数据类型图标summon_event
              字符串
              :被召唤实体生成时触发的实体事件 ID。
            • target 数据类型图标target
              字符串
              :召唤位置的参照主体,可选值为self、target。
        • start_sound_event 数据类型图标start_sound_event
          字符串
          :开始施法时播放的音效事件名。
        • weight 数据类型图标weight
          浮点数
          :该方案被选中的权重。默认值为0。

minecraft:behavior.swell​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对苦力怕可用。

使苦力怕在玩家靠近时膨胀。

  • minecraft:behavior.swell 数据类型图标minecraft:behavior.swell
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • start_distance 数据类型图标start_distance
      浮点数
      :目标进入该距离时开始膨胀,单位为方块。默认值为10。
    • stop_distance 数据类型图标stop_distance
      浮点数
      :目标离开该距离时停止膨胀,单位为方块。默认值为2。

备注:schema 的默认值(start_distance为10、stop_distance为2)与原版苦力怕的实际配置相反:原版把开始膨胀的距离(2.5)设得比停止膨胀的距离(6)更近。建议按原版数值填写。


minecraft:behavior.swim_idle​

通用
该特性在中国版和国际版均可用。
1.15.0+
该特性在游戏版本1.15.0+下可用。

使处于水中的实体原地停留一段时间。

  • minecraft:behavior.swim_idle 数据类型图标minecraft:behavior.swim_idle
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • idle_time 数据类型图标idle_time
      浮点数
      :保持停留的时间,单位为秒。默认值为5。
    • success_rate 数据类型图标success_rate
      浮点数
      :进入停留状态的概率,1.0表示 100%。默认值为0.1。

minecraft:behavior.swim_up_for_breath​

通用
该特性在中国版和国际版均可用。
1.21.20+
该特性在游戏版本1.21.20+下可用。
需要前置组件
要使用该组件,请事先定义minecraft:breathable组件。

使实体在氧气即将耗尽时游向空气。

另见:minecraft:breathable组件、EntityBreathableComponent 类。

  • minecraft:behavior.swim_up_for_breath 数据类型图标minecraft:behavior.swim_up_for_breath
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • material_type 数据类型图标material_type
      字符串
      :实体所处液体的材质。只有下方是该材质的空气方块才会被视作有效目标。可选值为water、lava,默认值为water。
    • search_height 数据类型图标search_height
      整数
      :向上搜索空气方块的高度,单位为方块。默认值为16。
    • search_radius 数据类型图标search_radius
      整数
      :以实体为中心的水平搜索半径,单位为方块。默认值为4。
    • speed_mod 数据类型图标speed_mod
      浮点数
      :执行该行为时的移动速度乘数。默认值为1.4。

minecraft:behavior.swim_wander​

通用
该特性在中国版和国际版均可用。
1.4.0+
该特性在游戏版本1.4.0+下可用。

使实体在游泳且未寻路时随意游动。

  • minecraft:behavior.swim_wander 数据类型图标minecraft:behavior.swim_wander
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • interval 数据类型图标interval
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      未寻路时开始游动的概率。默认值为0.00833。
    • look_ahead 数据类型图标look_ahead
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      游动时向前探测障碍的距离。默认值为5。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :游动时的移动速度乘数。默认值为1。
    • wander_time 数据类型图标wander_time
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      一次游动持续的时间,单位为秒。默认值为5。

minecraft:behavior.swim_with_entity​

通用
该特性在中国版和国际版均可用。
1.15.0+
该特性在游戏版本1.15.0+下可用。

使实体在水中跟随另一类实体一起游动。

  • minecraft:behavior.swim_with_entity 数据类型图标minecraft:behavior.swim_with_entity
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • catch_up_multiplier 数据类型图标catch_up_multiplier
      浮点数
      :与目标方向对齐时的移动速度乘数。默认值为2.5。
    • catch_up_threshold 数据类型图标catch_up_threshold
      浮点数
      :距目标超过该距离时加速追赶,单位为方块。默认值为12。
    • chance_to_stop 数据类型图标chance_to_stop
      浮点数
      :停止跟随当前目标的概率,1.0表示 100%。默认值为0.0333。
    • entity_types 数据类型图标entity_types
      JSON 数组
      :可以跟随的实体条件列表。默认值为空数组。
      • filters 数据类型图标filters
        JSON 对象
        :实体需满足的条件。见实体过滤器。
      • max_dist 数据类型图标max_dist
        浮点数
        :搜索该类实体的最大距离,单位为方块。默认值为16。
      • max_height 数据类型图标max_height
        浮点数
        :该类实体可作为目标的高度上限,-1表示不限制。默认值为-1。
      • max_flee 数据类型图标max_flee
        浮点数
        :逃离该类实体时距其多远停止,单位为方块。默认值为10。
      • cooldown 数据类型图标cooldown
        整数
        :再次选中该类实体前需要等待的秒数。默认值为0。
      • priority 数据类型图标priority
        整数
        :该实体类型在候选列表中的优先级,数值越小越优先。默认值为0。
      • must_see 数据类型图标must_see
        布尔值
        :为true时该类实体必须可见才会被选中。
      • must_see_forget_duration 数据类型图标must_see_forget_duration
        整数
        :看不见该类实体后多少秒放弃,单位为秒。默认值为3。
      • check_if_outnumbered 数据类型图标check_if_outnumbered
        布尔值
        :为true时检查该类实体的数量是否占优。默认值为false。
      • reevaluate_description 数据类型图标reevaluate_description
        布尔值
        :为true时,对方一旦不再满足条件就停止将其作为目标。默认值为false。
      • walk_speed_multiplier 数据类型图标walk_speed_multiplier
        浮点数
        :接近该类实体时的行走速度乘数。默认值为1。
      • sprint_speed_multiplier 数据类型图标sprint_speed_multiplier
        浮点数
        :接近该类实体时的疾跑速度乘数。默认值为1。
    • match_direction_threshold 数据类型图标match_direction_threshold
      浮点数
      :距目标小于该距离时与目标方向对齐,单位为方块。默认值为2。
    • search_range 数据类型图标search_range
      浮点数
      :搜索可跟随实体的半径,单位为方块。默认值为20。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :追赶目标时的移动速度乘数。默认值为1.5。
    • state_check_interval 数据类型图标state_check_interval
      浮点数
      :检查是否需要追赶或对齐方向的间隔,单位为秒。默认值为0.5。
    • stop_distance 数据类型图标stop_distance
      浮点数
      :距目标小于该距离时停止跟随,单位为方块。默认值为5。
    • success_rate 数据类型图标success_rate
      浮点数
      :在尚未跟随时开始跟随的概率,1.0表示 100%。默认值为0.1。

minecraft:behavior.swoop_attack​

通用
该特性在中国版和国际版均可用。
1.6.0+
该特性在游戏版本1.6.0+下可用。

使实体俯冲攻击目标,适合飞行生物。发生水平碰撞或目标远离时行为结束。

  • minecraft:behavior.swoop_attack 数据类型图标minecraft:behavior.swoop_attack
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • damage_reach 数据类型图标damage_reach
      浮点数
      :1.15.0+
      该特性在游戏版本1.15.0+下可用。
      与实体基础体积相加,得到造成伤害时允许的最大目标距离。默认值为0.2。
    • delay_range 数据类型图标delay_range
      JSON 对象
      :两次俯冲之间的延迟区间,单位为秒。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为0。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为0。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :扑向目标时的移动速度乘数。默认值为1。

minecraft:behavior.take_block​

通用
该特性在中国版和国际版均可用。
1.21.100+
该特性在游戏版本1.21.100+下可用。

使实体从世界中取走方块并携带在身上。

  • minecraft:behavior.take_block 数据类型图标minecraft:behavior.take_block
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • affected_by_griefing_rule 数据类型图标affected_by_griefing_rule
      布尔值
      :为true时该行为受「生物破坏」游戏规则影响。默认值为true。
    • blocks 数据类型图标blocks
      JSON 数组
      :允许取走的方块列表,为空表示所有方块都可取走。默认值为空数组。
      • string 数据类型图标
        字符串
        :方块 ID,也可写成含name、states、tags的对象。
    • can_take 数据类型图标can_take
      JSON 对象
      :取走方块前需满足的条件。见实体过滤器。
    • chance 数据类型图标chance
      浮点数
      :每刻尝试取走方块的概率,取值 0 到 1。默认值为1。
    • on_take 数据类型图标on_take
      JSON 对象
      :取走方块时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
        • filters 数据类型图标filters
          JSON 对象
          :实体需满足的条件。见实体过滤器。
        • target 数据类型图标target
          字符串
          :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
    • requires_line_of_sight 数据类型图标requires_line_of_sight
      布尔值
      :为true时需要看见方块才能取走。默认值为true。
    • xz_range 数据类型图标xz_range
      JSON 对象
      :水平方向上搜索方块的范围区间,单位为方块。
      • min 数据类型图标min
        整数
        :区间下限。默认值为0。
      • max 数据类型图标max
        整数
        :区间上限。默认值为0。
    • y_range 数据类型图标y_range
      JSON 对象
      :垂直方向上搜索方块的范围区间,单位为方块。
      • min 数据类型图标min
        整数
        :区间下限。默认值为0。
      • max 数据类型图标max
        整数
        :区间上限。默认值为0。

minecraft:behavior.take_flower​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使实体接受另一实体通过minecraft:behavior.offer_flower递来的花。

  • minecraft:behavior.take_flower 数据类型图标minecraft:behavior.take_flower
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • filters 数据类型图标filters
      JSON 对象
      :1.19.50+
      该特性在游戏版本1.19.50+下可用。
      接受花朵需满足的条件。见实体过滤器。
    • max_head_rotation_y 数据类型图标max_head_rotation_y
      浮点数
      :1.19.50+
      该特性在游戏版本1.19.50+下可用。
      抬头注视目标时的最大 Y 轴旋转角度,单位为度。默认值为30。
    • max_rotation_x 数据类型图标max_rotation_x
      浮点数
      :1.19.50+
      该特性在游戏版本1.19.50+下可用。
      注视目标时的最大 X 轴旋转角度,单位为度。默认值为30。
    • max_wait_time 数据类型图标max_wait_time
      浮点数
      :1.19.50+
      该特性在游戏版本1.19.50+下可用。
      接花前随机等待时间的上限,单位为秒。默认值为20。
    • min_distance_to_target 数据类型图标min_distance_to_target
      浮点数
      :1.19.50+
      该特性在游戏版本1.19.50+下可用。
      视为已到达目标的最小距离,单位为方块。默认值为2。
    • min_wait_time 数据类型图标min_wait_time
      浮点数
      :1.19.50+
      该特性在游戏版本1.19.50+下可用。
      接花前随机等待时间的下限,单位为秒。默认值为4。
    • on_take_flower 数据类型图标on_take_flower
      JSON 对象
      :1.21.110+
      该特性在游戏版本1.21.110+下可用。
      接到花时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
        • filters 数据类型图标filters
          JSON 对象
          :实体需满足的条件。见实体过滤器。
        • target 数据类型图标target
          字符串
          :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
    • search_area 数据类型图标search_area
      JSON 数组
      :1.19.50+
      该特性在游戏版本1.19.50+下可用。
      搜索递花对象的范围,写作[x, y, z],也可写成含x、y、z的对象。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :1.19.50+
      该特性在游戏版本1.19.50+下可用。
      执行该行为时的移动速度乘数。默认值为0.5。

minecraft:behavior.target_when_pushed​

通用
该特性在中国版和国际版均可用。
未知
已尝试查找该特性的加入版本,但未能确定。

使实体在被其他实体推动时把对方设为目标。

  • minecraft:behavior.target_when_pushed 数据类型图标minecraft:behavior.target_when_pushed
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • entity_types 数据类型图标entity_types
      JSON 对象
      :目标实体的条件,可写成数组或单个对象。
      • filters 数据类型图标filters
        JSON 对象
        :实体需满足的条件。见实体过滤器。
      • max_dist 数据类型图标max_dist
        浮点数
        :搜索该类实体的最大距离,单位为方块。默认值为16。
      • max_height 数据类型图标max_height
        浮点数
        :目标所在高度的上限,-1表示不限制。默认值为-1。
      • max_flee 数据类型图标max_flee
        浮点数
        :逃离该类实体时距其多远停止,单位为方块。默认值为10。
      • cooldown 数据类型图标cooldown
        整数
        :对该类实体生效后的冷却时间,单位为秒。默认值为0。
      • priority 数据类型图标priority
        整数
        :该实体类型在候选列表中的优先级,数值越小越优先。默认值为0。
      • must_see 数据类型图标must_see
        布尔值
        :是否必须看见对方才会生效。
      • must_see_forget_duration 数据类型图标must_see_forget_duration
        整数
        :看不见对方后多少秒放弃,单位为秒。默认值为3。
      • check_if_outnumbered 数据类型图标check_if_outnumbered
        布尔值
        :为true时仅在对方数量占优时生效。默认值为false。
      • reevaluate_description 数据类型图标reevaluate_description
        布尔值
        :为true时,对方一旦不再满足条件就停止将其作为目标。默认值为false。
      • walk_speed_multiplier 数据类型图标walk_speed_multiplier
        浮点数
        :走向该类实体时的行走速度乘数。默认值为1。
      • sprint_speed_multiplier 数据类型图标sprint_speed_multiplier
        浮点数
        :走向该类实体时的疾跑速度乘数。默认值为1。
    • percent_chance 数据类型图标percent_chance
      浮点数
      :被推动时锁定对方的概率,100表示 100%。默认值为0。

minecraft:behavior.teleport_to_owner​

通用
该特性在中国版和国际版均可用。
1.21.20+
该特性在游戏版本1.21.20+下可用。

使实体传送到其主人身边。

  • minecraft:behavior.teleport_to_owner 数据类型图标minecraft:behavior.teleport_to_owner
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • cooldown 数据类型图标cooldown
      浮点数
      :再次尝试传送前的冷却时间,单位为秒。默认值为1。
    • filters 数据类型图标filters
      JSON 对象
      :允许传送需满足的条件。见实体过滤器。

minecraft:behavior.tempt​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使实体被手持特定物品的玩家吸引并跟随。移动依赖寻路。

  • minecraft:behavior.tempt 数据类型图标minecraft:behavior.tempt
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • can_get_scared 数据类型图标can_get_scared
      布尔值
      :为true时玩家在极近距离内快速移动会让实体停止被吸引。默认值为false。
    • can_tempt_vertically 数据类型图标can_tempt_vertically
      布尔值
      :1.18.10+
      该特性在游戏版本1.18.10+下可用。
      为true时计算与玩家的垂直距离。默认值为false。
    • can_tempt_while_ridden 数据类型图标can_tempt_while_ridden
      布尔值
      :1.18.10+
      该特性在游戏版本1.18.10+下可用。
      为true时被骑乘也能被吸引。默认值为false。
    • items 数据类型图标items
      JSON 数组
      :可以吸引该实体的物品列表。默认值为空数组。
      • string 数据类型图标
        字符串
        :物品 ID,也可写成含name的对象。
    • on_tempt_end 数据类型图标on_tempt_end
      JSON 对象
      :停止被吸引时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
        • filters 数据类型图标filters
          JSON 对象
          :实体需满足的条件。见实体过滤器。
        • target 数据类型图标target
          字符串
          :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
    • on_tempt_start 数据类型图标on_tempt_start
      JSON 对象
      :开始被吸引时触发的事件,结构同上。
    • sound_interval 数据类型图标sound_interval
      JSON 对象
      :1.18.10+
      该特性在游戏版本1.18.10+下可用。
      吸引期间播放音效的间隔区间,单位为刻。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为0。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为0。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :跟随玩家时的移动速度乘数。默认值为1。
    • stop_distance 数据类型图标stop_distance
      浮点数
      :1.21.80+
      该特性在游戏版本1.21.80+下可用。
      距玩家多近时停止跟随,单位为方块。
    • tempt_sound 数据类型图标tempt_sound
      字符串
      :1.18.10+
      该特性在游戏版本1.18.10+下可用。
      吸引期间播放的音效事件名。
    • within_radius 数据类型图标within_radius
      浮点数
      :玩家手持物品时可以吸引该实体的距离,单位为方块。默认值为0。

minecraft:behavior.timer_flag_1​

通用
该特性在中国版和国际版均可用。
1.20.40+
该特性在游戏版本1.20.40+下可用。

启动时触发事件并等待随机时长后结束,结束或被打断时再次触发事件。与timer_flag_2、timer_flag_3结构相同,编号只用于让同一实体挂载多个独立计时器。

  • minecraft:behavior.timer_flag_1 数据类型图标minecraft:behavior.timer_flag_1
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • cooldown_range 数据类型图标cooldown_range
      JSON 对象
      :两次触发之间的冷却区间,单位为秒。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为0。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为0。
    • duration_range 数据类型图标duration_range
      JSON 对象
      :单次持续时间的随机区间,单位为秒。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为0。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为0。
    • on_end 数据类型图标on_end
      JSON 对象
      :行为结束时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
        • filters 数据类型图标filters
          JSON 对象
          :实体需满足的条件。见实体过滤器。
        • target 数据类型图标target
          字符串
          :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
    • on_start 数据类型图标on_start
      JSON 对象
      :行为开始时触发的事件,结构同上。

minecraft:behavior.timer_flag_2​

通用
该特性在中国版和国际版均可用。
1.20.40+
该特性在游戏版本1.20.40+下可用。

结构同timer_flag_1,编号不同,用于在同一实体上挂载第二个独立计时器。

  • minecraft:behavior.timer_flag_2 数据类型图标minecraft:behavior.timer_flag_2
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • cooldown_range 数据类型图标cooldown_range
      JSON 对象
      :两次触发之间的冷却区间,单位为秒。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为0。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为0。
    • duration_range 数据类型图标duration_range
      JSON 对象
      :单次持续时间的随机区间,单位为秒。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为0。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为0。
    • on_end 数据类型图标on_end
      JSON 对象
      :行为结束时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
        • filters 数据类型图标filters
          JSON 对象
          :实体需满足的条件。见实体过滤器。
        • target 数据类型图标target
          字符串
          :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
    • on_start 数据类型图标on_start
      JSON 对象
      :行为开始时触发的事件,结构同上。

minecraft:behavior.timer_flag_3​

通用
该特性在中国版和国际版均可用。
1.20.40+
该特性在游戏版本1.20.40+下可用。

结构同timer_flag_1,编号不同,用于在同一实体上挂载第三个独立计时器。

  • minecraft:behavior.timer_flag_3 数据类型图标minecraft:behavior.timer_flag_3
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • cooldown_range 数据类型图标cooldown_range
      JSON 对象
      :两次触发之间的冷却区间,单位为秒。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为0。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为0。
    • duration_range 数据类型图标duration_range
      JSON 对象
      :单次持续时间的随机区间,单位为秒。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为0。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为0。
    • on_end 数据类型图标on_end
      JSON 对象
      :行为结束时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
        • filters 数据类型图标filters
          JSON 对象
          :实体需满足的条件。见实体过滤器。
        • target 数据类型图标target
          字符串
          :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
    • on_start 数据类型图标on_start
      JSON 对象
      :行为开始时触发的事件,结构同上。

minecraft:behavior.trade_interest​

通用
该特性在中国版和国际版均可用。
1.10.0+
该特性在游戏版本1.10.0+下可用。

使实体注视手持可交易物品的玩家。

  • minecraft:behavior.trade_interest 数据类型图标minecraft:behavior.trade_interest
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • carried_item_switch_time 数据类型图标carried_item_switch_time
      浮点数
      :展示某件交易物品后,尝试换成另一件同价物品的最长等待时间,单位为秒。默认值为2。
    • cooldown 数据类型图标cooldown
      浮点数
      :再次使用该行为前的冷却时间,单位为秒。默认值为2。
    • interest_time 数据类型图标interest_time
      浮点数
      :展示交易物品的总时长上限,单位为秒。默认值为45。
    • remove_item_time 数据类型图标remove_item_time
      浮点数
      :玩家不再持有可交易物品后,收起展示物品的等待时间,单位为秒。默认值为1。
    • within_radius 数据类型图标within_radius
      浮点数
      :玩家手持可交易物品时可以引起注意的距离,单位为方块。默认值为0。

minecraft:behavior.trade_with_player​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

允许玩家与该实体交易。行为开始时实体会停止寻路。

  • minecraft:behavior.trade_with_player 数据类型图标minecraft:behavior.trade_with_player
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • filters 数据类型图标filters
      JSON 对象
      :1.19.60+
      该特性在游戏版本1.19.60+下可用。
      允许交易需满足的条件。见实体过滤器。
    • max_distance_from_player 数据类型图标max_distance_from_player
      浮点数
      :1.19.60+
      该特性在游戏版本1.19.60+下可用。
      距玩家超过该距离时退出交易行为,单位为方块。默认值为8。

minecraft:behavior.transport_items​

通用
该特性在中国版和国际版均可用。
1.21.100+
该特性在游戏版本1.21.100+下可用。

使实体在容器之间搬运物品。铜傀儡用它把铜箱中的物品放进普通箱子。

  • minecraft:behavior.transport_items 数据类型图标minecraft:behavior.transport_items
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • allow_simultaneous_interaction 数据类型图标allow_simultaneous_interaction
      布尔值
      :为true时等待容器不再被其他实体使用后才开始交互。默认值为false。
    • allowed_items 数据类型图标allowed_items
      JSON 数组
      :唯一允许搬运的物品列表。与disallowed_items都为空时搬运所有物品。默认值为空数组。
      • string 数据类型图标
        字符串
        :物品 ID,也可写成含name的对象。
    • destination_container_types 数据类型图标destination_container_types
      JSON 数组
      :可作为目的地的方块容器列表。默认值为空数组。
      • string 数据类型图标
        字符串
        :方块 ID,也可写成含name、states、tags的对象。
    • disallowed_items 数据类型图标disallowed_items
      JSON 数组
      :禁止搬运的物品列表。非空时allowed_items必须为空。默认值为空数组。
      • string 数据类型图标
        字符串
        :物品 ID,也可写成含name的对象。
    • idle_cooldown 数据类型图标idle_cooldown
      整数
      :找不到可用容器时行为停止激活的时间,单位为秒。默认值为20。
    • initial_cooldown 数据类型图标initial_cooldown
      整数
      :实体生成或挂载该组件后延迟开始的时间,单位为秒。默认值为0。
    • interaction_time 数据类型图标interaction_time
      浮点数
      :在容器前交互的时间,单位为秒。默认值为3。
    • max_stack_size 数据类型图标max_stack_size
      整数
      :最多尝试从容器中取出的物品堆叠数,取值 1 到 64。默认值为64。
    • max_visited_containers 数据类型图标max_visited_containers
      整数
      :在进入冷却、重新开始之前最多访问的容器数量。默认值为16。
    • place_strategy 数据类型图标place_strategy
      字符串
      :放置策略。可选值为any(有空位就放)、with_matching(容器中已有同类物品才放)、with_matching_or_empty(两者满足其一即可),默认值为any。
    • search_distance 数据类型图标search_distance
      JSON 数组
      :搜索容器的范围,写作[x, y, z],也可写成含x、y、z的对象。
    • search_strategy 数据类型图标search_strategy
      字符串
      :搜索策略。可选值为nearest(最近的容器)、random(范围内的随机容器),默认值为random。
    • source_container_types 数据类型图标source_container_types
      JSON 数组
      :可作为来源的方块容器列表。默认值为空数组。
      • string 数据类型图标
        字符串
        :方块 ID,也可写成含name、states、tags的对象。

minecraft:behavior.use_kinetic_weapon​

通用
该特性在中国版和国际版均可用。
1.21.130+
该特性在游戏版本1.21.130+下可用。

使实体使用动能武器,间歇性地冲向目标并在攻击后重新拉开距离。

  • minecraft:behavior.use_kinetic_weapon 数据类型图标minecraft:behavior.use_kinetic_weapon
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • approach_distance 数据类型图标approach_distance
      浮点数
      :距目标多近时开始使用动能武器,单位为方块。默认值为8。
    • attack_once 数据类型图标attack_once
      布尔值
      :为true时该行为在实体整个生命周期内只触发一次。默认值为false。
    • attack_types 数据类型图标attack_types
      字符串
      :该实体会攻击的实体类型。
    • can_spread_on_fire 数据类型图标can_spread_on_fire
      布尔值
      :为true时着火的空手实体命中后会点燃目标。默认值为false。
    • cooldown_distance 数据类型图标cooldown_distance
      JSON 对象
      :进入冷却时的距离区间,单位为方块。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为0。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为0。
    • cooldown_speed_multiplier 数据类型图标cooldown_speed_multiplier
      浮点数
      :冷却期间的移动速度乘数。默认值为1。
    • cooldown_time 数据类型图标cooldown_time
      浮点数
      :两次攻击之间的冷却时间,单位为秒。默认值为1。
    • hijack_mount_navigation 数据类型图标hijack_mount_navigation
      布尔值
      :为true时用该行为的逻辑覆盖坐骑的寻路,需要坐骑也运行该行为。默认值为false。
    • inner_boundary_time_increase 数据类型图标inner_boundary_time_increase
      浮点数
      :目标超出path_inner_boundary时,寻路重算间隔的增量,单位为秒。默认值为0.25。
    • max_path_time 数据类型图标max_path_time
      浮点数
      :寻路重算间隔的基础上限,单位为秒。默认值为0.55。
    • melee_fov 数据类型图标melee_fov
      浮点数
      :用于发现目标的视野角度,单位为度。默认值为90。
    • min_path_time 数据类型图标min_path_time
      浮点数
      :寻路重算间隔的基础下限,单位为秒。默认值为0.2。
    • on_attack 数据类型图标on_attack
      JSON 对象
      :攻击命中时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
        • filters 数据类型图标filters
          JSON 对象
          :实体需满足的条件。见实体过滤器。
        • target 数据类型图标target
          字符串
          :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
    • on_kill 数据类型图标on_kill
      JSON 对象
      :击杀目标时触发的事件,结构同上。
    • outer_boundary_time_increase 数据类型图标outer_boundary_time_increase
      浮点数
      :目标超出path_outer_boundary时,寻路重算间隔的增量,单位为秒。默认值为0.5。
    • path_fail_time_increase 数据类型图标path_fail_time_increase
      浮点数
      :无法沿当前路径移动时,寻路重算间隔的增量,单位为秒。默认值为0.75。
    • path_inner_boundary 数据类型图标path_inner_boundary
      浮点数
      :超过该距离时按inner_boundary_time_increase增加间隔,单位为方块。默认值为16。
    • path_outer_boundary 数据类型图标path_outer_boundary
      浮点数
      :超过该距离时按outer_boundary_time_increase增加间隔,单位为方块。默认值为32。
    • random_stop_interval 数据类型图标random_stop_interval
      整数
      :以1/N的概率中断当前攻击,N取该值。默认值为0。
    • reposition_distance 数据类型图标reposition_distance
      JSON 对象
      :攻击后重新拉开距离的目标区间,单位为方块。
      • min 数据类型图标min
        浮点数
        :区间下限。默认值为0。
      • max 数据类型图标max
        浮点数
        :区间上限。默认值为0。
    • reposition_speed_multiplier 数据类型图标reposition_speed_multiplier
      浮点数
      :重新拉开距离时的移动速度乘数。默认值为1。
    • require_complete_path 数据类型图标require_complete_path
      布尔值
      :为true时必须存在从实体到目标的完整寻路路径。默认值为false。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :追击目标时的移动速度乘数。默认值为1。
    • track_target 数据类型图标track_target
      布尔值
      :为true时即使没有硬编码的感知组件也会追踪目标。默认值为false。
    • weapon_min_speed_multiplier 数据类型图标weapon_min_speed_multiplier
      浮点数
      :武器minecraft:kinetic_weapon组件中各项min_speed条件的乘数。默认值为1。
    • weapon_reach_multiplier 数据类型图标weapon_reach_multiplier
      浮点数
      :武器minecraft:kinetic_weapon组件中reach的乘数。默认值为1。
    • x_max_rotation 数据类型图标x_max_rotation
      浮点数
      :瞄准时每次最多旋转的角度(X 轴),单位为度。默认值为30。
    • y_max_head_rotation 数据类型图标y_max_head_rotation
      浮点数
      :瞄准时头部每次最多旋转的角度(Y 轴),单位为度。默认值为30。

minecraft:behavior.vex_copy_owner_target​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使恼鬼把主人当前的攻击目标设为自己的目标。

  • minecraft:behavior.vex_copy_owner_target 数据类型图标minecraft:behavior.vex_copy_owner_target
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

备注:官方文档中该组件的参数只有priority与control_flags;具体是否生效还取决于主人自身是否有攻击目标。


minecraft:behavior.vex_random_move​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使恼鬼随机移动。

  • minecraft:behavior.vex_random_move 数据类型图标minecraft:behavior.vex_random_move
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

备注:官方文档中该组件的参数只有priority与control_flags。


minecraft:behavior.wither_random_attack_pos_goal​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。
限定实体类型
该组件仅对凋灵可用。

使凋灵随机发起攻击。

  • minecraft:behavior.wither_random_attack_pos_goal 数据类型图标minecraft:behavior.wither_random_attack_pos_goal
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。

minecraft:behavior.wither_target_highest_damage​

通用
该特性在中国版和国际版均可用。
1.2.0+
该特性在游戏版本1.2.0+下可用。

使凋灵优先攻击对它造成伤害最多的实体。

  • minecraft:behavior.wither_target_highest_damage 数据类型图标minecraft:behavior.wither_target_highest_damage
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • entity_types 数据类型图标entity_types
      JSON 对象
      :目标实体的条件,可写成数组或单个对象。
      • filters 数据类型图标filters
        JSON 对象
        :实体需满足的条件。见实体过滤器。
      • max_dist 数据类型图标max_dist
        浮点数
        :搜索该类实体的最大距离,单位为方块。默认值为16。
      • max_height 数据类型图标max_height
        浮点数
        :目标所在高度的上限,-1表示不限制。默认值为-1。
      • max_flee 数据类型图标max_flee
        浮点数
        :逃离该类实体时距其多远停止,单位为方块。默认值为10。
      • cooldown 数据类型图标cooldown
        整数
        :对该类实体生效后的冷却时间,单位为秒。默认值为0。
      • priority 数据类型图标priority
        整数
        :该实体类型在候选列表中的优先级,数值越小越优先。默认值为0。
      • must_see 数据类型图标must_see
        布尔值
        :是否必须看见对方才会生效。
      • must_see_forget_duration 数据类型图标must_see_forget_duration
        整数
        :看不见对方后多少秒放弃,单位为秒。默认值为3。
      • check_if_outnumbered 数据类型图标check_if_outnumbered
        布尔值
        :为true时仅在对方数量占优时生效。默认值为false。
      • reevaluate_description 数据类型图标reevaluate_description
        布尔值
        :为true时,对方一旦不再满足条件就停止将其作为目标。默认值为false。
      • walk_speed_multiplier 数据类型图标walk_speed_multiplier
        浮点数
        :走向该类实体时的行走速度乘数。默认值为1。
      • sprint_speed_multiplier 数据类型图标sprint_speed_multiplier
        浮点数
        :走向该类实体时的疾跑速度乘数。默认值为1。

备注:原版未写出entity_types,因此对所有实体生效。


minecraft:behavior.work​

通用
该特性在中国版和国际版均可用。
1.18.10+
该特性在游戏版本1.18.10+下可用。

使 NPC 前往并使用其工作站点方块。

  • minecraft:behavior.work 数据类型图标minecraft:behavior.work
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • active_time 数据类型图标active_time
      整数
      :在工作站点停留的时长,单位为刻。默认值为0。
    • can_work_in_rain 数据类型图标can_work_in_rain
      布尔值
      :为true时工作站点被雨淋到也能工作。默认值为false。
    • goal_cooldown 数据类型图标goal_cooldown
      整数
      :该行为再次可用前的冷却,单位为刻。默认值为0。
    • on_arrival 数据类型图标on_arrival
      JSON 对象
      :抵达工作站点时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
        • filters 数据类型图标filters
          JSON 对象
          :实体需满足的条件。见实体过滤器。
        • target 数据类型图标target
          字符串
          :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
    • sound_delay_max 数据类型图标sound_delay_max
      整数
      :播放音效间隔的上限。默认值为0。
    • sound_delay_min 数据类型图标sound_delay_min
      整数
      :播放音效间隔的下限。默认值为0。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为0.5。
    • work_in_rain_tolerance 数据类型图标work_in_rain_tolerance
      整数
      :can_work_in_rain为false时,降雨不会打断该行为、还能继续工作的剩余刻数。默认值为-1。

备注:同一实体的不同组件组里,该组件也常写作空对象{},此时priority取默认值0,会抢占几乎所有其他行为,一般应显式指定优先级。


minecraft:behavior.work_composter​

通用
该特性在中国版和国际版均可用。
1.18.30+
该特性在游戏版本1.18.30+下可用。

使 NPC 使用堆肥桶,把多余的种子转化为骨粉。

  • minecraft:behavior.work_composter 数据类型图标minecraft:behavior.work_composter
    JSON 对象
    :根对象。
    • priority 数据类型图标priority
      整数
      :行为优先级,数值越小越优先。默认值为0。
    • control_flags 数据类型图标control_flags
      JSON 数组
      :该行为占用的控制通道。可选值为move、look、jump。
      • string 数据类型图标
        字符串
        :一个控制通道。
    • active_time 数据类型图标active_time
      整数
      :在工作站点停留的时长,单位为刻。默认值为0。
    • block_interaction_max 数据类型图标block_interaction_max
      整数
      :与堆肥桶交互的最大次数。默认值为1。
    • can_empty_composter 数据类型图标can_empty_composter
      布尔值
      :为true时可以取出装满的堆肥桶。默认值为true。
    • can_fill_composter 数据类型图标can_fill_composter
      布尔值
      :为true时可以往未满的堆肥桶中添加物品。默认值为true。
    • can_work_in_rain 数据类型图标can_work_in_rain
      布尔值
      :为true时工作站点被雨淋到也能工作。默认值为false。
    • goal_cooldown 数据类型图标goal_cooldown
      整数
      :该行为再次可用前的冷却,单位为刻。默认值为0。
    • items_per_use_max 数据类型图标items_per_use_max
      整数
      :每次交互最多添加的物品数量。默认值为20。
    • min_item_count 数据类型图标min_item_count
      整数
      :每种可堆肥物品最多消耗的数量,超出部分若可堆肥才会被处理。默认值为10。
    • on_arrival 数据类型图标on_arrival
      JSON 对象
      :抵达堆肥桶时触发的事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
        • filters 数据类型图标filters
          JSON 对象
          :实体需满足的条件。见实体过滤器。
        • target 数据类型图标target
          字符串
          :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
    • speed_multiplier 数据类型图标speed_multiplier
      浮点数
      :执行该行为时的移动速度乘数。默认值为0.5。
    • use_block_max 数据类型图标use_block_max
      整数
      :与堆肥桶交互间隔的上限。默认值为200。
    • use_block_min 数据类型图标use_block_min
      整数
      :与堆肥桶交互间隔的下限。默认值为100。
    • work_in_rain_tolerance 数据类型图标work_in_rain_tolerance
      整数
      :can_work_in_rain为false时,降雨不会打断该行为、还能继续工作的剩余刻数。默认值为-1。