deleteVehicleCrew: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " is local" to " is local")
(Add objectParent information)
 
(20 intermediate revisions by the same user not shown)
Line 10: Line 10:
|gr1= Object Manipulation
|gr1= Object Manipulation


|descr= Deletes a member of the crew of a vehicle. Human players cannot be deleted. Since Arma 3 v2.06.147649 it is also possible to delete entire crew all in one sweep using alternative syntax.
|descr= Deletes a member of or the whole crew of a vehicle. Human players cannot be deleted.
{{Feature | Informative | This command attempts to move the given [[crew]] member out before deleting it. Made especially for deleting dead crew members, as using conventional [[deleteVehicle]] leads to all sorts of bugs and ghost objects. While the argument is global, you should take extra steps and execute this where vehicle is [[Multiplayer Scripting#Locality|local]] as moving units out of the vehicle happens where vehicle is [[Multiplayer Scripting#Locality|local]] and you want this to always precede deletion.}}
{{Feature|informative|This command attempts to move the given [[crew]] member out before deleting it. Made especially for deleting dead crew members, as using conventional [[deleteVehicle]] leads to all sorts of bugs and ghost objects. While the argument is global, you should take extra steps and execute this where vehicle is [[Multiplayer Scripting#Locality|local]] as moving units out of the vehicle happens where vehicle is [[Multiplayer Scripting#Locality|local]] and you want this to always precede deletion.}}


|s1= vehicle [[deleteVehicleCrew]] unit
|s1= vehicle [[deleteVehicleCrew]] unit
Line 21: Line 21:
|r1= [[Nothing]]
|r1= [[Nothing]]


|s2= [[deleteVehicleCrew]] vehicle {{Since|arma3|2.06.147649|y}}
|s2= [[deleteVehicleCrew]] vehicle
 
|s2since= arma3 2.06


|p21= vehicle: [[Object]]
|p21= vehicle: [[Object]]
Line 27: Line 29:
|r2= [[Nothing]]
|r2= [[Nothing]]


|x1= <code>_helicopter [[deleteVehicleCrew]] [[driver]] _helicopter;</code>
|x1= <sqf>
// delete when knowing the vehicle
_helicopter deleteVehicleCrew driver _helicopter;


|x2= <code>{ _helicopter [[deleteVehicleCrew]] _x } [[forEach]] [[crew]] _helicopter; {{cc|deletes all crew}}</code>
// delete when only knowing the unit
// vehicle _soldier deleteVehicleCrew _soldier; // may return the unit itself when used on dead crew
objectParent _soldier deleteVehicleCrew _soldier; // faster and always returns the vehicle
</sqf>


|x3= Delete entire crew:<code>[[deleteVehicleCrew]] _tank;</code>
|x2= Delete entire crew:
<sqf>
deleteVehicleCrew _tank; // since v2.06


|seealso= ‎[[createVehicleCrew]], [[moveInDriver]], [[moveInGunner]], [[moveInCommander]], [[moveInTurret]], [[moveInCargo]], [[Arma_3:_Event_Handlers#Deleted | Deleted EH]]
{ _helicopter deleteVehicleCrew _x } forEach crew _helicopter; // before v2.06
</sqf>
 
|seealso= [[createVehicleCrew]] [[moveInDriver]] [[moveInGunner]] [[moveInCommander]] [[moveInTurret]] [[moveInCargo]] [[Arma_3:_Event_Handlers#Deleted | Deleted EH]]
}}
}}


<dl class="command_description">
{{Note
 
|user= Killzone_Kid
<dt><dt>
|timestamp= 20140831101500
<dd class="notedate">Posted on August 31, 2014 - 10:15 (UTC)</dd>
|text= If you delete the AI pilot with <sqf inline>deleteVehicle driver heli</sqf> the co-pilot will jump out.<br>
<dt class="note">[[User:Killzone Kid|Killzone Kid]]</dt>
If you delete the AI pilot with <sqf inline>heli deleteVehicleCrew driver heli</sqf> the co-pilot will stay.
<dd class="note">
}}
If you delete the AI pilot with {{ic|[[deleteVehicle]] [[driver]] heli}} the co-pilot will jump out.<br>
If you delete the AI pilot with {{ic|heli [[deleteVehicleCrew]] [[driver]] heli}} the co-pilot will stay.
</dd>
 
</dl>

Latest revision as of 17:02, 18 September 2023

Arma 3 logo black.png1.32
GAGlobalGEGlobal
Hover & click on the images for description

Description

Description:
Deletes a member of or the whole crew of a vehicle. Human players cannot be deleted.
ⓘ
This command attempts to move the given crew member out before deleting it. Made especially for deleting dead crew members, as using conventional deleteVehicle leads to all sorts of bugs and ghost objects. While the argument is global, you should take extra steps and execute this where vehicle is local as moving units out of the vehicle happens where vehicle is local and you want this to always precede deletion.
Groups:
Object Manipulation

Syntax

Syntax:
vehicle deleteVehicleCrew unit
Parameters:
vehicle: Object
unit: Object
Return Value:
Nothing

Alternative Syntax

Syntax:
deleteVehicleCrew vehicle
Parameters:
vehicle: Object
Return Value:
Nothing

Examples

Example 1:
// delete when knowing the vehicle _helicopter deleteVehicleCrew driver _helicopter; // delete when only knowing the unit // vehicle _soldier deleteVehicleCrew _soldier; // may return the unit itself when used on dead crew objectParent _soldier deleteVehicleCrew _soldier; // faster and always returns the vehicle
Example 2:
Delete entire crew:
deleteVehicleCrew _tank; // since v2.06 { _helicopter deleteVehicleCrew _x } forEach crew _helicopter; // before v2.06

Additional Information

See also:
createVehicleCrew moveInDriver moveInGunner moveInCommander moveInTurret moveInCargo Deleted EH

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
Killzone_Kid - c
Posted on Aug 31, 2014 - 10:15 (UTC)
If you delete the AI pilot with deleteVehicle driver heli the co-pilot will jump out.
If you delete the AI pilot with heli deleteVehicleCrew driver heli the co-pilot will stay.
Retrieved from "https://community.bistudio.com/wiki?title=deleteVehicleCrew&oldid=347420"