跳到主要内容

基础属性组件

全体实体通用的组件。在定义实体的时候,多数情况下都需要这些组件,并且在编写实体时应当优先考虑这些组件。

minecraft:collision_box​

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

定义实体的碰撞箱。

  • minecraft:collision_box 数据类型图标minecraft:collision_box
    JSON 对象
    :根对象。
    • height 数据类型图标height
      浮点数
      :实体的碰撞箱高度。默认值为1。
    • width 数据类型图标width
      浮点数
      :实体的碰撞箱宽度。默认值为1。

minecraft:health​

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

定义实体的生命值。1 颗心等于 2 点生命值。

另见:EntityHealthComponent 类。

  • minecraft:health 数据类型图标minecraft:health
    JSON 对象
    :根对象。
    • value 数据类型图标value
      整数
      :(写法 1)实体的血量。默认值为20。
    • value 数据类型图标value
      JSON 对象
      :(写法 2)实体的血量范围。
      • range_min 数据类型图标range_min
        整数
        :血量的最小值。
      • range_max 数据类型图标range_max
        整数
        :血量的最大值。
    • max 数据类型图标max
      整数
      :实体的最大血量。默认值为20。

minecraft:physics​

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

定义实体的物理属性,是否应该具有碰撞或重力。

  • minecraft:physics 数据类型图标minecraft:physics
    JSON 对象
    :根对象。
    • has_collision 数据类型图标has_collision
      布尔值
      :实体是否和世界中的其他方块/实体有碰撞。默认值为true。
    • has_gravity 数据类型图标has_gravity
      布尔值
      :实体是否有重力。默认值为true。
    • push_towards_closest_space 数据类型图标push_towards_closest_space
      布尔值
      :1.19.60+
      该特性在游戏版本1.19.60+下可用。
      在被方块卡住后,实体是否应该被挤压到最近的开放区域。默认值为false。

minecraft:pushable_by_block​

通用
该特性在中国版和国际版均可用。
26.10+
该特性在游戏版本26.10+下可用,但该版本对于当前的中国版版本过高。在更旧的版本下使用minecraft:pushable组件。

定义实体可被活塞或潜影盒推动。

  • minecraft:pushable_by_block 数据类型图标minecraft:pushable_by_block
    JSON 对象
    :根对象,不含任何参数。

minecraft:pushable_by_entity​

通用
该特性在中国版和国际版均可用。
26.10+
该特性在游戏版本26.10+下可用,但该版本对于当前的中国版版本过高。在更旧的版本下使用minecraft:pushable组件。

定义实体可被其他实体推动。

  • minecraft:pushable_by_entity 数据类型图标minecraft:pushable_by_entity
    JSON 对象
    :根对象。
    • presets 数据类型图标presets
      JSON 数组
      :26.30+
      该特性在游戏版本26.30+下可用,但该版本对于当前的中国版版本过高。
      定义特殊实体的推动行为。
      • object 数据类型图标
        JSON 对象
        :一项预设。
        • filters 数据类型图标filters
          JSON 对象
          :实体过滤器。定义该实体应满足的条件。见实体过滤器。
        • push_mode 数据类型图标push_mode
          字符串
          :推动模式。可选值为:
          可选值描述
          none无法推动此实体。
          default(默认值)多数实体采用的标准推动行为。
          legacy_boat继承船的推动行为,包括阻尼力和潜行抵消行为。见船 - 中文 Minecraft Wiki。
          legacy_minecart继承矿车的推动行为,包括基于对齐的碰撞处理和速度平均行为。见矿车 - 中文 Minecraft Wiki。
          ball类似于踢球的推动行为,实体会向推动者运动的方向运动,受力与推动者的速度成正比。见硫方怪 - 中文 Minecraft Wiki。
        • strength_multiplier 数据类型图标strength_multiplier
          浮点数
          :施加给实体推力的乘数。更大的乘数意味着更大的推力。默认值为0.05。
        • min_distance 数据类型图标min_distance
          浮点数
          :要施加推力的实体之间的最小距离。距离更小则不会相互推动。默认值为0.01。
        • max_distance 数据类型图标max_distance
          浮点数
          :要施加推力的实体之间的最大距离。距离更大则不会相互推动。默认值为3.4e38。
        • push_scale_self 数据类型图标push_scale_self
          浮点数
          :发生碰撞时推动自身的推力乘数。更大的乘数意味着对自身的推力越大。默认值为1。
        • push_scale_other 数据类型图标push_scale_other
          浮点数
          :发生碰撞时推动其他实体的推力乘数。更大的乘数意味着对其他实体的推力越大。默认值为1。
        • play_sound 数据类型图标play_sound
          布尔值
          :是否要播放pushed_by_player音效。默认值为false。
        • play_sound_cooldown_in_seconds 数据类型图标play_sound_cooldown_in_seconds
          浮点数
          :声音之间的冷却时间,数字越小,声音越多。单位:秒。默认值为0.2。
        • play_sound_impulse_threshold 数据类型图标play_sound_impulse_threshold
          浮点数
          :触发推动音效所需的最小速度变化,值越低,灵敏度越高。默认值为0.2。
        • kick_speed_scale 数据类型图标kick_speed_scale
          浮点数
          :限定参数
          仅当push_mode为ball时可用。
          踢球速度乘数,推力会随着速度的增加而增加。乘数越大则推力越大。默认值为2。
        • min_kick_speed 数据类型图标min_kick_speed
          浮点数
          :限定参数
          仅当push_mode为ball时可用。
          最小踢球速度,实体将被击退的最小速度。默认值为0.0。
        • max_kick_speed 数据类型图标max_kick_speed
          浮点数
          :限定参数
          仅当push_mode为ball时可用。
          最大踢球速度,实体将被击退的最大速度。默认值为0.5。
        • vertical_kick_multiplier 数据类型图标vertical_kick_multiplier
          浮点数
          :限定参数
          仅当push_mode为ball时可用。
          当物体在地面上被推动时,向上施加的力的乘数。为0时则使实体保持在地面上。默认值为0.3。
        • require_collision_overlap 数据类型图标require_collision_overlap
          浮点数
          :26.40+
          该特性在游戏版本26.40+下可用,但该版本对于当前的中国版版本过高。
          是否需要碰撞箱重叠才能推动。默认值为true。1.26.40起未写时按true处理,更早的格式版本则按false处理。

minecraft:type_family​

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

定义实体所属的家族类型。家族类型可用于在过滤器中、命令中或其他游戏系统进行分类判断(例如:mob、monster、undead、zombie等)。

另见:EntityTypeFamilyComponent 类。

  • minecraft:type_family 数据类型图标minecraft:type_family
    JSON 对象
    :根对象。
    • family 数据类型图标family
      JSON 数组
      :定义实体的家族类型。
      • string 数据类型图标
        字符串
        :家族名。

备注:通常会在数组中定义一个与实体自身 ID 相同的家族名。原版常见的家族名有mob、inanimate、aquatic、monster、undead、skeleton、arthropod、zombie、lightweight、fish、player,也可以自定义。


minecraft:conditional_bandwidth_optimization​

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

定义实体的带宽优化策略,用于减少位置同步包的数量。

  • minecraft:conditional_bandwidth_optimization 数据类型图标minecraft:conditional_bandwidth_optimization
    JSON 对象
    :根对象。
    • default_values 数据类型图标default_values
      JSON 对象
      :默认策略。下列三个字段同样适用于conditional_values中的每一项。
      • max_dropped_ticks 数据类型图标max_dropped_ticks
        整数
        :最多可连续多少刻不发送位置同步包。
      • max_optimized_distance 数据类型图标max_optimized_distance
        浮点数
        :参与优化的最大距离,超过该距离按最大优化处理。
      • use_motion_prediction_hints 数据类型图标use_motion_prediction_hints
        布尔值
        :为true时在丢包区间内发送更小的运动预测包,适合高速移动或传送的实体。
    • conditional_values 数据类型图标conditional_values
      JSON 数组
      :按条件覆盖默认策略,取第一条条件成立者。
      • object 数据类型图标
        JSON 对象
        :一项。
        • filters 数据类型图标filters
          JSON 对象
          :条件。见实体过滤器。
        • max_dropped_ticks 数据类型图标max_dropped_ticks
          整数
          :最多可连续多少刻不发送位置同步包。
        • max_optimized_distance 数据类型图标max_optimized_distance
          浮点数
          :参与优化的最大距离。
        • use_motion_prediction_hints 数据类型图标use_motion_prediction_hints
          布尔值
          :是否发送更小的运动预测包。

minecraft:nameable​

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

允许该实体被命名,例如使用命名牌。

  • minecraft:nameable 数据类型图标minecraft:nameable
    JSON 对象
    :根对象。
    • allow_name_tag_renaming 数据类型图标allow_name_tag_renaming
      布尔值
      :是否允许用命名牌再次改名。默认值为true。
    • allowNameTagRenaming 数据类型图标allowNameTagRenaming
      布尔值
      :已弃用:1.2.0-1.13.0
      该特性已被弃用,只能在游戏版本1.2.0-1.13.0下使用。
      是否允许用命名牌再次改名(旧拼写)。默认值为true。
    • always_show 数据类型图标always_show
      布尔值
      :名字是否始终显示。默认值为false。
    • alwaysShow 数据类型图标alwaysShow
      布尔值
      :已弃用:1.2.0-1.13.0
      该特性已被弃用,只能在游戏版本1.2.0-1.13.0下使用。
      名字是否始终显示(旧拼写)。默认值为false。
    • default_trigger 数据类型图标default_trigger
      JSON 对象
      :实体被命名时触发的默认事件。
      • event 数据类型图标event
        字符串
        :事件 ID。
      • target 数据类型图标target
        字符串
        :事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
    • name_actions 数据类型图标name_actions
      JSON 数组
      :特殊名字与对应事件的列表。
      • object 数据类型图标
        JSON 对象
        :一项。
        • name_filter 数据类型图标name_filter
          字符串
          :触发该事件的名字。
        • on_named 数据类型图标on_named
          JSON 对象
          :取到该名字时触发的事件,结构同default_trigger。

备注:官方文档把name_filter、on_named列为根字段,原版则收在name_actions数组内,此处按原版结构书写。


minecraft:is_hidden_when_invisible​

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

设置该实体在隐身状态下可以躲避敌对生物。

另见:EntityIsHiddenWhenInvisibleComponent 类。

  • minecraft:is_hidden_when_invisible 数据类型图标minecraft:is_hidden_when_invisible
    JSON 对象
    :根对象,不含任何参数。

minecraft:hurt_on_condition​

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

定义一组条件,实体满足条件时持续受到伤害。

  • minecraft:hurt_on_condition 数据类型图标minecraft:hurt_on_condition
    JSON 对象
    :根对象。
    • damage_conditions 数据类型图标damage_conditions
      JSON 数组
      :伤害条件列表,每刻按顺序求值。
      • object 数据类型图标
        JSON 对象
        :一项条件。
        • cause 数据类型图标cause
          字符串
          :造成的伤害类型,如lava、fall、entity_attack、magma、temperature、all,完整列表见伤害类型;无效值按none处理。默认值为none。
        • damage_per_tick 数据类型图标damage_per_tick
          浮点数
          :满足条件时每刻造成的伤害。默认值为0。
        • filters 数据类型图标filters
          JSON 对象
          :触发伤害所需的条件。见实体过滤器。

minecraft:breathable​

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

定义实体可以呼吸的介质、憋气时长与窒息伤害。

另见:EntityBreathableComponent 类。

已弃用:1.2.0-1.13.0

该特性已被弃用,只能在游戏版本1.2.0-1.13.0下使用。
:

  • minecraft:breathable 数据类型图标minecraft:breathable
    JSON 对象
    :根对象。
    • totalSupply 数据类型图标totalSupply
      整数
      :可憋气的秒数。默认值为15。
    • suffocateTime 数据类型图标suffocateTime
      整数
      :两次窒息伤害之间的秒数。默认值为-20。
    • inhaleTime 数据类型图标inhaleTime
      浮点数
      :1.4.0+
      该特性在游戏版本1.4.0+下可用。
      把憋气量恢复到上限所需的秒数。默认值为0。
    • breathesAir 数据类型图标breathesAir
      布尔值
      :是否能在空气中呼吸。默认值为true。
    • breathesWater 数据类型图标breathesWater
      布尔值
      :是否能在水中呼吸。默认值为false。
    • breathesLava 数据类型图标breathesLava
      布尔值
      :是否能在熔岩中呼吸。默认值为false。
    • breathesSolids 数据类型图标breathesSolids
      布尔值
      :是否能在固体方块中呼吸。默认值为false。
    • generatesBubbles 数据类型图标generatesBubbles
      布尔值
      :在水中是否显示气泡。默认值为true。
    • breatheBlocks 数据类型图标breatheBlocks
      JSON 数组
      :除上述开关外,额外允许呼吸的方块。
      • string 数据类型图标
        字符串
        :方块 ID。
    • nonBreatheBlocks 数据类型图标nonBreatheBlocks
      JSON 数组
      :除上述开关外,额外禁止呼吸的方块。
      • string 数据类型图标
        字符串
        :方块 ID。

1.13.0+

该特性在游戏版本1.13.0+下可用。
:

  • minecraft:breathable 数据类型图标minecraft:breathable
    JSON 对象
    :根对象。
    • breathes_air 数据类型图标breathes_air
      布尔值
      :是否能在空气中呼吸。默认值为true。
    • breathes_water 数据类型图标breathes_water
      布尔值
      :是否能在水中呼吸。默认值为false。
    • breathes_lava 数据类型图标breathes_lava
      布尔值
      :是否能在熔岩中呼吸。默认值为true。
    • breathes_solids 数据类型图标breathes_solids
      布尔值
      :是否能在固体方块中呼吸。默认值为false。
    • breathe_blocks 数据类型图标breathe_blocks
      JSON 数组
      :除上述开关外,额外允许呼吸的方块。
      • string 数据类型图标
        字符串
        :方块 ID。
    • non_breathe_blocks 数据类型图标non_breathe_blocks
      JSON 数组
      :除上述开关外,额外禁止呼吸的方块。
      • string 数据类型图标
        字符串
        :方块 ID。
    • total_supply 数据类型图标total_supply
      整数
      :可憋气的秒数。默认值为15。
    • suffocate_time 数据类型图标suffocate_time
      整数
      :两次窒息伤害之间的秒数。默认值为-20。
    • inhale_time 数据类型图标inhale_time
      浮点数
      :把憋气量恢复到上限所需的秒数。默认值为0。
    • generates_bubbles 数据类型图标generates_bubbles
      布尔值
      :在水中是否显示气泡。默认值为true。
    • can_dehydrate 数据类型图标can_dehydrate
      布尔值
      :1.21.130+
      该特性在游戏版本1.21.130+下可用。
      为true时,只能在水下呼吸的实体在脱离水后会受到脱水伤害。默认值为false,以保持原有的呼吸行为。

备注:原版有 2 个文件写作totalSupply、suffocateTime,其余 80 个文件均为下划线写法。


minecraft:experience_reward​

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

定义实体被繁殖或死亡时给予的经验值。

  • minecraft:experience_reward 数据类型图标minecraft:experience_reward
    JSON 对象
    :根对象。
    • on_bred 数据类型图标on_bred
      字符串
      :成功繁殖时给予的经验值,填返回数值的 Molang 表达式。
    • on_death 数据类型图标on_death
      字符串
      :死亡时给予的经验值,填返回数值的 Molang 表达式。

minecraft:loot​

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

定义实体死亡时掉落的战利品表。

  • minecraft:loot 数据类型图标minecraft:loot
    JSON 对象
    :根对象。
    • table 数据类型图标table
      字符串
      :战利品表路径,相对于行为包根目录,如loot_tables/entities/blaze.json。