moveInCargo: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[\[Category:[ _]?Scripting[ _]Commands[ _]Armed[ _]Assault(\|.*)]]" to "{{GameCategory|arma1|Scripting Commands}}")
m (Text replacement - "{{Feature|Important|" to "{{Feature|important|")
 
(50 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| ofp |Game name=
|game1= ofp
|version1= 1.00


|1.00|Game version=
|game2= ofpe
|version2= 1.00


|arg= local |Multiplayer Arguments=
|game3= arma1
|version3= 1.00


|eff= global |Multiplayer Effects=
|game4= arma2
|version4= 1.00


|gr1= Unit Control |GROUP1=
|game5= arma2oa
____________________________________________________________________________________________
|version5= 1.50


| Move soldier into vehicle cargo position (Immediate, no animation). |DESCRIPTION=
|game6= tkoh
____________________________________________________________________________________________
|version6= 1.00


| unitName [[moveInCargo]] vehicle |SYNTAX=
|game7= arma3
|version7= 0.50


|p1= unitName: [[Object]] |PARAMETER1=
|arg= local


|p2= vehicle: [[Object]] |PARAMETER2=
|eff= global


| [[Nothing]] |RETURNVALUE=
|gr1= Unit Control
____________________________________________________________________________________________
|s2= unitName [[moveInCargo]] [vehicle, CargoIndex] |SYNTAX2=


|p21= unitName: [[Object]] |PARAMETER21=
|descr= Moves a unit into a vehicle cargo position (immediately and without animation).
{{Feature|informative|See [[AI Group Vehicle Management]] for more information.}}
{{Feature|important|If the unit is already in a vehicle, nothing will happen. You should use [[moveOut]] to move the unit out of his vehicle before trying to move him into a new (or same) vehicle.}}
|mp= {{Feature|informative|The command should execute where the '''unit''' (not '''vehicle''') is local.}}


|p22= vehicle: [[Object]] |PARAMETER22=
|s1= unit [[moveInCargo]] vehicle


|p23= CargoIndex: [[Number]] |PARAMETER23=
|p1= unit: [[Object]]


|r2= [[Nothing]] |RETURNVALUE2=
|p2= vehicle: [[Object]]
____________________________________________________________________________________________
 
|x1= <code>_soldierOne [[moveInCargo]] _jeepOne;</code> |EXAMPLE1=


|x2= <code>_soldierOne [[moveInCargo]] [_jeepOne, 1];</code>|EXAMPLE2=
|r1= [[Nothing]]
____________________________________________________________________________________________


| [[moveInAny]], [[moveInCommander]], [[moveInDriver]], [[moveInGunner]], [[moveInTurret]], [[assignAsCargo]], [[assignAsCommander]], [[assignAsDriver]], [[assignAsGunner]], [[getCargoIndex]]  |SEEALSO=
|s2= unit [[moveInCargo]] [vehicle, cargoIndex, canReassign]
}}
 
|p21= unit: [[Object]]
 
|p22= vehicle: [[Object]]
 
|p23= cargoIndex: [[Number]]
 
|p24= canReassign: [[Boolean]] - (Optional, default [[true]]) try to move ''unit'' into the first free ''vehicle'' cargo seat if ''cargoIndex'' is already occupied
|p24since= arma3 2.08


<h3 style="display:none">Notes</h3>
|r2= [[Nothing]]
<dl class="command_description">
<!-- Note Section BEGIN -->


<dd class="notedate">Posted on August 4, 2006 - 14:42
|x1= <sqf>_soldierOne moveInCargo _jeepOne;</sqf>
<dt class="note">[[User:Hardrock|hardrock]]
<dd class="note">''Notes from before the conversion''<br>
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: <code>_soldier [[moveInCargo]] helo1; _soldier [[assignAsCargo]] helo1;</code>


<dd class="notedate">
|x2= <sqf>_soldierOne moveInCargo [_jeepOne, 1];</sqf>
<dt class="note">[[User:Ceeeb|Ceeeb]]
<dd class="note">
In '''OFP v1.96''', the moveIn commands will not trigger an associated getIn [[Operation_Flashpoint:_EventHandlers_List|event]]. To ensure the getIn event is fired, use the "getIn Cargo" [[Operation_Flashpoint:_Actions_List|action]] command.


<dd class="notedate">
|seealso= [[moveInAny]] [[moveInCommander]] [[moveInDriver]] [[moveInGunner]] [[moveInTurret]] [[assignAsCargo]] [[assignAsCommander]] [[assignAsDriver]] [[assignAsGunner]] [[getCargoIndex]]
<dt class="note">[[User:Killzone_Kid|Killzone_Kid]]
}}
<dd class="note">
In Arma 3 when using the alternative syntax of [[moveInCargo]], it is necessary to call [[assignAsCargoIndex]] because it is not called automatically.
<code>unit1 [[moveInCargo]] [heli, 3];
unit1 [[assignAsCargoIndex]] [heli, 3];</code>
Alternatively avoid this broken syntax all together and use:
<code>unit1 [[assignAsCargoIndex]] [heli, 3];
unit1 [[moveInCargo]] heli;
</code>


<!-- Note Section END -->
{{Note
</dl>
|user= Hardrock
|timestamp= 20060804144200
|text= ''Notes from before the conversion''<br>
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:
<sqf>_soldier moveInCargo helo1; _soldier assignAsCargo helo1;</sqf>
}}


<h3 style="display:none">Bottom Section</h3>
{{Note
|user= Ceeeb
|timestamp= 20070202070000
|text= In '''OFP v1.96''', the moveIn commands will not trigger an associated getIn [[Operation_Flashpoint:_EventHandlers_List|event]]. To ensure the getIn event is fired, use the "getIn Cargo" [[Operation_Flashpoint:_Actions_List|action]] command.
}}


[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
{{Note
[[Category:Scripting Commands OFP 1.46|{{uc:{{PAGENAME}}}}]]
|user= Killzone_Kid
[[Category:Scripting Commands OFP 1.96|{{uc:{{PAGENAME}}}}]]
|timestamp= 20140318190800
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
|text=  In {{arma3}} when using the alternative syntax of [[moveInCargo]], it is necessary to call [[assignAsCargoIndex]] because it is not called automatically.
{{GameCategory|arma1|Scripting Commands}}
<sqf>
[[Category:Scripting Commands Arma 2|{{uc:{{PAGENAME}}}}]]
unit1 moveInCargo [heli, 3];
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
unit1 assignAsCargoIndex [heli, 3];
[[Category:Scripting Commands Take On Helicopters|{{uc:{{PAGENAME}}}}]]
</sqf>
Alternatively avoid this broken syntax all together and use:
<sqf>
unit1 assignAsCargoIndex [heli, 3];
unit1 moveInCargo heli;
</sqf>
}}

Latest revision as of 00:23, 2 February 2024

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.
If the unit is already in a vehicle, nothing will happen. You should use moveOut to move the unit out of his vehicle before trying to move him into a new (or same) vehicle.
Multiplayer:
The command should execute where the unit (not vehicle) is local.
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: Boolean - (Optional, default true) try to move unit into the first free vehicle 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
Hardrock - c
Posted on Aug 04, 2006 - 14:42 (UTC)
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 - c
Posted on Feb 02, 2007 - 07:00 (UTC)
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 - c
Posted on Mar 18, 2014 - 19:08 (UTC)
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;