---
name: "findCover"
type: command
status: broken
groups: ["Broken Commands"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/findCover
revid: 377600
updated: 2026-01-02T07:01:58Z
---

# findCover

*Command · Broken Commands · Arma 3 v0.50 · introduced in Armed Assault v1.00*

> [!WARNING]
> This command is listed as broken on the wiki.

## Description

Returns the object around where the unit finds cover. The minDist, visibilityPosition and ignoreObject parameters are optional.

> [!IMPORTANT]
> Not implemented in Arma 2 and later titles (always returns [objNull](../commands/objNull.md)).

## Syntax

```sqf
object findCover [position, hidePosition, maxDist, minDist, visibilityPosition, ignoreObject]
```

**Parameters:**

- `object`: [Object](../topics/Object.md)
- `position`: [Position](../topics/Position.md)
- `hidePosition`: [PositionATL](../topics/Position.md#positionatl) - [getHideFrom](../commands/getHideFrom.md)-like position from which the unit should hide
- `maxDist`: [Number](../topics/Number.md)
- `minDist`: [Number](../topics/Number.md) - (Optional)
- `visibilityPosition`: [Position](../topics/Position.md) - (Optional) used to select cover that unit can see in that direction from
- `ignoreObject`: [Object](../topics/Object.md) - (Optional) ignore this object in visibility check

**Returns:** [Object](../topics/Object.md) - always [objNull](../commands/objNull.md)

## Examples

### Example 1

```sqf
unit1 findCover [ASLToATL aimPos unit2, 30];
```

## See also

[getHideFrom](../commands/getHideFrom.md) · [setHideBehind](../commands/setHideBehind.md) · [isHidden](../commands/isHidden.md)

## Community notes

**SnowSky** — 2015-07-04

An alternative function in Arma 3 might be [BIS_fnc_findSafePos](../functions/BIS_fnc_findSafePos.md).

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