moveInCargo: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\|seealso= *\[\[([^ ]+)\]\], \[\[([^ ]+)\]\]" to "|seealso= $1 $2")
(Added new optional parameter canReassign)
Line 28: Line 28:
|gr1= Unit Control
|gr1= Unit Control


|descr= Move soldier into vehicle cargo position (Immediate, no animation).
|descr= Moves a unit into a vehicle cargo position (immediately and without animation).
{{Feature|informative|See [[AI Group Vehicle Management]] for more information.}}
{{Feature|informative|See [[AI Group Vehicle Management]] for more information.}}


|s1= unitName [[moveInCargo]] vehicle
|s1= unit [[moveInCargo]] vehicle


|p1= unitName: [[Object]]
|p1= unit: [[Object]]


|p2= vehicle: [[Object]]
|p2= vehicle: [[Object]]
Line 39: Line 39:
|r1= [[Nothing]]
|r1= [[Nothing]]


|s2= unitName [[moveInCargo]] [vehicle, CargoIndex]
|s2= unit [[moveInCargo]] [vehicle, cargoIndex, canReassign]


|p21= unitName: [[Object]]
|p21= unit: [[Object]]


|p22= vehicle: [[Object]]
|p22= vehicle: [[Object]]


|p23= CargoIndex: [[Number]]
|p23= cargoIndex: [[Number]]
 
|p24= canReassign (Optional, default: [[true]]): [[Boolean]] - try to move ''unit'' into the first free cargo seat if ''cargoIndex'' is already occupied
|p24since= arma3 2.08


|r2= [[Nothing]]
|r2= [[Nothing]]

Revision as of 13:27, 7 February 2022

Hover & click on the images for description

Description

Description:
Moves a unit into a vehicle cargo position (immediately and without animation).
See AI Group Vehicle Management for more information.
Groups:
Unit Control

Syntax

Syntax:
unit moveInCargo vehicle
Parameters:
unit: Object
vehicle: Object
Return Value:
Nothing

Alternative Syntax

Syntax:
unit moveInCargo [vehicle, cargoIndex, canReassign]
Parameters:
unit: Object
vehicle: Object
cargoIndex: Number
since Arma 3 logo black.png2.08
canReassign (Optional, default: true): Boolean - try to move unit into the first free cargo seat if cargoIndex is already occupied
Return Value:
Nothing

Examples

Example 1:
_soldierOne moveInCargo _jeepOne;
Example 2:
_soldierOne moveInCargo [_jeepOne, 1];

Additional Information

See also:
moveInAny moveInCommander moveInDriver moveInGunner moveInTurret assignAsCargo assignAsCommander assignAsDriver assignAsGunner getCargoIndex

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 4, 2006 - 14:42
hardrock
Notes from before the conversion
If you place a soldier in a vehicle with the moveInCargo command, he wont "know" he's in the vehicle, and thus he won't disembark properly when the vehicle reaches a Transport Unload waypoint. Therefore you have to use the assignAsCargo command, in order for the AI to catch on. Something like this: _soldier moveInCargo helo1; _soldier assignAsCargo helo1;
Ceeeb
In OFP v1.96, the moveIn commands will not trigger an associated getIn event. To ensure the getIn event is fired, use the "getIn Cargo" action command.
Killzone_Kid
In Arma 3 when using the alternative syntax of moveInCargo, it is necessary to call assignAsCargoIndex because it is not called automatically. unit1 moveInCargo [heli, 3]; unit1 assignAsCargoIndex [heli, 3]; Alternatively avoid this broken syntax all together and use: unit1 assignAsCargoIndex [heli, 3]; unit1 moveInCargo heli;