assignedVehicle: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " +" to " ")
No edit summary
 
(25 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| arma1
|game1= arma1
|version1= 1.05


|1.05
|game2= arma2
|version2= 1.00
 
|game3= arma2oa
|version3= 1.50
 
|game4= tkoh
|version4= 1.00
 
|game5= arma3
|version5= 0.50


|arg= local
|arg= local
Line 9: Line 20:
|gr1= Object Manipulation
|gr1= Object Manipulation


| Returns the vehicle an unit is assigned to. If no vehicle is assigned [[objNull]] is returned.
|descr= Returns the vehicle to which a unit is assigned, usually with ''assignAsXXX'' command. If no vehicle is assigned [[objNull]] is returned.
<br><br>
{{Feature|informative|See [[AI Group Vehicle Management]] for more information.}}
Notes:
* The assignment happens via the various assignAsXXX/moveInXXX commands, or player/AI GL getIn radio commands, getIn waypoint, or when units start in vehicles or get moved in to a vehicle by Zeus/via Eden.
* [[addVehicle]] indirectly may also add the vehicle, however only if an AI GL assigns [[assignedVehicleRole|vehicle roles]] (which depends on various things).
* [[vehicle]] returns the current vehicles an AI is in, while with [[assignedVehicle]] the AI may not (yet) be in the said vehicle (still in transit or held of by waypoints or other SQF commands).
* To make AI under AI GL enter a vehicle, use [[orderGetIn]] [[true]].
* While [[unassignVehicle]] works, if the group is under AI command, the AI GL may re-assign the vehicle immediately. To stop the AI from re-entering at least, use [[orderGetIn]] or [[allowGetIn]] [[false]], or permanently remove the assignment vi a [[leaveVehicle]].
* For player GL lead AI [[assignedVehicle]] seems not to be really reliable/behaves strange. Disembark radio command seems to [[unassignVehicle|unassign]] though.


| [[assignedVehicle]] unit
|s1= [[assignedVehicle]] unit


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


|r1=[[Object]]
|r1= [[Object]]


|x1= <code>_vehicle = [[assignedVehicle]] [[player]];</code>
|x1= <sqf>_vehicle = assignedVehicle player;</sqf>


|x12= <code>_units [[apply]] {[[Magic Variables|_x]] [[leaveVehicle]] (assignedVehicle [[Magic Variables|_x]])};</code>
|x2= <sqf>_units apply { _x leaveVehicle (assignedVehicle _x) };</sqf>


|seealso= [[addVehicle]], [[assignAsDriver]], [[assignAsCargo]], [[assignAsCommander]], [[assignAsGunner]], [[unassignVehicle]], [[leaveVehicle]]
|seealso= [[assignedVehicleRole]] [[addVehicle]] [[assignAsDriver]] [[assignAsCargo]] [[assignAsCommander]] [[assignAsGunner]] [[assignAsTurret]] [[assignAsCargoIndex]] [[unassignVehicle]] [[leaveVehicle]] [[assignedVehicles]] [[assignedGroup]] [[fullCrew]]
}}
}}
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|tkoh|Scripting Commands}}

Latest revision as of 16:20, 31 August 2022

Hover & click on the images for description

Description

Description:
Returns the vehicle to which a unit is assigned, usually with assignAsXXX command. If no vehicle is assigned objNull is returned.
See AI Group Vehicle Management for more information.
Groups:
Object Manipulation

Syntax

Syntax:
assignedVehicle unit
Parameters:
unit: Object
Return Value:
Object

Examples

Example 1:
_vehicle = assignedVehicle player;
Example 2:
_units apply { _x leaveVehicle (assignedVehicle _x) };

Additional Information

See also:
assignedVehicleRole addVehicle assignAsDriver assignAsCargo assignAsCommander assignAsGunner assignAsTurret assignAsCargoIndex unassignVehicle 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