fullCrew

From Bohemia Interactive Community
Jump to: navigation, search
Introduced with Arma 3 version 1.34
  Arguments of this scripting command don't have to be local to the client the command is executed on

Click on the images for descriptions

Introduced in

Game:
Arma 3
Version:
1.34

Description

Description:
Returns array with all crew inside given vehicle. Since Arma 3 v1.55.133810 it is possible to return empty seats as well.

NOTE that with introduction of person turrets, the cargo indexes listed in the return are true for moveInCargo command but incompatible with actions such as "GetInCargo" and "MoveToCargo". To find out seats compatible with cargo action commands, execute command with "cargo" filter: fullCrew [heli, "cargo", true]; The return array is ordered according to cargo index compatible with action cargo commands, i.e. 1st element has index 0, second - index 1, etc. For example armed WY-55 Hellcat reports:
  • [[<NULL-object>,"cargo",2,[],false],[<NULL-object>,"cargo",3,[],false],[<NULL-object>,"cargo",4,[],false],[<NULL-object>,"cargo",5,[],false]]
for cargo positions. The following commands will put player in the same seat: player moveInCargo [heli, 2]; player action ["GetInCargo", heli, 0];

Syntax

Syntax:
fullCrew vehicle
Parameters:
vehicle: Object
Return Value:
Array - format [[<Object>unit,<String>role,<Number>cargoIndex (see note in description),<Array>turretPath,<Boolean>personTurret], ...]

Alternative Syntax

Syntax:
fullCrew [vehicle, type, includeEmpty]
Parameters:
[vehicle, type]: Array
vehicle: Object
type: String - filter (role) available values are "driver", "commander", "gunner", "turret", "cargo"
includeEmpty (Optional): Boolean - (since Arma 3 v1.55.133810) include empty crew seats too
Return Value:
Array - format [[<Object>unit,<String>role,<Number>cargoIndex (see note in description),<Array>turretPath,<Boolean>personTurret], ...]

Examples

Example 1:
_list = fullCrew vehicle player;
Example 2:
_list = fullCrew [vehicle player, "turret"];

Additional Information

Multiplayer:
-
See also:
crewcreateVehicleCrewassignedVehicleRoleallTurrets

Notes

Only post proven facts here. Report bugs on the feedback tracker. Use the talk page or the forums for discussions.
Add New Note | How To

Notes

Bottom Section

Posted on December 13, 2014 - 22:54 (UTC)
Commy2
Be aware that the returned role may or may not be in lowercase. E.g. it's "driver" for the driver, but "Turret" for turret units.

As of Arma 3 version 1.36, the alternative syntax of this command returns all crew members if the filter is anything except "driver", "commander", "gunner", "turret" or "cargo"
The filter is not case sensitive.