createVehicleCrew: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " <!-- (DIS)?CONTINUE Notes -->" to "")
m (Text replacement - " |r1=[[" to " |r1= [[")
(11 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| arma3
|game1= arma3
 
|version1= 0.76
|0.76


|gr1= Object Manipulation
|gr1= Object Manipulation


| Creates vehicle crew corresponding to vehicle's [[faction]]. The command creates driver, if the vehicle has driver position (vehicle config: <tt>hasDriver</tt>) and fills [[allTurrets | all non-FFV turrets]] with gunners, if turrets can have gunners (turret config: <tt>hasGunner</tt>). Any turret that has <tt>dontCreateAI</tt> option set is omitted. If the vehicle is already occupied, the command will only create missing crew.<br><br>
|descr= Creates vehicle crew corresponding to vehicle's [[faction]]. The command creates driver, if the vehicle has driver position (vehicle config: <tt>hasDriver</tt>) and fills [[allTurrets | all non-FFV turrets]] with gunners, if turrets can have gunners (turret config: <tt>hasGunner</tt>). Any turret that has <tt>dontCreateAI</tt> option set is omitted. If the vehicle is already occupied, the command will only create missing crew.<br><br>
Since Arma 3 v1.94 this command will return [[Group]] of the created crew which will be vehicle's group. Missing crew will be created in the same group as vehicle. To find out which crew will be created, use [[BIS_fnc_vehicleCrewTurrets]].<br><br>
Since Arma 3 v1.94 this command will return [[Group]] of the created crew which will be vehicle's group. Missing crew will be created in the same group as vehicle. To find out which crew will be created, use [[BIS_fnc_vehicleCrewTurrets]].<br><br>
    
    
Line 14: Line 13:
{{Feature|important| While a vehicle with a crew placed in editor will have all crew units of the [[rank]] <tt>"PRIVATE"</tt>, this command will create the driver as <tt>"LIEUTENANT"</tt> and all turret units as <tt>"SERGEANT"</tt> }}
{{Feature|important| While a vehicle with a crew placed in editor will have all crew units of the [[rank]] <tt>"PRIVATE"</tt>, this command will create the driver as <tt>"LIEUTENANT"</tt> and all turret units as <tt>"SERGEANT"</tt> }}


| [[createVehicleCrew]] vehicle
|s1= [[createVehicleCrew]] vehicle


|p1= vehicle: [[Object]] - vehicle to populate with crew
|p1= vehicle: [[Object]] - vehicle to populate with crew


| [[Group]] - the group of the created crew (since Arma 3 v1.94)
|r1= [[Group]] - the group of the created crew (since Arma 3 v1.94)


|x1= <code>_veh = [[createVehicle]] ["B_MRAP_01_F", [[getMarkerPos]] "createVeh", [], 0, "NONE"];
|x1= <code>_veh = [[createVehicle]] ["B_MRAP_01_F", [[getMarkerPos]] "createVeh", [], 0, "NONE"];
Line 35: Line 34:




[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
<dl class="command_description">
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|arma3|New Scripting Commands}}


<dl class="command_description">
<dt></dt>
<dt></dt>
<dd class="notedate">Posted on August 20, 2014 - 14:01 (UTC)</dd>
<dd class="notedate">Posted on August 20, 2014 - 14:01 (UTC)</dd>
Line 46: Line 42:
As of ARMA 3 v1.26 the command will work on non-empty vehicles. If any of the crew defined in config are missing they will be added.
As of ARMA 3 v1.26 the command will work on non-empty vehicles. If any of the crew defined in config are missing they will be added.
</dd>
</dd>
<dt><dt>
<dt><dt>
<dd class="notedate">Posted on November 8, 2014 - 17:06 (UTC)</dd>
<dd class="notedate">Posted on November 8, 2014 - 17:06 (UTC)</dd>
Line 53: Line 50:
So a gunship Huron will get a pilot and copilot plus 2 door gunners, but nobody in the back.
So a gunship Huron will get a pilot and copilot plus 2 door gunners, but nobody in the back.
</dd>
</dd>
<dt><dt>
<dt><dt>
<dd class="notedate">Posted on December 22, 2015 - 14:19 (UTC)</dd>
<dd class="notedate">Posted on December 22, 2015 - 14:19 (UTC)</dd>
Line 59: Line 57:
createVehicleCrew does not work with Transport Unload waypoints for helicopters. You need to spawn the pilots separately and then get them into the helicopter in order to get Transport Unload waypoints to work.
createVehicleCrew does not work with Transport Unload waypoints for helicopters. You need to spawn the pilots separately and then get them into the helicopter in order to get Transport Unload waypoints to work.
</dd>
</dd>
<dt><dt>
<dt><dt>
<dd class="notedate">Posted on July 2, 2017 - 03:26 (UTC)</dd>
<dd class="notedate">Posted on July 2, 2017 - 03:26 (UTC)</dd>
Line 72: Line 71:
Also, I've written a function to create a UAV crew for a specific side: https://gist.github.com/AgentRev/cb25d30e464f2239b6cee51fa0110c78
Also, I've written a function to create a UAV crew for a specific side: https://gist.github.com/AgentRev/cb25d30e464f2239b6cee51fa0110c78
</dd>
</dd>
</dl>
</dl>

Revision as of 23:34, 7 August 2021

Hover & click on the images for description

Description

Description:
Creates vehicle crew corresponding to vehicle's faction. The command creates driver, if the vehicle has driver position (vehicle config: hasDriver) and fills all non-FFV turrets with gunners, if turrets can have gunners (turret config: hasGunner). Any turret that has dontCreateAI option set is omitted. If the vehicle is already occupied, the command will only create missing crew.

Since Arma 3 v1.94 this command will return Group of the created crew which will be vehicle's group. Missing crew will be created in the same group as vehicle. To find out which crew will be created, use BIS_fnc_vehicleCrewTurrets.

This command does not addVehicle to the created crew in the same way this normally happens when crewed vehicle created in the editor. See BIS_fnc_spawnVehicle for a full vehicle and crew creation and group addition.
While a vehicle with a crew placed in editor will have all crew units of the rank "PRIVATE", this command will create the driver as "LIEUTENANT" and all turret units as "SERGEANT"
Groups:
Object Manipulation

Syntax

Syntax:
createVehicleCrew vehicle
Parameters:
vehicle: Object - vehicle to populate with crew
Return Value:
Group - the group of the created crew (since Arma 3 v1.94)

Examples

Example 1:
_veh = createVehicle ["B_MRAP_01_F", getMarkerPos "createVeh", [], 0, "NONE"]; createVehicleCrew _veh;
Example 2:
_veh = createVehicle ["O_MRAP_02_hmg_F", position player, [], 0, "NONE"]; createVehicleCrew _veh; { diag_log [_x, faction _x, side _x, side group _x]; } forEach crew _veh; [O Alpha 1-1:1,"OPF_F",EAST,EAST] [O Alpha 1-1:2,"OPF_F",EAST,EAST]

Additional Information

See also:
deleteVehicleCrewmoveInDrivermoveInGunnermoveInCommandermoveInTurretmoveInCargoBIS_fnc_spawnVehicle

Notes

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 20, 2014 - 14:01 (UTC)
SilentSpike
As of ARMA 3 v1.26 the command will work on non-empty vehicles. If any of the crew defined in config are missing they will be added.
Posted on November 8, 2014 - 17:06 (UTC)
Tankbuster
This command creates drivers/copilots, commanders and gunners where appropriate, but it never creates cargo crew. So a gunship Huron will get a pilot and copilot plus 2 door gunners, but nobody in the back.
Posted on December 22, 2015 - 14:19 (UTC)
DrPastah
createVehicleCrew does not work with Transport Unload waypoints for helicopters. You need to spawn the pilots separately and then get them into the helicopter in order to get Transport Unload waypoints to work.
Posted on July 2, 2017 - 03:26 (UTC)
AgentRev
The particular seats to which units are added depend on the dontCreateAI property, the hasDriver property of the base class, and the hasGunner propery of turret classes.
For instance, the following snippet calculates how many seats will be occupied by the created crew: private _vehCfg = configFile >> "CfgVehicles" >> typeOf _vehicle; private _crewCount = {round getNumber (_x >> "dontCreateAI") < 1 && ((_x == _vehCfg && {round getNumber (_x >> "hasDriver") > 0}) || (_x != _vehCfg && {round getNumber (_x >> "hasGunner") > 0}))} count ([_vehicle, configNull] call BIS_fnc_getTurrets); Also, I've written a function to create a UAV crew for a specific side: https://gist.github.com/AgentRev/cb25d30e464f2239b6cee51fa0110c78