---
name: "damage"
type: command
status: ok
groups: ["Object Manipulation"]
arma3_since: "0.50"
locality: {"argument": "global", "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/damage
revid: 364153
updated: 2024-05-05T10:44:17Z
---

# damage

*Command · Object Manipulation · Arma 3 v0.50 · introduced in Operation Flashpoint vNone*

Locality: arguments **global**

Alias: [getDammage](../commands/getDammage.md)

## Description

Return the damage value of an object.

## Syntax

```sqf
damage object
```

**Parameters:**

- `object`: [Object](../topics/Object.md)

**Returns:** [Number](../topics/Number.md) - the returned number in range (healthy) 0..1 (dead).

## Examples

### Example 1

```sqs
? damage player > 0.1 : player groupChat "I'm hurt! Medic!"
```

### Example 2

```sqf
if (damage player > 0.1) then
{
    player groupChat "I'm hurt! Medic!";
};
```

### Example 3

```sqf
private _health = (1 - damage player) * 100; // health in % from 0 to 100
```

## See also

[setDamage](../commands/setDamage.md) · [setHit](../commands/setHit.md) · [getHit](../commands/getHit.md) · [getHitIndex](../commands/getHitIndex.md) · [setHitIndex](../commands/setHitIndex.md) · [getHitPointDamage](../commands/getHitPointDamage.md) · [setHitPointDamage](../commands/setHitPointDamage.md) · [waterDamaged](../commands/waterDamaged.md) · [Arma 3: Event Handlers](../topics/Event_Handlers.md)

## Community notes

**Pierre MGI** — 2015-02-13

The returned value depends on the couple target/ammo fired. This value has no correlation with the sum of all hitpoints damage status and the effective status of the object.
Firing bullets on cars often lead to weird results. For example: [damage](../commands/damage.md) returns zero while a Hunter is fired at will with an .50 HMG! Hunter can be almost destroyed with zero damage for this function.
If you script, use instead the [getHitPointDamage](../commands/getHitPointDamage.md) command.

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