setHit

Description

Set damage on a part of an object.

Note

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

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

• useEffects: Boolean - (Optional, default true) false to skip destruction effects (since arma3 1.68)

• 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 arma3 2.08)

• 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 arma3 2.12)

• 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. (since arma3 2.18)

Returns: 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!");
};

See also

getHit · getHitPointDamage · setHitPointDamage · damage · setDamage · setFuel · setAmmo · getHitIndex · setHitIndex · forceHitPointsDamageSync

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

_MH60S setHit ["elektronika", _hit];

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