ENTITIES DOCUMENTATION
Version: 1.18.10.4

索引

Client Entity Documentation（客户端实体文档）
Spawn Egg（生物蛋）
animation_controllers（动画控制器）
animations（动画）
enable_attachables（允许附着物）
hide_armor（隐藏盔甲）
identifier（实体标识符）
locators（定位器）
materials, textures, animations（材质，纹理，动画）
min_engine_version（最小引擎版本）
particle（粒子）
render_controllers（渲染控制器）
scripts（脚本）
Data-Driven Spawning（数据驱动生成）
Spawn Rules（生成规则）
Filters（过滤器）
clock_time
distance_to_nearest_player
has_ability
has_biome_tag
has_component
has_container_open
has_damage
has_equipment
has_mob_effect
has_nametag
has_ranged_weapon
has_tag
has_target
has_trade_supply
hourly_clock_time
in_block
in_caravan
in_clouds
in_contact_with_water
in_lava
in_nether
in_water
in_water_or_rain
inactivity_timer
is_altitude
is_avoiding_mobs
is_biome
is_block
is_brightness
is_climbing
is_color
is_daytime
is_difficulty
is_family
is_game_rule
is_humid
is_immobile
is_in_village
is_leashed
is_leashed_to
is_mark_variant
is_missing_health
is_moving
is_owner
is_persistent
is_riding
is_skin_id
is_sleeping
is_sneaking
is_snow_covered
is_target
is_temperature_type
is_temperature_value
is_underground
is_underwater
is_variant
is_visible
is_weather
light_level
moon_intensity
moon_phase
on_ground
on_ladder
random_chance
rider_count
surface_mob
trusts
weather
weather_at_position
Server Entity Documentation（服务端实体文档）
AI Goals（AI意向）
Attributes（特性）
Built-in Events（内置事件）
Components（组件）
Entity Definition Properties
Entity Description Properties
ID Lists
Properties
Triggers
返回顶部

Client Entity Documentation（客户端实体文档）

客户端实体文档包含在一个资源包中。
首先，在资源包的根目录下创建一个新的文件夹并将其命名为 "entity"，在实体文件夹中创建一个JSON文件并给它一个名字。JSON文件需要一个版本格式和 minecraft:client_entity 信息。

minecraft:client_entity 部分包含实体的描述。在该部分，你可以设置许多关于实体的东西。一般来说，该文件定义了一个生物需要哪些资源，并给每个资源一个*友好*的名字，这样以便其他文件的实用。

猪的客户端实体定义JSON示例

返回顶部

Spawn Egg（生物蛋）

设置实体刷怪蛋的颜色或纹理。有两种方法可以做到这一点。第一种是使用 HEX 来设置基础色（底色）和覆盖色。

当一个纹理名称有一个以上的纹理时，你可以使用一个特殊值来选择你想要的那个。如果没有指定特殊值，则假定其为0，并使用列表中的第一个纹理。
指定了一个纹理的刷怪蛋示例

使用了十六进制值的刷怪蛋示例

返回顶部



animation_controllers（动画控制器）

决定何时播放哪些动画。每个控制器包含一个会播放一个或多个动画的状态列表，允许玩家指定名称来引用动画控制器的完整名称。每个控制器名称是必需的，并且需要与该生物的其他动画控制器名称不同。玩家可以参考原版 Minecraft 资源包中的动画控制器，或者创建一个自己的。自定义动画控制器应该在资源包根部的 animation_controllers 文件夹中。
返回顶部

animations（动画）

允许玩家指定引用动画的完整名称。这些名字被动画控制器的JSON 所使用。玩家可以参考原版 Minecraft 资源包中的动画，也可以创建一个自己的动画。自定义动画应该在资源包根部的 animation 文件夹中。
返回顶部

enable_attachables（允许附着物）

决定实体是否可以装备身体部件。当值为"true"时，实体可以渲染盔甲和武器。



返回顶部

hide_armor（隐藏盔甲）

决定了实体的盔甲是否该被隐藏。当值为"true"时，实体身上盔甲会被隐藏。且会覆盖 enable_attachables 所指定的渲染设置。



返回顶部

identifier（实体标识符）

标识符用于向服务器注册实体。在客户端实体文档 JSON 中，标识符设置了实体的外观（材料、纹理、模型等）。行为包中实体行为 JSON 中的匹配标识符将会赋予实体其行为。
返回顶部

locators（定位器）

定位器偏移量在模型空间中指定。例如"lead"定位器用于指定拴绳在实体上的连接位置。



返回顶部

materials, textures, animations（材质，纹理，动画）

设置实体使用的材质、纹理和模型。玩家可以设置一个或多个材质、纹理和模型，供生物使用。玩家必须为他们设置自定义的名字。这些名称在渲染控制器 JSON 中使用。玩家可以从原版 Minecraft 资源包中调用材质、纹理和模型，或者创建自己的自定义材质、纹理和模型应位于资源包根目录下的相应文件夹中。
返回顶部

min_engine_version（最小引擎版本）

当存在时，可以设置允许解析 JSON 所需的最小版本。文档内的版本会与与构建最高优先级的资源包的引擎版本进行比较，如果定义的 min_engine_version 比该包的 engine 版本更新，则不解析该定义。 多个定义文件可能使用相同的标识符，在这种情况下，将只加载其中一个定义。与最高优先级的资源包的引擎版本相比，具有相同或最接近且不大于 min_engine_version 的定义将被解析，具有相同标识符的所有其他定义则不会被解析。当在资源包组顶部使用较旧的资源包时，这对于继续支持较旧版本的实体非常有用，同时在所有其他情况下也支持较新版本的实体。
返回顶部

particle（粒子）

允许指定一个键来引用粒子的完整名称。当键和实体都存在时，粒子就会在实体生成时被创建。键是必需的，并且需要与该生物的其他动画控制器的键名称不同。玩家可以参考原版 Minecraft 资源包中的粒子，或者创建自己的。自定义粒子应该在资源包根部的 particle 文件夹中。
返回顶部

render_controllers（渲染控制器）

指定渲染控制器的名称。该名称需要与位于 Render Controllers 文件夹中的相应 JSON 的名称相匹配。玩家可以参考原版 Minecraft 资源包中的渲染控制器，或者创建自己的。自定义渲染控制器应该在资源包根部的 textures 文件夹中。
返回顶部

scripts（脚本）

脚本允许玩家使用 Molang 来进行一次计算并存储该结果值。该值可以被反复使用，而不需要反复重新计算。脚本目前支持预动画和缩放，更多的脚本类型将在以后添加。
-预动画脚本可以在处理动画之前立即被评估。
-缩放脚本可以批量设置生物的模型大小。
*该特性已被删除*

鳕鱼的动画脚本示例

蝙蝠的缩放脚本示例

返回顶部



Data-Driven Spawning（数据驱动生成）

数据驱动生成允许玩家调整生物的生成条件，包括添加到游戏中的新生物在生物群系中的自然生成，添加/移除生物刷怪蛋到创造模式物品栏并设置生物刷怪蛋，并添加/移除到 /summon 命令中。

Spawn Rules（生成规则）

Biome Tags（生物群系标签）

游戏中的每个生物群系都有一个或多个标签，这些标签用于确定生物在哪些生物群系中生成。下面是可以使用的生物群系标签的列表：

Tag
animal
beach
birch
cold
dark_oak
deep
desert
edge
extreme_hills
flower_forest
forest
frozen
hills
ice
ice_plains
jungle
lakes
lukewarm
mega
mesa
monster
mooshroom_island
mountain
mutated
nether
ocean
plains
plateau
river
roofed
savanna
shore
stone
swamp
taiga
the_end
warm
返回顶部

Conditions（条件）

环境包含不同的组成部分，玩家可以使用这些部分来定义生物在群系的生成。

组件

名称 描述
minecraft:biome_filter 该组件允许玩家指定生物在哪些生物群系中生成。生物群系标签的信息见下文。
minecraft:brightness_filter 该组件允许玩家设置生成生物的光照强度范围。
名称 类型 默认值 描述
adjust_for_weather 布尔值 false 这决定了天气是否能影响导致生物生成的光照强度条件（例如，允许敌对生物在白天下雨时生成）。
max 浮点数 15.0 这是允许生物生成的最大光照强度值。
min 浮点数 0.0 这是允许生物生成的最小光照强度值。
minecraft:density_limit 该组件允许玩家确定特定生物类型的密度上限。
名称 类型 默认值 描述
surface 整数 这是该类型的生物在地表上可生成的最大数量。
underground 整数 这是该类型的生物在地下可生成的最大数量。
minecraft:difficulty_filter 该组件允许玩家决定生物会在在设置特定难度的情况下生成。
名称 类型 默认值 描述
max 字符串 这是一个生物生成的最大难度。
min 字符串 这是一个生物生成的最小难度。
minecraft:herd 该组件允许玩家决定一次生成一个生物群的大小。
名称 类型 默认值 描述
event 字符串 这是一个可以触发生成的事件。
event_skip_count 浮点数 这是事件被触发前可以生成的生物数量。
max_size 浮点数 这是生物在一个群内可生成的最大数量。
min_size 浮点数 这是生物在一个群内可生成的最小数量。
minecraft:spawns_on_surface 该组件允许生物在地表生成。添加该组件即起效，移除该组件使生物停止在地表生成。
minecraft:spawns_underwater 该组件允许生物在水中生成。添加该组件即起效，移除该组件使生物停止在水中生成。
minecraft:weight 该组件允许玩家对该生物的生成频率赋权。权重较高的生物比权重较低的生物有更大的机会生成。
名称 类型 默认值 描述
default 浮点数 0.0 这是生物生成的权重。
返回顶部



准备开始

新的生成规则包含在一个行为包中。首先，在您想添加新生物群系生成规则的行为包根部创建一个名为"spawn_rules"的新文件夹。在 spawn_rule 文件夹中，创建一个 JSON 文件，并给它一个名字。该 JSON 文件需要一个格式、描述和条件。生成规则包含描述和条件所有生成规则 JSON 需要有一个 ID （位于描述部分下）。与其他标识符类似，它遵循命名法则"namespace:name（命名空间:名称）"。 minecraft 命名空间是为原版 Minecraft 规则保留的。当改变一个现有的生物时，使用出现在该实体 JSON 中的 ID 。当创建你自己的生物时，请确保生物在所有实体的 JSON 文件中具有相同的 ID 。

生成规则还需要定义用于数量控制的生物组。每组都有自己的生成限制，通过将一个实体设置到一个生物组，只要该组没有达到生成限制，它就会生成。

有三个可供实体分配的生物组：
-animal
-water_animal
-monster
返回顶部

群系条件表

生物群系 标签
Beach monster, beach, warm
Birch Forest animal, monster, birch, forest
Birch Forest Hills animal, monster, birch, forest, hills
Birch Forest Hills M animal, monster, forest, birch, mutated, hills
Birch Forest M animal, monster, forest, birch, mutated
Cold Ocean ocean, cold, monster
Cold Taiga M animal, monster, taiga, cold, mutated
Dark Forest animal, monster, forest, roofed
Dark Forest M animal, monster, roofed, forest, mutated
Deep Cold Ocean ocean, cold, monster, deep
Deep Frozen Ocean ocean, frozen, monster, deep
Deep Lukewarm Ocean ocean, lukewarm, monster, deep
Deep Ocean ocean, monster, deep
Deep Warm Ocean ocean, warm, monster, deep
Desert monster, desert
Desert Hills monster, desert, hills
Desert M monster, desert, mutated
Forest animal, monster, forest
Forest Hills animal, monster, hills
Forest M monster, flower_forest, forest, mutated
Frozen Ocean ocean, frozen
Frozen River river, frozen
Giant Tree Taiga animal, monster, taiga, mega
Giant Tree Taiga Hills animal, monster, taiga, mega, hills
Giant Tree Taiga Hills M animal, monster, taiga, mega, hills, mutated
Giant Trees Taiga M animal, monster, mutated, mega
Jungle animal, monster, jungle
Jungle Edge animal, monster, jungle, edge
Jungle Edge M animal, monster, jungle, edge, mutated
Jungle Hills animal, monster, jungle, hills
Jungle M animal, monster, jungle, mutated
Lukewarm Ocean ocean, lukewarm, monster
Mesa monster
Mesa M animal, monster, mesa, mutated
Mesa Plateau monster, mesa
Mesa Plateau M monster, mesa, plateau, mutated
Mesa Plateau Stone monster, plateau
Mesa Plateau Stone M monster, mesa, plateau, mutated, stone
Mountain animal, monster, extreme_hills
Mountain + M animal, monster, extreme_hills, mutated, forest
Mountain Edge animal, monster, extreme_hills, edge, mountain
Mountain M animal, monster, extreme_hills, mutated
Mushroom Fields mooshroom_island
Mushroom Fields Shore mooshroom_island, shore
Nether nether
Ocean ocean, monster
Plains animal, monster, plains
Plains M animal, monster, plains, mutated
River river
Savanna animal, monster, savanna
Savanna M animal, monster, savanna, mutated
Savanna Plateau animal, monster, savanna
Savanna Plateau M animal, monster, savanna, plateau, mutated
Snowy Beach monster, beach, cold
Snowy Mountains frozen, ice, mountain
Snowy Taiga animal, monster, taiga, cold
Snowy Taiga Hills animal, monster, taiga, cold, hills
Snowy Tundra frozen, ice_plain, ice
Snowy Tundra M monster, frozen, ice_plains, mutated
Stone Shore monster, beach, stone
Swamp animal, monster, swamp
Swamp M animal, monster, swamp, mutated
Taiga animal, monster, taiga
Taiga Hills animal, monster, taiga, hills
Taiga M animal, monster, taiga, mutated
The End the_end
Warm Ocean ocean, warm, monster
Wooded Mountain animal, monster, extreme_hills, forest, mountain
返回顶部



僵尸的生成规则示例



Filters（过滤器）

过滤器允许数据对象使用指定的检测标准。

例如，一个包含过滤器的模型只有在过滤器标准值为 true 时才会被使用。



一个典型的过滤器由四个参数组成：

name（名称）：要应用的检测的名称。

domain（域）：检测应该在哪个域中进行。例如一个装甲槽；该参数只被少数检测使用。

operator（操作符）：与数值的比较，例如 “equal（等于）”或“greater（大于）”。

value（值）：与检测进行比较的值。



一个典型的过滤器看起来像下面这样：

{ "test" : "moon_intensity", "subject" : "self", "operator" : "greater", "value" : "0.5" }

其结果是调用实体（self）计算其位置的moon_intensity，如果结果大于 0.5 ，则返回 true 。



检测可以使用集合"all_of"、"any_of "或"none_of "组合成组。

"all_of"中的所有检测都必须通过，该组通才会过。

"any_of"中的一个或多个检测必须通过，该组才会通过。

none_of"中的所有检测都必须不通过，该组才会通过。

clock_time

将当前时间与一个范围为(0.0, 1.0)的浮动值进行比较。
0.0=中午
0.25=日落
0.5=午夜
0.75=日出

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 浮点数 （必须）一个浮点值。

示例

完整..

简短（使用默认值）..

返回顶部

distance_to_nearest_player

将用和最近的玩家之间的距离与浮点值进行比较。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 浮点数 （必须）一个浮点值。

示例

完整..

简短（使用默认值）..

返回顶部

has_ability

当主体实体具有命名能力时，返回 true。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 字符串 （必须）要检测的能力
选项 描述
flySpeed
flying
instabuild
invulnerable
lightning
mayfly
mute
noclip
walkSpeed
worldbuilder

示例

完整..

简短（使用默认值）..

返回顶部

has_biome_tag

检测受试者所在的生物群系是否具有指定的标签。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 字符串 （必须）要寻找的标签

示例

完整..

简短（使用默认值）..

返回顶部

has_component

当目标实体包含已命名的（已存在的）组件时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 字符串 （必须）要寻找的组件名

示例

完整..

简短（使用默认值）..

返回顶部

has_container_open

当目标玩家打开一个容器返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

has_damage

当目标实体受到已命名（已存在的）类型的伤害时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 字符串 （必须）要检测的伤害类型
选项 描述
anvil 铁砧
attack 近战攻击
block_explosion 方块爆炸
contact 仙人掌或甜浆果丛
drowning 溺水或淋雨
entity_explosion 实体爆炸
fall 跌落或末影珍珠
falling_block 下落的方块（除了铁砧）
fatal 任何可以杀死该主体的伤害
fire 火或篝火
fire_tick 身上连续着火
fly_into_wall 动能
lava 熔岩
magic 药水、龙息、唤魔者尖牙或守卫者激光
none 无
override 程序直接覆写生命值
piston 活塞
projectile 弹射物
stalactite 钟乳石
stalagmite 石笋
starve 饥饿
suffocation 窒息
suicide /kill指令
thorns 荆棘
void 虚空
wither 凋零

示例

完整..

简短（使用默认值）..

返回顶部

has_equipment

检测在目标实体的指定装备槽中是否存在一个已命名的物品。

名称 类型 默认值 描述
domain 字符串 any （可选）要检测的装备位置
选项 描述
any
armor
feet
hand
head
leg
torso
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 字符串 （必须）要寻找的物品名

示例

完整..

简短（使用默认值）..

返回顶部

has_mob_effect

检测目标实体是否受到了指定生物影响。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 字符串 （可选）一个字符串值。

示例

完整..

简短（使用默认值）..

返回顶部

has_nametag

检测目标实体是否被命名。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

has_ranged_weapon

检测目标实体是否持有远程武器（如弓和弩）。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

has_tag

当目标实体持有与提供的标签相同的标签时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 字符串 （可选）一个字符串值。

示例

完整..

简短（使用默认值）..

返回顶部

has_target

当目标实体锁定一个有效的目标时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

has_trade_supply

检测目标实体是否有任何交易物品剩余。如果目标不能被交易，将返回 false 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

hourly_clock_time

将当前24小时的时间与范围[0, 24000]中的一个整数值进行比较。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 整数 （必须）一个整数值。

示例

完整..

简短（使用默认值）..

返回顶部

in_block

当目标实体在一个特定方块中时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 字符串 （可选）一个字符串值。

示例

完整..

简短（使用默认值）..

返回顶部

in_caravan

当目标实体在载具中时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

in_clouds

当目标实体在云中时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

in_contact_with_water

当目标实体与任何水（如水方块、雨水、喷溅型水瓶）接触时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

in_lava

当目标实体与岩浆接触时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

in_nether

当目标实体在下界中时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

in_water

当目标实体在水中时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

in_water_or_rain

当目标实体在水中或者雨中时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

inactivity_timer

检测是否已经达到了指定的不运动时间（单位：秒）。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 整数 （必须）一个整数值。

示例

完整..

简短（使用默认值）..

返回顶部

is_altitude

根据提供的数值检测当前的海拔高度，0 = 基岩高度。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 整数 （必须）要与之比较的海拔值。

示例

完整..

简短（使用默认值）..

返回顶部

is_avoiding_mobs

当目标实体逃离生物返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

is_biome

检测目标实体是否处于以命名的群系中。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 字符串 （必须）要检测的生物群系类型
选项 描述
beach
desert
extreme_hills
flat
forest
ice
jungle
mesa
mushroom_island
ocean
plain
river
savanna
stone_beach
swamp
taiga
the_end
the_nether

示例

完整..

简短（使用默认值）..

返回顶部

is_block

当方块指定名称时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 字符串 （必须）要寻找的族名

示例

完整..

简短（使用默认值）..

返回顶部

is_brightness

将当前亮度与范围(0.0, 1.0)中的一个浮点值进行比较。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 浮点数 （必须）要与之比较的亮度值。

示例

完整..

简短（使用默认值）..

返回顶部

is_climbing

当目标实体正在攀爬时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

is_color

当目标实体是指定颜色时返回 true （例如羊）。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 字符串 （必须）要检测的调色板颜色
选项 描述
black
blue
brown
cyan
gray
green
light_blue
light_green
magenta
orange
pink
purple
red
silver
white
yellow

示例

完整..

简短（使用默认值）..

返回顶部

is_daytime

当时间是白天时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

is_difficulty

检测游戏的当前难度。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 字符串 （必须）要检测的游戏的难度级别
选项 描述
easy
hard
normal
peaceful

示例

完整..

简短（使用默认值）..

返回顶部

is_family

当目标实体是指定家族的一个成员时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 字符串 （必须）要寻找的族名

示例

完整..

简短（使用默认值）..

返回顶部

is_game_rule

检测一个游戏规则是否被激活。

名称 类型 默认值 描述
domain 字符串 (Required) The Game Rule to test.
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

is_humid

测试目标是否在一个有湿度的地区。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

is_immobile

当目标实体是不动的，则返回 true 。如果一个实体满足 AI 缺乏目标、刚刚变换了所处维度、生命值归零三种情况之一，那么它是不动的。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

is_in_village

检测目标是否处在村庄范围内。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

is_leashed

当目标实体被拴住时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

is_leashed_to

当目标实体被指定实体拴住时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

is_mark_variant

当目标实体是提供的指定变种时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 整数 （必须）一个整数值。

示例

完整..

简短（使用默认值）..

返回顶部

is_missing_health

检测目标是否满生命值。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

is_moving

当目标实体正在移动时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

is_owner

当目标实体是指定实体的主人时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

is_persistent

检测目标的宿存性是否与传入的布尔值一致。
（即是否使用了minecraft:persistent组件）

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

is_riding

当目标实体正在骑着另一个实体时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

is_skin_id

当目标实体是提供的指定皮肤时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 整数 （必须）一个整数值。

示例

完整..

简短（使用默认值）..

返回顶部

is_sleeping

检测目标是否在睡觉。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

is_sneaking

当目标实体正在潜行时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

is_snow_covered

检测目标所处区域是否被雪覆盖。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

is_target

当目标实体是指定实体的目标时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

is_temperature_type

检测当前温度是否是指定种类。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 字符串 （必须）要检测的生物群系温度分类
选项 描述
cold
mild
ocean
warm

示例

完整..

简短（使用默认值）..

返回顶部

is_temperature_value

将当前温度与范围(0.0, 1.0)中的一个浮点值进行比较，0.0时温度最低，1.0时温度最高。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 浮点数 （必须）要与之比较的生物群系温度值。

示例

完整..

简短（使用默认值）..

返回顶部

is_underground

当目标实体处于地下时返回 true 。
*如果实体上方有非固体方块，则该实体被视为地下实体。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

is_underwater

当目标实体处于水中时返回 true 。如果实体完全没入水方块，则该实体被视为水中实体。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

is_variant

当目标实体变种类型与提供的变种数相同时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 整数 （必须）一个整数值。

示例

完整..

简短（使用默认值）..

返回顶部

is_visible

当目标实体可见时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

is_weather

*这一条被移除了*

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 字符串 （必须）要寻找的族名

示例

完整..

简短（使用默认值）..

返回顶部

light_level

检测生物是否暴露在一个范围在(0, 16)特定的光照强度下。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 整数 （必须）一个整数值。

示例

完整..

简短（使用默认值）..

返回顶部

moon_intensity

将当前月光强度与范围(0.0, 1.0)中的一个浮点值进行比较。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 浮点数 （必须）一个浮点值。

示例

完整..

简短（使用默认值）..

返回顶部

moon_phase

将当前月相与范围(0, 7)中的一个整数值进行比较。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 整数 （必须）一个整数值。

示例

完整..

简短（使用默认值）..

返回顶部

on_ground

当目标实体在地面时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

on_ladder

当目标实体在梯子上时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

random_chance

如果随机在指定的最大范围内随机到0时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 整数 （必须）一个整数值。

示例

完整..

简短（使用默认值）..

返回顶部

rider_count

返回骑着目标实体的实体数量。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 整数 （必须）一个整数值。

示例

完整..

简短（使用默认值）..

返回顶部

surface_mob

检测生物是否是一个地面生物。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

trusts

如果目标被实体信任时返回 true 。

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 布尔值 true （可选）true或false。

示例

完整..

简短（使用默认值）..

返回顶部

weather

检测现在维度的天气并与指定值比较

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 字符串 （必须）要寻找的族名

示例

完整..

简短（使用默认值）..

返回顶部

weather_at_position

在实体角度检测现在的天气并与指定值比较

名称 类型 默认值 描述
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 字符串 （必须）要寻找的族名

示例

完整..

简短（使用默认值）..

返回顶部

示例：

仅当 moon_intensity大于 0.5 且调用方的目标实体位于水中时，此过滤器组才会通过。



Server Entity Documentation（服务端实体文档）

AI意向

minecraft:behavior.admire_item

使该生物能够钦慕那些配置为可钦慕的物品。必须与admire_item组件组合使用

名称 类型 默认值 描述
admire_item_sound 字符串 当钦慕该物品时要播放的声音事件
sound_interval 范围 [a, b] 0 在再次播放该声音之前需要随机等待的时间的范围（以秒为单位）。
返回顶部

minecraft:behavior.barter

使该生物能够通过以物易物索求那些被配置为以物易物通货的物品。必须与barter组件组合使用
返回顶部

minecraft:behavior.beg

允许该生物看向并跟随持有它们喜欢的食物的玩家。

名称 类型 默认值 描述
items 列表 该生物喜欢的物品的列表
look_distance 浮点数 8.0 该生物将会乞求自的距离（以方块为单位）
look_time 范围 [a, b] [2, 4] 该生物将会盯着持有它们喜欢的食物的玩家，并乞求该食物的时间的范围（以秒为单位）
返回顶部

minecraft:behavior.break_door

允许该生物去破坏门。
返回顶部

minecraft:behavior.breed

允许该生物去与其他生物交配。

名称 类型 默认值 描述
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.defend_trusted_target

允许生物锁定另一个伤害它所信任的实体的生物。

名称 类型 默认值 描述
aggro_sound 字符串 在防御时偶尔播放的声音。
attack_interval 整数 0 两次攻击之间的时间（单位为秒）。
entity_types JSON对象 能被生物作为有效目标的实体列表。
名称 类型 默认值 描述
filters Minecraft 类型 使列表中的该条目有效的条件。
max_dist 浮点数 16 生物锁定实体时可以离开的最大距离。
must_see 布尔值 false 当值为"true"时，实体锁定的目标必须是可见的。
must_see_forget_duration 布尔值 3.0 决定该生物在失去一个目标并在目标不再可见时重新寻找一个新的目标之前所需的时间（单位为秒）。
sprint_speed_multiplier 浮点数 1.0 生物跑步速度的乘子。值为1.0意味着速度没有变化。
walk_speed_multiplier 浮点数 1.0 生物行走速度的乘子。值为1.0意味着速度没有变化。
must_see 布尔值 false 当值为"true"时，生物视线范围内的实体才会被锁定为目标。
must_see_forget_duration 浮点数 3.0 决该生物在失去一个目标并在目标不再可见时寻找一个新的目标之前所需的时间（单位为秒）。
within_radius 浮点数 0.0 目标发起攻击所处的距离（以方块为单位）
返回顶部

minecraft:behavior.door_interact

允许生物打开和关闭门。
返回顶部

minecraft:behavior.dragondeath

让龙死亡时爆炸。仅末影龙可使用。
返回顶部

minecraft:behavior.dragonholdingpattern

允许龙围绕传送门作圆形飞行。只能由末影龙使用。
返回顶部

minecraft:behavior.dragonlanding

允许龙停止飞行并过渡到栖息模式。只能由末影龙使用。
返回顶部

minecraft:behavior.dragonscanning

允许龙在栖息模式下四处寻找玩家进行攻击。只能由末影龙使用。
返回顶部

minecraft:behavior.dragontakeoff

允许龙停止栖息并四处飞行。只能由末影龙使用。
返回顶部

minecraft:behavior.drink_potion

允许生物根据特定的条件饮用药水。

名称 类型 默认值 描述
potions List 实体可以喝的药水的列表。每个药水条目都有以下参数：
名称 类型 默认值 描述
chance 浮点数 1.0 当搜索要使用的药水时，该药水被选中的几率（从0.0到1.0）。
filters Minecraft 类型 确定是否可以选择此药水时使用的过滤器。
id 整数 -1 药水使用的 ID 。
speed_modifier 浮点数 0.0 实体在喝药水时使用的移动速度修正值。值为0代表速度没有变化。
返回顶部

minecraft:behavior.eat_carried_item

如果生物携带食物，那么生物将吃下它，食物效果将应用于生物。

名称 类型 默认值 描述
delay_before_eating 浮点数 生物在吃掉食物前等待的时间（单位为秒）。
返回顶部

minecraft:behavior.enderman_leave_block

允许末影人放下他们携带的方块。只能由末影人使用。
返回顶部

minecraft:behavior.enderman_take_block

允许末影人搬起方块并携带着四处走动。只能由末影人使用。
返回顶部

minecraft:behavior.explore_outskirts

允许生物探索村庄的外围。

名称 类型 默认值 描述
explore_dist 浮点数 5.0 生物可进入村庄边界的最大距离。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
wait_time 整数 0 生物会站在周围“搜索” POI （兴趣点）的时间。
返回顶部

minecraft:behavior.find_cover

允许生物寻找阴影。

名称 类型 默认值 描述
cooldown_time 浮点数 0.0 生物在再次使用该目标前必须等待的时间（单位为秒）。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.find_mount

允许生物四处寻找另一个生物骑在它上面。

名称 类型 默认值 描述
avoid_water 布尔值 false 当值为"true"时，生物在走向坐骑时将不会进入水中。
mount_distance 浮点数 -1.0 这是生物坐上坐骑需要离所需坐骑的距离，以方块为单位。如果该值低于0，生物将使用其默认的攻击距离。
start_delay 整数 0 生物在开始向坐骑移动前等待的时间。
target_needed 布尔值 false 当值为"true"时，生物将在有目标的情况下只会寻找坐骑。
within_radius 浮点数 0.0 生物寻找一个坐骑的距离（以方块为单位）。
返回顶部

minecraft:behavior.find_underwater_treasure

允许生物向最近的水下废墟或沉船移动。

名称 类型 默认值 描述
search_range 整数 0 生物在废墟或沉船内移动来搜索宝箱的范围。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
stop_distance 浮点数 2.0 生物在停止前会移动的距离。
返回顶部

minecraft:behavior.flee_sun

允许生物逃离阳光直射并寻求阴影。

名称 类型 默认值 描述
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.float

允许生物在游泳时保持漂浮。
返回顶部

minecraft:behavior.float_wander

允许生物如恶魂一样飘浮游动。

名称 类型 默认值 描述
float_duration 范围 [a, b] [0.0, 0.0] 生物在落地和选择做其他事情之前飘浮的时间范围（单位为秒）。
must_reach 布尔值 false 当值为"true"时，可到达的地点才能成为有效的目标。
random_reselect 布尔值 false 当值为"true"时，生物将随机挑选一个新的地点，同时飘浮到先前选定的地点。
注：恶魂的生物 AI 在寻路时是找定点的，如果此项为 true 则会进行随机游走类似的飘浮
xz_dist 整数 10 生物在地面上寻找新的移动点的距离（以方块为单位）。至少是1。
y_dist 整数 7 生物向上或向下寻找新的移动点的距离（以方块为单位）。至少是1。
y_offset 浮点数 0.0 要添加到所选目标位置的高度偏移（以方块为单位）。
返回顶部

minecraft:behavior.follow_caravan

允许生物跟随在商队（羊驼队伍）中的生物。

名称 类型 默认值 描述
entity_count 整数 1 可在商队中的实体数量。
entity_types JSON对象 在商队中可以跟随的实体类型列表。
名称 类型 默认值 描述
filters Minecraft 类型 使列表中的该标签有效的条件。
max_dist 浮点数 16 生物可以离开商队的最大距离。
must_see 布尔值 false 当值为"true"时，商队中的生物必须可见。
must_see_forget_duration 布尔值 3.0 决定该生物在失去一个目标并在目标不再可见时重新寻找一个新的目标之前所需的时间（单位为秒）。
sprint_speed_multiplier 浮点数 1.0 生物跑步速度的乘子。值为1.0意味着速度没有变化。
walk_speed_multiplier 浮点数 1.0 生物行走速度的乘子。值为1.0意味着速度没有变化。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.follow_mob

允许生物跟随其他生物。

名称 类型 默认值 描述
search_range 整数 0 生物寻找被跟随生物的距离（以方块为单位）。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
stop_distance 浮点数 2.0 生物在跟随时与它所跟随的生物的距离（以方块为单位）。
返回顶部

minecraft:behavior.follow_owner

允许生物跟随是它们主人的玩家。

名称 类型 默认值 描述
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
start_distance 浮点数 10.0 在生物开始跟踪主人之前，主人可以离开该生物的最远距离（以方块为单位）。
stop_distance 浮点数 2.0 生物在跟随时与它所跟随的主人的距离（以方块为单位）。
返回顶部

minecraft:behavior.follow_parent

允许生物跟随他们的父母到处走动。

名称 类型 默认值 描述
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.follow_target_captain

允许生物向其当前目标队长移动。

名称 类型 默认值 描述
follow_distance 浮点数 0.0 定义生物在跟踪时与目标的距离（以方块为单位）。
within_radius 浮点数 0.0 定义生物在放弃跟踪之前离其目标队长的最大距离（以方块为单位）。
返回顶部

minecraft:behavior.go_home

允许生物移动回他们生成的位置。

名称 类型 默认值 描述
goal_radius 浮点数 0.5 生物认为它已经达到目标的方块内的距离。这是一个可以阻止 AI 为了到达一个特定的地点而来回跳动的冗余量。
interval 整数 120 一个随机值，决定何时随机移动到某处。这有概率为此值分之一的机会来选择该目标。
on_home 字符串 当生物到家时将运行的事件。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.hide

允许一个具有hide组件的生物试图移动到 - 并且藏匿到 - 一个已拥有的或附近的POI。

名称 类型 默认值 描述
duration 浮点数 1.0 此生物反应的时间的数量（以秒为单位）。
poi_type 字符串 定义要藏匿于哪种POI类型。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
timeout_cooldown 浮点数 8.0 在此意向于一个内部错误或超时条件之后被再次使用之前的冷却时间（以秒为单位）。
返回顶部

minecraft:behavior.hold_ground

生物停止运动并看着它的目标生物。

名称 类型 默认值 描述
broadcast 布尔值 false 是否将生物的目标广播给其他同类型的生物。
broadcast_range 浮点数 0.0f 广播范围（以方块为单位）。
min_radius 浮点数 10.0f 生物跑向该目标所必须达到的最小距离。
within_radius_event 字符串 当目标在半径范围内时运行的事件。如果 broadcast 为 true ，该事件就会被广播。
返回顶部

minecraft:behavior.hurt_by_target

允许生物锁定伤害它的生物。

名称 类型 默认值 描述
alert_same_type 布尔值 false 如果值为"true"，附近同类型的生物将被提醒受到有同类受到伤害。
entity_types JSON对象 这生物受到伤害时可以锁定的实体类型列表。
名称 类型 默认值 描述
filters Minecraft 类型 使列表中的该条目有效的条件。
max_dist 浮点数 16 生物锁定实体时可以离开的最大距离。
must_see 布尔值 false 当值为"true"时，实体锁定的目标必须是可见的。
must_see_forget_duration 布尔值 3.0 决定该生物在失去一个目标并在目标不再可见时重新寻找一个新的目标之前所需的时间（单位为秒）。
sprint_speed_multiplier 浮点数 1.0 生物跑步速度的乘子。值为1.0意味着速度没有变化。
walk_speed_multiplier 浮点数 1.0 生物行走速度的乘子。值为1.0意味着速度没有变化。
hurt_owner 布尔值 false 如果值为"true"，该生物将伤害其主人和与自己有相同主人的其他生物。
返回顶部

minecraft:behavior.inspect_bookshelf

允许生物检查书架。

名称 类型 默认值 描述
goal_radius 浮点数 0.5 生物认为它已经达到目标的方块内的距离。这是一个可以阻止 AI 为了到达一个特定的地点而来回跳动的冗余量。
search_count 整数 10 每次检查时，生物会在其搜索范围和高度内检查有效的方块并移动到方块附近。如果数值为0，生物将在一次检查中检查范围内的每个方块。
search_height 整数 1 生物会搜索书架的高度。
search_range 整数 0 生物会寻找书进行检查的距离（以方块为单位）。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.knockback_roar

允许生物进行有伤害的击退，会影响到附近所有的实体。

名称 类型 默认值 描述
触发器 on_roar_end
attack_time 浮点数 0.5 击退后发生的延迟（以秒为单位）。
cooldown_time 浮点数 0.0 生物在再次使用击退前必须等待的时间（以秒为单位）。
duration 浮点数 1.0 吼声的持续时间（以秒为单位）。
knockback_damage 整数 6 击退吼叫所造成的伤害。
knockback_horizontal_strength 整数 4 水平击退的强度。
knockback_range 整数 4 击退的方块距离。
knockback_vertical_strength 整数 4 垂直击退的强度。
返回顶部

minecraft:behavior.lay_down

允许生物躺下。

名称 类型 默认值 描述
interval 整数 120 一个随机值，决定会发生什么随机事件。这有概率为此值分之一的机会来选择该目标。
random_stop_interval 整数 120 一个随机值，决定会结束随机事件。这有概率为此值分之一的机会来选择该目标。
返回顶部

minecraft:behavior.lay_egg

如果生物怀孕了，允许生物在某些类型的方块上产蛋。

名称 类型 默认值 描述
allow_laying_from_below 布尔值 false [实验性] 允许生物从无法到达的目标下方产蛋。如果目标方块是水，上面是空气，这就会很有用，因为生物可能无法到达水上面的空气方块。
egg_type 字符串 minecraft:turtle_egg [实验性] 用于产蛋的方块类型。如果是乌龟蛋，方块中的蛋的数量会随机设置。
goal_radius 浮点数 0.5 生物认为它已经达到目标的方块内的距离。这是一个可以阻止 AI 为了到达一个特定的地点而来回跳动的冗余量。
lay_egg_sound 字符串 lay_egg [实验性] 产蛋的音效名称。默认使用海龟的 lay_egg 。
lay_seconds 浮点数 10.0f [实验性] 产蛋过程的持续时间（以秒为单位）。
on_lay 触发器 生物产蛋时运行的事件。
search_height 整数 1 生物将寻找一个目标块来移动的高度（以方块为单位）。
search_range 整数 0 生物将寻找目标块移动的距离（以方块为单位）。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
target_blocks 数组 [ minecraft:sand ] [实验性] 允许生物在上面产蛋的方块。
target_materials_above_block 数组 [ Air ] [实验性] 目标方块上方可以存在的材料类型。可以为空气、水、岩浆。
use_default_animation 布尔值 true [实验性] 指定在产蛋时是否应播放默认的产蛋动画。
返回顶部

minecraft:behavior.leap_at_target

允许怪物跳向并攻击其目标。只能由敌对生物使用。

名称 类型 默认值 描述
must_be_on_ground 布尔值 true 如果值为"true"，生物将只在地面上向其目标跳跃。如果为"false"，那么它将可以多段跳。
set_persistent 布尔值 false 以玩家为目标之后就会宿存
yd 浮点数 0.0 生物在跳向目标时跳跃的高度（以方块为单位）。
返回顶部

minecraft:behavior.look_at_entity

允许生物看向附近的实体。

名称 类型 默认值 描述
angle_of_view_horizontal 整数 360 生物在Y轴上能看到的角度（以度为单位）。
angle_of_view_vertical 整数 360 生物在X轴上能看到的角度（以度为单位）。
filters Minecraft 类型 决定该生物查看实体的条件的过滤器
look_distance 浮点数 8.0 该实体看向其他实体的距离（以方块为单位）。
look_time 范围 [a, b] [2, 4] 看向实体的时间范围（以秒为单位）。
probability 浮点数 0.02 看向目标的概率，值1.00相当于100%。
返回顶部

minecraft:behavior.look_at_player

允许生物看向附近的玩家。

名称 类型 默认值 描述
angle_of_view_horizontal 整数 360 生物在Y轴上能看到的角度（以度为单位）。
angle_of_view_vertical 整数 360 生物在X轴上能看到的角度（以度为单位）。
look_distance 浮点数 8.0 该实体看向其他实体的距离（以方块为单位）。
look_time 范围 [a, b] [2, 4] 看向实体的时间范围（以秒为单位）。
probability 浮点数 0.02 看向目标的概率，值1.00相当于100%。
返回顶部

minecraft:behavior.look_at_target

允许生物看着他们瞄准的实体。

名称 类型 默认值 描述
angle_of_view_horizontal 整数 360 生物在Y轴上能看到的角度（以度为单位）。
angle_of_view_vertical 整数 360 生物在X轴上能看到的角度（以度为单位）。
look_distance 浮点数 8.0 该实体看向其他实体的距离（以方块为单位）。
look_time 范围 [a, b] [2, 4] 看向实体的时间范围（以秒为单位）。
probability 浮点数 0.02 看向目标的概率，值1.00相当于100%。
返回顶部

minecraft:behavior.look_at_trading_player

允许生物看着正在与他们交易的玩家。

名称 类型 默认值 描述
angle_of_view_horizontal 整数 360 生物在Y轴上能看到的角度（以度为单位）。
angle_of_view_vertical 整数 360 生物在X轴上能看到的角度（以度为单位）。
look_distance 浮点数 8.0 该实体看向其他实体的距离（以方块为单位）。
look_time 范围 [a, b] [2, 4] 看向实体的时间范围（以秒为单位）。
probability 浮点数 0.02 看向目标的概率，值1.00相当于100%。
返回顶部

minecraft:behavior.make_love

允许村民寻找配偶来繁殖其他村民。只能供村民使用。
返回顶部

minecraft:behavior.mingle

允许一个实体去村庄钟的位置与其他实体交谈。

名称 类型 默认值 描述
cooldown_time 浮点数 0.0 生物在再次使用该目标前必须等待的时间（单位为秒）。
duration 浮点数 1.0 实体将与另一实体聊天的时间（单位为秒）
mingle_distance 浮点数 2.0f 该实体与交谈对象之间的距离。如果两个实体种类不同，则两个实体上的该值必须相同。
mingle_partner_type List empty 允许此实体与之交谈的实体类型
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.mount_pathing

允许生物在寻找攻击目标时自行移动。

名称 类型 默认值 描述
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
target_dist 浮点数 0.0 此生物想要远离目标的距离
track_target 布尔值 false 如果为 true ，只要目标是有效目标，此生物就会追逐目标
返回顶部

minecraft:behavior.move_through_village

只能供村民使用。允许村民穿过村庄周围道路。

名称 类型 默认值 描述
only_at_night 布尔值 false 如果为 true ，村民只会在夜间穿过村庄
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.move_to_block

允许生物向一个方块移动。

名称 类型 默认值 描述
goal_radius 浮点数 0.5 生物认为它已经达到目标的方块内的距离。这是一个可以阻止 AI 为了到达一个特定的地点而来回跳动的冗余量。
on_reach 触发器 到达该方块后运行的事件。
on_stay_completed 触发器 在方块停留时间达到 stay_duration 后运行的事件。
search_height 整数 1 生物会搜索方块的高度（以方块为单位）。
search_range 整数 0 生物会搜索方块的范围（以方块为单位）。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
start_chance 浮点数 1.0 开始该行为的概率（在每个随机刻更新后应用）。
stay_duration 浮点数 0.0 完成停留在方块上的时间（以刻为单位）。
target_blocks List 要移动到的方块类型
target_offset 向量 [a, b, c] [0, 0, 0] 添加到目标位置的偏移量。
target_selection_method 字符串 nearest 寻找符合要求的方块的种类。有效值是"random（随机）"和"nearest（最接近）"。
tick_interval 整数 20 尝试运行该行为的平均间隔时间（以刻为单位）。
返回顶部

minecraft:behavior.move_to_land

允许生物在水中返回陆地。

名称 类型 默认值 描述
goal_radius 浮点数 0.5 生物认为它已经达到目标的方块内的距离。这是一个可以阻止 AI 为了到达一个特定的地点而来回跳动的冗余量。
search_count 整数 10 生物会每刻在其搜索范围和高度内检查有效的方块并移动到方块附近。如果数值为0，生物将在一刻中检查范围内的每个方块。
search_height 整数 1 生物会搜索陆地的高度（以方块为单位）。
search_range 整数 0 生物会搜索陆地的范围（以方块为单位）。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.move_to_lava

允许生物在陆地中返回岩浆。

名称 类型 默认值 描述
goal_radius 浮点数 0.5 生物认为它已经达到目标的方块内的距离。这是一个可以阻止 AI 为了到达一个特定的地点而来回跳动的冗余量。
search_count 整数 10 生物会每刻在其搜索范围和高度内检查有效的方块并移动到方块附近。如果数值为0，生物将在一刻中检查范围内的每个方块。
search_height 整数 1 生物会搜索岩浆的高度（以方块为单位）。
search_range 整数 0 生物会搜索岩浆的范围（以方块为单位）。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.move_to_liquid

允许生物在陆地上移动到液体中。

名称 类型 默认值 描述
goal_radius 浮点数 0.5 生物认为它已经达到目标的方块内的距离。这是一个可以阻止 AI 为了到达一个特定的地点而来回跳动的冗余量。
material_type 字符串 Any 要查找的液体方块的材质类型。有效值为“Any”、“Water”和“Lava”。
search_count 整数 10 生物会每刻在其搜索范围和高度内检查有效的方块并移动到方块附近。如果数值为0，生物将在一刻中检查范围内的每个方块。
search_height 整数 1 生物会搜索液体的高度（以方块为单位）。
search_range 整数 0 生物会搜索液体的范围（以方块为单位）。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.move_to_poi

在该生物可以的情况下，允许它移动到一个POI。

名称 类型 默认值 描述
poi_type 字符串 向意向表明它应该寻找哪种POI类型。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.move_to_random_block

允许生物移动到随机方块上

名称 类型 默认值 描述
block_distance 浮点数 16.0 定义将选择要移动上去的方块于生物的距离（以方块为单位）。
within_radius 浮点数 0.0 定义生物完成运动离方块的距离。
返回顶部

minecraft:behavior.move_to_village

允许生物移动到村庄里的一个随机位置

名称 类型 默认值 描述
cooldown_time 浮点数 0.0 生物在再次使用该目标前必须等待的时间（单位为秒）。
goal_radius 浮点数 0.5 生物认为它已经达到目标的方块内的距离。这是一个可以阻止 AI 为了到达一个特定的地点而来回跳动的冗余量。
search_range 整数 0 寻找村庄的距离，如果小于等于0，那么会无视距离移动到最近的村庄。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.move_to_water

允许生物在陆地上返回水中。

名称 类型 默认值 描述
goal_radius 浮点数 0.5 生物认为它已经达到目标的方块内的距离。这是一个可以阻止 AI 为了到达一个特定的地点而来回跳动的冗余量。
search_count 整数 10 生物会每刻在其搜索范围和高度内检查有效的方块并移动到方块附近。如果数值为0，生物将在一刻中检查范围内的每个方块。
search_height 整数 1 生物会搜索水的高度（以方块为单位）。
search_range 整数 0 生物会搜索水的范围（以方块为单位）。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.move_towards_target

允许生物向当前目标移动。

名称 类型 默认值 描述
within_radius 浮点数 0.0 定义生物离目标的距离。值为0表示它试图占用与目标相同的方块
返回顶部

minecraft:behavior.nap

允许生物在特定条件下偶尔停下来打个盹。

名称 类型 默认值 描述
cooldown_max 浮点数 0.0 生物在再次使用该目标前必须等待的最大时间（单位为秒）。
cooldown_min 浮点数 0.0 生物在再次使用该目标前必须等待的最小时间（单位为秒）。
mob_detect_dist 浮点数 6.0 该生物将要检测的生物在X和Z轴中的距离（以方块为单位）。
mob_detect_height 浮点数 6.0 该生物将要检测的生物在Y轴中的距离（以方块为单位）。
返回顶部

minecraft:behavior.nearest_attackable_target

允许一个实体在特定目标类型的集中攻击最近的目标。

名称 类型 默认值 描述
attack_interval 整数 0 搜索攻击目标的时间范围（单位为秒），范围在(0,"attack_interval"]之间。只在 "attack_interva "大于0时使用，否则使用 "scan_interval"。
attack_interval_min 整数 0 "attack_interval"的别名，提供与"attack_interval"相同的功能。
attack_owner 布尔值 false 如果值为"true"，生物可以伤害自己的主人。
entity_types JSON对象 过滤哪些类型的目标对该实体有效。
名称 类型 默认值 描述
filters Minecraft 类型 使该目标成为有效类型的条件。
max_dist 浮点数 16 为了成为一个有效的目标选择，目标距离实体的距离不得大于该值。
must_see 布尔值 false 确定目标有效性的生效条件是要求该实体只在范围内，还是既在范围内又在视线内。
must_see_forget_duration 布尔值 3.0 目标不被该实体看到而失效的时间（以秒为单位）。只在"must_see"为 true 时使用。
must_reach 布尔值 false 如果值为"true"，生物需要一条通往目标的路径。
must_see 布尔值 false 确定目标有效性的生效条件是要求该实体只在范围内，还是既在范围内又在视线内。
must_see_forget_duration 浮点数 3.0 目标不被该实体看到而失效的时间（以秒为单位）。只在"must_see"为 true 时使用。
persist_time 浮点数 0.0 在目标不再有效后，该实体可以继续攻击目标的时间（以秒为单位）。
reselect_targets 布尔值 false 允许攻击实体更新最近的目标，否则只有在每次"scan_interval"或"attack_interval"之后才会重新选择一个目标。
scan_interval 整数 10 如果"attack_interval"是0或者没有声明，那么在两次攻击之间，每"scan_interval"刻就会扫描一个新的目标，最小值是1。低于10的值会影响性能。
set_persistent 布尔值 false 以玩家为目标之后就会宿存
target_invisible_multiplier 浮点数 0.7 与目标的装甲穿戴率相乘，在检测隐形目标时修改"max_dist"。
target_search_height 浮点数 -1.0 最大垂直目标搜索距离，如果它大于目标类型的"max_dist"。负值默认为"entity_types"最大的"max_dist"。
target_sneak_visibility_multiplier 浮点数 0.8 当实体试图检测潜行目标时，与目标类型的"max_dist "相乘。
within_radius 浮点数 0.0 该实体在跟随目标时可以与目标的最大距离，否则目标会失效。该值只在实体没有声明"minecraft:follow_range"时使用。
返回顶部

minecraft:behavior.nearest_prioritized_attackable_target

允许生物检查并追踪最近的有效目标。

名称 类型 默认值 描述
attack_interval 整数 0 选择目标前等待的时间（单位为秒）
entity_types JSON对象 此实体认为有效目标的实体类型列表
名称 类型 默认值 描述
filters Minecraft 类型 使列表中的该条目有效的条件。
max_dist 浮点数 16 生物锁定实体时可以离开的最大距离。
must_see 布尔值 false 当值为"true"时，实体锁定的目标必须是可见的。
must_see_forget_duration 布尔值 3.0 决定该生物在失去一个目标并在目标不再可见时重新寻找一个新的目标之前所需的时间（单位为秒）。
sprint_speed_multiplier 浮点数 1.0 生物跑步速度的乘子。值为1.0意味着速度没有变化。
walk_speed_multiplier 浮点数 1.0 生物行走速度的乘子。值为1.0意味着速度没有变化。
must_reach 布尔值 false 当值为"true"时，可到达的实体才能成为有效的目标。
must_see 布尔值 false 当值为"true"时，实体锁定的目标必须是可见的。
must_see_forget_duration 浮点数 3.0 决定该生物在失去一个目标并在目标不再可见时重新寻找一个新的目标之前所需的时间（单位为秒）。
persist_time 浮点数 0.0f 在目标不再有效后，该实体可以继续攻击目标的时间（以秒为单位）。
priority 整数 0 指定被过滤的敌人类型应该被攻击的优先级。数字越小意味着越优先。
reselect_targets 布尔值 false 如果为 true ，则当其他实体更接近时，目标将更改为当前最近的实体
scan_interval 整数 10 在对两次扫描目标之间要等待多少刻。
set_persistent 布尔值 false 以玩家为目标之后就会宿存
target_search_height 浮点数 -1.0f 搜索目标生物的高度（以方块为单位），-1.0f意味着高度不重要。
within_radius 浮点数 0.0 目标可在其中发起攻击的距离（以方块为单位）。
返回顶部

minecraft:behavior.ocelot_sit_on_block

允许生物能够像豹猫一样坐在原地。

名称 类型 默认值 描述
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.offer_flower

允许生物能够像铁傀儡一样向玩家提供一朵花。
返回顶部

minecraft:behavior.open_door

允许生物打开门。这要求生物能够通过门，否则生物不会尝试打开门。

名称 类型 默认值 描述
close_door_after 布尔值 true 如果值为"true"，生物会在穿过门之后关门。
返回顶部

minecraft:behavior.owner_hurt_by_target

允许生物锁定另一个伤害其主人的生物。

名称 类型 默认值 描述
entity_types JSON对象 允许生物锁定另一个伤害其主人的生物的列表。
名称 类型 默认值 描述
filters Minecraft 类型 使列表中的该条目有效的条件。
max_dist 浮点数 16 生物锁定实体时可以离开的最大距离。
must_see 布尔值 false 当值为"true"时，实体锁定的目标必须是可见的。
must_see_forget_duration 布尔值 3.0 决定该生物在失去一个目标并在目标不再可见时重新寻找一个新的目标之前所需的时间（单位为秒）。
sprint_speed_multiplier 浮点数 1.0 生物跑步速度的乘子。值为1.0意味着速度没有变化。
walk_speed_multiplier 浮点数 1.0 生物行走速度的乘子。值为1.0意味着速度没有变化。
返回顶部

minecraft:behavior.owner_hurt_target

允许生物锁定被其主人伤害的生物。

名称 类型 默认值 描述
entity_types JSON对象 允许生物锁定被其主人伤害的生物的列表。
名称 类型 默认值 描述
filters Minecraft 类型 使列表中的该条目有效的条件。
max_dist 浮点数 16 生物锁定实体时可以离开的最大距离。
must_see 布尔值 false 当值为"true"时，实体锁定的目标必须是可见的。
must_see_forget_duration 布尔值 3.0 决定该生物在失去一个目标并在目标不再可见时重新寻找一个新的目标之前所需的时间（单位为秒）。
sprint_speed_multiplier 浮点数 1.0 生物跑步速度的乘子。值为1.0意味着速度没有变化。
walk_speed_multiplier 浮点数 1.0 生物行走速度的乘子。值为1.0意味着速度没有变化。
返回顶部

minecraft:behavior.panic

允许生物进入恐慌状态，使其四处奔跑，远离使其进入此状态的危害源。

名称 类型 默认值 描述
damage_sources List all 将导致该生物恐慌的实体危害源列表。
force 布尔值 false 如果值为"true"，该生物将不会停止恐慌，直到它不能再移动或意向从它身上移走。
ignore_mob_damage 布尔值 false 如果值为"true"，该生物将不会对来自其他生物的伤害做出反应而恐慌。这覆盖了“危害源”中的伤害类型。
prefer_water 布尔值 false 如果值为"true"，生物会更偏好水于陆地。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.peek

允许生物能够像潜影贝探出壳一样探出头来。
返回顶部

minecraft:behavior.pet_sleep_with_owner

允许宠物在主人睡觉时移动到床上。

名称 类型 默认值 描述
goal_radius 浮点数 0.5 生物认为它已经达到目标的方块内的距离。这是一个可以阻止 AI 为了到达一个特定的地点而来回跳动的冗余量。
search_height 整数 1 生物可以和主人同睡时离主人的高度（以方块为单位）。
search_range 整数 0 生物可以和主人同睡时离主人的范围（以方块为单位）。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.pickup_items

允许生物从地上捡起物品。

名称 类型 默认值 描述
can_pickup_any_item 布尔值 false 如果值为"true"，生物可以从地上捡起任何物品。
can_pickup_to_hand_or_equipment 布尔值 true 如果值为"true"，生物可以从地上捡起物品拿在手上或装备进装备槽。
excluded_items List 允许生物从地上捡起物品的列表。
goal_radius 浮点数 0.5 生物认为它已经达到目标的方块内的距离。这是一个可以阻止 AI 为了到达一个特定的地点而来回跳动的冗余量。
max_dist 浮点数 0.0 生物会寻找物品捡起的最大距离（以方块为单位）。
pickup_based_on_chance 布尔值 false 如果值为"true"，生物可能应难度的不同而有随机的机会无法捡起物品。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
track_target 布尔值 false 如果值为"true"，只要是有效的目标，生物就会追赶它。
返回顶部

minecraft:behavior.play

允许生物与其他小村民玩♂耍。只能由村民使用。

名称 类型 默认值 描述
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.player_ride_tamed

允许生物在被驯服后可以由玩家骑乘。
返回顶部

minecraft:behavior.raid_garden

允许生物吃/抢夺农场里的农作物，直到吃饱为止。

名称 类型 默认值 描述
blocks List 生物吃/抢夺的方块类型。
eat_delay 整数 2 每次吃/抢夺之间的间隔时间。
full_delay 整数 100 该生物吃饱后，想再吃/抢夺的时间（以秒为单位）。
goal_radius 浮点数 0.5 生物认为它已经达到目标的方块内的距离。这是一个可以阻止 AI 为了到达一个特定的地点而来回跳动的冗余量。
initial_eat_delay 整数 0 在它到达后开始吃/抢夺的时间（以秒为单位）。
max_to_eat 整数 6 该实体想吃/抢夺的作物的最大数量。如果设置为0或更少，那么它就没有最大数量。
search_range 整数 0 生物会寻找农作物来吃的最大距离（以方块为单位）。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.random_breach

允许生物随机地跳出水面。

名称 类型 默认值 描述
cooldown_time 浮点数 0.0 生物在再次使用该目标前必须等待的时间（单位为秒）。
interval 整数 120 一个随机值，决定何时随机移动到某处。这有概率为此值分之一的机会来选择该目标。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
xz_dist 整数 10 生物在XZ平面上寻找新的移动点的距离（以方块为单位）。必须至少是1。
y_dist 整数 7 生物在Y轴上寻找新的移动点的距离（以方块为单位）。必须至少是1。
返回顶部

minecraft:behavior.random_fly

允许生物在地面上附近随机盘旋。

名称 类型 默认值 描述
can_land_on_trees 布尔值 true 如果值为"true"，生物可以停在树上而不是地上。
xz_dist 整数 10 生物在XZ平面上寻找新的移动点的距离（以方块为单位）。必须至少是1。
y_dist 整数 7 生物在Y轴上寻找新的移动点的距离（以方块为单位）。必须至少是1。
返回顶部

妈的，我家猫抢我牛轧糖吃。
--by CMWither

minecraft:behavior.random_hover

允许生物随机飞翔。

名称 类型 默认值 描述
hover_height 范围 [a, b] 生物将会保持的离地距离。
interval 整数 120 一个随机值，决定何时随机移动到某处。这有概率为此值分之一的机会来选择该目标。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
xz_dist 整数 10 生物在XZ平面上寻找新的移动点的距离（以方块为单位）。必须至少是1。
y_dist 整数 7 生物在Y轴上寻找新的移动点的距离（以方块为单位）。必须至少是1。
y_offset 浮点数 0.0 要添加到所选目标位置的高度偏移（以方块为单位）。
返回顶部

minecraft:behavior.random_look_around

允许生物随机环顾四周。

名称 类型 默认值 描述
look_time 范围 [a, b] [2, 4] 生物在寻找其他位置之前会一直向随机方向看的时间范围（以秒为单位）
返回顶部

minecraft:behavior.random_look_around_and_sit

允许生物随机坐下并环顾四周一段时间。注： 必须设置坐姿动画才能使用此功能。

名称 类型 默认值 描述
max_look_count 整数 2 生物在环顾四周时拥有的独特外观的最大数量。
max_look_time 整数 40 生物在环顾四周时保持注视方向的最长时间（以刻为单位）。
min_look_count 整数 1 生物在环顾四周时将具有的最小独特外观数量。
min_look_time 整数 20 生物在环顾四周时保持注视方向的最短时间（以刻为单位）。
probability 整数 0.02 随机环顾四周/坐着的概率。
返回顶部

minecraft:behavior.random_sitting

允许生物随机坐下一段时间。

名称 类型 默认值 描述
cooldown_time 浮点数 0.0 生物在再次使用该目标前必须等待的时间（单位为秒）。
min_sit_time 浮点数 10 生物可以站起来之前的最短时间（以秒为单位）
start_chance 浮点数 0.1 这是生物开始该目标的几率，从 0 到 1
stop_chance 浮点数 0.3 这是生物停止此目标的几率，从 0 到 1
返回顶部

minecraft:behavior.random_stroll

允许生物随机四处走动。

名称 类型 默认值 描述
interval 整数 120 一个随机值，用于确定何时随机移动到某个位置。这有概率为此值分之一的机会选择此目标
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
xz_dist 整数 10 生物在地面上寻找新位置移动的距离（以方块为单位）。必须至少为 1
y_dist 整数 7 生物将向上或向下查找要移动到的新位置的距离（以方块为单位）。必须至少为 1
返回顶部

minecraft:behavior.random_swim

允许实体在水中随机移动

名称 类型 默认值 描述
avoid_surface 布尔值 true 如果为 true，生物会避免浮出水面（待验证）
interval 整数 120 一个随机值，用于确定何时随机移动到某个位置。这有概率为此值分之一的机会选择此目标
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
xz_dist 整数 10 生物在地面上寻找新位置移动的距离（以方块为单位）。必须至少为 1
y_dist 整数 7 生物将向上或向下查找要移动到的新位置的距离（以方块为单位）。必须至少为 1
返回顶部

minecraft:behavior.receive_love

允许村民停下来，以便其他村民可以与它繁殖。只能由村民使用。
返回顶部

minecraft:behavior.restrict_open_door

允许生物在夜间待在室内。
返回顶部

minecraft:behavior.restrict_sun

允许生物自动避开阳光。
返回顶部

minecraft:behavior.rise_to_liquid_level

允许生物在水中悬浮

名称 类型 默认值 描述
liquid_y_offset 浮点数 0.0 Target distance down from the liquid surface. i.e. Positive values move the target Y down.
rise_delta 浮点数 0.0 Movement up in Y per tick when below the liquid surface.
sink_delta 浮点数 0.0 Movement down in Y per tick when above the liquid surface.
返回顶部

minecraft:behavior.roll

这允许生物向前滚动。

名称 类型 默认值 描述
probability 浮点数 [1.0] 生物使用目标的概率。
返回顶部

minecraft:behavior.run_around_like_crazy

允许生物漫无目的地四处奔跑。

名称 类型 默认值 描述
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.scared

允许一个生物在外部天气处于雷暴时变为受惊状态。

名称 类型 默认值 描述
sound_interval 整数 0 当该意向以“1/延时”的机会被激活以开始时一个声音将会播放的时间间隔
（原文：The interval in which a sound will play when active in a 1/delay chance to kick off）
返回顶部

minecraft:behavior.send_event

允许 mob 向另一个 mob 发送事件。

名称 类型 默认值 描述
cast_duration 浮点数 Total delay of the steps 整个事件发送过程的时间（以秒为单位）
look_at_target 布尔值 true 如果为 true，则生物将面对它向其发送事件的实体
sequence List 要发送的事件列表
名称 类型 默认值 描述
base_delay 浮点数 0.0 开始此步骤之前的时间（以秒为单位）
event 字符串 要发送到实体的事件
sound_event 字符串 此步骤发生时要播放的声音事件
返回顶部

minecraft:behavior.share_items

允许生物将其拥有的物品赠予其他人。

名称 类型 默认值 描述
entity_types JSON对象 此生物将与之共享物品的实体列表
名称 类型 默认值 描述
filters Minecraft 类型 使列表中的该条目有效的条件。
max_dist 浮点数 16 生物锁定实体时可以离开的最大距离。
must_see 布尔值 false 当值为"true"时，实体锁定的目标必须是可见的。
must_see_forget_duration 布尔值 3.0 决定该生物在失去一个目标并在目标不再可见时重新寻找一个新的目标之前所需的时间（单位为秒）。
sprint_speed_multiplier 浮点数 1.0 生物跑步速度的乘子。值为1.0意味着速度没有变化。
walk_speed_multiplier 浮点数 1.0 生物行走速度的乘子。值为1.0意味着速度没有变化。
goal_radius 浮点数 0.5 生物认为它已经达到目标的方块内的距离。这是一个可以阻止 AI 为了到达一个特定的地点而来回跳动的冗余量。
max_dist 浮点数 0.0 此生物将寻找可与之共享物品的实体的最大距离（以方块为单位）
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.silverfish_merge_with_stone

允许生物像蠹虫一样进入石块。目前它只能由蠹虫使用。
返回顶部

minecraft:behavior.silverfish_wake_up_friends

允许生物提醒附近方块中的生物出来。目前它只能由蠹虫使用。
返回顶部

minecraft:behavior.skeleton_horse_trap

允许马生物成为陷阱马并像它们一样被触发，当玩家在附近时生成一个闪电和一群骷髅骑士。只能由马、骡、驴和骷髅马使用。

名称 类型 默认值 描述
duration 浮点数 1.0 陷阱存在的时间量（以秒为单位）。经过这段时间后，如果陷阱尚未激活，则会从世界中移除
within_radius 浮点数 0.0 玩家触发陷阱马的距离（以方块为单位）
返回顶部

minecraft:behavior.sleep

允许拥有床的村庄中的生物移动到其中并睡在其中。

名称 类型 默认值 描述
cooldown_time 浮点数 0.0 生物在再次使用该目标前必须等待的时间（单位为秒）。
sleep_collider_height 浮点数 1.0 生物的碰撞箱在休眠时的高度
sleep_collider_width 浮点数 1.0 生物的碰撞箱在休眠时的宽度
sleep_y_offset 浮点数 1.0 生物碰撞箱在休眠时的 y 偏移量
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
timeout_cooldown 浮点数 8.0 The cooldown time in seconds before the goal can be reused after a internal failure or timeout condition
返回顶部

minecraft:behavior.slime_attack

只能由史莱姆和岩浆怪使用。允许生物使用像史莱姆一样的近战攻击。

名称 类型 默认值 描述
set_persistent 布尔值 false 以玩家为目标之后就会宿存
返回顶部

minecraft:behavior.snacking

允许生物吃它在附近找到的食物。

名称 类型 默认值 描述
items List 感兴趣的零食
snacking_cooldown 浮点数 7.5 生物再次能够吃零食之前的冷却时间（以秒为单位）
snacking_cooldown_min 浮点数 0.5f 生物能够再次吃零食之前的最短冷却时间（以秒为单位）
snacking_stop_chance 浮点数 0.0017 这是生物停止吃零食的几率，范围从 0 到 1
返回顶部

minecraft:behavior.sneeze

允许生物停下来并打喷嚏，可能会惊吓附近的生物并掉落物品。

名称 类型 默认值 描述
cooldown_time 浮点数 0.0 生物在再次使用该目标前必须等待的时间（单位为秒）。
drop_item_chance 浮点数 1.0 生物打喷嚏时掉落物品的概率。
entity_types JSON对象 此生物在打喷嚏时会惊吓（导致跳跃）的实体类型列表。
名称 类型 默认值 描述
filters Minecraft 类型 使列表中的该条目有效的条件。
max_dist 浮点数 16 生物锁定实体时可以离开的最大距离。
must_see 布尔值 false 当值为"true"时，实体锁定的目标必须是可见的。
must_see_forget_duration 布尔值 3.0 决定该生物在失去一个目标并在目标不再可见时重新寻找一个新的目标之前所需的时间（单位为秒）。
sprint_speed_multiplier 浮点数 1.0 生物跑步速度的乘子。值为1.0意味着速度没有变化。
walk_speed_multiplier 浮点数 1.0 生物行走速度的乘子。值为1.0意味着速度没有变化。
loot_table 字符串 战利品表，从中选择掉落的物品。
prepare_sound 字符串 即将打喷嚏时播放的声音。
prepare_time 浮点数 1.0 生物准备打喷嚏所需的时间（以秒为单位）（当 prepare_sound 正在播放时）。
probability 浮点数 0.02 打喷嚏的概率。值 1.00 为 100%
sound 字符串 打喷嚏时播放的声音。
within_radius 浮点数 0.0 生物会被惊吓的距离（以方块为单位）
返回顶部

minecraft:behavior.squid_dive

允许鱿鱼潜入水中。只能由鱿鱼使用。
返回顶部

minecraft:behavior.squid_flee

让鱿鱼游走。只能由鱿鱼使用。
返回顶部

minecraft:behavior.squid_idle

允许鱿鱼在原地闲置地游泳。只能由鱿鱼使用。
返回顶部

minecraft:behavior.squid_move_away_from_ground

允许鱿鱼从地面移回水中。只能由鱿鱼使用。
返回顶部

minecraft:behavior.squid_out_of_water

允许鱿鱼在出水时粘在地面上。只能由鱿鱼使用。
返回顶部

minecraft:behavior.stalk_and_pounce_on_target

允许生物跟踪目标，然后在范围内猛扑目标，成功后目标将受到攻击，造成由攻击组件定义的伤害。失败时，生物将面临卡住的风险

名称 类型 默认值 描述
interest_time 浮点数 2.0 生物在猛扑之前感兴趣的时间量。当生物在猛扑范围内时，就会发生这种情况
leap_distance 浮点数 0.8 The distance in blocks the mob jumps in the direction of its target
leap_height 浮点数 0.9 The height in blocks the mob jumps when leaping at its target
max_stalk_dist 浮点数 10.0 在放弃跟踪之前，目标可以达到的最大距离
pounce_max_dist 浮点数 5.0 开始向目标猛扑的最大距离（以方块为单位）
set_persistent 布尔值 false 以玩家为目标之后就会宿存
stalk_speed 浮点数 1.2 跟踪目标的移动速度
strike_dist 浮点数 2.0 从突袭处着陆时，距离目标的最大距离，这仍然会导致对目标造成伤害
stuck_time 浮点数 2.0 如果生物失败并降落在他们可以卡住的方块上，他们将被卡住的时间
返回顶部

minecraft:behavior.stay_while_sitting

允许生物在坐着时保持原地不动，而不是做其他事情。
返回顶部

minecraft:behavior.stomp_turtle_egg

允许此生物践踏海龟蛋

名称 类型 默认值 描述
goal_radius 浮点数 0.5 生物认为它已经达到目标的方块内的距离。这是一个可以阻止 AI 为了到达一个特定的地点而来回跳动的冗余量。
interval 整数 120 一个随机值，用于确定何时随机移动到某个位置。这有概率为此值分之一的机会选择此目标
search_height 整数 1 生物会寻找海龟蛋移动的高度（以方块为单位）
search_range 整数 0 生物会寻找海龟蛋移动的距离（以方块为单位）
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.stroll_towards_village

允许生物移动到搜索范围内的村庄内的随机位置。

名称 类型 默认值 描述
cooldown_time 浮点数 0.0 生物在再次使用该目标前必须等待的时间（单位为秒）。
goal_radius 浮点数 0.5 生物认为它已经达到目标的方块内的距离。这是一个可以阻止 AI 为了到达一个特定的地点而来回跳动的冗余量。
search_range 整数 0 在村庄内搜索点的距离（以方块为单位）。如果 <= 0，则无论距离如何，都查找最近的村庄。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
start_chance 浮点数 0.1 这是生物开始该目标的几率，从 0 到 1
返回顶部

minecraft:behavior.summon_entity

允许生物通过召唤其他实体来攻击玩家。

名称 类型 默认值 描述
summon_choices List 生物用来召唤实体的法术列表。每个法术都有以下参数：
名称 类型 默认值 描述
cast_duration 浮点数 步骤的总延迟 施法需要的时间（以秒为单位）
cooldown_time 浮点数 0.0 生物在再次使用该法术之前必须等待的时间（以秒为单位）
do_casting 布尔值 true 如果为 true，则生物将执行施法动画并渲染法术粒子
filters Minecraft 类型
max_activation_range 浮点数 32.0 此法术的激活距离上限（以方块为单位）不得为负数。
min_activation_range 浮点数 1.0 此法术的激活距离的下限（以方块为单位）不得为负数。
particle_color 整数 0 此法术的粒子颜色
sequence List 法术的步骤列表。每个步骤都有以下参数：
名称 类型 默认值 描述
base_delay 浮点数 0.0 开始前等待的时间（以秒为单位）
delay_per_summon 浮点数 0.0 召唤每个实体需要的时间（以秒为单位）
entity_lifespan 浮点数 -1.0 生成的实体将处于活动状态的时间（以秒为单位）。值 -1.0 表示它将尽可能长时间地保持活动状态
entity_type 字符串 生成的实体类型
num_entities_spawned 整数 1 生成的实体数量
shape 字符串 line 基本形状。有效值为 circle 和 line
size 浮点数 1.0 生成实体的体型
sound_event 字符串 要播放的声音事件
summon_cap 整数 0 召唤出来的实体同时存在的最大数量
summon_cap_radius 浮点数 0.0 召唤范围半径
target 字符串 self 法术的目标。这是咒语开始的地方（line 从这里开始，circle 在这里居中）
start_sound_event 字符串 使用此法术时要播放的声音事件
weight 浮点数 0.0 该咒语的权重。
返回顶部

minecraft:behavior.swell

允许苦力怕在附近有玩家时膨胀。它只能由苦力怕使用。

名称 类型 默认值 描述
start_distance 浮点数 10.0 开始膨胀的距离
stop_distance 浮点数 2.0 停止膨胀的距离
返回顶部

minecraft:behavior.take_flower

只能由村民使用。允许生物接受铁傀儡的花。
返回顶部

minecraft:behavior.tempt

允许生物被他们喜欢的食物诱惑。

名称 类型 默认值 描述
can_get_scared 布尔值 false 如果为 true，则如果玩家靠近该生物时移动得太快，该生物可以停止受到诱惑
can_tempt_vertically 布尔值 false 如果为 true，则在诱惑时将考虑与玩家的垂直距离。
can_tempt_while_ridden 布尔值 false 如果为 true，则即使该生物有乘客（即被骑乘）也会受到诱惑。
items List 此生物受到诱惑的物品列表
sound_interval 范围 [a, b] [0.0, 0.0] 在 tempt 声音之间等待的随机刻度范围。
（原文：Range of random ticks to wait between tempt sounds.）
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
tempt_sound 字符串 当生物受到诱惑时播放的声音。
within_radius 浮点数 0.0 该生物可能会受到手持他们喜欢的物品的玩家的诱惑的距离（以方块为单位）
返回顶部

minecraft:behavior.trade_interest

允许生物看着持有可交易物品的玩家。

名称 类型 默认值 描述
carried_item_switch_time 浮点数 2.0 交易者在尝试切换到进行相同交易的不同物品之前持有物品的最长时间（以秒为单位）
cooldown 浮点数 2.0 再次查看的冷却时间（以秒为单位）
interest_time 浮点数 45.0 交易者有兴趣显示其交易项目的最长时间（以秒为单位）
remove_item_time 浮点数 1.0 当您不再有物品可交易时，交易者将等待的最长时间（以秒为单位）
within_radius 浮点数 0.0 感兴趣的距离（以方块为单位）
返回顶部

minecraft:behavior.trade_with_player

允许玩家与此生物进行交易。
返回顶部

minecraft:behavior.vex_copy_owner_target

允许生物将其所有者所敌对的同一实体作为目标。

名称 类型 默认值 描述
entity_types JSON对象 此生物可以复制所有者敌意的实体列表
名称 类型 默认值 描述
filters Minecraft 类型 使列表中的该条目有效的条件。
max_dist 浮点数 16 生物锁定实体时可以离开的最大距离。
must_see 布尔值 false 当值为"true"时，实体锁定的目标必须是可见的。
must_see_forget_duration 布尔值 3.0 决定该生物在失去一个目标并在目标不再可见时重新寻找一个新的目标之前所需的时间（单位为秒）。
sprint_speed_multiplier 浮点数 1.0 生物跑步速度的乘子。值为1.0意味着速度没有变化。
walk_speed_multiplier 浮点数 1.0 生物行走速度的乘子。值为1.0意味着速度没有变化。
返回顶部

minecraft:behavior.vex_random_move

允许生物像 Vex 一样随机移动。
返回顶部

minecraft:behavior.wither_random_attack_pos_goal

允许凋灵发动随机攻击。只能由凋灵使用。
返回顶部

minecraft:behavior.wither_target_highest_damage

允许凋灵集中攻击对它造成最大伤害的生物。

名称 类型 默认值 描述
entity_types JSON对象 凋灵考虑的实体类型列表，以找出对其造成最大伤害的人
名称 类型 默认值 描述
filters Minecraft 类型 使列表中的该条目有效的条件。
max_dist 浮点数 16 生物锁定实体时可以离开的最大距离。
must_see 布尔值 false 当值为"true"时，实体锁定的目标必须是可见的。
must_see_forget_duration 布尔值 3.0 决定该生物在失去一个目标并在目标不再可见时重新寻找一个新的目标之前所需的时间（单位为秒）。
sprint_speed_multiplier 浮点数 1.0 生物跑步速度的乘子。值为1.0意味着速度没有变化。
walk_speed_multiplier 浮点数 1.0 生物行走速度的乘子。值为1.0意味着速度没有变化。
返回顶部

minecraft:behavior.work

允许该NPC使用他们的工作站POI

名称 类型 默认值 描述
active_time 整数 0 该NPC将会停留在他们的工作地点的刻的数量
can_work_in_rain 布尔值 false 如果为true，一个实体可以在他们的工作站POI位于雨中时工作。
goal_cooldown 整数 0 该意向在可以被再次使用之前冷却的刻的数量
on_arrival 字符串 当该实体到达他们的工作站并且完成工作时要运行的事件。
sound_delay_max 整数 0 一个声音将会播放的最大时间间隔
sound_delay_min 整数 0 一个声音将会播放的最小时间间隔
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
work_in_rain_tolerance 整数 -1 如果“can_work_in_rain”为false，该值为雨不会打断该意向的最大剩余刻数。
返回顶部



特性

minecraft:attack

定义实体的近战攻击及其上的状态效果。

名称 类型 默认值 描述
damage 范围 [a, b] 近战攻击造成的随机伤害量的范围。负值可以治愈实体而不是伤害实体
effect_duration 浮点数 0.0 施加于受击实体的状态效果的持续时间（以秒为单位）
effect_name 字符串 攻击附加的状态效果的标识符
返回顶部

minecraft:spell_effects

定义在添加此组件时要向实体添加和删除的状态效果。

名称 类型 默认值 描述
add_effects List 要添加到此实体的效果列表
名称 类型 默认值 描述
effect 字符串 添加到此实体的状态效果。可用参数有"duration"持续时间（以秒为单位）、"amplifier"效果等级、"ambient"药水粒子是否受环境光照影响、"visible"粒子可见性
remove_effects 字符串 添加此组件后要从此实体中删除的效果标识符列表
返回顶部

minecraft:strength

定义实体携带物品的耐久度。

名称 类型 默认值 描述
max 整数 5 最大耐久
value 整数 1 耐久的初始值
返回顶部



Built-in Events（内置事件）

名称 描述
minecraft:entity_born Event 对通过两个实体繁殖生成的实体调用。
minecraft:entity_spawned 对生成在世界内的实体调用的事件。
minecraft:entity_transformed 对转换为另一个实体的实体调用的事件。
minecraft:on_prime 对其准备爆炸的实体调用的事件。
返回顶部

Components（组件）



minecraft:addrider

将骑手添加到实体。需要 minecraft:rideable。

名称 类型 默认值 描述
entity_type 字符串 将骑乘此实体的实体类型。
spawn_event 字符串 创建乘骑实体时将使用的 spawn 事件。
返回顶部

minecraft:admire_item

使生物在特定时间内无视可攻击的目标。（例：猪灵）

名称 类型 默认值 描述
cooldown_after_being_attacked 整数 0 持续时间，以秒为单位，如果生物受伤，生物不会欣赏物品
duration 整数 10 平息生物的持续时间（以秒为单位）。
返回顶部

minecraft:ageable

为实体添加一个计时器，以便其成长。可以通过为实体提供它喜欢的"feed_items"定义的项来加速它。

名称 类型 默认值 描述
drop_items List 实体长大后掉落的项列表。
duration 浮点数 1200.0 实体长大需要的时间，-1 表示始终是婴儿。
feed_items List 可喂食到实体的项目列表。包括 'item' 作为项目名称，包括 'growth' 来定义它增长的时间
grow_up 字符串 长大时运行的事件
transform_to_item Item 描述 Properties 交互成功后，使用的物品将转换为此项。格式：物品名:数据值
返回顶部

minecraft:angry

使用计时器定义实体的 'angry' 状态。

名称 类型 默认值 描述
angry_sound 字符串 当生物生气时要播放的声音事件
broadcast_anger 布尔值 false 如果为 true，则 broadcast_range 中具有相同实体定义的其他实体也会变得生气
broadcast_anger_on_attack 布尔值 false 如果为 true，则 broadcast_range 中具有相同实体定义的其他实体也会在该生物攻击时变得愤怒
broadcast_anger_on_being_attacked 布尔值 false 如果为 true，则 broadcast_range 中具有相同实体定义的其他实体也会在该生物受到攻击时变得愤怒
broadcast_filters Minecraft 类型 使列表中的该条目有效的条件。
broadcast_range 整数 20 同一实体定义的其他实体将变得生气的距离（以方块为单位）
broadcast_targets List 要向其广播愤怒的实体族列表
calm_event 字符串 在 duration 中指定的秒数过期后运行的事件（当实体停止“生气”时）
duration 整数 25 实体生气的时间（以秒为单位）
duration_delta 整数 0 添加到持续时间的秒数变化 [-delta, delta]（区间范围）
filters Minecraft 类型 过滤掉它在生气时不应该攻击的生物类型（其他猪灵）
sound_interval 范围 [a, b] 0 在再次播放声音之前随机等待的时间范围（以秒为单位）
返回顶部

minecraft:annotation.break_door

允许生物打破门，假设为组件设置了要在导航中使用的标志

名称 类型 默认值 描述
break_time 浮点数 12.0 破门而入所需的时间（以秒为单位）。
min_difficulty 字符串 hard 此实体破门必须达到的最低游戏难度。
返回顶部

minecraft:annotation.open_door

允许生物打开门，前提是为组件设置了要在导航中使用的标志
返回顶部

minecraft:area_attack

对范围内的实体造成伤害的组件。

名称 类型 默认值 描述
cause 字符串 应用于进入伤害范围的实体的伤害类型。
damage_per_tick 整数 2 每刻对进入伤害范围的实体施加多少伤害。
damage_range 浮点数 0.2 敌对实体必须离多近才能施加伤害。
entity_filter Minecraft 类型 在范围内时可有效施加伤害的实体集。
返回顶部

minecraft:attack_cooldown

为生物添加冷却时间。此冷却时间的目的是防止生物试图获取新的攻击目标。

名称 类型 默认值 描述
attack_cooldown_complete_event 触发器 冷却时间完成时要运行的事件。
attack_cooldown_time 范围 [a, b] [0.0, 1.0] 冷却时间（以秒为单位）。可以指定为一个数字或一对数字（最小值和最大值）。
返回顶部

minecraft:barter

使组件能够以易物交换的形式掉落物品。

名称 类型 默认值 描述
barter_table 字符串 用于掉落随机物品的战利品表。
cooldown_after_being_attacked 整数 0 持续时间，以秒为单位，如果生物受伤，它会停止以物易物
返回顶部

minecraft:block_climber

允许玩家在脚手架上进行检测和机动。（原文：Allows the player to detect and maneuver on the scaffolding block.）
返回顶部

minecraft:block_sensor

当阻止列表中的方块在传感器范围内被破坏时触发指定事件。（原文：Fires off a specified event when a block in the block list is broken within the sensor range.）

名称 类型 默认值 描述
on_break List 要监视被破坏以触发指定事件的方块列表。如果一个方块位于多个列表中，则会触发多个事件。
sensor_radius 浮点数 16.00 可以检测到指定方块的最大距离。最大半径为 32.0。
返回顶部

minecraft:boostable

定义可骑乘实体的加速的条件和行为。

名称 类型 默认值 描述
boost_items List 骑乘此实体时可用于提速的物品列表。每个项都具有以下属性：
名称 类型 默认值 描述
damage 整数 1 这是该物品每次使用时受到的耐久损伤。
item 字符串 可用于提速的物品名称。
replace_item 字符串 用于提速的物品一旦用完就会变成该物品。
duration 浮点数 3.0 提速的时间（以秒为单位）。
speed_multiplier 浮点数 1.0 实体的正常速度增加的系数。例如，2.0 意味着速度翻倍。
返回顶部

minecraft:boss

用于更新 Boss 血条 的 Boss 的当前状态。

名称 类型 默认值 描述
hud_range 整数 55 玩家屏幕上显示 Boss 的生命条时，与 Boss 的最大距离。
name 字符串 将显示在 Boss 生命条上方的名称。
should_darken_sky 布尔值 false 在 Boss 在场时，天空是否应该变暗。
返回顶部

minecraft:break_blocks

指定此实体在四处移动时可以破坏的方块。

名称 类型 默认值 描述
breakable_blocks List 此实体移动时可以破坏的方块的列表
返回顶部

minecraft:breathable

定义此实体可以呼吸的方块。

名称 类型 默认值 描述
breathe_blocks List 此实体可以呼吸的方块列表，以及其他 “breathes” 参数。
breathes_air 布尔值 true 如果为 true，则此实体可以呼吸空气。
breathes_lava 布尔值 true 如果为 true，则此实体可以在熔岩内呼吸。
breathes_solids 布尔值 false 如果为 true，则此实体可以在实心方块中呼吸。
breathes_water 布尔值 false 如果为 true，则此实体可以在水中呼吸。
generates_bubbles 布尔值 true 如果为 true，则此实体在水中时将具有可见的气泡。
inhale_time 浮点数 0 将呼吸恢复到最大状态的时间（以秒为单位）。
non_breathe_blocks List 此实体不能呼吸的方块列表，以及其他 “breathes” 参数。
suffocate_time 整数 -20 窒息伤害的时间间隔（以秒为单位）。
total_supply 整数 15 实体可以屏住呼吸的时间（以秒为单位）。
返回顶部

minecraft:breedable

定义实体进入 'love' 状态的方式。

名称 类型 默认值 描述
allow_sitting 布尔值 false 如果为 true，则实体可以在坐着时繁殖
blend_attributes 布尔值 true 如果为 true，则实体将在繁殖后将其属性混合到后代中。例如，马将它们的生命值、移速和跳跃高度混合到它们的后代中。
breed_cooldown 浮点数 60 实体可以再次繁殖之前的时间（以秒为单位）。
breed_items List 可用于使实体进入 'love' 状态的物品列表
breeds_with List 可以与之繁殖的实体列表。
名称 类型 默认值 描述
baby_type 字符串 此实体的婴儿的实体定义。
breed_event 字符串 此实体繁殖时运行的事件。
mate_type 字符串 此实体交配的对象定义。
causes_pregnancy 布尔值 false 如果为 true，则实体将怀孕，而不是生成婴儿。
deny_parents_variant JSON对象 确定具有相同变种的父母的婴儿采用给定范围内的随机变种的可能性。
名称 类型 默认值 描述
chance 浮点数 0 否定父级变种的百分比几率。
max_variant 整数 0 变种范围的包含最大值。
min_variant 整数 0 变种范围的包含最小值。
environment_requirements List 使实体进入 'love' 状态的附近区块要求列表。

blocks

实体繁殖所需的附近方块类型。
返回顶部

count

实体繁殖所需的附近方块类型的数量。
返回顶部

radius

从生物中心开始，半径内有多少个方块可以搜索到所需的方块。边界在 0 和 16 之间。
返回顶部
extra_baby_chance 浮点数 0 最多 16 个婴儿的几率在 0.0 到 1.0 之间生成，其中 1.0 是 100%。
inherit_tamed 布尔值 true 如果为 true，则如果其父母被驯服，则婴儿将自动被驯服
love_filters Minecraft 类型 尝试坠入爱河时要运行的过滤器。
mutation_factor JSON对象 确定婴儿不继承其父级变种之一的可能性。值介于 0.0 和 1.0 之间，数字越大意味着越有可能发生突变。
名称 类型 默认值 描述
color 浮点数 0 实体颜色发生突变的百分比几率。
extra_variant 浮点数 0 实体的额外变种类型发生突变的百分比几率。
variant 浮点数 0 实体的变种类型发生突变的百分比几率。
require_full_health 布尔值 false 如果为 true，则实体需要处于满生命值才能繁殖。
require_tame 布尔值 true 如果为 true，则必须先驯服实体，然后才能繁殖。
transform_to_item 字符串 使用的物品将在成功交互后转换为此物品。格式：物品名:数据值
返回顶部

minecraft:bribeable

定义实体进入 '贿赂' 状态的方式。

名称 类型 默认值 描述
bribe_cooldown 浮点数 2.0 实体可以再次被贿赂之前的时间（以秒为单位）。
bribe_items List 可用于贿赂实体的物品列表。
返回顶部

minecraft:buoyant

使实体能够漂浮在指定的液体方块上。（波浪模拟：船一上一下地浮动）

名称 类型 默认值 描述
apply_gravity 布尔值 true 在每刻应用重力。导致更多的波浪模拟，但会导致在液体外部应用更多的重力。
base_buoyancy 浮点数 1.0 基础浮力用于计算生物会漂浮多少。
big_wave_probability 浮点数 0.03 大浪击中实体的概率。仅在 'simulate_waves' 为 true 时使用。
big_wave_speed 浮点数 10.0 掀起的速度乘数。触发时间取决于 'big_wave_probability'
drag_down_on_buoyancy_removed 浮点数 0.0 删除 Buoyancy Component （浮力组件） 时，实体将被拖拽多少。
liquid_blocks List 此实体可以漂浮的方块列表。必须是液体块。
simulate_waves 布尔值 true 运动是否应该模拟波浪通过。
返回顶部

minecraft:burns_in_daylight

指定生物是否/如何在白天燃烧。
返回顶部

minecraft:celebrate_hunt

指定狩猎庆祝行为。

名称 类型 默认值 描述
broadcast 布尔值 true 如果为 true，则 庆祝 将广播到半径内的其他实体。
celeberation_targets Minecraft 类型 庆祝前必须满足的条件列表。
celebrate_sound 字符串 当生物庆祝时要播放的声音事件
duration 整数 4 庆祝的持续时间（以秒为单位）
radius 浮点数 16 如果启用了 broadcast，则指定它将通知其他实体进行庆祝的半径。
sound_interval 范围 [a, b] 0 在再次播放声音之前随机等待的时间范围（以秒为单位）
返回顶部

minecraft:combat_regeneration

提供再生1并消除杀死生物攻击目标的生物的采矿疲劳。（例：蝾螈）

名称 类型 默认值 描述
apply_to_family 布尔值 false 决定当生物杀死目标时，生物是否会给予相同类型的生物战斗增益。
apply_to_self 布尔值 false 决定如果生物杀死了目标，它是否会给予自己战斗增益。
regeneration_duration 整数 5 添加到生物中的再生持续时间（以秒为单位）。
返回顶部

minecraft:conditional_bandwidth_optimization

定义此实体的条件空间更新带宽优化。

名称 类型 默认值 描述
conditional_values List 包含条件带宽优化值的对象

conditional_values

使用这些优化值必须满足的条件。
返回顶部

max_dropped_ticks

相对于优化值，确定空间更新数据包不能发送的最大时间周期
返回顶部

max_optimized_distance

带宽优化期间考虑的最大距离。任何低于 max 的值都会值以找到优化，任何大于或等于此 max 的值都会导致 max 优化。
返回顶部

use_motion_prediction_hints

当设置为 true 时，将在丢弃数据包间隔期间发送较小的运动数据包，从而发送的数据包数量与未进行优化时相同，但发送的数据要少得多。当活动对象非常快速地移动或传送时，应该使用此方法，以防止视觉异常。
返回顶部
default_values JSON对象 包含默认带宽优化值的对象。

max_dropped_ticks

相对于优化值，确定空间更新数据包不能发送的最大时间周期。
返回顶部

max_optimized_distance

带宽优化期间考虑的最大距离。任何低于 max 的值都会值以找到优化，任何大于或等于此 max 的值都会导致 max 优化。
返回顶部

use_motion_prediction_hints

当设置为 true 时，将在丢弃数据包间隔期间发送较小的运动数据包，从而发送的数据包数量与未进行优化时相同，但发送的数据要少得多。当活动对象非常快速地移动或传送时，应该使用此方法，以防止视觉异常。
返回顶部
返回顶部

minecraft:custom_hit_test

对实体的近战和远程命中框列表。

名称 类型 默认值 描述
hitboxes 数组 以逗号分隔的命中框列表。
返回顶部

minecraft:damage_over_time

按指定的时间间隔对实体应用定义的伤害量。

名称 类型 默认值 描述
damage_per_hurt 整数 1 每次受伤造成的伤害量。
time_between_hurt 浮点数 0.0 伤害间隔时间（以秒为单位）。
返回顶部

minecraft:damage_sensor

定义当此实体被特定实体或物品攻击时要调用的事件。

名称 类型 默认值 描述
triggers List 包含受到特定类型伤害时要调用的事件的触发器列表。
名称 类型 默认值 描述
cause 字符串 none 触发事件的伤害类型。
damage_modifier 浮点数 0.0 一个修改，用于增加/消除伤害来源的基础伤害。它不会将伤害降低到 0 以下。
damage_multiplier 浮点数 1.0 一个乘数，用于修改伤害来源的基础伤害。如果 deals_damage 为 true，则乘数只能将实体将受到的伤害降低到最低 1。
deals_damage 布尔值 true 如果为 true，则对实体造成的伤害会带走实体的生命值，设置为 false 可使实体忽略该伤害。
on_damage JSON对象 指定实体定义和事件的过滤器。
on_damage_sound_event 字符串 定义在满足 on_damage 过滤器时要播放的声音（如果有）。
返回顶部

minecraft:despawn

当消失规则或可选过滤器的计算结果为 true 时，刷新掉实体

名称 类型 默认值 描述
despawn_from_chance 布尔值 true 确定是否在标准消失规则中使用 “min_range_random_chance”
despawn_from_distance JSON对象 指定是否在标准消失规则中使用 “min_distance” 和 “max_distance”。
名称 类型 默认值 描述
max_distance 整数 128 标准消失规则立即使生物消失的最大距离。
min_distance 整数 32 标准消失规则尝试使生物消失的最小距离。
despawn_from_inactivity 布尔值 true 确定是否在标准消失规则中使用 “min_range_inactivity_timer”。
despawn_from_simulation_edge 布尔值 true 确定在标准消失规则中，生物是否在模拟距离的边缘立即消失。
filters Minecraft 类型 在实体消失之前必须满足的条件列表。如果定义了此过滤器，则忽略标准消失规则。
min_range_inactivity_timer 整数 30 生物必须处于非活动状态的时间（以秒为单位）。
min_range_random_chance 整数 800 介于 1 和给定值之间的随机机会。
remove_child_entities 布尔值 false 如果为 true，则在子关系中链接到此实体的所有实体（例如拴绳）也将消失。
返回顶部

minecraft:drying_out_timer

添加了一个用于干燥的计时器，该将倒计时结束时触发“dried_out_event”，或者在实体被雨或水冲刷后触发“stopped_drying_out_event”

名称 类型 默认值 描述
dried_out_event 字符串 当倒计时结束时触发的事件。
recover_after_dried_out_event 字符串 当实体已经干涸但供水增加时触发的事件。
stopped_drying_out_event 字符串 当实体停止干燥时触发的事件，例如进入水中或下雨。
total_time 浮点数 0.0 完全干燥的时间（以秒为单位）。
water_bottle_refill_time 浮点数 0.0 通过在实体上使用喷溅水瓶提供的可选额外时间量（以秒为单位）。
返回顶部

minecraft:economy_trade_table

定义此实体与玩家交易的能力。

名称 类型 默认值 描述
convert_trades_economy 布尔值 false 确定当生物变化时，当新生物有economy_trade_table时是否应该转换交易。当交易被转换时，生物会用他们的新交易表生成一个新的交易列表，但随后它会尝试转换任何相同的交易以获得相同的附魔和用户数据。例如，如果原来的交易有一个绿宝石换附魔铁剑（锋利 1），而新交易也有一个绿宝石附魔铁剑，那么附魔将是锋利 1。
cured_discount 范围 [a, b] [-5, -20] 当玩家治愈了僵尸村民时，应该修改多少折扣。可以指定为一对数字（“低级交易”折扣和“高级交易”折扣）
display_name 字符串 与此实体交易时要显示的名称
hero_demand_discount 整数 -4 在旧价格中用于确定当玩家具有村庄英雄状态效果时应修改多少需求（原文：Used in legacy prices to determine how much should Demand be modified by when the player has the Hero of the Village mob effect）
max_cured_discount 范围 [a, b] [-25, -63] 当玩家治愈了僵尸村民时，可以修改折扣的最大值。可以指定为一对数字（“低级交易”折扣和“高级交易”折扣）
max_nearby_cured_discount 整数 -200 当玩家治愈了附近的僵尸村民时，可以修改折扣的最大值
nearby_cured_discount 整数 -25 当玩家治愈了附近的僵尸村民时，应该修改多少折扣
new_screen 布尔值 false 用于确定与实体交易是否打开新的交易屏幕
persist_trades 布尔值 false 确定当生物变化时交易是否应持续。这样，下次生物被转化为具有trade_table或economy_trade_table的实体时，它就会保留他们的交易。
show_trade_screen 布尔值 true 在与生物互动时显示游戏内交易界面。
table 字符串 用于此实体交易的资源包根目录的文件路径
use_legacy_price_formula 布尔值 false 确定是否使用旧公式来确定交易价格。
返回顶部

minecraft:entity_sensor

当定义范围内的其他实体满足一组条件时触发事件的组件。

名称 类型 默认值 描述
event 字符串 满足条件时触发的事件。
event_filters Minecraft 类型 触发事件必须满足的一组条件。
maximum_count 整数 -1 必须通过筛选条件才能发送事件的最大实体数。
minimum_count 整数 1 必须通过筛选条件才能发送事件的最小实体数。
relative_range 布尔值 true 如果为 true，则传感器范围是叠加在实体大小之上的。
require_all 布尔值 false 如果为 true，则要求所有附近的实体传递要发送的事件的筛选条件。
sensor_range 浮点数 10 另一个实体可以与之之间的最大距离，并针对该实体检查过滤器。
返回顶部

minecraft:environment_sensor

根据环境条件创建触发器。

名称 类型 默认值 描述
triggers List 当环境条件与给定筛选条件匹配时触发的触发器列表。
返回顶部

minecraft:equip_item

实体穿上所需的装备。
返回顶部

minecraft:equippable

定义实体装备物品的行为。

名称 类型 默认值 描述
slots List 槽位列表和可以装备的物品。
名称 类型 默认值 描述
accepted_items List 可以放入此槽位的物品列表。
interact_text 字符串 当实体使用触摸屏控件时，显示的交互按钮文本。
item 字符串 可以装备到此槽位的物品标识符。
on_equip JSON对象 当此实体装备此物品时触发的事件。
on_unequip JSON对象 从此实体中移除此物品时触发的事件。
slot 整数 0 此槽位的槽位编号。
返回顶部

minecraft:experience_reward

定义实体死亡或成功繁殖时奖励的经验量。

名称 类型 默认值 描述
on_bred Molang 0 一个 Molang 表达式，用于定义成功繁殖实体时奖励的经验量。表达式数组将每个表达式的结果相加得出最终总数。
on_death Molang 0 一个 Molang 表达式，用于定义实体死亡时奖励的经验量。表达式数组将每个表达式的结果相加得出最终总数。
返回顶部

minecraft:explode

定义实体的爆炸方式。

名称 类型 默认值 描述
breaks_blocks 布尔值 true 如果为 true，则爆炸将摧毁爆炸半径内的方块。
causes_fire 布尔值 false 如果为 true，则爆炸半径内的方块将被点燃。
destroy_affected_by_griefing 布尔值 false 如果为 true，则爆炸是否打破方块受生物破坏游戏规则的影响。
fire_affected_by_griefing 布尔值 false 如果为 true，则爆炸是否引起火灾受生物破坏游戏规则的影响。
fuse_length 范围 [a, b] [0.0, 0.0] 爆炸的随机时间范围，负值表示爆炸将立即爆炸。
fuse_lit 布尔值 false 如果为 true，则当此组件添加到实体时，保险丝已点亮。
max_resistance 浮点数 3.40282e+38 当爆炸发生时，方块的爆炸抗性将达到此值的上限。
power 浮点数 3 爆炸的半径（以方块为单位）和爆炸造成的伤害。
返回顶部

minecraft:flocking

允许实体在水中成群结队地聚集。

名称 类型 默认值 描述
block_distance 浮点数 0 实体将查看要推开的方块数量。
block_weight 浮点数 0 从方块上推回的重量。
breach_influence 浮点数 0 对冲出水面的集群实体的反击量。
cohesion_threshold 浮点数 1 The threshold in which to start applying cohesion.
cohesion_weight 浮点数 1 The weight applied for the cohesion steering of the flock.
goal_weight 浮点数 0 The weight on which to apply on the goal output.
high_flock_limit 整数 0 Determines the high bound amount of entities that can be allowed in the flock.
in_water 布尔值 false Tells the Flocking Component if the entity exists in water.
influence_radius 浮点数 0 The area around the entity that allows others to be added to the flock.
innner_cohesion_threshold 浮点数 0 The distance in which the flocker will stop applying cohesion.
loner_chance 浮点数 0 The percentage chance between 0-1 that a fish will spawn and not want to join flocks. Invalid values will be capped at the end points.
low_flock_limit 整数 0 Determines the low bound amount of entities that can be allowed in the flock.
match_variants 布尔值 false Tells the flockers that they can only match similar entities that also match the variant, mark variants, and color data of the other potential flockers.
max_height 浮点数 0 The max height allowable in the air or water.
min_height 浮点数 0 The min height allowable in the air or water.
separation_threshold 浮点数 2 The distance that is determined to be to close to another flocking and to start applying separation.
separation_weight 浮点数 1 The weight applied to the separation of the flock.
use_center_of_mass 布尔值 false Tells the flockers that they will follow flocks based on the center of mass.
返回顶部

minecraft:genetics

定义生物的基因和等位基因传递给其后代的方式，以及这些特征如何在孩子身上表现出来。相容的亲本基因杂交在一起，等位基因从父母传给孩子，任何匹配的遗传变异都会触发 JSON 事件来修改孩子并表达性状。

名称 类型 默认值 描述
genes List 此实体在育种过程中拥有并将与伴侣杂交的基因列表。
名称 类型 默认值 描述
allele_range 整数 该基因的正整数等位基因值的范围。生成的生物将在此范围内分配一个随机数。
名称 类型 默认值 描述
range_max 整数 0 该基因的等位基因值的上限。
range_min 整数 0 该基因的等位基因值的下限。
genetic_variants List 该基因的遗传变异列表。这些检查特定等位基因组合，并在满足所有等位基因组合时触发事件。
名称 类型 默认值 描述
birth_event 字符串 此生物出生并匹配等位基因条件时运行的事件。
both_allele 整数 -1 如果此值为非负数，则将生物的主等位基因和隐藏等位基因与此值进行比较，以便与两者匹配。也可以是整数范围。
either_allele 整数 -1 如果此值为非负数，则将生物的主等位基因和隐藏等位基因与此值进行比较，以便与其中任何一个匹配。也可以是整数范围。
hidden_allele 整数 -1 如果此值为非负数，则将 mob 的隐藏等位基因与此值进行比较以进行匹配。也可以是整数范围。
main_allele 整数 -1 如果此值为非负数，则将 mob 的主要等位基因与此值进行比较以进行匹配。也可以是整数范围。
mutation_rate 浮点数 -1 如果该值为非负值，则覆盖该基因在出生期间等位基因被随机等位基因替换而不是父母等位基因的几率。大于 '1' 的非负值将与值 '1' 相同。
name 字符串 基因的名称。
mutation_rate 浮点数 0.03125 在出生过程中，等位基因被随机等位基因替换而不是父母等位基因的几率。
返回顶部

minecraft:giveable

定义在此实体上使用时可用于触发事件的物品集。该物品也将被拿走并放置在实体的物品栏中。

名称 类型 默认值 描述
cooldown 浮点数 0.0 可选的冷却，以防止反复交互。（以秒为单位）
items List 可以提供给实体以放置在其物品栏中的物品列表。
on_give 字符串 在提供正确的物品时触发的事件。
返回顶部

minecraft:group_size

跟踪给定半径内的实体组大小。

名称 类型 默认值 描述
filters Minecraft 类型 其他实体必须满足的条件列表才能计入组大小。
radius 浮点数 16 距实体中心的半径。
返回顶部

minecraft:grows_crop

当实体走过农作物时，可能会增加农作物生长

名称 类型 默认值 描述
chance 浮点数 0 值介于 0-1 之间。每游戏刻的成功几率。
charges 整数 10 Number of charges
返回顶部

minecraft:healable

定义与此实体的交互以修复它。

名称 类型 默认值 描述
filters Minecraft 类型 定义使用此项修复实体的条件的过滤器组。
force_use 布尔值 false 不管实体是否处于满生命值，都可以对其使用物品。
items 数组 可用于修复此实体的物品数组。
名称 类型 默认值 描述
heal_amount 整数 1 此实体在喂食此物品时获得的生命值。
item 字符串 可用于修复此实体的物品标识符。
返回顶部

minecraft:home

保存生成实体时的起始位置。

名称 类型 默认值 描述
home_block_list List 可被视为有效 home 的可选方块列表。如果该位置不再存在此类方块，则删除 home 限制。语法示例：minecraft:sand。不支持：minecraft:sand:1。
restriction_radius 整数 -1 实体相对于其 home 将被限制的半径
返回顶部

minecraft:hurt_on_condition

定义实体应受到伤害的一组条件。

名称 类型 默认值 描述
damage_conditions 数组 对实体造成伤害的条件列表。

cause

对实体造成的伤害类型。各种盔甲和法术都使用它来判断实体是否免疫。


返回顶部

damage_per_tick

满足条件时每刻造成的伤害。
返回顶部

filters

在实体受到定义的伤害之前必须满足的一组条件。
返回顶部
返回顶部

minecraft:inside_block_notifier

验证实体是否位于列出的任何方块内。

名称 类型 默认值 描述
block_list List 具有特定方块状态的方块列表，这些方块被监控以查看实体是否在内部
返回顶部

minecraft:insomnia

添加自上次睡觉以来的计时器，以查看是否应该生成幻翼。

名称 类型 默认值 描述
days_until_insomnia 浮点数 3.0 生物熬夜直到幻翼生成的天数。
返回顶部

minecraft:instant_despawn

让生物立即消失。

名称 类型 默认值 描述
remove_child_entities 布尔值 false 如果为 true，则在子关系中链接到此实体的所有实体（例如拴绳）也将消失。
返回顶部

minecraft:interact

定义与此实体的交互。

名称 类型 默认值 描述
add_items JSON对象 战利品表，其中包含成功互动后可添加到玩家库存中的物品。
名称 类型 默认值 描述
table 字符串 文件路径（相对于 Behavior Pack 的路径）指向战利品表文件。
cooldown 浮点数 0 可以再次与此实体交互之前的时间（以秒为单位）。
cooldown_after_being_attacked 浮点数 0 此实体在受到攻击后可以与之交互的时间（以秒为单位）。
health_amount 整数 0 此实体在与此物品交互时将增加或减少的生命值。负值将伤害实体。
hurt_item 整数 0 物品在与此实体交互时将损失的耐久度。值为 0 表示项目不会失去耐久度。
interact_text 字符串 显示玩家在玩触摸屏控件时何时能够以这种方式与此实体交互的按钮文本。
on_interact 字符串 交互时触发的事件。
particle_on_start JSON对象 将在交互开始时触发的粒子特效。

particle_offset_towards_interactor

粒子是否看起来更接近执行交互的用户。
返回顶部

particle_type

将生成的粒子类型。
返回顶部

particle_y_offset

此粒子在 y 方向上偏移的量。
返回顶部
play_sounds 字符串 交互发生时要播放的声音列表。
spawn_entities 字符串 交互发生时要生成的实体列表。
spawn_items JSON对象 战利品表，互动成功后会掉落在地上的物品。
名称 类型 默认值 描述
table 字符串 文件路径（相对于 Behavior Pack 的路径）指向战利品表文件。
swing 布尔值 false 如果为 true，则玩家将在与此实体交互时执行 'swing' 动画。
transform_to_item 字符串 交互成功后，使用的物品将转换为此物品。格式：物品名:数据值
use_item 布尔值 false 如果为 true，则交互将使用物品。
返回顶部

minecraft:inventory

定义此实体的物品栏属性。

名称 类型 默认值 描述
additional_slots_per_strength 整数 0 此实体每增加一倍力量所能获得的槽位数量
can_be_siphoned_from 布尔值 false 如果为 true，则此物品栏的内容可以通过漏斗漏出
container_type 字符串 none 此实体具有的容器类型。可以是马、箱子矿车、漏斗矿车、物品栏、箱子或漏斗
inventory_size 整数 5 容器具有的槽位数
private 布尔值 false 如果为 true，则实体在死亡时不会掉落其物品栏
restrict_to_owner 布尔值 false 如果为 true，则实体的物品栏只能由其所有者或自身访问
返回顶部

minecraft:item_hopper

确定此实体是物品漏斗。（原版实例：漏斗矿车）
返回顶部

minecraft:jump.dynamic

定义一个动态类型的跳跃控件，该控件将根据生物的速度更改跳跃属性。
返回顶部

minecraft:jump.static

使实体能够跳跃。

名称 类型 默认值 描述
jump_power 浮点数 0.42 跳跃的初始垂直速度
返回顶部

minecraft:leashable

允许此实体被拴住，并定义此实体在被束缚时的条件和事件。

名称 类型 默认值 描述
can_be_stolen 布尔值 false 如果为 true，则玩家可以拴住此实体，即使它已经拴在另一个生物上。
hard_distance 浮点数 6 以方块为单位的距离，拴绳变硬，限制运动。
max_distance 浮点数 10 拴绳断裂的距离（以方块为单位）。
on_leash 字符串 当此实体被拴住时要调用的事件。
on_unleash 字符串 释放此实体时调用的事件。
soft_distance 浮点数 4 以方块为单位的距离，开始使该实体靠近拴住它的实体。
返回顶部

minecraft:lookat

定义其他实体看此实体时的行为。

名称 类型 默认值 描述
allow_invulnerable 布尔值 false 如果为 true，则无敌实体（例如处于创造模式的玩家）被视为有效目标。
filters Minecraft 类型 定义可以触发此组件的实体。
look_cooldown 范围 [a, b] [0, 0] 实体“冷却”并且不会生气或寻找目标的随机时间范围。
look_event 字符串 当筛选条件中指定的实体查看此实体时要运行的事件标识符。
search_radius 浮点数 10 此实体将寻找另一个正在注视它的实体的最大距离。
set_target 布尔值 true 如果为 true，则此实体会攻击看它的实体。
返回顶部

minecraft:managed_wandering_trader

此组件用于实现流浪商人行为的一部分，只能由流浪商人使用
返回顶部

minecraft:mob_effect

将状态效果应用于范围内的实体的组件。（原版实例：河豚）

名称 类型 默认值 描述
effect_range 浮点数 0.2 敌对实体必须离多近才能应用状态效果。
effect_time 整数 10 应用的状态效果持续多长时间（以秒为单位）。
entity_filter Minecraft 类型 可有效应用状态效果的实体集。
mob_effect 字符串 施加的状态效果。
返回顶部

minecraft:movement.amphibious

此移动控件允许生物在水中游泳并在陆地上行走。

名称 类型 默认值 描述
max_turn 浮点数 30.0 生物每刻可以转动的最大度数。
返回顶部

minecraft:movement.basic

此移动控件允许实体走动。

名称 类型 默认值 描述
max_turn 浮点数 30.0 实体每刻可以转动的最大度数。
返回顶部

minecraft:movement.fly

此移动控件允许生物飞行。

名称 类型 默认值 描述
max_turn 浮点数 30.0 生物每刻可以转动的最大度数。
返回顶部

minecraft:movement.generic

此移动控件允许生物飞行、游泳、攀爬等。（原版实例：溺尸）

名称 类型 默认值 描述
max_turn 浮点数 30.0 生物每刻可以转动的最大度数。
返回顶部

minecraft:movement.hover

此移动控件使生物悬停。（原版实例：蜜蜂）

名称 类型 默认值 描述
max_turn 浮点数 30.0 生物每刻可以转动的最大度数。
返回顶部

minecraft:movement.jump

移动控件，使生物在移动时以指定的跳跃延迟跳跃。（原版实例：史莱姆、岩浆怪）

名称 类型 默认值 描述
jump_delay 范围 [a, b] [0.0, 0.0] 使用史莱姆移动控件时着陆后的延迟。
max_turn 浮点数 30.0 生物每刻可以转动的最大度数。
返回顶部

minecraft:movement.skip

此移动控件允许生物在移动时跳跃。（原版实例：兔子）

名称 类型 默认值 描述
max_turn 浮点数 30.0 生物每刻可以转动的最大度数。
返回顶部

minecraft:movement.sway

该移动控制使生物左右摇晃，给人一种它在游泳的印象。

名称 类型 默认值 描述
max_turn 浮点数 30.0 生物每刻可以转动的最大度数。
sway_amplitude 浮点数 0.05 摇摆运动的强度。
sway_frequency 浮点数 0.5 摇摆运动频率的乘数。
返回顶部

minecraft:nameable

允许命名此实体（例如使用命名牌）。

名称 类型 默认值 描述
allow_name_tag_renaming 布尔值 true 如果为 true，则可以使用 name 标签重命名此实体
always_show 布尔值 false 如果为 true，则始终显示名称
default_trigger 字符串 在实体命名时运行的触发器
name_actions JSON对象 描述此实体的特殊名称以及实体获取这些名称时要调用的事件
名称 类型 默认值 描述
name_filter 字符串 触发 'on_named' 中定义的事件的特殊名称列表
on_named 字符串 当此实体获取 'name_filter' 中指定的名称时要调用的事件
返回顶部

minecraft:navigation.climb

允许此实体生成包含垂直墙的路径，就像原版的蜘蛛那样。

名称 类型 默认值 描述
avoid_damage_blocks 布尔值 false 在寻找路径时避开造成伤害的方块
avoid_portals 布尔值 false 在寻找路径时避开传送门（如下界传送门）
avoid_sun 布尔值 false 在创建路径时是否应避开阳光
avoid_water 布尔值 false 在寻找路径时避开水
blocks_to_avoid List 在创建路径时要避开哪些方块
can_breach 布尔值 false 是否可以跳出水面（像海豚一样）
can_break_doors 布尔值 false 是否可以穿过一扇关闭的门并打破它
can_jump 布尔值 true 是否可以跳上方块
can_open_doors 布尔值 false 是否可以穿过一扇关闭的门并打开它
can_open_iron_doors 布尔值 false 是否可以穿过一扇关闭的铁门并打开它
can_pass_doors 布尔值 true 是否可以穿过门
can_path_from_air 布尔值 false 当它在空中时可以开始寻路
can_path_over_lava 布尔值 false 它是否可以在熔岩表面创建路径
can_path_over_water 布尔值 false 它是否可以在水面创建路径
can_sink 布尔值 true 在水中时是否会被重力拉下
can_swim 布尔值 false 是否可以在水中的任何位置移动，并沿该路径播放游泳动画
can_walk 布尔值 true 是否可以在水外的地面上行走
can_walk_in_lava 布尔值 false 是否可以像在地面上行走一样在熔岩中移动
is_amphibious 布尔值 false 是否可以在水下的地面上行走
返回顶部

minecraft:navigation.float

允许此实体像恶魂一样通过在空中飞行来生成路径。

名称 类型 默认值 描述
avoid_damage_blocks 布尔值 false 在寻找路径时避开造成伤害的方块
avoid_portals 布尔值 false 在寻找路径时避开传送门（如下界传送门）
avoid_sun 布尔值 false 在创建路径时是否应避开阳光
avoid_water 布尔值 false 在寻找路径时避开水
blocks_to_avoid List 在创建路径时要避开哪些方块
can_breach 布尔值 false 是否可以跳出水面（像海豚一样）
can_break_doors 布尔值 false 是否可以穿过一扇关闭的门并打破它
can_jump 布尔值 true 是否可以跳上方块
can_open_doors 布尔值 false 是否可以穿过一扇关闭的门并打开它
can_open_iron_doors 布尔值 false 是否可以穿过一扇关闭的铁门并打开它
can_pass_doors 布尔值 true 是否可以穿过门
can_path_from_air 布尔值 false 当它在空中时可以开始寻路
can_path_over_lava 布尔值 false 它是否可以在熔岩表面创建路径
can_path_over_water 布尔值 false 它是否可以在水面创建路径
can_sink 布尔值 true 在水中时是否会被重力拉下
can_swim 布尔值 false 是否可以在水中的任何位置移动，并沿该路径播放游泳动画
can_walk 布尔值 true 是否可以在水外的地面上行走
can_walk_in_lava 布尔值 false 是否可以像在地面上行走一样在熔岩中移动
is_amphibious 布尔值 false 是否可以在水下的地面上行走
返回顶部

minecraft:navigation.fly

允许此实体像原版鹦鹉一样在空中生成路径。

名称 类型 默认值 描述
avoid_damage_blocks 布尔值 false 在寻找路径时避开造成伤害的方块
avoid_portals 布尔值 false 在寻找路径时避开传送门（如下界传送门）
avoid_sun 布尔值 false 在创建路径时是否应避开阳光
avoid_water 布尔值 false 在寻找路径时避开水
blocks_to_avoid List 在创建路径时要避开哪些方块
can_breach 布尔值 false 是否可以跳出水面（像海豚一样）
can_break_doors 布尔值 false 是否可以穿过一扇关闭的门并打破它
can_jump 布尔值 true 是否可以跳上方块
can_open_doors 布尔值 false 是否可以穿过一扇关闭的门并打开它
can_open_iron_doors 布尔值 false 是否可以穿过一扇关闭的铁门并打开它
can_pass_doors 布尔值 true 是否可以穿过门
can_path_from_air 布尔值 false 当它在空中时可以开始寻路
can_path_over_lava 布尔值 false 它是否可以在熔岩表面创建路径
can_path_over_water 布尔值 false 它是否可以在水面创建路径
can_sink 布尔值 true 在水中时是否会被重力拉下
can_swim 布尔值 false 是否可以在水中的任何位置移动，并沿该路径播放游泳动画
can_walk 布尔值 true 是否可以在水外的地面上行走
can_walk_in_lava 布尔值 false 是否可以像在地面上行走一样在熔岩中移动
is_amphibious 布尔值 false 是否可以在水下的地面上行走
返回顶部

minecraft:navigation.generic

允许此实体通过行走、游泳、飞行、攀爬或上下跳跃来生成路径

名称 类型 默认值 描述
avoid_damage_blocks 布尔值 false 在寻找路径时避开造成伤害的方块
avoid_portals 布尔值 false 在寻找路径时避开传送门（如下界传送门）
avoid_sun 布尔值 false 在创建路径时是否应避开阳光
avoid_water 布尔值 false 在寻找路径时避开水
blocks_to_avoid List 在创建路径时要避开哪些方块
can_breach 布尔值 false 是否可以跳出水面（像海豚一样）
can_break_doors 布尔值 false 是否可以穿过一扇关闭的门并打破它
can_jump 布尔值 true 是否可以跳上方块
can_open_doors 布尔值 false 是否可以穿过一扇关闭的门并打开它
can_open_iron_doors 布尔值 false 是否可以穿过一扇关闭的铁门并打开它
can_pass_doors 布尔值 true 是否可以穿过门
can_path_from_air 布尔值 false 当它在空中时可以开始寻路
can_path_over_lava 布尔值 false 它是否可以在熔岩表面创建路径
can_path_over_water 布尔值 false 它是否可以在水面创建路径
can_sink 布尔值 true 在水中时是否会被重力拉下
can_swim 布尔值 false 是否可以在水中的任何位置移动，并沿该路径播放游泳动画
can_walk 布尔值 true 是否可以在水外的地面上行走
can_walk_in_lava 布尔值 false 是否可以像在地面上行走一样在熔岩中移动
is_amphibious 布尔值 false 是否可以在水下的地面上行走
返回顶部

minecraft:navigation.hover

允许此实体像原版蜜蜂一样在空中生成路径。防止他们从天空中掉下来并进行预测性运动。（原文：Allows this entity to generate paths in the air like the vanilla Bees do. Keeps them from falling out of the skies and doing predictive movement.）

名称 类型 默认值 描述
avoid_damage_blocks 布尔值 false 在寻找路径时避开造成伤害的方块
avoid_portals 布尔值 false 在寻找路径时避开传送门（如下界传送门）
avoid_sun 布尔值 false 在创建路径时是否应避开阳光
avoid_water 布尔值 false 在寻找路径时避开水
blocks_to_avoid List 在创建路径时要避开哪些方块
can_breach 布尔值 false 是否可以跳出水面（像海豚一样）
can_break_doors 布尔值 false 是否可以穿过一扇关闭的门并打破它
can_jump 布尔值 true 是否可以跳上方块
can_open_doors 布尔值 false 是否可以穿过一扇关闭的门并打开它
can_open_iron_doors 布尔值 false 是否可以穿过一扇关闭的铁门并打开它
can_pass_doors 布尔值 true 是否可以穿过门
can_path_from_air 布尔值 false 当它在空中时可以开始寻路
can_path_over_lava 布尔值 false 它是否可以在熔岩表面创建路径
can_path_over_water 布尔值 false 它是否可以在水面创建路径
can_sink 布尔值 true 在水中时是否会被重力拉下
can_swim 布尔值 false 是否可以在水中的任何位置移动，并沿该路径播放游泳动画
can_walk 布尔值 true 是否可以在水外的地面上行走
can_walk_in_lava 布尔值 false 是否可以像在地面上行走一样在熔岩中移动
is_amphibious 布尔值 false 是否可以在水下的地面上行走
返回顶部

minecraft:navigation.swim

允许此实体生成包含水的路径。

名称 类型 默认值 描述
avoid_damage_blocks 布尔值 false 在寻找路径时避开造成伤害的方块
avoid_portals 布尔值 false 在寻找路径时避开传送门（如下界传送门）
avoid_sun 布尔值 false 在创建路径时是否应避开阳光
avoid_water 布尔值 false 在寻找路径时避开水
blocks_to_avoid List 在创建路径时要避开哪些方块
can_breach 布尔值 false 是否可以跳出水面（像海豚一样）
can_break_doors 布尔值 false 是否可以穿过一扇关闭的门并打破它
can_jump 布尔值 true 是否可以跳上方块
can_open_doors 布尔值 false 是否可以穿过一扇关闭的门并打开它
can_open_iron_doors 布尔值 false 是否可以穿过一扇关闭的铁门并打开它
can_pass_doors 布尔值 true 是否可以穿过门
can_path_from_air 布尔值 false 当它在空中时可以开始寻路
can_path_over_lava 布尔值 false 它是否可以在熔岩表面创建路径
can_path_over_water 布尔值 false 它是否可以在水面创建路径
can_sink 布尔值 true 在水中时是否会被重力拉下
can_swim 布尔值 false 是否可以在水中的任何位置移动，并沿该路径播放游泳动画
can_walk 布尔值 true 是否可以在水外的地面上行走
can_walk_in_lava 布尔值 false 是否可以像在地面上行走一样在熔岩中移动
is_amphibious 布尔值 false 是否可以在水下的地面上行走
返回顶部

minecraft:navigation.walk

允许此实体像普通生物一样通过四处走动和在方块上跳来生成路径。

名称 类型 默认值 描述
avoid_damage_blocks 布尔值 false 在寻找路径时避开造成伤害的方块
avoid_portals 布尔值 false 在寻找路径时避开传送门（如下界传送门）
avoid_sun 布尔值 false 在创建路径时是否应避开阳光
avoid_water 布尔值 false 在寻找路径时避开水
blocks_to_avoid List 在创建路径时要避开哪些方块
can_breach 布尔值 false 是否可以跳出水面（像海豚一样）
can_break_doors 布尔值 false 是否可以穿过一扇关闭的门并打破它
can_jump 布尔值 true 是否可以跳上方块
can_open_doors 布尔值 false 是否可以穿过一扇关闭的门并打开它
can_open_iron_doors 布尔值 false 是否可以穿过一扇关闭的铁门并打开它
can_pass_doors 布尔值 true 是否可以穿过门
can_path_from_air 布尔值 false 当它在空中时可以开始寻路
can_path_over_lava 布尔值 false 它是否可以在熔岩表面创建路径
can_path_over_water 布尔值 false 它是否可以在水面创建路径
can_sink 布尔值 true 在水中时是否会被重力拉下
can_swim 布尔值 false 是否可以在水中的任何位置移动，并沿该路径播放游泳动画
can_walk 布尔值 true 是否可以在水外的地面上行走
can_walk_in_lava 布尔值 false 是否可以像在地面上行走一样在熔岩中移动
is_amphibious 布尔值 false 是否可以在水下的地面上行走
返回顶部

minecraft:out_of_control

定义实体的 “失控” 状态。（原版实例：船）
返回顶部

minecraft:peek

定义实体的 '偷看' 行为，定义在操作期间应调用的事件。（原版实例：潜影贝）

名称 类型 默认值 描述
on_close 字符串 实体完成偷看时调用的事件。
on_open 字符串 当实体开始窥视时调用的事件。
on_target_open 字符串 当实体的目标实体开始窥视时调用的事件。
返回顶部

minecraft:persistent

定义实体是否应在世界中持久化。（永远不会刷新掉）
返回顶部

minecraft:physics

定义实体的物理属性，包括它是否受重力影响或是否与对象碰撞。

名称 类型 默认值 描述
has_collision 布尔值 true 对象是否与事物发生碰撞。
has_gravity 布尔值 true 实体是否受重力影响。
返回顶部

minecraft:preferred_path

指定喜欢在首选路径上行走的生物的成本信息。

名称 类型 默认值 描述
default_block_cost 浮点数 0 非首选方块的成本
jump_cost 整数 0 跳跃的成本
max_fall_blocks 整数 3 生物不会受到掉落伤害的最大高度
preferred_path_blocks List 方块及其相关成本的列表
返回顶部

minecraft:projectile

允许实体成为弹射物。

名称 类型 默认值 描述
angle_offset 浮点数 0 改变弹丸垂直射击的角度。游戏中的许多喷溅药水都使用它来将其角度偏移 -20 度。
catch_fire 布尔值 false 如果为 true，则弹射物是着火的。
crit_particle_on_hurt 布尔值 false 如果为 true，则当暴击发生时，弹道将产生额外的粒子
destroy_on_hurt 布尔值 false 当此弹射物造成伤害时，是否立即摧毁此弹射物
filter 字符串 此处定义的实体不会受到弹射物的伤害。
fire_affected_by_griefing 布尔值 false 如果为 true，则弹射物是否引起火灾受生物破坏游戏规则的影响。
gravity 浮点数 0.05 投掷时应用于此实体的重力。当此实体不在地面上时，每个tick内从实体的垂直位置变化中减去此数量。值越高，实体下落的速度就越快。
hit_sound 字符串 击中某物时播放的声音
homing 布尔值 false 如果为 true，则弹射物会追踪到最近的实体。
inertia 浮点数 0.99 在空中飞行时，弹射物的速度每帧都保持不变
is_dangerous 布尔值 false 如果为 true，则弹射物将被视为对玩家构成危险。
knockback 布尔值 true 如果为 true，则弹射物将击退它击中的实体
lightning 布尔值 false 如果为 true，则被击中的实体将被闪电击中
liquid_inertia 浮点数 0.6 在水中飞行时，弹射物的速度每帧都保持不变
multiple_targets 布尔值 true 如果为 true，则弹射物每次飞行可以击中多个实体
offset 向量 [a, b, c] [0, 0, 0] 与将生成弹射物的实体锚点的偏移量。
on_fire_time 浮点数 5 实体命中将着火的时间（以秒为单位）
particle 字符串 iconcrack 击中时使用的粒子
potion_effect 整数 -1 定义弹射物击中的实体施加的状态效果
power 浮点数 1.3 确定弹射物的速度
reflect_on_hurt 布尔值 false 如果为 true，则此实体将在被命中时反射回来
semi_random_diff_damage 布尔值 false 如果为 true，则最终伤害将根据伤害数值和速度随机化
shoot_sound 字符串 射击时播放的声音
shoot_target 布尔值 true 如果为 true，则弹射物将射向发射它的实体的目标
should_bounce 布尔值 false 如果为 true，则弹射物会在命中时弹跳
splash_potion 布尔值 false 如果为 true，则弹射物将被视为喷溅药水
splash_range 浮点数 4 喷溅效果的的半径（以方块为单位）
uncertainty_base 浮点数 0 基本精度。准确率由公式“uncertainty_base - 难度等级 * uncertainty_multiplier”决定
uncertainty_multiplier 浮点数 0 确定难度对准确性的影响程度。准确率由公式“uncertainty_base - 难度等级 * uncertainty_multiplier”决定
返回顶部

minecraft:pushable

定义是否可以被被其他实体或被活塞推动。

名称 类型 默认值 描述
is_pushable 布尔值 true 实体是否可以被其他实体推动。
is_pushable_by_piston 布尔值 true 实体是否可以被活塞推动。
返回顶部

minecraft:raid_trigger

尝试在实体的位置触发袭击。

名称 类型 默认值 描述
triggered_event 字符串 要运行的事件，触发对村庄的突袭。
返回顶部

minecraft:rail_movement

定义实体在轨道上的移动。具有此组件的实体只允许在轨道上移动。

名称 类型 默认值 描述
max_speed 浮点数 0.4 此实体在铁轨上移动的最大速度。
返回顶部

minecraft:rail_sensor

定义实体在通过已激活或已停用的轨道时的行为

名称 类型 默认值 描述
check_block_types 布尔值 false 如果为 true，则在tick更新时，此实体将触发其on_deactivate行为
eject_on_activate 布尔值 true 如果为 true，则此实体将在经过激活的铁轨时弹出其所有乘客
eject_on_deactivate 布尔值 false 如果为 true，则此实体将在经过未激活的铁轨时弹出其所有乘客
on_activate JSON对象 铁轨是激活状态时要调用的事件
on_deactivate JSON对象 铁轨是未激活状态时要调用的事件
tick_command_block_on_activate 布尔值 true 如果为 true，则命令方块将在通过激活的铁轨时开始被激活
tick_command_block_on_deactivate 布尔值 false 如果为 false，则命令方块将在通过未激活的铁轨时停止激活
返回顶部

minecraft:ravager_blocked

定义劫掠兽对近战攻击被格挡的反应。

名称 类型 默认值 描述
knockback_strength 浮点数 3.0 击退实体的强度
reaction_choices List [ ] 对被格挡的近战攻击的加权响应列表
返回顶部

minecraft:rideable

确定是否可以骑乘此实体。允许指定不同的座椅位置和数量。

名称 类型 默认值 描述
controlling_seat 整数 0 指定实体驾驶员的座位。这仅通过马/船的骑行方式观察到;带有 “minecraft:controlled_by_player” 的矿车/实体可以将控制权交给任何座位上的任何玩家。
crouching_skip_interact 布尔值 true 如果为 true，则如果与该实体交互的实体处于潜行状态，则无法与该实体交互
family_types List 可以骑乘此实体的实体列表
interact_text 字符串 当玩家在使用触摸屏控件玩游戏时可以与实体交互时显示的按钮文本
priority 整数 0 此字段可能存在于旧数据中，但未被 minecraft:rideable 使用。
pull_in_entities 布尔值 false 如果为 true，则此实体会将位于正确family_types中的实体拉到任何可用席位中
rider_can_interact 布尔值 false 是否允许骑行者与该实体互动（你能不能打自己正在骑的马）
seat_count 整数 1 可以同时骑乘此实体的实体数量
seats List 骑乘此实体的实体的位置列表和每个位置的骑手数量
名称 类型 默认值 描述
lock_rider_rotation 浮点数 181 允许骑手在骑乘此实体时旋转的角度（以度为单位）。无限制地省略此属性（原文：Angle in degrees that a rider is allowed to rotate while riding this entity. Omit this property for no limit）
max_rider_count 整数 seat_count 定义此座位有效时可以乘坐此实体的最大骑手数
min_rider_count 整数 0 定义在使用此座位之前需要乘坐此实体的最小骑手数
position 向量 [a, b, c] [0, 0, 0] 此座位相对于此实体位置的位置
rotate_rider_by Molang 0 偏移以旋转骑手
返回顶部

minecraft:scale_by_age

根据实体的年龄定义实体的大小。

名称 类型 默认值 描述
end_scale 浮点数 1 实体完全增长时的大小。
start_scale 浮点数 1 婴儿实体的初始大小。
返回顶部

minecraft:scheduler

在一天中的时间触发预定的生物事件 。

名称 类型 默认值 描述
scheduled_events List 当条件与给定筛选条件匹配时触发的触发器列表。如果任何筛选条件重叠，则将选取第一个定义的事件。
返回顶部

minecraft:shareables

定义生物想要分享或拾取的物品列表。每个物品必须具有以下参数：

名称 类型 默认值 描述
all_items 布尔值 false A bucket for all other items in the game. Note this category is always least priority items.
all_items_max_amount 整数 -1 Maximum number of this item the mob will hold.
all_items_surplus_amount 整数 -1 Number of this item considered extra that the entity wants to share.
all_items_want_amount 整数 -1 Number of this item this entity wants to share.
items List List of items that the entity wants to share.

admire

Mob will admire the item after picking up by looking at it. For this to happen the mob needs to have an Admire component and an Admire goal.
返回顶部

barter

Mob will barter for the item after picking it up. For this to work the mob needs to have a Barter component and a Barter goal.
返回顶部

consume_item

Determines whether the mob will consume the item or not.
返回顶部

craft_into

Defines the item this entity wants to craft with the item defined by "item". Should be an item name.
返回顶部

item

The name of the item. Aux value can be specified, for instance 'minecraft:skull:1'.
返回顶部

max_amount

Maximum number of this item the mob will hold.
返回顶部

pickup_limit

Maximum number of this item the mob will pick up during a single goal tick.
返回顶部

priority

Prioritizes which items the entity prefers. 0 is the highest priority.
返回顶部

stored_in_inventory

Determines whether the mob will try to put the item in its inventory if it has the inventory component and if it can't be equipped.
返回顶部

surplus_amount

Number of this item considered extra that the entity wants to share.
返回顶部

want_amount

Number of this item this entity wants to have.
返回顶部
返回顶部

minecraft:shooter

定义实体的远程攻击行为。

名称 类型 默认值 描述
aux_val 整数 -1 命中时要应用的药水效果的 ID
def 字符串 用作远程攻击的弹射物的定义。定义必须具有 projectile 组件才能作为弹射物进行射击
返回顶部

minecraft:sittable

定义实体的坐下状态。

名称 类型 默认值 描述
sit_event 字符串 当实体进入坐下状态时运行的事件
stand_event 字符串 当实体退出坐下状态时运行的事件
返回顶部

minecraft:spawn_entity

添加一个计时器，之后此实体将生成另一个实体或物品（类似于原版的鸡的下蛋行为）。

名称 类型 默认值 描述
filters Minecraft 类型 如果存在，则仅当过滤器的计算结果为 true 时，才会生成指定的实体。
max_wait_time 整数 600 在生成另一个实体之前随机等待的最长时间（以秒为单位）。
min_wait_time 整数 300 在生成另一个实体之前随机等待的最短时间（以秒为单位）。
num_to_spawn 整数 1 每次触发时要生成的此类型的实体数量。
should_leash 布尔值 false 如果为 true，则生成的实体将被栓绳栓到父级。
single_use 布尔值 false 如果为 true，则此组件将只生成指定实体一次。
spawn_entity 字符串 要生成的实体的标识符，留空以生成由 "spawn_item" 定义的项目。
spawn_event 字符串 minecraft:entity_born 生成实体时调用的事件。
spawn_item 字符串 egg 要生成的物品的标识符。
spawn_method 字符串 born 用于生成实体的方法。
spawn_sound 字符串 plop 生成实体时要播放的声音。
返回顶部

minecraft:strength

定义实体携带物品的能力。（原版实例：羊驼）

名称 类型 默认值 描述
max 整数 5 最大强度
value 整数 1 强度的初始值
返回顶部

minecraft:tameable

定义玩家要驯服的生物的规则

名称 类型 默认值 描述
probability 浮点数 1 使用每个物品时驯服实体的几率介于 0.0 和 1.0 之间，其中 1.0 为 100%
tame_event 字符串 此实体被驯服时要运行的事件
tame_items List 可用于驯服此实体的物品列表
返回顶部

minecraft:tamemount

允许通过乘骑实体来驯服该实体。

名称 类型 默认值 描述
attempt_temper_mod 整数 5 实体在骑乘时会增加的好感度。
autoRejectItems JSON对象 如果在与实体交互时携带，则会激怒它的物品列表。
名称 类型 默认值 描述
item 字符串 此实体不喜欢的物品的名称，如果在未驯服时使用会导致它生气。
feed_items JSON对象 可用于加快驯服过程的物品列表。
名称 类型 默认值 描述
item 字符串 此实体喜欢的物品名称，可用于增加好感度。
temper_mod 整数 0 喂食此物品时获得的好感度。
feed_text 字符串 在喂食交互按钮中显示的文本。
max_temper 整数 100 实体的初始好感度的最大值
min_temper 整数 0 实体的初始好感度的最小值
ride_text 字符串 在骑行交互按钮中显示的文本。
tame_event 字符串 当实体被驯服时触发的事件。
返回顶部

minecraft:target_nearby_sensor

定义实体的范围，在该范围内，它可以看到或感知其他实体以将其作为目标。

名称 类型 默认值 描述
inside_range 浮点数 1 其它实体将被视为在目标范围内的最大距离（以方块为单位）
must_see 布尔值 false 是否需要看见
on_inside_range JSON对象 当实体进入范围内时调用的事件。可以为事件名称指定 'event'，为事件的目标指定 'target'
on_outside_range JSON对象 当实体走出范围时调用的事件。可以为事件名称指定 'event'，为事件的目标指定 'target'
on_vision_lost_inside_range JSON对象 当实体退出可视范围时调用的事件。可以为事件名称指定 'event'，为事件的目标指定 'target'
outside_range 浮点数 5 距离多少时将被视为在范围外（以方块为单位）
返回顶部

minecraft:teleport

定义实体的传送行为。

名称 类型 默认值 描述
dark_teleport_chance 浮点数 0.01 实体在黑暗中时传送的几率
light_teleport_chance 浮点数 0.01 实体在日光下传送的几率
max_random_teleport_time 浮点数 20 随机传送之间的最大时间（秒）
min_random_teleport_time 浮点数 0 随机传送之间的最短时间（秒）
random_teleport_cube 向量 [a, b, c] [32, 16, 32] 实体将传送到此立方体区域内的随机位置
random_teleports 布尔值 true 如果为 true，则实体将随机传送
target_distance 浮点数 16 实体在追逐目标时传送的最大距离
target_teleport_chance 浮点数 1 实体传送的几率。1.0 表示 100%
返回顶部

minecraft:tick_world

定义实体是否加载周围区块。

名称 类型 默认值 描述
distance_to_players 浮点数 128 最近的玩家离此实体的距离到达此数值时，此实体消失。如果 never_despawn 为 true，则将忽略此选项。最少： 128 个方块。
never_despawn 布尔值 true 如果为 true，则即使玩家距离很远，此实体也不会消失。如果为 false，则 distance_to_players 将用于确定何时消失。
radius 正整数 2 要加载的周围的区块。默认值：2。允许的范围：2-6。
返回顶部

minecraft:timer

添加一个计时器，时间用完之后将触发事件。

名称 类型 默认值 描述
looping 布尔值 true 如果为 true，则计时器将在每次触发后重新启动。
randomInterval 布尔值 true 如果为 true，则计时器上的时间量将在 "time" 中指定的最小值和最大值之间随机取值。
random_time_choices List [ ] 这是一个对象列表，表示在触发事件之前可以选择的一个值（以秒为单位）和一个可选的权重。与 "time" 不兼容。
time 范围 [a, b] [0.0, 0.0] 计时器的时间量（以秒为单位）。可以指定为一个数字或一对数字（最小值和最大值）。与 "random_time_choices" 不兼容。
time_down_event 字符串 计时器上的时间用完时触发的事件。
返回顶部

minecraft:trade_table

定义此实体与玩家交易的能力。

名称 类型 默认值 描述
convert_trades_economy 布尔值 false 确定当生物变化时，当新生物有economy_trade_table时是否应该转换交易。当交易被转换时，生物会用他们的新交易表生成一个新的交易列表，但随后它会尝试转换任何相同的交易以获得相同的附魔和用户数据。例如，如果原来的交易有一个绿宝石换附魔铁剑（锋利 1），而新交易也有一个绿宝石附魔铁剑，那么附魔将是锋利 1。
display_name 字符串 与此实体交易时要显示的名称。
new_screen 布尔值 false 用于确定与实体交易是否打开新的交易屏幕。
persist_trades 布尔值 false 确定当生物变化时交易是否应持续。这样，下次生物被转化为具有trade_table或economy_trade_table的实体时，它就会保留他们的交易。
table 字符串 用于此实体交易的行为包根的文件路径。
返回顶部

minecraft:trail

使实体在世界中移动时留下方块的痕迹。

名称 类型 默认值 描述
block_type 字符串 air 您希望实体在世界中移动时生成的方块的类型。实心方块不能在偏移量 (0,0,0) 处生成。
spawn_filter Minecraft 类型 生成所选方块类型必须满足的一个或多个条件。
spawn_offset 向量 [a, b, c] [0, 0, 0] 与实体当前位置的距离，以生成方块。上限可达 16 个方块。X 值为 左/右(-/+)，Z 值为 后/前(-/+)，Y 值为 下/上(-/+)。
返回顶部

minecraft:transformation

将实体转换成另一个实体

名称 类型 默认值 描述
add JSON对象 转换后要添加到实体的组件列表
名称 类型 默认值 描述
component_groups List 要添加的组件组的名称
begin_transform_sound 字符串 转换开始时播放的声音
delay JSON对象 定义转换的延迟属性
名称 类型 默认值 描述
block_assist_chance 浮点数 0 实体寻找附近可以加快转换速度的方块的几率。值必须介于 0.0 和 1.0 之间
block_chance 浮点数 0 一旦找到一个方块，将有助于加快转换速度
block_max 整数 0 实体将寻找的最大方块数以帮助转换。如果未定义或设置为 0，则将其设置为方块半径
block_radius 整数 0 实体将搜索有助于转换的方块的距离（以方块为单位）
block_types List 可以帮助此实体加速转换的方块的列表
value 浮点数 0 实体转换所需的时间（以秒为单位）
drop_equipment 布尔值 false 实体在转换时是否掉落所有装备
drop_inventory 布尔值 false 实体在转换时是否掉落物品栏中的所有物品
into 字符串 此实体将转换为的实体
keep_level 布尔值 false 如果此实体已进行交易并已升级，则它在转换后应保持该级别。
keep_owner 布尔值 false 如果此实体由另一个实体驯服，则它在转换后应保持拥有状态。
preserve_equipment 布尔值 false 使实体在经过转换后保留装备
transformation_sound 字符串 实体完成转换时播放的声音
返回顶部

minecraft:trusting

定义生物信任玩家的规则。

名称 类型 默认值 描述
probability 浮点数 1.00 信任的几率介于 0.0 和 1.0 之间，其中 1.0 为 100%。
trust_event 字符串 当此实体变为信任时运行的 Event。
trust_items List 可用于使实体信任玩家的物品列表。
返回顶部

minecraft:water_movement

定义实体在水中移动的速度。

名称 类型 默认值 描述
drag_factor 浮点数 0.8 在水中移动时的阻力系数。
返回顶部



Entity Definition Properties

这些属性是整个实体定义的一部分，位于 Component 或 Component Group 之前。确保将它们放在任何 Components、Component Groups 或 Events 部分之前，否则它们将被忽略。

format_version

指定创建此实体时的游戏版本。如果版本低于当前版本，则对原版版本中的实体所做的任何更改都将应用于该实体。
返回顶部

Code Example

Example



Entity Description Properties

本节定义标识和构造实体所需的属性

Entity Description Properties

identifier

设置此实体的名称。

类型 默认值 描述
字符串 此实体的标识符
返回顶部

is_spawnable

设置此实体是否有生物蛋

类型 默认值 描述
布尔值 false 设置此实体是否有生物蛋
返回顶部

is_summonable

是否能被/summon召唤

类型 默认值 描述
布尔值 false 是否能被/summon召唤
返回顶部

runtime_identifier

设置此实体将用于构建自身的原版Minecraft标识符的名称。

类型 默认值 描述
字符串 用于构造此实体的标识符
返回顶部



animations

设置内部动画引用到实际动画的映射。这是名称/动画对的 JSON 对象

名称 类型 默认值 描述
animation 字符串 none 要使用的实际动画
name 字符串 none 此动画条目的内部 （到实体） 名称
返回顶部

scripts

设置内部动画控制器引用到实际动画控制器的映射。这是一个名称/动画控制器对的 JSON 数组

名称 类型 默认值 描述
animation controller 字符串 none 要使用的实际动画
name 字符串 none 此动画条目的内部 （到实体） 名称
返回顶部



ID Lists

AI Goals （AI意向）

JSON Name ID
minecraft:behavior.admire_item 1024844406
minecraft:behavior.barter 536670686
minecraft:behavior.beg 1346418048
minecraft:behavior.break_door -1798237626
minecraft:behavior.breed 51166360
minecraft:behavior.defend_trusted_target 2070046390
minecraft:behavior.door_interact -286762735
minecraft:behavior.dragondeath -1541162059
minecraft:behavior.dragonholdingpattern 1066617362
minecraft:behavior.dragonlanding -152352492
minecraft:behavior.dragonscanning -1003941066
minecraft:behavior.dragontakeoff -1912535317
minecraft:behavior.drink_potion 277029334
minecraft:behavior.eat_carried_item -184757575
minecraft:behavior.enderman_leave_block -717580550
minecraft:behavior.enderman_take_block -537294220
minecraft:behavior.explore_outskirts -1955198366
minecraft:behavior.find_cover -1231227755
minecraft:behavior.find_mount 731306871
minecraft:behavior.find_underwater_treasure -1602192311
minecraft:behavior.flee_sun -617664229
minecraft:behavior.float 1758503000
minecraft:behavior.float_wander -1122048364
minecraft:behavior.follow_caravan 9936402
minecraft:behavior.follow_mob -1524701626
minecraft:behavior.follow_owner 1213259599
minecraft:behavior.follow_parent 2127040136
minecraft:behavior.follow_target_captain -135480526
minecraft:behavior.go_home -1579225026
minecraft:behavior.hide -1101331718
minecraft:behavior.hold_ground 1804286487
minecraft:behavior.hurt_by_target -1710404297
minecraft:behavior.inspect_bookshelf 40191182
minecraft:behavior.knockback_roar -1304117826
minecraft:behavior.lay_down -2074934675
minecraft:behavior.lay_egg -1207740530
minecraft:behavior.leap_at_target 256926956
minecraft:behavior.look_at_entity -1735428573
minecraft:behavior.look_at_player -1892159379
minecraft:behavior.look_at_target -885375871
minecraft:behavior.look_at_trading_player -2094605693
minecraft:behavior.make_love -1551283431
minecraft:behavior.mingle 385775952
minecraft:behavior.mount_pathing 1112137677
minecraft:behavior.move_through_village 779377630
minecraft:behavior.move_to_block -342788833
minecraft:behavior.move_to_land -943551837
minecraft:behavior.move_to_lava -945036492
minecraft:behavior.move_to_liquid 635836098
minecraft:behavior.move_to_poi -1614682114
minecraft:behavior.move_to_random_block 395022171
minecraft:behavior.move_to_village -805189394
minecraft:behavior.move_to_water 1886139445
minecraft:behavior.move_towards_target -166537884
minecraft:behavior.nap 992184933
minecraft:behavior.nearest_attackable_target 5824270165841165755
minecraft:behavior.nearest_prioritized_attackable_target 335414683
minecraft:behavior.ocelot_sit_on_block -1327999383
minecraft:behavior.offer_flower -885387854
minecraft:behavior.open_door -906200433
minecraft:behavior.owner_hurt_by_target 530667419
minecraft:behavior.owner_hurt_target 995655261
minecraft:behavior.panic -169886247
minecraft:behavior.peek 211304085
minecraft:behavior.pet_sleep_with_owner 1379392240
minecraft:behavior.pickup_items 644287189
minecraft:behavior.play -505601580
minecraft:behavior.player_ride_tamed 603869698
minecraft:behavior.raid_garden -1145687602
minecraft:behavior.random_breach 928528911
minecraft:behavior.random_fly -446385505
minecraft:behavior.random_hover -1797323808
minecraft:behavior.random_look_around 1177762851
minecraft:behavior.random_look_around_and_sit -1368070166
minecraft:behavior.random_sitting 1722716662
minecraft:behavior.random_stroll -1643504294
minecraft:behavior.random_swim -1465281278
minecraft:behavior.receive_love 1156694272
minecraft:behavior.restrict_open_door 715583988
minecraft:behavior.restrict_sun -382716017
minecraft:behavior.rise_to_liquid_level -950950337
minecraft:behavior.roll 817471653
minecraft:behavior.run_around_like_crazy -1390363669
minecraft:behavior.scared -1643945926
minecraft:behavior.send_event -823429137
minecraft:behavior.share_items 2045906118
minecraft:behavior.silverfish_merge_with_stone 321908121
minecraft:behavior.silverfish_wake_up_friends 484391748
minecraft:behavior.skeleton_horse_trap 530952387
minecraft:behavior.sleep -1811763
minecraft:behavior.slime_attack -1315951081
minecraft:behavior.snacking 875141064
minecraft:behavior.sneeze 1528584076
minecraft:behavior.squid_dive 1626998843
minecraft:behavior.squid_flee 1304043261
minecraft:behavior.squid_idle 1741234679
minecraft:behavior.squid_move_away_from_ground 892387674
minecraft:behavior.squid_out_of_water -1347598607
minecraft:behavior.stalk_and_pounce_on_target -1248479202
minecraft:behavior.stay_while_sitting 1346980478
minecraft:behavior.stomp_turtle_egg 851839416
minecraft:behavior.stroll_towards_village -1563831906
minecraft:behavior.summon_entity -2005850647
minecraft:behavior.swell -1473132493
minecraft:behavior.take_flower 1218648257
minecraft:behavior.tempt 422904556
minecraft:behavior.trade_interest -574851053
minecraft:behavior.trade_with_player -2048563493
minecraft:behavior.vex_copy_owner_target -643459543
minecraft:behavior.vex_random_move -1117822165
minecraft:behavior.wither_random_attack_pos_goal -528895885
minecraft:behavior.wither_target_highest_damage -1065562072
minecraft:behavior.work -391600209
返回顶部

Attributes（特性）

JSON Name ID
minecraft:attack 1651346034
minecraft:spell_effects 523264365
minecraft:strength 648564399
返回顶部

Components（组件）

JSON Name ID
-2078137563
minecraft:addrider -1014528905
minecraft:admire_item -1838165406
minecraft:ageable 1092934985
minecraft:angry 725411499
minecraft:annotation.break_door 2116838963
minecraft:annotation.open_door 1004733768
minecraft:area_attack 1169114880
minecraft:attack_cooldown -1439360398
minecraft:barter -1660828566
minecraft:block_climber -505801518
minecraft:block_sensor 1944169706
minecraft:boostable -8316315
minecraft:boss -1309638025
minecraft:break_blocks -944056304
minecraft:breathable -707187232
minecraft:breedable -1616430100
minecraft:bribeable -2125526908
minecraft:buoyant -467213736
minecraft:burns_in_daylight 1256874605
minecraft:celebrate_hunt -789611239
minecraft:combat_regeneration -315365016
minecraft:conditional_bandwidth_optimization 1333085468
minecraft:custom_hit_test 2035968892
minecraft:damage_over_time -656420526
minecraft:damage_sensor -82616534
minecraft:despawn 1674909940
minecraft:drying_out_timer 2113510784
minecraft:economy_trade_table 1705466896
minecraft:entity_sensor -406052184
minecraft:environment_sensor 687748970
minecraft:equip_item -1774220620
minecraft:equippable -1164142226
minecraft:experience_reward -1992597900
minecraft:explode -1683058581
minecraft:flocking 1967597361
minecraft:genetics -82484670
minecraft:giveable 1739199795
minecraft:group_size -1997375941
minecraft:grows_crop 43636353
minecraft:healable -54247424
minecraft:home 610829097
minecraft:hurt_on_condition 163715083
minecraft:inside_block_notifier -377593253
minecraft:insomnia -300455606
minecraft:instant_despawn -634288138
minecraft:interact -1996861528
minecraft:inventory 1941951218
minecraft:item_hopper -447601772
minecraft:jump.dynamic 945664737
minecraft:jump.static 1064987526
minecraft:leashable 893445039
minecraft:lookat -1329707008
minecraft:managed_wandering_trader 846609640
minecraft:mob_effect 490430596
minecraft:movement.amphibious -500784850
minecraft:movement.basic 3354475
minecraft:movement.fly -1487316136
minecraft:movement.generic -1363369868
minecraft:movement.hover 1743805051
minecraft:movement.jump 1256268727
minecraft:movement.skip -1828832272
minecraft:movement.sway 2126249079
minecraft:nameable -595398763
minecraft:navigation.climb -1075360945
minecraft:navigation.float -842998036
minecraft:navigation.fly -1997823129
minecraft:navigation.generic 1768002583
minecraft:navigation.hover -769247640
minecraft:navigation.swim 1908076634
minecraft:navigation.walk 1909033775
minecraft:npc 1140005505
minecraft:out_of_control -639930856
minecraft:peek -863721039
minecraft:persistent 1435858387
minecraft:physics 1021552959
minecraft:preferred_path 1431188951
minecraft:projectile 1922456869
minecraft:pushable -1784639134
minecraft:raid_trigger 2093209329
minecraft:rail_movement -78235634
minecraft:rail_sensor 1273161273
minecraft:ravager_blocked -1417579541
minecraft:rideable 1656173828
minecraft:scale_by_age 64881972
minecraft:scheduler -684492525
minecraft:shareables 1301057082
minecraft:shooter 184150118
minecraft:sittable -1376274106
minecraft:spawn_entity 1991964333
minecraft:tameable 932870003
minecraft:tamemount 1615660288
minecraft:target_nearby_sensor 1309819882
minecraft:teleport -1900891127
minecraft:tick_world -381759296
minecraft:timer 1862095863
minecraft:trade_table 50480315
minecraft:trail 1632590434
minecraft:transformation -457894577
minecraft:trusting 936499892
minecraft:water_movement -128701925
返回顶部

Entity Description Properties

JSON Name ID
animations 1232311658
scripts -76244517
返回顶部

Properties

JSON Name ID
minecraft:ambient_sound_interval -1314051310
minecraft:can_climb -550459594
minecraft:can_fly 985724318
minecraft:can_power_jump -763124853
minecraft:collision_box -1277663508
minecraft:color 1069623177
minecraft:color2 1429635777
minecraft:default_look_angle -815556357
minecraft:equipment 714661022
minecraft:fire_immune -1071767182
minecraft:floats_in_liquid 179778474
minecraft:flying_speed -570508595
minecraft:friction_modifier -714364556
minecraft:ground_offset -1816881803
minecraft:input_ground_controlled -646415617
minecraft:is_baby 1853172763
minecraft:is_charged 125340337
minecraft:is_chested -817599379
minecraft:is_dyeable 1381448355
minecraft:is_hidden_when_invisible -1553744
minecraft:is_ignited 905710223
minecraft:is_illager_captain 921912694
minecraft:is_saddled 1037901616
minecraft:is_shaking 523951884
minecraft:is_sheared 1154836813
minecraft:is_stackable 1184456737
minecraft:is_stunned 1818977510
minecraft:is_tamed 1646421078
minecraft:item_controllable 1868311069
minecraft:loot 1775814032
minecraft:mark_variant 663621689
minecraft:push_through -138030768
minecraft:scale 77854436
minecraft:skin_id 1838729593
minecraft:sound_volume 937951776
minecraft:type_family -255011285
minecraft:variant -1789583977
minecraft:walk_animation_speed 972393614
minecraft:wants_jockey 1832515141
返回顶部

Triggers（触发器）

JSON Name ID
minecraft:on_death -49357854
minecraft:on_friendly_anger -1009986313
minecraft:on_hurt -1028603471
minecraft:on_hurt_by_player -599009831
minecraft:on_ignite -1911489054
minecraft:on_start_landing -555648368
minecraft:on_start_takeoff 426083399
minecraft:on_target_acquired 1063277906
minecraft:on_target_escape -1373130027
minecraft:on_wake_with_owner -1543219003
返回顶部



Properties

minecraft:ambient_sound_interval

设置实体播放其环境声音之间的延迟。

名称 类型 默认值 描述
event_name 字符串 ambient Level sound 事件作为环境声音播放。
range 浮点数 16.000000 随机添加到环境声音延迟时间的最长时间（以秒为单位）。
value 浮点数 8.000000 实体再次播放其环境声音之前的最短时间（以秒为单位）。
返回顶部

minecraft:can_climb

允许此实体爬上梯子。
返回顶部

minecraft:can_fly

将实体标记为能够飞行，探路者将不再限制其下方需要实心方块的路径。
返回顶部

minecraft:can_power_jump

允许实体像原版中的马一样进行强力跳跃。
返回顶部

minecraft:collision_box

设置实体的碰撞箱的宽度和高度。

名称 类型 默认值 描述
height 浮点数 1.0 碰撞箱的高度（以方块为单位）。负值将被设定为 0。
width 浮点数 1.0 碰撞箱的宽度（以方块为单位）。负值将被设定为 0。
返回顶部

minecraft:color

定义实体的颜色。仅适用于具有预定义颜色值的原版实体（绵羊、羊驼、潜影贝）。

名称 类型 默认值 描述
value 整数 0 实体的颜色值
返回顶部

minecraft:color2

定义实体的第二种纹理颜色。仅适用于具有第二个预定义颜色值的原版实体。 （热带鱼）

名称 类型 默认值 描述
value 整数 0 实体的第二种颜色值
返回顶部

minecraft:default_look_angle

设置此实体的默认头部旋转角度。

名称 类型 默认值 描述
value 浮点数 0.0f 角度（以度为单位）。
返回顶部

minecraft:equipment

设置用于此实体的装备表。

名称 类型 默认值 描述
slot_drop_chance List 有几率从该槽位中掉落装备物品的槽位列表。
table 字符串 装备表的文件路径，相对于行为包的根目录。
返回顶部

minecraft:fire_immune

设置此实体不会受到火焰伤害。
返回顶部

minecraft:floats_in_liquid

设置此实体可以漂浮在液体块中。
返回顶部

minecraft:flying_speed

此实体飞行的速度（以方块为单位）。

名称 类型 默认值 描述
value 浮点数 0.02 每刻的飞行速度（以方块为单位）。
返回顶部

minecraft:friction_modifier

定义摩擦力影响此实体的程度。

名称 类型 默认值 描述
value 浮点数 1.0 数字越大，摩擦力对此实体的影响就越大。值 1.0 表示常规摩擦力，而 2.0 表示两倍的摩擦力。
返回顶部

minecraft:ground_offset

设置实体实际位于的地面的偏移量。

名称 类型 默认值 描述
value 浮点数 0.0 实体与地面的偏移量值（以方块为单位）。
返回顶部

minecraft:input_ground_controlled

当配置为可骑行实体时，将使用 WASD 控件控制该实体。
返回顶部

minecraft:is_baby

设置此实体为婴儿。
返回顶部

minecraft:is_charged

当实体处于充能状态下使用的组件
返回顶部

minecraft:is_chested

设置此实体当前携带箱子 。
返回顶部

minecraft:is_dyeable

允许对此实体使用染料以更改其颜色。

名称 类型 默认值 描述
interact_text 字符串 使用染料与此实体交互时将显示的按钮文本。
返回顶部

minecraft:is_hidden_when_invisible

设置此实体可以在隐身时躲避敌对生物。
返回顶部

minecraft:is_ignited

设置此实体当前处于着火状态。
返回顶部

minecraft:is_illager_captain

设置此实体是灾厄队长。
返回顶部

minecraft:is_saddled

设置此实体当前处于有鞍状态。
返回顶部

minecraft:is_shaking

设置此实体当前正在晃动。
返回顶部

minecraft:is_sheared

设置此实体当前已被修剪。
返回顶部

minecraft:is_stackable

设置此实体可以堆叠。
返回顶部

minecraft:is_stunned

设置此实体当前处于眩晕状态。
返回顶部

minecraft:is_tamed

设置此实体当前被驯服。
返回顶部

minecraft:item_controllable

定义在骑行时可以使用哪些物品来控制此实体。

名称 类型 默认值 描述
control_items List 可用于控制此实体的物品列表。
返回顶部

minecraft:loot

设置此实体死亡时掉落的物品的战利品表。

名称 类型 默认值 描述
table 字符串 战利品表的路径，相对于行为包的根目录。
返回顶部

minecraft:mark_variant

其他变种值。可用于进一步区分变种。

名称 类型 默认值 描述
value 整数 0 变种的 ID。按照惯例，0 是基本实体的 ID。
返回顶部

minecraft:push_through

设置实体可以推入的距离。

名称 类型 默认值 描述
value 浮点数 0.0 实体的 push-through 值（以方块为单位）。
返回顶部

minecraft:scale

设置实体的视觉大小。

名称 类型 默认值 描述
value 浮点数 1.0 1.0 表示实体将以其在模型中定义的比例显示。数字越大，实体越大。
返回顶部

minecraft:skin_id

皮肤 ID 值。可以用来区分皮肤，比如村民的基础皮肤。

名称 类型 默认值 描述
value 整数 0 皮肤的 ID。按照惯例，0 是基础皮肤的 ID。
返回顶部

minecraft:sound_volume

设置实体的音效基本音量。

名称 类型 默认值 描述
value 浮点数 1.0 实体用于音效的音量值。
返回顶部

minecraft:type_family

定义此实体所属的族。

名称 类型 默认值 描述
family List 实体族列表
返回顶部

minecraft:variant

用于将实体变种的组件组与其他变种的组件组区分开来。（如：豹猫、村民）

名称 类型 默认值 描述
value 整数 0 变种的 ID。按照惯例，0 是基本实体的 ID。
返回顶部

minecraft:walk_animation_speed

设置此实体的行走动画速度的速度乘数。

名称 类型 默认值 描述
value 浮点数 1.0 数字越大，行走动画的播放速度越快。值 1.0 表示正常速度，而值 2.0 表示速度快两倍。
返回顶部

minecraft:wants_jockey

设置此实体要成为骑手。
返回顶部



Triggers

minecraft:on_death

只能由末影龙使用。添加一个触发器，用于调用此实体的死亡。

名称 类型 默认值 描述
event 字符串 满足此触发器的条件时要运行的事件。
filters Minecraft 类型 此触发器要执行的条件列表。
target 字符串 self 事件的目标。
返回顶部

minecraft:on_friendly_anger

添加一个触发器，当附近与此实体类型相同的实体变得愤怒时，该触发器将运行。

名称 类型 默认值 描述
event 字符串 满足此触发器的条件时要运行的事件。
filters Minecraft 类型 此触发器要执行的条件列表。
target 字符串 self 事件的目标。
返回顶部

minecraft:on_hurt

添加一个触发器，以便在此实体受到伤害时调用

名称 类型 默认值 描述
event 字符串 满足此触发器的条件时要运行的事件。
filters Minecraft 类型 此触发器要执行的条件列表。
target 字符串 self 事件的目标。
返回顶部

minecraft:on_hurt_by_player

添加一个触发器，以便在此实体受到玩家攻击时调用

名称 类型 默认值 描述
event 字符串 满足此触发器的条件时要运行的事件。
filters Minecraft 类型 此触发器要执行的条件列表。
target 字符串 self 事件的目标。
返回顶部

minecraft:on_ignite

添加一个触发器，以便在此实体设置为着火时调用

名称 类型 默认值 描述
event 字符串 满足此触发器的条件时要运行的事件。
filters Minecraft 类型 此触发器要执行的条件列表。
target 字符串 self 事件的目标。
返回顶部

minecraft:on_start_landing

只能由末影龙使用。添加一个触发器，以便在此实体登陆时调用

名称 类型 默认值 描述
event 字符串 满足此触发器的条件时要运行的事件。
filters Minecraft 类型 此触发器要执行的条件列表。
target 字符串 self 事件的目标。
返回顶部

minecraft:on_start_takeoff

只能由末影龙使用。添加一个触发器，以便在此实体开始飞行时调用

名称 类型 默认值 描述
event 字符串 满足此触发器的条件时要运行的事件。
filters Minecraft 类型 此触发器要执行的条件列表。
target 字符串 self 事件的目标。
返回顶部

minecraft:on_target_acquired

添加触发器，以便在此实体找到目标时调用。

名称 类型 默认值 描述
event 字符串 满足此触发器的条件时要运行的事件。
filters Minecraft 类型 此触发器要执行的条件列表。
target 字符串 self 事件的目标。
返回顶部

minecraft:on_target_escape

添加一个触发器，当此实体丢失其当前拥有的目标时调用。

名称 类型 默认值 描述
event 字符串 满足此触发器的条件时要运行的事件。
filters Minecraft 类型 此触发器要执行的条件列表。
target 字符串 self 事件的目标。
返回顶部

minecraft:on_wake_with_owner

添加一个触发器，当此宠物的主人在与宠物一起睡觉后醒来时调用。

名称 类型 默认值 描述
event 字符串 满足此触发器的条件时要运行的事件。
filters Minecraft 类型 此触发器要执行的条件列表。
target 字符串 self 事件的目标。
返回顶部