伤害：修订间差异

来自Minecraft基岩版开发Wiki
交互式浏览历史
添加的内容 删除的内容
可视化wikitext
标签：2017年版源代码编辑
小 （→‎伤害类型：​ // Edit via Wikiplus）
 
（未显示2个用户的7个中间版本）
第47行： 第47行：
* {{cd|[[Manual:minecraft:entity_hurt|minecraft:entity_hurt]]}}服务端事件的数据中的{{cd|absorbed_damage}}和{{cd|damage}}字段，分别为此次伤害中实体由于[[伤害吸收]]状态效果吸收的伤害和最终结算的伤害。
* {{cd|[[Manual:minecraft:entity_hurt|minecraft:entity_hurt]]}}服务端事件的数据中的{{cd|absorbed_damage}}和{{cd|damage}}字段，分别为此次伤害中实体由于[[伤害吸收]]状态效果吸收的伤害和最终结算的伤害。


=== ModSDK ===
=== 模组SDK ===


{{main|Manual:ModSDK|Manual:ModAPI}}
{{main|Manual:模组SDK|Manual:模组API}}


在在[[ModSDK]]中除了上述附加包中的数据驱动调用形式，还有以下数据驱动修改方式：
在在[[模组SDK]]中除了上述附加包中的数据驱动调用形式，还有以下数据驱动修改方式：
* 物品的{{cd|[[Manual:netease:weapon|netease:weapon]]}}[[组件]]的{{cd|attack_damage}}字段，控制该物品的攻击伤害。
* 物品的{{cd|[[Manual:netease:weapon|netease:weapon]]}}[[组件]]的{{cd|attack_damage}}字段，控制该物品的攻击伤害。


在[[ModAPI]]中还有如下调用方法：
在[[模组API]]中还有如下调用方法：
* 实体的{{cd|ActorHurtServerEvent}}服务端事件的数据中的{{cd|damage}}字段，为此次攻击给予的伤害；
* 实体的{{cd|ActorHurtServerEvent}}服务端事件的数据中的{{cd|damage}}字段，为此次攻击给予的伤害；
* 实体的{{cd|ActuallyHurtServerEvent}}服务端事件的数据中的{{cd|damage}}字段，为该实体受到的伤害；
* 实体的{{cd|ActuallyHurtServerEvent}}服务端事件的数据中的{{cd|damage}}字段，为该实体受到的伤害；
第62行： 第62行：
* 实体的{{cd|hurt}}类的{{cd|SetHurtByEntity}}组件第二个参数，为对实体造成伤害值。
* 实体的{{cd|hurt}}类的{{cd|SetHurtByEntity}}组件第二个参数，为对实体造成伤害值。


=== InnerCore ===
=== Inner Core ===


{{main|Manual:InnerCore|Manual:AdaptedScript|Manual:CoreEngine}}
{{main|Manual:Inner Core|Manual:AdaptedScript|Manual:CoreEngine}}


在[[AdaptedScript]]中，{{Info_needed}}
在[[AdaptedScript]]中，{{Info_needed}}
第80行： 第80行：


在[[ModPE]]中，可以使用以下[[钩子函数]]来获取伤害：
在[[ModPE]]中，可以使用以下[[钩子函数]]来获取伤害：
* {{cd|entityHurtHook}}的第三个参数，为该实体受伤时结算的伤害。
* {{cd|[[Manual:entityHurtHook|entityHurtHook]]}}的第三个参数，为该实体受伤时结算的伤害。


== 伤害类型 ==
== 伤害类型 ==
第86行： 第86行：
Minecraft中的伤害由来源不同被分为很多'''伤害类型'''（'''Damage types'''）。不仅不同的伤害类型在实体受到伤害时会被分开结算，玩家的死亡信息也会由类型不同而有所不同。下面列出当前游戏内所有伤害类型的表格以及他们的相关数据，该表格源自源码中的{{cd|ActorDamageCause}}类。
Minecraft中的伤害由来源不同被分为很多'''伤害类型'''（'''Damage types'''）。不仅不同的伤害类型在实体受到伤害时会被分开结算，玩家的死亡信息也会由类型不同而有所不同。下面列出当前游戏内所有伤害类型的表格以及他们的相关数据，该表格源自源码中的{{cd|ActorDamageCause}}类。


{{:伤害/ActorDamageCause}}
{| class="wikitable sortable"
! 枚举键 !! 内部ID !! 接口字符串{{only|addon}} !! 枚举值!! 原版中的产生途径
|-
| {{cd|None}} || {{cd|none}} || {{cd|none}} || -1 || 无
|-
| {{cd|Override}} || {{cd|override}} || {{cd|override}} || 0 || 程序直接覆写[[生命值]]
|-
| {{cd|Contact}} || {{cd|contact}} || {{cd|contact}} || 1 || [[仙人掌]]或[[甜浆果丛]]
|-
| {{cd|EntityAttack}} || {{cd|entity_attack}} || {{cd|attack}} || 2 || 近战[[攻击]]
|-
| {{cd|Projectile}} || {{cd|projectile}} || {{cd|projectile}} || 3 || [[弹射物]]
|-
| {{cd|Suffocation}} || {{cd|suffocation}} || {{cd|suffocation}} || 4 || [[窒息]]
|-
| {{cd|Fall}} || {{cd|fall}} || {{cd|fall}} || 5 || [[跌落]]或[[末影珍珠]]
|-
| {{cd|Fire}} || {{cd|fire}} || {{cd|fire}} || 6 || [[火]]或[[篝火]]
|-
| {{cd|FireTick}} || {{cd|fire_tick}} || {{cd|fire_tick}} || 7 || 身上连续着火
|-
| {{cd|Lava}} || {{cd|lava}} || {{cd|lava}} || 8 || [[熔岩]]
|-
| {{cd|Drowning}} || {{cd|drowning}} || {{cd|drowning}} || 9 || [[溺水]]或淋雨
|-
| {{cd|BlockExplosion}} || {{cd|block_explosion}} || {{cd|block_explosion}} || 10 || 方块[[爆炸]]
|-
| {{cd|EntityExplosion}} || {{cd|entity_explosion}} || {{cd|entity_explosion}} || 11 || 实体[[爆炸]]
|-
| {{cd|Void}} || {{cd|void}} || {{cd|void}} || 12 || [[虚空]]
|-
| {{cd|Suicide}} || {{cd|suicide}} || {{cd|suicide}} || 13 || {{cmd|kill}}指令
|-
| {{cd|Magic}} || {{cd|magic}} || {{cd|magic}} || 14 || [[药水]]、[[龙息]]、[[唤魔者尖牙]]或[[守卫者]]激光
|-
| {{cd|Wither}} || {{cd|wither}} || {{cd|wither}} || 15 || [[凋零]]
|-
| {{cd|Starve}} || {{cd|starve}} || {{cd|starve}} || 16 || [[饥饿]]
|-
| {{cd|Anvil}} || {{cd|anvil}} || {{cd|anvil}} || 17 || [[铁砧]]
|-
| {{cd|Thorns}} || {{cd|thorns}} || {{cd|thorns}} || 18 || 荆棘
|-
| {{cd|FallingBlock}} || {{cd|falling_block}} || {{cd|falling_block}} || 19 || [[下落的方块]]（除了铁砧）
|-
| {{cd|Piston}} || {{cd|piston}} || {{cd|piston}} || 20 || [[活塞]]
|-
| {{cd|FlyIntoWall}} || {{cd|fly_into_wall}} || {{cd|fly_into_wall}} || 21 || 动能
|-
| {{cd|Magma}} || {{cd|magma}} || - || 22 || [[岩浆块]]
|-
| {{cd|Fireworks}} || {{cd|fireworks}} || - || 23 || [[烟花火箭]]
|-
| {{cd|Lightning}} || {{cd|lightning}} || - || 24 || [[闪电]]
|-
| {{cd|Charging}} || {{cd|charging}} || - || 25 || 物品或实体蓄力{{verify}}
|-
| {{cd|Temperature}} || {{cd|temperature}} || - || 26 || [[雪傀儡]]在干燥、温暖或下界[[生物群系]]中
|-
| {{cd|Freezing}} || {{cd|freezing}} || - || 27 || 冰冻
|-
| {{cd|Stalactite}} || {{cd|stalactite}} || - || 28 || 钟乳石
|-
| {{cd|Stalagmite}} || {{cd|stalagmite}} || - || 29 || 石笋
|-
| {{cd|All}} || {{cd|all}} || {{cd|fatal}} || 31 || 任意伤害<ref group = "注">源码内描述：Any damage which kills the subject</ref>
|}{{notelist}}


伤害类型又称作'''伤害来源'''（'''Damage sources'''），在源码中又被称作'''伤害成因'''（'''Damage causes'''），模组开发者可以通过以下方式调用伤害成因。
伤害类型又称作'''伤害来源'''（'''Damage sources'''），在源码中又被称作'''伤害成因'''（'''Damage causes'''），模组开发者可以通过以下方式调用伤害成因。


=== 原生 ===
===原生===


可以使用{{cd|ActorDamageCause::<''key''>}}调用到上表中的{{cd|枚举值}}列中的值，其中{{cd|<''key''>}}是上表中{{cd|枚举建}}列中的项。{{Info_needed}}
可以使用{{cd|ActorDamageCause::<''key''>}}调用到上表中的{{cd|枚举值}}列中的值，其中{{cd|<''key''>}}是上表中{{cd|枚举建}}列中的项。{{Info_needed}}


=== 附加包 ===
===附加包===


{{main|Manual:附加包|Manual:脚本引擎}}
{{main|Manual:附加包|Manual:脚本引擎}}


在[[附加包]]中伤害类型只能直接以上表中{{cd|接口字符串}}列中的值以字符串的形式被调用，目前可以[[数据驱动]]的调用方法如下：
在[[附加包]]中伤害类型只能直接以上表中{{cd|接口字符串}}列中的值以字符串的形式被调用，目前可以[[数据驱动]]的调用方法如下：
* 实体的{{cd|has_damage}}[[过滤器]]的{{cd|value}}字段；
*实体的{{cd|has_damage}}[[过滤器]]的{{cd|value}}字段；
* 实体的{{cd|[[Manual:minecraft:behavior.panic|minecraft:behavior.panic]]}}[[AI意向]]的{{cd|damage_sources}}数组；
*实体的{{cd|[[Manual:minecraft:behavior.panic|minecraft:behavior.panic]]}}[[AI意向]]的{{cd|damage_sources}}数组；
* 实体的{{cd|[[Manual:minecraft:damage_sensor|minecraft:damage_sensor]]}}[[组件]]的{{cd|triggers}}数组中每一个对象的{{cd|cause}}字段。
*实体的{{cd|[[Manual:minecraft:damage_sensor|minecraft:damage_sensor]]}}[[组件]]的{{cd|triggers}}数组中每一个对象的{{cd|cause}}字段。
* 实体的{{cd|[[Manual:minecraft:hurt_on_condition|minecraft:hurt_on_condition]]}}组件的{{cd|damage_conditions}}数组中每一个对象中的{{cd|cause}}字段；
*实体的{{cd|[[Manual:minecraft:hurt_on_condition|minecraft:hurt_on_condition]]}}组件的{{cd|damage_conditions}}数组中每一个对象中的{{cd|cause}}字段；
* 方块的{{cd|damage}}[[事件]]中的{{cd|type}}字段。
*方块的{{cd|[[Manual:damage|damage]]}}[[事件]]中的{{cd|type}}字段。


在[[脚本引擎]]中还有如下调用方法：
在[[脚本引擎]]中还有如下调用方法：
* {{cd|[[Manual:minecraft:entity_hurt|minecraft:entity_hurt]]}}服务端[[事件]]的数据中的{{cd|cause}}字段。
*{{cd|[[Manual:minecraft:entity_hurt|minecraft:entity_hurt]]}}服务端[[事件]]的数据中的{{cd|cause}}字段。


=== ModSDK ===
===模组SDK===


{{main|Manual:ModSDK|Manual:ModAPI}}
{{main|Manual:模组SDK|Manual:模组API}}


在[[ModSDK]]的[[ModAPI]]中可以使用{{cd|<''api''>.[[Manual:GetMinecraftEnum|GetMinecraftEnum]]().ActorDamageCause.<''key''>}}得到上表中的{{cd|内部ID}}列中的值，其中{{cd|<''api''>}}是Python脚本中导入的当前服务端或客户端的[[API (ModSDK)|API]]，{{cd|<''key''>}}是上表中{{cd|枚举建}}列中的项。
在[[模组SDK]]的[[模组API]]中可以使用{{cd|<''api''>.[[Manual:GetMinecraftEnum|GetMinecraftEnum]]().ActorDamageCause.<''key''>}}得到上表中的{{cd|内部ID}}列中的值，其中{{cd|<''api''>}}是Python脚本中导入的当前服务端或客户端的[[API (模组SDK)|API]]，{{cd|<''key''>}}是上表中{{cd|枚举建}}列中的项。


除了上述附加包中的数据驱动调用形式，在ModAPI中伤害类型还能以如下形式被调用：
除了上述附加包中的数据驱动调用形式，在模组API中伤害类型还能以如下形式被调用：
* 实体的{{cd|ActorHurtServerEvent}}服务端事件的数据中的{{cd|cause}}字段；
*实体的{{cd|ActorHurtServerEvent}}服务端事件的数据中的{{cd|cause}}字段；
* 实体的{{cd|ActuallyHurtServerEvent}}服务端事件的数据中的{{cd|cause}}字段；
*实体的{{cd|ActuallyHurtServerEvent}}服务端事件的数据中的{{cd|cause}}字段；
* 生物的{{cd|DamageEvent}}服务端事件的数据中的{{cd|cause}}字段。
*生物的{{cd|DamageEvent}}服务端事件的数据中的{{cd|cause}}字段。


=== InnerCore ===
===Inner Core===


{{main|Manual:InnerCore|Manual:AdaptedScript|Manual:CoreEngine}}
{{main|Manual:Inner Core|Manual:AdaptedScript|Manual:CoreEngine}}


在[[AdaptedScript]]中，{{Info_needed}}
在[[AdaptedScript]]中，{{Info_needed}}


在[[CoreEngine]]中，上表中{{cd|枚举值}}列中的值可以通过以下方法获取：
在[[CoreEngine]]中，上表中{{cd|枚举值}}列中的值可以通过以下方法获取：
* {{cd|EntityDeath}}[[回调函数]]的第三个参数；
*{{cd|EntityDeath}}[[回调函数]]的第三个参数；
* {{cd|EntityHurt}}回调函数的第四个参数；
*{{cd|EntityHurt}}回调函数的第四个参数；
* {{cd|[[Manual:Armor.registerOnHurtListener|Armor.registerOnHurtListener]]}}的第二个参函数的第五个参数。
*{{cd|[[Manual:Armor.registerOnHurtListener|Armor.registerOnHurtListener]]}}的第二个参函数的第五个参数。


上表中{{cd|枚举值}}列中的值可以通过以下方法被调用：
上表中{{cd|枚举值}}列中的值可以通过以下方法被调用：
* {{cd|[[Manual:Entity.damageEntity|Entity.damageEntity]]}}的第三个参数。
*{{cd|[[Manual:Entity.damageEntity|Entity.damageEntity]]}}的第三个参数。


{{Gameplay}}
{{Gameplay}}

2022年7月9日 (六) 09:00的最新版本

  本条目介绍的是一种改变生命值的游戏机制。关于一种能够造成伤害的药水，请见“伤害药水”。关于一种能够瞬间造成伤害的状态效果，请见“状态效果”。关于物品损失耐久的过程，请见“损坏”。
  “治疗”重定向至此。关于一种能够治疗的药水，请见“治疗药水”。关于一种能够瞬间治疗的状态效果，请见“状态效果”。关于一种代表实体HP的游戏机制，请见“生命”。
  关于更多信息，请见“Minecraft Wiki:伤害”。

伤害（Damage）是指在Minecraft中通过一个实体或世界本身造成另一个实体的生命值发生改变的过程。狭义的伤害仅指生命值减少的情形，此时，对于生命值增加的情形，我们称之为治疗（Heal）。

单位[编辑]

伤害的生命值的变化量，因此和生命值共用同一种单位，即半颗心（halfheart，♥）。每半颗心（♥）俗称1点生命值。正的伤害一般代表生命值的减少，负的伤害一般代表生命值的增加。

存储[编辑]

主条目：实体 § 存储格式

包括玩家在内的所有实体都可以拥有控制自身攻击伤害和跌落伤害的两个特性。在存档中，他们存储在每个实体的 AttributesNBT标签内，控制该实体可以造成的该种类伤害的最大值、最小值和当前值。

ID 描述
minecraft:attack_damage 控制攻击伤害
minecraft:fall_damage 控制跌落伤害

应用[编辑]

很多API中都暴露了应用伤害的接口，模组开发者可以通过以下方式使用这些接口。

原生[编辑]

‌[需要更多信息]

附加包[编辑]

主页面：Manual:附加包和Manual:脚本引擎

在附加包中可以以数据驱动的形式控制实体和方块的伤害等属性，目前可用的修改方法如下：

在脚本引擎中还有如下调用方法：

  • minecraft:entity_hurt服务端事件的数据中的absorbed_damage和damage字段，分别为此次伤害中实体由于伤害吸收状态效果吸收的伤害和最终结算的伤害。

模组SDK[编辑]

主页面：Manual:模组SDK和Manual:模组API

在在模组SDK中除了上述附加包中的数据驱动调用形式，还有以下数据驱动修改方式：

在模组API中还有如下调用方法：

  • 实体的ActorHurtServerEvent服务端事件的数据中的damage字段，为此次攻击给予的伤害；
  • 实体的ActuallyHurtServerEvent服务端事件的数据中的damage字段，为该实体受到的伤害；
  • 生物的DamageEvent服务端事件的数据中的damage字段，为该实体实际结算的伤害。
  • 玩家的PlayerAttackEntityEvent服务端事件的数据中的damage字段，为玩家此次攻击给予的伤害‌[需要验证]；
  • 弹射物的projectile类的CreateProjectileEntity组件第三个参数对象的damage字段，为该弹射物的伤害值；
  • 实体的hurt类的SetHurtByEntity组件第二个参数，为对实体造成伤害值。

Inner Core[编辑]

主页面：Manual:Inner Core、Manual:AdaptedScript和Manual:CoreEngine

在AdaptedScript中，‌[需要更多信息]

在CoreEngine中，伤害可以通过以下方法获取：

上表中网络ID列中的值可以通过以下方法被调用：

ModPE[编辑]

主页面：Manual:ModPE

在ModPE中，可以使用以下钩子函数来获取伤害：

  • entityHurtHook的第三个参数，为该实体受伤时结算的伤害。

伤害类型[编辑]

Minecraft中的伤害由来源不同被分为很多伤害类型（Damage types）。不仅不同的伤害类型在实体受到伤害时会被分开结算，玩家的死亡信息也会由类型不同而有所不同。下面列出当前游戏内所有伤害类型的表格以及他们的相关数据，该表格源自源码中的ActorDamageCause类。

活动对象伤害成因枚举
键名 值 接口字符串 接口可用性 版际可用性 原版用例
过滤器[注 1] 其他[注 2] 国际版 中国版
— -2 fatal 可用 不可用 可用 可用 任意能够杀死主体的致命伤害
None -1 none 可用 可用 可用 可用 无
Override 0 override 可用 可用 可用 可用 程序直接覆写生命值
Contact 1 contact 可用 可用 可用 可用 仙人掌或甜浆果丛
EntityAttack 2 entity_attack attack 可用 可用 可用 近战攻击
Projectile 3 projectile 可用 可用 可用 可用 弹射物
Suffocation 4 suffocation 可用 可用 可用 可用 窒息
Fall 5 fall 可用 可用 可用 可用 跌落或末影珍珠
Fire 6 fire 可用 可用 可用 可用 火
FireTick 7 fire_tick 可用 可用 可用 可用 身上连续着火
Lava 8 lava 可用 可用 可用 可用 熔岩
Drowning 9 drowning 可用 可用 可用 可用 溺水或淋雨
BlockExplosion 10 block_explosion 可用 可用 可用 可用 方块爆炸
EntityExplosion 11 entity_explosion 可用 可用 可用 可用 实体爆炸
Void 12 void 可用 可用 可用 可用 虚空
SelfDestruct 13 suicide 可用 可用 可用 可用 /kill命令
Magic 14 magic 可用 可用 可用 可用 药水、龙息、唤魔者尖牙或守卫者激光
Wither 15 wither 可用 可用 可用 可用 凋零
Starve 16 starve 可用 可用 可用 可用 饥饿
Anvil 17 anvil 可用 可用 可用 可用 铁砧
Thorns 18 thorns 可用 可用 可用 可用 荆棘
FallingBlock 19 falling_block 可用 可用 可用 可用 下落的方块（除了铁砧）
Piston 20 piston 可用 可用 可用 可用 活塞
FlyIntoWall 21 fly_into_wall 可用 可用 可用 可用 动能
Magma 22 magma 不可用 可用 可用 可用 岩浆块
Fireworks 23 fireworks 不可用 可用 可用 可用 烟花火箭
Lightning 24 lightning 不可用 可用 可用 可用 闪电
Charging 25 charging 不可用 可用 可用 可用 物品或实体蓄力‌[需要验证]
Temperature 26 temperature 不可用 可用 可用 可用 雪傀儡在干燥、温暖或下界生物群系中
Freezing 27 freezing 不可用 可用 可用 可用 冰冻
Stalactite 28 stalactite 可用 可用 可用 可用 钟乳石
Stalagmite 29 stalagmite 可用 可用 可用 可用 石笋
RamAttack 30 ram_attack 不可用 可用 不可用 可用 冲撞攻击
SonicBoom 31 sonic_boom 可用 不可用 可用 即将到来 音爆
Campfire 32 — — — — — 篝火
SoulCampfire 33 — — — — — 灵魂火
All 34 all 不可用 不可用 可用 可用 任意伤害类型
— — durability 不可用 部分 可用 可用 物品耐久[注 3][注 4]
  1. ↑ 这包括has_damage过滤器的value字段。
  2. ↑ 这包括
  3. ↑ 对于物品来说，过滤器主体必须为self。对于方块来说，过滤器主体必须为item
  4. ↑ 事实上，源码内并无durability类型，当满足损坏物品的条件时，伤害类型可以为任意字符串，且不会对物品的损坏情况造成任何影响。durability类型为约定俗成的写法。

伤害类型又称作伤害来源（Damage sources），在源码中又被称作伤害成因（Damage causes），模组开发者可以通过以下方式调用伤害成因。

原生[编辑]

可以使用ActorDamageCause::<key>调用到上表中的枚举值列中的值，其中<key>是上表中枚举建列中的项。‌[需要更多信息]

附加包[编辑]

主页面：Manual:附加包和Manual:脚本引擎

在附加包中伤害类型只能直接以上表中接口字符串列中的值以字符串的形式被调用，目前可以数据驱动的调用方法如下：

在脚本引擎中还有如下调用方法：

模组SDK[编辑]

主页面：Manual:模组SDK和Manual:模组API

在模组SDK的模组API中可以使用<api>.GetMinecraftEnum().ActorDamageCause.<key>得到上表中的内部ID列中的值，其中<api>是Python脚本中导入的当前服务端或客户端的API，<key>是上表中枚举建列中的项。

除了上述附加包中的数据驱动调用形式，在模组API中伤害类型还能以如下形式被调用：

  • 实体的ActorHurtServerEvent服务端事件的数据中的cause字段；
  • 实体的ActuallyHurtServerEvent服务端事件的数据中的cause字段；
  • 生物的DamageEvent服务端事件的数据中的cause字段。

Inner Core[编辑]

主页面：Manual:Inner Core、Manual:AdaptedScript和Manual:CoreEngine

在AdaptedScript中，‌[需要更多信息]

在CoreEngine中，上表中枚举值列中的值可以通过以下方法获取：

上表中枚举值列中的值可以通过以下方法被调用：

游戏内容

参见：Template:Gameplay/content [编辑]
取自“https://wiki.mcbe-dev.net/w/index.php?title=伤害&oldid=17061”