removeWeapon: Difference between revisions

From Bohemia Interactive Community
m (Text replacement - " \| *(game[0-9]|version[0-9]|gr[0-9]|serverExec|mp|pr|descr|s[0-9]|p[0-9]{1,3}|r[0-9]|x1?[0-9]|seealso) *= +" to " |$1= ")
m (Some wiki formatting)
 
(11 intermediate revisions by 3 users not shown)
Line 30: Line 30:
|gr2= Vehicle Inventory
|gr2= Vehicle Inventory


|descr= Remove weapon from a unit. The unit must be [[local]] to the computer where command is executed. For a global version of this command see [[removeWeaponGlobal]].
|descr= Remove weapon from a unit. The unit must be [[Multiplayer Scripting#Locality|local]] to the computer where command is executed.
For a global version of this command, see [[removeWeaponGlobal]].


'''Note''': It is possible to create invalid combinations with this command (ie, attempting to remove a weapon that a unit does not possess). When doing so, application behaviour is undefined.
{{Feature|informative|
It is possible to create invalid combinations with this command (e.g attempting to remove a weapon that a unit does not possess).
When doing so, application behaviour is undefined.
}}


|s1= unit '''removeWeapon''' weapon
|s1= unit [[removeWeapon]] weapon


|p1= unit: [[Object]] - unit or vehicle
|p1= unit: [[Object]] - unit or vehicle
|p2= weapon: [[String]] - weapon class name
|p2= weapon: [[String]] - weapon class name


|r1=[[Nothing]]
|r1= [[Nothing]]
 
|s2= object [[removeWeapon]] [weapon, autoselect]
|s2since= arma3 2.20
 
|p21= object: [[Object]] - unit or vehicle
 
|p22= weapon: [[String]] - weapon class name


|x1= <code>[[player]] [[removeWeapon]] "BAF_L85A2_RIS_SUSAT";</code>
|p23= autoselect: [[String]] - (Optional, default [[true]]) [[false]] to abort weapon autoselection when removing primary weapon.


|x2= <code>An_2 [[removeWeapon]] "M240_veh";</code>
|r2= [[Nothing]]


|seealso= [[removeWeaponGlobal]], [[addWeapon]], [[removeAllWeapons]]
|x1= <sqf>player removeWeapon "BAF_L85A2_RIS_SUSAT";</sqf>
}}


<dl class="command_description">
|x2= <sqf>An_2 removeWeapon "M240_veh";</sqf>


<dt><dt>
|seealso= [[removeWeaponGlobal]] [[addWeapon]] [[removeAllWeapons]]
<dd class="notedate">Posted on May 27, 2009 - 14:30 (CEST)</dd>
}}
<dt class="note">[[User:ZGuba|zGuba]]</dt>
<dd class="note">CTD may occur in certain conditions: when shooter is AI and is currently shooting at target in some proximity (tested with M136 on ACE 1.08 and Compact Fix 1.14H+). Even "dropweapon" action may cause CTD with AI.


</dl>
{{Note
|user= zGuba
|timestamp= 20090527143000
|text= CTD may occur in certain conditions: when shooter is AI and is currently shooting at target in some proximity (tested with M136 on ACE 1.08 and Compact Fix 1.14H+). Even "dropweapon" action may cause CTD with AI.
}}

Latest revision as of 00:27, 15 October 2025

Logo A0.png 1.00ofpe logo.png 1.00Logo A1 black.png 1.00Logo A2.png 1.00A2 OA Logo.png 1.50tkoh logo small.png 1.00Arma 3 logo black.png 0.50
LALocalGEGlobal
Hover & click on the images for description

Description

Description:
Remove weapon from a unit. The unit must be local to the computer where command is executed. For a global version of this command, see removeWeaponGlobal.
ⓘ
It is possible to create invalid combinations with this command (e.g attempting to remove a weapon that a unit does not possess). When doing so, application behaviour is undefined.
Groups:
Unit InventoryVehicle Inventory

Syntax

Syntax:
unit removeWeapon weapon
Parameters:
unit: Object - unit or vehicle
weapon: String - weapon class name
Return Value:
Nothing

Alternative Syntax

Syntax:
object removeWeapon [weapon, autoselect]
Parameters:
object: Object - unit or vehicle
weapon: String - weapon class name
autoselect: String - (Optional, default true) false to abort weapon autoselection when removing primary weapon.
Return Value:
Nothing

Examples

Example 1:
player removeWeapon "BAF_L85A2_RIS_SUSAT";
Example 2:
An_2 removeWeapon "M240_veh";

Additional Information

See also:
removeWeaponGlobal addWeapon removeAllWeapons

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
zGuba - c
Posted on May 27, 2009 - 14:30 (UTC)
CTD may occur in certain conditions: when shooter is AI and is currently shooting at target in some proximity (tested with M136 on ACE 1.08 and Compact Fix 1.14H+). Even "dropweapon" action may cause CTD with AI.
Retrieved from "https://community.bistudio.com/wiki?title=removeWeapon&oldid=376459"