---
name: "BIS_fnc_taskPatrol"
type: function
status: ok
groups: ["Tasks"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_taskPatrol
revid: 364486
updated: 2024-05-16T20:41:57Z
---

# BIS_fnc_taskPatrol

*Function · Tasks · Arma 3 v0.50 · introduced in Arma 2 v1.00*

## Description

Create a random patrol of several waypoints around a given [position](../commands/position.md).

> [!NOTE]
> In Arma 2, the Functions Module is required.

## Syntax

```sqf
[group, position, distance, blacklist] call BIS_fnc_taskPatrol
```

**Parameters:**

- `group`: [Group](../topics/Group.md) - the [group](../commands/group.md) to patrol
- `position`: [Position](../topics/Position.md) - the [position](../commands/position.md) on which to base the patrol
- `distance`: [Number](../topics/Number.md) - maximum [distance](../commands/distance.md) between waypoints in meters
- `blacklist`: [Array](../topics/Array.md) - (optional) blacklist of areas

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

## Examples

### Example 1

```sqf
[group _unit, getPos _unit, 1000] call BIS_fnc_taskPatrol;
```

## See also

Functions Library · [BIS_fnc_taskAttack](../functions/BIS_fnc_taskAttack.md) · [BIS_fnc_taskDefend](../functions/BIS_fnc_taskDefend.md)

<sub>Source: [BI Community Wiki — BIS fnc taskPatrol](https://community.bistudio.com/wiki/BIS_fnc_taskPatrol) (revision 364486).</sub>