---
name: "getAllHitPointsDamage"
type: command
status: ok
groups: ["Object Manipulation"]
arma3_since: "1.50"
locality: {"argument": "global", "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/getAllHitPointsDamage
revid: 376957
updated: 2026-01-01T05:46:28Z
---

# getAllHitPointsDamage

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

Locality: arguments **global**

## Description

Get provided object's hit points damage.

## Syntax

```sqf
getAllHitPointsDamage entity
```

**Parameters:**

- `entity`: [Object](../topics/Object.md) - object to be queried

**Returns:** [Array](../topics/Array.md) - [] if entity is null or has no shape, otherwise [hitpointNames, selectionNames, damageValues]:
- hitpointNames: [Array](../topics/Array.md) of [String](../topics/String.md)s
- selectionNames: [Array](../topics/Array.md) of [String](../topics/String.md)s
- damageValues: [Array](../topics/Array.md) of [Number](../topics/Number.md)s in range 0..1 - where 0 = no damage, 1 = full damage
All values in all arrays are ordered accordingly to hit part index for convenience and for use in [setHitIndex](../commands/setHitIndex.md) and [getHitIndex](../commands/getHitIndex.md).

## Examples

### Example 1

```sqf
hint str getAllHitPointsDamage player;
/*
[
    ["hitface","hitneck","hithead","hitpelvis","hitabdomen","hitdiaphragm","hitchest","hitbody","hitarms","hithands","hitlegs","incapacitated"],
    ["face_hub","neck","head","pelvis","spine1","spine2","spine3","body","arms","hands","legs","body"],
    [0,0,0,0,0,0,0,0,0,0,0,0]
]
*/
```

### Example 2

```sqf
hint str getAllHitPointsDamage vehicle player;
/*
[
    ["hithull","hitengine","hitengine2","hitavionics","hitfuel","hitfuel2","hitglass1","hitlaileron","hitraileron","hitlcrudder","hitrrudder","hitlcelevator","hitrelevator","#gear_f_lights"],
    ["hithull","hitengine","hitengine2","hitavionics","hitfuel","hitfuel2","hitglass1","hitlaileron","hitraileron","hitlcrudder","hitrrudder","hitlcelevator","hitrelevator"," "],
    [0,0,0,0,0,0,0,0,0,0,0,0,0,0]
]
*/
```

## See also

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

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