unassignVehicle: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "<dt class="note">'''\[\[.*\]\]'''" to "<dt class="note">$1")
m (Fix example)
 
(46 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


| Unassigns individual unit from a vehicle, i.e removes [[assignedVehicleRole]] of the unit. If the unit is currently in that vehicle, the group leader will issue an order to disembark. |DESCRIPTION=
|game5= arma2oa
____________________________________________________________________________________________
|version5= 1.50


| '''unassignVehicle''' unitName |SYNTAX=
|game6= tkoh
|version6= 1.00


|p1= unitName: [[Object]] |PARAMETER1=
|game7= arma3
|version7= 0.50


| [[Nothing]] |RETURNVALUE=
|arg= local
____________________________________________________________________________________________


|x1= <code>[[unassignVehicle]] [[player]];</code> |EXAMPLE1=
|eff= global
|x2= <code>{ [[unassignVehicle]] [[Magic Variables|_x]] } [[forEach]] [[crew]] _vehiclename;</code> Will make all the occupants of a vehicle disembark |EXAMPLE2=
____________________________________________________________________________________________


| [[assignAsCargo]], [[assignAsCommander]], [[assignAsDriver]], [[assignAsGunner]], [[assignAsTurret]], [[assignedVehicle]], [[leaveVehicle]] |SEEALSO=
|gr1= Object Manipulation


}}
|gr2= Unit Control


<h3 style="display:none">Notes</h3>
|descr= Unassigns individual unit from a vehicle, usually previously assigned with ''assignAsXXX'' command, i.e removes [[assignedVehicleRole]] of the unit.
<dl class="command_description">
If the unit is currently in that vehicle, the group leader will issue an order to disembark.
<!-- Note Section BEGIN -->
{{Feature|informative|See [[AI Group Vehicle Management]] for more information.}}


<dd class="notedate">Posted on August 4, 2006 - 12:05
|s1= [[unassignVehicle]] unitName
<dt class="note">[[]]<dd class="note">''Notes from before the conversion:''


Even though:
|p1= unitName: [[Object]]


{unassignVehicle _x} [[forEach]] [[crew]] vehiclename
|r1= [[Nothing]]


will make all the occupants of a vehicle disembark, if they are the original crew of the vehicle then they will just get back in again.
|x1= <sqf>unassignVehicle player;</sqf>
|x2= Make all the occupants of a vehicle disembark:
<sqf>{ unassignVehicle _x } forEach crew _vehicle;</sqf>


To prevent this happening also use [[allowGetIn]] as in the example below:
|x3= Make all the occupants of a vehicle disembark and unable to get back in:
<sqf>
private _crew = crew _vehicle;
{ unassignVehicle _x } forEach _crew;
_crew allowGetIn false;
</sqf>


{unassignVehicle _x} [[forEach]] [[crew]] vehiclename; [[crew]] vehiclename [[allowGetIn]] [[false]]
|seealso= [[assignAsCargo]] [[assignAsCommander]] [[assignAsDriver]] [[assignAsGunner]] [[assignAsTurret]] [[assignedVehicle]] [[leaveVehicle]] [[assignedVehicles]] [[assignedGroup]] [[fullCrew]]
 
}}
 
<!-- Note Section END -->
</dl>
 
<h3 style="display:none">Bottom Section</h3>
 
[[Category:Scripting Commands|UNASSIGNVEHICLE]]
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.96|UNASSIGNVEHICLE]]
[[Category:Scripting Commands OFP 1.46|UNASSIGNVEHICLE]]
[[Category:Scripting Commands ArmA|UNASSIGNVEHICLE]]
[[Category:Scripting Commands Arma 2|UNASSIGNVEHICLE]]
[[Category:Command_Group:_Unit_Control|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Vehicle_Assignment|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Take On Helicopters|{{uc:{{PAGENAME}}}}]]

Latest revision as of 21:52, 28 March 2024

Hover & click on the images for description

Description

Description:
Unassigns individual unit from a vehicle, usually previously assigned with assignAsXXX command, i.e removes assignedVehicleRole of the unit. If the unit is currently in that vehicle, the group leader will issue an order to disembark.
See AI Group Vehicle Management for more information.
Groups:
Object ManipulationUnit Control

Syntax

Syntax:
unassignVehicle unitName
Parameters:
unitName: Object
Return Value:
Nothing

Examples

Example 1:
unassignVehicle player;
Example 2:
Make all the occupants of a vehicle disembark:
{ unassignVehicle _x } forEach crew _vehicle;
Example 3:
Make all the occupants of a vehicle disembark and unable to get back in:
private _crew = crew _vehicle; { unassignVehicle _x } forEach _crew; _crew allowGetIn false;

Additional Information

See also:
assignAsCargo assignAsCommander assignAsDriver assignAsGunner assignAsTurret assignedVehicle leaveVehicle assignedVehicles assignedGroup fullCrew

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