on_entity_damaged

Called when an entity is damaged. This is not called when an entities health is set directly by another mod.

Event Data

• entity: LuaEntity
• damage_type: LuaDamagePrototype
• original_damage_amount: float — The damage amount before resistances.
• final_damage_amount: float — The damage amount after resistances.
• final_health: float — The health of the entity after the damage was applied.
• cause?: LuaEntity — The entity that originally triggered the events that led to this damage, if available (e.g. the character, turret, etc. that pulled the trigger).
• source?: LuaEntity — The entity that is directly dealing the damage, if available (e.g. the projectile, flame, sticker, grenade, laser beam, etc.).
• force?: LuaForce — The force that did the attacking if any.
• name: defines.events — Identifier of the event
• tick: uint32 — Tick the event was generated.