ENTITIES DOCUMENTATION
Version: 1.21.50.7

索引

Client Entity Documentation
Spawn Egg
animation_controllers
animations
enable_attachables
held_item_ignores_lighting
hide_armor
identifier
locators
materials, textures, animations
min_engine_version
particle
render_controllers
scripts
Data-Driven Spawning
Spawn Rules
Filters
actor_health
all_slots_empty
any_slot_empty
bool_property
clock_time
distance_to_nearest_player
enum_property
float_property
has_ability
has_biome_tag
has_component
has_container_open
has_damage
has_damaged_equipment
has_equipment
has_mob_effect
has_nametag
has_property
has_ranged_weapon
has_silk_touch
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_overworld
in_water
in_water_or_rain
inactivity_timer
int_property
is_altitude
is_avoiding_mobs
is_baby
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_navigating
is_owner
is_panicking
is_persistent
is_raider
is_riding
is_sitting
is_skin_id
is_sleeping
is_sneak_held
is_sneaking
is_snow_covered
is_sprinting
is_target
is_temperature_type
is_temperature_value
is_underground
is_underwater
is_variant
is_visible
is_waterlogged
is_weather
light_level
moon_intensity
moon_phase
on_fire
on_ground
on_hot_block
on_ladder
owner_distance
random_chance
rider_count
surface_mob
taking_fire_damage
target_distance
trusts
was_last_hurt_by
weather
weather_at_position
Server Entity Documentation
AI Goals
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 来设置基础色（底色）和覆盖色。

Hex Value

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

返回顶部

Texture

另一种方法是指定纹理。

示例：指定纹理的刷怪蛋。纹理位于资源包的 textures 文件夹中的 “items_texture” JSON 中。当一个纹理名称有一个以上的纹理时，你可以使用一个特殊值来选择你想要的那个。如果没有指定特殊值，则假定其为 0 ，并使用列表中的第一个纹理

指定了一个纹理的刷怪蛋示例

返回顶部



animation_controllers（动画控制器）

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

animations（动画）

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

enable_attachables（允许附着物）

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



返回顶部

hide_armor（隐藏盔甲）

这决定了实体持有的物品的渲染是应该完全照亮（如果为 true），还是取决于周围的光亮。



返回顶部

hide_armor

This determines if the armor attached to an entity should be hidden when set to true. This overrides the rendering settings specified by '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, monster
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"中的所有检测都必须不通过，该组才会通过。

actor_health

Tests the health of the subject.

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

示例

完整..

简短（使用默认值）..

返回顶部

all_slots_empty

Returns true when the designated equipment location for the subject entity is completely empty.

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

示例

完整..

简短（使用默认值）..

返回顶部

any_slot_empty

Returns true when the designated equipment location for the subject entity has any empty slot.

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

示例

完整..

简短（使用默认值）..

返回顶部

bool_property

Returns true when the bool actor property matches the value provided.

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

示例

完整..

简短（使用默认值）..

返回顶部

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 浮点数 （必须）一个浮点值。

示例

完整..

简短（使用默认值）..

返回顶部

enum_property

Returns true when the enum actor property matches the value provided.

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

示例

完整..

简短（使用默认值）..

返回顶部

float_property

Returns true when the float actor property matches the value provided.

名称 类型 默认值 描述
domain 字符串 (Required) The property name to look for
operator 字符串 equals （可选）要应用的与‘value’的比较。
选项 描述
!= 检测不等关系。
< 检测小于value。
<= 检测小于或等于value。
<> 检测不等关系。
= 检测相等关系。
== 检测相等关系。
> 检测大于value。
>= 检测大于或等于value。
equals 检测相等关系。
not 检测不等关系。
subject 字符串 self （可选）该次过滤器检测的主体。
选项 描述
block 参与到该次交互的方块。
damager 参与到该次交互的正在造成伤害的活动对象。
other 在一次交互中与该次交互的调用者对立的成员。
parent 调用者当前的父成员。
player 参与到该次交互的玩家。
self 正在调用该次检测的实体或对象
target 调用者当前的目标。
value 浮点数 (Required) A floating point 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 弹射物
self_destruct /kill 指令
sonic_boom 音爆
stalactite 钟乳石
stalagmite 石笋
starve 饥饿
suffocation 窒息
thorns 荆棘
void 虚空
wither 凋零

示例

完整..

简短（使用默认值）..

返回顶部

has_damaged_equipment

Tests for the presence of a damaged named item in the designated slot of the subject entity.

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

示例

完整..

简短（使用默认值）..

返回顶部

has_equipment

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

名称 类型 默认值 描述
domain 字符串 any （可选）要检测的装备位置
选项 描述
any
armor
body
feet
hand
head
inventory
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_property

Tests for the presence of a property of the subject entity.

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

示例

完整..

简短（使用默认值）..

返回顶部

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_silk_touch

Tests if the subject is holding an item with silk touch.

名称 类型 默认值 描述
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_overworld

Returns true when the subject entity is in Overworld.

名称 类型 默认值 描述
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 整数 （必须）一个整数值。

示例

完整..

简短（使用默认值）..

返回顶部

int_property

Returns true when the int actor property matches the value provided.

名称 类型 默认值 描述
domain 字符串 (Required) The property name to look for
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_baby

Returns true when the subject entity is a baby.

名称 类型 默认值 描述
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_navigating

Tests if the subject is currently pathfinding. Requires a "minecraft:navigation" component.

名称 类型 默认值 描述
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_panicking

Tests if the subject is panicking.

名称 类型 默认值 描述
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_raider

Tests if the subject is a raider.

名称 类型 默认值 描述
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_sitting

Tests if the subject is sitting.

名称 类型 默认值 描述
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_sneak_held

Returns true if the subject entity has the sneak input held.

名称 类型 默认值 描述
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_sprinting

Tests if the subject is sprinting.

名称 类型 默认值 描述
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_waterlogged

Tests if the subject block is submerged in water.

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

Tests if the subject is on fire.

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

示例

完整..

简短（使用默认值）..

返回顶部

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_hot_block

Tests if the subject is on a hot block.

名称 类型 默认值 描述
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。

示例

完整..

简短（使用默认值）..

返回顶部

owner_distance

Tests the distance between the subject and its owner. Returns false if there is no owner.

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

示例

完整..

简短（使用默认值）..

返回顶部

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。

示例

完整..

简短（使用默认值）..

返回顶部

taking_fire_damage

Tests if the subject is taking fire damage. Requires the damage_sensor component

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

示例

完整..

简短（使用默认值）..

返回顶部

target_distance

Tests the distance between the calling entity and its target.

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

示例

完整..

简短（使用默认值）..

返回顶部

trusts

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

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

示例

完整..

简短（使用默认值）..

返回顶部

was_last_hurt_by

Tests if the subject is the last player who attacked the entity in the last 400 seconds, or the last mob to do so in the last 60 seconds.

名称 类型 默认值 描述
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.avoid_block

Allows this entity to avoid certain blocks.

名称 类型 默认值 描述
avoid_block_sound 字符串 The sound event to play when the mob is avoiding a block.
on_escape 触发器 Escape trigger.
search_height 整数 0 Maximum distance to look for a block in y.
search_range 整数 0 Maximum distance to look for a block in xz.
sound_interval 范围 [a, b] [3.0, 8.0] The range of time in seconds to randomly wait before playing the sound again.
sprint_speed_modifier 浮点数 1.0 Modifier for sprint speed. 1.0 means keep the regular speed, while higher numbers make the sprint speed faster.
target_blocks 列表 List of block types this mob avoids.
target_selection_method 字符串 nearest Block search method.
tick_interval 整数 1 Should start tick interval.
walk_speed_modifier 浮点数 1.0 Modifier for walking speed. 1.0 means keep the regular speed, while higher numbers make the walking speed faster.
返回顶部

minecraft:behavior.avoid_mob_type

Allows the entity to run away from other entities that meet the criteria specified.

名称 类型 默认值 描述
avoid_mob_sound 字符串 The sound event to play when the mob is avoiding another mob.
avoid_target_xz 整数 16 The next target position the entity chooses to avoid another entity will be chosen within this XZ Distance.
avoid_target_y 整数 7 The next target position the entity chooses to avoid another entity will be chosen within this Y Distance.
entity_types Minecraft 过滤器 The list of conditions another entity must meet to be a valid target to avoid.
ignore_visibilty 布尔值 false Whether or not to ignore direct line of sight while this entity is running away from other specified entities.
max_dist 浮点数 3.0 Maximum distance to look for an avoid target for the entity.
max_flee 浮点数 10.0 How many blocks away from its avoid target the entity must be for it to stop fleeing from the avoid target.
on_escape_event 触发器 Event that is triggered when escaping from a mob.
probability_per_strength 浮点数 1.0 Percent chance this entity will stop avoiding another entity based on that entity's strength, where 1.0 = 100%.
remove_target 布尔值 false Determine if we should remove target when fleeing or not.
sound_interval 范围 [a, b] [3.0, 8.0] The range of time in seconds to randomly wait before playing the sound again.
sprint_distance 浮点数 7.0 How many blocks within range of its avoid target the entity must be for it to begin sprinting away from the avoid target.
sprint_speed_multiplier 浮点数 1.0 Multiplier for sprint speed. 1.0 means keep the regular speed, while higher numbers make the sprint speed faster.
walk_speed_multiplier 浮点数 1.0 Multiplier for walking speed. 1.0 means keep the regular speed, while higher numbers make the walking speed faster.
返回顶部

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.celebrate

Allows this entity to celebrate surviving a raid by making celebration sounds and jumping.

名称 类型 默认值 描述
celebration_sound 字符串 The sound event to trigger during the celebration.
duration 浮点数 30.000000 The duration in seconds that the celebration lasts for.
jump_interval 范围 [a, b] [1, 3.5] Minimum and maximum time between jumping (positive, in seconds).
on_celebration_end_event 触发器 The event to trigger when the goal's duration expires.
sound_interval 范围 [a, b] [2, 7] Minimum and maximum time between sound events (positive, in seconds).
返回顶部

minecraft:behavior.celebrate_survive

Allows this entity to celebrate surviving a raid by shooting fireworks.

名称 类型 默认值 描述
duration 浮点数 30.000000 The duration in seconds that the celebration lasts for.
fireworks_interval 范围 [a, b] [10, 20] Minimum and maximum time between firework (positive, in seconds).
on_celebration_end_event 触发器 The event to trigger when the goal's duration expires.
返回顶部

minecraft:behavior.charge_attack

Allows this entity to damage a target by using a running attack.

名称 类型 默认值 描述
max_distance 浮点数 3 A charge attack cannot start if the entity is farther than this distance to the target.
min_distance 浮点数 2 A charge attack cannot start if the entity is closer than this distance to the target.
speed_multiplier 浮点数 1 Modifies the entity's speed when charging toward the target.
success_rate 浮点数 0.1428 Percent chance this entity will start a charge attack, if not already attacking (1.0 = 100%)
返回顶部

minecraft:behavior.charge_held_item

Allows an entity to charge and use their held item.

名称 类型 默认值 描述
items 数组 NA The list of items that can be used to charge the held item. This list is required and must have at least one item in it.
返回顶部

minecraft:behavior.circle_around_anchor

Causes an entity to circle around an anchor point placed near a point or target.

名称 类型 默认值 描述
angle_change 浮点数 15.0 Number of degrees to change this entity's facing by, when the entity selects its next anchor point.
goal_radius 浮点数 0.5 Maximum distance from the anchor-point in which this entity considers itself to have reached the anchor point. This is to prevent the entity from bouncing back and forth trying to reach a specific spot.
height_above_target_range 范围 [a, b] [ 0.0, 0.0 ] The number of blocks above the target that the next anchor point can be set. This value is used only when the entity is tracking a target.
height_adjustment_chance 浮点数 0.002857 Percent chance to determine how often to increase or decrease the current height around the anchor point. 1 = 100%. "height_change_chance" is deprecated and has been replaced with "height_adjustment_chance".
height_offset_range 范围 [a, b] [ 0.0, 0.0 ] Vertical distance from the anchor point this entity must stay within, upon a successful height adjustment.
radius_adjustment_chance 浮点数 0.004 Percent chance to determine how often to increase the size of the current movement radius around the anchor point. 1 = 100%. "radius_change_chance" is deprecated and has been replaced with "radius_adjustment_chance".
radius_change 浮点数 1.0 The number of blocks to increase the current movement radius by, upon successful "radius_adjustment_chance". If the current radius increases over the range maximum, the current radius will be set back to the range minimum and the entity will change between clockwise and counter-clockwise movement..
radius_range 范围 [a, b] [ 5.0, 15.0 ] Horizontal distance from the anchor point this entity must stay within upon a successful radius adjustment.
speed_multiplier 浮点数 1.0 Multiplies the speed at which this entity travels to its next desired position.
返回顶部

minecraft:behavior.controlled_by_player

Allows the entity to be controlled by the player using an item in the item_controllable property (required). Also requires the minecraft:movement property, and the minecraft:rideable property. On every tick, the entity will attempt to rotate towards where the player is facing with the control item whilst simultaneously moving forward.

名称 类型 默认值 描述
fractional_rotation 浮点数 0.5 The entity will attempt to rotate to face where the player is facing each tick. The entity will target this percentage of their difference in their current facing angles each tick (from 0.0 to 1.0 where 1.0 = 100%). This is limited by FractionalRotationLimit. A value of 0.0 will result in the entity no longer turning to where the player is facing.
fractional_rotation_limit 浮点数 5.0 Limits the total degrees the entity can rotate to face where the player is facing on each tick.
mount_speed_multiplier 浮点数 1.0 Speed multiplier of mount when controlled by player.
返回顶部

minecraft:behavior.croak

Allows the entity to croak at a random time interval with configurable conditions.

名称 类型 默认值 描述
duration 范围 [a, b] [4.5, 4.5] Random range in seconds after which the croaking stops. Can also be a constant.
filters Minecraft 过滤器 Conditions for the behavior to start and keep running. The interval between runs only starts after passing the filters.
interval 范围 [a, b] [10, 20] Random range in seconds between runs of this behavior. Can also be a constant.
返回顶部

minecraft:behavior.defend_trusted_target

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

名称 类型 默认值 描述
aggro_sound 字符串 在防御时偶尔播放的声音。
attack_interval 整数 0 两次攻击之间的时间（单位为秒）。
entity_types JSON对象 能被生物作为有效目标的实体列表。
名称 类型 默认值 描述
cooldown 浮点数 0.0 The amount of time in seconds that the mob has to wait before selecting a target of the same type again
filters Minecraft 过滤器 使列表中的该条目有效的条件。
max_dist 浮点数 16 生物锁定实体时可以离开的最大距离。
must_see 布尔值 false 当值为"true"时，实体锁定的目标必须是可见的。
must_see_forget_duration 浮点数 3.0 决定该生物在失去一个目标并在目标不再可见时重新寻找一个新的目标之前所需的时间（单位为秒）。
reevaluate_description 布尔值 false If true, the mob will stop being targeted if it stops meeting any conditions.
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.defend_village_target

Allows the entity to stay in a village and defend the village from aggressors. If a player is in bad standing with the village this goal will cause the entity to attack the player regardless of filter conditions.

名称 类型 默认值 描述
attack_chance 浮点数 0.05 The percentage chance that the entity has to attack aggressors of its village, where 1.0 = 100%.
返回顶部

minecraft:behavior.delayed_attack

Allows an entity to attack, while also delaying the damage-dealt until a specific time in the attack animation.

名称 类型 默认值 描述
attack_duration 浮点数 0.75 The entity's attack animation will play out over this duration (in seconds). Also controls attack cooldown.
attack_once 布尔值 false Allows the entity to use this attack behavior, only once EVER.
attack_types 字符串 N/A Defines the entity types this entity will attack.
can_spread_on_fire 布尔值 false If the entity is on fire, this allows the entity's target to catch on fire after being hit.
hit_delay_pct 浮点数 0.5 The percentage into the attack animation to apply the damage of the attack (1.0 = 100%).
inner_boundary_time_increase 浮点数 0.25 Time (in seconds) to add to attack path recalculation when the target is beyond the "path_inner_boundary".
max_dist 浮点数 N/A Unused. No effect on "minecraft:behavior.melee_attack".
max_path_time 浮点数 0.55 Maximum base time (in seconds) to recalculate new attack path to target (before increases applied).
melee_fov 浮点数 90 Field of view (in degrees) when using the sensing component to detect an attack target.
min_path_time 浮点数 0.2 Minimum base time (in seconds) to recalculate new attack path to target (before increases applied).
on_attack 触发器 N/A Defines the event to trigger when this entity successfully attacks.
outer_boundary_time_increase 浮点数 0.5 Time (in seconds) to add to attack path recalculation when the target is beyond the "path_outer_boundary".
path_fail_time_increase 浮点数 0.75 Time (in seconds) to add to attack path recalculation when this entity cannot move along the current path.
path_inner_boundary 浮点数 16 Distance at which to increase attack path recalculation by "inner_boundary_tick_increase".
path_outer_boundary 浮点数 32 Distance at which to increase attack path recalculation by "outer_boundary_tick_increase".
random_stop_interval 整数 0 This entity will have a 1 in N chance to stop it's current attack, where N = "random_stop_interval".
reach_multiplier 浮点数 1.5 Used with the base size of the entity to determine minimum target-distance before trying to deal attack damage.
require_complete_path 布尔值 false Toggles (on/off) the need to have a full path from the entity to the target when using this melee attack behavior.
set_persistent 布尔值 false Allows the actor to be set to persist upon targeting a player
speed_multiplier 浮点数 1 This multiplier modifies the attacking entity's speed when moving toward the target.
target_dist 浮点数 N/a Unused. No effect on "minecraft:behavior.melee_attack".
track_target 布尔值 true Allows the entity to track the attack target, even if the entity has no sensing.
x_max_rotation 浮点数 30 Maximum rotation (in degrees), on the X-axis, this entity can rotate while trying to look at the target.
y_max_head_rotation 浮点数 30 Maximum rotation (in degrees), on the Y-axis, this entity can rotate its head while trying to look at the target.
返回顶部

minecraft:behavior.dig

Allows this entity to dig into the ground before despawning.

名称 类型 默认值 描述
allow_dig_when_named 布尔值 false If true, this behavior can run when this entity is named. Otherwise not.
digs_in_daylight 布尔值 false Indicates that the actor should start digging when it sees daylight
duration 浮点数 0.0 Goal duration in seconds
idle_time 浮点数 The minimum idle time in seconds between the last detected disturbance to the start of digging.
on_start 触发器 Event(s) to run when the goal starts.
suspicion_is_disturbance 布尔值 false If true, finding new suspicious locations count as disturbances that may delay the start of this goal.
vibration_is_disturbance 布尔值 false If true, vibrations count as disturbances that may delay the start of this goal.
返回顶部

minecraft:behavior.door_interact

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

minecraft:behavior.dragonchargeplayer

Allows this entity to attack a player by charging at them. The player is chosen by the "minecraft:behavior.dragonscanning". Can only be used by the Ender Dragon.

名称 类型 默认值 描述
active_speed 浮点数 3 The speed this entity moves when this behavior has started or while it's active.
continue_charge_threshold_time 浮点数 0.5 If the dragon is outside the "target_zone" for longer than "continue_charge_threshold_time" seconds, the charge is canceled.
flight_speed 浮点数 0.6 The speed this entity moves while this behavior is not active.
target_zone 范围 [a, b] [10, 150] Minimum and maximum distance, from the target, this entity can use this behavior.
turn_speed 浮点数 0.7 The speed at which this entity turns while using this behavior.
返回顶部

minecraft:behavior.dragondeath

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

minecraft:behavior.dragonflaming

Allows this entity to use a flame-breath attack. Can only be used by the Ender Dragon.

名称 类型 默认值 描述
cooldown_time 浮点数 10 Time (in seconds), after roar, to breath flame.
flame_time 浮点数 0.5 Time (in seconds), after roar, to breath flame.
ground_flame_count 整数 4 Number of ground flame-breath attacks to use before flight-takeoff.
roar_time 浮点数 2 Time (in seconds) to roar, before breathing flame.
返回顶部

minecraft:behavior.dragonholdingpattern

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

minecraft:behavior.dragonlanding

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

minecraft:behavior.dragonscanning

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

minecraft:behavior.dragonstrafeplayer

Allows this entity to fly around looking for a player to shoot fireballs at. Can only be used by the Ender Dragon.

名称 类型 默认值 描述
active_speed 浮点数 0.6 The speed this entity moves when this behavior has started or while it's active.
fireball_range 浮点数 64 Maximum distance of this entity's fireball attack while strafing.
flight_speed 浮点数 0.6 The speed this entity moves while this behavior is not active.
switch_direction_probability 浮点数 0.125 Percent chance to to switch this entity's strafe direction between clockwise and counterclockwise. Switch direction chance occurs each time a new target is chosen (1.0 = 100%).
target_in_range_and_in_view_time 浮点数 0.25 Time (in seconds) the target must be in fireball range, and in view [ie, no solid terrain in-between the target and this entity], before a fireball can be shot.
target_zone 范围 [a, b] [10, 150] Minimum and maximum distance, from the target, this entity can use this behavior.
turn_speed 浮点数 0.7 The speed at which this entity turns while using this behavior.
view_angle 浮点数 10 The target must be within "view_angle" degrees of the dragon's current rotation before a fireball can be shot.
返回顶部

minecraft:behavior.dragontakeoff

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

minecraft:behavior.drink_milk

Allows the mob to drink milk based on specified environment conditions.

名称 类型 默认值 描述
cooldown_seconds 浮点数 5.00 Time (in seconds) that the goal is on cooldown before it can be used again.
filters Minecraft 过滤器 Conditions that need to be met for the behavior to start.
返回顶部

minecraft:behavior.drink_potion

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

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

minecraft:behavior.drop_item_for

Allows the entity to move toward a target, and drop an item near the target. This goal requires a "minecraft:navigation" to execute.

名称 类型 默认值 描述
cooldown 浮点数 0.2 Total time that the goal is on cooldown before it can be used again.
drop_item_chance 浮点数 1.0 The percent chance the entity will drop an item when using this goal.
entity_types Minecraft 过滤器 The list of conditions another entity must meet to be a valid target to drop an item for.
goal_radius 浮点数 0.50 Distance in blocks within the entity considers it has reached it's target position.
loot_table 字符串 The loot table that contains the possible loot the entity can drop with this goal.
max_head_look_at_height 浮点数 10.0 The maximum height the entities head will look at when dropping the item. The entity will always be looking at its target.
minimum_teleport_distance 浮点数 2.0 If the target position is farther away than this distance on any tick, the entity will teleport to the target position.
offering_distance 浮点数 1.0 The preferred distance the entity tries to be from the target it is dropping an item for.
on_drop_attempt 触发器 The event to trigger when the entity attempts to drop an item.
search_count 整数 0 The number of blocks each tick that the entity will check within its search range and height for a valid block to move to. A value of 0 will have the mob check every block within range in one tick.
search_height 整数 1 The Height in blocks the entity will search within to find a valid target position.
search_range 整数 0 The distance in blocks the entity will search within to find a valid target position.
seconds_before_pickup 浮点数 0.0 The numbers of seconds that will pass before the dropped entity can be picked up from the ground.
speed_multiplier 浮点数 1.00 Movement speed multiplier of the entity when using this Goal.
target_range 向量 [a, b, c] [1, 1, 1] The range in blocks within which the entity searches to find a target to drop an item for.
teleport_offset 向量 [a, b, c] [0, 1, 0] When the entity teleports, offset the teleport position by this many blocks in the X, Y, and Z coordinate.
time_of_day_range 范围 [a, b] [0, 1] The valid times of day that this goal can be used. For reference: noon is 0.0, sunset is 0.25, midnight is 0.5, and sunrise is 0.75, and back to noon for 1.0.
返回顶部

minecraft:behavior.eat_block

Allows the entity to consume a block, replace the eaten block with another block, and trigger an event as a result.

名称 类型 默认值 描述
eat_and_replace_block_pairs 列表 N/A A collection of pairs of blocks; the first ("eat_block")is the block the entity should eat, the second ("replace_block") is the block that should replace the eaten block.
on_eat 触发器 N/A The event to trigger when the block eating animation has completed.
success_chance Molang 0.02 A molang expression defining the success chance the entity has to consume a block.
time_until_eat 浮点数 1.8 The amount of time (in seconds) it takes for the block to be eaten upon a successful eat attempt.
返回顶部

minecraft:behavior.eat_carried_item

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

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

minecraft:behavior.eat_mob

Allows the entity to eat a specified Mob.

名称 类型 默认值 描述
eat_animation_time 浮点数 1.000000 Sets the time in seconds the eat animation should play for.
eat_mob_sound 字符串 Sets the sound that should play when eating a mob.
loot_table 字符串 The loot table for loot to be dropped when eating a mob.
pull_in_force 浮点数 1.000000 Sets the force which the mob-to-be-eaten is pulled towards the eating mob.
reach_mob_distance 浮点数 1.000000 Sets the desired distance to be reached before eating the mob.
run_speed 浮点数 1.000000 Sets the entity's speed when running toward the target.
返回顶部

minecraft:behavior.emerge

Allows this entity to emerge from the ground

名称 类型 默认值 描述
cooldown_time 整数 0.50 Time in seconds the mob has to wait before using the goal again
duration 浮点数 5.00 Goal duration in seconds
on_done 触发器 Trigger to be executed when the goal execution is about to end
返回顶部

minecraft:behavior.enderman_leave_block

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

minecraft:behavior.enderman_take_block

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

minecraft:behavior.equip_item

The entity puts on the desired equipment.
返回顶部

minecraft:behavior.explore_outskirts

Allows the entity to first travel to a random point on the outskirts of the village, and then explore random points within a small distance. This goal requires "minecraft:dweller" and "minecraft:navigation" to execute.

名称 类型 默认值 描述
dist_from_boundary 向量 [a, b, c] [5, 0, 5] The distance from the boundary the villager must be within in to explore the outskirts.
explore_dist 浮点数 5.00 Total distance in blocks the the entity will explore beyond the village bounds when choosing its travel point.
max_travel_time 浮点数 60.0 This is the maximum amount of time an entity will attempt to reach it's travel point on the outskirts of the village before the goal exits.
max_wait_time 浮点数 0.0 The wait time in seconds between choosing new explore points will be chosen on a random interval between this value and the minimum wait time. This value is also the total amount of time the entity will explore random points before the goal stops.
min_dist_from_target 浮点数 2.2 The entity must be within this distance for it to consider it has successfully reached its target.
min_perimeter 浮点数 1.0 The minimum perimeter of the village required to run this goal.
min_wait_time 浮点数 3.0 The wait time in seconds between choosing new explore points will be chosen on a random interval between this value and the maximum wait time.
next_xz 整数 5 A new explore point will randomly be chosen within this XZ distance of the current target position when navigation has finished and the wait timer has elapsed.
next_y 整数 3 A new explore point will randomly be chosen within this Y distance of the current target position when navigation has finished and the wait timer has elapsed.
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
timer_ratio 浮点数 2.0 Each new explore point will be chosen on a random interval between the minimum and the maximum wait time, divided by this value. This does not apply to the first explore point chosen when the goal runs.
返回顶部

minecraft:behavior.fertilize_farm_block

Allows the mob to search within an area for a growable crop block. If found, the mob will use any available fertilizer in their inventory on the crop. This goal will not execute if the mob does not have a fertilizer item in its inventory.

名称 类型 默认值 描述
goal_radius 浮点数 1.50 Distance in blocks within the mob considers it has reached it's target position.
max_fertilizer_usage 整数 1 The maximum number of times the mob will use fertilzer on the target block.
search_cooldown_max_seconds 浮点数 8.0 The maximum amount of time in seconds that the goal can take before searching again. The time is chosen between 0 and this number.
search_count 整数 9 The number of randomly selected blocks each tick that the mob will check within its search range and height for a valid block to move to. A value of 0 will have the mob check every block within range in one tick.
search_height 整数 1 The Height in blocks the mob will search within to find a valid target position.
search_range 整数 1 The distance in blocks the mob will search within to find a valid target position.
speed_multiplier 浮点数 0.50 Movement speed multiplier of the mob when using this Goal.
返回顶部

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.fire_at_target

Allows an entity to attack by firing a shot with a delay. Anchor and offset parameters of this component overrides the anchor and offset from projectile component.

名称 类型 默认值 描述
attack_cooldown 浮点数 0.500000 The cooldown time in seconds before this goal can be used again.
attack_range 范围 [a, b] [2.000000, 16.000000] Target needs to be within this range for the attack to happen.
filters Minecraft 过滤器 Conditions that need to be met for the behavior to start.
max_head_rotation_x 浮点数 30.000000 Maximum head rotation (in degrees), on the X-axis, that this entity can apply while trying to look at the target.
max_head_rotation_y 浮点数 30.000000 Maximum head rotation (in degrees), on the Y-axis, that this entity can apply while trying to look at the target.
owner_anchor 整数 2 Entity anchor for the projectile spawn location.
owner_offset 向量 [a, b, c] [0.000, 0.000, 0.000] Offset vector from the owner_anchor.
post_shoot_delay 浮点数 0.200000 Time in seconds between firing the projectile and ending the goal.
pre_shoot_delay 浮点数 0.750000 Time in seconds before firing the projectile.
projectile_def 字符串 Actor definition to use as projectile for the ranged attack. The actor must be a projectile. This field is required for the goal to be usable.
ranged_fov 浮点数 90.000000 Field of view (in degrees) when using sensing to detect a target for attack.
target_anchor 整数 2 Entity anchor for projectile target.
target_offset 向量 [a, b, c] [0.000, 0.000, 0.000] Offset vector from the target_anchor.
返回顶部

minecraft:behavior.flee_sun

Allows the mob to run away from direct sunlight and seek shade.

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

minecraft:behavior.float

允许生物在游泳时保持漂浮。Passengers will be kicked out the moment the mob's head goes underwater, which may not happen for tall mobs.

名称 类型 默认值 描述
sink_with_passengers 布尔值 false If true, the mob will keep sinking as long as it has passengers.
返回顶部

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对象 在商队中可以跟随的实体类型列表。
名称 类型 默认值 描述
cooldown 浮点数 0.0 The amount of time in seconds that the mob has to wait before selecting a target of the same type again
filters Minecraft 过滤器 使列表中的该标签有效的条件。
max_dist 浮点数 16 生物可以离开商队的最大距离。
must_see 布尔值 false 当值为"true"时，商队中的生物必须可见。
must_see_forget_duration 浮点数 3.0 决定该生物在失去一个目标并在目标不再可见时重新寻找一个新的目标之前所需的时间（单位为秒）。
reevaluate_description 布尔值 false If true, the mob will stop being targeted if it stops meeting any conditions.
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

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

名称 类型 默认值 描述
can_teleport 布尔值 true Defines if the mob will teleport to its owner when too far away.
ignore_vibration 布尔值 true Defines if the mob should disregard following its owner after detecting a recent vibration.
max_distance 浮点数 60.0 The maximum distance the mob can be from its owner to start following it. Applicable only when "can_teleport" is set to false.
post_teleport_distance 布尔值 "stop_distance" + 1 Defines how far (in blocks) the entity will be from its owner after teleporting. If not specified, it defaults to "stop_distance" + 1, allowing the entity to seamlessly resume navigation.
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_and_give_items_to_noteblock

The entity will attempt to toss the items from its inventory to a nearby recently played noteblock.

名称 类型 默认值 描述
listen_time 整数 0.000000 Sets the time an entity should continue delivering items to a noteblock after hearing it.
on_item_throw 触发器 Event(s) to run when this mob throws items.
reach_block_distance 浮点数 3.000000 Sets the desired distance to be reached before throwing the items towards the block.
run_speed 浮点数 1.000000 Sets the entity's speed when running toward the block.
throw_force 浮点数 0.200000 Sets the throw force.
throw_sound 字符串 Sound to play when this mob throws an item.
vertical_throw_mul 浮点数 1.500000 Sets the vertical throw multiplier that is applied on top of the throw force in the vertical direction.
返回顶部

minecraft:behavior.go_and_give_items_to_owner

The entity will attempt to toss the items from its inventory to its owner.

名称 类型 默认值 描述
on_item_throw 触发器 Event(s) to run when this mob throws items.
reach_mob_distance 浮点数 3.000000 Sets the desired distance to be reached before giving items to owner.
run_speed 浮点数 1.000000 Sets the entity's speed when running toward the owner.
throw_force 浮点数 0.200000 Sets the throw force.
throw_sound 字符串 item_thrown Sound to play when this mob throws an item.
vertical_throw_mul 浮点数 1.500000 Sets the vertical throw multiplier that is applied on top of the throw force in the vertical direction.
返回顶部

minecraft:behavior.go_home

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

名称 类型 默认值 描述
calculate_new_path_radius 浮点数 2.00 Distance in blocks that the mob is considered close enough to the end of the current path. A new path will then be calculated to continue toward home.
goal_radius 浮点数 0.50 生物认为它已经达到目标的方块内的距离。这是一个可以阻止 AI 为了到达一个特定的地点而来回跳动的冗余量。
interval 整数 120 一个随机值，决定何时随机移动到某处。这有概率为此值分之一的机会来选择该目标。
on_failed 触发器 Event(s) to run when this goal fails.
on_home 触发器 当生物到家时将运行的事件。
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子.
返回顶部

minecraft:behavior.guardian_attack

Allows this entity to use a laser beam attack. Can only be used by Guardians and Elder Guardians.

名称 类型 默认值 描述
elder_extra_magic_damage 整数 2 Amount of additional damage dealt from an elder guardian's magic attack.
hard_mode_extra_magic_damage 整数 2 In hard difficulty, amount of additional damage dealt from a guardian's magic attack.
magic_damage 整数 1 Amount of damage dealt from a guardian's magic attack. Magic attack damage is added to the guardian's base attack damage.
min_distance 浮点数 3 Guardian attack behavior stops if the target is closer than this distance (doesn't apply to elders).
sound_delay_time 浮点数 0.5 Time (in seconds) to wait after starting an attack before playing the guardian attack sound.
x_max_rotation 浮点数 90 Maximum rotation (in degrees), on the X-axis, this entity can rotate while trying to look at the target.
y_max_head_rotation 浮点数 90 Maximum rotation (in degrees), on the Y-axis, this entity can rotate its head while trying to look at the target.
返回顶部

minecraft:behavior.harvest_farm_block

Allows the entity to search within an area for farmland with air above it. If found, the entity will replace the air block by planting a seed item from its inventory on the farmland block. This goal requires "minecraft:inventory" and "minecraft:navigation" to execute. This goal will not execute if the entity does not have an item in its inventory.

名称 类型 默认值 描述
goal_radius 浮点数 1.50 Distance in blocks within the entity considers it has reached it's target position.
max_seconds_before_search 浮点数 1.0 The maximum amount of time in seconds that the goal can take before searching for the first harvest block. The time is chosen between 0 and this number.
search_cooldown_max_seconds 浮点数 8.0 The maximum amount of time in seconds that the goal can take before searching again, after failing to find a a harvest block already. The time is chosen between 0 and this number.
search_count 整数 0 The number of randomly selected blocks each tick that the entity will check within its search range and height for a valid block to move to. A value of 0 will have the mob check every block within range in one tick.
search_height 整数 1 The Height in blocks the entity will search within to find a valid target position.
search_range 整数 16 The distance in blocks the entity will search within to find a valid target position.
seconds_until_new_task 浮点数 0.5 The amount of time in seconds that the goal will cooldown after a successful reap/sow, before it can start again.
speed_multiplier 浮点数 0.50 Movement speed multiplier of the entity when using this Goal.
返回顶部

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对象 这生物受到伤害时可以锁定的实体类型列表。
名称 类型 默认值 描述
cooldown 浮点数 0.0 The amount of time in seconds that the mob has to wait before selecting a target of the same type again
filters Minecraft 过滤器 使列表中的该条目有效的条件。
max_dist 浮点数 16 生物锁定实体时可以离开的最大距离。
must_see 布尔值 false 当值为"true"时，实体锁定的目标必须是可见的。
must_see_forget_duration 浮点数 3.0 决定该生物在失去一个目标并在目标不再可见时重新寻找一个新的目标之前所需的时间（单位为秒）。
reevaluate_description 布尔值 false If true, the mob will stop being targeted if it stops meeting any conditions.
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.investigate_suspicious_location

允许此实体根据 minecraft:suspect_tracking 中收集的数据向“可疑”位置移动

名称 类型 默认值 描述
goal_radius 浮点数 1.5 Distance in blocks within the entity considers it has reached it's target position.
speed_multiplier 浮点数 1 Movement speed multiplier
返回顶部

minecraft:behavior.jump_around_target

Allows an entity to jump around a target.

名称 类型 默认值 描述
check_collision 布尔值 false Enables collision checks when calculating the jump. Setting check_collision to true may affect performance and should be used with care.
entity_bounding_box_scale 浮点数 0.700000 Scaling temporarily applied to the entity's AABB bounds when jumping. A smaller bounding box reduces the risk of collisions during the jump. When check_collision is true it also increases the chance of being able to jump when close to obstacles.
filters Minecraft 过滤器 Conditions that need to be met for the behavior to start.
jump_angles 数组 [ 40.0, 55.0, 60.0, 75.0, 80.0 ] The jump angles in float degrees that are allowed when performing the jump. The order in which the angles are chosen is randomized.
jump_cooldown_duration 浮点数 0.500000 The time in seconds to spend in cooldown before this goal can be used again.
jump_cooldown_when_hurt_duration 浮点数 0.100000 The time in seconds to spend in cooldown after being hurt before this goal can be used again.
landing_distance_from_target 范围 [a, b] [4.000000, 8.000000] The range deciding how close to and how far away from the target the landing position can be when jumping.
landing_position_spread_degrees 整数 90 This angle (in degrees) is used for controlling the spread when picking a landing position behind the target. A zero spread angle means the landing position will be straight behind the target with no variance. A 90 degree spread angle means the landing position can be up to 45 degrees to the left and to the right of the position straight behind the target's view direction.
last_hurt_duration 浮点数 2.000000 If the entity was hurt within these last seconds, the jump_cooldown_when_hurt_duration will be used instead of jump_cooldown_duration.
line_of_sight_obstruction_height_ignore 整数 4 If the entity's line of sight towards its target is obstructed by an obstacle with a height below this number, the obstacle will be ignored, and the goal will try to find a valid landing position.
max_jump_velocity 浮点数 1.400000 Maximum velocity a jump can be performed at.
prepare_jump_duration 浮点数 0.500000 The time in seconds to spend preparing for the jump.
required_vertical_space 整数 4 The number of blocks above the entity's head that has to be air for this goal to be usable.
snap_to_surface_block_range 整数 10 The number of blocks above and below from the jump target position that will be checked to find a surface to land on.
valid_distance_to_target 范围 [a, b] [4.000000, 20.000000] Target needs to be within this range for the jump to happen.
返回顶部

minecraft:behavior.jump_to_block

Allows an entity to jump to another random block.

名称 类型 默认值 描述
cooldown_range 范围 [a, b] [10, 20] Minimum and maximum cooldown time-range (positive, in seconds) between each attempted jump.
forbidden_blocks 数组 Blocks that the mob can't jump to.
max_velocity 浮点数 1.500000 The maximum velocity with which the mob can jump.
minimum_distance 整数 2 The minimum distance (in blocks) from the mob to a block, in order to consider jumping to it.
minimum_path_length 整数 5 The minimum length (in blocks) of the mobs path to a block, in order to consider jumping to it.
preferred_blocks 数组 Blocks that the mob prefers jumping to.
preferred_blocks_chance 浮点数 1.000000 Chance (between 0.0 and 1.0) that the mob will jump to a preferred block, if in range. Only matters if preferred blocks are defined.
scale_factor 浮点数 0.700000 The scalefactor of the bounding box of the mob while it is jumping.
search_height 整数 10 The height (in blocks, in range [2, 15]) of the search box, centered around the mob.
search_width 整数 8 The width (in blocks, in range [2, 15]) of the search box, centered around the mob.
返回顶部

minecraft:behavior.knockback_roar

Allows the mob to perform a damaging knockback that affects all nearby entities.

名称 类型 默认值 描述
attack_time 浮点数 0.5 击退后发生的延迟（以秒为单位）。
cooldown_time 浮点数 0.10 生物在再次使用击退前必须等待的时间（以秒为单位）。
damage_filters Minecraft 过滤器 The list of conditions another entity must meet to be a valid target to apply damage to.
duration 浮点数 1.0 吼声的持续时间（以秒为单位）。
knockback_damage 整数 6 击退吼叫所造成的伤害。
knockback_filters Minecraft 过滤器 The list of conditions another entity must meet to be a valid target to apply knockback to.
knockback_height_cap 浮点数 0.40 The maximum height for vertical knockback.
knockback_horizontal_strength 整数 4 水平击退的强度。
knockback_range 整数 4 击退的方块距离。
knockback_vertical_strength 整数 4 垂直击退的强度。
on_roar_end 触发器 Event that is triggered when the roar ends.
返回顶部

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 ] Blocks that the mob can lay its eggs on top of.
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.melee_attack

Allows an entity to deal damage through a melee attack.

名称 类型 默认值 描述
attack_once 布尔值 false Allows the entity to use this attack behavior, only once EVER.
attack_types 字符串 N/A Defines the entity types this entity will attack.
can_spread_on_fire 布尔值 false If the entity is on fire, this allows the entity's target to catch on fire after being hit.
cooldown_time 浮点数 1 Cooldown time (in seconds) between attacks.
inner_boundary_time_increase 浮点数 0.25 Time (in seconds) to add to attack path recalculation when the target is beyond the "path_inner_boundary".
max_dist 浮点数 N/A Unused. No effect on "minecraft:behavior.melee_attack".
max_path_time 浮点数 0.55 Maximum base time (in seconds) to recalculate new attack path to target (before increases applied).
melee_fov 浮点数 90 Field of view (in degrees) when using the sensing component to detect an attack target.
min_path_time 浮点数 0.2 Minimum base time (in seconds) to recalculate new attack path to target (before increases applied).
on_attack 触发器 N/A Defines the event to trigger when this entity successfully attacks.
outer_boundary_time_increase 浮点数 0.5 Time (in seconds) to add to attack path recalculation when the target is beyond the "path_outer_boundary".
path_fail_time_increase 浮点数 0.75 Time (in seconds) to add to attack path recalculation when this entity cannot move along the current path.
path_inner_boundary 浮点数 16 Distance at which to increase attack path recalculation by "inner_boundary_tick_increase".
path_outer_boundary 浮点数 32 Distance at which to increase attack path recalculation by "outer_boundary_tick_increase".
random_stop_interval 整数 0 This entity will have a 1 in N chance to stop it's current attack, where N = "random_stop_interval".
reach_multiplier 浮点数 2 Used with the base size of the entity to determine minimum target-distance before trying to deal attack damage.
require_complete_path 布尔值 false Toggles (on/off) the need to have a full path from the entity to the target when using this melee attack behavior.
set_persistent 布尔值 false Allows the actor to be set to persist upon targeting a player
speed_multiplier 浮点数 1 This multiplier modifies the attacking entity's speed when moving toward the target.
target_dist 浮点数 N/a Unused. No effect on "minecraft:behavior.melee_attack".
track_target 布尔值 false Allows the entity to track the attack target, even if the entity has no sensing.
x_max_rotation 浮点数 30 Maximum rotation (in degrees), on the X-axis, this entity can rotate while trying to look at the target.
y_max_head_rotation 浮点数 30 Maximum rotation (in degrees), on the Y-axis, this entity can rotate its head while trying to look at the target.
返回顶部

minecraft:behavior.melee_box_attack

Allows an entity to deal damage through a melee attack with reach calculations based on bounding boxes.

名称 类型 默认值 描述
attack_once 布尔值 false Allows the entity to use this attack behavior, only once EVER.
attack_types 字符串 N/A Defines the entity types this entity will attack.
can_spread_on_fire 布尔值 false If the entity is on fire, this allows the entity's target to catch on fire after being hit.
cooldown_time 浮点数 1 Cooldown time (in seconds) between attacks.
horizontal_reach 浮点数 0.8 The attack reach of the mob will be a box with the size of the mobs bounds increased by this value in all horizontal directions.
inner_boundary_time_increase 浮点数 0.25 Time (in seconds) to add to attack path recalculation when the target is beyond the "path_inner_boundary".
max_dist 浮点数 N/A Unused. No effect on "minecraft:behavior.melee_attack".
max_path_time 浮点数 0.55 Maximum base time (in seconds) to recalculate new attack path to target (before increases applied).
melee_fov 浮点数 90 Field of view (in degrees) when using the sensing component to detect an attack target.
min_path_time 浮点数 0.2 Minimum base time (in seconds) to recalculate new attack path to target (before increases applied).
on_attack 触发器 N/A Defines the event to trigger when this entity successfully attacks.
outer_boundary_time_increase 浮点数 0.5 Time (in seconds) to add to attack path recalculation when the target is beyond the "path_outer_boundary".
path_fail_time_increase 浮点数 0.75 Time (in seconds) to add to attack path recalculation when this entity cannot move along the current path.
path_inner_boundary 浮点数 16 Distance at which to increase attack path recalculation by "inner_boundary_tick_increase".
path_outer_boundary 浮点数 32 Distance at which to increase attack path recalculation by "outer_boundary_tick_increase".
random_stop_interval 整数 0 This entity will have a 1 in N chance to stop it's current attack, where N = "random_stop_interval".
require_complete_path 布尔值 false Toggles (on/off) the need to have a full path from the entity to the target when using this melee attack behavior.
set_persistent 布尔值 false Allows the actor to be set to persist upon targeting a player
speed_multiplier 浮点数 1 This multiplier modifies the attacking entity's speed when moving toward the target.
target_dist 浮点数 N/a Unused. No effect on "minecraft:behavior.melee_attack".
track_target 布尔值 false Allows the entity to track the attack target, even if the entity has no sensing.
x_max_rotation 浮点数 30 Maximum rotation (in degrees), on the X-axis, this entity can rotate while trying to look at the target.
y_max_head_rotation 浮点数 30 Maximum rotation (in degrees), on the Y-axis, this entity can rotate its head while trying to look at the target.
返回顶部

minecraft:behavior.mingle

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

名称 类型 默认值 描述
cooldown_time 浮点数 0.0 生物在再次使用该目标前必须等待的时间（单位为秒）。
duration 浮点数 1.0 实体将与另一实体聊天的时间（单位为秒）
mingle_distance 浮点数 2.0f 该实体与交谈对象之间的距离。如果两个实体种类不同，则两个实体上的该值必须相同。
mingle_partner_type 列表 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_around_target

Allows an entity to move around a target. If the entity is too close (i.e. closer than destination range min and height difference limit) it will try to move away from its target. If the entity is too far away from its target it will try to move closer to a random position within the destination range. A randomized amount of those positions will be behind the target, and the spread can be tweaked with 'destination_pos_search_spread_degrees'.

名称 类型 默认值 描述
destination_pos_search_spread_degrees 浮点数 90.000000 This angle (in degrees) is used for controlling the spread when picking a destination position behind the target. A zero spread angle means the destination position will be straight behind the target with no variance. A 90 degree spread angle means the destination position can be up to 45 degrees to the left and to the right of the position straight behind the target's view direction..
destination_position_range 范围 [a, b] [4.000000, 8.000000] The range of distances from the target entity within which the goal should look for a position to move the owner entity to.
filters Minecraft 过滤器 Conditions that need to be met for the behavior to start.
height_difference_limit 浮点数 10.000000 Distance in height (in blocks) between the owner entity and the target has to be less than this value when owner checks if it is too close and should move away from the target. This value needs to be bigger than zero for the move away logic to trigger.
horizontal_search_distance 整数 5 Horizontal search distance (in blocks) when searching for a position to move away from target.
movement_speed 浮点数 0.600000 The speed with which the entity should move to its target position.
vertical_search_distance 整数 5 Vertical search distance (in blocks) when searching for a position to move away from target.
返回顶部

minecraft:behavior.move_indoors

Allows this entity to move indoors.

名称 类型 默认值 描述
speed_multiplier 浮点数 0.800000 The movement speed modifier to apply to the entity while it is moving indoors.
timeout_cooldown 浮点数 8.000000 The cooldown time in seconds before the goal can be reused after pathfinding fails
返回顶部

minecraft:behavior.move_outdoors

Allows this entity to move outdoors.

名称 类型 默认值 描述
goal_radius 浮点数 0.500000 The radius away from the target block to count as reaching the goal.
search_count 整数 0.000000 The amount of times to try finding a random outdoors position before failing.
search_height 整数 0.000000 The y range to search for an outdoors position for.
search_range 整数 0.000000 The x and z range to search for an outdoors position for.
speed_multiplier 浮点数 0.500000 The movement speed modifier to apply to the entity while it is moving outdoors.
timeout_cooldown 浮点数 8.000000 The cooldown time in seconds before the goal can be reused after pathfinding fails
返回顶部

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 列表 要移动到的方块类型
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_dwelling_restriction

Allows entities with the "minecraft:dweller" component to move toward their Village area that the entity should be restricted to.

名称 类型 默认值 描述
speed_multiplier 浮点数 1.0 This multiplier modifies the entity's speed when moving towards its restriction.
返回顶部

minecraft:behavior.move_towards_home_restriction


Allows entities with a "minecraft:home" component to move towards their home position.
If "restriction_radius" is set, entities will be able to run this behavior only if outside of it.

名称 类型 默认值 描述
speed_multiplier 浮点数 1.0 This multiplier modifies the entity's speed when moving towards its restriction.
返回顶部

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 时使用。
reevaluate_description 布尔值 false If true, the mob will stop being targeted if it stops meeting any conditions.
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.70 与目标的装甲穿戴率相乘，在检测隐形目标时修改"max_dist"。
target_search_height 浮点数 -1.00 最大垂直目标搜索距离，如果它大于目标类型的"max_dist"。负值默认为"entity_types"最大的"max_dist"。
target_sneak_visibility_multiplier 浮点数 0.80 当实体试图检测潜行目标时，与目标类型的"max_dist "相乘。
within_radius 浮点数 0.0 该实体在跟随目标时可以与目标的最大距离，否则目标会失效。该值只在实体没有声明"minecraft:follow_range"时使用。
返回顶部

minecraft:behavior.nearest_prioritized_attackable_target

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

名称 类型 默认值 描述
attack_interval 整数 0 选择目标前等待的时间（单位为秒）
cooldown 浮点数 0.0 The amount of time in seconds that the mob has to wait before selecting a target of the same type again
entity_types JSON对象 此实体认为有效目标的实体类型列表
名称 类型 默认值 描述
cooldown 浮点数 0.0 The amount of time in seconds that the mob has to wait before selecting a target of the same type again
filters Minecraft 过滤器 使列表中的该条目有效的条件。
max_dist 浮点数 16 生物锁定实体时可以离开的最大距离。
must_see 布尔值 false 当值为"true"时，实体锁定的目标必须是可见的。
must_see_forget_duration 浮点数 3.0 决定该生物在失去一个目标并在目标不再可见时重新寻找一个新的目标之前所需的时间（单位为秒）。
reevaluate_description 布尔值 false If true, the mob will stop being targeted if it stops meeting any conditions.
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.ocelotattack

Allows an entity to attack by sneaking and pouncing.

名称 类型 默认值 描述
cooldown_time 浮点数 1 Time (in seconds) between attacks.
max_distance 浮点数 15 Max distance from the target, this entity will use this attack behavior.
max_sneak_range 浮点数 15 Max distance from the target, this entity starts sneaking.
max_sprint_range 浮点数 4 Max distance from the target, this entity starts sprinting (sprinting takes priority over sneaking).
reach_multiplier 浮点数 2 Used with the base size of the entity to determine minimum target-distance before trying to deal attack damage.
sneak_speed_multiplier 浮点数 0.6 Modifies the attacking entity's movement speed while sneaking.
sprint_speed_multiplier 浮点数 1.33 Modifies the attacking entity's movement speed while sprinting.
walk_speed_multiplier 浮点数 0.8 Modifies the attacking entity's movement speed when not sneaking or sprinting, but still within attack range.
x_max_rotation 浮点数 30 Maximum rotation (in degrees), on the X-axis, this entity can rotate while trying to look at the target.
y_max_head_rotation 浮点数 30 Maximum rotation (in degrees), on the Y-axis, this entity can rotate its head while trying to look at the target.
返回顶部

minecraft:behavior.offer_flower

Allows the mob to offer a flower to another mob with the minecraft:take_flower behavior.

名称 类型 默认值 描述
chance_to_start 浮点数 0.00 Percent chance that the mob will start this goal from 0.0 to 1.0 (where 1.0 = 100%).
filters Minecraft 过滤器 Conditions that need to be met for the behavior to start.
max_head_rotation_y 浮点数 30 Maximum rotation (in degrees), on the Y-axis, this entity can rotate its head while trying to look at the target.
max_offer_flower_duration 浮点数 20.00 The max amount of time (in seconds) that the mob will offer the flower for before exiting the Goal.
max_rotation_x 浮点数 30 Maximum rotation (in degrees), on the X-axis, this entity can rotate while trying to look at the target.
search_area 向量 [a, b, c] [6, 2, 6] The dimensions of the AABB used to search for a potential mob to offer flower to.
返回顶部

minecraft:behavior.open_door

Allows the mob to open doors. Requires the mob to be able to path through doors, otherwise the mob won't even want to try opening them.

名称 类型 默认值 描述
close_door_after 布尔值 true If true, the mob will close the door after opening it and going through it
返回顶部

minecraft:behavior.owner_hurt_by_target

Allows the mob to target another mob that hurts their owner.

名称 类型 默认值 描述
entity_types JSON Object List of entity types that this mob can target if they hurt their owner
名称 类型 默认值 描述
cooldown 浮点数 0.0 The amount of time in seconds that the mob has to wait before selecting a target of the same type again
filters Minecraft 过滤器 Conditions that make this entry in the list valid
max_dist 浮点数 16 Maximum distance this mob can be away to be a valid choice
must_see 布尔值 false If true, the mob has to be visible to be a valid choice
must_see_forget_duration 浮点数 3.0 Determines the amount of time in seconds that this mob will look for a target before forgetting about it and looking for a new one when the target isn't visible any more
reevaluate_description 布尔值 false If true, the mob will stop being targeted if it stops meeting any conditions.
sprint_speed_multiplier 浮点数 1.0 Multiplier for the running speed. A value of 1.0 means the speed is unchanged
walk_speed_multiplier 浮点数 1.0 Multiplier for the walking speed. A value of 1.0 means the speed is unchanged
返回顶部

minecraft:behavior.owner_hurt_target

Allows the mob to target a mob that is hurt by their owner.

名称 类型 默认值 描述
entity_types JSON Object List of entity types that this entity can target if the potential target is hurt by this mob's owner
名称 类型 默认值 描述
cooldown 浮点数 0.0 The amount of time in seconds that the mob has to wait before selecting a target of the same type again
filters Minecraft 过滤器 Conditions that make this entry in the list valid
max_dist 浮点数 16 Maximum distance this mob can be away to be a valid choice
must_see 布尔值 false If true, the mob has to be visible to be a valid choice
must_see_forget_duration 浮点数 3.0 Determines the amount of time in seconds that this mob will look for a target before forgetting about it and looking for a new one when the target isn't visible any more
reevaluate_description 布尔值 false If true, the mob will stop being targeted if it stops meeting any conditions.
sprint_speed_multiplier 浮点数 1.0 Multiplier for the running speed. A value of 1.0 means the speed is unchanged
walk_speed_multiplier 浮点数 1.0 Multiplier for the walking speed. A value of 1.0 means the speed is unchanged
返回顶部

minecraft:behavior.panic

Allows the mob to enter the panic state, which makes it run around and away from the damage source that made it enter this state.

名称 类型 默认值 描述
damage_sources 列表 [campfire, fire, fire_tick, freezing, lava, lightning, magma, soul_campfire, temperature, entity_attack, entity_explosion, fireworks, magic, projectile, ram_attack, sonic_boom, wither, mace_smash] The list of Entity Damage Sources that will cause this mob to panic
force 布尔值 false If true, this mob will not stop panicking until it can't move anymore or the goal is removed from it
ignore_mob_damage 布尔值 false If true, the mob will not panic in response to damage from other mobs. This overrides the damage types in "damage_sources"
prefer_water 布尔值 false If true, the mob will prefer water over land
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.pet_sleep_with_owner

Allows the pet mob to move onto a bed with its owner while sleeping.

名称 类型 默认值 描述
goal_radius 浮点数 0.5 Distance in blocks within the mob considers it has reached the goal. This is the "wiggle room" to stop the AI from bouncing back and forth trying to reach a specific spot
search_height 整数 1 Height in blocks from the owner the pet can be to sleep with owner.
search_range 整数 0 The distance in blocks from the owner the pet can be to sleep with owner.
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.pickup_items

Allows the mob to pick up items on the ground.

名称 类型 默认值 描述
can_pickup_any_item 布尔值 false If true, the mob can pickup any item
can_pickup_to_hand_or_equipment 布尔值 true If true, the mob can pickup items to its hand or armor slots
excluded_items 列表 List of items this mob will not pick up
goal_radius 浮点数 0.5 Distance in blocks within the mob considers it has reached the goal. This is the "wiggle room" to stop the AI from bouncing back and forth trying to reach a specific spot
max_dist 浮点数 0.0 Maximum distance this mob will look for items to pick up
pickup_based_on_chance 布尔值 false If true, depending on the difficulty, there is a random chance that the mob may not be able to pickup items
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
track_target 布尔值 false If true, this mob will chase after the target as long as it's a valid target
返回顶部

minecraft:behavior.play

Allows the mob to play with other mobs by chasing each other and moving around randomly.

名称 类型 默认值 描述
chance_to_start 浮点数 0.00 Percent chance that the mob will start this goal, from 0 to 1.
follow_distance 整数 2 The distance (in blocks) that the mob tries to be in range of the friend it's following.
friend_search_area 向量 [a, b, c] [6, 3, 6] The dimensions of the AABB used to search for a potential friend to play with.
friend_types 数组 The entity type(s) to consider when searching for a potential friend to play with.
max_play_duration_seconds 浮点数 50.00 The max amount of seconds that the mob will play for before exiting the Goal.
random_pos_search_height 整数 3 The height (in blocks) that the mob will search within to find a random position position to move to. Must be at least 1.
random_pos_search_range 整数 16 The distance (in blocks) on ground that the mob will search within to find a random position to move to. Must be at least 1.
speed_multiplier 浮点数 1.00 此生物使用该AI意向时的移动速度乘子.
返回顶部

minecraft:behavior.play_dead

Allows this entity to pretend to be dead to avoid being targeted by attackers.

名称 类型 默认值 描述
apply_regeneration 布尔值 true Whether the mob will receive the regeneration effect while playing dead.
damage_sources 数组 all The list of Entity Damage Sources that will cause this mob to play dead.
duration 浮点数 1.000000 The amount of time the mob will remain playing dead (in seconds).
filters Minecraft 过滤器 The list of other triggers that are required for the mob to activate play dead
force_below_health 整数 0 The amount of health at which damage will cause the mob to play dead.
random_damage_range 范围 [a, b] [0, 0] The range of damage that may cause the goal to start depending on randomness. Damage taken below the min will never cause the goal to start. Damage taken above the max will always cause the goal to start.
random_start_chance 浮点数 1.000000 The likelihood of this goal starting upon taking damage.
返回顶部

minecraft:behavior.player_ride_tamed

Allows the mob to be ridden by the player after being tamed.
返回顶部

minecraft:behavior.raid_garden

Allows the mob to eat/raid crops out of farms until they are full.

名称 类型 默认值 描述
blocks 列表 Blocks that the mob is looking for to eat/raid
eat_delay 整数 2 Time in seconds between each time it eats/raids
full_delay 整数 100 Amount of time in seconds before this mob wants to eat/raid again after eating its maximum
goal_radius 浮点数 0.5 Distance in blocks within the mob considers it has reached the goal. This is the "wiggle room" to stop the AI from bouncing back and forth trying to reach a specific spot
initial_eat_delay 整数 0 Time in seconds before starting to eat/raid once it arrives at it
max_to_eat 整数 6 Maximum number of crops this entity wants to eat/raid. If set to zero or less then it doesn't have a maximum
search_range 整数 0 Distance in blocks the mob will look for crops to eat
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.ram_attack

Allows this entity to damage a target by using a running attack.

名称 类型 默认值 描述
baby_knockback_modifier 浮点数 0.333333 The modifier to knockback that babies have.
cooldown_range 范围 [a, b] [10, 20] Minimum and maximum cooldown time-range (positive, in seconds) between each attempted ram attack.
knockback_force 浮点数 5.000000 The force of the knockback of the ram attack.
knockback_height 浮点数 0.100000 The height of the knockback of the ram attack.
min_ram_distance 浮点数 0.000000 The minimum distance at which the mob can start a ram attack.
on_start 触发器 The event to trigger when attacking
pre_ram_sound 字符串 The sound to play when an entity is about to perform a ram attack.
ram_distance 浮点数 0.000000 The distance at which the mob start to run with ram speed.
ram_impact_sound 字符串 The sound to play when an entity is impacting on a ram attack.
ram_speed 浮点数 2.000000 Sets the entity's speed when charging toward the target.
run_speed 浮点数 1.000000 Sets the entity's speed when running toward the target.
返回顶部

minecraft:behavior.random_breach

Allows the mob to randomly break surface of the water.

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

minecraft:behavior.random_fly

Allows a mob to randomly fly around.

名称 类型 默认值 描述
can_land_on_trees 布尔值 true If true, the mob can stop flying and land on a tree instead of the ground
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
xz_dist 整数 10 生物在地面上寻找新位置移动的距离（以方块为单位）。必须至少为 1
y_dist 整数 7 生物将向上或向下查找要移动到的新位置的距离（以方块为单位）。必须至少为 1
返回顶部

minecraft:behavior.random_hover

Allows the mob to hover around randomly, close to the surface

名称 类型 默认值 描述
hover_height 范围 [a, b] The height above the surface which the mob will try to maintain
interval 整数 120 一个随机值，用于确定何时随机移动到某个位置。这有概率为此值分之一的机会选择此目标
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
xz_dist 整数 10 生物在地面上寻找新位置移动的距离（以方块为单位）。必须至少为 1
y_dist 整数 7 生物将向上或向下查找要移动到的新位置的距离（以方块为单位）。必须至少为 1
y_offset 浮点数 0.0 Height in blocks to add to the selected target position
返回顶部

minecraft:behavior.random_look_around

Allows the mob to randomly look around.

名称 类型 默认值 描述
look_time 范围 [a, b] [2, 4] The range of time in seconds the mob will stay looking in a random direction before looking elsewhere
max_angle_of_view_horizontal 整数 30 The rightmost angle a mob can look at on the horizontal plane with respect to its initial facing direction.
min_angle_of_view_horizontal 整数 -30 The leftmost angle a mob can look at on the horizontal plane with respect to its initial facing direction.
返回顶部

minecraft:behavior.random_look_around_and_sit

Allows the mob to randomly sit and look around for a duration. Note: Must have a sitting animation set up to use this.

名称 类型 默认值 描述
continue_if_leashed 布尔值 false If the goal should continue to be used as long as the mob is leashed.
continue_sitting_on_reload 布尔值 false The mob will stay sitting on reload.
max_angle_of_view_horizontal 浮点数 30.0 The rightmost angle a mob can look at on the horizontal plane with respect to its initial facing direction.
max_look_count 整数 2 The max amount of unique looks a mob will have while looking around.
max_look_time 整数 40 The max amount of time (in ticks) a mob will stay looking at a direction while looking around.
min_angle_of_view_horizontal 浮点数 -30.0 The leftmost angle a mob can look at on the horizontal plane with respect to its initial facing direction.
min_look_count 整数 1 The min amount of unique looks a mob will have while looking around.
min_look_time 整数 20 The min amount of time (in ticks) a mob will stay looking at a direction while looking around.
probability 浮点数 0.02 The probability of randomly looking around/sitting.
random_look_around_cooldown 整数 0 The cooldown in seconds before the goal can be used again.
返回顶部

minecraft:behavior.random_search_and_dig

Allows this entity to locate a random target block that it can path find to. Once found, the entity will move towards it and dig up an item. [Default target block types: Dirt, Grass, Podzol, DirtWithRoots, MossBlock, Mud, MuddyMangroveRoots].

名称 类型 默认值 描述
cooldown_range 范围 [a, b] [0.000000, 0.000000] Goal cooldown range in seconds.
digging_duration_range 范围 [a, b] [0.000000, 0.000000] Digging duration in seconds.
find_valid_position_retries 浮点数 0.000000 Amount of retries to find a valid target position within search range.
goal_radius 浮点数 1.500000 Distance in blocks within the entity to considers it has reached it's target position.
item_table 字符串 File path relative to the resource pack root for items to spawn list (loot table format).
on_digging_start 触发器 Event to run when the goal ends searching has begins digging.
on_fail_during_digging 触发器 Event to run when the goal failed while in digging state.
on_fail_during_searching 触发器 Event to run when the goal failed while in searching state.
on_item_found 触发器 Event to run when the goal find a item.
on_searching_start 触发器 Event to run when the goal starts searching.
on_success 触发器 Event to run when searching and digging has ended.
search_range_xz 浮点数 0.000000 Width and length of the volume around the entity used to find a valid target position
search_range_y 浮点数 0.000000 Height of the volume around the entity used to find a valid target position
spawn_item_after_seconds 浮点数 0.000000 Digging duration before spawning item in seconds.
spawn_item_pos_offset 浮点数 0.000000 Distance to offset the item's spawn location in the direction the mob is facing.
speed_multiplier 浮点数 1.000000 Searching movement speed multiplier.
target_blocks 列表 List of target block types the goal will look to dig on. Overrides the default list.
target_dig_position_offset 浮点数 2.250000 Dig target position offset from the feet position of the mob in their facing direction.
返回顶部

minecraft:behavior.random_sitting

Allows the mob to randomly sit for a duration.

这是生物开始这个目标的几率，从 0 到 1
名称 类型 默认值 描述
cooldown_time 浮点数 0.0 Time in seconds the mob has to wait before using the goal again
min_sit_time 浮点数 10 The minimum amount of time in seconds before the mob can stand back up
start_chance 浮点数 0.1 This is the chance that the mob will start this goal, from 0 to 1
stop_chance 浮点数 0.3 这是生物停止此目标的几率，从 0 到 1
返回顶部

minecraft:behavior.random_stroll

Allows a mob to randomly stroll around.

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

minecraft:behavior.random_swim

Allows an entity to randomly move through water

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

minecraft:behavior.ranged_attack

Allows an entity to attack by using ranged shots. "charge_shoot_trigger" must be greater than 0 to enable charged up burst-shot attacks. Requires minecraft:shooter to define projectile behaviour.

名称 类型 默认值 描述
attack_interval 浮点数 0 Alternative to "attack_interval_min" & "attack_interval_max". Consistent reload-time (in seconds), when not using a charged shot. Does not scale with target-distance.
attack_interval_max 浮点数 0 Maximum bound for reload-time range (in seconds), when not using a charged shot. Reload-time range scales with target-distance.
attack_interval_min 浮点数 0 Minimum bound for reload-time range (in seconds), when not using a charged shot. Reload-time range scales with target-distance.
attack_radius 浮点数 0 Minimum distance to target before this entity will attempt to shoot.
attack_radius_min 浮点数 0 Minimum distance the target can be for this mob to fire. If the target is closer, this mob will move first before firing
burst_interval 浮点数 0 Time (in seconds) between each individual shot when firing a burst of shots from a charged up attack.
burst_shots 整数 1 Number of shots fired every time the attacking entity uses a charged up attack.
charge_charged_trigger 浮点数 0 Time (in seconds, then add "charge_shoot_trigger"), before a charged up attack is done charging. Charge-time decays while target is not in sight.
charge_shoot_trigger 浮点数 0 Amount of time (in seconds, then doubled) a charged shot must be charging before reloading burst shots. Charge-time decays while target is not in sight.
ranged_fov 浮点数 90 Field of view (in degrees) when using sensing to detect a target for attack.
set_persistent 布尔值 false Allows the actor to be set to persist upon targeting a player
speed_multiplier 浮点数 1 During attack behavior, this multiplier modifies the entity's speed when moving toward the target.
swing 布尔值 false If a swing animation (using variable.attack_time) exists, this causes the actor to swing their arm(s) upon firing the ranged attack.
target_in_sight_time 浮点数 1 Minimum amount of time (in seconds) the attacking entity needs to see the target before moving toward it.
x_max_rotation 浮点数 30 Maximum rotation (in degrees), on the X-axis, this entity can rotate while trying to look at the target.
y_max_head_rotation 浮点数 30 Maximum rotation (in degrees), on the Y-axis, this entity can rotate its head while trying to look at the target.
返回顶部

minecraft:behavior.receive_love

Allows the villager to stop so another villager can breed with it. Can only be used by a Villager.
返回顶部

minecraft:behavior.restrict_open_door

Allows the mob to stay indoors during night time.
返回顶部

minecraft:behavior.restrict_sun

Allows the mob to automatically start avoiding the sun when its a clear day out.
返回顶部

minecraft:behavior.rise_to_liquid_level

Allows the mob to stay at a certain level when in liquid.

名称 类型 默认值 描述
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.roar

Allows this entity to roar at another entity based on data in minecraft:anger_level. Once the anger threshold specified in minecraft:anger_level has been reached, this entity will roar for the specified amount of time, look at the other entity, apply anger boost towards it, and finally target it.

名称 类型 默认值 描述
duration 浮点数 0.0 The amount of time to roar for.
返回顶部

minecraft:behavior.roll

This allows the mob to roll forward.

名称 类型 默认值 描述
probability 浮点数 [1.0] The probability that the mob will use the goal.
返回顶部

minecraft:behavior.run_around_like_crazy

Allows the mob to run around aimlessly.

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

minecraft:behavior.scared

Allows the a mob to become scared when the weather outside is thundering

名称 类型 默认值 描述
sound_interval 整数 0 The interval in which a sound will play when active in a 1/delay chance to kick off
返回顶部

minecraft:behavior.send_event

Allows the mob to send an event to another mob.

名称 类型 默认值 描述
cast_duration 浮点数 Total delay of the steps Time in seconds for the entire event sending process
look_at_target 布尔值 true If true, the mob will face the entity it sends an event to
sequence 列表 List of events to send
名称 类型 默认值 描述
base_delay 浮点数 0.0 Amount of time in seconds before starting this step
event 字符串 The event to send to the entity
sound_event 字符串 The sound event to play when this step happens
返回顶部

minecraft:behavior.share_items

Allows the mob to give items it has to others.

名称 类型 默认值 描述
entity_types JSON Object List of entities this mob will share items with
名称 类型 默认值 描述
cooldown 浮点数 0.0 The amount of time in seconds that the mob has to wait before selecting a target of the same type again
filters Minecraft 过滤器 Conditions that make this entry in the list valid
max_dist 浮点数 16 Maximum distance this mob can be away to be a valid choice
must_see 布尔值 false If true, the mob has to be visible to be a valid choice
must_see_forget_duration 浮点数 3.0 Determines the amount of time in seconds that this mob will look for a target before forgetting about it and looking for a new one when the target isn't visible any more
reevaluate_description 布尔值 false If true, the mob will stop being targeted if it stops meeting any conditions.
sprint_speed_multiplier 浮点数 1.0 Multiplier for the running speed. A value of 1.0 means the speed is unchanged
walk_speed_multiplier 浮点数 1.0 Multiplier for the walking speed. A value of 1.0 means the speed is unchanged
goal_radius 浮点数 0.5 Distance in blocks within the mob considers it has reached the goal. This is the "wiggle room" to stop the AI from bouncing back and forth trying to reach a specific spot
max_dist 浮点数 0.0 Maximum distance in blocks this mob will look for entities to share items with
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.silverfish_merge_with_stone

Allows the mob to go into stone blocks like Silverfish do. Currently it can only be used by Silverfish.
返回顶部

minecraft:behavior.silverfish_wake_up_friends

Allows the mob to alert mobs in nearby blocks to come out. Currently it can only be used by Silverfish.
返回顶部

minecraft:behavior.skeleton_horse_trap

Allows Equine mobs to be Horse Traps and be triggered like them, spawning a lightning bolt and a bunch of horses when a player is nearby. Can only be used by Horses, Mules, Donkeys and Skeleton Horses.

名称 类型 默认值 描述
duration 浮点数 1.0 Amount of time in seconds the trap exists. After this amount of time is elapsed, the trap is removed from the world if it hasn't been activated
within_radius 浮点数 0.0 Distance in blocks that the player has to be within to trigger the horse trap
返回顶部

minecraft:behavior.sleep

Allows mobs that own a bed to in a village to move to and sleep in it.

名称 类型 默认值 描述
can_sleep_while_riding 布尔值 false If true, the mob will be able to use the sleep goal if riding something
cooldown_time 浮点数 0.0 Time in seconds the mob has to wait before using the goal again
sleep_collider_height 浮点数 1.0 The height of the mob's collider while sleeping
sleep_collider_width 浮点数 1.0 The width of the mob's collider while sleeping
sleep_y_offset 浮点数 1.0 The y offset of the mob's collider while sleeping
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

Causes the entity to grow tired every once in a while, while attacking.

名称 类型 默认值 描述
set_persistent 布尔值 false Allows the actor to be set to persist upon targeting a player
speed_multiplier 浮点数 1 During attack behavior, this multiplier modifies the entity's speed when moving toward the target.
x_max_rotation 浮点数 10 Maximum rotation (in degrees), on the X-axis, this entity can rotate while trying to look at the target.
y_max_rotation 浮点数 10 Maximum rotation (in degrees), on the Y-axis, this entity can rotate while trying to look at the target.
返回顶部

minecraft:behavior.slime_float

Allow slimes to float in water / lava. Can only be used by Slime and Magma Cubes.

名称 类型 默认值 描述
jump_chance_percentage 浮点数 0.8 Percent chance a slime or magma cube has to jump while in water / lava.
speed_multiplier 浮点数 1.2 Determines the multiplier the entity's speed is modified by when moving through water / lava.
返回顶部

minecraft:behavior.slime_keep_on_jumping

Allows the entity to continuously jump around like a slime.

名称 类型 默认值 描述
speed_multiplier 浮点数 1 Determines the multiplier this entity's speed is modified by when jumping around.
返回顶部

minecraft:behavior.slime_random_direction

Allows the entity to move in random directions like a slime.

名称 类型 默认值 描述
add_random_time_range 整数 3 Additional time (in whole seconds), chosen randomly in the range of [0, "add_random_time_range"], to add to "min_change_direction_time".
min_change_direction_time 浮点数 2 Constant minimum time (in seconds) to wait before choosing a new direction.
turn_range 整数 360 Maximum rotation angle range (in degrees) when randomly choosing a new direction.
返回顶部

minecraft:behavior.snacking

Allows the mob to take a load off and snack on food that it found nearby.

名称 类型 默认值 描述
items 列表 Items that we are interested in snacking on
snacking_cooldown 浮点数 7.5 The cooldown time in seconds before the mob is able to snack again
snacking_cooldown_min 浮点数 0.5f The minimum time in seconds before the mob is able to snack again
snacking_stop_chance 浮点数 0.0017 This is the chance that the mob will stop snacking, from 0 to 1
返回顶部

minecraft:behavior.sneeze

Allows the mob to stop and sneeze possibly startling nearby mobs and dropping an item.

名称 类型 默认值 描述
cooldown_time 浮点数 0.0 Time in seconds the mob has to wait before using the goal again
drop_item_chance 浮点数 1.0 The probability that the mob will drop an item when it sneezes.
entity_types JSON Object List of entity types this mob will startle (cause to jump) when it sneezes.
名称 类型 默认值 描述
cooldown 浮点数 0.0 The amount of time in seconds that the mob has to wait before selecting a target of the same type again
filters Minecraft 过滤器 Conditions that make this entry in the list valid
max_dist 浮点数 16 Maximum distance this mob can be away to be a valid choice
must_see 布尔值 false If true, the mob has to be visible to be a valid choice
must_see_forget_duration 浮点数 3.0 Determines the amount of time in seconds that this mob will look for a target before forgetting about it and looking for a new one when the target isn't visible any more
reevaluate_description 布尔值 false If true, the mob will stop being targeted if it stops meeting any conditions.
sprint_speed_multiplier 浮点数 1.0 Multiplier for the running speed. A value of 1.0 means the speed is unchanged
walk_speed_multiplier 浮点数 1.0 Multiplier for the walking speed. A value of 1.0 means the speed is unchanged
loot_table 字符串 Loot table to select dropped items from.
prepare_sound 字符串 Sound to play when the sneeze is about to happen.
prepare_time 浮点数 1.0 The time in seconds that the mob takes to prepare to sneeze (while the prepare_sound is playing).
probability 浮点数 0.02 The probability of sneezing. A value of 1.00 is 100%
sound 字符串 Sound to play when the sneeze occurs.
within_radius 浮点数 0.0 Distance in blocks that mobs will be startled.
返回顶部

minecraft:behavior.sniff

Allows this entity to detect the nearest player within "sniffing_radius" and update its "minecraft:suspect_tracking" component state

名称 类型 默认值 描述
cooldown_range 范围 [a, b] [3.0, 10.0] Cooldown range between sniffs in seconds
duration 浮点数 1.0 Sniffing duration in seconds
sniffing_radius 浮点数 5.0 Mob detection radius
suspicion_radius_horizontal 浮点数 3.0 Mob suspicion horizontal radius. When a player is within this radius horizontally, the anger level towards that player is increased
suspicion_radius_vertical 浮点数 3.0 Mob suspicion vertical radius. When a player is within this radius vertically, the anger level towards that player is increased
返回顶部

minecraft:behavior.sonic_boom

Allows this entity to perform a 'sonic boom' ranged attack

名称 类型 默认值 描述
attack_cooldown 浮点数 5.00 Cooldown in seconds required after using this attack until the entity can use sonic boom again.
attack_damage 浮点数 30.00 Attack damage of the sonic boom.
attack_range_horizontal 浮点数 15.00 Horizontal range (in blocks) at which the sonic boom can damage the target.
attack_range_vertical 浮点数 20.00 Vertical range (in blocks) at which the sonic boom can damage the target.
attack_sound 字符串 Sound event for the attack.
charge_sound 字符串 Sound event for the charge up.
duration 浮点数 3.00 Goal duration in seconds
duration_until_attack_sound 浮点数 1.70 Duration in seconds until the attack sound is played.
knockback_height_cap 浮点数 0.00 Height cap of the attack knockback's vertical delta.
knockback_horizontal_strength 浮点数 0.00 Horizontal strength of the attack's knockback applied to the attack target.
knockback_vertical_strength 浮点数 0.00 Vertical strength of the attack's knockback applied to the attack target.
speed_multiplier 浮点数 1.00 This multiplier modifies the attacking entity's speed when moving toward the target.
返回顶部

minecraft:behavior.squid_dive

Allows the squid to dive down in water. Can only be used by the Squid.
返回顶部

minecraft:behavior.squid_flee

Allows the squid to swim away. Can only be used by the Squid.
返回顶部

minecraft:behavior.squid_idle

Allows the squid to swim in place idly. Can only be used by the Squid.
返回顶部

minecraft:behavior.squid_move_away_from_ground

Allows the squid to move away from ground blocks and back to water. Can only be used by the Squid.
返回顶部

minecraft:behavior.squid_out_of_water

Allows the squid to stick to the ground when outside water. Can only be used by the Squid.
返回顶部

minecraft:behavior.stalk_and_pounce_on_target

Allows a mob to stalk a target, then once within range pounce onto a target, on success the target will be attacked dealing damage defined by the attack component. On failure, the mob will risk getting stuck

名称 类型 默认值 描述
interest_time 浮点数 2.0 The amount of time the mob will be interested before pouncing. This happens when the mob is within range of pouncing
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 The maximum distance away a target can be before the mob gives up on stalking
pounce_max_dist 浮点数 5.0 The maximum distance away from the target in blocks to begin pouncing at the target
set_persistent 布尔值 false Allows the actor to be set to persist upon targeting a player
stalk_speed 浮点数 1.2 The movement speed in which you stalk your target
strike_dist 浮点数 2.0 The max distance away from the target when landing from the pounce that will still result in damaging the target
stuck_time 浮点数 2.0 The amount of time the mob will be stuck if they fail and land on a block they can be stuck on
返回顶部

minecraft:behavior.stay_near_noteblock

The entity will attempt to toss the items from its inventory to a nearby recently played noteblock.

名称 类型 默认值 描述
listen_time 整数 0.000000 Sets the time an entity should stay near a noteblock after hearing it.
speed 浮点数 1.000000 Sets the entity's speed when moving toward the block.
start_distance 浮点数 10.000000 Sets the distance the entity needs to be away from the block to attempt to start the goal.
stop_distance 浮点数 2.000000 Sets the distance from the block the entity will attempt to reach.
返回顶部

minecraft:behavior.stay_while_sitting

Allows the mob to stay put while it is in a sitting state instead of doing something else.
返回顶部

minecraft:behavior.stomp_attack

Allows an entity to attack using stomp AoE damage behavior.

名称 类型 默认值 描述
attack_once 布尔值 false Allows the entity to use this attack behavior, only once EVER.
attack_types 字符串 N/A Defines the entity types this entity will attack.
can_spread_on_fire 布尔值 false If the entity is on fire, this allows the entity's target to catch on fire after being hit.
cooldown_time 浮点数 1 Cooldown time (in seconds) between attacks.
inner_boundary_time_increase 浮点数 0.25 Time (in seconds) to add to attack path recalculation when the target is beyond the "path_inner_boundary".
max_dist 浮点数 N/A Unused. No effect on "minecraft:behavior.melee_attack".
max_path_time 浮点数 0.55 Maximum base time (in seconds) to recalculate new attack path to target (before increases applied).
min_path_time 浮点数 0.2 Minimum base time (in seconds) to recalculate new attack path to target (before increases applied).
no_damage_range_multiplier 浮点数 2 Multiplied with the final AoE damage range to determine a no damage range. The stomp attack will go on cooldown if target is in this no damage range.
on_attack 触发器 N/A Defines the event to trigger when this entity successfully attacks.
outer_boundary_time_increase 浮点数 0.5 Time (in seconds) to add to attack path recalculation when the target is beyond the "path_outer_boundary".
path_fail_time_increase 浮点数 0.75 Time (in seconds) to add to attack path recalculation when this entity cannot move along the current path.
path_inner_boundary 浮点数 16 Distance at which to increase attack path recalculation by "inner_boundary_tick_increase".
path_outer_boundary 浮点数 32 Distance at which to increase attack path recalculation by "outer_boundary_tick_increase".
random_stop_interval 整数 0 This entity will have a 1 in N chance to stop it's current attack, where N = "random_stop_interval".
reach_multiplier 浮点数 2 Used with the base size of the entity to determine minimum target-distance before trying to deal attack damage.
require_complete_path 布尔值 false Toggles (on/off) the need to have a full path from the entity to the target when using this melee attack behavior.
set_persistent 布尔值 false Allows the actor to be set to persist upon targeting a player
speed_multiplier 浮点数 1 This multiplier modifies the attacking entity's speed when moving toward the target.
stomp_range_multiplier 浮点数 2 Multiplied with the base size of the entity to determine stomp AoE damage range.
target_dist 浮点数 N/a Unused. No effect on "minecraft:behavior.melee_attack".
track_target 布尔值 false Allows the entity to track the attack target, even if the entity has no sensing.
x_max_rotation 浮点数 30 Maximum rotation (in degrees), on the X-axis, this entity can rotate while trying to look at the target.
y_max_head_rotation 浮点数 30 Maximum rotation (in degrees), on the Y-axis, this entity can rotate its head while trying to look at the target.
返回顶部

minecraft:behavior.stomp_turtle_egg

Allows this mob to stomp turtle eggs

名称 类型 默认值 描述
goal_radius 浮点数 0.5 Distance in blocks within the mob considers it has reached the goal. This is the "wiggle room" to stop the AI from bouncing back and forth trying to reach a specific spot
interval 整数 120 一个随机值，用于确定何时随机移动到某个位置。这有概率为此值分之一的机会选择此目标
search_height 整数 1 Height in blocks the mob will look for turtle eggs to move towards
search_range 整数 0 The distance in blocks it will look for turtle eggs to move towards
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
返回顶部

minecraft:behavior.stroll_towards_village

Allows the mob to move into a random location within a village within the search range.

这是生物开始这个目标的几率，从 0 到 1
名称 类型 默认值 描述
cooldown_time 浮点数 0.0 Time in seconds the mob has to wait before using the goal again
goal_radius 浮点数 0.5 Distance in blocks within the mob considers it has reached the goal. This is the "wiggle room" to stop the AI from bouncing back and forth trying to reach a specific spot
search_range 整数 0 The distance in blocks to search for points inside villages. If <= 0, find the closest village regardless of distance.
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
start_chance 浮点数 0.1 This is the chance that the mob will start this goal, from 0 to 1
返回顶部

minecraft:behavior.summon_entity

Allows the mob to attack the player by summoning other entities.

名称 类型 默认值 描述
summon_choices 列表 List of spells for the mob to use to summon entities. Each spell has the following parameters:
名称 类型 默认值 描述
cast_duration 浮点数 Total delay of the steps Time in seconds the spell casting will take
cooldown_time 浮点数 0.0 Time in seconds the mob has to wait before using the spell again
do_casting 布尔值 true If true, the mob will do the casting animations and render spell particles
filters Minecraft 过滤器
max_activation_range 浮点数 32.0 Upper bound of the activation distance in blocks for this spell, must not be negative.
min_activation_range 浮点数 1.0 Lower bound of the activation distance in blocks for this spell, must not be negative.
particle_color 整数 0 The color of the particles for this spell
sequence 列表 List of steps for the spell. Each step has the following parameters:
名称 类型 默认值 描述
base_delay 浮点数 0.0 Amount of time in seconds to wait before this step starts
delay_per_summon 浮点数 0.0 Amount of time in seconds before each entity is summoned in this step
entity_lifespan 浮点数 -1.0 Amount of time in seconds that the spawned entity will be alive for. A value of -1.0 means it will remain alive for as long as it can
entity_type 字符串 The entity type of the entities we will spawn in this step
num_entities_spawned 整数 1 Number of entities that will be spawned in this step
shape 字符串 line The base shape of this step. Valid values are circle and line
size 浮点数 1.0 The base size of the entity
sound_event 字符串 The sound event to play for this step
summon_cap 整数 0 Maximum number of summoned entities at any given time
summon_cap_radius 浮点数 0.0
summon_event 字符串 Event to invoke on each summoned entity on spawn
target 字符串 self The target of the spell. This is where the spell will start (line will start here, circle will be centered here)
start_sound_event 字符串 The sound event to play when using this spell
weight 浮点数 0.0 The weight of this spell. Controls how likely the mob is to choose this spell when casting one
返回顶部

minecraft:behavior.swell

Allows the creeper to swell up when a player is nearby. It can only be used by Creepers.

名称 类型 默认值 描述
start_distance 浮点数 10.0 This mob starts swelling when a target is at least this many blocks away
stop_distance 浮点数 2.0 This mob stops swelling when a target has moved away at least this many blocks
返回顶部

minecraft:behavior.swim_idle

Allows the entity go idle, if swimming. Entity must be in water.

名称 类型 默认值 描述
idle_time 浮点数 5 Amount of time (in seconds) to stay idle.
success_rate 浮点数 0.1 Percent chance this entity will go idle, 1.0 = 100%.
返回顶部

minecraft:behavior.swim_up_for_breath

Allows the mob to try to move to air once it is close to running out of its total breathable supply. Requires "minecraft:breathable".

名称 类型 默认值 描述
material_type 字符串 water The material the mob is traveling in. An air block will only be considered valid to move to with a block of this material below it. Options are: "water", "lava", or "any".
search_height 整数 16 The height (in blocks) above the mob's current position that it will search for a valid air block to move to. If a valid block cannot be found, the mob will move to the position this many blocks above it.
search_radius 整数 4 The radius (in blocks) around the mob's current position that it will search for a valid air block to move to.
speed_mod 浮点数 1.40 Movement speed multiplier of the mob when using this Goal.
返回顶部

minecraft:behavior.swim_wander

Allows the entity to wander around while swimming, when not path-finding.

名称 类型 默认值 描述
interval 浮点数 0.00833 Percent chance to start wandering, when not path-finding. 1 = 100%
look_ahead 浮点数 5 Distance to look ahead for obstacle avoidance, while wandering.
speed_multiplier 浮点数 1 This multiplier modifies the entity's speed when wandering.
wander_time 浮点数 5 Amount of time (in seconds) to wander after wandering behavior was successfully started.
返回顶部

minecraft:behavior.swim_with_entity

Allows the entity follow another entity. Both entities must be swimming [ie, in water].

名称 类型 默认值 描述
catch_up_multiplier 浮点数 2.5 The multiplier this entity's speed is modified by when matching another entity's direction.
catch_up_threshold 浮点数 12 Distance, from the entity being followed, at which this entity will speed up to reach that entity.
chance_to_stop 浮点数 0.0333 Percent chance to stop following the current entity, if they're riding another entity or they're not swimming. 1.0 = 100%
entity_types JSON Object Filters which types of entities are valid to follow.
match_direction_threshold 浮点数 2 Distance, from the entity being followed, at which this entity will try to match that entity's direction
search_range 浮点数 20 Radius around this entity to search for another entity to follow.
speed_multiplier 浮点数 1.5 The multiplier this entity's speed is modified by when trying to catch up to the entity being followed.
state_check_interval 浮点数 0.5 Time (in seconds) between checks to determine if this entity should catch up to the entity being followed or match the direction of the entity being followed.
stop_distance 浮点数 5 Distance, from the entity being followed, at which this entity will stop following that entity.
success_rate 浮点数 0.1 Percent chance to start following another entity, if not already doing so. 1.0 = 100%
返回顶部

minecraft:behavior.swoop_attack

Allows an entity to attack using swoop attack behavior; Ideal for use with flying mobs. The behavior ends if the entity has a horizontal collision or gets hit.

名称 类型 默认值 描述
damage_reach 浮点数 0.2 Added to the base size of the entity, to determine the target's maximum allowable distance, when trying to deal attack damage.
delay_range 范围 [a, b] [10, 20] Minimum and maximum cooldown time-range (in seconds) between each attempted swoop attack.
speed_multiplier 浮点数 1 During swoop attack behavior, this determines the multiplier the entity's speed is modified by when moving toward the target.
返回顶部

minecraft:behavior.take_flower

Allows the mob to accept flowers from another mob with the minecraft:offer_flower behavior.

名称 类型 默认值 描述
filters Minecraft 过滤器 Conditions that need to be met for the behavior to start.
max_head_rotation_y 浮点数 30 Maximum rotation (in degrees), on the Y-axis, this entity can rotate its head while trying to look at the target.
max_rotation_x 浮点数 30 Maximum rotation (in degrees), on the X-axis, this entity can rotate while trying to look at the target.
max_wait_time 浮点数 20.00 The maximum amount of time (in seconds) for the mob to randomly wait for before taking the flower.
min_distance_to_target 浮点数 2.00 Minimum distance (in blocks) for the entity to be considered having reached its target.
min_wait_time 浮点数 4.00 The minimum amount of time (in seconds) for the mob to randomly wait for before taking the flower.
search_area 向量 [a, b, c] [6, 2, 6] The dimensions of the AABB used to search for a potential mob to take a flower from.
speed_multiplier 浮点数 0.50 此生物使用该AI意向时的移动速度乘子.
返回顶部

minecraft:behavior.teleport_to_owner

Allows an entity to teleport to its owner.

名称 类型 默认值 描述
cooldown 浮点数 1.00 The time in seconds that must pass for the entity to be able to try to teleport again.
filters Minecraft 过滤器 Conditions to be satisfied for the entity to teleport to its owner.
返回顶部

minecraft:behavior.tempt

Allows the mob to be tempted by food they like.

名称 类型 默认值 描述
can_get_scared 布尔值 false If true, the mob can stop being tempted if the player moves too fast while close to this mob
can_tempt_vertically 布尔值 false If true, vertical distance to the player will be considered when tempting.
can_tempt_while_ridden 布尔值 false If true, the mob can be tempted even if it has a passenger (i.e. if being ridden).
items 列表 List of items this mob is tempted by
sound_interval 范围 [a, b] [0.0, 0.0] Range of random ticks to wait between tempt sounds.
speed_multiplier 浮点数 1.0 此生物使用该AI意向时的移动速度乘子
tempt_sound 字符串 Sound to play while the mob is being tempted.
within_radius 浮点数 0.0 Distance in blocks this mob can get tempted by a player holding an item they like
返回顶部

minecraft:behavior.timer_flag_1

Fires an event when this behavior starts, then waits for a duration before stopping. When stopping due to that timeout or due to being interrupted by another behavior, fires another event. query.timer_flag_1 will return 1.0 on both the client and server when this behavior is running, and 0.0 otherwise.

名称 类型 默认值 描述
cooldown_range 范围 [a, b] [10.000000, 10.000000] Goal cooldown range in seconds. If specified, the cooldown will have to elapse even before the goal can be selected for the first time.
duration_range 范围 [a, b] [2.000000, 2.000000] Goal duration range in seconds.
on_end 触发器 Event(s) to run when the goal end.
on_start 触发器 Event(s) to run when the goal starts.
返回顶部

minecraft:behavior.timer_flag_2

Fires an event when this behavior starts, then waits for a duration before stopping. When stopping due to that timeout or due to being interrupted by another behavior, fires another event. query.timer_flag_2 will return 1.0 on both the client and server when this behavior is running, and 0.0 otherwise.

名称 类型 默认值 描述
cooldown_range 范围 [a, b] [10.000000, 10.000000] Goal cooldown range in seconds. If specified, the cooldown will have to elapse even before the goal can be selected for the first time.
duration_range 范围 [a, b] [2.000000, 2.000000] Goal duration range in seconds.
on_end 触发器 Event(s) to run when the goal end.
on_start 触发器 Event(s) to run when the goal starts.
返回顶部

minecraft:behavior.timer_flag_3

Fires an event when this behavior starts, then waits for a duration before stopping. When stopping due to that timeout or due to being interrupted by another behavior, fires another event. query.timer_flag_3 will return 1.0 on both the client and server when this behavior is running, and 0.0 otherwise.

名称 类型 默认值 描述
cooldown_range 范围 [a, b] [10.000000, 10.000000] Goal cooldown range in seconds. If specified, the cooldown will have to elapse even before the goal can be selected for the first time.
duration_range 范围 [a, b] [2.000000, 2.000000] Goal duration range in seconds.
on_end 触发器 Event(s) to run when the goal end.
on_start 触发器 Event(s) to run when the goal starts.
返回顶部

minecraft:behavior.trade_interest

Allows the mob to look at a player that is holding a tradable item.

名称 类型 默认值 描述
carried_item_switch_time 浮点数 2.0 The max time in seconds that the trader will hold an item before attempting to switch for a different item that takes the same trade
cooldown 浮点数 2.0 The time in seconds before the trader can use this goal again
interest_time 浮点数 45.0 The max time in seconds that the trader will be interested with showing its trade items
remove_item_time 浮点数 1.0 The max time in seconds that the trader will wait when you no longer have items to trade
within_radius 浮点数 0.0 Distance in blocks this mob can be interested by a player holding an item they like
返回顶部

minecraft:behavior.trade_with_player

Allows the player to trade with this mob. When the goal starts, it will stop the mob's navigation.

名称 类型 默认值 描述
filters Minecraft 过滤器 Conditions that need to be met for the behavior to start.
max_distance_from_player 浮点数 8.00 The max distance that the mob can be from the player before exiting the goal.
返回顶部

minecraft:behavior.vex_copy_owner_target

Allows the mob to target the same entity its owner is targeting.

名称 类型 默认值 描述
entity_types JSON Object List of entities this mob can copy the owner from
名称 类型 默认值 描述
cooldown 浮点数 0.0 The amount of time in seconds that the mob has to wait before selecting a target of the same type again
filters Minecraft 过滤器 Conditions that make this entry in the list valid
max_dist 浮点数 16 Maximum distance this mob can be away to be a valid choice
must_see 布尔值 false If true, the mob has to be visible to be a valid choice
must_see_forget_duration 浮点数 3.0 Determines the amount of time in seconds that this mob will look for a target before forgetting about it and looking for a new one when the target isn't visible any more
reevaluate_description 布尔值 false If true, the mob will stop being targeted if it stops meeting any conditions.
sprint_speed_multiplier 浮点数 1.0 Multiplier for the running speed. A value of 1.0 means the speed is unchanged
walk_speed_multiplier 浮点数 1.0 Multiplier for the walking speed. A value of 1.0 means the speed is unchanged
返回顶部

minecraft:behavior.vex_random_move

Allows the mob to move around randomly like the Vex.
返回顶部

minecraft:behavior.wither_random_attack_pos_goal

Allows the wither to launch random attacks. Can only be used by the Wither Boss.
返回顶部

minecraft:behavior.wither_target_highest_damage

Allows the wither to focus its attacks on whichever mob has dealt the most damage to it.

名称 类型 默认值 描述
entity_types JSON Object List of entity types the wither takes into account to find who dealt the most damage to it
名称 类型 默认值 描述
cooldown 浮点数 0.0 The amount of time in seconds that the mob has to wait before selecting a target of the same type again
filters Minecraft 过滤器 Conditions that make this entry in the list valid
max_dist 浮点数 16 Maximum distance this mob can be away to be a valid choice
must_see 布尔值 false If true, the mob has to be visible to be a valid choice
must_see_forget_duration 浮点数 3.0 Determines the amount of time in seconds that this mob will look for a target before forgetting about it and looking for a new one when the target isn't visible any more
reevaluate_description 布尔值 false If true, the mob will stop being targeted if it stops meeting any conditions.
sprint_speed_multiplier 浮点数 1.0 Multiplier for the running speed. A value of 1.0 means the speed is unchanged
walk_speed_multiplier 浮点数 1.0 Multiplier for the walking speed. A value of 1.0 means the speed is unchanged
返回顶部

minecraft:behavior.work

Allows the NPC to use the POI

名称 类型 默认值 描述
active_time 整数 0 The amount of ticks the NPC will stay in their the work location
can_work_in_rain 布尔值 false If true, this entity can work when their jobsite POI is being rained on.
goal_cooldown 整数 0 The amount of ticks the goal will be on cooldown before it can be used again
on_arrival 触发器 Event to run when the mob reaches their jobsite.
sound_delay_max 整数 0 The max interval in which a sound will play.
sound_delay_min 整数 0 The min interval in which a sound will play.
speed_multiplier 浮点数 0.50 此生物使用该AI意向时的移动速度乘子
work_in_rain_tolerance 整数 -1 If "can_work_in_rain" is false, this is the maximum number of ticks left in the goal where rain will not interrupt the goal
返回顶部

minecraft:behavior.work_composter

Allows the NPC to use the composter POI to convert excess seeds into bone meal.

名称 类型 默认值 描述
active_time 整数 0 The amount of ticks the NPC will stay in their the work location
block_interaction_max 整数 1 The maximum number of times the mob will interact with the composter.
can_empty_composter 布尔值 true Determines whether the mob can empty a full composter.
can_fill_composter 布尔值 true Determines whether the mob can add items to a composter given that it is not full.
can_work_in_rain 布尔值 false If true, this entity can work when their jobsite POI is being rained on.
goal_cooldown 整数 0 The amount of ticks the goal will be on cooldown before it can be used again
items_per_use_max 整数 20 The maximum number of items which can be added to the composter per block interaction.
min_item_count 整数 10 Limits the amount of each compostable item the mob can use. Any amount held over this number will be composted if possible
on_arrival 触发器 Event to run when the mob reaches their jobsite.
speed_multiplier 浮点数 0.50 此生物使用该AI意向时的移动速度乘子
use_block_max 整数 200 The maximum interval in which the mob will interact with the composter.
use_block_min 整数 100 The minimum interval in which the mob will interact with the composter.
work_in_rain_tolerance 整数 -1 If "can_work_in_rain" is false, this is the maximum number of ticks left in the goal where rain will not interrupt the goal
返回顶部



Attributes

minecraft:attack

Defines an entity's melee attack and any additional effects on it.

名称 类型 默认值 描述
damage 范围 [a, b] Range of the random amount of damage the melee attack deals. A negative value can heal the entity instead of hurting it
effect_duration 浮点数 0.0 Duration in seconds of the status ailment applied to the damaged entity
effect_name 字符串 Identifier of the status ailment to apply to an entity attacked by this entity's melee attack
返回顶部

minecraft:spell_effects

Defines what mob effects to add and remove to the entity when adding this component.

名称 类型 默认值 描述
add_effects 列表 List of effects to add to this entity after adding this component
名称 类型 默认值 描述
effect 字符串 Effect to add to this entity. Includes 'duration' in seconds, 'amplifier' level, 'ambient' if it is to be considered an ambient effect, and 'visible' if the effect should be visible
remove_effects 字符串 List of identifiers of effects to be removed from this entity after adding this component
返回顶部

minecraft:strength

Defines the entity's strength to carry items.

名称 类型 默认值 描述
max 整数 5 The maximum strength of this entity
value 整数 1 The initial value of the strength
返回顶部



Built-in Events

名称 描述
minecraft:entity_born Event called on an entity that is spawned through two entities breeding.
minecraft:entity_spawned Event called on an entity that is placed in the level.
minecraft:entity_transformed Event called on an entity that transforms into another entity.
minecraft:on_prime Event called on an entity whose fuse is lit and is ready to explode.
返回顶部

Components



minecraft:addrider

Adds a rider to the entity. Requires minecraft:rideable.

名称 类型 默认值 描述
entity_type 字符串 The entity type that will be riding this entity.
spawn_event 字符串 The spawn event that will be used when the riding entity is created.
返回顶部

minecraft:admire_item

Causes the mob to ignore attackable targets for a given duration.

名称 类型 默认值 描述
cooldown_after_being_attacked 整数 0 Duration, in seconds, for which mob won't admire items if it was hurt
duration 整数 10 Duration, in seconds, that the mob is pacified.
返回顶部

minecraft:ageable

Adds a timer for the entity to grow up. It can be accelerated by giving the entity the items it likes as defined by feedItems.

名称 类型 默认值 描述
drop_items 列表 List of items that the entity drops when it grows up.
duration 浮点数 1200.0 Amount of time before the entity grows up, -1 for always a baby.
feed_items 列表 List of items that can be fed to the entity. Includes 'item' for the item name and 'growth' to define how much time it grows up by.
grow_up 字符串 Event to run when this entity grows up.
interact_filters Minecraft 过滤器 List of conditions to meet so that the entity can be fed.
transform_to_item Item Description Properties The feed item used will transform to this item upon successful interaction. Format: itemName:auxValue
返回顶部

minecraft:anger_level

Allows this entity to track anger towards a set of nuisances

名称 类型 默认值 描述
anger_decrement_interval 浮点数 1.00 Anger level will decay over time. Defines how often anger towards all nuisances will be decreased by one
angry_boost Positive Integer 20 Anger boost applied to angry threshold when mob gets angry
angry_threshold Positive Integer 80 Threshold that define when the mob is considered angry at a nuisance
default_annoyingness 字符串 0 The default amount of annoyingness for any given nuisance. Specifies how much to raise anger level on each provocation
max_anger Positive Integer 100 The maximum anger level that can be reached. Applies to any nuisance
nuisance_filter Minecraft 过滤器 Filter that is applied to determine if a mob can be a nuisance
on_increase_sounds 数组 Sounds to play when the entity is getting provoked. Evaluated in order. First matching condition wins

condition

A Molang expression describing under which conditions to play this sound, given that the entity was provoked
返回顶部

sound

The sound to play
返回顶部
remove_targets_below_angry_threshold 布尔值 true Defines if the mob should remove target if it falls below 'angry' threshold
返回顶部

minecraft:angry

Defines the entity's 'angry' state using a timer.

名称 类型 默认值 描述
angry_sound 字符串 The sound event to play when the mob is angry
broadcast_anger 布尔值 false If true, other entities of the same entity definition within the broadcastRange will also become angry
broadcast_anger_on_attack 布尔值 false If true, other entities of the same entity definition within the broadcastRange will also become angry whenever this mob attacks
broadcast_anger_on_being_attacked 布尔值 false If true, other entities of the same entity definition within the broadcastRange will also become angry whenever this mob is attacked
broadcast_anger_when_dying 布尔值 true If false, when this mob is killed it does not spread its anger to other entities of the same entity definition within the broadcastRange
broadcast_filters Minecraft 过滤器 Conditions that make this entry in the list valid
broadcast_range 整数 20 Distance in blocks within which other entities of the same entity definition will become angry
broadcast_targets 列表 A list of entity families to broadcast anger to
calm_event 字符串 Event to run after the number of seconds specified in duration expires (when the entity stops being 'angry')
duration 整数 25 The amount of time in seconds that the entity will be angry
duration_delta 整数 0 Variance in seconds added to the duration [-delta, delta]
filters Minecraft 过滤器 Filter out mob types that it should not attack while angry (other Piglins)
sound_interval 范围 [a, b] 0 The range of time in seconds to randomly wait before playing the sound again
返回顶部

minecraft:annotation.break_door

Allows the actor to break doors assuming that that flags set up for the component to use in navigation

名称 类型 默认值 描述
break_time 浮点数 12.0 The time in seconds required to break through doors.
min_difficulty 字符串 hard The minimum difficulty that the world must be on for this entity to break doors.
返回顶部

minecraft:annotation.open_door

Allows the actor to open doors assuming that that flags set up for the component to use in navigation
返回顶部

minecraft:area_attack

A component that does damage to entities that get within range.

名称 类型 默认值 描述
cause 字符串 The type of damage that is applied to entities that enter the damage range.
damage_cooldown 浮点数 0 Attack cooldown (in seconds) for how often this entity can attack a target.
damage_per_tick 整数 2 How much damage per tick is applied to entities that enter the damage range.
damage_range 浮点数 0.2 How close a hostile entity must be to have the damage applied.
entity_filter Minecraft 过滤器 The set of entities that are valid to apply the damage to when within range.
play_attack_sound 布尔值 4.94066e-324 If the entity should play their attack sound when attacking a target.
返回顶部

minecraft:attack_cooldown

Adds a cooldown to a mob. The intention of this cooldown is to be used to prevent the mob from attempting to aquire new attack targets.

名称 类型 默认值 描述
attack_cooldown_complete_event 触发器 Event to be run when the cooldown is complete.
attack_cooldown_time 范围 [a, b] [0.00, 1.00] Amount of time in seconds for the cooldown. Can be specified as a number or a pair of numbers (min and max).
返回顶部

minecraft:barter

Enables the component to drop an item as a barter exchange.

名称 类型 默认值 描述
barter_table 字符串 Loot table that's used to drop a random item.
cooldown_after_being_attacked 整数 0 Duration, in seconds, for which mob won't barter items if it was hurt
返回顶部

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 of blocks to watch for being broken to fire off a specified event. If a block is in multiple lists, multiple events will fire.
sensor_radius 浮点数 16.00 The maximum radial distance in which a specified block can be detected. The biggest radius is 32.0.
sources 列表 List of sources that break the block to listen for. If none are specified, all block breaks will be detected.
返回顶部

minecraft:boostable

Defines the conditions and behavior of a rideable entity's boost.

名称 类型 默认值 描述
boost_items 列表 List of items that can be used to boost while riding this entity. Each item has the following properties:
名称 类型 默认值 描述
damage 整数 1 This is the damage that the item will take each time it is used.
item 字符串 Name of the item that can be used to boost.
replace_item 字符串 The item used to boost will become this item once it is used up.
duration 浮点数 3.00 Time in seconds for the boost.
speed_multiplier 浮点数 1.35 Factor by which the entity's normal speed increases. E.g. 2.0 means go twice as fast. Requires "format_version" of 1.20 or more, otherwise the value 1.35 will be used.
返回顶部

minecraft:boss

The current state of the boss for updating the boss HUD.

名称 类型 默认值 描述
hud_range 整数 55 The max distance from the boss at which the boss's health bar is present on the players screen.
name 字符串 The name that will be displayed above the boss's health bar.
should_darken_sky 布尔值 false Whether the sky should darken in the presence of the boss.
返回顶部

minecraft:break_blocks

Specifies the blocks that this entity can break as it moves around.

名称 类型 默认值 描述
breakable_blocks 列表 A list of the blocks that can be broken as this entity moves around
返回顶部

minecraft:breathable

Defines what blocks this entity can breathe in and gives them the ability to suffocate.

名称 类型 默认值 描述
breathe_blocks 列表 List of blocks this entity can breathe in, in addition to the other "breathes" parameters.
breathes_air 布尔值 true If true, this entity can breathe in air.
breathes_lava 布尔值 true If true, this entity can breathe in lava.
breathes_solids 布尔值 false If true, this entity can breathe in solid blocks.
breathes_water 布尔值 false If true, this entity can breathe in water.
generates_bubbles 布尔值 true If true, this entity will have visible bubbles while in water.
inhale_time 浮点数 0 Time in seconds to recover breath to maximum.
non_breathe_blocks 列表 List of blocks this entity can't breathe in, in addition to the other "breathes" parameters.
suffocate_time 整数 -20 Time in seconds between suffocation damage.
total_supply 整数 15 Time in seconds the entity can hold its breath.
返回顶部

minecraft:breedable

Defines the way an entity can get into the 'love' state.

名称 类型 默认值 描述
allow_sitting 布尔值 false If true, entities can breed while sitting
blend_attributes 布尔值 true If true, the entities will blend their attributes in the offspring after they breed.
breed_cooldown 浮点数 60 Time in seconds before the Entity can breed again.
breed_items 列表 The list of items that can be used to get the entity into the 'love' state
breeds_with 列表 The list of entity definitions that this entity can breed with.
名称 类型 默认值 描述
baby_type 字符串 The entity definition of this entity's babies.
breed_event 字符串 Event to run when this entity breeds.
mate_type 字符串 The entity definition of this entity's mate.
causes_pregnancy 布尔值 false If true, the entity will become pregnant instead of spawning a baby.
deny_parents_variant JSON Object Determines how likely the baby of parents with the same variant will deny that variant and take a random variant within the given range instead.
名称 类型 默认值 描述
chance 浮点数 0 The percentage chance of denying the parents' variant.
max_variant 整数 0 The inclusive maximum of the variant range.
min_variant 整数 0 The inclusive minimum of the variant range.
environment_requirements 列表 The list of nearby block requirements to get the entity into the 'love' state.

blocks

The block types required nearby for the entity to breed.
返回顶部

count

The number of the required block types nearby for the entity to breed.
返回顶部

radius

How many blocks radius from the mob's center to search in for the required blocks. Bounded between 0 and 16.
返回顶部
extra_baby_chance 浮点数 0 Chance that up to 16 babies will spawn between 0.0 and 1.0, where 1.0 is 100%.
inherit_tamed 布尔值 true If true, the babies will be automatically tamed if its parents are
love_filters Minecraft 过滤器 The filters to run when attempting to fall in love.
mutation_factor JSON Object Determines how likely the babies are to NOT inherit one of their parent's variances. Values are between 0.0 and 1.0, with a higher number meaning more likely to mutate.
名称 类型 默认值 描述
color 浮点数 0 The percentage chance of a mutation on the entity's color.
extra_variant 浮点数 0 The percentage chance of a mutation on the entity's extra variant type.
variant 浮点数 0 The percentage chance of a mutation on the entity's variant type.
mutation_strategy 字符串 none Strategy used for mutating variants and extra variants for offspring. Current valid alternatives are 'random' and 'none'.
parent_centric_attribute_blending 列表 [EXPERIMENTAL] List of attributes that should benefit from parent centric attribute blending. For example, horses blend their health, movement, and jump_strength in their offspring.
random_extra_variant_mutation_interval 范围 [a, b] 0 Range used to determine random extra variant.
random_variant_mutation_interval 范围 [a, b] 0 Range used to determine random variant.
require_full_health 布尔值 false If true, the entity needs to be at full health before it can breed.
require_tame 布尔值 true If true, the entities need to be tamed first before they can breed.
transform_to_item 字符串 The breed item used will transform to this item upon successful interaction. Format: itemName:auxValue
返回顶部

minecraft:bribeable

Defines the way an entity can get into the 'bribed' state.

名称 类型 默认值 描述
bribe_cooldown 浮点数 2.0 Time in seconds before the Entity can be bribed again.
bribe_items 列表 The list of items that can be used to bribe the entity.
返回顶部

minecraft:buoyant

Enables an entity to float on the specified liquid blocks.

名称 类型 默认值 描述
apply_gravity 布尔值 true Applies gravity each tick. Causes more of a wave simulation, but will cause more gravity to be applied outside liquids.
base_buoyancy 浮点数 1.0 Base buoyancy used to calculate how much will a mob float.
big_wave_probability 浮点数 0.03 Probability for a big wave hitting the entity. Only used if `simulate_waves` is true.
big_wave_speed 浮点数 10.0 Multiplier for the speed to make a big wave. Triggered depending on 'big_wave_probability'.
drag_down_on_buoyancy_removed 浮点数 0.0 How much an actor will be dragged down when the Buoyancy Component is removed.
liquid_blocks 列表 List of blocks this entity can float on. Must be a liquid block.
simulate_waves 布尔值 true Should the movement simulate waves going through.
返回顶部

minecraft:burns_in_daylight

Specifies if a mob burns in daylight.
返回顶部

minecraft:can_join_raid

Determines that this entity can join an existing raid.
返回顶部

minecraft:celebrate_hunt

Specifies hunt celebration behaviour.

名称 类型 默认值 描述
broadcast 布尔值 true If true, celebration will be broadcasted to other entities in the radius.
celeberation_targets Minecraft 过滤器 The list of conditions that target of hunt must satisfy to initiate celebration.
celebrate_sound 字符串 The sound event to play when the mob is celebrating
duration 整数 4 Duration, in seconds, of celebration
radius 浮点数 16 If broadcast is enabled, specifies the radius in which it will notify other entities for celebration.
sound_interval 范围 [a, b] 0 The range of time in seconds to randomly wait before playing the sound again
返回顶部

minecraft:collision_box

Sets the width and height of the Entity's collision box.

名称 类型 默认值 描述
height 浮点数 1.0 Height of the collision box in blocks. A negative value will be assumed to be 0.
width 浮点数 1.0 Width of the collision box in blocks. A negative value will be assumed to be 0.
返回顶部

minecraft:combat_regeneration

Gives Regeneration I and removes Mining Fatigue from the mob that kills the Actor's attack target.

名称 类型 默认值 描述
apply_to_family 布尔值 false Determines if the mob will grant mobs of the same type combat buffs if they kill the target.
apply_to_self 布尔值 false Determines if the mob will grant itself the combat buffs if it kills the target.
regeneration_duration 整数 5 The duration in seconds of Regeneration I added to the mob.
返回顶部

minecraft:conditional_bandwidth_optimization

Defines the Conditional Spatial Update Bandwidth Optimizations of this entity.

名称 类型 默认值 描述
conditional_values 列表 The object containing the conditional bandwidth optimization values.

conditional_values

Conditions that must be met for these optimization values to be used.
返回顶部

max_dropped_ticks

In relation to the optimization value, determines the maximum ticks spatial update packets can be not sent.
返回顶部

max_optimized_distance

The maximum distance considered during bandwidth optimizations. Any value below the max is interpolated to find optimization, and any value greater than or equal to this max results in max optimization.
返回顶部

use_motion_prediction_hints

When set to true, smaller motion packets will be sent during drop packet intervals, resulting in the same amount of packets being sent as without optimizations but with much less data being sent. This should be used when actors are travelling very quickly or teleporting to prevent visual oddities.
返回顶部
default_values JSON Object The object containing the default bandwidth optimization values.

max_dropped_ticks

In relation to the optimization value, determines the maximum ticks spatial update packets can be not sent.
返回顶部

max_optimized_distance

The maximum distance considered during bandwidth optimizations. Any value below the max is interpolated to find optimization, and any value greater than or equal to this max results in max optimization.
返回顶部

use_motion_prediction_hints

When set to true, smaller motion packets will be sent during drop packet intervals, resulting in the same amount of packets being sent as without optimizations but with much less data being sent. This should be used when actors are travelling very quickly or teleporting to prevent visual oddities.
返回顶部
返回顶部

minecraft:custom_hit_test

List of hitboxes for melee and ranged hits against the entity.

名称 类型 默认值 描述
hitboxes 数组 Comma seperated list of hitboxes.
返回顶部

minecraft:damage_over_time

Applies defined amount of damage to the entity at specified intervals.

名称 类型 默认值 描述
damage_per_hurt 整数 1 Amount of damage caused each hurt.
time_between_hurt 浮点数 0.0 Time in seconds between damage.
返回顶部

minecraft:damage_sensor

"Defines what events to call when this entity is damaged by specific entities or items.

名称 类型 默认值 描述
triggers 列表 List of triggers with the events to call when taking specific kinds of damage."
名称 类型 默认值 描述
cause 字符串 none Type of damage that triggers the events.
damage_modifier 浮点数 0.00 A modifier that adds/removes to the base damage received from the specified damage cause. It does not reduce damage to less than 0.
damage_multiplier 浮点数 1.00 A multiplier that modifies the base damage received from the specified damage cause. If "deals_damage" is true the multiplier can only reduce the damage the entity will take to a minimum of 1.
deals_damage 布尔值 yes Defines how received damage affects the entity:
\n- "yes", received damage is applied to the entity.
\n- "no", received damage is not applied to the entity.
\n- "no_but_side_effects_apply", received damage is not applied to the entity, but the side effects of the attack are. This means that the attacker's weapon loses durability, enchantment side effects are applied, and so on.
on_damage JSON Object Defines which entities the trigger applies to, and which, if any, event to emit when damaged.
on_damage_sound_event 字符串 Defines what sound to play, if any, when the "on_damage" filters are met.
返回顶部

minecraft:dash

Ability for a rideable entity to dash.

名称 类型 默认值 描述
cooldown_time 浮点数 1.00 The dash cooldown in seconds. Default value is 1.000000.
horizontal_momentum 浮点数 1.00 Horizontal momentum of the dash.
vertical_momentum 浮点数 1.00 Vertical momentum of the dash.
返回顶部

minecraft:despawn

Despawns the Actor when the despawn rules or optional filters evaluate to true.

名称 类型 默认值 描述
despawn_from_chance 布尔值 true Determines if "min_range_random_chance" is used in the standard despawn rules
despawn_from_distance JSON Object Specifies if the "min_distance" and "max_distance" are used in the standard despawn rules.
名称 类型 默认值 描述
max_distance 整数 128 maximum distance for standard despawn rules to instantly despawn the mob.
min_distance 整数 32 minimum distance for standard despawn rules to try to despawn the mob.
despawn_from_inactivity 布尔值 true Determines if the "min_range_inactivity_timer" is used in the standard despawn rules.
despawn_from_simulation_edge 布尔值 true Determines if the mob is instantly despawned at the edge of simulation distance in the standard despawn rules.
filters Minecraft 过滤器 The list of conditions that must be satisfied before the Actor is despawned. If a filter is defined then standard despawn rules are ignored.
min_range_inactivity_timer 整数 30 The amount of time in seconds that the mob must be inactive.
min_range_random_chance 整数 800 A random chance between 1 and the given value.
remove_child_entities 布尔值 false If true, all entities linked to this entity in a child relationship (eg. leashed) will also be despawned.
返回顶部

minecraft:dimension_bound

Prevents the entity from changing dimension through portals.
返回顶部

minecraft:drying_out_timer

Adds a timer for drying out that will count down and fire 'dried_out_event' or will stop as soon as the entity will get under rain or water and fire 'stopped_drying_out_event'

名称 类型 默认值 描述
dried_out_event 字符串 Event to fire when the drying out time runs out.
recover_after_dried_out_event 字符串 Event to fire when entity was already dried out but received increase in water supply.
stopped_drying_out_event 字符串 Event to fire when entity stopped drying out, for example got into water or under rain.
total_time 浮点数 0.0 Amount of time in seconds to dry out fully.
water_bottle_refill_time 浮点数 0.0 Optional amount of additional time in seconds given by using splash water bottle on entity.
返回顶部

minecraft:economy_trade_table

Defines this entity's ability to trade with players.

名称 类型 默认值 描述
convert_trades_economy 布尔值 false Determines when the mob transforms, if the trades should be converted when the new mob has a economy_trade_table. When the trades are converted, the mob will generate a new trade list with their new trade table, but then it will try to convert any of the same trades over to have the same enchantments and user data. For example, if the original has a Emerald to Enchanted Iron Sword (Sharpness 1), and the new trade also has an Emerald for Enchanted Iron Sword, then the enchantment will be Sharpness 1.
cured_discount 范围 [a, b] [-25, -20] How much should the discount be modified by when the player has cured the Zombie Villager. Can be specified as a pair of numbers (When use_legacy_price_formula is true this is the low-tier trade discount and high-tier trade discount, otherwise it is the minor positive gossip and major positive gossip.)
display_name 字符串 Name to be displayed while trading with this entity
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, -20] The max the discount can be modified by when the player has cured the Zombie Villager. Can be specified as a pair of numbers (When use_legacy_price_formula is true this is the low-tier trade discount and high-tier trade discount, otherwise it is the minor positive gossip and major positive gossip.)
max_nearby_cured_discount 整数 -200 The max the discount can be modified by when the player has cured a nearby Zombie Villager. Only used when use_legacy_price_formula is true, otherwise max_cured_discount (low) is used.
nearby_cured_discount 整数 -20 How much should the discount be modified by when the player has cured a nearby Zombie Villager
new_screen 布尔值 false Used to determine if trading with entity opens the new trade screen
persist_trades 布尔值 false Determines if the trades should persist when the mob transforms. This makes it so that the next time the mob is transformed to something with a trade_table or economy_trade_table, then it keeps their trades.
show_trade_screen 布尔值 true Show an in game trade screen when interacting with the mob.
table 字符串 File path relative to the resource pack root for this entity's trades
use_legacy_price_formula 布尔值 false Determines whether the legacy formula is used to determines the trade prices.
返回顶部

minecraft:entity_armor_equipment_slot_mapping

It defines to which armor slot an item equipped to 'minecraft:equippable''s second slot should be equipped to. It is automatically applied to all entities for worlds with a version greater than or equal to 1.21.10. For older worlds, 'slot.armor.torso' will be used. It is strongly advised not to explicitly use this component, as no backwards compatibility for it will be provided.

名称 类型 默认值 描述
armor_slot 字符串 The armor slot an item equipped to 'minecraft:equippable''s second slot should be equipped to. It defaults to 'slot.armor.torso' for entities with a format version prior to 1.21.10, and to 'slot.armor.body' otherwise.
返回顶部

minecraft:entity_sensor

A component that owns multiple subsensors, each one firing an event when a set of conditions are met by other entities within the defined range.

名称 类型 默认值 描述
relative_range 布尔值 true If true the subsensors' range is additive on top of the entity's size.
subsensors 列表 The list of subsensors which sense for entities and emit events when all their conditions are met.
名称 类型 默认值 描述
cooldown 浮点数 -1 How many seconds should elapse before the subsensor can once again sense for entities. The cooldown is applied on top of the base 1 tick (0.05 seconds) delay. Negative values will result in no cooldown being used.
event 字符串 Event to fire when the conditions are met.
event_filters Minecraft 过滤器 The set of conditions that must be satisfied to fire the event.
maximum_count 整数 -1 The maximum number of entities that must pass the filter conditions for the event to send.
minimum_count 整数 1 The minimum number of entities that must pass the filter conditions for the event to send.
range Vector [a, b] [10, 10] The maximum horizontal and vertical distance another entity can be from this and have the filters checked against it.
require_all 布尔值 false If true requires all nearby entities to pass the filter conditions for the events to send.
返回顶部

minecraft:environment_sensor

Creates a trigger based on environment conditions.

名称 类型 默认值 描述
triggers 列表 The list of triggers that fire when the environment conditions match the given filter criteria.
返回顶部

minecraft:equip_item

The entity puts on the desired equipment.

名称 类型 默认值 描述
excluded_items 列表 List of items that the entity should not equip.
返回顶部

minecraft:equippable

Defines an entity's behavior for having items equipped to it.

名称 类型 默认值 描述
slots 列表 List of slots and the item that can be equipped.
名称 类型 默认值 描述
accepted_items 列表 The list of items that can go in this slot.
interact_text 字符串 Text to be displayed when the entity can be equipped with this item when playing with Touch-screen controls.
item 字符串 Identifier of the item that can be equipped for this slot.
on_equip 字符串 Event to trigger when this entity is equipped with this item.
on_unequip 字符串 Event to trigger when this item is removed from this entity.
slot 整数 0 The slot number of this slot.
返回顶部

minecraft:exhaustion_values

Defines how much exhaustion each player action should take.

名称 类型 默认值 描述
attack 浮点数 0.1 Amount of exhaustion applied when attacking.
damage 浮点数 0.1 Amount of exhaustion applied when taking damage.
heal 浮点数 6 Amount of exhaustion applied when healed through food regeneration.
jump 浮点数 0.05 Amount of exhaustion applied when jumping.
mine 浮点数 0.005 Amount of exhaustion applied when mining.
sprint 浮点数 0.01 Amount of exhaustion applied when sprinting.
sprint_jump 浮点数 0.2 Amount of exhaustion applied when sprint jumping.
swim 浮点数 0.01 Amount of exhaustion applied when swimming.
walk 浮点数 0 Amount of exhaustion applied when walking.
返回顶部

minecraft:experience_reward

.

名称 类型 默认值 描述
on_bred Molang 0 A Molang expression defining the amount of experience rewarded when this entity is successfully bred. An array of expressions adds each expression's result together for a final total.
on_death Molang 0 A Molang expression defining the amount of experience rewarded when this entity dies. An array of expressions adds each expression's result together for a final total.
返回顶部

minecraft:explode

Defines how the entity explodes.

名称 类型 默认值 描述
allow_underwater 布尔值 false If true, the explosion will affect blocks and entities under water.
breaks_blocks 布尔值 true If true, the explosion will destroy blocks in the explosion radius.
causes_fire 布尔值 false If true, blocks in the explosion radius will be set on fire.
damage_scaling 浮点数 1.000000 A scale factor applied to the explosion's damage to entities. A value of 0 prevents the explosion from dealing any damage. Negative values cause the explosion to heal entities instead.
destroy_affected_by_griefing 布尔值 false If true, whether the explosion breaks blocks is affected by the mob griefing game rule.
fire_affected_by_griefing 布尔值 false If true, whether the explosion causes fire is affected by the mob griefing game rule.
fuse_length 范围 [a, b] [0.0, 0.0] The range for the random amount of time the fuse will be lit before exploding, a negative value means the explosion will be immediate.
fuse_lit 布尔值 false If true, the fuse is already lit when this component is added to the entity.
knockback_scaling 浮点数 1.000000 A scale factor applied to the knockback force caused by the explosion.
max_resistance 浮点数 3.40282e+38 A blocks explosion resistance will be capped at this value when an explosion occurs.
negates_fall_damage 布尔值 false Defines whether the explosion should apply fall damage negation to Players above the point of collision.
particle_effect 字符串 explosion The name of the particle effect to use. The accepted strings are 'explosion', 'wind_burst', or 'breeze_wind_burst'.
power 浮点数 3 The radius of the explosion in blocks and the amount of damage the explosion deals.
sound_effect 字符串 explode The name of the sound effect played when the explosion triggers.
toggles_blocks 布尔值 false If true, the explosion will toggle blocks in the explosion radius.
返回顶部

minecraft:flocking

Allows entities to flock in groups in water or not.

名称 类型 默认值 描述
block_distance 浮点数 0 The amount of blocks away the entity will look at to push away from.
block_weight 浮点数 0 The weight of the push back away from blocks.
breach_influence 浮点数 0 The amount of push back given to a flocker that breaches out of the water.
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:game_event_movement_tracking

Allows an entity to emit `entityMove`, `swim` and `flap` game events, depending on the block the entity is moving through. It is added by default to every mob. Add it again to override its behavior.

名称 类型 默认值 描述
emit_flap 布尔值 false If true, the `flap` game event will be emitted when the entity moves through air.
emit_move 布尔值 true If true, the `entityMove` game event will be emitted when the entity moves on ground or through a solid.
emit_swim 布尔值 true If true, the `swim` game event will be emitted when the entity moves through a liquid.
返回顶部

minecraft:genetics

Defines the way a mob's genes and alleles are passed on to its offspring, and how those traits manifest in the child. Compatible parent genes are crossed together, the alleles are handed down from the parents to the child, and any matching genetic variants fire off JSON events to modify the child and express the traits.

名称 类型 默认值 描述
genes 列表 The list of genes that this entity has and will cross with a partner during breeding.
名称 类型 默认值 描述
allele_range 整数 The range of positive integer allele values for this gene. Spawned mobs will have a random number in this range assigned to them.
名称 类型 默认值 描述
range_max 整数 0 Upper bound of the allele values for this gene.
range_min 整数 0 Lower bound of the allele values for this gene.
genetic_variants 列表 The list of genetic variants for this gene. These check for particular allele combinations and fire events when all of them are satisfied.
名称 类型 默认值 描述
birth_event 字符串 Event to run when this mob is created and matches the allele conditions.
both_allele 整数 -1 If this value is non-negative, compare both the mob's main and hidden alleles with this value for a match with both. Can also be a range of integers.
either_allele 整数 -1 If this value is non-negative, compare both the mob's main and hidden alleles with this value for a match with either. Can also be a range of integers.
hidden_allele 整数 -1 If this value is non-negative, compare the mob's hidden allele with this value for a match. Can also be a range of integers.
main_allele 整数 -1 If this value is non-negative, compare the mob's main allele with this value for a match. Can also be a range of integers.
mutation_rate 浮点数 -1 If this value is non-negative, overrides the chance for this gene that an allele will be replaced with a random one instead of the parent's allele during birth. Non-negative values greater than `1` will be the same as the value `1`.
name 字符串 The name of the gene.
mutation_rate 浮点数 0.03125 Chance that an allele will be replaced with a random one instead of the parent's allele during birth.
返回顶部

minecraft:giveable

Defines sets of items that can be used to trigger events when used on this entity. The item will also be taken and placed in the entity's inventory.

名称 类型 默认值 描述
cooldown 浮点数 0.0 An optional cool down in seconds to prevent spamming interactions.
items 列表 The list of items that can be given to the entity to place in their inventory.
on_give 字符串 Event to fire when the correct item is given.
返回顶部

minecraft:group_size

Keeps track of entity group size in the given radius.

名称 类型 默认值 描述
filters Minecraft 过滤器 The list of conditions that must be satisfied for other entities to be counted towards group size.
radius 浮点数 16 Radius from center of entity.
返回顶部

minecraft:grows_crop

Could increase crop growth when entity walks over crop

名称 类型 默认值 描述
chance 浮点数 0 Value between 0-1. Chance of success per tick.
charges 整数 10 Number of charges
返回顶部

minecraft:healable

Defines the interactions with this entity for healing it.

名称 类型 默认值 描述
filters Minecraft 过滤器 The filter group that defines the conditions for using this item to heal the entity.
force_use 布尔值 false Determines if item can be used regardless of entity being at full health.
items 数组 The array of items that can be used to heal this entity.
名称 类型 默认值 描述
heal_amount 整数 1 The amount of health this entity gains when fed this item.
item 字符串 Item identifier that can be used to heal this entity.
返回顶部

minecraft:heartbeat

Defines the entity's heartbeat.

名称 类型 默认值 描述
interval Molang 1.00 A Molang expression defining the inter-beat interval in seconds. A value of zero or less means no heartbeat.
sound_event 字符串 heartbeat Level sound event to be played as the heartbeat sound.
返回顶部

minecraft:home

Saves a home position for when the the entity is spawned.

名称 类型 默认值 描述
home_block_list 列表 Optional list of blocks that can be considered a valid home. If no such block longer exists at that position,
the home restriction is removed. Example syntax: minecraft:sand. Not supported: minecraft:sand:1.
restriction_radius 整数 0 Optional radius that the entity will be restricted to in relation to its home.
restriction_type 字符串 none Defines how the the entity will be restricted to its home position. The possible values are:
\n- "none", which poses no restriction.
\n- "random_movement", which restricts randomized movement to be around the home position.
\n- "all_movement", which restricts any kind of movement to be around the home position.
However, entities that somehow got too far away from their home will always be able to move closer to it, if prompted to do so.
返回顶部

minecraft:hurt_on_condition

Defines a set of conditions under which an entity should take damage.

名称 类型 默认值 描述
damage_conditions 数组 List of damage conditions that when met can cause damage to the entity.

cause

The kind of damage that is caused to the entity. Various armors and spells use this to determine if the entity is immune.


返回顶部

damage_per_tick

The amount of damage done each tick that the conditions are met.
返回顶部

filters

The set of conditions that must be satisfied before the entity takes the defined damage.
返回顶部
返回顶部

minecraft:inside_block_notifier

Verifies whether the entity is inside any of the listed blocks.

名称 类型 默认值 描述
block_list 列表 List of blocks, with certain block states, that we are monitoring to see if the entity is inside.
返回顶部

minecraft:insomnia

Adds a timer since last rested to see if phantoms should spawn.

名称 类型 默认值 描述
days_until_insomnia 浮点数 3.0 Number of days the mob has to stay up until the insomnia effect begins.
返回顶部

minecraft:instant_despawn

Despawns the Actor immediately.

名称 类型 默认值 描述
remove_child_entities 布尔值 false If true, all entities linked to this entity in a child relationship (eg. leashed) will also be despawned.
返回顶部

minecraft:interact

Defines interactions with this entity.

名称 类型 默认值 描述
add_items JSON Object Loot table with items to add to the player's inventory upon successful interaction.
名称 类型 默认值 描述
table 字符串 File path, relative to the Behavior Pack's path, to the loot table file.
cooldown 浮点数 0 Time in seconds before this entity can be interacted with again.
cooldown_after_being_attacked 浮点数 0 Time in seconds before this entity can be interacted with after being attacked.
drop_item_slot 字符串 The entity's slot to remove and drop the item from, if any, upon successful interaction. Inventory slots are denoted by positive numbers. Armor slots are denoted by 'slot.armor.head', 'slot.armor.chest', 'slot.armor.legs', 'slot.armor.feet' and 'slot.armor.body'.
equip_item_slot 字符串 The entity's slot to equip the item to, if any, upon successful interaction. Inventory slots are denoted by positive numbers. Armor slots are denoted by 'slot.armor.head', 'slot.armor.chest', 'slot.armor.legs', 'slot.armor.feet' and 'slot.armor.body'.
health_amount 整数 0 The amount of health this entity will recover or lose when interacting with this item. Negative values will harm the entity.
hurt_item 整数 0 The amount of damage the item will take when used to interact with this entity. A value of 0 means the item won't lose durability.
interact_text 字符串 Text to show when the player is able to interact in this way with this entity when playing with Touch-screen controls.
on_interact 字符串 Event to fire when the interaction occurs.
particle_on_start JSON Object Particle effect that will be triggered at the start of the interaction.

particle_offset_towards_interactor

Whether or not the particle will appear closer to who performed the interaction.
返回顶部

particle_type

The type of particle that will be spawned.
返回顶部

particle_y_offset

Will offset the particle this amount in the y direction.
返回顶部
play_sounds 字符串 List of sounds to play when the interaction occurs.
repair_entity_item JSON Object Allows to repair one of the entity's items.
名称 类型 默认值 描述
amount 整数 How much of the item durability should be restored upon interaction.
slot 整数 The entity's slot containing the item to be repaired. Inventory slots are denoted by positive numbers. Armor slots are denoted by 'slot.armor.head', 'slot.armor.chest', 'slot.armor.legs', 'slot.armor.feet' and 'slot.armor.body'.
spawn_entities 字符串 List of entities to spawn when the interaction occurs.
spawn_items JSON Object Loot table with items to drop on the ground upon successful interaction.
名称 类型 默认值 描述
table 字符串 File path, relative to the Behavior Pack's path, to the loot table file.
swing 布尔值 false If true, the player will do the 'swing' animation when interacting with this entity.
transform_to_item 字符串 The item used will transform to this item upon successful interaction. Format: itemName:auxValue
use_item 布尔值 false If true, the interaction will use an item.
vibration 字符串 entity_interact Vibration to emit when the interaction occurs. Admitted values are none (no vibration emitted), shear, entity_die, entity_act, entity_interact.
返回顶部

minecraft:inventory

Defines this entity's inventory properties.

名称 类型 默认值 描述
additional_slots_per_strength 整数 0 Number of slots that this entity can gain per extra strength
can_be_siphoned_from 布尔值 false If true, the contents of this inventory can be removed by a hopper
container_type 字符串 none Type of container this entity has. Can be horse, minecart_chest, chest_boat, minecart_hopper, inventory, container or hopper
inventory_size 整数 5 Number of slots the container has
private 布尔值 false If true, the entity will not drop its inventory on death
restrict_to_owner 布尔值 false If true, the entity's inventory can only be accessed by its owner or itself
返回顶部

minecraft:item_hopper

Determines that this entity is an item hopper.
返回顶部

minecraft:jump.dynamic

Defines a dynamic type jump control that will change jump properties based on the speed modifier of the mob.
返回顶部

minecraft:jump.static

Gives the entity the ability to jump.

名称 类型 默认值 描述
jump_power 浮点数 0.42 The initial vertical velocity for the jump
返回顶部

minecraft:leashable

Allows this entity to be leashed and defines the conditions and events for this entity when is leashed.

名称 类型 默认值 描述
can_be_stolen 布尔值 false If true, players can leash this entity even if it is already leashed to another mob.
hard_distance 浮点数 6 Distance in blocks at which the leash stiffens, restricting movement.
max_distance 浮点数 10 Distance in blocks at which the leash breaks.
on_leash 字符串 Event to call when this entity is leashed.
on_unleash 字符串 Event to call when this entity is unleashed.
soft_distance 浮点数 4 Distance in blocks at which the 'spring' effect starts acting to keep this entity close to the entity that leashed it.
返回顶部

minecraft:looked_at

Defines the behavior when another entity looks at the owner entity.

名称 类型 默认值 描述
field_of_view 浮点数 26 Defines, in degrees, the width of the field of view for entities looking at the owner entity. If "scale_fov_by_distance" is set to true, this value corresponds to the field of view at a distance of one block between the entities.
filters Minecraft 过滤器 Defines which entities are considered when searching for entities looking at the owner entity.
find_players_only 布尔值 false Limits the search to only the nearest Player that meets the specified "filters" rather than all nearby entities.
line_of_sight_obstruction_type 字符串 collision Defines the type of block shape used to check for line of sight obstructions. Valid values: "outline", "collision", "collision_for_camera".
look_at_locations 列表 A list of locations on the owner entity towards which line of sight checks are performed. At least one location must be unobstructed for the entity to be considered as looked at.
looked_at_cooldown 范围 [a, b] [0, 0] Specifies the range for the random number of seconds that must pass before the owner entity can check again for entities looking at it, after detecting an entity looking at it.
looked_at_event 字符串 Defines the event to trigger when an entity is detected looking at the owner entity.
not_looked_at_event 字符串 Defines the event to trigger when no entity is found looking at the owner entity.
scale_fov_by_distance 布尔值 true When true, the field of view narrows as the distance between the owner entity and the entity looking at it increases. This ensures that the width of the view cone remains somewhat constant towards the owner entity position, regardless of distance.
search_radius 浮点数 10 Maximum distance the owner entity will search for entities looking at it.
set_target 布尔值 once_and_stop_scanning Defines if and how the owner entity will set entities that are looking at it as its combat targets. Valid values:
\n- "never", looking entities are never set as targets, but events are emitted.
\n- "once_and_stop_scanning", the first detected looking entity is set as target. Scanning and event emission is suspended if and until the owner entity has a target.
\n- "once_and_keep_scanning", the first detected looking entity is set as target. Scanning and event emission continues.s
返回顶部

minecraft:managed_wandering_trader

This component is used to implement part of the Wandering Trader behavior
返回顶部

minecraft:mob_effect

A component that applies a mob effect to entities that get within range.

名称 类型 默认值 描述
cooldown_time 整数 0 Time in seconds to wait between each application of the effect.
effect_range 浮点数 0.2 How close a hostile entity must be to have the mob effect applied.
effect_time 整数 10 How long the applied mob effect lasts in seconds.
entity_filter Minecraft 过滤器 The set of entities that are valid to apply the mob effect to.
mob_effect 字符串 The mob effect that is applied to entities that enter this entities effect range.
返回顶部

minecraft:mob_effect_immunity

Entities with this component will have an immunity to the provided mob effects.

名称 类型 默认值 描述
mob_effects 数组 List of names of effects the entity is immune to.
返回顶部

minecraft:movement.amphibious

This move control allows the mob to swim in water and walk on land.

名称 类型 默认值 描述
max_turn 浮点数 30.0 The maximum number in degrees the mob can turn per tick.
返回顶部

minecraft:movement.basic

This component accents the movement of an entity.

名称 类型 默认值 描述
max_turn 浮点数 30.0 The maximum number in degrees the mob can turn per tick.
返回顶部

minecraft:movement.fly

This move control causes the mob to fly.

名称 类型 默认值 描述
max_turn 浮点数 30.0 The maximum number in degrees the mob can turn per tick.
返回顶部

minecraft:movement.generic

This move control allows a mob to fly, swim, climb, etc.

名称 类型 默认值 描述
max_turn 浮点数 30.0 The maximum number in degrees the mob can turn per tick.
返回顶部

minecraft:movement.hover

This move control causes the mob to hover.

名称 类型 默认值 描述
max_turn 浮点数 30.0 The maximum number in degrees the mob can turn per tick.
返回顶部

minecraft:movement.jump

Move control that causes the mob to jump as it moves with a specified delay between jumps.

名称 类型 默认值 描述
jump_delay 范围 [a, b] [0.0, 0.0] Delay after landing when using the slime move control.
max_turn 浮点数 30.0 The maximum number in degrees the mob can turn per tick.
返回顶部

minecraft:movement.skip

This move control causes the mob to hop as it moves.

名称 类型 默认值 描述
max_turn 浮点数 30.0 The maximum number in degrees the mob can turn per tick.
返回顶部

minecraft:movement.sway

This move control causes the mob to sway side to side giving the impression it is swimming.

名称 类型 默认值 描述
max_turn 浮点数 30.0 The maximum number in degrees the mob can turn per tick.
sway_amplitude 浮点数 0.05 Strength of the sway movement.
sway_frequency 浮点数 0.5 Multiplier for the frequency of the sway movement.
返回顶部

minecraft:nameable

Allows this entity to be named (e.g. using a name tag).

名称 类型 默认值 描述
allow_name_tag_renaming 布尔值 true If true, this entity can be renamed with name tags
always_show 布尔值 false If true, the name will always be shown
default_trigger 字符串 Trigger to run when the entity gets named
name_actions JSON Object Describes the special names for this entity and the events to call when the entity acquires those names
名称 类型 默认值 描述
name_filter 字符串 List of special names that will cause the events defined in 'on_named' to fire
on_named 字符串 Event to be called when this entity acquires the name specified in 'name_filter'
返回顶部

minecraft:navigation.climb

Allows this entity to generate paths that include vertical walls like the vanilla Spiders do.

名称 类型 默认值 描述
avoid_damage_blocks 布尔值 false Tells the pathfinder to avoid blocks that cause damage when finding a path
avoid_portals 布尔值 false Tells the pathfinder to avoid portals (like nether portals) when finding a path
avoid_sun 布尔值 false Whether or not the pathfinder should avoid tiles that are exposed to the sun when creating paths
avoid_water 布尔值 false Tells the pathfinder to avoid water when creating a path
blocks_to_avoid 列表 Tells the pathfinder which blocks to avoid when creating a path
can_breach 布尔值 false Tells the pathfinder whether or not it can jump out of water (like a dolphin)
can_break_doors 布尔值 false Tells the pathfinder that it can path through a closed door and break it
can_jump 布尔值 true Tells the pathfinder whether or not it can jump up blocks
can_open_doors 布尔值 false Tells the pathfinder that it can path through a closed door assuming the AI will open the door
can_open_iron_doors 布尔值 false Tells the pathfinder that it can path through a closed iron door assuming the AI will open the door
can_pass_doors 布尔值 true Whether a path can be created through a door
can_path_from_air 布尔值 false Tells the pathfinder that it can start pathing when in the air
can_path_over_lava 布尔值 false Tells the pathfinder whether or not it can travel on the surface of the lava
can_path_over_water 布尔值 false Tells the pathfinder whether or not it can travel on the surface of the water
can_sink 布尔值 true Tells the pathfinder whether or not it will be pulled down by gravity while in water
can_swim 布尔值 false Tells the pathfinder whether or not it can path anywhere through water and plays swimming animation along that path
can_walk 布尔值 true Tells the pathfinder whether or not it can walk on the ground outside water
can_walk_in_lava 布尔值 false Tells the pathfinder whether or not it can travel in lava like walking on ground
is_amphibious 布尔值 false Tells the pathfinder whether or not it can walk on the ground underwater
返回顶部

minecraft:navigation.float

Allows this entity to generate paths by flying around the air like the regular Ghast.

名称 类型 默认值 描述
avoid_damage_blocks 布尔值 false Tells the pathfinder to avoid blocks that cause damage when finding a path
avoid_portals 布尔值 false Tells the pathfinder to avoid portals (like nether portals) when finding a path
avoid_sun 布尔值 false Whether or not the pathfinder should avoid tiles that are exposed to the sun when creating paths
avoid_water 布尔值 false Tells the pathfinder to avoid water when creating a path
blocks_to_avoid 列表 Tells the pathfinder which blocks to avoid when creating a path
can_breach 布尔值 false Tells the pathfinder whether or not it can jump out of water (like a dolphin)
can_break_doors 布尔值 false Tells the pathfinder that it can path through a closed door and break it
can_jump 布尔值 true Tells the pathfinder whether or not it can jump up blocks
can_open_doors 布尔值 false Tells the pathfinder that it can path through a closed door assuming the AI will open the door
can_open_iron_doors 布尔值 false Tells the pathfinder that it can path through a closed iron door assuming the AI will open the door
can_pass_doors 布尔值 true Whether a path can be created through a door
can_path_from_air 布尔值 false Tells the pathfinder that it can start pathing when in the air
can_path_over_lava 布尔值 false Tells the pathfinder whether or not it can travel on the surface of the lava
can_path_over_water 布尔值 false Tells the pathfinder whether or not it can travel on the surface of the water
can_sink 布尔值 true Tells the pathfinder whether or not it will be pulled down by gravity while in water
can_swim 布尔值 false Tells the pathfinder whether or not it can path anywhere through water and plays swimming animation along that path
can_walk 布尔值 true Tells the pathfinder whether or not it can walk on the ground outside water
can_walk_in_lava 布尔值 false Tells the pathfinder whether or not it can travel in lava like walking on ground
is_amphibious 布尔值 false Tells the pathfinder whether or not it can walk on the ground underwater
返回顶部

minecraft:navigation.fly

Allows this entity to generate paths in the air like the vanilla Parrots do.

名称 类型 默认值 描述
avoid_damage_blocks 布尔值 false Tells the pathfinder to avoid blocks that cause damage when finding a path
avoid_portals 布尔值 false Tells the pathfinder to avoid portals (like nether portals) when finding a path
avoid_sun 布尔值 false Whether or not the pathfinder should avoid tiles that are exposed to the sun when creating paths
avoid_water 布尔值 false Tells the pathfinder to avoid water when creating a path
blocks_to_avoid 列表 Tells the pathfinder which blocks to avoid when creating a path
can_breach 布尔值 false Tells the pathfinder whether or not it can jump out of water (like a dolphin)
can_break_doors 布尔值 false Tells the pathfinder that it can path through a closed door and break it
can_jump 布尔值 true Tells the pathfinder whether or not it can jump up blocks
can_open_doors 布尔值 false Tells the pathfinder that it can path through a closed door assuming the AI will open the door
can_open_iron_doors 布尔值 false Tells the pathfinder that it can path through a closed iron door assuming the AI will open the door
can_pass_doors 布尔值 true Whether a path can be created through a door
can_path_from_air 布尔值 false Tells the pathfinder that it can start pathing when in the air
can_path_over_lava 布尔值 false Tells the pathfinder whether or not it can travel on the surface of the lava
can_path_over_water 布尔值 false Tells the pathfinder whether or not it can travel on the surface of the water
can_sink 布尔值 true Tells the pathfinder whether or not it will be pulled down by gravity while in water
can_swim 布尔值 false Tells the pathfinder whether or not it can path anywhere through water and plays swimming animation along that path
can_walk 布尔值 true Tells the pathfinder whether or not it can walk on the ground outside water
can_walk_in_lava 布尔值 false Tells the pathfinder whether or not it can travel in lava like walking on ground
is_amphibious 布尔值 false Tells the pathfinder whether or not it can walk on the ground underwater
返回顶部

minecraft:navigation.generic

Allows this entity to generate paths by walking, swimming, flying and/or climbing around and jumping up and down a block.

名称 类型 默认值 描述
avoid_damage_blocks 布尔值 false Tells the pathfinder to avoid blocks that cause damage when finding a path
avoid_portals 布尔值 false Tells the pathfinder to avoid portals (like nether portals) when finding a path
avoid_sun 布尔值 false Whether or not the pathfinder should avoid tiles that are exposed to the sun when creating paths
avoid_water 布尔值 false Tells the pathfinder to avoid water when creating a path
blocks_to_avoid 列表 Tells the pathfinder which blocks to avoid when creating a path
can_breach 布尔值 false Tells the pathfinder whether or not it can jump out of water (like a dolphin)
can_break_doors 布尔值 false Tells the pathfinder that it can path through a closed door and break it
can_jump 布尔值 true Tells the pathfinder whether or not it can jump up blocks
can_open_doors 布尔值 false Tells the pathfinder that it can path through a closed door assuming the AI will open the door
can_open_iron_doors 布尔值 false Tells the pathfinder that it can path through a closed iron door assuming the AI will open the door
can_pass_doors 布尔值 true Whether a path can be created through a door
can_path_from_air 布尔值 false Tells the pathfinder that it can start pathing when in the air
can_path_over_lava 布尔值 false Tells the pathfinder whether or not it can travel on the surface of the lava
can_path_over_water 布尔值 false Tells the pathfinder whether or not it can travel on the surface of the water
can_sink 布尔值 true Tells the pathfinder whether or not it will be pulled down by gravity while in water
can_swim 布尔值 false Tells the pathfinder whether or not it can path anywhere through water and plays swimming animation along that path
can_walk 布尔值 true Tells the pathfinder whether or not it can walk on the ground outside water
can_walk_in_lava 布尔值 false Tells the pathfinder whether or not it can travel in lava like walking on ground
is_amphibious 布尔值 false Tells the pathfinder whether or not it can walk on the ground underwater
返回顶部

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 Tells the pathfinder to avoid blocks that cause damage when finding a path
avoid_portals 布尔值 false Tells the pathfinder to avoid portals (like nether portals) when finding a path
avoid_sun 布尔值 false Whether or not the pathfinder should avoid tiles that are exposed to the sun when creating paths
avoid_water 布尔值 false Tells the pathfinder to avoid water when creating a path
blocks_to_avoid 列表 Tells the pathfinder which blocks to avoid when creating a path
can_breach 布尔值 false Tells the pathfinder whether or not it can jump out of water (like a dolphin)
can_break_doors 布尔值 false Tells the pathfinder that it can path through a closed door and break it
can_jump 布尔值 true Tells the pathfinder whether or not it can jump up blocks
can_open_doors 布尔值 false Tells the pathfinder that it can path through a closed door assuming the AI will open the door
can_open_iron_doors 布尔值 false Tells the pathfinder that it can path through a closed iron door assuming the AI will open the door
can_pass_doors 布尔值 true Whether a path can be created through a door
can_path_from_air 布尔值 false Tells the pathfinder that it can start pathing when in the air
can_path_over_lava 布尔值 false Tells the pathfinder whether or not it can travel on the surface of the lava
can_path_over_water 布尔值 false Tells the pathfinder whether or not it can travel on the surface of the water
can_sink 布尔值 true Tells the pathfinder whether or not it will be pulled down by gravity while in water
can_swim 布尔值 false Tells the pathfinder whether or not it can path anywhere through water and plays swimming animation along that path
can_walk 布尔值 true Tells the pathfinder whether or not it can walk on the ground outside water
can_walk_in_lava 布尔值 false Tells the pathfinder whether or not it can travel in lava like walking on ground
is_amphibious 布尔值 false Tells the pathfinder whether or not it can walk on the ground underwater
返回顶部

minecraft:navigation.swim

Allows this entity to generate paths that include water.

名称 类型 默认值 描述
avoid_damage_blocks 布尔值 false Tells the pathfinder to avoid blocks that cause damage when finding a path
avoid_portals 布尔值 false Tells the pathfinder to avoid portals (like nether portals) when finding a path
avoid_sun 布尔值 false Whether or not the pathfinder should avoid tiles that are exposed to the sun when creating paths
avoid_water 布尔值 false Tells the pathfinder to avoid water when creating a path
blocks_to_avoid 列表 Tells the pathfinder which blocks to avoid when creating a path
can_breach 布尔值 false Tells the pathfinder whether or not it can jump out of water (like a dolphin)
can_break_doors 布尔值 false Tells the pathfinder that it can path through a closed door and break it
can_jump 布尔值 true Tells the pathfinder whether or not it can jump up blocks
can_open_doors 布尔值 false Tells the pathfinder that it can path through a closed door assuming the AI will open the door
can_open_iron_doors 布尔值 false Tells the pathfinder that it can path through a closed iron door assuming the AI will open the door
can_pass_doors 布尔值 true Whether a path can be created through a door
can_path_from_air 布尔值 false Tells the pathfinder that it can start pathing when in the air
can_path_over_lava 布尔值 false Tells the pathfinder whether or not it can travel on the surface of the lava
can_path_over_water 布尔值 false Tells the pathfinder whether or not it can travel on the surface of the water
can_sink 布尔值 true Tells the pathfinder whether or not it will be pulled down by gravity while in water
can_swim 布尔值 false Tells the pathfinder whether or not it can path anywhere through water and plays swimming animation along that path
can_walk 布尔值 true Tells the pathfinder whether or not it can walk on the ground outside water
can_walk_in_lava 布尔值 false Tells the pathfinder whether or not it can travel in lava like walking on ground
is_amphibious 布尔值 false Tells the pathfinder whether or not it can walk on the ground underwater
返回顶部

minecraft:navigation.walk

Allows this entity to generate paths by walking around and jumping up and down a block like regular mobs.

名称 类型 默认值 描述
avoid_damage_blocks 布尔值 false Tells the pathfinder to avoid blocks that cause damage when finding a path
avoid_portals 布尔值 false Tells the pathfinder to avoid portals (like nether portals) when finding a path
avoid_sun 布尔值 false Whether or not the pathfinder should avoid tiles that are exposed to the sun when creating paths
avoid_water 布尔值 false Tells the pathfinder to avoid water when creating a path
blocks_to_avoid 列表 Tells the pathfinder which blocks to avoid when creating a path
can_breach 布尔值 false Tells the pathfinder whether or not it can jump out of water (like a dolphin)
can_break_doors 布尔值 false Tells the pathfinder that it can path through a closed door and break it
can_jump 布尔值 true Tells the pathfinder whether or not it can jump up blocks
can_open_doors 布尔值 false Tells the pathfinder that it can path through a closed door assuming the AI will open the door
can_open_iron_doors 布尔值 false Tells the pathfinder that it can path through a closed iron door assuming the AI will open the door
can_pass_doors 布尔值 true Whether a path can be created through a door
can_path_from_air 布尔值 false Tells the pathfinder that it can start pathing when in the air
can_path_over_lava 布尔值 false Tells the pathfinder whether or not it can travel on the surface of the lava
can_path_over_water 布尔值 false Tells the pathfinder whether or not it can travel on the surface of the water
can_sink 布尔值 true Tells the pathfinder whether or not it will be pulled down by gravity while in water
can_swim 布尔值 false Tells the pathfinder whether or not it can path anywhere through water and plays swimming animation along that path
can_walk 布尔值 true Tells the pathfinder whether or not it can walk on the ground outside water
can_walk_in_lava 布尔值 false Tells the pathfinder whether or not it can travel in lava like walking on ground
is_amphibious 布尔值 false Tells the pathfinder whether or not it can walk on the ground underwater
返回顶部

minecraft:out_of_control

Defines the entity's 'out of control' state.
返回顶部

minecraft:peek

Defines the entity's 'peek' behavior, defining the events that should be called during it.

名称 类型 默认值 描述
on_close 字符串 Event to call when the entity is done peeking.
on_open 字符串 Event to call when the entity starts peeking.
on_target_open 字符串 Event to call when the entity's target entity starts peeking.
返回顶部

minecraft:persistent

Defines whether an entity should be persistent in the game world.
返回顶部

minecraft:physics

Defines physics properties of an actor, including if it is affected by gravity or if it collides with objects.

名称 类型 默认值 描述
has_collision 布尔值 true Whether or not the object collides with things.
has_gravity 布尔值 true Whether or not the entity is affected by gravity.
push_towards_closest_space 布尔值 false Whether or not the entity should be pushed towards the nearest open area when stuck inside a block.
返回顶部

minecraft:preferred_path

Specifies costing information for mobs that prefer to walk on preferred paths.

名称 类型 默认值 描述
default_block_cost 浮点数 0 Cost for non-preferred blocks
jump_cost 整数 0 Added cost for jumping up a node
max_fall_blocks 整数 3 Distance mob can fall without taking damage
preferred_path_blocks 列表 A list of blocks with their associated cost
返回顶部

minecraft:projectile

Allows the entity to be a thrown entity.

名称 类型 默认值 描述
angle_offset 浮点数 0 Determines the angle at which the projectile is thrown
catch_fire 布尔值 false If true, the entity hit will be set on fire
crit_particle_on_hurt 布尔值 false If true, the projectile will produce additional particles when a critical hit happens
destroy_on_hurt 布尔值 false If true, this entity will be destroyed when hit
filter 字符串 Entity Definitions defined here can't be hurt by the projectile
fire_affected_by_griefing 布尔值 false If true, whether the projectile causes fire is affected by the mob griefing game rule
gravity 浮点数 0.05 The gravity applied to this entity when thrown. The higher the value, the faster the entity falls
hit_nearest_passenger 布尔值 false If true, when hitting a vehicle, and there's at least one passenger in the vehicle, the damage will be dealt to the passenger closest to the projectile impact point. If there are no passengers, this setting does nothing.
hit_sound 字符串 The sound that plays when the projectile hits something
homing 布尔值 false If true, the projectile homes in to the nearest entity
ignored_entities 数组 [EXPERIMENTAL] An array of strings defining the types of entities that this entity does not collide with.
inertia 浮点数 0.99 The fraction of the projectile's speed maintained every frame while traveling in air
is_dangerous 布尔值 false If true, the projectile will be treated as dangerous to the players
knockback 布尔值 true If true, the projectile will knock back the entity it hits
lightning 布尔值 false If true, the entity hit will be struck by lightning
liquid_inertia 浮点数 0.6 The fraction of the projectile's speed maintained every frame while traveling in water
multiple_targets 布尔值 true If true, the projectile can hit multiple entities per flight
offset 向量 [a, b, c] [0, 0, 0] The offset from the entity's anchor where the projectile will spawn
on_fire_time 浮点数 5 Time in seconds that the entity hit will be on fire for
particle 字符串 iconcrack Particle to use upon collision
potion_effect 整数 -1 Defines the effect the arrow will apply to the entity it hits
power 浮点数 1.3 Determines the velocity of the projectile
reflect_immunity 浮点数 0 During the specified time, in seconds, the projectile cannot be reflected by hitting it
reflect_on_hurt 布尔值 false If true, this entity will be reflected back when hit
semi_random_diff_damage 布尔值 false If true, damage will be randomized based on damage and speed
shoot_sound 字符串 The sound that plays when the projectile is shot
shoot_target 布尔值 true If true, the projectile will be shot towards the target of the entity firing it
should_bounce 布尔值 false If true, the projectile will bounce upon hit
splash_potion 布尔值 false If true, the projectile will be treated like a splash potion
splash_range 浮点数 4 Radius in blocks of the 'splash' effect
uncertainty_base 浮点数 0 The base accuracy. Accuracy is determined by the formula uncertaintyBase - difficultyLevel * uncertaintyMultiplier
uncertainty_multiplier 浮点数 0 Determines how much difficulty affects accuracy. Accuracy is determined by the formula uncertaintyBase - difficultyLevel * uncertaintyMultiplier
返回顶部

minecraft:pushable

Defines what can push an entity between other entities and pistons.

名称 类型 默认值 描述
is_pushable 布尔值 true Whether the entity can be pushed by other entities.
is_pushable_by_piston 布尔值 true Whether the entity can be pushed by pistons safely.
返回顶部

minecraft:raid_trigger

Attempts to trigger a raid at the entity's location.

名称 类型 默认值 描述
triggered_event 字符串 Event to run when a raid is triggered on the village.
返回顶部

minecraft:rail_movement

Defines the entity's movement on the rails. An entity with this component is only allowed to move on the rail.

名称 类型 默认值 描述
max_speed 浮点数 0.4 Maximum speed that this entity will move at when on the rail.
返回顶部

minecraft:rail_sensor

名称 类型 默认值 描述
check_block_types 布尔值 false If true, on tick this entity will trigger its on_deactivate behavior
eject_on_activate 布尔值 true If true, this entity will eject all of its riders when it passes over an activated rail
eject_on_deactivate 布尔值 false If true, this entity will eject all of its riders when it passes over a deactivated rail
on_activate 字符串 Event to call when the rail is activated
on_deactivate 字符串 Event to call when the rail is deactivated
tick_command_block_on_activate 布尔值 true If true, command blocks will start ticking when passing over an activated rail
tick_command_block_on_deactivate 布尔值 false If false, command blocks will stop ticking when passing over a deactivated rail
返回顶部

minecraft:ravager_blocked

Defines the ravager's response to their melee attack being blocked.

名称 类型 默认值 描述
knockback_strength 浮点数 3.0 The strength with which blocking entities should be knocked back
reaction_choices 列表 [ ] A list of weighted responses to the melee attack being blocked
返回顶部

minecraft:reflect_projectiles

[EXPERIMENTAL] Allows an entity to reflect projectiles.

名称 类型 默认值 描述
azimuth_angle Molang 0 [EXPERIMENTAL] A Molang expression defining the angle in degrees to add to the projectile's y axis rotation.
elevation_angle Molang 0 [EXPERIMENTAL] A Molang expression defining the angle in degrees to add to the projectile's x axis rotation.
reflected_projectiles 数组 [EXPERIMENTAL] An array of strings defining the types of projectiles that are reflected when they hit the entity.
reflection_scale Molang 1 [EXPERIMENTAL] A Molang expression defining the velocity scaling of the reflected projectile. Values below 1 decrease the projectile's velocity, and values above 1 increase it.
reflection_sound 字符串 reflect [EXPERIMENTAL] A string defining the name of the sound event to be played when a projectile is reflected. "reflect" unless specified.
返回顶部

minecraft:rideable

Determines whether this entity can be ridden. Allows specifying the different seat positions and quantity.

名称 类型 默认值 描述
controlling_seat 整数 0 The seat that designates the driver of the entity. This is only observed by the horse/boat styles of riding; minecarts/entities with "minecraft:controlled_by_player" give control to any player in any seat.
crouching_skip_interact 布尔值 true If true, this entity can't be interacted with if the entity interacting with it is crouching
family_types 列表 List of entities that can ride this entity
interact_text 字符串 The text to display when the player can interact with the entity when playing with Touch-screen controls
passenger_max_width 浮点数 0.00 The max width a mob can be to be a passenger. A value of 0 ignores this parameter.
priority 整数 0 This field may exist in old data but isn't used by minecraft:rideable.
pull_in_entities 布尔值 false If true, this entity will pull in entities that are in the correct family_types into any available seats
rider_can_interact 布尔值 false If true, this entity will be picked when looked at by the rider
seat_count 整数 1 The number of entities that can ride this entity at the same time
seats 列表 The list of positions and number of riders for each position for entities riding this entity
名称 类型 默认值 描述
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 Defines the maximum number of riders that can be riding this entity for this seat to be valid
min_rider_count 整数 0 Defines the minimum number of riders that need to be riding this entity before this seat can be used
position 向量 [a, b, c] [0, 0, 0] Position of this seat relative to this entity's position
rotate_rider_by Molang 0 Offset to rotate riders by
返回顶部

minecraft:scale_by_age

Defines the entity's size interpolation based on the entity's age.

名称 类型 默认值 描述
end_scale 浮点数 1 Ending scale of the entity when it's fully grown.
start_scale 浮点数 1 Initial scale of the newborn entity.
返回顶部

minecraft:scheduler

Fires off scheduled mob events at time of day events.

名称 类型 默认值 描述
scheduled_events 列表 The list of triggers that fire when the conditions match the given filter criteria. If any filter criteria overlap the first defined event will be picked.
返回顶部

minecraft:shareables

Defines a list of items the mob wants to share or pick up. Each item must have the following parameters:

名称 类型 默认值 描述
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 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.
返回顶部

pickup_only

Determines whether the mob can only pickup the item and not drop it.
返回顶部

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.
返回顶部
singular_pickup 布尔值 false Controls if the mob is able to pick up more of the same item if it is already holding that item
返回顶部

minecraft:shooter

Defines the entity's ranged attack behavior. The "minecraft:behavior.ranged_attack" goal uses this component to determine which projectiles to shoot.

名称 类型 默认值 描述
aux_val 整数 -1 ID of the Potion effect for the default projectile to be applied on hit.
def 字符串 Actor definition to use as the default projectile for the ranged attack. The actor definition must have the projectile component to be able to be shot as a projectile.
magic 布尔值 false Sets whether the projectiles being used are flagged as magic. If set, the ranged attack goal will not be used at the same time as other magic goals, such as minecraft:behavior.drink_potion
power 浮点数 0.00 Velocity in which the projectiles will be shot at. A power of 0 will be overwritten by the default projectile throw power.
projectiles 列表 List of projectiles that can be used by the shooter. Projectiles are evaluated in the order of the list; After a projectile is chosen, the rest of the list is ignored.
sound 字符串 Sound that is played when the shooter shoots a projectile.
返回顶部

minecraft:sittable

Defines the entity's 'sit' state.

名称 类型 默认值 描述
sit_event 字符串 Event to run when the entity enters the 'sit' state
stand_event 字符串 Event to run when the entity exits the 'sit' state
返回顶部

minecraft:spawn_entity

Adds a timer after which this entity will spawn another entity or item (similar to vanilla's chicken's egg-laying behavior).

名称 类型 默认值 描述
filters Minecraft 过滤器 If present, the specified entity will only spawn if the filter evaluates to true.
max_wait_time 整数 600 Maximum amount of time to randomly wait in seconds before another entity is spawned.
min_wait_time 整数 300 Minimum amount of time to randomly wait in seconds before another entity is spawned.
num_to_spawn 整数 1 The number of entities of this type to spawn each time that this triggers.
should_leash 布尔值 false If true, this the spawned entity will be leashed to the parent.
single_use 布尔值 false If true, this component will only ever spawn the specified entity once.
spawn_entity 字符串 Identifier of the entity to spawn, leave empty to spawn the item defined by "spawn_item" instead.
spawn_event 字符串 minecraft:entity_born Event to call on the spawned entity when it spawns.
spawn_item 字符串 egg Item identifier of the item to spawn.
spawn_item_event 触发器 Event to call on this entity when the item is spawned.
spawn_method 字符串 born Method to use to spawn the entity.
spawn_sound 字符串 plop Identifier of the sound effect to play when the entity is spawned.
返回顶部

minecraft:suspect_tracking

Allows this entity to remember suspicious locations
返回顶部

minecraft:tameable

Defines the rules for a mob to be tamed by the player.

名称 类型 默认值 描述
probability 浮点数 1 The chance of taming the entity with each item use between 0.0 and 1.0, where 1.0 is 100%
tame_event 字符串 Event to run when this entity becomes tamed
tame_items 列表 The list of items that can be used to tame this entity
返回顶部

minecraft:tamemount

Allows the Entity to be tamed by mounting it.

名称 类型 默认值 描述
attempt_temper_mod 整数 5 The amount the entity's temper will increase when mounted.
autoRejectItems JSON Object The list of items that, if carried while interacting with the entity, will anger it.
名称 类型 默认值 描述
item 字符串 Name of the item this entity dislikes and will cause it to get angry if used while untamed.
feed_items JSON Object The list of items that can be used to increase the entity's temper and speed up the taming process.
名称 类型 默认值 描述
item 字符串 Name of the item this entity likes and can be used to increase this entity's temper.
temper_mod 整数 0 The amount of temper this entity gains when fed this item.
feed_text 字符串 The text that shows in the feeding interact button.
max_temper 整数 100 The maximum value for the entity's random starting temper.
min_temper 整数 0 The minimum value for the entity's random starting temper.
ride_text 字符串 The text that shows in the riding interact button.
tame_event 字符串 Event that triggers when the entity becomes tamed.
返回顶部

minecraft:target_nearby_sensor

Defines the entity's range within which it can see or sense other entities to target them.

名称 类型 默认值 描述
inside_range 浮点数 1 Maximum distance in blocks that another entity will be considered in the 'inside' range
must_see 布尔值 false Whether the other entity needs to be visible to trigger 'inside' events
on_inside_range 字符串 Event to call when an entity gets in the inside range. Can specify 'event' for the name of the event and 'target' for the target of the event
on_outside_range 字符串 Event to call when an entity gets in the outside range. Can specify 'event' for the name of the event and 'target' for the target of the event
on_vision_lost_inside_range 字符串 Event to call when an entity exits visual range. Can specify 'event' for the name of the event and 'target' for the target of the event
outside_range 浮点数 5 Maximum distance in blocks that another entity will be considered in the 'outside' range
返回顶部

minecraft:teleport

Defines an entity's teleporting behavior.

名称 类型 默认值 描述
dark_teleport_chance 浮点数 0.01 Modifies the chance that the entity will teleport if the entity is in darkness
light_teleport_chance 浮点数 0.01 Modifies the chance that the entity will teleport if the entity is in daylight
max_random_teleport_time 浮点数 20 Maximum amount of time in seconds between random teleports
min_random_teleport_time 浮点数 0 Minimum amount of time in seconds between random teleports
random_teleport_cube 向量 [a, b, c] [32, 16, 32] Entity will teleport to a random position within the area defined by this cube
random_teleports 布尔值 true If true, the entity will teleport randomly
target_distance 浮点数 16 Maximum distance the entity will teleport when chasing a target
target_teleport_chance 浮点数 1 The chance that the entity will teleport between 0.0 and 1.0. 1.0 means 100%
返回顶部

minecraft:tick_world

Defines if the entity ticks the world and the radius around it to tick.

名称 类型 默认值 描述
distance_to_players 浮点数 128 The distance at which the closest player has to be before this entity despawns. This option will be ignored if never_despawn is true. Min: 128 blocks.
never_despawn 布尔值 true If true, this entity will not despawn even if players are far away. If false, distance_to_players will be used to determine when to despawn.
radius Positive Integer 2 The area around the entity to tick. Default: 2. Allowed range: 2-6.
返回顶部

minecraft:timer

Adds a timer after which an event will fire.

名称 类型 默认值 描述
looping 布尔值 true If true, the timer will restart every time after it fires.
randomInterval 布尔值 true If true, the amount of time on the timer will be random between the min and max values specified in time.
random_time_choices 列表 [ ] This is a list of objects, representing one value in seconds that can be picked before firing the event and an optional weight. Incompatible with time.
time 范围 [a, b] [0.0, 0.0] Amount of time in seconds for the timer. Can be specified as a number or a pair of numbers (min and max). Incompatible with random_time_choices.
time_down_event 字符串 Event to fire when the time on the timer runs out.
返回顶部

minecraft:trade_table

Defines this entity's ability to trade with players.

名称 类型 默认值 描述
convert_trades_economy 布尔值 false Determines when the mob transforms, if the trades should be converted when the new mob has a economy_trade_table. When the trades are converted, the mob will generate a new trade list with their new trade table, but then it will try to convert any of the same trades over to have the same enchantments and user data. For example, if the original has a Emerald to Enchanted Iron Sword (Sharpness 1), and the new trade also has an Emerald for Enchanted Iron Sword, then the enchantment will be Sharpness 1.
display_name 字符串 Name to be displayed while trading with this entity.
new_screen 布尔值 false Used to determine if trading with entity opens the new trade screen.
persist_trades 布尔值 false Determines if the trades should persist when the mob transforms. This makes it so that the next time the mob is transformed to something with a trade_table or economy_trade_table, then it keeps their trades.
table 字符串 File path relative to the behavior pack root for this entity's trades.
返回顶部

minecraft:trail

Causes an entity to leave a trail of blocks as it moves about the world.

名称 类型 默认值 描述
block_type 字符串 air The type of block you wish to be spawned by the entity as it move about the world. Solid blocks may not be spawned at an offset of (0,0,0).
spawn_filter Minecraft 过滤器 One or more conditions that must be met in order to cause the chosen block type to spawn.
spawn_offset 向量 [a, b, c] [0, 0, 0] The distance from the entities current position to spawn the block. Capped at up to 16 blocks away. The X value is left/right(-/+), the Z value is backward/forward(-/+), the Y value is below/above(-/+).
返回顶部

minecraft:transformation

Defines an entity's transformation from the current definition into another

名称 类型 默认值 描述
add JSON Object List of components to add to the entity after the transformation
名称 类型 默认值 描述
component_groups 列表 Names of component groups to add
begin_transform_sound 字符串 Sound to play when the transformation starts
delay JSON Object Defines the properties of the delay for the transformation
名称 类型 默认值 描述
block_assist_chance 浮点数 0 Chance that the entity will look for nearby blocks that can speed up the transformation. Value must be between 0.0 and 1.0
block_chance 浮点数 0 Chance that, once a block is found, will help speed up the transformation
block_max 整数 0 Maximum number of blocks the entity will look for to aid in the transformation. If not defined or set to 0, it will be set to the block radius
block_radius 整数 0 Distance in Blocks that the entity will search for blocks that can help the transformation
block_types 列表 List of blocks that can help the transformation of this entity
range_max 浮点数 0 Time in seconds to be added to value to have the maximum random time range value until the entity transforms (if non-zero then the time in seconds before the entity transforms will be random between value+range_min and value+range_max)
range_min 浮点数 0 Time in seconds to be added to value to have the minimum random time range value until the entity transforms (if non-zero then the time in seconds before the entity transforms will be random between value+range_min and value+range_max)
value 浮点数 0 Time in seconds before the entity transforms
drop_equipment 布尔值 false Cause the entity to drop all equipment upon transformation
drop_inventory 布尔值 false Cause the entity to drop all items in inventory upon transformation
into 字符串 Entity Definition that this entity will transform into
keep_level 布尔值 false If this entity has trades and has leveled up, it should maintain that level after transformation.
keep_owner 布尔值 false If this entity is owned by another entity, it should remain owned after transformation.
preserve_equipment 布尔值 false Cause the entity to keep equipment after going through transformation
transformation_sound 字符串 Sound to play when the entity is done transforming
返回顶部

minecraft:transient

An entity with this component will NEVER persist, and forever disappear when unloaded.
返回顶部

minecraft:trusting

Defines the rules for a mob to trust players.

名称 类型 默认值 描述
probability 浮点数 1.00 The chance of the entity trusting with each item use between 0.0 and 1.0, where 1.0 is 100%.
trust_event 字符串 Event to run when this entity becomes trusting.
trust_items 列表 The list of items that can be used to get the entity to trust players.
返回顶部

minecraft:variable_max_auto_step

Entities with this component will have a maximum auto step height that is different depending on whether they are on a block that prevents jumping. Incompatible with "runtime_identifier": "minecraft:horse".

名称 类型 默认值 描述
base_value 浮点数 0.5625 The maximum auto step height when on any other block.
controlled_value 浮点数 0.5625 The maximum auto step height when on any other block and controlled by the player.
jump_prevented_value 浮点数 0.5625 The maximum auto step height when on a block that prevents jumping.
返回顶部

minecraft:vibration_damper

Vibrations emitted by this entity will be ignored.
返回顶部

minecraft:water_movement

名称 类型 默认值 描述
drag_factor 浮点数 0.8 Drag factor to determine movement speed when in water.
返回顶部



Entity Definition Properties

These properties are part of the Entity Definition as a whole and go before the Component or Component Groups. Make sure to place them before any Components, Component Groups or Events sections or they will be ignored.

format_version

Specifies the version of the game this entity was made in. If the version is lower than the current version, any changes made to the entity in the vanilla version will be applied to it.
返回顶部

Code Example

Example



Entity Description Properties

This section defines properties required to identify and construct the entity

Entity Description Properties

identifier

Sets the name for this entity's description.

类型 默认值 描述
字符串 The identifier for this entity
返回顶部

is_spawnable

Sets whether or not this entity has a spawn egg in the creative ui.

类型 默认值 描述
布尔值 false Set to determine if this entity has a spawn egg.
返回顶部

is_summonable

Sets whether or not we can summon this entity using commands such as /summon.

类型 默认值 描述
布尔值 false Flag to mark this entity as being summonable or not.
返回顶部

runtime_identifier

Sets the name for the Vanilla Minecraft identifier this entity will use to build itself from.

类型 默认值 描述
字符串 The identifier for the class to construct this entity with
返回顶部

spawn_category

Sets the Spawn Category type of this entity. This entity will spawn with the rest of this Spawn Category type.

类型 默认值 描述
字符串 The Spawn Category type of this entity, used to spawn the entity.
返回顶部



animations

Sets the mapping of internal animation references to actual animations. This is a JSON Object of name/animation pairs

名称 类型 默认值 描述
animation 字符串 none Actual animation to use
name 字符串 none Internal (to the entity) name of this animation entry
返回顶部

scripts

Sets the mapping of internal animation controller references to actual animation controller. This is a JSON Array of name/animation-controller pairs

名称 类型 默认值 描述
animation controller 字符串 none Actual animation to use
name 字符串 none Internal (to the entity) name of this animation entry
返回顶部



ID Lists

AI Goals

JSON Name ID
minecraft:behavior.admire_item 1024844406
minecraft:behavior.avoid_block 2854732834617046989
minecraft:behavior.avoid_mob_type 12990492194774829831
minecraft:behavior.barter 536670686
minecraft:behavior.beg 1346418048
minecraft:behavior.break_door -1798237626
minecraft:behavior.breed 51166360
minecraft:behavior.celebrate 3133100024050825239
minecraft:behavior.celebrate_survive 9921563176146616642
minecraft:behavior.charge_attack 16313004636962889255
minecraft:behavior.charge_held_item 9534738104831396526
minecraft:behavior.circle_around_anchor 6362218630635387278
minecraft:behavior.controlled_by_player 17455778614872480612
minecraft:behavior.croak 13695866816529218596
minecraft:behavior.defend_trusted_target 2070046390
minecraft:behavior.defend_village_target 5237560637228864639
minecraft:behavior.delayed_attack 16686103324935382281
minecraft:behavior.dig 18229463342171064186
minecraft:behavior.door_interact -286762735
minecraft:behavior.dragonchargeplayer 3000393824704693780
minecraft:behavior.dragondeath -1541162059
minecraft:behavior.dragonflaming 17923055218634571091
minecraft:behavior.dragonholdingpattern 1066617362
minecraft:behavior.dragonlanding -152352492
minecraft:behavior.dragonscanning -1003941066
minecraft:behavior.dragonstrafeplayer 18364378208758607551
minecraft:behavior.dragontakeoff -1912535317
minecraft:behavior.drink_milk 14686590835698253470
minecraft:behavior.drink_potion 277029334
minecraft:behavior.drop_item_for 6288016308568137423
minecraft:behavior.eat_block 13717849383294281770
minecraft:behavior.eat_carried_item -184757575
minecraft:behavior.eat_mob 6189417788331940525
minecraft:behavior.emerge 12499259831953635711
minecraft:behavior.enderman_leave_block -717580550
minecraft:behavior.enderman_take_block -537294220
minecraft:behavior.equip_item 13771509599928214056
minecraft:behavior.explore_outskirts 1573426610843290210
minecraft:behavior.fertilize_farm_block 9206289212958280677
minecraft:behavior.find_cover -1231227755
minecraft:behavior.find_mount 731306871
minecraft:behavior.find_underwater_treasure -1602192311
minecraft:behavior.fire_at_target 15552728018745447502
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_and_give_items_to_noteblock 4654150191236239757
minecraft:behavior.go_and_give_items_to_owner 12205890323878762703
minecraft:behavior.go_home 16188843613883396158
minecraft:behavior.guardian_attack 10035257602683297598
minecraft:behavior.harvest_farm_block 10346419677401805698
minecraft:behavior.hide -1101331718
minecraft:behavior.hold_ground 1804286487
minecraft:behavior.hurt_by_target -1710404297
minecraft:behavior.inspect_bookshelf 40191182
minecraft:behavior.investigate_suspicious_location 17828766620487298865
minecraft:behavior.jump_around_target 11795366379540415834
minecraft:behavior.jump_to_block 9920654059703051752
minecraft:behavior.knockback_roar 10556128811593022910
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.melee_attack 11509785650956819759
minecraft:behavior.melee_box_attack 16943510645914782909
minecraft:behavior.mingle 385775952
minecraft:behavior.mount_pathing 1112137677
minecraft:behavior.move_around_target 12172580866581071579
minecraft:behavior.move_indoors 15759011189030877060
minecraft:behavior.move_outdoors 13363481534821336549
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_dwelling_restriction 4996579375027897212
minecraft:behavior.move_towards_home_restriction 6619321617752047371
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.ocelotattack 6119969836310458450
minecraft:behavior.offer_flower 14523794672066366898
minecraft:behavior.open_door -906200433
minecraft:behavior.owner_hurt_by_target 530667419
minecraft:behavior.owner_hurt_target 995655261
minecraft:behavior.panic -169886247
minecraft:behavior.pet_sleep_with_owner 1379392240
minecraft:behavior.pickup_items 644287189
minecraft:behavior.play 9028661884418335188
minecraft:behavior.play_dead 15611122012431414539
minecraft:behavior.player_ride_tamed 603869698
minecraft:behavior.raid_garden -1145687602
minecraft:behavior.ram_attack 16987281751541937759
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_search_and_dig 9274891347700307903
minecraft:behavior.random_sitting 1722716662
minecraft:behavior.random_stroll -1643504294
minecraft:behavior.random_swim -1465281278
minecraft:behavior.ranged_attack 17427060681688556526
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.roar 8169564995138049594
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 9939462702916185623
minecraft:behavior.slime_float 3498887529883213515
minecraft:behavior.slime_keep_on_jumping 9635607836508236313
minecraft:behavior.slime_random_direction 16233644158771707634
minecraft:behavior.snacking 875141064
minecraft:behavior.sneeze 1528584076
minecraft:behavior.sniff 2518751594793034670
minecraft:behavior.sonic_boom 3140959826915046776
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_near_noteblock 10537868669633006624
minecraft:behavior.stay_while_sitting 1346980478
minecraft:behavior.stomp_attack 2494714009520253728
minecraft:behavior.stomp_turtle_egg 851839416
minecraft:behavior.stroll_towards_village -1563831906
minecraft:behavior.summon_entity -2005850647
minecraft:behavior.swell -1473132493
minecraft:behavior.swim_idle 6562850329755828441
minecraft:behavior.swim_up_for_breath 6795851152810947053
minecraft:behavior.swim_wander 12378924708543723854
minecraft:behavior.swim_with_entity 10204691344094313319
minecraft:behavior.swoop_attack 7451467701814397451
minecraft:behavior.take_flower 16066043784359778497
minecraft:behavior.teleport_to_owner 1980014114121577323
minecraft:behavior.tempt 422904556
minecraft:behavior.timer_flag_1 9107193206350859182
minecraft:behavior.timer_flag_2 9107192106839230971
minecraft:behavior.timer_flag_3 9107191007327602760
minecraft:behavior.trade_interest -574851053
minecraft:behavior.trade_with_player 13082946109325010651
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 11642413332579264431
minecraft:behavior.work_composter 8770872254111982548
返回顶部

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:anger_level 500775548
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:can_join_raid -1847990870
minecraft:celebrate_hunt -789611239
minecraft:collision_box -1277663508
minecraft:combat_regeneration -315365016
minecraft:conditional_bandwidth_optimization 1333085468
minecraft:custom_hit_test 2035968892
minecraft:damage_over_time -656420526
minecraft:damage_sensor -82616534
minecraft:dash -51257122
minecraft:despawn 1674909940
minecraft:dimension_bound -1843592159
minecraft:drying_out_timer 2113510784
minecraft:economy_trade_table 1705466896
minecraft:entity_armor_equipment_slot_mapping 388041038
minecraft:entity_sensor -406052184
minecraft:environment_sensor 687748970
minecraft:equip_item -1774220620
minecraft:equippable -1164142226
minecraft:exhaustion_values 1522147793
minecraft:experience_reward -1992597900
minecraft:explode -1683058581
minecraft:flocking 1967597361
minecraft:game_event_movement_tracking 763815151
minecraft:genetics -82484670
minecraft:giveable 1739199795
minecraft:group_size -1997375941
minecraft:grows_crop 43636353
minecraft:healable -54247424
minecraft:heartbeat 2102942906
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:looked_at -1189178052
minecraft:managed_wandering_trader 846609640
minecraft:mob_effect 490430596
minecraft:mob_effect_immunity 1589547531
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:reflect_projectiles -2073986952
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:suspect_tracking 690744457
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:transient -413020544
minecraft:trusting 936499892
minecraft:variable_max_auto_step -368684982
minecraft:vibration_damper 1836172792
minecraft:vibration_listener 1844567337
minecraft:water_movement -128701925
返回顶部

Entity Description Properties

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

Properties

JSON Name ID
minecraft:ambient_sound_interval -1314051310
minecraft:body_rotation_blocked -31742338
minecraft:can_climb -550459594
minecraft:can_fly 985724318
minecraft:can_power_jump -763124853
minecraft:cannot_be_attacked 1363084217
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:ignore_cannot_be_attacked 2139692418
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_pregnant -1253700046
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:movement_sound_distance_offset 124679519
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

Sets the entity's delay between playing its ambient sound.

名称 类型 默认值 描述
event_name 字符串 ambient Level sound event to be played as the ambient sound.
event_names 数组 List of dynamic level sound events, with conditions for choosing between them. Evaluated in order, first one wins. If none evaluate to true, 'event_name' will take precedence.

condition

The condition that must be satisfied to select the given ambient sound
返回顶部

event_name

Level sound event to be played as the ambient sound
返回顶部
range 浮点数 16.000000 Maximum time in seconds to randomly add to the ambient sound delay time.
value 浮点数 8.000000 Minimum time in seconds before the entity plays its ambient sound again.
返回顶部

minecraft:body_rotation_blocked

When set, the entity will no longer visually rotate their body to match their facing direction.
返回顶部

minecraft:can_climb

Allows this entity to climb up ladders.
返回顶部

minecraft:can_fly

Marks the entity as being able to fly, the pathfinder won't be restricted to paths where a solid block is required underneath it.
返回顶部

minecraft:can_power_jump

Allows the entity to power jump like the horse does in vanilla.
返回顶部

minecraft:cannot_be_attacked

When set, blocks entities from attacking the owner entity unless they have the "minecraft:ignore_cannot_be_attacked" component.
返回顶部

minecraft:color

Defines the entity's color. Only works on vanilla entities that have predefined color values (sheep, llama, shulker).

名称 类型 默认值 描述
value 整数 0 The Palette Color value of the entity.
返回顶部

minecraft:color2

Defines the entity's second texture color. Only works on vanilla entities that have a second predefined color values (tropical fish).

名称 类型 默认值 描述
value 整数 0 The second Palette Color value of the entity.
返回顶部

minecraft:default_look_angle

Sets this entity's default head rotation angle.

名称 类型 默认值 描述
value 浮点数 0.0f Angle in degrees.
返回顶部

minecraft:equipment

Sets the Equipment table to use for this Entity.

名称 类型 默认值 描述
slot_drop_chance 列表 A list of slots with the chance to drop an equipped item from that slot.
table 字符串 The file path to the equipment table, relative to the behavior pack's root.
返回顶部

minecraft:fire_immune

Sets that this entity doesn't take damage from fire.
返回顶部

minecraft:floats_in_liquid

Sets that this entity can float in liquid blocks.
返回顶部

minecraft:flying_speed

Speed in Blocks that this entity flies at.

名称 类型 默认值 描述
value 浮点数 0.02 Flying speed in blocks per tick.
返回顶部

minecraft:friction_modifier

Defines how much friction affects this entity.

名称 类型 默认值 描述
value 浮点数 1.0 The higher the number, the more the friction affects this entity. A value of 1.0 means regular friction, while 2.0 means twice as much.
返回顶部

minecraft:ground_offset

Sets the offset from the ground that the entity is actually at.

名称 类型 默认值 描述
value 浮点数 0.0 The value of the entity's offset from the terrain, in blocks.
返回顶部

minecraft:ignore_cannot_be_attacked

When set, blocks entities from attacking the owner entity unless they have the "minecraft:ignore_cannot_be_attacked" component.

名称 类型 默认值 描述
filters Minecraft 过滤器 Defines which entities are exceptions and are allowed to be attacked by the owner entity, potentially attacked entity is subject "other". If this is not specified then all attacks by the owner are allowed.
返回顶部

minecraft:input_ground_controlled

When configured as a rideable entity, the entity will be controlled using WASD controls. Beginning with 1.19.50 the default auto step height for rideable entities is half a block. Consider adding the `variable_max_auto_step` component to increase it.
返回顶部

minecraft:is_baby

Sets that this entity is a baby.
返回顶部

minecraft:is_charged

Sets that this entity is charged.
返回顶部

minecraft:is_chested

Sets that this entity is currently carrying a chest.
返回顶部

minecraft:is_dyeable

Allows dyes to be used on this entity to change its color.

名称 类型 默认值 描述
interact_text 字符串 The text that will display when interacting with this entity with a dye when playing with Touch-screen controls.
返回顶部

minecraft:is_hidden_when_invisible

Sets that this entity can hide from hostile mobs while invisible.
返回顶部

minecraft:is_ignited

Sets that this entity is currently on fire.
返回顶部

minecraft:is_illager_captain

Sets that this entity is an illager captain.
返回顶部

minecraft:is_pregnant

Sets that this entity is currently pregnant.
返回顶部

minecraft:is_saddled

Sets that this entity is currently saddled.
返回顶部

minecraft:is_shaking

Sets that this entity is currently shaking.
返回顶部

minecraft:is_sheared

Sets that this entity is currently sheared.
返回顶部

minecraft:is_stackable

Sets that this entity can be stacked.
返回顶部

minecraft:is_stunned

Sets that this entity is currently stunned.
返回顶部

minecraft:is_tamed

Sets that this entity is currently tamed.
返回顶部

minecraft:item_controllable

Defines what items can be used to control this entity while ridden.

名称 类型 默认值 描述
control_items 列表 List of items that can be used to control this entity.
返回顶部

minecraft:loot

Sets the loot table for what items this entity drops upon death.

名称 类型 默认值 描述
table 字符串 The path to the loot table, relative to the Behavior Pack's root.
返回顶部

minecraft:mark_variant

Additional variant value. Can be used to further differentiate variants.

名称 类型 默认值 描述
value 整数 0 The ID of the variant. By convention, 0 is the ID of the base entity.
返回顶部

minecraft:movement_sound_distance_offset

Sets the offset used to determine the next step distance for playing a movement sound.

名称 类型 默认值 描述
value 浮点数 1.0 The higher the number, the less often the movement sound will be played.
返回顶部

minecraft:push_through

Sets the distance through which the entity can push through.

名称 类型 默认值 描述
value 浮点数 0.0 The value of the entity's push-through, in blocks.
返回顶部

minecraft:scale

Sets the entity's visual size.

名称 类型 默认值 描述
value 浮点数 1.0 The value of the scale. 1.0 means the entity will appear at the scale they are defined in their model. Higher numbers make the entity bigger.
返回顶部

minecraft:skin_id

Skin ID value. Can be used to differentiate skins, such as base skins for villagers.

名称 类型 默认值 描述
value 整数 0 The ID of the skin. By convention, 0 is the ID of the base skin.
返回顶部

minecraft:sound_volume

Sets the entity's base volume for sound effects.

名称 类型 默认值 描述
value 浮点数 1.0 The value of the volume the entity uses for sound effects.
返回顶部

minecraft:type_family

Defines the families this entity belongs to.

名称 类型 默认值 描述
family 列表 List of family names.
返回顶部

minecraft:variant

Used to differentiate the component group of a variant of an entity from others. (e.g. ocelot, villager)

名称 类型 默认值 描述
value 整数 0 The ID of the variant. By convention, 0 is the ID of the base entity.
返回顶部

minecraft:walk_animation_speed

Sets the speed multiplier for this entity's walk animation speed.

名称 类型 默认值 描述
value 浮点数 1.0 The higher the number, the faster the animation for walking plays. A value of 1.0 means normal speed, while 2.0 means twice as fast.
返回顶部

minecraft:wants_jockey

Sets that this entity wants to become a jockey.
返回顶部



Triggers

minecraft:on_death

Only usable by the Ender Dragon. Adds a trigger to call on this entity's death.

名称 类型 默认值 描述
event 字符串 The event to run when the conditions for this trigger are met.
filters Minecraft 过滤器 The list of conditions for this trigger to execute.
target 字符串 self The target of the event.
返回顶部

minecraft:on_friendly_anger

Adds a trigger that will run when a nearby entity of the same type as this entity becomes Angry.

名称 类型 默认值 描述
event 字符串 The event to run when the conditions for this trigger are met.
filters Minecraft 过滤器 The list of conditions for this trigger to execute.
target 字符串 self The target of the event.
返回顶部

minecraft:on_hurt

Adds a trigger to call when this entity takes damage.

名称 类型 默认值 描述
event 字符串 The event to run when the conditions for this trigger are met.
filters Minecraft 过滤器 The list of conditions for this trigger to execute.
target 字符串 self The target of the event.
返回顶部

minecraft:on_hurt_by_player

Adds a trigger to call when this entity is attacked by the player.

名称 类型 默认值 描述
event 字符串 The event to run when the conditions for this trigger are met.
filters Minecraft 过滤器 The list of conditions for this trigger to execute.
target 字符串 self The target of the event.
返回顶部

minecraft:on_ignite

Adds a trigger to call when this entity is set on fire.

名称 类型 默认值 描述
event 字符串 The event to run when the conditions for this trigger are met.
filters Minecraft 过滤器 The list of conditions for this trigger to execute.
target 字符串 self The target of the event.
返回顶部

minecraft:on_start_landing

Only usable by the Ender Dragon. Adds a trigger to call when this entity lands.

名称 类型 默认值 描述
event 字符串 The event to run when the conditions for this trigger are met.
filters Minecraft 过滤器 The list of conditions for this trigger to execute.
target 字符串 self The target of the event.
返回顶部

minecraft:on_start_takeoff

Only usable by the Ender Dragon. Adds a trigger to call when this entity starts flying.

名称 类型 默认值 描述
event 字符串 The event to run when the conditions for this trigger are met.
filters Minecraft 过滤器 The list of conditions for this trigger to execute.
target 字符串 self The target of the event.
返回顶部

minecraft:on_target_acquired

Adds a trigger to call when this entity finds a target.

名称 类型 默认值 描述
event 字符串 The event to run when the conditions for this trigger are met.
filters Minecraft 过滤器 The list of conditions for this trigger to execute.
target 字符串 self The target of the event.
返回顶部

minecraft:on_target_escape

Adds a trigger to call when this entity loses the target it currently has.

名称 类型 默认值 描述
event 字符串 The event to run when the conditions for this trigger are met.
filters Minecraft 过滤器 The list of conditions for this trigger to execute.
target 字符串 self The target of the event.
返回顶部

minecraft:on_wake_with_owner

Adds a trigger to call when this pet's owner awakes after sleeping with the pet.

名称 类型 默认值 描述
event 字符串 The event to run when the conditions for this trigger are met.
filters Minecraft 过滤器 The list of conditions for this trigger to execute.
target 字符串 self The target of the event.
返回顶部