AI 意向组件
AI 意向组件(AI Goal Components)规定了实体的 AI,规定 AI 后可以使得实体拥有“想要做什么事情”的能力。
minecraft:behavior.admire_item
通用使生物欣赏被标记为可欣赏的物品。
另见:minecraft:admire_item组件。
- 参数
- 示例
minecraft:behavior.admire_itemJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
admire_item_sound字符串:欣赏物品时播放的音效事件名。sound_intervalJSON 数组:已弃用:1.16.0-26.20该特性已被弃用,只能在游戏版本1.16.0-26.20下使用。两次音效之间随机等待的秒数区间,写作[最小值, 最大值]。默认值为[0, 0]。sound_intervalJSON 对象:26.20+该特性在游戏版本26.20+下可用,但该版本对于当前的中国版版本过高。两次音效之间随机等待的秒数区间。min浮点数:区间下限。默认值为0。max浮点数:区间上限。默认值为0。
on_admire_item_startJSON 对象:开始欣赏物品时触发的事件。event字符串:事件 ID。target字符串:事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
on_admire_item_stopJSON 对象:停止欣赏物品时触发的事件,结构同上。
猪灵(piglin.json
"minecraft:behavior.admire_item": {
"priority": 2,
"admire_item_sound": "admire",
"sound_interval": { "min": 8.0, "max": 8.0 }
}
minecraft:behavior.aquatic_charge_attack
通用使水生生物向目标发起冲刺攻击。
- 参数
- 示例
minecraft:behavior.aquatic_charge_attackJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
attack_reach浮点数:在碰撞箱基础上向外扩张的判定距离,单位为方块。默认值为0.05。charge_speed浮点数:冲刺时的绝对速度。默认值为0.06。max_charge_distance浮点数:发起冲刺的最大距离,单位为方块。默认值为16。charge_overshoot_distance浮点数:冲刺时瞄准目标后方多远的距离。默认值为1.5。charge_cooldown_timeJSON 数组:两次冲刺之间随机等待的秒数区间,写作[最小值, 最大值]。默认值为[2, 6]。knockback_force浮点数:命中时施加给目标的击退力。默认值为2。
鹦鹉螺(nautilus.json
"minecraft:behavior.aquatic_charge_attack": {
"priority": 3,
"max_charge_distance": 16,
"charge_speed": 1.2,
"knockback_force": 2.0,
"charge_cooldown_time": { "min": 4.0, "max": 4.0 }
}
minecraft:behavior.avoid_block
通用使生物避开指定的方块。
- 参数
- 示例
minecraft:behavior.avoid_blockJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
target_blocksJSON 数组:要避开的方块列表。- 字符串:方块 ID。
target_selection_method字符串:方块的搜索方式。可选值为nearest(最近)与random(随机)。默认值为nearest。search_range整数:水平方向搜索的最大距离,单位为方块。默认值为0。search_height整数:垂直方向搜索的最大距离,单位为方块。默认值为0。tick_interval整数:每隔多少刻执行一次该行为。默认值为1。walk_speed_modifier浮点数:行走速度的乘数,1.0表示维持原速。默认值为1。sprint_speed_modifier浮点数:疾跑速度的乘数。默认值为1。avoid_block_sound字符串:避开方块时播放的音效事件名。sound_intervalJSON 数组:两次音效之间随机等待的秒数区间,写作[最小值, 最大值]。默认值为[3, 8]。on_escapeJSON 数组:成功避开时触发的事件列表。- JSON 对象:一个事件。
event字符串:事件 ID。target字符串:事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
疣猪兽(hoglin.json
"minecraft:behavior.avoid_block": {
"priority": 1,
"tick_interval": 5,
"search_range": 8,
"search_height": 4,
"walk_speed_modifier": 1,
"sprint_speed_modifier": 1,
"avoid_block_sound": "retreat",
"sound_interval": { "min": 2.0, "max": 5.0 },
"target_selection_method": "nearest",
"target_blocks": [ "minecraft:warped_fungus", "minecraft:warped_roots" ]
}
minecraft:behavior.avoid_mob_type
通用使生物避开特定类型的实体。
- 参数
- 示例
minecraft:behavior.avoid_mob_typeJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
entity_typesJSON 数组:要避开的实体条件列表。- JSON 对象:一项条件。
filtersJSON 对象:实体需满足的条件。见实体过滤器。max_dist浮点数:触发躲避的最大距离,单位为方块。walk_speed_multiplier浮点数:躲避时行走速度的乘数。sprint_speed_multiplier浮点数:躲避时疾跑速度的乘数。check_if_outnumbered布尔值:是否仅在对方数量占优时躲避。
max_dist浮点数:搜索躲避目标的最大距离,单位为方块。默认值为3。max_flee浮点数:1.4.0+该特性在游戏版本1.4.0+下可用。逃到距目标多远时停止逃跑,单位为方块。默认值为10。sprint_distance浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。距目标多近时开始疾跑,单位为方块。默认值为7。avoid_target_xz整数:1.18.30+该特性在游戏版本1.18.30+下可用。逃跑目标点在水平方向上的选取范围,单位为方块。默认值为16。avoid_target_y整数:1.18.30+该特性在游戏版本1.18.30+下可用。逃跑目标点在垂直方向上的选取范围,单位为方块。默认值为7。ignore_visibility布尔值:1.18.30+该特性在游戏版本1.18.30+下可用。为true时逃跑途中不考虑视线是否被遮挡。默认值为false。remove_target布尔值:1.18.30+该特性在游戏版本1.18.30+下可用。为true时逃跑期间清除当前攻击目标。默认值为false。probability_per_strength浮点数:按对方力量决定停止躲避的概率。默认值为1。walk_speed_multiplier浮点数:行走速度的乘数。默认值为1。sprint_speed_multiplier浮点数:疾跑速度的乘数。默认值为1。river_speed_multiplier浮点数:沿河流逃跑时的速度乘数。默认值为0.75。avoid_mob_sound字符串:1.18.30+该特性在游戏版本1.18.30+下可用。躲避时播放的音效事件名。sound_intervalJSON 数组:1.18.30+该特性在游戏版本1.18.30+下可用。两次音效之间随机等待的秒数区间,写作[最小值, 最大值]。默认值为[3, 8]。on_escape_eventJSON 对象:1.18.30+该特性在游戏版本1.18.30+下可用。成功逃脱时触发的事件,结构同其他行为的event加target。
沼骸(bogged.json
"minecraft:behavior.avoid_mob_type": {
"priority": 4,
"entity_types": [
{
"filters": { "test": "is_family", "subject": "other", "value": "wolf" },
"max_dist": 6,
"walk_speed_multiplier": 1.2,
"sprint_speed_multiplier": 1.2
}
]
}
minecraft:behavior.barter
通用使生物进行以物易物。
另见:minecraft:barter组件。
- 参数
- 示例
minecraft:behavior.barterJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
priority整数:行为优先级,数值越小越优先。默认值为0。
猪灵(piglin.json
"minecraft:behavior.barter": {
"priority": 3
}
minecraft:behavior.beg
通用使生物注视并跟随手持其喜爱食物的玩家。
- 参数
- 示例
minecraft:behavior.begJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
itemsJSON 数组:该生物喜爱的物品列表。- JSON 对象:一项物品描述符。也可直接写物品 ID 字符串。
name字符串:物品 ID。
look_distance浮点数:乞求时可保持的最大距离,单位为方块。默认值为8。look_timeJSON 对象:每次注视玩家持续时间的区间,单位为秒。
26.40+该特性在游戏版本26.40+下可用,但该版本对于当前的中国版版本过高。:只接受带min与max值的对象,更早的格式版本仍可写作[最小值, 最大值]。min整数:区间下限。默认值为2。max整数:区间上限。默认值为4。
狼(wolf.json
"minecraft:behavior.beg": {
"priority": 9,
"look_distance": 8,
"look_time": { "min": 20, "max": 40 },
"items": [
{ "name": "minecraft:bone" },
{ "name": "minecraft:porkchop" }
]
}
minecraft:behavior.break_door
通用使生物破坏阻挡其寻路的门,需配合minecraft:annotation.break_door组件。
- 参数
- 示例
minecraft:behavior.break_doorJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
priority整数:行为优先级,数值越小越优先。默认值为0。
原版暂无单独声明该行为的实体,以下为最小写法:
"minecraft:behavior.break_door": {
"priority": 3
}
minecraft:behavior.breed
通用使生物寻找同类进行繁殖。
另见:minecraft:breedable组件。
- 参数
- 示例
minecraft:behavior.breedJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
犰狳(armadillo.json
"minecraft:behavior.breed": {
"priority": 2,
"speed_multiplier": 1.0
}
minecraft:behavior.celebrate
通用使生物在触发后进行庆祝,例如袭击者攻下村庄后的欢呼。
- 参数
- 示例
minecraft:behavior.celebrateJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
celebration_sound字符串:庆祝时播放的音效事件名。默认值为celebrate。duration浮点数:庆祝持续的秒数。默认值为30。jump_intervalJSON 数组:两次跳跃之间随机等待的秒数区间。默认值为[1, 3.5]。sound_intervalJSON 数组:两次音效之间随机等待的秒数区间。默认值为[2, 7]。on_celebration_end_eventJSON 对象:庆祝结束时触发的事件。event字符串:事件 ID。target字符串:事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
备注:区间参数在 schema 中写作
min与max,原版多数写作range_min与range_max,两种写法均可解析。
唤魔者(evocation_illager.json
"minecraft:behavior.celebrate": {
"priority": 5,
"celebration_sound": "celebrate",
"duration": 30,
"jump_interval": { "range_min": 1, "range_max": 3.5 },
"sound_interval": { "range_min": 2, "range_max": 7 },
"on_celebration_end_event": {
"event": "minecraft:stop_celebrating",
"target": "self"
}
}
minecraft:behavior.celebrate_survive
通用使生物在袭击中存活后进行庆祝,并周期性放出烟花。
- 参数
- 示例
minecraft:behavior.celebrate_surviveJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
duration浮点数:庆祝持续的秒数。默认值为30。fireworks_intervalJSON 数组:两次烟花之间随机等待的秒数区间。默认值为[10, 20]。on_celebration_end_eventJSON 对象:庆祝结束时触发的事件。event字符串:事件 ID。target字符串:事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
村民(villager.json
"minecraft:behavior.celebrate_survive": {
"priority": 5,
"duration": 30,
"fireworks_interval": { "range_min": 2, "range_max": 7 },
"on_celebration_end_event": {
"event": "minecraft:stop_celebrating",
"target": "self"
}
}
minecraft:behavior.charge_attack
通用使生物向目标发起冲锋,例如恼鬼的突进。
- 参数
- 示例
minecraft:behavior.charge_attackJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
min_distance浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。距目标小于该距离时不发起冲锋,单位为方块。默认值为2。max_distance浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。距目标大于该距离时不发起冲锋,单位为方块。默认值为3。speed_multiplier浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。冲向目标时的速度乘数。默认值为1。success_rate浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。未处于攻击状态时发起冲锋的概率。默认值为0.1428。sound_event字符串:冲锋时播放的音效事件名。默认值为charge。
恼鬼(vex.json
"minecraft:behavior.charge_attack": {
"priority": 4
}
minecraft:behavior.charge_held_item
通用使生物为手持物品蓄力,例如猪灵拉弓。
- 参数
- 示例
minecraft:behavior.charge_held_itemJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
itemsJSON 数组:会触发蓄力的物品列表,该项为必填。- 字符串:物品 ID。
猪灵(piglin.json
"minecraft:behavior.charge_held_item": {
"priority": 3,
"items": [ "minecraft:arrow" ]
}
minecraft:behavior.circle_around_anchor
通用使生物围绕一个锚点盘旋,例如幻翼在空中绕圈。
- 参数
- 示例
minecraft:behavior.circle_around_anchorJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
goal_radius浮点数:距锚点多近即视为到达,单位为方块。默认值为0.5。angle_change浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。选择下一个锚点时朝向改变的角度。默认值为15。radius_rangeJSON 数组:与锚点的水平距离范围,写作[最小值, 最大值]。默认值为[5, 15]。radius_change浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。成功调整半径时增加的距离,单位为方块。默认值为1。radius_adjustment_chance浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。每刻调整半径的概率。默认值为0.004。height_above_target_rangeJSON 数组:高于目标高度的范围,写作[最小值, 最大值]。默认值为[0, 0]。height_offset_rangeJSON 数组:相对锚点的垂直偏移范围,写作[最小值, 最大值]。默认值为[0, 0]。height_adjustment_chance浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。每刻调整高度的概率。默认值为0.002857。speed_multiplier浮点数:飞向下一位置时的速度乘数。默认值为1。
幻翼(phantom.json
"minecraft:behavior.circle_around_anchor": {
"priority": 3,
"goal_radius": 1,
"height_above_target_range": { "min": 20, "max": 40 },
"height_offset_range": { "min": -4, "max": 5 }
}
minecraft:behavior.controlled_by_player
通用使被玩家骑乘的实体接受玩家的方向控制。
另见:minecraft:item_controllable组件、minecraft:movement组件、minecraft:rideable组件、EntityMovementComponent 类、EntityRideableComponent 类。
- 参数
- 示例
minecraft:behavior.controlled_by_playerJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
mount_speed_multiplier浮点数:1.16.0+该特性在游戏版本1.16.0+下可用。被控制时的移动速度乘数。默认值为1。fractional_rotation浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。每刻朝玩家视角转动的比例。默认值为0.5。fractional_rotation_limit浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。每刻可转动的最大角度,单位为度。默认值为5。
猪(pig.json
"minecraft:behavior.controlled_by_player": {
"priority": 0
}
minecraft:behavior.croak
通用使生物周期性发出鸣叫,青蛙使用该行为。
- 参数
- 示例
minecraft:behavior.croakJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
durationJSON 数组:每次鸣叫持续的秒数区间,也可直接写固定值。默认值为[4.5, 4.5]。intervalJSON 数组:两次鸣叫之间随机等待的秒数区间,也可直接写固定值。默认值为[10, 20]。filtersJSON 对象:允许鸣叫的条件。见实体过滤器。
青蛙(frog.json
"minecraft:behavior.croak": {
"priority": 9,
"duration": { "min": 4.5, "max": 4.5 },
"interval": { "min": 10, "max": 20 },
"filters": {
"all_of": [
{ "test": "in_water", "value": false },
{ "test": "in_lava", "value": false }
]
}
}
minecraft:behavior.defend_trusted_target
通用使生物保护已获得其信任的对象,例如狐狸保护信任的玩家。
- 参数
- 示例
minecraft:behavior.defend_trusted_targetJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
entity_typesJSON 数组:被视为有效攻击目标的实体条件列表。- JSON 对象:一项条件。
filtersJSON 对象:实体需满足的条件。见实体过滤器。
within_radius浮点数:在被保护对象周围多大的范围内发起攻击,单位为方块。默认值为0。must_see布尔值:为true时只把视野内的实体作为目标。默认值为false。must_see_forget_duration浮点数:目标离开视野多少秒后放弃。默认值为3。attack_interval整数:两次攻击之间的秒数。默认值为0。aggro_sound字符串:保护期间偶尔播放的音效事件名。on_defend_startJSON 对象:开始保护时触发的事件。event字符串:事件 ID。target字符串:事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
狐狸(fox.json
"minecraft:behavior.defend_trusted_target": {
"priority": 0,
"within_radius": 25,
"must_see": false,
"aggro_sound": "mad",
"on_defend_start": {
"event": "minecraft:fox_configure_defending",
"target": "self"
}
}
minecraft:behavior.defend_village_target
通用使生物攻击村庄的入侵者,铁傀儡使用该行为。
- 参数
- 示例
minecraft:behavior.defend_village_targetJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
entity_typesJSON 数组:被视为入侵者的实体条件列表。- JSON 对象:一项条件。
filtersJSON 对象:实体需满足的条件。见实体过滤器。
attack_chance浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。每刻发起攻击的概率。默认值为0.05。attack_owner布尔值:1.21.80+该特性在游戏版本1.21.80+下可用。为true时该实体可以攻击自己的主人。默认值为false。must_reach布尔值:1.21.80+该特性在游戏版本1.21.80+下可用。为true时要求存在通往目标的完整路径。默认值为false。must_see布尔值:1.21.80+该特性在游戏版本1.21.80+下可用。为true时只把视野内的实体作为目标。默认值为false。must_see_forget_duration浮点数:1.21.80+该特性在游戏版本1.21.80+下可用。目标离开视野多少秒后放弃。默认值为3。persist_time浮点数:1.21.80+该特性在游戏版本1.21.80+下可用。目标不再可见后仍继续攻击的秒数。默认值为0。within_radius浮点数:1.21.80+该特性在游戏版本1.21.80+下可用。距目标的最大跟随距离,超出则放弃。默认值为0。
铁傀儡(iron_golem.json
"minecraft:behavior.defend_village_target": {
"priority": 1,
"must_reach": true,
"entity_types": [
{
"filters": {
"all_of": [
{ "test": "is_family", "subject": "other", "value": "mob" },
{ "test": "is_family", "subject": "other", "value": "player" }
]
}
}
]
}
原版该条目的filters用数字写subject与operator,上例已改写为字符串形式。
minecraft:behavior.delayed_attack
通用让生物在攻击动画播放到一定进度时才结算伤害,劫掠兽使用该行为。
- 参数
- 示例
minecraft:behavior.delayed_attackJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
attack_duration浮点数:攻击动画的播放时长,单位为秒。默认值为0.75。hit_delay_pct浮点数:动画播放到多少比例时结算伤害,1.0表示动画结束。默认值为0.5。attack_once布尔值:为true时该行为在实体整个生命周期内只执行一次。默认值为false。attack_types字符串:该实体攻击的目标类型。can_spread_on_fire布尔值:1.20.30+该特性在游戏版本1.20.30+下可用。为true时,着火的实体空手攻击会点燃目标。默认值为false。reach_multiplier浮点数:以碰撞箱尺寸为基础计算攻击距离的乘数。默认值为1.5。speed_multiplier浮点数:接近目标时的移动速度乘数。默认值为1。track_target布尔值:为true时即使没有固定感知组件也能追踪目标。默认值为true。require_complete_path布尔值:1.15.0+该特性在游戏版本1.15.0+下可用。为true时要求存在通往目标的完整路径。默认值为false。random_stop_interval整数:以1/N的概率中断攻击,N为该值。默认值为0。min_path_time浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。重新计算攻击路径的最短基础间隔,单位为秒。默认值为0.2。max_path_time浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。重新计算攻击路径的最长基础间隔,单位为秒。默认值为0.55。path_inner_boundary浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。距目标小于该距离时按inner_boundary_time_increase延长重算间隔。默认值为16。path_outer_boundary浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。距目标大于该距离时按outer_boundary_time_increase延长重算间隔。默认值为32。inner_boundary_time_increase浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。目标靠近时追加的重算间隔,单位为秒。默认值为0.25。outer_boundary_time_increase浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。目标远离时追加的重算间隔,单位为秒。默认值为0.5。path_fail_time_increase浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。寻路失败时追加的重算间隔,单位为秒。默认值为0.75。melee_fov浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。感知有效目标时使用的视场角,单位为度。默认值为90。x_max_rotation浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。注视目标时俯仰方向的最大转角,单位为度。默认值为30。y_max_head_rotation浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。注视目标时水平方向的最大转角,单位为度。默认值为30。sound_event字符串:攻击时播放的音效事件名。默认值为attack.strong。on_attackJSON 对象:1.15.0+该特性在游戏版本1.15.0+下可用。成功攻击时触发的事件。event字符串:事件 ID。target字符串:事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
on_killJSON 对象:1.21.80+该特性在游戏版本1.21.80+下可用。击杀目标时触发的事件,结构同上。
劫掠兽(ravager.json
"minecraft:behavior.delayed_attack": {
"priority": 4,
"attack_once": false,
"track_target": true,
"require_complete_path": false,
"reach_multiplier": 1.5,
"speed_multiplier": 1.0,
"attack_duration": 0.75,
"hit_delay_pct": 0.5
}
minecraft:behavior.dig
通用使生物钻入地面并停留一段时间,监守者使用该行为。
- 参数
- 示例
minecraft:behavior.digJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
duration浮点数:钻地持续的秒数。默认值为0。idle_time浮点数:最后一次扰动后、开始钻地前需保持静止的秒数。默认值为0。allow_dig_when_named布尔值:为true时已被命名的实体也能钻地。默认值为false。digs_in_daylight布尔值:为true时实体见到阳光就开始钻地。默认值为false。suspicion_is_disturbance布尔值:为true时发现可疑位置也算扰动,会推迟钻地。默认值为false。vibration_is_disturbance布尔值:为true时振动也算扰动,会推迟钻地。默认值为false。on_startJSON 对象:1.19.10+该特性在游戏版本1.19.10+下可用。开始钻地时触发的事件。event字符串:事件 ID。target字符串:事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
监守者(warden.json
"minecraft:behavior.dig": {
"priority": 1,
"duration": 5.5,
"idle_time": 60,
"vibration_is_disturbance": true,
"suspicion_is_disturbance": true,
"on_start": { "event": "on_digging_event" }
}
minecraft:behavior.door_interact
通用使生物能够手动开关门。
- 参数
- 示例
minecraft:behavior.door_interactJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
原版暂无单独声明该行为的实体,以下为最小写法:
"minecraft:behavior.door_interact": {
"priority": 1
}
minecraft:behavior.dragonchargeplayer
通用使末影龙向玩家发起俯冲冲锋。
另见:minecraft:behavior.dragonscanning组件。
- 参数
- 示例
minecraft:behavior.dragonchargeplayerJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
active_speed浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。冲锋进行中或已开始时的移动速度。默认值为3。flight_speed浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。未冲锋时的飞行速度。默认值为0.6。turn_speed浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。执行该行为时的转向速度。默认值为0.7。target_zoneJSON 数组:已弃用:1.15.0-26.0该特性已被弃用,只能在游戏版本1.15.0-26.0下使用。可使用该行为的距离区间,写作[最小值, 最大值],单位为方块。默认值为[10, 150]。target_zoneJSON 对象:26.0+该特性在游戏版本26.0+下可用,但该版本对于当前的中国版版本过高。可使用该行为的距离区间,单位为方块。默认值为{"min": 10, "max": 150}。min浮点数:区间下限。默认值为10。max浮点数:区间上限。默认值为150。
continue_charge_threshold_time浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。目标脱离target_zone超过该秒数后停止冲锋。默认值为0.5。
末影龙(ender_dragon.json
"minecraft:behavior.dragonchargeplayer": {
"priority": 1
}
minecraft:behavior.dragondeath
通用控制末影龙死亡时的升空与消散过程。
- 参数
- 示例
minecraft:behavior.dragondeathJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
末影龙(ender_dragon.json
"minecraft:behavior.dragondeath": {
"priority": 0
}
minecraft:behavior.dragonflaming
通用使末影龙在停驻时先咆哮、再喷吐龙息。
- 参数
- 示例
minecraft:behavior.dragonflamingJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
cooldown_time浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。两次「咆哮并喷吐」循环之间的间隔,单位为秒。默认值为10。roar_time浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。咆哮持续的秒数。默认值为2。flame_time浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。咆哮结束后喷吐龙息持续的秒数。默认值为0.5。ground_flame_count整数:1.15.0+该特性在游戏版本1.15.0+下可用。起飞前在地面喷吐龙息的次数。默认值为4。smoke_color字符串:龙息烟雾的颜色,写作十六进制色值。默认值为#DC00EF。smoke_radius浮点数:烟雾的扩散半径。默认值为5。smoke_time浮点数:烟雾持续的时间。默认值为10。
末影龙(ender_dragon.json
"minecraft:behavior.dragonflaming": {
"priority": 1
}
minecraft:behavior.dragonholdingpattern
通用使末影龙在祭坛上方盘旋等待。
- 参数
- 示例
minecraft:behavior.dragonholdingpatternJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
末影龙(ender_dragon.json
"minecraft:behavior.dragonholdingpattern": {
"priority": 3
}
minecraft:behavior.dragonlanding
通用使末影龙降落到祭坛上。
- 参数
- 示例
minecraft:behavior.dragonlandingJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
末影龙(ender_dragon.json
"minecraft:behavior.dragonlanding": {
"priority": 0
}
minecraft:behavior.dragonscanning
通用使末影龙扫描周围,寻找可供攻击的目标。
- 参数
- 示例
minecraft:behavior.dragonscanningJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
末影龙(ender_dragon.json
"minecraft:behavior.dragonscanning": {
"priority": 2
}
minecraft:behavior.dragonstrafeplayer
通用使末影龙绕玩家盘旋并伺机发射火球。
- 参数
- 示例
minecraft:behavior.dragonstrafeplayerJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
active_speed浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。该行为进行中的移动速度。默认值为0.6。flight_speed浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。未执行该行为时的飞行速度。默认值为0.6。turn_speed浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。执行该行为时的转向速度。默认值为0.7。target_zoneJSON 数组:已弃用:1.15.0-26.0该特性已被弃用,只能在游戏版本1.15.0-26.0下使用。可使用该行为的距离区间,写作[最小值, 最大值],单位为方块。默认值为[10, 150]。target_zoneJSON 对象:26.0+该特性在游戏版本26.0+下可用,但该版本对于当前的中国版版本过高。可使用该行为的距离区间,单位为方块。默认值为{"min": 10, "max": 150}。min浮点数:区间下限。默认值为10。max浮点数:区间上限。默认值为150。
fireball_range浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。盘旋时可发射火球的最大距离,单位为方块。默认值为64。view_angle浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。目标需处于当前朝向多少度以内才发射火球,单位为度。默认值为10。target_in_range_and_in_view_time浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。目标需持续处于射程与视野内的秒数。默认值为0.25。switch_direction_probability浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。每刻在顺时针与逆时针之间切换的概率。默认值为0.125。
末影龙(ender_dragon.json
"minecraft:behavior.dragonstrafeplayer": {
"priority": 2
}
minecraft:behavior.dragontakeoff
通用使末影龙结束停驻、重新起飞盘旋。
- 参数
- 示例
minecraft:behavior.dragontakeoffJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
末影龙(ender_dragon.json
"minecraft:behavior.dragontakeoff": {
"priority": 0
}
minecraft:behavior.drink_milk
通用使生物在满足条件时饮用牛奶。
- 参数
- 示例
minecraft:behavior.drink_milkJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
cooldown_seconds浮点数:该行为的冷却秒数。默认值为5。filtersJSON 对象:允许饮用牛奶的条件。见实体过滤器。
流浪商人(wandering_trader.json
"minecraft:behavior.drink_milk": {
"priority": 1,
"cooldown_seconds": 5,
"filters": {
"all_of": [
{ "test": "is_daytime", "value": true },
{ "test": "is_visible", "value": false },
{ "test": "is_avoiding_mobs", "value": false }
]
}
}
原版该条目的filters用数字写subject与operator,上例已改写为字符串形式。
minecraft:behavior.drink_potion
通用使生物在满足条件时饮用指定的药水。
- 参数
- 示例
minecraft:behavior.drink_potionJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
potionsJSON 数组:可饮用的药水列表。- JSON 对象:一种药水。
id整数:药水的注册 ID。默认值为-1。chance浮点数:选中该药水的概率,取值0.0-1.0。默认值为1。filtersJSON 对象:允许选择该药水的条件。见实体过滤器。
speed_modifier浮点数:饮用期间施加给生物的速度修正。默认值为0。
备注:
id为药水的注册 ID,具体数值随版本变化,建议以官方示例或实际测试为准。
流浪商人(wandering_trader.json
"minecraft:behavior.drink_potion": {
"priority": 1,
"speed_modifier": 0,
"potions": [
{
"id": 14,
"chance": 1,
"filters": {
"all_of": [
{ "test": "hourly_clock_time", "operator": ">=", "value": 18000 }
]
}
}
]
}
上例只保留原版列表中的第一项,药水id按原版写法。
minecraft:behavior.drop_item_for
通用使生物靠近目标并向其投下物品,例如猫向玩家赠送礼物。
另见:minecraft:navigation.walk等导航组件。
- 参数
- 示例
minecraft:behavior.drop_item_forJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
entity_typesJSON 数组:可作为投赠对象的实体条件列表。- JSON 对象:一项条件。
filtersJSON 对象:实体需满足的条件。见实体过滤器。
loot_table字符串:决定掉落内容的战利品表路径。drop_item_chance浮点数:每次尝试投下物品的概率,取值0.0-1.0。默认值为1。offering_distance浮点数:希望与目标保持的投赠距离,单位为方块。默认值为1。cooldown浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。该行为的冷却秒数。默认值为0.25。seconds_before_pickup浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。投下的物品需经过多少秒才能被拾取。默认值为0。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。goal_radius浮点数:距目标点多近即视为到达,单位为方块。默认值为0.5。target_rangeJSON 数组:1.18.30+该特性在游戏版本1.18.30+下可用。寻找落点时在[x, y, z]三个方向上的搜索范围。默认值为[1, 1, 1]。search_range整数:搜索落点的水平距离,单位为方块。默认值为0。search_height整数:搜索落点的垂直距离,单位为方块。默认值为1。search_count整数:1.18.30+该特性在游戏版本1.18.30+下可用。每刻随机检查的方块数量。默认值为0。max_head_look_at_height浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。投赠时头部注视的最大高度,单位为方块。默认值为10。minimum_teleport_distance浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。目标距离超过该值时实体改为传送,单位为方块。默认值为2。teleport_offsetJSON 数组:1.18.30+该特性在游戏版本1.18.30+下可用。传送落点相对目标的偏移,写作[x, y, z]。默认值为[0, 1, 0]。time_of_day_rangeJSON 数组:允许执行该行为的时间范围,0.0为正午、0.5为午夜。默认值为[0, 1]。on_drop_attemptJSON 对象:尝试投下物品时触发的事件。event字符串:事件 ID。target字符串:事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
猫(cat.json
"minecraft:behavior.drop_item_for": {
"priority": 1,
"seconds_before_pickup": 0.0,
"cooldown": 0.25,
"drop_item_chance": 0.7,
"offering_distance": 5.0,
"minimum_teleport_distance": 2.0,
"max_head_look_at_height": 10.0,
"target_range": [ 5.0, 5.0, 5.0 ]
}
minecraft:behavior.eat_block
通用使生物啃食指定的方块并替换为另一方块,羊吃草即使用该行为。
- 参数
- 示例
minecraft:behavior.eat_blockJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
eat_and_replace_block_pairsJSON 数组:1.18.30+该特性在游戏版本1.18.30+下可用。被啃食方块与替换方块的对应关系列表。- JSON 对象:一组对应。
eat_block字符串:被啃食的方块 ID。replace_block字符串:啃食后替换成的方块 ID。
success_chance字符串:1.18.30+该特性在游戏版本1.18.30+下可用。每刻成功啃食的概率,填 Molang 表达式。默认值为0.02。time_until_eat浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。啃食动画持续的秒数。默认值为1.8。on_eatJSON 对象:啃食完成后触发的事件。event字符串:事件 ID。target字符串:事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
羊(sheep.json
"minecraft:behavior.eat_block": {
"priority": 6,
"success_chance": "query.is_baby ? 0.02 : 0.001",
"time_until_eat": 1.8,
"eat_and_replace_block_pairs": [
{ "eat_block": "grass", "replace_block": "dirt" },
{ "eat_block": "tallgrass", "replace_block": "air" }
]
}
minecraft:behavior.eat_carried_item
通用使生物吃掉口中携带的物品。
- 参数
- 示例
minecraft:behavior.eat_carried_itemJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
delay_before_eating浮点数:开始进食前的等待秒数。默认值为0。
狐狸(fox.json
"minecraft:behavior.eat_carried_item": {
"priority": 12,
"delay_before_eating": 28
}
minecraft:behavior.eat_mob
通用使生物吞食其他生物,青蛙吃史莱姆即使用该行为。
- 参数
- 示例
minecraft:behavior.eat_mobJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
eat_animation_time浮点数:吞食动画持续的秒数。默认值为1。eat_mob_sound字符串:吞食时播放的音效事件名。loot_table字符串:吞食后掉落内容的战利品表路径。pull_in_force浮点数:把被捕食者拉向自己的力。默认值为1。reach_mob_distance浮点数:开始吞食所需的距离,单位为方块。默认值为1。run_speed浮点数:冲向目标时的速度。默认值为1。
青蛙(frog.json
"minecraft:behavior.eat_mob": {
"priority": 7,
"run_speed": 2,
"eat_animation_time": 0.3,
"pull_in_force": 0.75,
"reach_mob_distance": 1.75,
"eat_mob_sound": "tongue",
"loot_table": "loot_tables/entities/frog.json"
}
minecraft:behavior.emerge
通用使生物从地下钻出,监守者使用该行为。
- 参数
- 示例
minecraft:behavior.emergeJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
duration浮点数:钻出过程的持续秒数。默认值为5。cooldown_time浮点数:再次使用该行为前的冷却秒数。默认值为0.5。on_doneJSON 对象:即将结束时触发的事件。event字符串:事件 ID。target字符串:事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
监守者(warden.json
"minecraft:behavior.emerge": {
"duration": 7.0,
"on_done": {
"event": "minecraft:emerged",
"target": "self"
}
}
minecraft:behavior.equip_item
通用使生物拾起并装备地面上的物品。
- 参数
- 示例
minecraft:behavior.equip_itemJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
沼骸(bogged.json
"minecraft:behavior.equip_item": {
"priority": 3
}
minecraft:behavior.explore_outskirts
通用使村民到村庄外围探索。
另见:minecraft:dweller组件、minecraft:navigation.walk等导航组件。
- 参数
- 示例
minecraft:behavior.explore_outskirtsJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
dist_from_boundaryJSON 数组:1.18.30+该特性在游戏版本1.18.30+下可用。距村庄边界的距离范围,写作[x, y, z]。默认值为[5, 0, 5]。explore_dist浮点数:超出村庄边界后继续探索的距离,单位为方块。默认值为5。max_travel_time浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。前往探索点的最长时间,单位为秒。默认值为60。min_dist_from_target浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。距探索点多近即视为到达,单位为方块。默认值为2.25。min_perimeter浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。村庄的最小周长,低于该值不执行该行为。默认值为1。min_wait_time浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。选择下一个探索点前的最短等待秒数。默认值为3。max_wait_time浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。选择下一个探索点前的最长等待秒数。默认值为0。next_xz整数:1.18.30+该特性在游戏版本1.18.30+下可用。新探索点在水平方向上的随机范围,单位为方块。默认值为5。next_y整数:1.18.30+该特性在游戏版本1.18.30+下可用。新探索点在垂直方向上的随机范围,单位为方块。默认值为3。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。timer_ratio浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。等待时长在最短与最长之间的取值比例。默认值为2。
村民(villager_v2.json
"minecraft:behavior.explore_outskirts": {}
minecraft:behavior.fertilize_farm_block
通用使生物对农田方块施肥,促进作物生长。
- 参数
- 示例
minecraft:behavior.fertilize_farm_blockJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
goal_radius浮点数:距目标点多近即视为到达,单位为方块。默认值为1.5。max_fertilizer_usage整数:对同一方块最多施肥的次数。默认值为1。search_cooldown_max_seconds浮点数:再次搜索前的最长冷却秒数。默认值为8。search_count整数:每刻随机检查的方块数量。默认值为9。search_height整数:搜索的垂直距离,单位为方块。默认值为1。search_range整数:搜索的水平距离,单位为方块。默认值为1。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为0.5。
村民(villager_v2.json
"minecraft:behavior.fertilize_farm_block": {
"priority": 8
}
minecraft:behavior.find_cover
通用使生物寻找遮蔽物躲藏。
- 参数
- 示例
minecraft:behavior.find_coverJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。cooldown_time浮点数:该行为的冷却秒数。默认值为0。
狐狸(fox.json
"minecraft:behavior.find_cover": {
"priority": 0,
"speed_multiplier": 1,
"cooldown_time": 0.0
}
minecraft:behavior.find_mount
通用使生物寻找可骑乘的目标并骑上去。
- 参数
- 示例
minecraft:behavior.find_mountJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
within_radius整数:在多大范围内寻找坐骑,单位为方块。默认值为0。avoid_water布尔值:为true时不会走进水中去找坐骑。默认值为false。start_delay整数:开始行动前等待的刻数。默认值为0。max_failed_attempts整数:寻找坐骑的最大尝试次数。默认值为20。mount_distance浮点数:与坐骑之间需要达到的距离,单位为方块,-1表示不限。默认值为-1。target_needed布尔值:为true时只有拥有攻击目标才会寻找坐骑。默认值为false。
溺尸(drowned.json
"minecraft:behavior.find_mount": {
"priority": 1,
"max_failed_attempts": 20,
"start_delay": 15,
"within_radius": 16
}
minecraft:behavior.find_underwater_treasure
通用使生物前往海底遗迹寻找宝箱,海豚使用该行为。
- 参数
- 示例
minecraft:behavior.find_underwater_treasureJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
search_range整数:在遗迹中搜索宝箱的范围。默认值为0。stop_distance浮点数:距目标多远时停下,单位为方块。默认值为2。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
海豚(dolphin.json
"minecraft:behavior.find_underwater_treasure": {
"priority": 2,
"speed_multiplier": 2.0,
"search_range": 30,
"stop_distance": 50
}
minecraft:behavior.fire_at_target
通用使生物向目标发射弹射物,旋风人使用该行为。
- 参数
- 示例
minecraft:behavior.fire_at_targetJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
projectile_def字符串:作为弹射物的实体定义 ID。attack_rangeJSON 数组:要求目标所处的距离区间,写作[最小值, 最大值],单位为方块。默认值为[0, 0]。attack_cooldown浮点数:该行为的冷却秒数。默认值为0.5。filtersJSON 对象:允许执行该行为的条件。见实体过滤器。pre_shoot_delay浮点数:发射前的准备秒数。默认值为0.75。post_shoot_delay浮点数:发射后到行为结束的秒数。默认值为0.2。ranged_fov浮点数:感知目标时使用的视场角,单位为度。默认值为90。max_head_rotation_x浮点数:注视目标时俯仰方向的最大转角,单位为度。默认值为30。max_head_rotation_y浮点数:注视目标时水平方向的最大转角,单位为度。默认值为30。owner_anchor整数:弹射物的生成锚点。0为原点、1为眼睛高度、2为实体中心。默认值为2。owner_offsetJSON 数组:相对锚点的生成偏移,写作[x, y, z]。默认值为[0, 0, 0]。target_anchor整数:瞄准目标的锚点,取值同owner_anchor。默认值为2。target_offsetJSON 数组:相对目标锚点的偏移,写作[x, y, z]。默认值为[0, 0, 0]。
旋风人(breeze.json
"minecraft:behavior.fire_at_target": {
"priority": 2,
"projectile_def": "minecraft:breeze_wind_charge_projectile",
"attack_range": { "min": 0, "max": 16 },
"attack_cooldown": 0.5,
"pre_shoot_delay": 0.75,
"post_shoot_delay": 0.2,
"owner_anchor": 2,
"owner_offset": [ 0.0, 0.3, 0.0 ],
"filters": {
"all_of": [
{ "test": "is_navigating", "value": false }
]
}
}
minecraft:behavior.flee_sun
通用使生物躲避阳光,沼骸与僵尸类实体使用该行为。
- 参数
- 示例
minecraft:behavior.flee_sunJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
沼骸(bogged.json
"minecraft:behavior.flee_sun": {
"priority": 2,
"speed_multiplier": 1
}
minecraft:behavior.float
通用使实体在水中向上浮动,避免沉底。
- 参数
- 示例
minecraft:behavior.floatJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
chance_per_tick_to_float浮点数:1.21.130+该特性在游戏版本1.21.130+下可用。每刻施加向上推力的概率。默认值为0.8。sink_with_passengers布尔值:1.19.50+该特性在游戏版本1.19.50+下可用。为true时只要还有乘客就持续下沉。默认值为false。time_under_water_to_dismount_passengers浮点数:1.21.130+该特性在游戏版本1.21.130+下可用。载具头部没入水中多少秒后让乘客下船。默认值为0。
悦灵(allay.json
"minecraft:behavior.float": {
"priority": 7
}
minecraft:behavior.float_tempt
通用使浮空的生物被手持特定物品的玩家吸引。
- 参数
- 示例
minecraft:behavior.float_temptJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
itemsJSON 数组:可以吸引该生物的物品列表。- 字符串:物品 ID。
within_radius浮点数:在多大范围内能被吸引,单位为方块。默认值为0。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。stop_distance浮点数:追随玩家时保持的距离,单位为方块。can_get_scared布尔值:为true时玩家移动过快会让生物受惊而停止跟随。默认值为false。can_tempt_vertically布尔值:为true时垂直距离也计入判定。默认值为false。can_tempt_while_ridden布尔值:为true时身上有骑乘者也能被吸引。默认值为false。tempt_sound字符串:被吸引期间播放的音效事件名。sound_intervalJSON 数组:两次音效之间随机等待的刻数区间。on_tempt_startJSON 对象:开始被吸引时触发的事件。event字符串:事件 ID。target字符串:事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
on_tempt_endJSON 对象:停止被吸引时触发的事件,结构同上。
快乐恶魂(happy_ghast.json
"minecraft:behavior.float_tempt": {
"priority": 4,
"can_tempt_vertically": true,
"items": [
"minecraft:snowball",
"minecraft:black_harness",
"minecraft:blue_harness"
]
}
上例的物品列表在原版中更长,此处只保留前三项。
minecraft:behavior.float_wander
通用使生物在空中随意漂浮游荡,蝙蝠使用该行为。
- 参数
- 示例
minecraft:behavior.float_wanderJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
float_durationJSON 数组:已弃用:1.2.0-26.40该特性已被弃用,只能在游戏版本1.2.0-26.40下使用。每次漂浮持续的时间区间,写作[最小值, 最大值],单位为秒。默认值为[0, 0]。float_durationJSON 对象:26.40+该特性在游戏版本26.40+下可用,但该版本对于当前的中国版版本过高。每次漂浮持续的时间区间,单位为秒。min浮点数:区间下限。默认值为0。max浮点数:区间上限。默认值为0。
xz_dist整数:在水平方向上寻找落点的距离,单位为方块。默认值为10。y_dist整数:在垂直方向上寻找落点的距离,单位为方块。默认值为7。y_offset浮点数:在选定落点上叠加的高度偏移,单位为方块。默认值为0。random_reselect布尔值:为true时移动途中会随机重新选择落点。默认值为false。must_reach布尔值:为true时落点必须可达才有效。默认值为false。float_wander_has_move_control布尔值:1.21.70+该特性在游戏版本1.21.70+下可用。为true时该行为自带移动控制。默认值为true。use_home_position_restriction布尔值:1.21.70+该特性在游戏版本1.21.70+下可用。为true时遵守minecraft:home的限制范围。默认值为true。navigate_around_surface布尔值:1.21.80+该特性在游戏版本1.21.80+下可用。为true时优先在表面附近寻找落点。默认值为false。surface_xz_dist整数:1.21.80+该特性在游戏版本1.21.80+下可用。检查表面时的水平距离,单位为方块。默认值为8。surface_y_dist整数:1.21.80+该特性在游戏版本1.21.80+下可用。检查表面时的垂直距离,单位为方块。默认值为8。additional_collision_buffer布尔值:1.21.80+该特性在游戏版本1.21.80+下可用。为true时在实体周围增加一圈避让缓冲。默认值为false。allow_navigating_through_liquids布尔值:1.21.80+该特性在游戏版本1.21.80+下可用。为true时允许穿过液体寻路。默认值为false。
蝙蝠(bat.json
"minecraft:behavior.float_wander": {
"priority": 1,
"float_duration": [ 0.1, 0.35 ],
"float_wander_has_move_control": false,
"random_reselect": true,
"y_offset": -2.0,
"use_home_position_restriction": false,
"xz_dist": 10,
"y_dist": 7
}
minecraft:behavior.follow_caravan
通用使生物跟随行进队伍中的其他实体,羊驼使用该行为。
- 参数
- 示例
minecraft:behavior.follow_caravanJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
entity_typesJSON 数组:队伍中可以跟随的实体条件列表。- JSON 对象:一项条件。
filtersJSON 对象:实体需满足的条件。见实体过滤器。
entity_count整数:队伍中允许的实体数量。默认值为1。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
备注:原版把
entity_types写成单个对象,schema 中为数组,两种写法均可解析。
羊驼(llama.json
"minecraft:behavior.follow_caravan": {
"priority": 3,
"speed_multiplier": 2.1,
"entity_count": 10,
"entity_types": {
"filters": { "test": "is_family", "subject": "other", "value": "llama" }
}
}
minecraft:behavior.follow_mob
通用使生物跟随附近的其他生物。
- 参数
- 示例
minecraft:behavior.follow_mobJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
search_range整数:搜索可跟随目标的范围,单位为方块。默认值为0。stop_distance浮点数:与被跟随者保持的距离,单位为方块。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。filtersJSON 对象:1.21.80+该特性在游戏版本1.21.80+下可用。可作为跟随目标的实体条件。见实体过滤器。preferred_actor_type字符串:1.21.80+该特性在游戏版本1.21.80+下可用。优先跟随的实体 ID,省略时随机选择。use_home_position_restriction布尔值:1.21.80+该特性在游戏版本1.21.80+下可用。为true时遵守minecraft:home的限制范围。默认值为false。
快乐恶魂(happy_ghast.json
"minecraft:behavior.follow_mob": {
"priority": 6,
"search_range": 16,
"stop_distance": 5,
"speed_multiplier": 1.1,
"use_home_position_restriction": true,
"preferred_actor_type": "player"
}
minecraft:behavior.follow_owner
通用使生物跟随其主人,如悦灵跟随给予它物品的玩家。
- 参数
- 示例
minecraft:behavior.follow_ownerJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
start_distance浮点数:距主人多远时开始跟随,单位为方块。默认值为10。stop_distance浮点数:距主人多近时停止跟随,单位为方块。默认值为2。max_distance浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。距主人超过该距离后不再跟随,单位为方块。默认值为60。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。can_teleport布尔值:1.18.30+该特性在游戏版本1.18.30+下可用。为true时距离过远会传送到主人身边。默认值为true。post_teleport_distance整数:1.21.20+该特性在游戏版本1.21.20+下可用。传送后与主人保持的距离,单位为方块。默认值为3。ignore_vibration布尔值:1.18.30+该特性在游戏版本1.18.30+下可用。为true时感知到振动后仍继续跟随。默认值为false。
悦灵(allay.json
"minecraft:behavior.follow_owner": {
"priority": 6,
"can_teleport": false,
"speed_multiplier": 8,
"start_distance": 16,
"stop_distance": 4
}
minecraft:behavior.follow_parent
通用使幼年实体跟随其父母。
- 参数
- 示例
minecraft:behavior.follow_parentJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
犰狳(armadillo.json
"minecraft:behavior.follow_parent": {
"priority": 5,
"speed_multiplier": 1.25
}
minecraft:behavior.follow_target_leader
通用使生物跟随符合条件的目标作为领队。
- 参数
- 示例
minecraft:behavior.follow_target_leaderJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
leader_filtersJSON 对象:可作为领队的实体条件。见实体过滤器。within_radius浮点数:搜索领队的最大距离,单位为方块。默认值为0。follow_distance浮点数:与目标保持的距离,单位为方块。默认值为0。search_cooldown整数:两次搜索之间的间隔,单位为刻。默认值为20。always_look_for_leader布尔值:为true时即使没有目标也持续寻找领队。默认值为false。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
原版暂无使用该行为的实体,以下为最小写法:
"minecraft:behavior.follow_target_leader": {
"priority": 5,
"leader_filters": { "test": "is_family", "subject": "other", "value": "llama" },
"within_radius": 16,
"follow_distance": 4
}
minecraft:behavior.go_and_give_items_to_noteblock
通用使生物把物品投向音符盒。
- 参数
- 示例
minecraft:behavior.go_and_give_items_to_noteblockJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
listen_time整数:在音符盒处继续投掷物品的秒数。默认值为30。reach_block_distance浮点数:距音符盒多近时开始投掷,单位为方块。默认值为3。run_speed浮点数:冲向音符盒时的速度。默认值为1。throw_force浮点数:投掷力度。默认值为0.2。vertical_throw_mul浮点数:在投掷力度之上叠加的垂直分量乘数。默认值为1.5。throw_sound字符串:投掷时播放的音效事件名。默认值为charge。on_item_throwJSON 数组:投掷物品时触发的事件列表。- JSON 对象:一个事件。
event字符串:事件 ID。target字符串:事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
悦灵(allay.json
"minecraft:behavior.go_and_give_items_to_noteblock": {
"priority": 3,
"run_speed": 8,
"throw_sound": "item_thrown",
"on_item_throw": [
{ "event": "pickup_item_delay", "target": "self" }
]
}
minecraft:behavior.go_and_give_items_to_owner
通用使生物把物品投向其主人。
- 参数
- 示例
minecraft:behavior.go_and_give_items_to_ownerJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
reach_mob_distance浮点数:距主人多近时开始投掷,单位为方块。默认值为3。run_speed浮点数:冲向主人时的速度。默认值为1。throw_force浮点数:投掷力度。默认值为0.2。vertical_throw_mul浮点数:在投掷力度之上叠加的垂直分量乘数。默认值为1.5。throw_sound字符串:投掷时播放的音效事件名。默认值为charge。on_item_throwJSON 数组:投掷物品时触发的事件列表。- JSON 对象:一个事件。
event字符串:事件 ID。target字符串:事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
悦灵(allay.json
"minecraft:behavior.go_and_give_items_to_owner": {
"priority": 4,
"run_speed": 8,
"throw_sound": "item_thrown",
"on_item_throw": [
{ "event": "pickup_item_delay", "target": "self" }
]
}
minecraft:behavior.go_home
通用使生物返回其「家」的位置,需配合minecraft:home组件。
- 参数
- 示例
minecraft:behavior.go_homeJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
interval整数:再次尝试回家前的随机间隔,单位为刻。默认值为120。goal_radius浮点数:距家多近即视为到达,单位为方块。默认值为0.5。calculate_new_path_radius浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。距终点多近时重新计算路径,单位为方块。默认值为2。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。on_homeJSON 数组:到家时触发的事件列表。on_failedJSON 数组:1.18.30+该特性在游戏版本1.18.30+下可用。回家失败时触发的事件列表,结构同上。
蜜蜂(bee.json
"minecraft:behavior.go_home": {
"priority": 4,
"speed_multiplier": 1.0,
"interval": 1,
"goal_radius": 1.2,
"on_home": [
{
"filters": {
"any_of": [
{ "test": "is_block", "subject": "block", "value": "minecraft:bee_nest" },
{ "test": "is_block", "subject": "block", "value": "minecraft:beehive" }
]
},
"event": "minecraft:bee_returned_to_hive",
"target": "block"
}
]
}
minecraft:behavior.guardian_attack
通用使守卫者与远古守卫者发动魔法攻击。
- 参数
- 示例
minecraft:behavior.guardian_attackJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
magic_damage整数:1.15.0+该特性在游戏版本1.15.0+下可用。魔法攻击的基础伤害。默认值为1。elder_extra_magic_damage整数:1.15.0+该特性在游戏版本1.15.0+下可用。远古守卫者额外增加的魔法伤害。默认值为2。hard_mode_extra_magic_damage整数:1.15.0+该特性在游戏版本1.15.0+下可用。困难难度下额外增加的魔法伤害。默认值为2。min_distance浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。目标距离小于该值时停止该行为,单位为方块。默认值为3。sound_delay_time浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。开始攻击后延迟多少秒播放音效。默认值为0.5。x_max_rotation浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。俯仰方向的最大转角,单位为度。默认值为90。y_max_head_rotation浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。水平方向的最大转角,单位为度。默认值为90。
远古守卫者(elder_guardian.json
"minecraft:behavior.guardian_attack": {
"priority": 4
}
minecraft:behavior.harvest_farm_block
通用使村民收割成熟的作物。
另见:minecraft:inventory组件、minecraft:navigation.walk等导航组件、EntityInventoryComponent 类。
- 参数
- 示例
minecraft:behavior.harvest_farm_blockJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
goal_radius浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。距目标点多近即视为到达,单位为方块。默认值为1.5。search_range整数:1.18.30+该特性在游戏版本1.18.30+下可用。搜索农田的水平距离,单位为方块。默认值为16。search_height整数:1.18.30+该特性在游戏版本1.18.30+下可用。搜索农田的垂直距离,单位为方块。默认值为1。search_count整数:1.18.30+该特性在游戏版本1.18.30+下可用。每刻随机检查的方块数量。默认值为0。max_seconds_before_search浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。开始搜索前允许等待的最长秒数。默认值为1。search_cooldown_max_seconds浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。搜索失败后再次搜索前的最长冷却秒数。默认值为8。seconds_until_new_task浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。成功收割后进入下一任务前的冷却秒数。默认值为0.5。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为0.5。
村民(villager.json
"minecraft:behavior.harvest_farm_block": {
"priority": 9,
"speed_multiplier": 0.5
}
minecraft:behavior.hide
通用使生物移动到并躲藏在其兴趣点处。
- 参数
- 示例
minecraft:behavior.hideJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
poi_type字符串:要寻找的兴趣点类型。可选值为bed(床)、meeting_area(集会点)、jobsite(工作站点)。duration浮点数:躲藏的持续秒数。默认值为1。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。timeout_cooldown浮点数:被打断后再次使用该行为前的冷却秒数。默认值为8。
村民(villager_v2.json
"minecraft:behavior.hide": {
"priority": 0,
"duration": 30,
"poi_type": "bed",
"speed_multiplier": 0.8
}
minecraft:behavior.hold_ground
通用使生物在目标进入一定距离后停下并固守原地。
- 参数
- 示例
minecraft:behavior.hold_groundJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
min_radius浮点数:目标需进入该距离才执行该行为,单位为方块。默认值为10。broadcast布尔值:为true时把当前目标广播给同类实体。默认值为false。broadcast_range浮点数:广播的范围,单位为方块。默认值为0。within_radius_eventJSON 对象:目标进入范围时触发的事件。event字符串:事件 ID。target字符串:事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
掠夺者(pillager.json
"minecraft:behavior.hold_ground": {
"priority": 6,
"broadcast": true,
"broadcast_range": 8,
"min_radius": 10,
"within_radius_event": { "event": "minecraft:ranged_mode", "target": "self" }
}
minecraft:behavior.hover
通用使实体在空中悬停。
- 参数
- 示例
minecraft:behavior.hoverJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
原版暂无单独声明该行为的实体,以下为最小写法:
"minecraft:behavior.hover": {
"priority": 5
}
minecraft:behavior.hurt_by_target
通用使生物把伤害来源设为目标进行反击。
- 参数
- 示例
minecraft:behavior.hurt_by_targetJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
entity_typesJSON 数组:可作为反击目标的实体条件列表。- JSON 对象:一项条件。
filtersJSON 对象:实体需满足的条件。见实体过滤器。
hurt_owner布尔值:为true时也会攻击主人以及属于同一主人的实体。默认值为false。
蜜蜂(bee.json
"minecraft:behavior.hurt_by_target": {
"priority": 1
}
minecraft:behavior.inspect_bookshelf
通用使村民查看书架。
- 参数
- 示例
minecraft:behavior.inspect_bookshelfJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
goal_radius浮点数:距目标点多近即视为到达,单位为方块。默认值为0.5。search_range整数:搜索书架的距离,单位为方块。默认值为0。search_height整数:搜索书架的高度,单位为方块。默认值为1。search_count整数:每刻随机检查的方块数量。默认值为10。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
村民(villager_v2.json
"minecraft:behavior.inspect_bookshelf": {}
minecraft:behavior.investigate_suspicious_location
通用使生物前往可疑位置进行调查,监守者使用该行为。
- 参数
- 示例
minecraft:behavior.investigate_suspicious_locationJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
goal_radius浮点数:距目标点多近即视为到达,单位为方块。默认值为1.5。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
监守者(warden.json
"minecraft:behavior.investigate_suspicious_location": {
"priority": 5,
"speed_multiplier": 0.7
}
minecraft:behavior.jump_around_target
通用使生物围绕目标跳跃移动,旋风人使用该行为。
- 参数
- 示例
minecraft:behavior.jump_around_targetJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
filtersJSON 对象:允许执行该行为的条件。见实体过滤器。jump_anglesJSON 数组:允许使用的跳跃角度列表,单位为度。默认值为[40, 55, 60, 75, 80]。max_jump_velocity浮点数:跳跃的最大速度。默认值为1.4。prepare_jump_duration浮点数:起跳前的准备秒数。默认值为0.5。jump_cooldown_duration浮点数:两次跳跃之间的冷却秒数。默认值为0.5。jump_cooldown_when_hurt_duration浮点数:受伤后跳跃的冷却秒数。默认值为0.1。last_hurt_duration浮点数:判定「近期受伤」的秒数,受伤后的跳跃改用较短的冷却。默认值为2。valid_distance_to_targetJSON 数组:已弃用:1.21.30-26.20该特性已被弃用,只能在游戏版本1.21.30-26.20下使用。允许起跳的目标距离区间写作[最小值, 最大值],单位为方块。默认值为[4, 20]。valid_distance_to_targetJSON 对象:26.20+该特性在游戏版本26.20+下可用,但该版本对于当前的中国版版本过高。允许起跳的目标距离区间,单位为方块。min浮点数:区间下限。默认值为4。max浮点数:区间上限。默认值为20。
landing_distance_from_targetJSON 数组:已弃用:1.21.30-26.20该特性已被弃用,只能在游戏版本1.21.30-26.20下使用。落点与目标的距离区间写作[最小值, 最大值],单位为方块。默认值为[4, 8]。landing_distance_from_targetJSON 对象:26.20+该特性在游戏版本26.20+下可用,但该版本对于当前的中国版版本过高。落点与目标的距离区间,单位为方块。min浮点数:区间下限。默认值为4。max浮点数:区间上限。默认值为8。
landing_position_spread_degrees整数:选择落点时的散布角度,单位为度。默认值为90。required_vertical_space整数:头顶需要留空的方块数。默认值为4。line_of_sight_obstruction_height_ignore整数:视线受阻时,低于该高度的遮挡物可忽略,单位为方块。默认值为4。snap_to_surface_block_range整数:在落点上下多大范围内贴合表面,单位为方块。默认值为10。check_collision布尔值:为true时计算跳跃时会检查碰撞。默认值为false。entity_bounding_box_scale浮点数:跳跃期间临时施加给碰撞箱的缩放。默认值为0.7。
旋风人(breeze.json
"minecraft:behavior.jump_around_target": {
"priority": 1,
"jump_cooldown_duration": 0.5,
"check_collision": false,
"filters": {
"all_of": [
{
"any_of": [
{ "test": "in_water", "value": true },
{ "test": "on_ground", "value": true }
]
},
{ "test": "is_riding", "value": false }
]
}
}
minecraft:behavior.jump_to_block
通用使生物跳向指定的方块,青蛙使用该行为。
- 参数
- 示例
minecraft:behavior.jump_to_blockJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
cooldown_rangeJSON 数组:已弃用:1.18.30-26.20该特性已被弃用,只能在游戏版本1.18.30-26.20下使用。两次跳跃之间的冷却秒数区间写作[最小值, 最大值]。默认值为[10, 20]。cooldown_rangeJSON 对象:26.20+该特性在游戏版本26.20+下可用,但该版本对于当前的中国版版本过高。两次跳跃之间的冷却秒数区间,单位为秒。min浮点数:区间下限。默认值为10。max浮点数:区间上限。默认值为20。
forbidden_blocksJSON 数组:不能跳向的方块列表,元素写作{ "name": 方块 ID }。preferred_blocksJSON 数组:优先跳向的方块列表,写法同上。preferred_blocks_chance浮点数:优先选择偏好方块的附加概率,取值0.0-1.0。默认值为1。max_velocity浮点数:跳跃的最大速度。默认值为1.5。minimum_distance整数:与目标方块的最小距离,单位为方块。默认值为2。minimum_path_length整数:通往目标方块的最短路径长度,单位为方块。默认值为5。search_width整数:搜索框的宽度,单位为方块,取值1-15。默认值为8。search_height整数:搜索框的高度,单位为方块,取值1-15。默认值为10。scale_factor浮点数:跳跃期间碰撞箱的缩放系数。默认值为0.7。
青蛙(frog.json
"minecraft:behavior.jump_to_block": {
"priority": 10,
"cooldown_range": { "min": 5, "max": 7 },
"max_velocity": 1,
"minimum_distance": 1,
"minimum_path_length": 2,
"forbidden_blocks": [ { "name": "minecraft:water" } ],
"preferred_blocks": [ { "name": "minecraft:waterlily" } ]
}
minecraft:behavior.knockback_roar
通用使生物咆哮并把周围的实体击退,劫掠兽使用该行为。
- 参数
- 示例
minecraft:behavior.knockback_roarJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
attack_time浮点数:开始咆哮到产生击退之间的延迟秒数。默认值为0.5。duration浮点数:咆哮持续的秒数。默认值为1。cooldown_time浮点数:该行为的冷却秒数。默认值为0.1。knockback_damage整数:咆哮造成的伤害。默认值为6。knockback_range整数:击退作用的半径,单位为方块。默认值为4。knockback_horizontal_strength整数:1.17.20+该特性在游戏版本1.17.20+下可用。水平击退强度。默认值为4。knockback_vertical_strength整数:1.17.20+该特性在游戏版本1.17.20+下可用。垂直击退强度。默认值为4。knockback_height_cap浮点数:1.18.30+该特性在游戏版本1.18.30+下可用。垂直击退的高度上限。默认值为0.4。damage_filtersJSON 对象:1.18.30+该特性在游戏版本1.18.30+下可用。会受到伤害的实体条件。见实体过滤器。knockback_filtersJSON 对象:1.18.30+该特性在游戏版本1.18.30+下可用。会被击退的实体条件。见实体过滤器。on_roar_endJSON 对象:1.18.30+该特性在游戏版本1.18.30+下可用。咆哮结束时触发的事件。event字符串:事件 ID。target字符串:事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
劫掠兽(ravager.json
"minecraft:behavior.knockback_roar": {
"priority": 1,
"duration": 1,
"attack_time": 0.5,
"knockback_damage": 6,
"knockback_horizontal_strength": 3,
"knockback_vertical_strength": 3,
"knockback_range": 4
}
minecraft:behavior.lay_down
通用使生物躺下休息,熊猫使用该行为。
- 参数
- 示例
minecraft:behavior.lay_downJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
interval整数:可以进入躺下状态的随机间隔,单位为刻。默认值为120。random_stop_interval整数:退出躺下状态的随机间隔,单位为刻。默认值为120。
熊猫(panda.json
"minecraft:behavior.lay_down": {
"priority": 5,
"interval": 400,
"random_stop_interval": 2000
}
minecraft:behavior.lay_egg
通用使生物在指定方块上产卵,海龟与青蛙使用该行为。
- 参数
- 示例
minecraft:behavior.lay_eggJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
egg_type字符串:1.18.10+该特性在游戏版本1.18.10+下可用。产下的卵对应的方块 ID。默认值为minecraft:turtle_egg。target_blocksJSON 数组:1.18.10+该特性在游戏版本1.18.10+下可用。可以在其上方产卵的方块列表。默认值为[ "minecraft:sand" ]。target_materials_above_blockJSON 数组:1.18.10+该特性在游戏版本1.18.10+下可用。目标方块上方允许存在的材质列表。默认值为[ "air" ]。lay_seconds浮点数:1.18.10+该特性在游戏版本1.18.10+下可用。产卵过程持续的秒数。默认值为10。lay_egg_sound字符串:1.18.10+该特性在游戏版本1.18.10+下可用。产卵时播放的音效事件名。默认值为lay_egg。allow_laying_from_below布尔值:1.18.10+该特性在游戏版本1.18.10+下可用。为true时允许从目标方块下方产卵。默认值为false。use_default_animation布尔值:1.18.10+该特性在游戏版本1.18.10+下可用。为true时播放默认的产卵动画。默认值为true。search_range整数:搜索产卵位置的距离,单位为方块。默认值为0。search_height整数:搜索产卵位置的高度,单位为方块。默认值为1。goal_radius浮点数:距目标点多近即视为到达,单位为方块。默认值为0.5。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。on_layJSON 对象:产卵时触发的事件。event字符串:事件 ID。target字符串:事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
青蛙(frog.json
"minecraft:behavior.lay_egg": {
"priority": 2,
"allow_laying_from_below": true,
"lay_seconds": 2,
"egg_type": "minecraft:frog_spawn",
"search_height": 3,
"goal_radius": 1.7,
"lay_egg_sound": "lay_spawn",
"on_lay": { "event": "laid_egg", "target": "self" }
}
minecraft:behavior.leap_at_target
通用使生物向目标扑跃。
- 参数
- 示例
minecraft:behavior.leap_at_targetJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
yd浮点数:扑跃时达到的高度,单位为方块。默认值为0。must_be_on_ground布尔值:为true时只有站在地面上才会扑跃。默认值为true。set_persistent布尔值:1.16.0+该特性在游戏版本1.16.0+下可用。为true时锁定玩家为目标后转为持久实体。默认值为false。
schema 把该组件标注为仅敌对生物可用,但 26.60 的原版包中猫、豹猫、狼也在使用,此处按原版书写。
猫(cat.json
"minecraft:behavior.leap_at_target": {
"priority": 3
}
minecraft:behavior.look_at_entity
通用使生物注视附近的特定实体。
- 参数
- 示例
minecraft:behavior.look_at_entityJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
angle_of_view_horizontal整数:水平方向的视场角,单位为度。默认值为360。angle_of_view_vertical整数:垂直方向的视场角,单位为度。默认值为360。look_distance浮点数:可注视的最远距离,单位为方块。默认值为8。look_timeJSON 数组:已弃用:1.2.0-26.0该特性已被弃用,只能在游戏版本1.2.0-26.0下使用。每次注视持续时间的区间,写作[最小值, 最大值],单位为秒。默认值为[2, 4]。look_timeJSON 对象:26.0+该特性在游戏版本26.0+下可用,但该版本对于当前的中国版版本过高。每次注视持续时间的区间,单位为秒。默认值为{"min": 2, "max": 4}。min浮点数:区间下限。默认值为2。max浮点数:区间上限。默认值为4。
probability浮点数:每刻开始注视的概率,取值0.0-1.0。默认值为0.02。filtersJSON 对象:可以被注视的实体条件。见实体过滤器。
唤魔者(evocation_illager.json
"minecraft:behavior.look_at_entity": {
"priority": 10,
"look_time": { "min": 1, "max": 2 }
}
minecraft:behavior.look_at_player
通用使生物注视附近的玩家。
- 参数
- 示例
minecraft:behavior.look_at_playerJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
angle_of_view_horizontal整数:水平方向的视场角,单位为度。默认值为360。angle_of_view_vertical整数:垂直方向的视场角,单位为度。默认值为360。look_distance浮点数:可注视的最远距离,单位为方块。默认值为8。look_timeJSON 数组:已弃用:1.2.0-26.0该特性已被弃用,只能在游戏版本1.2.0-26.0下使用。每次注视持续时间的区间,写作[最小值, 最大值],单位为秒。默认值为[2, 4]。look_timeJSON 对象:26.0+该特性在游戏版本26.0+下可用,但该版本对于当前的中国版版本过高。每次注视持续时间的区间,单位为秒。默认值为{"min": 2, "max": 4}。min浮点数:区间下限。默认值为2。max浮点数:区间上限。默认值为4。
probability浮点数:每刻开始注视的概率,取值0.0-1.0。默认值为0.02。
悦灵(allay.json
"minecraft:behavior.look_at_player": {
"priority": 8,
"look_distance": 6
}
minecraft:behavior.look_at_target
通用使生物注视其当前攻击目标。
- 参数
- 示例
minecraft:behavior.look_at_targetJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
angle_of_view_horizontal整数:水平方向的视场角,单位为度。默认值为360。angle_of_view_vertical整数:垂直方向的视场角,单位为度。默认值为360。look_distance浮点数:可注视的最远距离,单位为方块。默认值为8。look_timeJSON 数组:已弃用:1.2.0-26.0该特性已被弃用,只能在游戏版本1.2.0-26.0下使用。每次注视持续时间的区间,写作[最小值, 最大值],单位为秒。默认值为[2, 4]。look_timeJSON 对象:26.0+该特性在游戏版本26.0+下可用,但该版本对于当前的中国版版本过高。每次注视持续时间的区间,单位为秒。默认值为{"min": 2, "max": 4}。min浮点数:区间下限。默认值为2。max浮点数:区间上限。默认值为4。
probability浮点数:每刻开始注视的概率,取值0.0-1.0。默认值为0.02。
凋灵(wither.json
"minecraft:behavior.look_at_target": {
"priority": 5,
"look_time": { "min": 1, "max": 2 }
}
minecraft:behavior.look_at_trading_player
通用使生物注视正在与其交易的玩家。
- 参数
- 示例
minecraft:behavior.look_at_trading_playerJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
angle_of_view_horizontal整数:水平方向的视场角,单位为度。默认值为360。angle_of_view_vertical整数:垂直方向的视场角,单位为度。默认值为360。look_distance浮点数:可注视的最远距离,单位为方块。默认值为8。look_timeJSON 数组:已弃用:1.2.0-26.0该特性已被弃用,只能在游戏版本1.2.0-26.0下使用。每次注视持续时间的区间,写作[最小值, 最大值],单位为秒。默认值为[2, 4]。look_timeJSON 对象:26.0+该特性在游戏版本26.0+下可用,但该版本对于当前的中国版版本过高。每次注视持续时间的区间,单位为秒。默认值为{"min": 2, "max": 4}。min浮点数:区间下限。默认值为2。max浮点数:区间上限。默认值为4。
probability浮点数:每刻开始注视的概率,取值0.0-1.0。默认值为0.02。
村民(villager.json
"minecraft:behavior.look_at_trading_player": {
"priority": 2,
"look_time": { "min": 1, "max": 2 }
}
minecraft:behavior.make_love
通用使生物寻找配偶并进入求爱状态,需配合minecraft:breedable组件。
- 参数
- 示例
minecraft:behavior.make_loveJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
村民(villager.json
"minecraft:behavior.make_love": {
"priority": 6
}
minecraft:behavior.melee_attack
通用使生物接近并近战攻击目标。
- 参数
- 示例
minecraft:behavior.melee_attackJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
reach_multiplier浮点数:以碰撞箱尺寸为基础计算攻击距离的乘数,0表示不进行近战攻击。默认值为2。cooldown_time浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。两次攻击之间的冷却秒数。默认值为1。attack_once布尔值:1.6.0+该特性在游戏版本1.6.0+下可用。为true时该行为在实体整个生命周期内只执行一次。默认值为false。attack_types字符串:该实体攻击的目标类型。can_spread_on_fire布尔值:1.20.30+该特性在游戏版本1.20.30+下可用。为true时,着火的实体空手攻击会点燃目标。默认值为false。speed_multiplier浮点数:接近目标时的移动速度乘数。默认值为1。track_target布尔值:为true时即使没有固定感知组件也能追踪目标。默认值为false。require_complete_path布尔值:1.9.0+该特性在游戏版本1.9.0+下可用。为true时要求存在通往目标的完整路径。默认值为false。random_stop_interval整数:以1/N的概率中断攻击,N为该值。默认值为0。min_path_time浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。重新计算攻击路径的最短基础间隔,单位为秒。默认值为0.2。max_path_time浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。重新计算攻击路径的最长基础间隔,单位为秒。默认值为0.55。path_inner_boundary浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。距目标小于该距离时追加inner_boundary_time_increase的重算间隔。默认值为16。path_outer_boundary浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。距目标大于该距离时追加outer_boundary_time_increase的重算间隔。默认值为32。inner_boundary_time_increase浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。目标靠近时追加的重算间隔,单位为秒。默认值为0.25。outer_boundary_time_increase浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。目标远离时追加的重算间隔,单位为秒。默认值为0.5。path_fail_time_increase浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。寻路失败时追加的重算间隔,单位为秒。默认值为0.75。melee_fov浮点数:1.6.0+该特性在游戏版本1.6.0+下可用。感知有效目标时使用的视场角,单位为度。默认值为90。x_max_rotation浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。注视目标时俯仰方向的最大转角,单位为度。默认值为30。y_max_head_rotation浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。注视目标时水平方向的最大转角,单位为度。默认值为30。on_attackJSON 对象:1.15.0+该特性在游戏版本1.15.0+下可用。成功攻击时触发的事件。event字符串:事件 ID。target字符串:事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
on_killJSON 对象:1.21.80+该特性在游戏版本1.21.80+下可用。击杀目标时触发的事件,结构同上。
苦力怕(creeper.json
reach_multiplier设为0,只用于追击而不挥击。
"minecraft:behavior.melee_attack": {
"priority": 4,
"reach_multiplier": 0,
"speed_multiplier": 1.25
}
minecraft:behavior.melee_box_attack
通用使生物以矩形判定范围进行近战攻击。
- 参数
- 示例
minecraft:behavior.melee_box_attackJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
horizontal_reach浮点数:在实体碰撞箱基础上向外扩展的判定距离,单位为方块。默认值为0.8。cooldown_time浮点数:两次攻击之间的冷却秒数。默认值为1。attack_once布尔值:为true时该行为在实体整个生命周期内只执行一次。默认值为false。attack_types字符串:该实体攻击的目标类型。can_spread_on_fire布尔值:为true时,着火的实体空手攻击会点燃目标。默认值为false。speed_multiplier浮点数:接近目标时的移动速度乘数。默认值为1。track_target布尔值:为true时即使没有固定感知组件也能追踪目标。默认值为false。require_complete_path布尔值:为true时要求存在通往目标的完整路径。默认值为false。random_stop_interval整数:以1/N的概率中断攻击,N为该值。默认值为0。min_path_time浮点数:重新计算攻击路径的最短基础间隔,单位为秒。默认值为0.2。max_path_time浮点数:重新计算攻击路径的最长基础间隔,单位为秒。默认值为0.55。path_inner_boundary浮点数:距目标小于该距离时追加inner_boundary_time_increase的重算间隔。默认值为16。path_outer_boundary浮点数:距目标大于该距离时追加outer_boundary_time_increase的重算间隔。默认值为32。inner_boundary_time_increase浮点数:目标靠近时追加的重算间隔,单位为秒。默认值为0.25。outer_boundary_time_increase浮点数:目标远离时追加的重算间隔,单位为秒。默认值为0.5。path_fail_time_increase浮点数:寻路失败时追加的重算间隔,单位为秒。默认值为0.75。melee_fov浮点数:感知有效目标时使用的视场角,单位为度。默认值为90。x_max_rotation浮点数:注视目标时俯仰方向的最大转角,单位为度。默认值为30。y_max_head_rotation浮点数:注视目标时水平方向的最大转角,单位为度。默认值为30。on_attackJSON 对象:成功攻击时触发的事件。event字符串:事件 ID。target字符串:事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
on_killJSON 对象:1.21.80+该特性在游戏版本1.21.80+下可用。击杀目标时触发的事件,结构同上。
美西螈(axolotl.json
"minecraft:behavior.melee_box_attack": {
"priority": 4,
"on_attack": { "event": "killed_enemy_event" }
}
minecraft:behavior.mingle
通用使生物与其他同类聚在一起交流,村民使用该行为。
- 参数
- 示例
minecraft:behavior.mingleJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
mingle_partner_type字符串:1.12.0+该特性在游戏版本1.12.0+下可用。可以交流的实体类型,如minecraft:villager_v2。mingle_distance浮点数:1.12.0+该特性在游戏版本1.12.0+下可用。与交流对象保持的距离,单位为方块。默认值为2。duration浮点数:每次交流持续的秒数。默认值为1。cooldown_time浮点数:该行为的冷却秒数。默认值为0。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
村民(villager_v2.json
"minecraft:behavior.mingle": {
"priority": 7,
"cooldown_time": 10,
"duration": 30,
"mingle_distance": 2,
"mingle_partner_type": "minecraft:villager_v2",
"speed_multiplier": 0.5
}
minecraft:behavior.mount_pathing
通用使骑乘中的实体朝目标移动。
另见:minecraft:rideable组件、EntityRideableComponent 类。
- 参数
- 示例
minecraft:behavior.mount_pathingJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
target_dist浮点数:与目标保持的距离,单位为方块。默认值为0。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。track_target布尔值:为true时只要目标有效就持续追击。默认值为false。
骆驼尸壳(camel_husk.json
"minecraft:behavior.mount_pathing": {
"priority": 3,
"target_dist": 0,
"speed_multiplier": 4,
"track_target": true
}
minecraft:behavior.move_around_target
通用使生物在目标周围游走,旋风人使用该行为。
- 参数
- 示例
minecraft:behavior.move_around_targetJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
filtersJSON 对象:允许执行该行为的条件。见实体过滤器。destination_position_rangeJSON 数组:已弃用:1.21.30-26.20该特性已被弃用,只能在游戏版本1.21.30-26.20下使用。落点与目标之间的距离区间写作[最小值, 最大值],单位为方块。默认值为[4, 8]。destination_position_rangeJSON 对象:26.20+该特性在游戏版本26.20+下可用,但该版本对于当前的中国版版本过高。落点与目标之间的距离区间,单位为方块。min浮点数:区间下限。默认值为4。max浮点数:区间上限。默认值为8。
destination_pos_spread_degrees浮点数:1.21.80+该特性在游戏版本1.21.80+下可用。选择落点时的散布角度,单位为度。默认值为90。height_difference_limit浮点数:与目标允许的最大高度差,单位为方块。默认值为10。horizontal_search_distance整数:搜索落点的水平距离,单位为方块。默认值为5。vertical_search_distance整数:搜索落点的垂直距离,单位为方块。默认值为5。movement_speed浮点数:移动时的速度。默认值为0.6。
旋风人(breeze.json
"minecraft:behavior.move_around_target": {
"priority": 3,
"destination_pos_spread_degrees": 360,
"destination_position_range": { "min": 4.0, "max": 8.0 },
"filters": {
"all_of": [
{ "test": "on_ground", "value": true }
]
}
}
上例的filters在原版中还包含距离判断,此处从简。
minecraft:behavior.move_indoors
通用使生物向室内移动,村民在夜晚使用该行为。
- 参数
- 示例
minecraft:behavior.move_indoorsJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
speed_multiplier浮点数:移动时的速度乘数。默认值为0.8。timeout_cooldown浮点数:1.11.0+该特性在游戏版本1.11.0+下可用。寻路失败后再次使用该行为前的冷却秒数。默认值为8。
村民(villager.json
"minecraft:behavior.move_indoors": {
"priority": 4,
"speed_multiplier": 0.8
}
minecraft:behavior.move_outdoors
通用使生物向室外移动。
- 参数
- 示例
minecraft:behavior.move_outdoorsJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
search_range整数:搜索室外位置的水平范围,单位为方块。默认值为15。search_height整数:搜索室外位置的垂直范围,单位为方块。默认值为5。search_count整数:搜索失败前尝试的随机位置数量。默认值为10。goal_radius浮点数:距目标点多近即视为到达,单位为方块。默认值为2。speed_multiplier浮点数:移动时的速度乘数。默认值为0.5。timeout_cooldown浮点数:寻路失败后再次使用该行为前的冷却秒数。默认值为8。
村民(villager.json
"minecraft:behavior.move_outdoors": {
"priority": 2,
"speed_multiplier": 0.8,
"timeout_cooldown": 8
}
minecraft:behavior.move_through_village
通用使生物在村庄中来回走动。
- 参数
- 示例
minecraft:behavior.move_through_villageJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
only_at_night布尔值:为true时只在夜间走动。默认值为false。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
schema 把该组件标注为仅村民可用,但 26.60 的原版包中只有铁傀儡使用,此处按原版书写。
铁傀儡(iron_golem.json
"minecraft:behavior.move_through_village": {
"priority": 3,
"only_at_night": true,
"speed_multiplier": 0.6
}
minecraft:behavior.move_to_block
通用使生物移动到指定的方块处并停留一段时间。
- 参数
- 示例
minecraft:behavior.move_to_blockJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
target_blocksJSON 数组:要前往的方块列表。- 字符串:方块 ID。
target_block_filtersJSON 对象:方块需满足的条件。见实体过滤器。target_selection_method字符串:方块的选择方式。可选值为nearest(最近)与random(随机)。默认值为nearest。target_offsetJSON 数组:目标位置相对方块的偏移,写作[x, y, z]。默认值为[0, 0, 0]。search_range整数:搜索方块的距离,单位为方块。默认值为0。search_height整数:搜索方块的高度,单位为方块。默认值为1。goal_radius浮点数:距目标多近即视为到达,单位为方块。默认值为0.5。stay_duration浮点数:到达后需要停留的刻数。默认值为0。start_chance浮点数:1.18.10+该特性在游戏版本1.18.10+下可用。每次尝试时启动该行为的概率。默认值为1。tick_interval整数:尝试执行该行为的平均间隔,单位为刻。默认值为20。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。on_reachJSON 数组:到达方块时触发的事件列表。- JSON 对象:一个事件。
event字符串:事件 ID。target字符串:事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
on_stay_completedJSON 数组:在方块处停留完成后触发的事件列表,结构同上。
蜜蜂(bee.json
"minecraft:behavior.move_to_block": {
"priority": 10,
"tick_interval": 1,
"start_chance": 0.5,
"search_range": 6,
"search_height": 4,
"goal_radius": 1.0,
"stay_duration": 20.0,
"target_selection_method": "random",
"target_offset": [ 0, 0.25, 0 ]
}
minecraft:behavior.move_to_land
通用使生物离开水域移动到陆地上,青蛙使用该行为。
- 参数
- 示例
minecraft:behavior.move_to_landJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
search_range整数:搜索陆地的水平距离,单位为方块。默认值为0。search_height整数:搜索陆地的垂直距离,单位为方块。默认值为1。search_count整数:1.8.0+该特性在游戏版本1.8.0+下可用。每刻随机检查的方块数量。默认值为10。goal_radius浮点数:距目标点多近即视为到达,单位为方块。默认值为0.5。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
青蛙(frog.json
"minecraft:behavior.move_to_land": {
"priority": 6,
"goal_radius": 2,
"search_count": 80,
"search_height": 8,
"search_range": 30
}
minecraft:behavior.move_to_lava
通用定义实体在陆地上时返回熔岩的行为。
- 参数
- 示例
minecraft:behavior.move_to_lavaJSON 对象:根对象。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
priority整数:行为优先级,数值越小越优先。默认值为0。goal_radius浮点数:判定到达目标的范围,单位为方块。默认值为0.5。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。search_count整数:每刻随机选取的方块数量。默认值为10。search_height整数:搜索熔岩的垂直范围,单位为方块。默认值为1。search_range整数:搜索熔岩的水平范围,单位为方块。默认值为0。
原版未使用该组件,以下按默认值书写:
"minecraft:behavior.move_to_lava": {
"priority": 0,
"search_range": 16,
"search_height": 8,
"speed_multiplier": 1.0
}
minecraft:behavior.move_to_liquid
通用使生物寻找并移动到液体方块处。
- 参数
- 示例
minecraft:behavior.move_to_liquidJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
material_type字符串:要寻找的液体材质。可选值为any(任意液体)、water、lava。默认值为any。search_range整数:搜索液体的水平距离,单位为方块。默认值为0。search_height整数:搜索液体的垂直距离,单位为方块。默认值为1。search_count整数:每刻随机检查的方块数量。默认值为10。goal_radius浮点数:距目标点多近即视为到达,单位为方块。默认值为0.5。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
原版暂无使用该行为的实体,以下为最小写法:
"minecraft:behavior.move_to_liquid": {
"priority": 4,
"material_type": "lava",
"search_range": 16,
"search_height": 5,
"search_count": 10
}
minecraft:behavior.move_to_poi
通用使生物移动到指定类型的兴趣点处。
- 参数
- 示例
minecraft:behavior.move_to_poiJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
poi_type字符串:要寻找的兴趣点类型。可选值为bed(床)、meeting_area(集会点)、jobsite(工作站点)。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
原版暂无单独声明该行为的实体,以下为最小写法:
"minecraft:behavior.move_to_poi": {
"priority": 5,
"poi_type": "bed"
}
minecraft:behavior.move_to_random_block
通用使生物移动到附近随机的方块位置。
- 参数
- 示例
minecraft:behavior.move_to_random_blockJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
block_distance浮点数:目标方块与实体的距离上限,单位为方块。默认值为16。within_radius浮点数:距目标方块多近即视为到达,单位为方块。默认值为0。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
掠夺者(pillager.json
"minecraft:behavior.move_to_random_block": {
"priority": 6,
"block_distance": 512,
"speed_multiplier": 0.55,
"within_radius": 8
}
minecraft:behavior.move_to_village
通用使生物移动到最近的村庄。
- 参数
- 示例
minecraft:behavior.move_to_villageJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
search_range整数:1.13.0+该特性在游戏版本1.13.0+下可用。搜索村庄的距离,单位为方块;小于等于0时找最近的村庄。默认值为0。goal_radius浮点数:距目标点多近即视为到达,单位为方块。默认值为1.5。cooldown_time浮点数:1.13.0+该特性在游戏版本1.13.0+下可用。该行为的冷却秒数。默认值为8。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
唤魔者(evocation_illager.json
"minecraft:behavior.move_to_village": {
"priority": 6,
"speed_multiplier": 0.7
}
minecraft:behavior.move_to_water
通用使生物寻找并移动到水域。
- 参数
- 示例
minecraft:behavior.move_to_waterJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
search_range整数:搜索水域的水平距离,单位为方块。默认值为0。search_height整数:搜索水域的垂直距离,单位为方块。默认值为1。search_count整数:1.8.0+该特性在游戏版本1.8.0+下可用。每刻随机检查的方块数量。默认值为10。goal_radius浮点数:距目标点多近即视为到达,单位为方块。默认值为0.5。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
美西螈(axolotl.json
"minecraft:behavior.move_to_water": {
"priority": 6,
"search_range": 16,
"search_height": 5,
"search_count": 1,
"goal_radius": 0.1
}
minecraft:behavior.move_towards_dwelling_restriction
通用使生物回到其居住地的限制范围内。
- 参数
- 示例
minecraft:behavior.move_towards_dwelling_restrictionJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
speed_multiplier浮点数:移动时的速度乘数。默认值为1。
猫(cat.json
"minecraft:behavior.move_towards_dwelling_restriction": {
"priority": 7
}
minecraft:behavior.move_towards_home_restriction
通用使生物回到其「家」的限制范围内。
- 参数
- 示例
minecraft:behavior.move_towards_home_restrictionJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
speed_multiplier浮点数:移动时的速度乘数。默认值为1。
蜜蜂(bee.json
"minecraft:behavior.move_towards_home_restriction": {
"priority": 9
}
minecraft:behavior.move_towards_restriction
通用使生物回到行为限制的范围内。
- 参数
- 示例
minecraft:behavior.move_towards_restrictionJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
speed_multiplier浮点数:移动时的速度乘数。默认值为1。
备注:官方 schema 未收录该组件,参数按同类限制类行为整理。
原版暂无使用该行为的实体,以下为最小写法:
"minecraft:behavior.move_towards_restriction": {
"priority": 5
}
minecraft:behavior.move_towards_target
通用使生物朝其攻击目标靠近。
- 参数
- 示例
minecraft:behavior.move_towards_targetJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
within_radius浮点数:希望与目标保持的距离,单位为方块。默认值为0。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
铁傀儡(iron_golem.json
"minecraft:behavior.move_towards_target": {
"priority": 2,
"speed_multiplier": 0.9,
"within_radius": 32
}
minecraft:behavior.nap
通用使生物打盹,狐狸使用该行为。
- 参数
- 示例
minecraft:behavior.napJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
can_nap_filtersJSON 对象:允许打盹的条件。见实体过滤器。wake_mob_exceptionsJSON 对象:即使靠近也不会吵醒该实体的生物条件。见实体过滤器。cooldown_min浮点数:再次打盹前的最短等待秒数。默认值为0。cooldown_max浮点数:再次打盹前的最长等待秒数。默认值为0。mob_detect_dist浮点数:检测附近生物的水平距离,单位为方块。默认值为6。mob_detect_height浮点数:检测附近生物的垂直距离,单位为方块。默认值为6。
狐狸(fox.json
"minecraft:behavior.nap": {
"priority": 8,
"cooldown_min": 2.0,
"cooldown_max": 7.0,
"mob_detect_dist": 12.0,
"mob_detect_height": 6.0,
"can_nap_filters": {
"all_of": [
{ "test": "in_water", "value": false },
{ "test": "in_lava", "value": false }
]
}
}
minecraft:behavior.nearest_attackable_target
通用使生物把最近的可攻击实体设为目标。
- 参数
- 示例
minecraft:behavior.nearest_attackable_targetJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
entity_typesJSON 数组:可作为目标的实体条件列表。- JSON 对象:一项条件。
filtersJSON 对象:实体需满足的条件。见实体过滤器。max_dist浮点数:该类型目标的最大距离,单位为方块。max_height浮点数:该类实体可作为目标的高度上限,-1表示不限制。默认值为-1。max_flee浮点数:逃离该类实体时距其多远停止,单位为方块。默认值为10。cooldown整数:再次选中该类实体前需要等待的秒数。默认值为0。priority整数:该实体类型在候选列表中的优先级,数值越小越优先。默认值为0。must_see布尔值:为true时该类实体必须可见才会被选中。must_see_forget_duration整数:看不见该类实体后多少秒放弃,单位为秒。默认值为3。check_if_outnumbered布尔值:为true时检查该类实体的数量是否占优。默认值为false。reevaluate_description布尔值:为true时,对方一旦不再满足条件就停止将其作为目标。默认值为false。walk_speed_multiplier浮点数:接近该目标时的行走速度乘数。sprint_speed_multiplier浮点数:接近该目标时的疾跑速度乘数。
must_see布尔值:为true时只把视野内的实体作为目标。默认值为false。must_reach布尔值:为true时要求存在通往目标的路径。默认值为false。must_see_forget_duration浮点数:目标离开视野多少秒后放弃。默认值为3。within_radius浮点数:距目标的最大跟随距离,单位为方块。默认值为0。persist_time浮点数:1.6.0+该特性在游戏版本1.6.0+下可用。目标不可见后仍继续攻击的秒数。默认值为0。reselect_targets布尔值:为true时允许改用更近的目标。默认值为false。attack_owner布尔值:1.15.0+该特性在游戏版本1.15.0+下可用。为true时可以攻击自己的主人。默认值为false。set_persistent布尔值:1.16.0+该特性在游戏版本1.16.0+下可用。为true时锁定玩家为目标后转为持久实体。默认值为false。attack_intervalJSON 数组:已弃用:1.21.130-26.0该特性已被弃用,只能在游戏版本1.21.130-26.0下使用。两次搜索目标之间的秒数区间,写作[最小值, 最大值]。默认值为[0, 0]。attack_intervalJSON 对象:26.0+该特性在游戏版本26.0+下可用,但该版本对于当前的中国版版本过高。两次搜索目标之间的秒数区间。默认值为{"min": 0, "max": 0}。min浮点数:区间下限。默认值为0。max浮点数:区间上限。默认值为0。
scan_interval整数:1.6.0+该特性在游戏版本1.6.0+下可用。未设置attack_interval时的扫描间隔,单位为刻。默认值为10。target_search_height浮点数:1.6.0+该特性在游戏版本1.6.0+下可用。搜索目标的垂直距离,-1表示不限。默认值为-1。target_invisible_multiplier浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。目标护甲覆盖率对该距离判定的修正系数。默认值为0.7。target_sneak_visibility_multiplier浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。目标潜行时距离判定的修正系数。默认值为0.8。target_acquisition_probability浮点数:1.21.130+该特性在游戏版本1.21.130+下可用。接受找到的目标的概率,取值0.0-1.0。默认值为1。
美西螈(axolotl.json
"minecraft:behavior.nearest_attackable_target": {
"priority": 3,
"must_see": true,
"reselect_targets": true,
"within_radius": 20.0,
"must_see_forget_duration": 17.0,
"entity_types": [
{
"filters": {
"all_of": [
{ "test": "in_water", "subject": "other", "value": true }
]
},
"max_dist": 20
}
]
}
minecraft:behavior.nearest_prioritized_attackable_target
通用使生物按优先级选择可攻击的目标。
- 参数
- 示例
minecraft:behavior.nearest_prioritized_attackable_targetJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
entity_typesJSON 数组:可作为目标的实体条件列表,各项可带priority。- JSON 对象:一项条件。
filtersJSON 对象:实体需满足的条件。见实体过滤器。max_dist浮点数:该类型目标的最大距离,单位为方块。max_height浮点数:该类实体可作为目标的高度上限,-1表示不限制。默认值为-1。max_flee浮点数:逃离该类实体时距其多远停止,单位为方块。默认值为10。cooldown整数:1.20.0+该特性在游戏版本1.20.0+下可用。再次选中该类实体前需要等待的秒数。默认值为0。priority整数:该实体类型在候选列表中的优先级,数值越小越优先。默认值为0。must_see布尔值:为true时该类实体必须可见才会被选中。must_see_forget_duration整数:看不见该类实体后多少秒放弃,单位为秒。默认值为3。check_if_outnumbered布尔值:为true时检查该类实体的数量是否占优。默认值为false。reevaluate_description布尔值:为true时,对方一旦不再满足条件就停止将其作为目标。默认值为false。walk_speed_multiplier浮点数:接近该目标时的行走速度乘数。sprint_speed_multiplier浮点数:接近该目标时的疾跑速度乘数。
must_see布尔值:为true时只把视野内的实体作为目标。默认值为false。must_reach布尔值:为true时只把可寻路到达的实体作为目标。默认值为false。must_see_forget_duration浮点数:目标离开视野多少秒后放弃。默认值为3。within_radius浮点数:距目标的最大跟随距离,单位为方块。默认值为0。persist_time浮点数:目标不可见后仍继续攻击的秒数。默认值为0。reselect_targets布尔值:为true时允许改用更近的目标。默认值为false。hurt_owner布尔值:为true时也会攻击伤害主人的实体。默认值为false。set_persistent布尔值:1.16.0+该特性在游戏版本1.16.0+下可用。为true时锁定玩家为目标后转为持久实体。默认值为false。attack_interval整数:选择目标的间隔秒数。默认值为0。scan_interval整数:扫描目标的间隔,单位为刻。默认值为10。target_search_height浮点数:搜索目标的垂直距离,-1表示不限。默认值为-1。
狐狸(fox.json
"minecraft:behavior.nearest_prioritized_attackable_target": {
"priority": 6,
"attack_interval": 2,
"reselect_targets": true,
"target_search_height": 5,
"entity_types": [
{
"filters": { "test": "is_family", "subject": "other", "value": "rabbit" },
"max_dist": 12,
"priority": 0
},
{
"filters": { "test": "is_family", "subject": "other", "value": "chicken" },
"max_dist": 12,
"priority": 1
}
]
}
minecraft:behavior.ocelot_sit_on_block
通用使生物坐到当前所在的方块上。
- 参数
- 示例
minecraft:behavior.ocelot_sit_on_blockJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
猫(cat.json
"minecraft:behavior.ocelot_sit_on_block": {
"priority": 7,
"speed_multiplier": 1.0
}
minecraft:behavior.ocelotattack
通用使生物以潜行接近再冲刺的方式发动攻击,豹猫与猫使用该行为。
- 参数
- 示例
minecraft:behavior.ocelotattackJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
cooldown_time浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。两次攻击之间的秒数。默认值为1。max_distance浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。可使用该行为的最大距离,单位为方块。默认值为15。max_sneak_range浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。开始潜行的最大距离,单位为方块。默认值为15。max_sprint_range浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。开始冲刺的最大距离,单位为方块。默认值为4。reach_multiplier浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。以碰撞箱尺寸为基础计算攻击距离的乘数。默认值为2。sneak_speed_multiplier浮点数:潜行时的速度乘数。默认值为0.6。sprint_speed_multiplier浮点数:冲刺时的速度乘数。默认值为1.33。walk_speed_multiplier浮点数:既不潜行也不冲刺时的速度乘数。默认值为0.8。x_max_rotation浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。注视目标时俯仰方向的最大转角,单位为度。默认值为30。y_max_head_rotation浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。注视目标时水平方向的最大转角,单位为度。默认值为30。
猫(cat.json
"minecraft:behavior.ocelotattack": {
"priority": 4,
"cooldown_time": 1.0,
"max_distance": 15.0,
"max_sneak_range": 15.0,
"max_sprint_range": 4.0,
"reach_multiplier": 2.0
}
minecraft:behavior.offer_flower
通用使生物向附近的另一只生物献花,铁傀儡使用该行为。
- 参数
- 示例
minecraft:behavior.offer_flowerJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
filtersJSON 对象:1.19.50+该特性在游戏版本1.19.50+下可用。允许献花的条件。见实体过滤器。chance_to_start浮点数:1.19.50+该特性在游戏版本1.19.50+下可用。每刻开始献花的概率。默认值为0.000125。max_offer_flower_duration浮点数:1.19.50+该特性在游戏版本1.19.50+下可用。献花持续的秒数。默认值为20。search_areaJSON 数组:1.19.50+该特性在游戏版本1.19.50+下可用。搜索献花对象的范围,写作[x, y, z]。默认值为[6, 2, 6]。max_rotation_x浮点数:1.19.50+该特性在游戏版本1.19.50+下可用。俯仰方向的最大转角,单位为度。默认值为30。max_head_rotation_y浮点数:1.19.50+该特性在游戏版本1.19.50+下可用。水平方向的最大转角,单位为度。默认值为30。
铁傀儡(iron_golem.json
"minecraft:behavior.offer_flower": {
"priority": 5,
"filters": { "test": "is_daytime" }
}
minecraft:behavior.open_door
通用使生物能够开门并穿过。
- 参数
- 示例
minecraft:behavior.open_doorJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
close_door_after布尔值:为true时通过后会关门。默认值为true。
备注:该行为要求实体的寻路组件允许开门(
can_open_doors为true),否则生物不会尝试开门。
村民(villager.json
"minecraft:behavior.open_door": {
"priority": 6,
"close_door_after": true
}
minecraft:behavior.owner_hurt_by_target
通用使生物在主人被攻击时把攻击者设为目标。
- 参数
- 示例
minecraft:behavior.owner_hurt_by_targetJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
entity_typesJSON 数组:可作为目标的实体条件列表。- JSON 对象:一项条件。
filtersJSON 对象:实体需满足的条件。见实体过滤器。max_dist浮点数:该类型目标的最大距离,单位为方块。max_height浮点数:该类实体可作为目标的高度上限,-1表示不限制。默认值为-1。max_flee浮点数:逃离该类实体时距其多远停止,单位为方块。默认值为10。cooldown整数:再次选中该类实体前需要等待的秒数。默认值为0。priority整数:该实体类型在候选列表中的优先级,数值越小越优先。默认值为0。must_see布尔值:为true时该类实体必须可见才会被选中。must_see_forget_duration整数:看不见该类实体后多少秒放弃,单位为秒。默认值为3。check_if_outnumbered布尔值:为true时检查该类实体的数量是否占优。默认值为false。reevaluate_description布尔值:为true时,对方一旦不再满足条件就停止将其作为目标。默认值为false。walk_speed_multiplier浮点数:接近该类实体时的行走速度乘数。默认值为1。sprint_speed_multiplier浮点数:接近该类实体时的疾跑速度乘数。默认值为1。
狼(wolf.json
"minecraft:behavior.owner_hurt_by_target": {
"priority": 1
}
minecraft:behavior.owner_hurt_target
通用使生物在主人攻击某实体时把该实体设为目标。
- 参数
- 示例
minecraft:behavior.owner_hurt_targetJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
entity_typesJSON 数组:可作为目标的实体条件列表。- JSON 对象:一项条件。
filtersJSON 对象:实体需满足的条件。见实体过滤器。max_dist浮点数:该类型目标的最大距离,单位为方块。max_height浮点数:该类实体可作为目标的高度上限,-1表示不限制。默认值为-1。max_flee浮点数:逃离该类实体时距其多远停止,单位为方块。默认值为10。cooldown整数:再次选中该类实体前需要等待的秒数。默认值为0。priority整数:该实体类型在候选列表中的优先级,数值越小越优先。默认值为0。must_see布尔值:为true时该类实体必须可见才会被选中。must_see_forget_duration整数:看不见该类实体后多少秒放弃,单位为秒。默认值为3。check_if_outnumbered布尔值:为true时检查该类实体的数量是否占优。默认值为false。reevaluate_description布尔值:为true时,对方一旦不再满足条件就停止将其作为目标。默认值为false。walk_speed_multiplier浮点数:接近该类实体时的行走速度乘数。默认值为1。sprint_speed_multiplier浮点数:接近该类实体时的疾跑速度乘数。默认值为1。
狼(wolf.json
"minecraft:behavior.owner_hurt_target": {
"priority": 2
}
minecraft:behavior.panic
通用使生物受到伤害后惊慌逃跑。26.60起生物被困住时不再每刻反复停止与启动该意向。
- 参数
- 示例
minecraft:behavior.panicJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
damage_sourcesJSON 数组:1.16.0+该特性在游戏版本1.16.0+下可用。会引发惊慌的伤害来源类型列表,如all。- 字符串:伤害来源类型。
ignore_mob_damage布尔值:1.9.0+该特性在游戏版本1.9.0+下可用。为true时被其他生物伤害不会惊慌。默认值为false。force布尔值:为true时只有找不到玩家才会停止惊慌。默认值为false。prefer_water布尔值:1.5.0+该特性在游戏版本1.5.0+下可用。为true时优先逃向水中。默认值为false。panic_sound字符串:惊慌时播放的音效事件名。sound_intervalJSON 数组:两次音效之间随机等待的刻数区间。speed_multiplier浮点数:惊慌时的移动速度乘数。默认值为1。
悦灵(allay.json
"minecraft:behavior.panic": {
"priority": 1,
"speed_multiplier": 2.0
}
minecraft:behavior.pet_sleep_with_owner
通用使已驯服的宠物睡在主人身边。
- 参数
- 示例
minecraft:behavior.pet_sleep_with_ownerJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
search_range整数:搜索主人的距离,单位为方块。默认值为0。search_height整数:允许与主人相隔的高度,单位为方块。默认值为1。goal_radius浮点数:距主人多近即视为到达,单位为方块。默认值为0.5。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
猫(cat.json
"minecraft:behavior.pet_sleep_with_owner": {
"priority": 2,
"speed_multiplier": 1.2,
"search_height": 10,
"goal_radius": 1.0
}
minecraft:behavior.pickup_items
通用使生物拾取地面上的物品。
- 参数
- 示例
minecraft:behavior.pickup_itemsJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
can_pickup_any_item布尔值:1.16.0+该特性在游戏版本1.16.0+下可用。为true时任何物品都会拾取。默认值为false。can_pickup_to_hand_or_equipment布尔值:1.16.0+该特性在游戏版本1.16.0+下可用。为true时可以把物品放到手上或装备栏。默认值为true。pickup_based_on_chance布尔值:1.16.0+该特性在游戏版本1.16.0+下可用。为true时按难度决定是否拾取。默认值为false。pickup_same_items_as_in_hand布尔值:为true时只拾取与手中相同的物品。默认值为false。stop_if_holding_item布尔值:为true时手中已有物品就不再拾取。默认值为false。track_target布尔值:为true时持续追逐有效目标。默认值为false。excluded_itemsJSON 数组:1.17.30+该特性在游戏版本1.17.30+下可用。不会拾取的物品列表。- 字符串:物品 ID。
max_dist整数:搜索物品的最大距离,单位为方块。默认值为1。search_height整数:搜索物品的垂直距离,单位为方块。默认值为1。cooldown_after_being_attacked整数:被攻击后多少秒内停止拾取。默认值为0。goal_radius浮点数:距物品多近即视为到达,单位为方块。默认值为0.5。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。on_pickup_item_startJSON 对象:26.20+该特性在游戏版本26.20+下可用,但该版本对于当前的中国版版本过高。开始走向物品时触发的事件。event字符串:事件 ID。target字符串:事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
on_pickup_item_endJSON 对象:26.20+该特性在游戏版本26.20+下可用,但该版本对于当前的中国版版本过高。拾取完成或放弃时触发的事件,结构同上。
悦灵(allay.json
"minecraft:behavior.pickup_items": {
"priority": 2,
"max_dist": 32,
"search_height": 32,
"goal_radius": 2.2,
"can_pickup_any_item": false,
"can_pickup_to_hand_or_equipment": false,
"pickup_same_items_as_in_hand": true
}
minecraft:behavior.place_block
通用使生物放置携带的方块,铜傀儡使用该行为。
- 参数
- 示例
minecraft:behavior.place_blockJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
placeable_carried_blocksJSON 数组:允许从身上放置的方块列表,元素写作{ "block": 方块描述 }。randomly_placeable_blocksJSON 数组:可随机放置的方块列表,元素含block、filter与weight。can_placeJSON 对象:允许放置的条件。见实体过滤器。chance浮点数:每刻尝试放置的概率。默认值为1。affected_by_griefing_rule布尔值:为true时受「允许破坏方块」游戏规则影响。默认值为true。xz_rangeJSON 数组:尝试放置的水平范围,写作[最小值, 最大值]。默认值为[-2, 2]。y_rangeJSON 数组:尝试放置的垂直范围,写作[最小值, 最大值]。默认值为[0, 3]。on_placeJSON 对象:成功放置时触发的事件。event字符串:事件 ID。target字符串:事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
铜傀儡(copper_golem.json
"minecraft:behavior.place_block": {
"priority": 4,
"affected_by_griefing_rule": false,
"randomly_placeable_blocks": [
{
"block": {
"name": "minecraft:oxidized_copper_golem_statue",
"states": { "minecraft:cardinal_direction": "north" }
},
"filter": { "test": "is_daytime", "value": true }
}
]
}
上例的randomly_placeable_blocks在原版中按四个朝向各列一项,此处只保留一项。
minecraft:behavior.play
通用使生物寻找同伴一起玩耍,村民的幼年个体使用该行为。
- 参数
- 示例
minecraft:behavior.playJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
friend_typesJSON 数组:1.19.40+该特性在游戏版本1.19.40+下可用。可作为玩伴的实体条件列表。- JSON 对象:一项条件。
filtersJSON 对象:实体需满足的条件。见实体过滤器。max_dist浮点数:该类实体可作为目标的最大距离,单位为方块。默认值为16。max_height浮点数:该类实体可作为目标的高度上限,-1表示不限制。默认值为-1。max_flee浮点数:逃离该类实体时距其多远停止,单位为方块。默认值为10。cooldown整数:再次选中该类实体前需要等待的秒数。默认值为0。priority整数:该实体类型在候选列表中的优先级,数值越小越优先。默认值为0。must_see布尔值:为true时该类实体必须可见才会被选中。must_see_forget_duration整数:看不见该类实体后多少秒放弃,单位为秒。默认值为3。check_if_outnumbered布尔值:为true时检查该类实体的数量是否占优。默认值为false。reevaluate_description布尔值:为true时,对方一旦不再满足条件就停止将其作为目标。默认值为false。walk_speed_multiplier浮点数:接近该类实体时的行走速度乘数。默认值为1。sprint_speed_multiplier浮点数:接近该类实体时的疾跑速度乘数。默认值为1。
chance_to_start浮点数:1.19.40+该特性在游戏版本1.19.40+下可用。每刻开始玩耍的概率。默认值为0.0025。friend_search_areaJSON 数组:1.19.40+该特性在游戏版本1.19.40+下可用。搜索玩伴的范围,写作[x, y, z]。默认值为[6, 3, 6]。follow_distance整数:1.19.40+该特性在游戏版本1.19.40+下可用。与玩伴保持的距离,单位为方块。默认值为2。max_play_duration_seconds浮点数:1.19.40+该特性在游戏版本1.19.40+下可用。一次玩耍持续的秒数。默认值为50。random_pos_search_range整数:1.19.40+该特性在游戏版本1.19.40+下可用。在地面上搜索随机位置的距离,单位为方块。默认值为16。random_pos_search_height整数:1.19.40+该特性在游戏版本1.19.40+下可用。搜索随机位置的高度,单位为方块。默认值为3。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
备注:
friend_search_area的类型在文档中标的与示例不符,此处按原版的三元数组书写。
村民(villager.json
"minecraft:behavior.play": {
"priority": 8,
"speed_multiplier": 0.32
}
minecraft:behavior.play_dead
通用使实体在受伤后装死,以避免被攻击者继续追击。
- 参数
- 示例
minecraft:behavior.play_deadJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
apply_regeneration布尔值:装死期间是否获得生命恢复效果。默认值为false。damage_sourcesJSON 数组:会触发装死的伤害类型。可选值为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。默认值为空数组。- 字符串:一个伤害类型。
duration浮点数:装死持续的时间,单位为秒。默认值为1。filtersJSON 对象:装死需满足的额外条件。实体需满足的条件。见实体过滤器。force_below_health整数:生命值低于该值时受伤必定装死。默认值为0。random_damage_rangeJSON 对象:随机附加伤害的区间,用于让装死显得更真实。min整数:区间下限。默认值为0。max整数:区间上限。默认值为0。
random_start_chance浮点数:受伤时装死的概率。默认值为1。
美西螈(axolotl.json
"minecraft:behavior.play_dead": {
"priority": 0,
"duration": 10,
"force_below_health": 8,
"random_start_chance": 0.33,
"random_damage_range": {
"min": 0,
"max": 2
},
"damage_sources": [
"contact",
"entity_attack",
"entity_explosion",
"magic",
"projectile",
"thorns",
"wither"
],
"apply_regeneration": true,
"filters": {
"test": "in_water",
"operator": "==",
"value": true
}
}
minecraft:behavior.player_ride_tamed
通用使玩家可以骑乘已驯服的该实体。
另见:minecraft:rideable组件、EntityRideableComponent 类。
- 参数
- 示例
minecraft:behavior.player_ride_tamedJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
骆驼(camel.json
"minecraft:behavior.player_ride_tamed": {}
minecraft:behavior.raid_garden
通用使实体前往农田啃食或掠夺指定方块,直到吃饱为止。
- 参数
- 示例
minecraft:behavior.raid_gardenJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
blocksJSON 数组:实体前去啃食的方块列表。默认值为空数组。- 字符串:方块 ID。
eat_delay整数:两次啃食之间的间隔,单位为秒。默认值为2。full_delay整数:吃饱后再次产生进食欲望所需的冷却,单位为秒。默认值为100。goal_radius浮点数:距目标多近即视为到达,单位为方块。默认值为0.5。initial_eat_delay整数:1.13.0+该特性在游戏版本1.13.0+下可用。到达目标后开始啃食前的等待时间,单位为秒。默认值为0。max_to_eat整数:一次最多啃食的方块数量,小于等于0表示不设上限。默认值为6。search_height整数:搜索作物时的垂直范围,单位为方块。默认值为1。search_range整数:搜索作物时的水平范围,单位为方块。默认值为0。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
备注:
max_to_eat设为0表示不限制啃食数量,狐狸即如此配置。
狐狸(fox.json
"minecraft:behavior.raid_garden": {
"priority": 12,
"blocks": [
"minecraft:sweet_berry_bush",
"minecraft:cave_vines_head_with_berries",
"minecraft:cave_vines_body_with_berries"
],
"speed_multiplier": 1.2,
"search_range": 12,
"search_height": 2,
"goal_radius": 0.8,
"max_to_eat": 0,
"initial_eat_delay": 2
}
minecraft:behavior.ram_attack
通用使实体通过助跑冲撞的方式攻击目标。
- 参数
- 示例
minecraft:behavior.ram_attackJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
baby_knockback_modifier浮点数:幼年个体击退强度的修正系数。默认值为0.3333333。cooldown_rangeJSON 对象:两次冲撞之间的冷却区间,单位为秒。min浮点数:区间下限。默认值为0。max浮点数:区间上限。默认值为0。
knockback_force浮点数:冲撞造成的击退力度。默认值为5。knockback_height浮点数:冲撞造成的击退垂直分量。默认值为0.1。min_ram_distance整数:可以发起冲撞的最小距离,单位为方块。默认值为4。on_startJSON 数组:发起冲撞时触发的事件列表。默认值为空数组。pre_ram_sound字符串:冲锋前播放的声音定义 ID。ram_distance整数:进入冲锋状态的距目标距离,单位为方块。默认值为7。ram_impact_sound字符串:冲撞命中时播放的音效事件名。ram_speed浮点数:冲锋阶段的移动速度。默认值为2。run_speed浮点数:助跑阶段的移动速度。默认值为1。
备注:原版山羊把
pre_ram_sound与ram_impact_sound分别写成pre_ram与ram_impact,对应sound_definitions.json中的声音定义。
山羊(goat.json
"minecraft:behavior.ram_attack": {
"priority": 5,
"run_speed": 0.7,
"ram_speed": 1.8,
"min_ram_distance": 4,
"ram_distance": 7,
"knockback_force": 2.5,
"knockback_height": 0.04,
"pre_ram_sound": "pre_ram",
"ram_impact_sound": "ram_impact",
"cooldown_range": {
"min": 30,
"max": 300
},
"on_start": [
{
"event": "start_event",
"target": "self"
}
]
}
minecraft:behavior.random_breach
通用使水生生物随机浮出水面换气。
- 参数
- 示例
minecraft:behavior.random_breachJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
cooldown_time浮点数:两次浮出水面之间的等待时间,单位为秒。默认值为0。interval整数:每刻以1/interval的概率触发该行为。默认值为120。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。xz_dist整数:水平方向上搜索目标位置的距离,单位为方块,至少为1。默认值为10。y_dist整数:垂直方向上搜索目标位置的距离,单位为方块,至少为1。默认值为7。
海豚(dolphin.json
"minecraft:behavior.random_breach": {
"priority": 6,
"interval": 50,
"xz_dist": 6,
"cooldown_time": 2.0
}
minecraft:behavior.random_fly
通用使实体随机飞行。
- 参数
- 示例
minecraft:behavior.random_flyJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
can_land_on_trees布尔值:为true时允许降落在树上而非地面。默认值为true。speed_multiplier浮点数:1.21.0+该特性在游戏版本1.21.0+下可用。执行该行为时的移动速度乘数。默认值为1。xz_dist整数:水平方向上搜索目标位置的距离,单位为方块,至少为1。默认值为10。y_dist整数:垂直方向上搜索目标位置的距离,单位为方块,至少为1。默认值为7。
备注:原版鹦鹉还写了
avoid_damage_blocks与y_offset两个参数,均未被 schema 收录,行为未见于官方文档。
鹦鹉(parrot.json
"minecraft:behavior.random_fly": {
"priority": 3,
"avoid_damage_blocks": true,
"can_land_on_trees": true,
"y_offset": 0,
"speed_multiplier": 1.0,
"xz_dist": 15,
"y_dist": 1
}
minecraft:behavior.random_hover
通用使实体在贴近地面的高度上随机悬浮移动。
- 参数
- 示例
minecraft:behavior.random_hoverJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
hover_heightJSON 对象:1.18.10+该特性在游戏版本1.18.10+下可用。悬浮高度区间,单位为方块。min整数:区间下限。默认值为0。max整数:区间上限。默认值为0。
interval整数:每刻以1/interval的概率触发该行为。默认值为120。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。xz_dist整数:水平方向上搜索目标位置的距离,单位为方块,至少为1。默认值为10。y_dist整数:垂直方向上搜索目标位置的距离,单位为方块,至少为1。默认值为7。y_offset浮点数:在选定的目标位置基础上额外偏移的高度,单位为方块。默认值为0。
备注:
hover_height在 schema 里是含min/max的对象,原版写成[1, 4]这样的二元数组,两种写法都能解析。
悦灵(allay.json
"minecraft:behavior.random_hover": {
"hover_height": [1, 4],
"y_dist": 8,
"interval": 1,
"xz_dist": 8,
"priority": 9,
"y_offset": -1
}
minecraft:behavior.random_look_around
通用使实体随机环顾四周。
- 参数
- 示例
minecraft:behavior.random_look_aroundJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
look_timeJSON 对象:每次注视的持续时间区间,单位为秒。min整数:区间下限。默认值为2。max整数:区间上限。默认值为4。
max_angle_of_view_horizontal浮点数:1.19.50+该特性在游戏版本1.19.50+下可用。相对初始朝向,向右可转的最大角度,单位为度。默认值为180。min_angle_of_view_horizontal浮点数:1.19.50+该特性在游戏版本1.19.50+下可用。相对初始朝向,向左可转的最大角度,单位为度。默认值为-180。probability浮点数:触发该行为的概率。默认值为0.02。
悦灵(allay.json
"minecraft:behavior.random_look_around": {
"priority": 8
}
minecraft:behavior.random_look_around_and_sit
通用使实体随机坐下并在坐姿下环顾四周。需要有对应的坐下动画才能生效。
- 参数
- 示例
minecraft:behavior.random_look_around_and_sitJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
continue_if_leashed布尔值:1.19.50+该特性在游戏版本1.19.50+下可用。为true时被拴住的实体也会持续执行该行为。默认值为false。continue_sitting_on_reload布尔值:1.20.40+该特性在游戏版本1.20.40+下可用。为true时区块重新加载后保持坐下状态。默认值为false。max_angle_of_view_horizontal浮点数:1.19.50+该特性在游戏版本1.19.50+下可用。相对初始朝向,向右可转的最大角度,单位为度。默认值为180。max_look_count整数:环顾时注视方向数量的上限。默认值为2。max_look_time整数:每个方向注视时间的上限,单位为刻。默认值为40。min_angle_of_view_horizontal浮点数:1.19.50+该特性在游戏版本1.19.50+下可用。相对初始朝向,向左可转的最大角度,单位为度。默认值为-180。min_look_count整数:环顾时注视方向数量的下限。默认值为1。min_look_time整数:每个方向注视时间的下限,单位为刻。默认值为20。probability浮点数:触发该行为的概率。默认值为0.02。random_look_around_cooldown整数:1.19.50+该特性在游戏版本1.19.50+下可用。再次触发前的冷却时间,单位为秒。默认值为0。
骆驼(camel.json
"minecraft:behavior.random_look_around_and_sit": {
"priority": 4,
"continue_if_leashed": true,
"continue_sitting_on_reload": true,
"min_look_count": 2,
"max_look_count": 5,
"min_look_time": 80,
"max_look_time": 100,
"min_angle_of_view_horizontal": -30,
"max_angle_of_view_horizontal": 30,
"random_look_around_cooldown": 5,
"probability": 0.001
}
minecraft:behavior.random_search_and_dig
通用使实体在附近寻找符合条件的方块,前往挖掘并按战利品表产出物品。
- 参数
- 示例
minecraft:behavior.random_search_and_digJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
cooldown_rangeJSON 对象:两次挖掘之间的冷却区间,单位为秒。min浮点数:区间下限。默认值为0。max浮点数:区间上限。默认值为0。
digging_duration_rangeJSON 对象:单次挖掘的持续时间区间,单位为秒。min浮点数:区间下限。默认值为0。max浮点数:区间上限。默认值为0。
find_valid_position_retries整数:在搜索范围内寻找有效目标位置的尝试次数。默认值为5。goal_radius浮点数:距目标多近即视为到达,单位为方块。默认值为1.5。item_table字符串:1.20.40+该特性在游戏版本1.20.40+下可用。产出物品所用的战利品表路径,相对于行为包根目录。on_digging_startJSON 对象:开始挖掘时触发的事件。on_fail_during_diggingJSON 对象:挖掘过程中失败时触发的事件,结构同上。on_fail_during_searchingJSON 对象:搜索过程中失败时触发的事件,结构同上。on_item_foundJSON 对象:挖到物品时触发的事件,结构同上。on_searching_startJSON 对象:开始搜索时触发的事件,结构同上。on_successJSON 对象:整个行为成功结束时触发的事件,结构同上。search_range_xz整数:搜索范围的边长,单位为方块。默认值为10。search_range_y整数:搜索范围的高度,单位为方块。默认值为7。spawn_item_after_seconds浮点数:挖掘开始后经过多少秒产出物品。默认值为0。spawn_item_pos_offset浮点数:物品生成位置沿实体朝向前移的距离,单位为方块。默认值为0。speed_multiplier浮点数:搜索阶段的移动速度乘数。默认值为1。target_blocksJSON 数组:1.20.40+该特性在游戏版本1.20.40+下可用。允许挖掘的方块列表,会覆盖默认列表。默认值为空数组。- 字符串:方块 ID,也可写成含
name、states、tags的对象。
target_dig_position_offset浮点数:1.20.10+该特性在游戏版本1.20.10+下可用。挖掘判定点沿实体朝向前移的距离,单位为方块。默认值为2.25。
嗅探兽(sniffer.json
"minecraft:behavior.random_search_and_dig": {
"priority": 5,
"speed_multiplier": 1.25,
"find_valid_position_retries": 5,
"target_blocks": [
"minecraft:dirt",
"minecraft:coarse_dirt",
"minecraft:grass",
"minecraft:podzol",
"minecraft:dirt_with_roots",
"minecraft:moss_block",
"minecraft:pale_moss_block",
"minecraft:mud",
"minecraft:muddy_mangrove_roots"
],
"goal_radius": 2.0,
"search_range_xz": 20,
"search_range_y": 3,
"cooldown_range": {
"min": 0.0,
"max": 0.0
},
"digging_duration_range": {
"min": 8.0,
"max": 10.0
},
"item_table": "loot_tables/gameplay/entities/sniffer_seeds.json",
"spawn_item_after_seconds": 6.0,
"spawn_item_pos_offset": 2.25
}
备注:示例省略了原版的几个
on_*事件字段,结构可参照参数树补齐。
minecraft:behavior.random_sitting
通用使实体随机坐下一段时间。
- 参数
- 示例
minecraft:behavior.random_sittingJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
cooldown浮点数:两次坐下之间的冷却,单位为秒。默认值为100。min_sit_time浮点数:最短坐下的时间,单位为秒。默认值为10。start_chance浮点数:开始该行为的概率,取值 0 到 1。默认值为0.1。stop_chance浮点数:停止该行为的概率,取值 0 到 1。默认值为0.3。
熊猫(panda.json
"minecraft:behavior.random_sitting": {
"priority": 6,
"start_chance": 0.02,
"stop_chance": 0.2,
"cooldown": 25,
"min_sit_time": 15
}
minecraft:behavior.random_stroll
通用使实体随机四处闲逛。
- 参数
- 示例
minecraft:behavior.random_strollJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
interval整数:1.4.0+该特性在游戏版本1.4.0+下可用。每刻以1/interval的概率触发该行为。默认值为120。speed_multiplier浮点数:1.4.0+该特性在游戏版本1.4.0+下可用。执行该行为时的移动速度乘数。默认值为1。xz_dist整数:水平方向上搜索目标位置的距离,单位为方块,至少为1。默认值为10。y_dist整数:垂直方向上搜索目标位置的距离,单位为方块,至少为1。默认值为7。
犰狳(armadillo.json
"minecraft:behavior.random_stroll": {
"priority": 6,
"speed_multiplier": 1.0
}
minecraft:behavior.random_swim
通用使实体在水中随机游动。
- 参数
- 示例
minecraft:behavior.random_swimJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
avoid_surface布尔值:1.15.0+该特性在游戏版本1.15.0+下可用。为true时实体从水面下方游过,不会浮到水面。默认值为true。interval整数:每刻以1/interval的概率触发该行为。默认值为120。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。xz_dist整数:水平方向上搜索目标位置的距离,单位为方块,至少为1。默认值为10。y_dist整数:垂直方向上搜索目标位置的距离,单位为方块,至少为1。默认值为7。
美西螈(axolotl.json
"minecraft:behavior.random_swim": {
"priority": 8,
"interval": 0,
"xz_dist": 30,
"y_dist": 15
}
minecraft:behavior.ranged_attack
通用使实体通过远程射击攻击目标。启用蓄力连发时,charge_shoot_trigger必须大于0。
另见:minecraft:shooter组件。
- 参数
- 示例
minecraft:behavior.ranged_attackJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
attack_interval浮点数:已弃用:1.15.0-26.40该特性已被弃用,只能在游戏版本1.15.0-26.40下使用。两次攻击之间的秒数。默认值为0。attack_intervalJSON 对象:26.40+该特性在游戏版本26.40+下可用,但该版本对于当前的中国版版本过高。两次攻击之间的间隔区间,单位为秒,取代attack_interval_min与attack_interval_max。min浮点数:区间下限。默认值为-1。max浮点数:区间上限。默认值为-1。
attack_interval_min浮点数:已弃用:未知-26.40该特性已被弃用,只能在游戏版本未知-26.40下使用。两次攻击间隔的下限。默认值为0。attack_interval_max浮点数:已弃用:未知-26.40该特性已被弃用,只能在游戏版本未知-26.40下使用。两次攻击间隔的上限。默认值为0。attack_radius浮点数:已弃用:未知-26.50该特性已被弃用,只能在游戏版本未知-26.50下使用。可以发起攻击的最大距离,26.50起由attack_range取代。默认值为0。attack_radius_min浮点数:已弃用:未知-26.50该特性已被弃用,只能在游戏版本未知-26.50下使用。目标进入攻击范围的最小距离,26.50起由attack_range取代。默认值为0。attack_rangeJSON 对象:26.50+该特性在游戏版本26.50+下可用,但该版本对于当前的中国版版本过高。可以发起攻击的距离区间,单位为方块。min浮点数:区间下限。默认值为0。max浮点数:区间上限。默认值为0。
burst_interval浮点数:蓄力连发时每发之间的间隔,单位为秒。默认值为0。burst_shots整数:蓄力连发时的每次射击发数。默认值为1。charge_charged_trigger浮点数:在charge_shoot_trigger基础上再蓄力多少秒才算蓄满。默认值为0。charge_shoot_trigger浮点数:开始筹备连发前需要蓄力多少秒(随后翻倍)。目标离开视线时蓄力会衰减。默认值为0。in_range_movement_mode字符串:26.50+该特性在游戏版本26.50+下可用,但该版本对于当前的中国版版本过高。进入攻击距离后如何移动。可选值为hold_position(原地不动)、follow_target(跟随目标)。ranged_fov浮点数:1.6.0+该特性在游戏版本1.6.0+下可用。用于发现目标的视野角度,单位为度。默认值为90。set_persistent布尔值:1.18.30+该特性在游戏版本1.18.30+下可用。为true时瞄准玩家后不再被自然清除。默认值为false。speed_multiplier浮点数:追击目标时的移动速度乘数。默认值为1。swing布尔值:1.18.30+该特性在游戏版本1.18.30+下可用。为true时开火会触发手臂摆动动画(依赖variable.attack_time)。默认值为false。target_in_sight_time浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。发现目标后需要持续看见多少秒才会开始追击。默认值为1。x_max_rotation浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。瞄准时每次最多旋转的角度(X 轴),单位为度。默认值为30。y_max_head_rotation浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。瞄准时头部每次最多旋转的角度(Y 轴),单位为度。默认值为30。
烈焰人(blaze.json
"minecraft:behavior.ranged_attack": {
"charge_shoot_trigger": 4.0,
"attack_interval": {
"min": 3.0,
"max": 5.0
},
"attack_range": {
"min": 0.0,
"max": 48.0
},
"burst_interval": 0.3,
"burst_shots": 3,
"priority": 3
}
minecraft:behavior.receive_love
通用使村民停下等待其他村民前来繁殖。
- 参数
- 示例
minecraft:behavior.receive_loveJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
村民(villager.json
"minecraft:behavior.receive_love": {
"priority": 7
}
minecraft:behavior.restrict_open_door
通用使实体在夜间留在室内,不去开关门。
- 参数
- 示例
minecraft:behavior.restrict_open_doorJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
村民(villager.json
"minecraft:behavior.restrict_open_door": {
"priority": 5
}
minecraft:behavior.restrict_sun
通用使实体在晴朗的白天自动躲避阳光。
- 参数
- 示例
minecraft:behavior.restrict_sunJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
备注:该组件在 schema 中只有
priority与control_flags两个字段,行为逻辑依赖实体自身的组件配置。
(原版无用例,以下为最小写法。)
"minecraft:behavior.restrict_sun": {
"priority": 1
}
minecraft:behavior.rise_to_liquid_level
通用使实体在液体中维持在距液面固定深度的位置。
- 参数
- 示例
minecraft:behavior.rise_to_liquid_levelJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
liquid_y_offset浮点数:1.18.10+该特性在游戏版本1.18.10+下可用。目标位置距液面下沉的距离,单位为方块。正值使目标位置更靠下。默认值为0。rise_delta浮点数:1.18.10+该特性在游戏版本1.18.10+下可用。低于目标位置时每刻向上移动的距离。默认值为0。sink_delta浮点数:1.18.10+该特性在游戏版本1.18.10+下可用。高于目标位置时每刻向下移动的距离。默认值为0。
炽足兽(strider.json
"minecraft:behavior.rise_to_liquid_level": {
"priority": 0,
"liquid_y_offset": 0.25,
"rise_delta": 0.01,
"sink_delta": 0.01
}
minecraft:behavior.roar
通用使实体依据minecraft:anger_level中的数据向其他实体咆哮,怒气值越过阈值后触发。
- 参数
- 示例
minecraft:behavior.roarJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
duration浮点数:咆哮的持续时间,单位为秒。默认值为0。
监守者(warden.json
"minecraft:behavior.roar": {
"duration": 4.2,
"priority": 2
}
minecraft:behavior.roll
通用使实体向前翻滚。
- 参数
- 示例
minecraft:behavior.rollJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
probability浮点数:触发该行为的概率。默认值为0.02。
熊猫(panda.json
"minecraft:behavior.roll": {
"priority": 12,
"probability": 0.0016
}
minecraft:behavior.run_around_like_crazy
通用使实体漫无目的地狂奔。
- 参数
- 示例
minecraft:behavior.run_around_like_crazyJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
驴(donkey.json
"minecraft:behavior.run_around_like_crazy": {
"priority": 1,
"speed_multiplier": 1.2
}
minecraft:behavior.scared
通用使实体在雷雨天气时表现出害怕。
- 参数
- 示例
minecraft:behavior.scaredJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
sound_delay整数:生效期间以1/sound_delay的概率播放音效的间隔。默认值为0。
熊猫(panda.json
"minecraft:behavior.scared": {
"priority": 1
}
minecraft:behavior.send_event
通用使实体向另一个实体发送事件。常用于施展法术。
- 参数
- 示例
minecraft:behavior.send_eventJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
event_choicesJSON 数组:可选的事件方案列表,每次激活时随机挑选一个。默认值为空数组。- JSON 对象:一种事件方案。
cast_duration浮点数:施法持续时间,单位为秒。默认值为0。cooldown_time浮点数:该方案的冷却时间,单位为秒。默认值为0。do_casting布尔值:为true时播放施法动作。默认值为true。filtersJSON 对象:实体需满足的条件。见实体过滤器。look_at_target布尔值:1.16.100+该特性在游戏版本1.16.100+下可用。为true时施法期间注视目标。默认值为true。max_activation_range浮点数:触发该方案的最大距离,单位为方块。默认值为32。min_activation_range浮点数:触发该方案的最小距离,单位为方块。默认值为1。particle_color字符串:施法粒子的颜色,可写十六进制颜色字符串或[R, G, B]数组。sequenceJSON 数组:施法过程中按顺序执行的动作。默认值为空数组。- JSON 对象:一个动作。
base_delay浮点数:相对上一个动作的延迟,单位为秒。默认值为0。event字符串:要发送的事件 ID。sound_event字符串:同时播放的音效事件名。
start_sound_event字符串:开始施法时播放的音效事件名。weight浮点数:该方案被选中的权重。默认值为0。
唤魔者(evocation_illager.json
"minecraft:behavior.send_event": {
"event_choices": [
{
"particle_color": "#FFB38033",
"cast_duration": 3,
"max_activation_range": 16,
"filters": {
"all_of": [
{
"subject": "other",
"test": "is_family",
"value": "sheep"
},
{
"subject": "other",
"test": "is_color",
"value": "blue"
}
]
},
"cooldown_time": 5,
"min_activation_range": 0,
"start_sound_event": "cast.spell",
"sequence": [
{
"base_delay": 2,
"event": "wololo",
"sound_event": "prepare.wololo"
}
],
"weight": 3
}
],
"priority": 3
}
minecraft:behavior.share_items
通用使实体把身上的物品分给其他实体。
- 参数
- 示例
minecraft:behavior.share_itemsJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
entity_typesJSON 对象:可以分享物品的实体条件,可写成数组或单个对象。filtersJSON 对象:实体需满足的条件。见实体过滤器。max_dist浮点数:搜索该类实体的最大距离,单位为方块。默认值为16。max_height浮点数:该类实体可作为目标的高度上限,-1表示不限制。默认值为-1。max_flee浮点数:逃离该类实体时距其多远停止,单位为方块。默认值为10。cooldown整数:对这类实体分享物品后的冷却时间,单位为秒。默认值为0。priority整数:该实体类型在候选列表中的优先级,数值越小越优先。默认值为0。must_see布尔值:是否必须看见对方才会前往。must_see_forget_duration整数:看不见对方后多少秒放弃,单位为秒。默认值为3。check_if_outnumbered布尔值:为true时仅在对方数量占优时分享。默认值为false。reevaluate_description布尔值:为true时,对方一旦不再满足条件就停止将其作为目标。默认值为false。walk_speed_multiplier浮点数:走向该类实体时的行走速度乘数。默认值为1。sprint_speed_multiplier浮点数:走向该类实体时的疾跑速度乘数。默认值为1。
goal_radius浮点数:距目标多近即视为到达,单位为方块。默认值为0.5。max_dist整数:搜索分享对象的整体最大距离,单位为方块。默认值为1。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
村民(villager.json
"minecraft:behavior.share_items": {
"entity_types": [
{
"filters": {
"subject": "other",
"test": "is_family",
"value": "villager"
}
}
],
"goal_radius": 2,
"priority": 8,
"max_dist": 3,
"speed_multiplier": 0.5
}
minecraft:behavior.silverfish_merge_with_stone
通用使实体像蠹虫一样钻入石头方块。
- 参数
- 示例
minecraft:behavior.silverfish_merge_with_stoneJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
蠹虫(silverfish.json
"minecraft:behavior.silverfish_merge_with_stone": {
"priority": 5
}
minecraft:behavior.silverfish_wake_up_friends
通用使实体惊动附近方块中的同类,让它们钻出来。
- 参数
- 示例
minecraft:behavior.silverfish_wake_up_friendsJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
蠹虫(silverfish.json
"minecraft:behavior.silverfish_wake_up_friends": {
"priority": 1
}
minecraft:behavior.skeleton_horse_trap
通用使实体像骷髅马陷阱一样,在玩家靠近时召唤闪电与一群骷髅马。
- 参数
- 示例
minecraft:behavior.skeleton_horse_trapJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
duration浮点数:陷阱的存活时间,单位为秒。超时未被触发则从世界中移除。默认值为1。within_radius浮点数:触发陷阱所需的玩家距离,单位为方块。默认值为0。
骷髅马(skeleton_horse.json
"minecraft:behavior.skeleton_horse_trap": {
"within_radius": 10.0,
"duration": 900.0,
"priority": 2
}
minecraft:behavior.sleep
通用使拥有床的实体前往床上睡觉。
- 参数
- 示例
minecraft:behavior.sleepJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
can_sleep_while_riding布尔值:1.19.0+该特性在游戏版本1.19.0+下可用。为true时骑乘其他实体也能执行该行为。默认值为false。cooldown_time浮点数:再次使用该行为前的冷却时间,单位为秒。默认值为0。sleep_collider_height浮点数:睡觉时碰撞箱的高度。默认值为1。sleep_collider_width浮点数:睡觉时碰撞箱的宽度。默认值为1。sleep_y_offset浮点数:睡觉时碰撞箱在垂直方向上的偏移。默认值为1。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。timeout_cooldown浮点数:1.11.0+该特性在游戏版本1.11.0+下可用。内部超时或失败后重新使用该行为前的冷却,单位为秒。默认值为8。
村民(villager_v2.json
"minecraft:behavior.sleep": {
"priority": 3,
"sleep_collider_height": 0.3,
"sleep_collider_width": 1,
"sleep_y_offset": 0.6,
"speed_multiplier": 0.6,
"timeout_cooldown": 10
}
minecraft:behavior.slime_attack
通用使实体在攻击过程中周期性进入疲惫状态。
- 参数
- 示例
minecraft:behavior.slime_attackJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
grow_tired_cooldown_time浮点数:两次进入疲惫状态之间的冷却,单位为秒。默认值为15。set_persistent布尔值:1.16.0+该特性在游戏版本1.16.0+下可用。为true时瞄准玩家后不再被自然清除。默认值为false。speed_multiplier浮点数:追击目标时的移动速度乘数。默认值为1。x_max_rotation浮点数:瞄准时每次最多旋转的角度(X 轴),单位为度。默认值为10。y_max_rotation浮点数:瞄准时每次最多旋转的角度(Y 轴),单位为度。默认值为10。
岩浆怪(magma_cube.json
"minecraft:behavior.slime_attack": {
"priority": 3
}
minecraft:behavior.slime_float
通用使史莱姆与岩浆怪在水中或熔岩中浮起。
- 参数
- 示例
minecraft:behavior.slime_floatJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
jump_chance_percentage浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。在液体中跳跃的概率。默认值为0.8。speed_multiplier浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。在液体中移动时的速度乘数。默认值为1.2。
岩浆怪(magma_cube.json
"minecraft:behavior.slime_float": {
"priority": 1
}
minecraft:behavior.slime_keep_on_jumping
通用使实体像史莱姆一样持续跳跃前进。
- 参数
- 示例
minecraft:behavior.slime_keep_on_jumpingJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
speed_multiplier浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。跳跃时的移动速度乘数。默认值为1。
岩浆怪(magma_cube.json
"minecraft:behavior.slime_keep_on_jumping": {
"priority": 5
}
minecraft:behavior.slime_random_direction
通用使实体像史莱姆一样随机改变移动方向。
- 参数
- 示例
minecraft:behavior.slime_random_directionJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
add_random_time_range整数:1.15.0+该特性在游戏版本1.15.0+下可用。在min_change_direction_time基础上随机追加的时间上限,单位为秒。默认值为3。min_change_direction_time浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。两次改变方向之间的最短时间,单位为秒。默认值为2。turn_range整数:1.15.0+该特性在游戏版本1.15.0+下可用。改变方向时的最大转角,单位为度。默认值为360。
备注:原版未显式写出任何参数,全部使用默认值。
岩浆怪(magma_cube.json
"minecraft:behavior.slime_random_direction": {
"priority": 4
}
minecraft:behavior.snacking
通用使实体停下来吃附近找到的食物。
- 参数
- 示例
minecraft:behavior.snackingJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
itemsJSON 数组:允许啃食的物品列表。默认值为空数组。- 字符串:物品 ID,也可写成含
name的对象。
snacking_cooldown浮点数:两次进食之间的冷却,单位为秒。默认值为7.5。snacking_cooldown_min浮点数:冷却时间的最小值,单位为秒。默认值为0.5。snacking_stop_chance浮点数:停止进食的概率,取值 0 到 1。默认值为0.00167。
熊猫(panda.json
"minecraft:behavior.snacking": {
"priority": 3,
"snacking_cooldown": 17.5,
"snacking_cooldown_min": 10,
"snacking_stop_chance": 0.0011,
"items": [
{
"name": "minecraft:bamboo"
},
{
"name": "minecraft:cake"
}
]
}
minecraft:behavior.sneeze
通用使实体打喷嚏,并掉落物品、惊吓附近的生物。
- 参数
- 示例
minecraft:behavior.sneezeJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
cooldown_time浮点数:两次打喷嚏之间的冷却,单位为秒。默认值为0。drop_item_chance浮点数:打喷嚏时掉落物品的概率。默认值为1。entity_typesJSON 对象:会被喷嚏惊吓的实体条件,可写成数组或单个对象。filtersJSON 对象:实体需满足的条件。见实体过滤器。max_dist浮点数:该类实体的搜索距离,单位为方块。默认值为16。max_height浮点数:该类实体可作为目标的高度上限,-1表示不限制。默认值为-1。max_flee浮点数:逃离该类实体时距其多远停止,单位为方块。默认值为10。cooldown整数:再次选中该类实体前需要等待的秒数。默认值为0。priority整数:该实体类型在候选列表中的优先级,数值越小越优先。默认值为0。must_see布尔值:为true时该类实体必须可见才会被选中。must_see_forget_duration整数:看不见该类实体后多少秒放弃,单位为秒。默认值为3。check_if_outnumbered布尔值:为true时检查该类实体的数量是否占优。默认值为false。reevaluate_description布尔值:为true时,对方一旦不再满足条件就停止将其作为目标。默认值为false。walk_speed_multiplier浮点数:接近该类实体时的行走速度乘数。默认值为1。sprint_speed_multiplier浮点数:接近该类实体时的疾跑速度乘数。默认值为1。
loot_table字符串:掉落物品所用的战利品表路径,相对于行为包根目录。prepare_sound字符串:喷嚏即将发生时的音效事件名。prepare_time浮点数:打喷嚏前的准备时间,单位为秒。默认值为1。probability浮点数:打喷嚏的概率。默认值为0.02。sound字符串:打喷嚏时的音效事件名。within_radius浮点数:会惊吓到生物的距离,单位为方块。默认值为0。
熊猫(panda.json
"minecraft:behavior.sneeze": {
"priority": 7,
"probability": 0.0001666,
"cooldown_time": 1.0,
"within_radius": 10.0,
"entity_types": [
{
"filters": {
"all_of": [
{
"test": "has_component",
"subject": "other",
"operator": "!=",
"value": "minecraft:is_baby"
},
{
"test": "is_family",
"subject": "other",
"value": "panda"
}
]
},
"max_dist": 10
}
],
"drop_item_chance": 0.001,
"loot_table": "loot_tables/entities/panda_sneeze.json",
"prepare_sound": "presneeze",
"prepare_time": 1.0,
"sound": "sneeze"
}
minecraft:behavior.sniff
通用使实体探测sniffing_radius范围内最近的玩家,并更新minecraft:suspect_tracking组件的状态。
- 参数
- 示例
minecraft:behavior.sniffJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
cooldown_rangeJSON 对象:两次嗅探之间的冷却区间,单位为秒。min浮点数:区间下限。默认值为0。max浮点数:区间上限。默认值为0。
duration浮点数:单次嗅探的持续时间,单位为秒。默认值为1。sniffing_radius浮点数:探测半径,单位为方块。默认值为5。suspicion_radius_horizontal浮点数:玩家进入该水平半径内时,对其的怒气值上升,单位为方块。默认值为3。suspicion_radius_vertical浮点数:玩家进入该垂直半径内时,对其的怒气值上升,单位为方块。默认值为3。
监守者(warden.json
"minecraft:behavior.sniff": {
"duration": 4.16,
"sniffing_radius": 24,
"suspicion_radius_horizontal": 6,
"suspicion_radius_vertical": 20,
"cooldown_range": {
"min": 5,
"max": 10
},
"priority": 6
}
minecraft:behavior.sonic_boom
通用使实体发动音波攻击。
- 参数
- 示例
minecraft:behavior.sonic_boomJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
attack_cooldown浮点数:两次音波攻击之间的冷却,单位为秒。默认值为5。attack_damage浮点数:音波造成的伤害。默认值为30。attack_range_horizontal浮点数:可以对目标造成伤害的水平距离,单位为方块。默认值为15。attack_range_vertical浮点数:可以对目标造成伤害的垂直距离,单位为方块。默认值为20。attack_sound字符串:发动攻击的音效事件名。charge_sound字符串:蓄力时的音效事件名。duration浮点数:该行为的持续时间,单位为秒。默认值为0。duration_until_attack_sound浮点数:从开始到播放攻击音效的时长,单位为秒。默认值为1.7。knockback_height_cap浮点数:击退垂直分量的上限。默认值为0。knockback_horizontal_strength浮点数:击退的水平力度。默认值为0。knockback_vertical_strength浮点数:击退的垂直力度。默认值为0。speed_multiplier浮点数:追击目标时的移动速度乘数。默认值为1。
监守者(warden.json
"minecraft:behavior.sonic_boom": {
"duration": 3,
"speed_multiplier": 1.2,
"attack_damage": 10,
"attack_cooldown": 2,
"knockback_vertical_strength": 0.5,
"knockback_horizontal_strength": 2.5,
"knockback_height_cap": 0.5,
"attack_sound": "sonic_boom",
"charge_sound": "sonic_charge",
"priority": 3
}
minecraft:behavior.squid_dive
通用允许鱿鱼在水中下潜。
- 参数
- 示例
minecraft:behavior.squid_diveJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
鱿鱼(squid.json
"minecraft:behavior.squid_dive": {
"priority": 2
}
minecraft:behavior.squid_flee
通用使鱿鱼向外游走逃离。
- 参数
- 示例
minecraft:behavior.squid_fleeJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
发光鱿鱼(glow_squid.json
"minecraft:behavior.squid_flee": {
"priority": 2
}
minecraft:behavior.squid_idle
通用使鱿鱼在原地附近游动徘徊。
- 参数
- 示例
minecraft:behavior.squid_idleJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
发光鱿鱼(glow_squid.json
"minecraft:behavior.squid_idle": {
"priority": 2
}
minecraft:behavior.squid_move_away_from_ground
通用允许鱿鱼离开地面方块并回到水中。
- 参数
- 示例
minecraft:behavior.squid_move_away_from_groundJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
发光鱿鱼(glow_squid.json
"minecraft:behavior.squid_move_away_from_ground": {
"priority": 1
}
minecraft:behavior.squid_out_of_water
通用使鱿鱼离开水面后紧贴地面不动。
- 参数
- 示例
minecraft:behavior.squid_out_of_waterJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
发光鱿鱼(glow_squid.json
"minecraft:behavior.squid_out_of_water": {
"priority": 2
}
minecraft:behavior.stalk_and_pounce_on_target
通用使实体悄悄接近目标,进入范围后扑向目标,落地时若仍足够接近则造成伤害。
- 参数
- 示例
minecraft:behavior.stalk_and_pounce_on_targetJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
interest_time浮点数:进入扑击范围后蓄势的时间,单位为秒。默认值为2。leap_dist浮点数:扑击时朝目标方向跃出的距离,单位为方块。默认值为0.8。leap_height浮点数:扑击时跃起的高度,单位为方块。默认值为0.9。max_stalk_dist浮点数:放弃追踪的最大距离,单位为方块。默认值为10。pounce_max_dist浮点数:可以开始扑击的最大距离,单位为方块。默认值为5。set_persistent布尔值:1.16.0+该特性在游戏版本1.16.0+下可用。为true时瞄准玩家后不再被自然清除。默认值为false。stalk_speed浮点数:接近目标时的移动速度。默认值为1.2。strike_dist浮点数:落地后仍能造成伤害的最大距离,单位为方块。默认值为2。stuck_blocksJSON 对象:扑击失败时会陷进去的方块条件。见实体过滤器。stuck_time浮点数:陷进方块后的停留时间,单位为秒。默认值为2。
狐狸(fox.json
"minecraft:behavior.stalk_and_pounce_on_target": {
"priority": 7,
"stalk_speed": 1.2,
"max_stalk_dist": 12.0,
"leap_height": 0.9,
"leap_dist": 0.8,
"pounce_max_dist": 5.0,
"interest_time": 2.0,
"stuck_time": 2.0,
"strike_dist": 2.0,
"stuck_blocks": {
"test": "is_block",
"subject": "block",
"operator": "==",
"value": "snow_layer"
}
}
minecraft:behavior.stay_near_noteblock
通用使实体在听到最近敲响的 note block 后靠近它,并尝试把手上的物品丢过去。
- 参数
- 示例
minecraft:behavior.stay_near_noteblockJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
listen_time整数:听到 note block 后保持在附近的时间,单位为秒。默认值为30。speed浮点数:走向方块时的移动速度。默认值为1。start_distance浮点数:距方块多远时开始执行该行为,单位为方块。默认值为10。stop_distance浮点数:尝试到达的距方块距离,单位为方块。默认值为2。
悦灵(allay.json
"minecraft:behavior.stay_near_noteblock": {
"speed": 8,
"start_distance": 16,
"stop_distance": 4,
"priority": 5
}
minecraft:behavior.stay_while_sitting
通用使实体处于坐下状态时待在原地,不执行其他行为。
- 参数
- 示例
minecraft:behavior.stay_while_sittingJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
猫(cat.json
"minecraft:behavior.stay_while_sitting": {
"priority": 3
}
minecraft:behavior.stomp_attack
通用使实体通过踩踏造成范围伤害。
- 参数
- 示例
minecraft:behavior.stomp_attackJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
attack_once布尔值:1.6.0+该特性在游戏版本1.6.0+下可用。为true时该行为在实体整个生命周期内只触发一次。默认值为false。attack_types字符串:该实体会攻击的实体类型。can_spread_on_fire布尔值:1.20.30+该特性在游戏版本1.20.30+下可用。为true时着火的空手实体命中后会点燃目标。默认值为false。cooldown_time浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。两次攻击之间的冷却,单位为秒。默认值为1。inner_boundary_time_increase浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。目标超出path_inner_boundary时,寻路重算间隔的增量,单位为秒。默认值为0.25。max_path_time浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。寻路重算间隔的基础上限,单位为秒。默认值为0.55。min_path_time浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。寻路重算间隔的基础下限,单位为秒。默认值为0.2。no_damage_range_multiplier浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。与实体基础体积相乘得到「无伤害范围」,目标处于该范围内时该行为进入冷却。默认值为2。on_attackJSON 对象:1.15.0+该特性在游戏版本1.15.0+下可用。攻击命中时触发的事件。on_killJSON 对象:1.21.80+该特性在游戏版本1.21.80+下可用。击杀目标时触发的事件,结构同上。outer_boundary_time_increase浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。目标超出path_outer_boundary时,寻路重算间隔的增量,单位为秒。默认值为0.5。path_fail_time_increase浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。无法沿当前路径移动时,寻路重算间隔的增量,单位为秒。默认值为0.75。path_inner_boundary浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。超过该距离时按inner_boundary_time_increase增加间隔,单位为方块。默认值为16。path_outer_boundary浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。超过该距离时按outer_boundary_time_increase增加间隔,单位为方块。默认值为32。random_stop_interval整数:以1/N的概率中断当前攻击,N取该值。默认值为0。reach_multiplier浮点数:与实体基础体积相乘得到造成伤害前的最小目标距离。默认值为2。require_complete_path布尔值:1.9.0+该特性在游戏版本1.9.0+下可用。为true时必须存在从实体到目标的完整寻路路径。默认值为false。speed_multiplier浮点数:追击目标时的移动速度乘数。默认值为1。stomp_range_multiplier浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。与实体基础体积相乘得到踩踏的范围伤害半径。默认值为2。track_target布尔值:为true时即使没有硬编码的感知组件也会追踪目标。默认值为false。x_max_rotation浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。瞄准时每次最多旋转的角度(X 轴),单位为度。默认值为30。y_max_head_rotation浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。瞄准时头部每次最多旋转的角度(Y 轴),单位为度。默认值为30。
北极熊(polar_bear.json
"minecraft:behavior.stomp_attack": {
"priority": 1,
"track_target": true,
"require_complete_path": true,
"stomp_range_multiplier": 2.0,
"no_damage_range_multiplier": 2.0
}
minecraft:behavior.stomp_turtle_egg
通用使实体前往踩踏海龟蛋。
- 参数
- 示例
minecraft:behavior.stomp_turtle_eggJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
goal_radius浮点数:距目标多近即视为到达,单位为方块。默认值为0.5。interval整数:每刻以1/interval的概率触发该行为。默认值为120。search_count整数:每刻在搜索范围内随机抽查的方块数量,0表示全部检查。默认值为10。search_height整数:搜索海龟蛋时的垂直范围,单位为方块。默认值为1。search_range整数:搜索海龟蛋时的水平范围,单位为方块。默认值为0。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。
溺尸(drowned.json
"minecraft:behavior.stomp_turtle_egg": {
"goal_radius": 1.14,
"priority": 4,
"search_height": 2,
"interval": 20,
"search_range": 10,
"speed_multiplier": 1
}
minecraft:behavior.stroll_towards_village
通用使实体在搜索范围内前往村庄中的随机位置。
- 参数
- 示例
minecraft:behavior.stroll_towards_villageJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
cooldown_time浮点数:再次使用该行为前的冷却时间,单位为秒。默认值为8。goal_radius浮点数:距目标多近即视为到达,单位为方块。默认值为1.5。search_range整数:搜索村庄的距离,小于等于0表示不限距离、直接取最近的村庄。默认值为0。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为1。start_chance浮点数:开始该行为的概率,取值 0 到 1。默认值为1。
狐狸(fox.json
"minecraft:behavior.stroll_towards_village": {
"priority": 11,
"speed_multiplier": 1.0,
"goal_radius": 3.0,
"cooldown_time": 10.0,
"search_range": 32,
"start_chance": 0.005
}
minecraft:behavior.summon_entity
通用使实体通过召唤其他实体来攻击目标。
- 参数
- 示例
minecraft:behavior.summon_entityJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
summon_choicesJSON 数组:可用的召唤方案列表,每次激活时按权重随机挑选。默认值为空数组。- JSON 对象:一种召唤方案。
cast_duration浮点数:施法持续时间,单位为秒,-1表示不施法。默认值为-1。cooldown_time浮点数:该方案的冷却时间,单位为秒。默认值为0。do_casting布尔值:为true时播放施法动作。默认值为true。filtersJSON 对象:实体需满足的条件。见实体过滤器。max_activation_range浮点数:触发该方案的最大距离,单位为方块。默认值为32。min_activation_range浮点数:触发该方案的最小距离,单位为方块。默认值为1。particle_color字符串:施法粒子的颜色,可写十六进制颜色字符串或[R, G, B]数组。sequenceJSON 数组:召唤过程中按顺序执行的步骤。默认值为空数组。- JSON 对象:一个召唤步骤。
base_delay浮点数:相对上一个步骤的延迟,单位为秒。默认值为0。delay_per_summon浮点数:每个被召唤实体之间的延迟,单位为秒。默认值为0。entity_lifespan浮点数:被召唤实体的存活时间,单位为秒,-1表示永久。默认值为-1。entity_type字符串:被召唤实体的标识符。num_entities_spawned整数:召唤数量。默认值为1。shape字符串:召唤排列方式,可选值为circle、line。size浮点数:召唤排列的尺寸,含义随shape变化。默认值为1。sound_event字符串:召唤时播放的音效事件名。summon_cap整数:场上同时存在的被召唤实体数量上限。默认值为0。summon_cap_radius浮点数:统计召唤数量上限时的半径,单位为方块。默认值为0。summon_event字符串:被召唤实体生成时触发的实体事件 ID。target字符串:召唤位置的参照主体,可选值为self、target。
start_sound_event字符串:开始施法时播放的音效事件名。weight浮点数:该方案被选中的权重。默认值为0。
唤魔者(evocation_illager.json
"minecraft:behavior.summon_entity": {
"priority": 2,
"summon_choices": [
{
"cast_duration": 2,
"particle_color": "#FF664D59",
"cooldown_time": 5,
"max_activation_range": 3,
"min_activation_range": 0,
"sequence": [
{
"base_delay": 1,
"shape": "circle",
"num_entities_spawned": 5,
"delay_per_summon": 0,
"entity_lifespan": 1.1,
"entity_type": "minecraft:evocation_fang",
"size": 1.5,
"sound_event": "prepare.attack",
"target": "self"
}
],
"start_sound_event": "cast.spell",
"weight": 3
},
{
"cast_duration": 5,
"particle_color": "#FFB3B3CC",
"cooldown_time": 17,
"sequence": [
{
"base_delay": 5,
"entity_type": "minecraft:vex",
"shape": "circle",
"num_entities_spawned": 3,
"summon_cap_radius": 16,
"size": 1,
"sound_event": "prepare.summon",
"summon_cap": 8,
"summon_event": "minecraft:add_damage_timer",
"target": "self"
}
],
"weight": 1
}
]
}
备注:示例保留了原版的两种召唤方案,并省略了排成一线的尖牙方案。
minecraft:behavior.swell
通用使苦力怕在玩家靠近时膨胀。
- 参数
- 示例
minecraft:behavior.swellJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
start_distance浮点数:目标进入该距离时开始膨胀,单位为方块。默认值为10。stop_distance浮点数:目标离开该距离时停止膨胀,单位为方块。默认值为2。
备注:schema 的默认值(
start_distance为10、stop_distance为2)与原版苦力怕的实际配置相反:原版把开始膨胀的距离(2.5)设得比停止膨胀的距离(6)更近。建议按原版数值填写。
苦力怕(creeper.json
"minecraft:behavior.swell": {
"priority": 2,
"start_distance": 2.5,
"stop_distance": 6
}
minecraft:behavior.swim_idle
通用使处于水中的实体原地停留一段时间。
- 参数
- 示例
minecraft:behavior.swim_idleJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
idle_time浮点数:保持停留的时间,单位为秒。默认值为5。success_rate浮点数:进入停留状态的概率,1.0表示 100%。默认值为0.1。
美西螈(axolotl.json
"minecraft:behavior.swim_idle": {
"priority": 7,
"idle_time": 5.0,
"success_rate": 0.05
}
minecraft:behavior.swim_up_for_breath
通用使实体在氧气即将耗尽时游向空气。
另见:minecraft:breathable组件、EntityBreathableComponent 类。
- 参数
- 示例
minecraft:behavior.swim_up_for_breathJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
material_type字符串:实体所处液体的材质。只有下方是该材质的空气方块才会被视作有效目标。可选值为water、lava,默认值为water。search_height整数:向上搜索空气方块的高度,单位为方块。默认值为16。search_radius整数:以实体为中心的水平搜索半径,单位为方块。默认值为4。speed_mod浮点数:执行该行为时的移动速度乘数。默认值为1.4。
海豚(dolphin.json
"minecraft:behavior.swim_up_for_breath": {
"priority": 1
}
minecraft:behavior.swim_wander
通用使实体在游泳且未寻路时随意游动。
- 参数
- 示例
minecraft:behavior.swim_wanderJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
interval浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。未寻路时开始游动的概率。默认值为0.00833。look_ahead浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。游动时向前探测障碍的距离。默认值为5。speed_multiplier浮点数:游动时的移动速度乘数。默认值为1。wander_time浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。一次游动持续的时间,单位为秒。默认值为5。
鱼(fish.json
"minecraft:behavior.swim_wander": {
"interval": 0.1,
"look_ahead": 2,
"priority": 4
}
minecraft:behavior.swim_with_entity
通用使实体在水中跟随另一类实体一起游动。
- 参数
- 示例
minecraft:behavior.swim_with_entityJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
catch_up_multiplier浮点数:与目标方向对齐时的移动速度乘数。默认值为2.5。catch_up_threshold浮点数:距目标超过该距离时加速追赶,单位为方块。默认值为12。chance_to_stop浮点数:停止跟随当前目标的概率,1.0表示 100%。默认值为0.0333。entity_typesJSON 数组:可以跟随的实体条件列表。默认值为空数组。filtersJSON 对象:实体需满足的条件。见实体过滤器。max_dist浮点数:搜索该类实体的最大距离,单位为方块。默认值为16。max_height浮点数:该类实体可作为目标的高度上限,-1表示不限制。默认值为-1。max_flee浮点数:逃离该类实体时距其多远停止,单位为方块。默认值为10。cooldown整数:再次选中该类实体前需要等待的秒数。默认值为0。priority整数:该实体类型在候选列表中的优先级,数值越小越优先。默认值为0。must_see布尔值:为true时该类实体必须可见才会被选中。must_see_forget_duration整数:看不见该类实体后多少秒放弃,单位为秒。默认值为3。check_if_outnumbered布尔值:为true时检查该类实体的数量是否占优。默认值为false。reevaluate_description布尔值:为true时,对方一旦不再满足条件就停止将其作为目标。默认值为false。walk_speed_multiplier浮点数:接近该类实体时的行走速度乘数。默认值为1。sprint_speed_multiplier浮点数:接近该类实体时的疾跑速度乘数。默认值为1。
match_direction_threshold浮点数:距目标小于该距离时与目标方向对齐,单位为方块。默认值为2。search_range浮点数:搜索可跟随实体的半径,单位为方块。默认值为20。speed_multiplier浮点数:追赶目标时的移动速度乘数。默认值为1.5。state_check_interval浮点数:检查是否需要追赶或对齐方向的间隔,单位为秒。默认值为0.5。stop_distance浮点数:距目标小于该距离时停止跟随,单位为方块。默认值为5。success_rate浮点数:在尚未跟随时开始跟随的概率,1.0表示 100%。默认值为0.1。
海豚(dolphin.json
"minecraft:behavior.swim_with_entity": {
"priority": 4,
"success_rate": 0.1,
"chance_to_stop": 0.0333,
"state_check_interval": 0.5,
"catch_up_threshold": 12.0,
"match_direction_threshold": 2.0,
"catch_up_multiplier": 2.5,
"speed_multiplier": 1.5,
"search_range": 20.0,
"stop_distance": 5.0,
"entity_types": [
{
"filters": {
"test": "is_family",
"subject": "other",
"value": "player"
}
}
]
}
minecraft:behavior.swoop_attack
通用使实体俯冲攻击目标,适合飞行生物。发生水平碰撞或目标远离时行为结束。
- 参数
- 示例
minecraft:behavior.swoop_attackJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
damage_reach浮点数:1.15.0+该特性在游戏版本1.15.0+下可用。与实体基础体积相加,得到造成伤害时允许的最大目标距离。默认值为0.2。delay_rangeJSON 对象:两次俯冲之间的延迟区间,单位为秒。min浮点数:区间下限。默认值为0。max浮点数:区间上限。默认值为0。
speed_multiplier浮点数:扑向目标时的移动速度乘数。默认值为1。
幻翼(phantom.json
"minecraft:behavior.swoop_attack": {
"priority": 2
}
minecraft:behavior.take_block
通用使实体从世界中取走方块并携带在身上。
- 参数
- 示例
minecraft:behavior.take_blockJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
affected_by_griefing_rule布尔值:为true时该行为受「生物破坏」游戏规则影响。默认值为true。blocksJSON 数组:允许取走的方块列表,为空表示所有方块都可取走。默认值为空数组。- 字符串:方块 ID,也可写成含
name、states、tags的对象。
can_takeJSON 对象:取走方块前需满足的条件。见实体过滤器。chance浮点数:每刻尝试取走方块的概率,取值 0 到 1。默认值为1。on_takeJSON 对象:取走方块时触发的事件。requires_line_of_sight布尔值:为true时需要看见方块才能取走。默认值为true。xz_rangeJSON 对象:水平方向上搜索方块的范围区间,单位为方块。min整数:区间下限。默认值为0。max整数:区间上限。默认值为0。
y_rangeJSON 对象:垂直方向上搜索方块的范围区间,单位为方块。min整数:区间下限。默认值为0。max整数:区间上限。默认值为0。
末影人(enderman.json
"minecraft:behavior.take_block": {
"priority": 11,
"xz_range": {
"min": -2,
"max": 2
},
"y_range": {
"min": 0,
"max": 3
},
"chance": 0.05,
"blocks": [
"dirt",
"grass_block",
"podzol",
"coarse_dirt",
"mycelium",
"mud",
"sand",
"red_sand",
"gravel"
]
}
minecraft:behavior.take_flower
通用使实体接受另一实体通过minecraft:behavior.offer_flower递来的花。
- 参数
- 示例
minecraft:behavior.take_flowerJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
filtersJSON 对象:1.19.50+该特性在游戏版本1.19.50+下可用。接受花朵需满足的条件。见实体过滤器。max_head_rotation_y浮点数:1.19.50+该特性在游戏版本1.19.50+下可用。抬头注视目标时的最大 Y 轴旋转角度,单位为度。默认值为30。max_rotation_x浮点数:1.19.50+该特性在游戏版本1.19.50+下可用。注视目标时的最大 X 轴旋转角度,单位为度。默认值为30。max_wait_time浮点数:1.19.50+该特性在游戏版本1.19.50+下可用。接花前随机等待时间的上限,单位为秒。默认值为20。min_distance_to_target浮点数:1.19.50+该特性在游戏版本1.19.50+下可用。视为已到达目标的最小距离,单位为方块。默认值为2。min_wait_time浮点数:1.19.50+该特性在游戏版本1.19.50+下可用。接花前随机等待时间的下限,单位为秒。默认值为4。on_take_flowerJSON 对象:1.21.110+该特性在游戏版本1.21.110+下可用。接到花时触发的事件。search_areaJSON 数组:1.19.50+该特性在游戏版本1.19.50+下可用。搜索递花对象的范围,写作[x, y, z],也可写成含x、y、z的对象。speed_multiplier浮点数:1.19.50+该特性在游戏版本1.19.50+下可用。执行该行为时的移动速度乘数。默认值为0.5。
铜傀儡(copper_golem.json
"minecraft:behavior.take_flower": {
"filters": {
"all_of": [
{
"test": "is_daytime",
"value": true
},
{
"domain": "minecraft:has_flower",
"test": "bool_property",
"value": false
}
]
},
"on_take_flower": {
"event": "minecraft:on_take_flower"
},
"priority": 4
}
minecraft:behavior.target_when_pushed
通用使实体在被其他实体推动时把对方设为目标。
- 参数
- 示例
minecraft:behavior.target_when_pushedJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
entity_typesJSON 对象:目标实体的条件,可写成数组或单个对象。filtersJSON 对象:实体需满足的条件。见实体过滤器。max_dist浮点数:搜索该类实体的最大距离,单位为方块。默认值为16。max_height浮点数:目标所在高度的上限,-1表示不限制。默认值为-1。max_flee浮点数:逃离该类实体时距其多远停止,单位为方块。默认值为10。cooldown整数:对该类实体生效后的冷却时间,单位为秒。默认值为0。priority整数:该实体类型在候选列表中的优先级,数值越小越优先。默认值为0。must_see布尔值:是否必须看见对方才会生效。must_see_forget_duration整数:看不见对方后多少秒放弃,单位为秒。默认值为3。check_if_outnumbered布尔值:为true时仅在对方数量占优时生效。默认值为false。reevaluate_description布尔值:为true时,对方一旦不再满足条件就停止将其作为目标。默认值为false。walk_speed_multiplier浮点数:走向该类实体时的行走速度乘数。默认值为1。sprint_speed_multiplier浮点数:走向该类实体时的疾跑速度乘数。默认值为1。
percent_chance浮点数:被推动时锁定对方的概率,100表示 100%。默认值为0。
铁傀儡(iron_golem.json
"minecraft:behavior.target_when_pushed": {
"entity_types": [
{
"filters": {
"all_of": [
{
"subject": "other",
"test": "is_family",
"value": "monster"
},
{
"operator": "not",
"test": "is_family",
"subject": "other",
"value": "creeper"
}
]
}
}
],
"percent_chance": 5.0,
"priority": 1
}
minecraft:behavior.teleport_to_owner
通用使实体传送到其主人身边。
- 参数
- 示例
minecraft:behavior.teleport_to_ownerJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
cooldown浮点数:再次尝试传送前的冷却时间,单位为秒。默认值为1。filtersJSON 对象:允许传送需满足的条件。见实体过滤器。
猫(cat.json
"minecraft:behavior.teleport_to_owner": {
"priority": 0,
"filters": {
"all_of": [
{
"test": "owner_distance",
"operator": ">",
"value": 12
},
{
"test": "is_panicking"
}
]
}
}
minecraft:behavior.tempt
通用使实体被手持特定物品的玩家吸引并跟随。移动依赖寻路。
- 参数
- 示例
minecraft:behavior.temptJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
can_get_scared布尔值:为true时玩家在极近距离内快速移动会让实体停止被吸引。默认值为false。can_tempt_vertically布尔值:1.18.10+该特性在游戏版本1.18.10+下可用。为true时计算与玩家的垂直距离。默认值为false。can_tempt_while_ridden布尔值:1.18.10+该特性在游戏版本1.18.10+下可用。为true时被骑乘也能被吸引。默认值为false。itemsJSON 数组:可以吸引该实体的物品列表。默认值为空数组。- 字符串:物品 ID,也可写成含
name的对象。
on_tempt_endJSON 对象:停止被吸引时触发的事件。on_tempt_startJSON 对象:开始被吸引时触发的事件,结构同上。sound_intervalJSON 对象:1.18.10+该特性在游戏版本1.18.10+下可用。吸引期间播放音效的间隔区间,单位为刻。min浮点数:区间下限。默认值为0。max浮点数:区间上限。默认值为0。
speed_multiplier浮点数:跟随玩家时的移动速度乘数。默认值为1。stop_distance浮点数:1.21.80+该特性在游戏版本1.21.80+下可用。距玩家多近时停止跟随,单位为方块。tempt_sound字符串:1.18.10+该特性在游戏版本1.18.10+下可用。吸引期间播放的音效事件名。within_radius浮点数:玩家手持物品时可以吸引该实体的距离,单位为方块。默认值为0。
犰狳(armadillo.json
"minecraft:behavior.tempt": {
"priority": 3,
"speed_multiplier": 1.25,
"can_tempt_vertically": true,
"items": [
"spider_eye"
]
}
minecraft:behavior.timer_flag_1
通用启动时触发事件并等待随机时长后结束,结束或被打断时再次触发事件。与timer_flag_2、timer_flag_3结构相同,编号只用于让同一实体挂载多个独立计时器。
- 参数
- 示例
minecraft:behavior.timer_flag_1JSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
cooldown_rangeJSON 对象:两次触发之间的冷却区间,单位为秒。min浮点数:区间下限。默认值为0。max浮点数:区间上限。默认值为0。
duration_rangeJSON 对象:单次持续时间的随机区间,单位为秒。min浮点数:区间下限。默认值为0。max浮点数:区间上限。默认值为0。
on_endJSON 对象:行为结束时触发的事件。on_startJSON 对象:行为开始时触发的事件,结构同上。
犰狳(armadillo.json
"minecraft:behavior.timer_flag_1": {
"priority": 0,
"cooldown_range": {
"min": 2.5,
"max": 2.5
},
"duration_range": {
"min": 5.0,
"max": 20.0
},
"on_start": {
"event": "minecraft:stop_peeking"
},
"on_end": {
"event": "minecraft:start_peeking"
}
}
minecraft:behavior.timer_flag_2
通用结构同timer_flag_1,编号不同,用于在同一实体上挂载第二个独立计时器。
- 参数
- 示例
minecraft:behavior.timer_flag_2JSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
cooldown_rangeJSON 对象:两次触发之间的冷却区间,单位为秒。min浮点数:区间下限。默认值为0。max浮点数:区间上限。默认值为0。
duration_rangeJSON 对象:单次持续时间的随机区间,单位为秒。min浮点数:区间下限。默认值为0。max浮点数:区间上限。默认值为0。
on_endJSON 对象:行为结束时触发的事件。on_startJSON 对象:行为开始时触发的事件,结构同上。
嗅探兽(sniffer.json
"minecraft:behavior.timer_flag_2": {
"priority": 2,
"control_flags": [
"move"
],
"cooldown_range": {
"min": 0.0,
"max": 0.0
},
"duration_range": {
"min": 2.0,
"max": 5.0
},
"on_end": {
"event": "on_rising_end",
"target": "self"
}
}
minecraft:behavior.timer_flag_3
通用结构同timer_flag_1,编号不同,用于在同一实体上挂载第三个独立计时器。
- 参数
- 示例
minecraft:behavior.timer_flag_3JSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
cooldown_rangeJSON 对象:两次触发之间的冷却区间,单位为秒。min浮点数:区间下限。默认值为0。max浮点数:区间上限。默认值为0。
duration_rangeJSON 对象:单次持续时间的随机区间,单位为秒。min浮点数:区间下限。默认值为0。max浮点数:区间上限。默认值为0。
on_endJSON 对象:行为结束时触发的事件。on_startJSON 对象:行为开始时触发的事件,结构同上。
嗅探兽(sniffer.json
"minecraft:behavior.timer_flag_3": {
"priority": 5,
"cooldown_range": {
"min": 0.0,
"max": 0.0
},
"duration_range": {
"min": 2.0,
"max": 5.0
},
"on_end": {
"event": "on_feeling_happy_end",
"target": "self"
}
}
minecraft:behavior.trade_interest
通用使实体注视手持可交易物品的玩家。
- 参数
- 示例
minecraft:behavior.trade_interestJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
carried_item_switch_time浮点数:展示某件交易物品后,尝试换成另一件同价物品的最长等待时间,单位为秒。默认值为2。cooldown浮点数:再次使用该行为前的冷却时间,单位为秒。默认值为2。interest_time浮点数:展示交易物品的总时长上限,单位为秒。默认值为45。remove_item_time浮点数:玩家不再持有可交易物品后,收起展示物品的等待时间,单位为秒。默认值为1。within_radius浮点数:玩家手持可交易物品时可以引起注意的距离,单位为方块。默认值为0。
村民(villager_v2.json
"minecraft:behavior.trade_interest": {
"carried_item_switch_time": 2,
"cooldown": 2,
"interest_time": 45,
"within_radius": 6,
"priority": 5,
"remove_item_time": 1
}
minecraft:behavior.trade_with_player
通用允许玩家与该实体交易。行为开始时实体会停止寻路。
- 参数
- 示例
minecraft:behavior.trade_with_playerJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
filtersJSON 对象:1.19.60+该特性在游戏版本1.19.60+下可用。允许交易需满足的条件。见实体过滤器。max_distance_from_player浮点数:1.19.60+该特性在游戏版本1.19.60+下可用。距玩家超过该距离时退出交易行为,单位为方块。默认值为8。
村民(villager.json
"minecraft:behavior.trade_with_player": {
"filters": {
"all_of": [
{
"all_of": [
{
"test": "in_water",
"value": false
}
]
},
{
"any_of": [
{
"test": "on_ground",
"value": true
},
{
"test": "is_sleeping",
"value": true
}
]
}
]
},
"priority": 1
}
minecraft:behavior.transport_items
通用使实体在容器之间搬运物品。铜傀儡用它把铜箱中的物品放进普通箱子。
- 参数
- 示例
minecraft:behavior.transport_itemsJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
allow_simultaneous_interaction布尔值:为true时等待容器不再被其他实体使用后才开始交互。默认值为false。allowed_itemsJSON 数组:唯一允许搬运的物品列表。与disallowed_items都为空时搬运所有物品。默认值为空数组。- 字符串:物品 ID,也可写成含
name的对象。
destination_container_typesJSON 数组:可作为目的地的方块容器列表。默认值为空数组。- 字符串:方块 ID,也可写成含
name、states、tags的对象。
disallowed_itemsJSON 数组:禁止搬运的物品列表。非空时allowed_items必须为空。默认值为空数组。- 字符串:物品 ID,也可写成含
name的对象。
idle_cooldown整数:找不到可用容器时行为停止激活的时间,单位为秒。默认值为20。initial_cooldown整数:实体生成或挂载该组件后延迟开始的时间,单位为秒。默认值为0。interaction_time浮点数:在容器前交互的时间,单位为秒。默认值为3。max_stack_size整数:最多尝试从容器中取出的物品堆叠数,取值 1 到 64。默认值为64。max_visited_containers整数:在进入冷却、重新开始之前最多访问的容器数量。默认值为16。place_strategy字符串:放置策略。可选值为any(有空位就放)、with_matching(容器中已有同类物品才放)、with_matching_or_empty(两者满足其一即可),默认值为any。search_distanceJSON 数组:搜索容器的范围,写作[x, y, z],也可写成含x、y、z的对象。search_strategy字符串:搜索策略。可选值为nearest(最近的容器)、random(范围内的随机容器),默认值为random。source_container_typesJSON 数组:可作为来源的方块容器列表。默认值为空数组。- 字符串:方块 ID,也可写成含
name、states、tags的对象。
铜傀儡(copper_golem.json
"minecraft:behavior.transport_items": {
"source_container_types": [
{
"name": "minecraft:copper_chest"
},
{
"name": "minecraft:exposed_copper_chest"
}
],
"destination_container_types": [
{
"name": "minecraft:chest"
},
{
"name": "minecraft:trapped_chest"
}
],
"max_stack_size": 16,
"search_strategy": "nearest",
"search_distance": [32, 8],
"priority": 1
}
minecraft:behavior.use_kinetic_weapon
通用使实体使用动能武器,间歇性地冲向目标并在攻击后重新拉开距离。
- 参数
- 示例
minecraft:behavior.use_kinetic_weaponJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
approach_distance浮点数:距目标多近时开始使用动能武器,单位为方块。默认值为8。attack_once布尔值:为true时该行为在实体整个生命周期内只触发一次。默认值为false。attack_types字符串:该实体会攻击的实体类型。can_spread_on_fire布尔值:为true时着火的空手实体命中后会点燃目标。默认值为false。cooldown_distanceJSON 对象:进入冷却时的距离区间,单位为方块。min浮点数:区间下限。默认值为0。max浮点数:区间上限。默认值为0。
cooldown_speed_multiplier浮点数:冷却期间的移动速度乘数。默认值为1。cooldown_time浮点数:两次攻击之间的冷却时间,单位为秒。默认值为1。hijack_mount_navigation布尔值:为true时用该行为的逻辑覆盖坐骑的寻路,需要坐骑也运行该行为。默认值为false。inner_boundary_time_increase浮点数:目标超出path_inner_boundary时,寻路重算间隔的增量,单位为秒。默认值为0.25。max_path_time浮点数:寻路重算间隔的基础上限,单位为秒。默认值为0.55。melee_fov浮点数:用于发现目标的视野角度,单位为度。默认值为90。min_path_time浮点数:寻路重算间隔的基础下限,单位为秒。默认值为0.2。on_attackJSON 对象:攻击命中时触发的事件。on_killJSON 对象:击杀目标时触发的事件,结构同上。outer_boundary_time_increase浮点数:目标超出path_outer_boundary时,寻路重算间隔的增量,单位为秒。默认值为0.5。path_fail_time_increase浮点数:无法沿当前路径移动时,寻路重算间隔的增量,单位为秒。默认值为0.75。path_inner_boundary浮点数:超过该距离时按inner_boundary_time_increase增加间隔,单位为方块。默认值为16。path_outer_boundary浮点数:超过该距离时按outer_boundary_time_increase增加间隔,单位为方块。默认值为32。random_stop_interval整数:以1/N的概率中断当前攻击,N取该值。默认值为0。reposition_distanceJSON 对象:攻击后重新拉开距离的目标区间,单位为方块。min浮点数:区间下限。默认值为0。max浮点数:区间上限。默认值为0。
reposition_speed_multiplier浮点数:重新拉开距离时的移动速度乘数。默认值为1。require_complete_path布尔值:为true时必须存在从实体到目标的完整寻路路径。默认值为false。speed_multiplier浮点数:追击目标时的移动速度乘数。默认值为1。track_target布尔值:为true时即使没有硬编码的感知组件也会追踪目标。默认值为false。weapon_min_speed_multiplier浮点数:武器minecraft:kinetic_weapon组件中各项min_speed条件的乘数。默认值为1。weapon_reach_multiplier浮点数:武器minecraft:kinetic_weapon组件中reach的乘数。默认值为1。x_max_rotation浮点数:瞄准时每次最多旋转的角度(X 轴),单位为度。默认值为30。y_max_head_rotation浮点数:瞄准时头部每次最多旋转的角度(Y 轴),单位为度。默认值为30。
尸壳(husk.json
"minecraft:behavior.use_kinetic_weapon": {
"approach_distance": 12,
"reposition_distance": {
"min": 8,
"max": 9
},
"reposition_speed_multiplier": 4,
"cooldown_distance": {
"min": 11,
"max": 13
},
"cooldown_speed_multiplier": 4,
"weapon_reach_multiplier": 0.5,
"weapon_min_speed_multiplier": 0.2,
"hijack_mount_navigation": true,
"speed_multiplier": 4,
"track_target": true,
"priority": 3
}
minecraft:behavior.vex_copy_owner_target
通用使恼鬼把主人当前的攻击目标设为自己的目标。
- 参数
- 示例
minecraft:behavior.vex_copy_owner_targetJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
备注:官方文档中该组件的参数只有
priority与control_flags;具体是否生效还取决于主人自身是否有攻击目标。
(schema 未给出该组件的参数结构,原版也无用例,以下为最小写法。)
"minecraft:behavior.vex_copy_owner_target": {
"priority": 2
}
minecraft:behavior.vex_random_move
通用使恼鬼随机移动。
- 参数
- 示例
minecraft:behavior.vex_random_moveJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
备注:官方文档中该组件的参数只有
priority与control_flags。
(schema 未给出该组件的参数结构,原版也无用例,以下为最小写法。)
"minecraft:behavior.vex_random_move": {
"priority": 2
}
minecraft:behavior.wither_random_attack_pos_goal
通用使凋灵随机发起攻击。
- 参数
- 示例
minecraft:behavior.wither_random_attack_pos_goalJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
凋灵(wither.json
"minecraft:behavior.wither_random_attack_pos_goal": {
"priority": 3
}
minecraft:behavior.wither_target_highest_damage
通用使凋灵优先攻击对它造成伤害最多的实体。
- 参数
- 示例
minecraft:behavior.wither_target_highest_damageJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
entity_typesJSON 对象:目标实体的条件,可写成数组或单个对象。filtersJSON 对象:实体需满足的条件。见实体过滤器。max_dist浮点数:搜索该类实体的最大距离,单位为方块。默认值为16。max_height浮点数:目标所在高度的上限,-1表示不限制。默认值为-1。max_flee浮点数:逃离该类实体时距其多远停止,单位为方块。默认值为10。cooldown整数:对该类实体生效后的冷却时间,单位为秒。默认值为0。priority整数:该实体类型在候选列表中的优先级,数值越小越优先。默认值为0。must_see布尔值:是否必须看见对方才会生效。must_see_forget_duration整数:看不见对方后多少秒放弃,单位为秒。默认值为3。check_if_outnumbered布尔值:为true时仅在对方数量占优时生效。默认值为false。reevaluate_description布尔值:为true时,对方一旦不再满足条件就停止将其作为目标。默认值为false。walk_speed_multiplier浮点数:走向该类实体时的行走速度乘数。默认值为1。sprint_speed_multiplier浮点数:走向该类实体时的疾跑速度乘数。默认值为1。
备注:原版未写出
entity_types,因此对所有实体生效。
凋灵(wither.json
"minecraft:behavior.wither_target_highest_damage": {
"priority": 1
}
minecraft:behavior.work
通用使 NPC 前往并使用其工作站点方块。
- 参数
- 示例
minecraft:behavior.workJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
active_time整数:在工作站点停留的时长,单位为刻。默认值为0。can_work_in_rain布尔值:为true时工作站点被雨淋到也能工作。默认值为false。goal_cooldown整数:该行为再次可用前的冷却,单位为刻。默认值为0。on_arrivalJSON 对象:抵达工作站点时触发的事件。sound_delay_max整数:播放音效间隔的上限。默认值为0。sound_delay_min整数:播放音效间隔的下限。默认值为0。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为0.5。work_in_rain_tolerance整数:can_work_in_rain为false时,降雨不会打断该行为、还能继续工作的剩余刻数。默认值为-1。
备注:同一实体的不同组件组里,该组件也常写作空对象
{},此时priority取默认值0,会抢占几乎所有其他行为,一般应显式指定优先级。
村民(villager_v2.json
"minecraft:behavior.work": {
"priority": 7,
"active_time": 250,
"on_arrival": {
"event": "minecraft:resupply_trades",
"target": "self"
},
"can_work_in_rain": false,
"speed_multiplier": 0.5,
"goal_cooldown": 200,
"sound_delay_max": 200,
"sound_delay_min": 100,
"work_in_rain_tolerance": 100
}
minecraft:behavior.work_composter
通用使 NPC 使用堆肥桶,把多余的种子转化为骨粉。
- 参数
- 示例
minecraft:behavior.work_composterJSON 对象:根对象。priority整数:行为优先级,数值越小越优先。默认值为0。control_flagsJSON 数组:该行为占用的控制通道。可选值为move、look、jump。- 字符串:一个控制通道。
active_time整数:在工作站点停留的时长,单位为刻。默认值为0。block_interaction_max整数:与堆肥桶交互的最大次数。默认值为1。can_empty_composter布尔值:为true时可以取出装满的堆肥桶。默认值为true。can_fill_composter布尔值:为true时可以往未满的堆肥桶中添加物品。默认值为true。can_work_in_rain布尔值:为true时工作站点被雨淋到也能工作。默认值为false。goal_cooldown整数:该行为再次可用前的冷却,单位为刻。默认值为0。items_per_use_max整数:每次交互最多添加的物品数量。默认值为20。min_item_count整数:每种可堆肥物品最多消耗的数量,超出部分若可堆肥才会被处理。默认值为10。on_arrivalJSON 对象:抵达堆肥桶时触发的事件。speed_multiplier浮点数:执行该行为时的移动速度乘数。默认值为0.5。use_block_max整数:与堆肥桶交互间隔的上限。默认值为200。use_block_min整数:与堆肥桶交互间隔的下限。默认值为100。work_in_rain_tolerance整数:can_work_in_rain为false时,降雨不会打断该行为、还能继续工作的剩余刻数。默认值为-1。
村民(villager_v2.json
"minecraft:behavior.work_composter": {
"active_time": 250,
"priority": 9,
"can_work_in_rain": false,
"on_arrival": {
"event": "minecraft:resupply_trades",
"target": "self"
},
"goal_cooldown": 200,
"speed_multiplier": 0.5,
"work_in_rain_tolerance": 100
}