基础属性组件
全体实体通用的组件。在定义实体的时候,多数情况下都需要这些组件,并且在编写实体时应当优先考虑这些组件。
minecraft:collision_box
通用定义实体的碰撞箱。
- 参数
- 示例
minecraft:collision_boxJSON 对象:根对象。height浮点数:实体的碰撞箱高度。默认值为1。width浮点数:实体的碰撞箱宽度。默认值为1。
箭(arrow.json
"minecraft:collision_box": {
"height": 0.25,
"width": 0.25
}
minecraft:health
通用定义实体的生命值。1 颗心等于 2 点生命值。
- 参数
- 示例
minecraft:healthJSON 对象:根对象。value整数:(写法 1)实体的血量。默认值为20。valueJSON 对象:(写法 2)实体的血量范围。range_min整数:血量的最小值。range_max整数:血量的最大值。
max整数:实体的最大血量。默认值为20。
猪(pig.json
"minecraft:health": {
"value": 10,
"max": 10
}
羊驼(llama.json
"minecraft:health": {
"value": {
"range_min": 15,
"range_max": 30
}
}
minecraft:physics
通用定义实体的物理属性,是否应该具有碰撞或重力。
- 参数
- 示例
minecraft:physicsJSON 对象:根对象。has_collision布尔值:实体是否和世界中的其他方块/实体有碰撞。默认值为true。has_gravity布尔值:实体是否有重力。默认值为true。push_towards_closest_space布尔值:1.19.60+该特性在游戏版本1.19.60+下可用。在被方块卡住后,实体是否应该被挤压到最近的开放区域。默认值为false。
恼鬼(vex.json
"minecraft:physics": {
"has_collision": false,
"has_gravity": false
}
盔甲架(armor_stand.json
"minecraft:physics": {}
minecraft:pushable_by_block
通用定义实体可被活塞或潜影盒推动。
- 参数
- 示例
minecraft:pushable_by_blockJSON 对象:根对象,不含任何参数。
"minecraft:pushable_by_block": {}
minecraft:pushable_by_entity
通用定义实体可被其他实体推动。
- 参数
- 示例
minecraft:pushable_by_entityJSON 对象:根对象。presetsJSON 数组:26.30+该特性在游戏版本26.30+下可用,但该版本对于当前的中国版版本过高。定义特殊实体的推动行为。- JSON 对象:一项预设。
filtersJSON 对象:实体过滤器。定义该实体应满足的条件。见实体过滤器。push_mode字符串:推动模式。可选值为:可选值 描述 none无法推动此实体。 default(默认值)多数实体采用的标准推动行为。 legacy_boat继承船的推动行为,包括阻尼力和潜行抵消行为。见船 - 中文 Minecraft Wiki。 legacy_minecart继承矿车的推动行为,包括基于对齐的碰撞处理和速度平均行为。见矿车 - 中文 Minecraft Wiki。 ball类似于踢球的推动行为,实体会向推动者运动的方向运动,受力与推动者的速度成正比。见硫方怪 - 中文 Minecraft Wiki。 strength_multiplier浮点数:施加给实体推力的乘数。更大的乘数意味着更大的推力。默认值为0.05。min_distance浮点数:要施加推力的实体之间的最小距离。距离更小则不会相互推动。默认值为0.01。max_distance浮点数:要施加推力的实体之间的最大距离。距离更大则不会相互推动。默认值为3.4e38。push_scale_self浮点数:发生碰撞时推动自身的推力乘数。更大的乘数意味着对自身的推力越大。默认值为1。push_scale_other浮点数:发生碰撞时推动其他实体的推力乘数。更大的乘数意味着对其他实体的推力越大。默认值为1。play_sound布尔值:是否要播放pushed_by_player音效。默认值为false。play_sound_cooldown_in_seconds浮点数:声音之间的冷却时间,数字越小,声音越多。单位:秒。默认值为0.2。play_sound_impulse_threshold浮点数:触发推动音效所需的最小速度变化,值越低,灵敏度越高。默认值为0.2。kick_speed_scale浮点数:限定参数仅当push_mode为ball时可用。踢球速度乘数,推力会随着速度的增加而增加。乘数越大则推力越大。默认值为2。min_kick_speed浮点数:限定参数仅当push_mode为ball时可用。最小踢球速度,实体将被击退的最小速度。默认值为0.0。max_kick_speed浮点数:限定参数仅当push_mode为ball时可用。最大踢球速度,实体将被击退的最大速度。默认值为0.5。vertical_kick_multiplier浮点数:限定参数仅当push_mode为ball时可用。当物体在地面上被推动时,向上施加的力的乘数。为0时则使实体保持在地面上。默认值为0.3。require_collision_overlap浮点数:26.40+该特性在游戏版本26.40+下可用,但该版本对于当前的中国版版本过高。是否需要碰撞箱重叠才能推动。默认值为true。1.26.40起未写时按true处理,更早的格式版本则按false处理。
"minecraft:pushable_by_entity": {}
26.30+boat.json
"minecraft:pushable_by_entity": {
"presets": [
{
"filters": {
"all_of": [
{
"test": "is_family",
"subject": "other",
"value": "sulfur_cube"
},
{
"test": "enum_property",
"subject": "other",
"domain": "minecraft:sulfur_cube_archetype",
"operator": "not",
"value": "none"
},
{
"test": "is_controlling_passenger_family",
"subject": "self",
"value": "player"
}
]
},
"push_mode": "none"
},
{
"push_mode": "legacy_boat",
"strength_multiplier": 0.1,
"min_distance": 0.55,
"push_scale_self": 0.5,
"push_scale_other": 0.25
}
]
}
26.30+sulfur_cube.json
"minecraft:pushable_by_entity": {
"presets": [
{
"filters": {
"any_of": [
{
"test": "is_family",
"subject": "other",
"value": "player"
},
{
"test": "is_controlling_passenger_family",
"subject": "other",
"value": "player"
}
]
},
"push_mode": "ball",
"min_distance": 0.0,
"max_distance": 1.0,
"push_scale_self": 3.0,
"push_scale_other": 1.0,
"kick_speed_scale": 0.3,
"min_kick_speed": 0.0,
"max_kick_speed": 0.5,
"vertical_kick_multiplier": 0.3,
"play_sound": true,
"play_sound_impulse_threshold": 0.2,
"play_sound_cooldown_in_seconds": 0.7
}
]
}
minecraft:type_family
通用定义实体所属的家族类型。家族类型可用于在过滤器中、命令中或其他游戏系统进行分类判断(例如:mob、monster、undead、zombie等)。
另见:EntityTypeFamilyComponent 类。
- 参数
- 示例
minecraft:type_familyJSON 对象:根对象。familyJSON 数组:定义实体的家族类型。- 字符串:家族名。
备注:通常会在数组中定义一个与实体自身 ID 相同的家族名。原版常见的家族名有
mob、inanimate、aquatic、monster、undead、skeleton、arthropod、zombie、lightweight、fish、player,也可以自定义。
骷髅(skeleton.json
"minecraft:type_family": { "family": ["skeleton", "undead", "monster", "mob"] }
盔甲架(armor_stand.json
"minecraft:type_family": { "family": ["armor_stand", "inanimate", "mob"] }
minecraft:conditional_bandwidth_optimization
通用定义实体的带宽优化策略,用于减少位置同步包的数量。
- 参数
- 示例
minecraft:conditional_bandwidth_optimizationJSON 对象:根对象。default_valuesJSON 对象:默认策略。下列三个字段同样适用于conditional_values中的每一项。max_dropped_ticks整数:最多可连续多少刻不发送位置同步包。max_optimized_distance浮点数:参与优化的最大距离,超过该距离按最大优化处理。use_motion_prediction_hints布尔值:为true时在丢包区间内发送更小的运动预测包,适合高速移动或传送的实体。
conditional_valuesJSON 数组:按条件覆盖默认策略,取第一条条件成立者。- JSON 对象:一项。
filtersJSON 对象:条件。见实体过滤器。max_dropped_ticks整数:最多可连续多少刻不发送位置同步包。max_optimized_distance浮点数:参与优化的最大距离。use_motion_prediction_hints布尔值:是否发送更小的运动预测包。
箭(arrow.json
"minecraft:conditional_bandwidth_optimization": {
"default_values": {
"max_dropped_ticks": 7,
"max_optimized_distance": 80.0,
"use_motion_prediction_hints": true
}
}
minecraft:nameable
通用允许该实体被命名,例如使用命名牌。
- 参数
- 示例
minecraft:nameableJSON 对象:根对象。allow_name_tag_renaming布尔值:是否允许用命名牌再次改名。默认值为true。allowNameTagRenaming布尔值:已弃用:1.2.0-1.13.0该特性已被弃用,只能在游戏版本1.2.0-1.13.0下使用。是否允许用命名牌再次改名(旧拼写)。默认值为true。always_show布尔值:名字是否始终显示。默认值为false。alwaysShow布尔值:已弃用:1.2.0-1.13.0该特性已被弃用,只能在游戏版本1.2.0-1.13.0下使用。名字是否始终显示(旧拼写)。默认值为false。default_triggerJSON 对象:实体被命名时触发的默认事件。event字符串:事件 ID。target字符串:事件作用于哪个主体。可填self(自身)、other(交互另一方)、player(玩家)、target(当前攻击目标)、parent(父母)、block(方块)、damager(伤害来源),完整取值与含义见测试主体。默认值为self。
name_actionsJSON 数组:特殊名字与对应事件的列表。- JSON 对象:一项。
name_filter字符串:触发该事件的名字。on_namedJSON 对象:取到该名字时触发的事件,结构同default_trigger。
备注:官方文档把
name_filter、on_named列为根字段,原版则收在name_actions数组内,此处按原版结构书写。
卫道士(vindicator.json
"minecraft:nameable": {
"default_trigger": {
"event": "minecraft:stop_johnny",
"target": "self"
},
"name_actions": [
{
"name_filter": "Johnny",
"on_named": {
"event": "minecraft:start_johnny",
"target": "self"
}
}
]
}
minecraft:is_hidden_when_invisible
通用设置该实体在隐身状态下可以躲避敌对生物。
另见:EntityIsHiddenWhenInvisibleComponent 类。
- 参数
- 示例
minecraft:is_hidden_when_invisibleJSON 对象:根对象,不含任何参数。
悦灵(allay.json
"minecraft:is_hidden_when_invisible": {}
minecraft:hurt_on_condition
通用定义一组条件,实体满足条件时持续受到伤害。
- 参数
- 示例
悦灵(allay.json
"minecraft:hurt_on_condition": {
"damage_conditions": [
{
"cause": "lava",
"damage_per_tick": 4,
"filters": {
"subject": "self",
"test": "in_lava"
}
}
]
}
minecraft:breathable
通用定义实体可以呼吸的介质、憋气时长与窒息伤害。
另见:EntityBreathableComponent 类。
- 参数
- 示例
已弃用:1.2.0-1.13.0
minecraft:breathableJSON 对象:根对象。totalSupply整数:可憋气的秒数。默认值为15。suffocateTime整数:两次窒息伤害之间的秒数。默认值为-20。inhaleTime浮点数:1.4.0+该特性在游戏版本1.4.0+下可用。把憋气量恢复到上限所需的秒数。默认值为0。breathesAir布尔值:是否能在空气中呼吸。默认值为true。breathesWater布尔值:是否能在水中呼吸。默认值为false。breathesLava布尔值:是否能在熔岩中呼吸。默认值为false。breathesSolids布尔值:是否能在固体方块中呼吸。默认值为false。generatesBubbles布尔值:在水中是否显示气泡。默认值为true。breatheBlocksJSON 数组:除上述开关外,额外允许呼吸的方块。- 字符串:方块 ID。
nonBreatheBlocksJSON 数组:除上述开关外,额外禁止呼吸的方块。- 字符串:方块 ID。
1.13.0+
minecraft:breathableJSON 对象:根对象。breathes_air布尔值:是否能在空气中呼吸。默认值为true。breathes_water布尔值:是否能在水中呼吸。默认值为false。breathes_lava布尔值:是否能在熔岩中呼吸。默认值为true。breathes_solids布尔值:是否能在固体方块中呼吸。默认值为false。breathe_blocksJSON 数组:除上述开关外,额外允许呼吸的方块。- 字符串:方块 ID。
non_breathe_blocksJSON 数组:除上述开关外,额外禁止呼吸的方块。- 字符串:方块 ID。
total_supply整数:可憋气的秒数。默认值为15。suffocate_time整数:两次窒息伤害之间的秒数。默认值为-20。inhale_time浮点数:把憋气量恢复到上限所需的秒数。默认值为0。generates_bubbles布尔值:在水中是否显示气泡。默认值为true。can_dehydrate布尔值:1.21.130+该特性在游戏版本1.21.130+下可用。为true时,只能在水下呼吸的实体在脱离水后会受到脱水伤害。默认值为false,以保持原有的呼吸行为。
备注:原版有 2 个文件写作
totalSupply、suffocateTime,其余 80 个文件均为下划线写法。
悦灵(allay.json
"minecraft:breathable": {
"total_supply": 15,
"suffocate_time": 0
}
minecraft:experience_reward
通用定义实体被繁殖或死亡时给予的经验值。
- 参数
- 示例
minecraft:experience_rewardJSON 对象:根对象。on_bred字符串:成功繁殖时给予的经验值,填返回数值的 Molang 表达式。on_death字符串:死亡时给予的经验值,填返回数值的 Molang 表达式。
犰狳(armadillo.json
"minecraft:experience_reward": {
"on_bred": "Math.Random(1,7)",
"on_death": "query.last_hit_by_player ? Math.Random(1,3) : 0"
}
minecraft:loot
通用定义实体死亡时掉落的战利品表。
- 参数
- 示例
minecraft:lootJSON 对象:根对象。table字符串:战利品表路径,相对于行为包根目录,如loot_tables/entities/blaze.json。
烈焰人(blaze.json
"minecraft:loot": {
"table": "loot_tables/entities/blaze.json"
}