deleteVehicle: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
m (Text replacement - "\[\[Category:Scripting Commands OFP 1.[4-9]{2}(\|(\{\{uc:\{\{PAGENAME\}\}\}\}|#|[A-Z]+))?\]\] " to "")
(48 intermediate revisions by 12 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| ofp |= Game name
| ofp


|1.34|= Game version
|1.34


|arg= global |= Arguments in MP
|arg= global


|eff= global |= Effects in MP
|eff= global
____________________________________________________________________________________________


| Delete an object. Note that 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 can't be removed. |= Description
|gr1= Object Manipulation
____________________________________________________________________________________________


| '''deleteVehicle''' object |= Syntax
| Deletes an object. Only objects inserted in the mission editor and objects created during the game's progress can be deleted by this command. Island objects and player cannot be removed.<br><br>
{{Feature | Informative | The actual object deletion, when 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 unit in a group, it immediately becomes groupless <tt>[[isNull]] [[group]] _unit; //true</tt>}}<br>
{{Feature | Warning | Do not use this command for deletion of dead [[crew]] members from a vehicle. Doing so may lead to all sorts of bugs and ghost objects left on the map. Instead use [[deleteVehicleCrew]], which was designed with this functionality in mind}}


|p1=  object: [[Object]] |= Parameter 1
| '''deleteVehicle''' object


| [[Nothing]] |= Return value
|p1=  object: [[Object]]
____________________________________________________________________________________________
 
| [[Nothing]]
   
   
|x1= <pre>deleteVehicle _house1</pre>
|x1= <code>[[deleteVehicle]] _house1;</code>
 
|x2= Deleting a vehicle with crew: <code>// might want to make sure that the car is local
Attention Deleting a vehicle, which is still being accessed by a running script, can result in a CTD. |= Example 1
{car [[deleteVehicleCrew]] _x} [[forEach]] [[crew]] car;
____________________________________________________________________________________________
[[deleteVehicle]] car;</code>
 
| [[createUnit]], [[createUnit array]], [[createVehicle array]], [[createVehicleLocal]], [[createVehicle]] |= See also


|mp= A deleted player unit will stay visible until that player has disconnected. |=
| [[createUnit]], [[createVehicleLocal]], [[createVehicle]], [[Arma_3:_Event_Handlers#Deleted | Deleted EH]]


|mp=
}}
}}


<h3 style="display:none">Notes</h3>
<dl class="command_description">
<!-- Note Section BEGIN -->
<dd class="notedate">Posted on August 3, 2006 - 14:30</dd>
<dt class="note">'''[[User:Hardrock|hardrock]]'''</dt>
<dd class="note">''Notes from before the conversion:''
If you run deleteVehicle for every playable soldier, the AI units will be removed.
<code>deleteVehicle unit1</code>
will result in some very strange, and unwelcome, things happening.
A safer way to delete unit1 if it is, or might be, inside a vehicle is:
<code>[[unassignVehicle]] unit1<br/>
unit1 [[setPos]] [0,0,0]<br/>
deleteVehicle unit1</code>
''This is because you cannot call deleteVehicle on a unit (soldier) who's currently inside a Vehicle.''
The line below works just fine for units that have been deleted.
<code>[[if]] ([[alive]] unit1) [[then]] {[[hint]]"He is alive"} [[else]] {[[hint]]"Oh no he's not"}</code>
</dd>
<dd class="notedate">Posted on January 14, 2009 - 12:35</dd>
<dt class="note">'''[[User:Kronzky|Kronzky]]'''</dt>
<dd class="note">''Units in vehicles cannot be deleted''.<br>
It doesn't matter whether it's the default crew (e.g. {driver car1}), or a unit that has been placed into a vehicle (e.g. {unit1 moveInCargo car1; deleteVehicle unit1}). In either case the unit will stay alive and visible in its position.<br>
To circumvent this limitation, [[Armed_Assault:_Actions_List#Eject|eject]] the unit first, before deleting it.
</dd>
<dd class="notedate">Posted on August 6, 2009 - 11:30</dd>
<dt class="note">'''[[User:Shuko|Shuko]]'''</dt>
<dd class="note">In Arma 2 deleting units in vehicles work. Trigger with the code below will remove APC, crew and the group that is moveincargo'd.
<code>{deletevehicle _x} foreach crew (thislist select 0);
deletevehicle (thislist select 0);</code>
</dd>
<!-- Note Section END -->
</dl>
<h3 style="display:none">Bottom Section</h3>




[[Category:Scripting Commands|DELETEVEHICLE]]
{{GameCategory|arma1|Scripting Commands}}
[[Category:Scripting Commands OFP 1.96|DELETEVEHICLE]]
{{GameCategory|arma2|Scripting Commands}}
[[Category:Scripting Commands OFP 1.46|DELETEVEHICLE]]
{{GameCategory|arma3|Scripting Commands}}
[[Category:Scripting Commands ArmA|DELETEVEHICLE]]
{{GameCategory|tkoh|Scripting Commands}}
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Unit_Control|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Object_Manipulation|{{uc:{{PAGENAME}}}}]]

Revision as of 00:27, 25 March 2021

Game1 needed - Version1 needed
GAGlobalGEGlobal
Hover & click on the images for description

Description

Description:
This article is a Stub. You can help BI Community Wiki by expanding it.
Description needed
Groups:
Object Manipulation

Syntax

Syntax:
Syntax needed
Parameters:
object: Object
Return Value:
Return value needed

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:
See also needed

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=251524"