---
name: "BIS_fnc_unitPlay"
type: function
status: ok
groups: ["Scenes"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_unitPlay
revid: 349483
updated: 2023-11-08T17:09:03Z
---

# BIS_fnc_unitPlay

*Function · Scenes · Arma 3 v0.50 · introduced in Arma 2: Operation Arrowhead v1.50*

Locality: executed with **spawn**

## Description

Plays back input movement data on input unit.

## Syntax

```sqf
[unit, data, varDone, stateIgnore, obsolete_1, obsolete_2, skipTime] spawn BIS_fnc_unitPlay
```

**Parameters:**

- `unit`: [Object](../topics/Object.md) - unit to play movement data on
- `data`: [Array](../topics/Array.md) - movement data recorder by [BIS_fnc_unitCapture](../functions/BIS_fnc_unitCapture.md)
- `varDone`: [Array](../topics/Array.md) - (Optional, default `[]`) variable to set on specified Object once playback has finished in format:
  - 0: [Object](../topics/Object.md) - Target object
  - 1: [String](../topics/String.md) - Variable name
- `stateIgnore`: [Boolean](../topics/Boolean.md) - (Optional, default [false](../commands/false.md)) whether to ignore if the Unit is dead and/or cannot move
- `obsolete_1`: [Nothing](../topics/Nothing.md) - obsolete param, preserved because of backward compatibility
- `obsolete_2`: [Nothing](../topics/Nothing.md) - obsolete param, preserved because of backward compatibility
- `skipTime`: [Number](../topics/Number.md) - (Optional, default 0) amount of time to skip at the start of playback. For example if you wish to play the data from halfway instead of the start.

**Returns:** [Boolean](../topics/Boolean.md) - always [true](../commands/true.md)

## Examples

### Example 1

```sqf
[vehicle player, _unitCaptureData] spawn BIS_fnc_unitPlay
```

## See also

[BIS_fnc_unitCaptureFiring](../functions/BIS_fnc_unitCaptureFiring.md) · [BIS_fnc_unitCaptureSimple](../functions/BIS_fnc_unitCaptureSimple.md) · [BIS_fnc_unitPlaySimple](../functions/BIS_fnc_unitPlaySimple.md) · [BIS_fnc_unitPlayFiring](../functions/BIS_fnc_unitPlayFiring.md) · [BIS_fnc_unitCapture](../functions/BIS_fnc_unitCapture.md)

<sub>Source: [BI Community Wiki — BIS fnc unitPlay](https://community.bistudio.com/wiki/BIS_fnc_unitPlay) (revision 349483).</sub>