unassignVehicle: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(description)
m (Fix example)
 
(54 intermediate revisions by 5 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 |= Arguments in MP
|game3= arma1
|version3= 1.00


|eff= global |= Effects in MP
|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]] |= Parameter 1
|game7= arma3
|version7= 0.50


| [[Nothing]] |= Return value
|arg= local
____________________________________________________________________________________________


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


| [[assignAsCargo]], [[assignAsCommander]], [[assignAsDriver]], [[assignAsGunner]], [[assignAsTurret]], [[assignedVehicle]], [[leaveVehicle]] |= See also
|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">'''[[User:Hardrock|hardrock]]'''<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 ArmA2|UNASSIGNVEHICLE]]
[[Category:Command_Group:_Unit_Control|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Vehicle_Assignment|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]

Latest revision as of 20:52, 28 March 2024

Logo A0.png1.00ofpe logo.png1.00Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
LALocalGEGlobal
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
Retrieved from "https://community.bistudio.com/wiki?title=unassignVehicle&oldid=363373"