assignedVehicle: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " <h3 style="display:none">Notes</h3>" to "")
No edit summary
 
(34 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command
{{RV|type=command


| arma1
|game1= arma1
|version1= 1.05


|1.05
|game2= arma2
|version2= 1.00


|arg= local
|game3= arma2oa
|version3= 1.50


|gr1= Object Manipulation
|game4= tkoh
|version4= 1.00


| Returns the vehicle an unit is assigned to. If no vehicle is assigned [[objNull]] is returned.
|game5= arma3
<br><br>
|version5= 0.50
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.


|arg= local


| [[assignedVehicle]] unit
|gr1= Object Manipulation


|p1= unit: [[Object]]
|descr= Returns the vehicle to which a unit is assigned, usually with ''assignAsXXX'' command. If no vehicle is assigned [[objNull]] is returned.
{{Feature|informative|See [[AI Group Vehicle Management]] for more information.}}


| [[Object]]
|s1= [[assignedVehicle]] unit
 
|x1= <code>_vehicle = [[assignedVehicle]] [[player]];</code>
 
|x12= <code>_units [[apply]] {[[Magic Variables|_x]] [[leaveVehicle]] (assignedVehicle [[Magic Variables|_x]])};</code>


| [[addVehicle]], [[assignAsDriver]], [[assignAsCargo]], [[assignAsCommander]], [[assignAsGunner]], [[unassignVehicle]], [[leaveVehicle]]
|p1= unit: [[Object]]
}}


<dl class="command_description">
|r1= [[Object]]


<!-- Note Section BEGIN -->
|x1= <sqf>_vehicle = assignedVehicle player;</sqf>


<!-- Note Section END -->
|x2= <sqf>_units apply { _x leaveVehicle (assignedVehicle _x) };</sqf>
</dl>


 
|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

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