---
name: "BIS_fnc_assignPlayerRole"
type: function
status: ok
groups: ["Object Manipulation"]
arma3_since: "0.50"
locality: {"argument": null, "effect": "local", "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_assignPlayerRole
revid: 326919
updated: 2022-07-12T21:44:38Z
---

# BIS_fnc_assignPlayerRole

*Function · Object Manipulation · Arma 3 v0.50 · introduced in Take On Helicopters v1.00*

Locality: effect **local**

## Description

Ensures the player can only get in the specific vehicle role.

## Syntax

```sqf
[vehicle, role, path] call BIS_fnc_assignPlayerRole
```

**Parameters:**

- `vehicle`: [Object](../topics/Object.md) - targeted vehicle
- `role`: [String](../topics/String.md) - can be one of:
  - "driver"
  - "gunner"
  - "commander"
  - "cargo"
  - "turret"
- `path`: [Array](../topics/Array.md) or [Number](../topics/Number.md)s - the turret path

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

## Examples

### Example 1

```sqf
[myVehicle, "turret", [0, 1]] call BIS_fnc_assignPlayerRole;
```

## See also

[assignAsDriver](../commands/assignAsDriver.md) · [assignAsGunner](../commands/assignAsGunner.md) · [assignAsCommander](../commands/assignAsCommander.md) · [assignAsCargo](../commands/assignAsCargo.md) · [assignAsTurret](../commands/assignAsTurret.md)

<sub>Source: [BI Community Wiki — BIS fnc assignPlayerRole](https://community.bistudio.com/wiki/BIS_fnc_assignPlayerRole) (revision 326919).</sub>