---
name: "fuel"
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/fuel
revid: 376958
updated: 2026-01-01T05:49:41Z
---

# fuel

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

Locality: arguments **global**

## Description

Checks how much fuel is left in the gas tank of a vehicle.

## Syntax

```sqf
fuel vehicle
```

**Parameters:**

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

**Returns:** [Number](../topics/Number.md) in range 0..1 - 0 (empty tank) to 1 (full tank).

## Examples

### Example 1

```sqf
if (fuel vehicle player == 0) then { hint "The vehicle is out of fuel!" };
```

## See also

[setFuel](../commands/setFuel.md) · [setFuelCargo](../commands/setFuelCargo.md) · [getFuelCargo](../commands/getFuelCargo.md)

## Community notes

**UNN** — 2006-08-13

Vehicles refuelled in game with the Fuel trucks e.t.c never get completely refuelled. After refuelling, rather than returning a value of 1 when the [fuel](../commands/fuel.md) command is called.
They return a value greater than 0.98 and less than 1.

---

**fusselwurm** — 2020-12-19

returns
- *1* for units (dead or alive)
- *0* for *objNull*

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