addWeapon: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
m (Text replacement - "<sqf>([^↵][^\/]*↵[^\/]*)<\/sqf>" to "<sqf> $1 </sqf>")
 
(51 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| ofp |= Game name
|game1= ofp
|version1= 1.00


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


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


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


| Add a weapon to a unit. The unit must be [[local]]. For a global version of this command see [[addWeaponGlobal]].
|game5= arma2oa
|version5= 1.50


Infantry units can only carry a specific number of weapons, once the weapon slots are filled, any further [[addWeapon]] commands are ignored. |= Description
|game6= tkoh
____________________________________________________________________________________________
|version6= 1.00


| unit '''addWeapon''' weapon |= Syntax
|game7= arma3
|version7= 0.50


|p1= unit: [[Object]] - unit or vehicle to add the weapon to |= Parameter 1
|arg= local


|p2= weapon: [[String]] - weapon class name. See the topic [[:Category:Weapons]] for reference about possible values. |= Parameter 2
|eff= global


| [[Nothing]] |= Return value
|gr1= Unit Inventory
____________________________________________________________________________________________
 
|x1= <code>[[player]] [[addMagazine]] "30Rnd_556x45_Stanag";
[[player]] [[addWeapon]] "BAF_L85A2_RIS_SUSAT";</code> |= Example 1


|x2= <code>An_2 [[addMagazine]] "100Rnd_762x51_M240";
|gr2= Vehicle Inventory
An_2 [[addWeapon]] "M240_veh";</code> |= Example 2
____________________________________________________________________________________________


| [[addWeaponGlobal]], [[removeWeapon]], [[removeAllWeapons]], [[addMagazine]] |= See also
|descr= Add a weapon to a unit. For a global version of this command see [[addWeaponGlobal]].


}}
Infantry units can only carry a specific number of weapons, once the weapon slots are filled, any further [[addWeapon]] commands are ignored.


<h3 style="display:none">Notes</h3>
{{Feature|informative|a '''magazine''' must be added first for the added weapon to be loaded.}}
<dl class="command_description">
<!-- Note Section BEGIN -->


<dd class="notedate">Posted on August 2, 2006 - 10:19
{{Feature|warning| In Arma 3 this command can also link items to the inventory slots, the functionality is identical to [[linkItem]] command, which it global and thus differ in how it should be used.}}
<dt class="note">'''[[User:Hardrock|hardrock]]'''<dd class="note">''Notes from before the conversion:''


To ensure that the weapon is loaded at the start of the mission, add at least one magazine ([[addMagazine]]) before adding the weapon. To remove weapons use the [[removeAllWeapons]] or the [[removeWeapon]] commands.
|s1= object [[addWeapon]] weapon


|p1= object: [[Object]] - unit or vehicle to add the weapon to


<dt class="note">'''[[User:Talkingtoaj|talkingtoaj]]'''<dd class="note">
|p2= weapon: [[String]] - weapon class name. See the topic [[:Category:Weapons]] for reference about possible values.


When adding a weapon in-game, a bug means that sometimes the weapon can't be fired. Swap to a different weapon and swap back again to enable the newly added weapon to fire; or drop and pick up the weapon again.
|r1= [[Nothing]]


|x1= <sqf>
player addMagazine "30Rnd_556x45_Stanag";
player addWeapon "BAF_L85A2_RIS_SUSAT";
</sqf>


|x2= <sqf>
An_2 addMagazine "100Rnd_762x51_M240";
An_2 addWeapon "M240_veh";
</sqf>


 
|seealso= [[addWeaponGlobal]] [[addWeaponTurret]] [[removeWeapon]] [[removeAllWeapons]] [[addMagazine]]
<!-- Note Section END -->
}}
</dl>
 
<h3 style="display:none">Bottom Section</h3>
 
 
[[Category:Scripting Commands|ADDWEAPON]]
[[Category:Scripting Commands OFP 1.96|ADDWEAPON]]
[[Category:Scripting Commands OFP 1.46|ADDWEAPON]]
[[Category:Scripting Commands ArmA|ADDWEAPON]]
[[Category:Command_Group:_Weapons|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]

Latest revision as of 21:37, 2 September 2024

Hover & click on the images for description

Description

Description:
Add a weapon to a unit. For a global version of this command see addWeaponGlobal. Infantry units can only carry a specific number of weapons, once the weapon slots are filled, any further addWeapon commands are ignored.
a magazine must be added first for the added weapon to be loaded.
In Arma 3 this command can also link items to the inventory slots, the functionality is identical to linkItem command, which it global and thus differ in how it should be used.
Groups:
Unit InventoryVehicle Inventory

Syntax

Syntax:
object addWeapon weapon
Parameters:
object: Object - unit or vehicle to add the weapon to
weapon: String - weapon class name. See the topic Category:Weapons for reference about possible values.
Return Value:
Nothing

Examples

Example 1:
player addMagazine "30Rnd_556x45_Stanag"; player addWeapon "BAF_L85A2_RIS_SUSAT";
Example 2:
An_2 addMagazine "100Rnd_762x51_M240"; An_2 addWeapon "M240_veh";

Additional Information

See also:
addWeaponGlobal addWeaponTurret removeWeapon removeAllWeapons addMagazine

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