assignedVehicleRole: Difference between revisions

Revision as of 12:55, 20 January 2022

Hover & click on the images for description

Description:: Returns the role a unit is assigned to within its assigned vehicle.
ⓘ
See AI Group Vehicle Management for more information.
Multiplayer:: On a client the command will return empty arrays for every unit that is not local. On the server the command correctly returns the role, regardless of the units locality.
Groups:: Object Manipulation

Syntax:

assignedVehicleRole unitName

Parameters:

unitName: Object

Return Value:

Array - The array which is returned contains:

[] - Not assigned to any vehicle
["driver"] - Assigned as driver
["cargo"] (or ["cargo", [turret path]] since Arma 3 1.31.127272) - Assigned as cargo
["turret", [turret path]] - Assigned to a turret

Example 1:: _RoleArray = assignedVehicleRole player;
Example 2:: Get weapons available to player at player occupied turret:_weaponsTurret = vehicle player weaponsTurret (assignedVehicleRole player select 1);

See also:: addVehicle assignedVehicle unassignVehicle leaveVehicle assignAsCargo assignAsCommander assignAsDriver assignAsGunner assignAsTurret crew fullCrew

: Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note


: Posted on August 31, 2013
Killzone_Kid: When player is in a group of AIs and is not the leader, assignedVehicleRole of the player could be unpredictable and absolutely not related to the position player occupies. In short, forget about this command for the player, it is unreliable and has been broken too many times in the past.

@@ Line 38: / Line 38: @@
 |x2= Get weapons available to player at player occupied turret:<code>_weaponsTurret = [[vehicle]] [[player]] [[weaponsTurret]] ([[assignedVehicleRole]] [[player]] [[select]] 1);</code>
-|seealso= [[addVehicle]], [[assignedVehicle]], [[unassignVehicle]], [[leaveVehicle]], [[assignAsCargo]], [[assignAsCommander]], [[assignAsDriver]], [[assignAsGunner]], [[assignAsTurret]], [[crew]], [[fullCrew]]
+|seealso= [[addVehicle]] [[assignedVehicle]], [[unassignVehicle]], [[leaveVehicle]], [[assignAsCargo]], [[assignAsCommander]], [[assignAsDriver]], [[assignAsGunner]], [[assignAsTurret]], [[crew]], [[fullCrew]]
 }}