setHit

1.001.501.000.50

LALocalGEGlobal

Hover & click on the images for description

Description

Description:

Event Handler	Triggered
Hit
HandleDamage
Killed
MPKilled

Set damage on a part of an object.

ⓘ

Some part names are in Czech; see the translation table.

Groups:

Object Manipulation

Syntax

Syntax:

object setHit [part, damage, useEffects, killer, instigator, breakRotor]

Parameters:

object: Object - local object

part: String - name of the part (selection name)

damage: Number - damage value ranging 0..1, 0 being fully functional, 1 being destroyed

since 1.68

useEffects: Boolean - (Optional, default true) false to skip destruction effects

since 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.

• 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.

since 2.12

instigator: Object - (Optional, default objNull) the person that instigated the damage.

• if a tank is a killer, the tank gunner that pulled the trigger is instigator
• it will be listed as _instigator parameter in the Killed event handler.

since 2.16

breakRotor: Boolean - (Optional, default false) if the hitpoint is rotor on a helicopter, true will break the rotor as well as play corresponding sound if 'useEffects' is also true.

Return Value:

Nothing

Examples

Example 1:

vehicle player setHit ["motor", 1];

Example 2:

vehicle player setHit ["mala vrtule", 0.95];

Example 3:

if (local _heli) then { _heli setHit ["velka vrtule", 0]; } else { hint ("Vehicle " + str _heli + " must be local to this machine to do that!"); };

Additional Information

See also:

getHit getHitPointDamage setHitPointDamage damage setDamage setFuel setAmmo getHitIndex setHitIndex forceHitPointsDamageSync

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

Deadfast - c

Posted on Aug 24, 2009 - 11:09 (UTC)

1.00

Damaging specific parts of the vehicle will not update its overall damage value (as of v1.03):

player setHit ["hands", 0.9]; hint str (damage player); // will return 0

DenV - c

Posted on Mar 29, 2011 - 14:25 (UTC)

Direct use of the names of sections of the model is likely a bad practice, and will not work on some addons. So instead:

_MH60S setHit ["elektronika", _hit];

should be used:

_MH60S setHit [getText (configFile >> "cfgVehicles" >> "MH60S" >> "HitPoints" >> "HitAvionics" >> "name"), _hit];