---
name: "getUnitFreefallInfo"
type: command
status: ok
groups: ["Object Manipulation"]
arma3_since: "2.10"
locality: {"argument": "local", "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/getUnitFreefallInfo
revid: 377879
updated: 2026-01-04T16:08:21Z
---

# getUnitFreefallInfo

*Command · Object Manipulation · Arma 3 v2.10*

Locality: arguments **local**

## Description

Returns a unit's freefall information.

## Syntax

```sqf
getUnitFreefallInfo unit
```

**Parameters:**

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

**Returns:** [Array](../topics/Array.md) with [isFalling, isInFreefallPose, minFreefallHeight]
- isFalling: [Boolean](../topics/Boolean.md) - [true](../commands/true.md) if unit is falling
- isInFreefallPose: [Boolean](../topics/Boolean.md) - [true](../commands/true.md) if unit is in freefall pose
- minFreefallHeight: [Number](../topics/Number.md) - current minimum freefall height (see [setUnitFreefallHeight](../commands/setUnitFreefallHeight.md))

## Examples

### Example 1

```sqf
getUnitFreefallInfo player;
```

## See also

[setUnitFreefallHeight](../commands/setUnitFreefallHeight.md) · [getUserInfo](../commands/getUserInfo.md) · [getModelInfo](../commands/getModelInfo.md)

## Community notes

**Sa-Matra** — 2023-05-08

Note that command is supposed to be used on local units. When used  on a remote unit, its return (isFalling) is unreliable and sometimes returns wrong values.

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