setHitIndex: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\|x([0-9])= *<code>([^<]*)<\/code>" to "|x$1= <sqf>$2</sqf>")
No edit summary
Line 12: Line 12:
|descr= Sets the current level of damage for a specific Hit Point. All hit points can be obtained with [[getAllHitPointsDamage]] command.
|descr= Sets the current level of damage for a specific Hit Point. All hit points can be obtained with [[getAllHitPointsDamage]] command.


|s1= vehicle [[setHitIndex]] [hitPartIndex, damage, useEffects, instigator]
|s1= vehicle [[setHitIndex]] [hitPartIndex, damage, useEffects, killer]


|p1= vehicle : [[Object]] - Vehicle to be damaged
|p1= vehicle : [[Object]] - Vehicle to be damaged
Line 24: Line 24:
|p4= {{GVI|arma3|1.68}} useEffects: [[Boolean]] - (Optional, default [[true]]) [[false|False]] to skip destruction effects
|p4= {{GVI|arma3|1.68}} useEffects: [[Boolean]] - (Optional, default [[true]]) [[false|False]] to skip destruction effects


|p5= {{GVI|arma3|2.08}} instigator: [[Object]] - (Optional, default [[objNull]]) The object that caused the damage. If the damage leads to the death of the unit, the instigator will be used as the object that caused the kill. <br>
|p5= {{GVI|arma3|2.08}} killer: [[Object]] - (Optional, default [[objNull]]) The entity that caused the damage. If the damage leads to the death of the unit, the killer will be used as the object that caused the kill. <br>
* It can be used to show "killed by player" in debriefing statistics and kill messages in the chat (if death messages are enabled). <br>
* It can be used to show "killed by player" in debriefing statistics and kill messages in the chat (if death messages are enabled). <br>
* It will alter the instigator's [[rating]] as if the instigator directly killed the unit. <br>
* It will alter the killer's [[rating]] as if the killer directly killed the unit. <br>
* It will be listed as {{ic|_killer}} parameter in the [[Arma_3:_Event_Handlers#Killed|Killed]] event handler.
* It will be listed as {{ic|_killer}} parameter in the [[Arma_3:_Event_Handlers#Killed|Killed]] event handler.



Revision as of 22:40, 23 July 2022

Hover & click on the images for description

Description

Description:
Sets the current level of damage for a specific Hit Point. All hit points can be obtained with getAllHitPointsDamage command.
Groups:
Object Manipulation

Syntax

Syntax:
vehicle setHitIndex [hitPartIndex, damage, useEffects, killer]
Parameters:
vehicle : Object - Vehicle to be damaged
hitPartIndex: Number - Hit part index of the Hit Point
damage: Number - Level of damage
  • 0: no damage
  • 1: full damage
Arma 3 logo black.png1.68 useEffects: Boolean - (Optional, default true) False to skip destruction effects
Arma 3 logo black.png2.08 killer: Object - (Optional, default objNull) The entity that caused the damage. If the damage leads to the death of the unit, the killer will be used as the object that caused the kill.
  • It can be used to show "killed by player" in debriefing statistics and kill messages in the chat (if death messages are enabled).
  • It will alter the killer's rating as if the killer directly killed the unit.
  • It will be listed as _killer parameter in the Killed event handler.
Return Value:
Nothing

Examples

Example 1:
vehicle player setHitIndex [1, 1];
Example 2:
player setHitIndex [7, 0.5];

Additional Information

See also:
getAllHitPointsDamage getHitIndex getHitPointDamage setHitPointDamage setHit getHit setDamage damage

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note