setHit

1.00

1.50

1.00

0.50

LALocal GEGlobal

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

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];