手册:damage (方块事件响应)

来自Minecraft基岩版开发Wiki
damage
附加包方块事件
组件所属
方块
组件类型
event
API
数据驱动
格式版本
1.16.100
加入版本
  本页面介绍的是一种方块事件响应。关于同名物品事件响应，请见“damage”。

使方块对目标造成损坏或伤害。

语法[编辑]

"damage": {
  "amount": <par1>,
  "target": "<par2>",
  "type": "<par3>"
}

结构[编辑]

  •  damage：根对象。
    •  amount：设置损伤量。默认值为0。
    •  target：设置事件执行的目标，为一个过滤器主体。默认值为self。
    •  type：设置伤害或损坏的类型。

过滤器主体列表[编辑]

过滤器主体枚举
键名 值 接口字符串 触发器 过滤器 事件响应 描述
Self 0 self 可用 可用 可用 上下文中的对象自身，事件触发者或其对应持有者。
Other 1 other 可用 可用 可用 上下文中对象的对立者，事件触发者的对立者。
Player 2 player 可用 可用 可用 上下文中的玩家。
Target 3 target 可用 可用 可用 上下文中的目标，对于实体而言多为对象自身的攻击目标。
Parent 4 parent 可用 可用 可用 上下文中的父级，对于实体而言多为对象自身的亲代。
Baby 5 baby 可用 不可用 可用 上下文中的子级，对于实体而言多为对象自身的子代。
Block 6 block 可用 可用 可用 上下文中的方块，对于方块而言为该对象自身。
Damager 7 damager 可用 可用 可用 上下文中的伤害来源。
Holder 8 holder 可用 不可用 可用 上下文中的有效持有者。
Item 9 item 可用 不可用 可用 上下文中的物品，这包括方块的物品形态，或上下文中该物品的持有者。

伤害类型列表[编辑]

活动对象伤害成因枚举
键名 值 接口字符串 接口可用性 版际可用性 原版用例
过滤器[注 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类型为约定俗成的写法。

历史[编辑]

基岩版
1.16.1001.16.100.56加入了damage。

漏洞[编辑]

关于“damage”的漏洞在国际版中由漏洞追踪器维护，请在此报告漏洞。

注释[编辑]

检索自“https://wiki.mcbe-dev.net/w/index.php?title=Manual:Damage_(方块事件响应)&oldid=22918”