---
name: "setOxygenRemaining"
type: command
status: ok
groups: ["Object Manipulation"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/setOxygenRemaining
revid: 377982
updated: 2026-01-20T14:37:17Z
---

# setOxygenRemaining

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

## Description

Sets oxygen remaining. It has no effect when soldier is not diving.

## Syntax

```sqf
unit setOxygenRemaining value
```

**Parameters:**

- `unit`: [Object](../topics/Object.md)
- `value`: [Number](../topics/Number.md) in range 0..1

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

## Examples

### Example 1

```sqf
if (!isAbleToBreathe player) then
{
    player setOxygenRemaining 0; // drowns player
};
```

## See also

[isAbleToBreathe](../commands/isAbleToBreathe.md) · [getOxygenRemaining](../commands/getOxygenRemaining.md)

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