deleteVehicle: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
m (2.16 -> 2.18)
 
(65 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| ofp |= Game name
|game1= ofp
|version1= 1.34


|1.34|= Game version
|game2= ofpe
|version2= 1.00


|arg= global |= Arguments in MP
|game3= arma1
|version3= 1.00


|eff= global |= Effects in MP
|game4= arma2
____________________________________________________________________________________________
|version4= 1.00


| Deletes an object.<br>
|game5= arma2oa
Only units inserted in the mission editor and units created during the game's progress can be deleted by this command. Island objects and player units cannot be removed. <br>
|version5= 1.50
Deleting a vehicle, which is still being accessed by a running script, can result in a CTD.|= Description
____________________________________________________________________________________________


| '''deleteVehicle''' object |= Syntax
|game6= tkoh
|version6= 1.00


|p1= object: [[Object]] |= Parameter 1
|game7= arma3
|version7= 0.50


| [[Nothing]] |= Return value
|arg= global
____________________________________________________________________________________________
 
|x1= <code>[[deleteVehicle]] _house1;</code> |= Example 1
|x2= <code>{
_x [[action]] ["Eject", car];
} [[forEach]] [[crew]] car;
[[deleteVehicle]] car;</code> |= Example 1
|x3= Objects such as
* test_EmptyObjectForBubbles
* test_EmptyObjectForFireBig
* test_EmptyObjectForSmoke
create additional emitters that needs to be deleted first before deleting the object itself: <code>///--- function to delete test object (MP compatible)
fnc_deleteTestObj = {
_this [[addMPEventHandler]] ["MPKilled", {
_this = _this [[select]] 0;
{
[[deleteVehicle]] _x;
} [[forEach]] (_this [[getVariable]] ["effects", []]);
[[if]] ([[isServer]]) [[then]] {
[[deleteVehicle]] _this;
};
}];
_this [[setDamage]] 1;
};
///--- example
[] [[spawn]] {
_fire = "test_EmptyObjectForFireBig" [[createVehicle]] [[position]] [[player]];
[[sleep]] 5;
_fire [[call]] fnc_deleteTestObj;
};</code> |= Example 3
____________________________________________________________________________________________


| [[createUnit]], [[createVehicleLocal]], [[createVehicle]] |= See also
|eff= global


|mp= A deleted player unit will stay visible until that player has disconnected. |=
|gr1= Object Manipulation


}}
|descr= Deletes an object. Only objects inserted in the mission editor and objects created during the game's progress can be deleted by this command. Terrain objects and players cannot be deleted.
{{Feature|informative|The actual object deletion, when the object becomes [[objNull]], happens on the next frame after command execution, but there are some object modifications that happen immediately. For example if the object is a unit in a group, it immediately becomes groupless (<sqf inline>isNull group _unit; // true</sqf>).}}
 
|pr= {{Feature|warning|Use [[deleteVehicleCrew]] to delete units that are in a vehicle! Do '''not''' use this command for a vehicle's [[crew]] members as it may lead to all sorts of bugs and ghost objects left on the map.}}
 
|s1= [[deleteVehicle]] object
 
|p1= object: [[Object]]
 
|r1= [[Nothing]]
 
|s2= [[deleteVehicle]] objects
|s2since= arma3 2.18


<h3 style="display:none">Notes</h3>
|p21= objects: [[Array]] of [[Object]]s
<dl class="command_description">
<!-- Note Section BEGIN -->


<!-- Note Section END -->
|r2= [[Nothing]]
</dl>


<h3 style="display:none">Bottom Section</h3>
|x1= <sqf>deleteVehicle _house1;</sqf>


|x2= Deleting a vehicle with crew:
<sqf>
// might want to make sure that the car is local
{ car deleteVehicleCrew _x } forEach crew car;
deleteVehicle car;
</sqf>


[[Category:Scripting Commands|DELETEVEHICLE]]
|seealso= [[deleteVehicleCrew]] [[createUnit]] [[createVehicleLocal]] [[createVehicle]] [[Arma_3:_Event_Handlers#Deleted | Deleted EH]]
[[Category:Scripting Commands OFP 1.99|DELETEVEHICLE]]
}}
[[Category:Scripting Commands OFP 1.96|DELETEVEHICLE]]
[[Category:Scripting Commands OFP 1.46|DELETEVEHICLE]]
[[Category:Scripting Commands ArmA|DELETEVEHICLE]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Unit_Control|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Object_Manipulation|{{uc:{{PAGENAME}}}}]]

Latest revision as of 15:01, 8 February 2024

Logo A0.png1.34ofpe logo.png1.00Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
GAGlobalGEGlobal
Hover & click on the images for description

Description

Description:
Deletes an object. Only objects inserted in the mission editor and objects created during the game's progress can be deleted by this command. Terrain objects and players cannot be deleted.
ⓘ
The actual object deletion, when the object becomes objNull, happens on the next frame after command execution, but there are some object modifications that happen immediately. For example if the object is a unit in a group, it immediately becomes groupless (isNull group _unit; // true).
Problems:
⚠
Use deleteVehicleCrew to delete units that are in a vehicle! Do not use this command for a vehicle's crew members as it may lead to all sorts of bugs and ghost objects left on the map.
Groups:
Object Manipulation

Syntax

Syntax:
deleteVehicle object
Parameters:
object: Object
Return Value:
Nothing

Alternative Syntax

Syntax:
deleteVehicle objects
Parameters:
objects: Array of Objects
Return Value:
Nothing

Examples

Example 1:
deleteVehicle _house1;
Example 2:
Deleting a vehicle with crew:
// might want to make sure that the car is local { car deleteVehicleCrew _x } forEach crew car; deleteVehicle car;

Additional Information

See also:
deleteVehicleCrew createUnit createVehicleLocal createVehicle 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
Retrieved from "https://community.bistudio.com/wiki?title=deleteVehicle&oldid=352346"