Difference between revisions of "Osiris/API/CharacterReceivedDamage"
From Divinity Engine Wiki
m |
m |
||
| Line 10: | Line 10: | ||
* This event is thrown even if '''_Percentage''' 0.0, i.e., if all damage was blocked by armor or because '''_Character''' is immune to the damage type. | * This event is thrown even if '''_Percentage''' 0.0, i.e., if all damage was blocked by armor or because '''_Character''' is immune to the damage type. | ||
* This event is ''not'' thrown if the "damage" healed '''_Character''' (e.g. poison damage to a zombie); in that case, a corresponding HEAL status will be applied to '''_Character''' instead. | * This event is ''not'' thrown if the "damage" healed '''_Character''' (e.g. poison damage to a zombie); in that case, a corresponding HEAL status will be applied to '''_Character''' instead. | ||
| + | * The '''_Percentage''' and '''_Source''' parameters are new in DOS2 Patch 5. | ||
===== See Also ===== | ===== See Also ===== | ||
* [[Osiris/API/AttackedByObject|AttackedByObject]] | * [[Osiris/API/AttackedByObject|AttackedByObject]] | ||
Revision as of 15:02, 25 November 2017
Full Definition(s)
- event CharacterReceivedDamage((CHARACTERGUID)_Character, (INTEGER)_Percentage, (GUIDSTRING)_Source)
Description
Thrown when a character receives damage from an attack or an environmental effect such as a surface.
Parameters
- _Character: The character that was damaged.
- _Percentage: The percentage of vitality/hit points that was removed by this damage event.
- _Source: The GUID of the character or item that caused the damage. In case the damage is caused by a surface, this will be the creator of said surface (can be NULL if the game cannot determine the party responsible, e.g. if you are damaged by a static fire surface that was painted in the editor).
Notes
- This event is thrown even if _Percentage 0.0, i.e., if all damage was blocked by armor or because _Character is immune to the damage type.
- This event is not thrown if the "damage" healed _Character (e.g. poison damage to a zombie); in that case, a corresponding HEAL status will be applied to _Character instead.
- The _Percentage and _Source parameters are new in DOS2 Patch 5.
