---
name: "setHitIndex"
type: command
status: ok
groups: ["Object Manipulation"]
arma3_since: "1.50"
locality: {"argument": "local", "effect": "global", "server_exec": false}
source: https://community.bistudio.com/wiki/setHitIndex
revid: 377888
updated: 2026-01-04T16:34:13Z
---

# setHitIndex

*Command · Object Manipulation · Arma 3 v1.50*

Locality: arguments **local** · effect **global**

## Description

Sets the current level of damage for a specific Hit Point. All hit points can be obtained with [getAllHitPointsDamage](../commands/getAllHitPointsDamage.md) command.

## Syntax

```sqf
vehicle setHitIndex [hitPartIndex, damage, useEffects, killer, instigator, breakRotor]
```

**Parameters:**

- `vehicle` : [Object](../topics/Object.md) - vehicle to be damaged
- `hitPartIndex`: [Number](../topics/Number.md) - hit part index of the Hit Point
- `damage`: [Number](../topics/Number.md) in range 0..1 - level of damage, 0 = no damage, 1 = full damage
- `useEffects`: [Boolean](../topics/Boolean.md) - (Optional, default [true](../commands/true.md)) [false](../commands/false.md) to skip destruction effects *(since arma3 1.68)*
- `killer`: [Object](../topics/Object.md) - (Optional, default [objNull](../commands/objNull.md)) 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](../commands/rating.md) as if the killer directly killed the unit.

  - It will be listed as `_killer` parameter in the [Killed](../topics/Event_Handlers.md#killed) event handler. *(since arma3 2.08)*
- `instigator`: [Object](../topics/Object.md) - (Optional, default [objNull](../commands/objNull.md)) 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](../topics/Event_Handlers.md#killed) event handler. *(since arma3 2.12)*
- `breakRotor`: [Boolean](../topics/Boolean.md) - (Optional, default [false](../commands/false.md)) if the hitpoint is rotor on a helicopter, [true](../commands/true.md) will break the rotor as well as play corresponding sound if 'useEffects' is also [true](../commands/true.md). *(since arma3 2.18)*

**Returns:** [Nothing](../topics/Nothing.md)

## Examples

### Example 1

```sqf
vehicle player setHitIndex [1, 1];
```

### Example 2

```sqf
player setHitIndex [7, 0.5];
```

## See also

[getAllHitPointsDamage](../commands/getAllHitPointsDamage.md) · [getHitIndex](../commands/getHitIndex.md) · [getHitPointDamage](../commands/getHitPointDamage.md) · [setHitPointDamage](../commands/setHitPointDamage.md) · [setHit](../commands/setHit.md) · [getHit](../commands/getHit.md) · [setDamage](../commands/setDamage.md) · [damage](../commands/damage.md) · [forceHitPointsDamageSync](../commands/forceHitPointsDamageSync.md)

<sub>Source: [BI Community Wiki — setHitIndex](https://community.bistudio.com/wiki/setHitIndex) (revision 377888).</sub>