实体

From Minecraft基岩版开发Wiki

实体(Entity)包括在Minecraft中所有动态的、移动中的对象。

行为[edit]

所有实体都有以下性质:

  • 具有速度、位置和旋转角度。(以经典力学为依据)
  • 占有特定的空间大小。此空间是一个固定长宽高的三维长方体(实体不偏斜时,俯视图为正方形)。
  • 当前的生命值(除了方块实体、物品、弹射物(包括药水)、区域效果云和经验球)。
  • 当着时,生命值逐渐减少,实体显示出被火焰包围的样子。
  • 状态效果,主要由药水产生。

一部分实体能被流推动。包括玩家、生物、船、物品、点燃的TNT、经验球等。一些实体能够命名牌将其重命名。

实体不能穿过固体方块。大多数实体会占用所在的空间,阻止方块的放置,除了掉落物和经验球会自动让出占用的空间。若实体确实与固体方块处在同一位置,如被掉落的沙子掩埋或被活动的卡在一起。

实体会根据所在位置的亮度等级被照亮。例如,如果矿车斜着撞进一个固体方块中,就会变成黑色(固体方块的亮度永远是0);射出的有时候也会呈现黑色(尤其是几乎水平地卡在了天花板上时)。

相关组件[edit]

描述[edit]

客户端[edit]

类型
名称
默认值
描述
字符串 identifier 设置该实体的赋命名空间标识符
字符串 min_engine_version 设置该实体使用的最小游戏引擎版本。
对象 materials
对象 textures
对象 geometry
对象 scripts
对象 animations 行为动画或动画控制器的列表。这些可用于在实体上运行命令或事件
对象 animation_controllers
对象 render_controllers
对象 locators
布尔值 enable_attachables true
布尔值 hide_armor true
对象 spawn_egg

服务端[edit]

类型
名称
默认值
ID
描述
字符串 identifier 设置该实体的赋命名空间标识符
布尔值 is_experimental false 设置该实体是否属于实验性玩法
布尔值 is_spawnable false 设置该实体是否可以自然生成或通过刷怪蛋生成(当设置为true时游戏会自动向物品栏中添加刷怪蛋物品)。
布尔值 is_summonable false 设置该实体是否可被命令生成。
字符串 runtime_identifier
对象 scripts -76244517
对象 animations 1232311658

组件[edit]

基本组件[edit]

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

内置事件[edit]

名称
描述
minecraft:entity_transformed
minecraft:entity_born
minecraft:entity_spawned
minecraft:on_prime

过滤器[edit]

名称
描述
clock_time
distance_to_nearest_player
has_ability
has_biome_tag
has_component
has_container_open
has_damage
has_equipment
has_mob_effect
has_ranged
has_tag
has_target
has_trade_supply
hourly_clock_time
in_block
in_caravan
in_clouds
in_contact_with_water
in_lava
in_nether
in_water
in_water_or_rain
inactivity_timer
is_altitude
is_avoiding_mobs
is_biome
is_block
is_brigtness
is_climbing
is_color
is_daytime
is_difficulty
is_family
is_game_rule
is_humid
is_immobile
is_village
is_leashed
is_leashed_to
is_mark_variant
is_moving
is_owner
is_persistent
is_riding
is_skin_id
is_sleeping
is_sneaking
is_snow_covered
is_target
is_temperature_type
is_temperature_value
is_underground
is_underwater
is_variant
is_visible
is_weather
light_level
moon_intensity
moon_phase
on_ground
on_ladder
random_chance
rider_count
surface_mob
trusts
weather
weather_at_position

触发器[edit]

名称
ID
描述
minecraft:on_death -49357854
minecraft:on_friendly_angry -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

AI意向[edit]

名称
ID
描述
minecraft:behavior.admire_item 1024844406
minecraft:behavior.barter 536670686
minecraft:behavior.beg 1346418048 控制此实体注视并跟随拿着它们喜欢的食物的玩家
minecraft:behavior.break_door -1798237626 控制此实体破坏门
minecraft:behavior.breed 51166360 控制此实体与其他实体繁殖
minecraft:behavior.celebrate 995178519
minecraft:behavior.croak
minecraft:behavior.defend_trusted_target 2070046390
minecraft:behavior.door_interact -286762735 控制实体开门和关门
minecraft:behavior.dragondeath -1541162059 控制实体在死亡时播放末影龙死亡动画,此标识控制末影龙的死亡动画并且不能被其他实体控制用。
minecraft:behavior.dragonholdingpattern 1066617362 控制龙围绕中央平台以圆形轨迹飞行,只能被末影龙控制用。
minecraft:behavior.dragonlanding -152352492 控制龙停止飞行并过渡到栖息模式,只能被末影龙控制用。
minecraft:behavior.dragonscanning -1003941066 控制龙处于栖息模式时寻找要攻击的玩家,只能被末影龙控制用。
minecraft:behavior.dragontakeoff -1912535317 控制龙由栖息变为盘旋,只能被末影龙控制用。
minecraft:behavior.drink_potion 277029334 控制实体根据环境条件喝下药水。
minecraft:behavior.eat_carried_item -184757575
minecraft:behavior.eat_mob
minecraft:behavior.enderman_leave_block -717580550 控制末影人放下它们随机拿起的方块,只能被末影人控制用。
minecraft:behavior.enderman_take_block -537294220 控制末影人随机拿走一个方块,只能拿被末影人时控制用。
minecraft:behavior.explore_outskirts -1955198366 控制实体探索村庄外围区域。
minecraft:behavior.find_cover -1231227755 控制实体像狐狸那样寻找一个不露天的地方。
minecraft:behavior.find_mount 731306871 控制实体骑到另外一个实体身上。
minecraft:behavior.find_underwater_treasure -1602192311 控制实体移动至最近的海底废墟或沉船。
minecraft:behavior.flee_sun -617664229 控制实体避开阳光直射和寻找阴影庇护。
minecraft:behavior.float 1758503000 控制实体能浮在水面上。
minecraft:behavior.float_wander -1122048364 控制实体能像恶魂那样漂浮。
minecraft:behavior.follow_caravan 9936402 控制实体跟随商队里的实体。
minecraft:behavior.follow_mob -1524701626 控制此实体跟随其他实体。
minecraft:behavior.follow_owner 1213259599 控制实体跟随其主人。
minecraft:behavior.follow_parent 2127040136 控制实体跟随在其父母周围。
minecraft:behavior.follow_target_captain -135480526 控制实体朝着目前的目标队长移动。
minecraft:behavior.go_home -1579225026 控制此实体回到其出生点。
minecraft:behavior.hide 233394190 控制实体寻找躲藏处(仅对村民有效)。
minecraft:behavior.hold_ground 1804286487
minecraft:behavior.hurt_by_target -1710404297 控制实体把对它造成伤害的实体标记为目标。
minecraft:behavior.inspect_bookshelf 40191182 控制实体查阅书架。
minecraft:behavior.jump_to_block
minecraft:behavior.knockback_roar -1304117826 控制实体对附近所有实体造成击退伤害。
minecraft:behavior.lay_down -2074934675 控制实体趴下。
minecraft:behavior.lay_egg -1207740530 控制实体在怀孕时在沙子上下蛋。
minecraft:behavior.leap_at_target 256926956 控制怪物跳起来攻击它们的目标,只能被敌对实体时控制用。
minecraft:behavior.look_at_entity -1735428573 控制实体看着它们附近的实体。
minecraft:behavior.look_at_player -1892159379 控制实体附近有玩家时看着玩家。
minecraft:behavior.look_at_target -885375871 控制实体看着被它们标记的目标。
minecraft:behavior.look_at_trading_player -2094605693 控制实体看着与它们交易的目标。
minecraft:behavior.make_love -1551283431 控制村民寻找配偶以生成其他村民,此标识只能被村民控制用。
minecraft:behavior.mingle 385775952 控制村民前往村庄中钟的位置,并与其他村民待在一起。
minecraft:behavior.mount_pathing 1112137677 控制实体自行游荡寻找攻击目标。
minecraft:behavior.move_indoors 2107078532 控制村民寻找房屋,此标志只能被村民控制用。
minecraft:behavior.move_through_village 779377630 控制村民创建环绕村庄的路径,此标志只能被村民控制用。
minecraft:behavior.move_to_land -943551837 控制此实体在水里时回到岸上。
minecraft:behavior.move_to_lava -945036492
minecraft:behavior.move_to_poi 1721669938 控制实体移动到POI(工作方块、床、钟)。
minecraft:behavior.move_to_random_block 395022171 控制实体向一个随机方块移动。
minecraft:behavior.move_to_village -805189394 控制实体移动到村庄内的一个随机地点。
minecraft:behavior.move_to_water 1886139445 控制此实体上岸时回到水里。
minecraft:behavior.move_towards_target -166537884 控制实体移向其当前目标。
minecraft:behavior.nap 992184933 控制实体小睡(无需床)。
minecraft:behavior.nearest_attackable_target 5824270165841165755 控制实体检查并追赶距离最近的有效目标。
minecraft:behavior.nearest_priorized_attackable_target 335414683
minecraft:behavior.ocelot_sit_on_block -1327999383 控制实体像豹猫那样原地坐下。
minecraft:behavior.offer_flower -885387854 控制实体送出花(仅对铁傀儡有效)。
minecraft:behavior.open_door -906200433
minecraft:behavior.owner_hurt_by_target 530667419
minecraft:behavior.owner_hurt_target 995655261
minecraft:behavior.panic -169886247
minecraft:behavior.peek 211304085
minecraft:behavior.pet_sleep_with_owner 1379392240
minecraft:behavior.pickup_items 644287189
minecraft:behavior.play -505601580
minecraft:behavior.player_ride_tamed 603869698
minecraft:behavior.raid_garden -1145687602
minecraft:behavior.random_breach 928528911
minecraft:behavior.random_fly -446385505
minecraft:behavior.random_hover -1797323808
minecraft:behavior.random_look_around 1177762851
minecraft:behavior.random_look_around_and_sit -1368070166
minecraft:behavior.random_sitting 1722716662
minecraft:behavior.random_stroll -1643504294
minecraft:behavior.random_swim -1465281278
minecraft:behavior.receive_love 1156694272
minecraft:behavior.restrict_open_door 715583988
minecraft:behavior.restrict_sun -382716017
minecraft:behavior.rise_to_liquid_level -950950337
minecraft:behavior.roll 817471653
minecraft:behavior.run_around_like_crazy -1390363669
minecraft:behavior.scared 1812936510
minecraft:behavior.seed_event -823429137
minecraft:behavior.share_items 2045906118
minecraft:behavior.silverfish_merge 321908121
minecraft:behavior.silverfish_wake_up_friends 484391748
minecraft:behavior.skeleton_horse_trap 530952387
minecraft:behavior.sleep -1811763
minecraft:behavior.slime_attack -1315951081
minecraft:behavior.snacking 875141064
minecraft:behavior.sneeze 1528584076
minecraft:behavior.squid_dive 1626998843
minecraft:behavior.squid_flee 1304043261
minecraft:behavior.squid_idle 1741234679
minecraft:behavior.squid_move_away_from_ground 892387674
minecraft:behavior.squid_out_of_water -1347598607
minecraft:behavior.stalk_and_pounce_on_target -1248479202
minecraft:behavior.stay_while_sitting 1346980478
minecraft:behavior.stomp_turtle_egg 851839416
minecraft:behavior.stroll_towards_village -1563831906
minecraft:behavior.summon_entity -2005850647
minecraft:behavior.swell -1473132493
minecraft:behavior.take_flower 1218648257
minecraft:behavior.tempt 422904556
minecraft:behavior.trade_interest -574851053
minecraft:behavior.trade_with_player -2048563493
minecraft:behavior.vex_copy_owner_target -643459543
minecraft:behavior.vex_random_move -1117822165
minecraft:behavior.wither_random_attack_pos_goal -528895885
minecraft:behavior.wither_target_highest_damage -1065562072
minecraft:behavior.work -1700601421

生成规则[edit]

名称
描述
minecraft:spawns_on_surface
minecraft:spawns_underwater
minecraft:brightness_filter
minecraft:weight
minecraft:difficulty_filter
minecraft:herd
minecraft:biome_filter
minecraft:density_limit
minecraft:world_age_filter

特性[edit]

名称
ID
描述
minecraft:attack 1651346034
minecraft:spell_effects 523264365
minecraft:strength 648564399

实体属性[edit]

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

相关文件[edit]

以下附加包内路径的文件与实体有关。

文件路径 描述 文件类别
/animation_controllers/ 动画控制器JSON文件的存储位置。 资源包文件
/animations/ 动画JSON文件的存储位置。 资源包文件
/attachables/ 附着物JSON文件的存储位置。 资源包文件
/entitis/ 实体行为定义JSON文件的存储位置。 行为包文件
/entity/ 实体材质资源定义JSON文件的存储位置。 资源包文件
/loot_tables/entities/

或 /loot_tables/gameplay/entities/ 或 /loot_tables/gameplay/fishing/

战利品JSON文件的存储位置。(注:钓鱼竿甩出的鱼钩属于实体) 行为包文件
/models/entity/

或 /models/entity/mobs.json

几何模型JSON文件的存储位置。 资源包文件
/particles/ 粒子JSON文件的存储位置。 资源包文件
/render_controllers/ 渲染控制器JSON文件的存储位置。 资源包文件
/scripts/ JS文件的存储位置。 行为包文件
/sounds/ 声音JSON文件和音频文件的存储位置。 资源包文件
/spawn_rules/ 实体生成规则的JSON文件的存储位置。 行为包文件
/texts/ 语言文件的存储位置。 资源包文件
/textures/entity/ 材质贴图JSON文件和贴图的存储位置。 资源包文件
/trading/ 实体交易列表JSON文件的存储位置。 行为包文件

种类列表[edit]

种类 是否固体 掉落物 生命值 碰撞箱(宽×高) 内部ID 网络ID

特性[edit]

特性 描述

伤害来源[edit]

伤害来源 描述

存储格式[edit]

存档格式/实体

Template:Entities