fullCrew: Difference between revisions
Jump to navigation
Jump to search
Killzone Kid (talk | contribs) No edit summary |
Lou Montana (talk | contribs) m (Text replacement - "{{HashLink" to "{{Link") |
||
Line 10: | Line 10: | ||
|descr= Returns an array with all crew inside given vehicle, with or without empty seats. | |descr= Returns an array with all crew inside given vehicle, with or without empty seats. | ||
{{Feature | important | With the introduction of person turrets (FFV), the returned ''cargoIndex'' works with [[moveInCargo]] but does not with [[action]]s such as "GetInCargo" and "MoveToCargo". To find out indexes for actions, use the "cargo" filter (See {{ | {{Feature | important | With the introduction of person turrets (FFV), the returned ''cargoIndex'' works with [[moveInCargo]] but does not with [[action]]s such as "GetInCargo" and "MoveToCargo". To find out indexes for actions, use the "cargo" filter (See {{Link|#Example 3}}).}} | ||
|s1= [[fullCrew]] vehicle | |s1= [[fullCrew]] vehicle |
Revision as of 17:43, 4 January 2023
Description
- Description:
- Returns an array with all crew inside given vehicle, with or without empty seats.
- Groups:
- Object Manipulation
Syntax
- Syntax:
- fullCrew vehicle
- Parameters:
- vehicle: Object
- Return Value:
- Array - list of arrays in format [unit, role, cargoIndex, turretPath, personTurret, assignedUnit]:
- unit: Object
- role: String - not always lowercase (from 2.03 always lower case)
- cargoIndex: Number
- turretPath: Array
- personTurret: Boolean
- 2.12 assignedUnit: Object - see assignAsXXX commands, assignAsDriver for example
- 2.12 positionName: String - unlocalized entry for turret's `gunnerName`, for example "$STR_A3_TURRETS_CARGOTURRET_R2"
Alternative Syntax
- Syntax:
- fullCrew [vehicle, type, includeEmpty]
- Parameters:
- vehicle: Object
- type: String - role filter (case-insensitive). An invalid value (e.g "") will return all positions. Available values:
- "driver"
- "commander"
- "gunner"
- "turret"
- "cargo"
- since 1.56
- includeEmpty: Boolean - (Optional, default false) include empty crew seats
- Return Value:
- Array - list of arrays in format [unit, role, cargoIndex, turretPath, personTurret, assignedUnit]:
- unit: Object
- role: String - not always lowercase (from 2.03 always lower case)
- cargoIndex: Number
- turretPath: Array
- personTurret: Boolean
- 2.12 assignedUnit: Object - see assignAsXXX commands, assignAsDriver for example
- 2.12 positionName: String - unlocalized entry for turret's `gunnerName`, for example "$STR_A3_TURRETS_CARGOTURRET_R2"
Examples
- Example 1:
- Example 2:
- Example 3:
- private _actionCompatibleCargoIndexes = fullCrew [heli, "cargo", true]; /* returns for example (on an armed WY-55 Hellcat): [ [objNull, "cargo" ,2, [], false], [objNull, "cargo", 3, [], false], [objNull, "cargo", 4, [], false], [objNull, "cargo", 5, [], false] ] using the element's index is compatible with action cargo commands - see below */ // the following commands will put the player in the same seat: player moveInCargo [heli, 2]; player action ["GetInCargo", heli, 0];
Additional Information
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