BIS fnc addWeapon: Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
Lou Montana (talk | contribs) m (Text replacement - "_{10,} " to "") |
||
| Line 1: | Line 1: | ||
{{Function|Comments= | {{Function|Comments= | ||
| arma3 |Game name= | | arma3 |Game name= | ||
| Line 10: | Line 9: | ||
|gr2 = Weapons |GROUP2= | |gr2 = Weapons |GROUP2= | ||
| Adds a weapon to the specified unit, with magazine classnames taken from the weapon's config (in [[:Category:Weapons|CfgWeapons]]). | | Adds a weapon to the specified unit, with magazine classnames taken from the weapon's config (in [[:Category:Weapons|CfgWeapons]]). | ||
This function does not remove magazines nor weapons prior to adding the new weapon, so that still has to be done manually. |DESCRIPTION= | This function does not remove magazines nor weapons prior to adding the new weapon, so that still has to be done manually. |DESCRIPTION= | ||
| [unit, weaponClassName, quantity, type] call [[BIS_fnc_addWeapon]] |SYNTAX= | | [unit, weaponClassName, quantity, type] call [[BIS_fnc_addWeapon]] |SYNTAX= | ||
| Line 30: | Line 27: | ||
| [[String]] - Primary'''(!)''' muzzle name of weapon. |RETURNVALUE= | | [[String]] - Primary'''(!)''' muzzle name of weapon. |RETURNVALUE= | ||
|x1= Add 6 dual-purpose magazines and the underwater gun to the player: | |x1= Add 6 dual-purpose magazines and the underwater gun to the player: | ||
| Line 40: | Line 36: | ||
|x3= Alternative syntax of second example, with magazine name written out: | |x3= Alternative syntax of second example, with magazine name written out: | ||
<code>newGun = [bluforUnit, "arifle_Mk20_F", 2, "30Rnd_556x45_Stanag_Tracer_red"] [[call]] [[BIS_fnc_addWeapon]];</code> |Example3= | <code>newGun = [bluforUnit, "arifle_Mk20_F", 2, "30Rnd_556x45_Stanag_Tracer_red"] [[call]] [[BIS_fnc_addWeapon]];</code> |Example3= | ||
| [[addWeapon]], [[selectWeapon]] |SEEALSO= | | [[addWeapon]], [[selectWeapon]] |SEEALSO= | ||
Revision as of 22:43, 16 January 2021
Description
- Description:
- Adds a weapon to the specified unit, with magazine classnames taken from the weapon's config (in CfgWeapons). This function does not remove magazines nor weapons prior to adding the new weapon, so that still has to be done manually.
- Execution:
- call
- Groups:
- InventoryWeapons
Syntax
- Syntax:
- [unit, weaponClassName, quantity, type] call BIS_fnc_addWeapon
- Parameters:
- unit: Object - Unit to add weapon to.
- weaponClassName: String - Weapon Classname (found in CfgWeapons).
- quantity: Number - Amount of magazines.
- type: Number or String - (Optional, default 0)
- Return Value:
- String - Primary(!) muzzle name of weapon.
Examples
- Example 1:
- Add 6 dual-purpose magazines and the underwater gun to the player:
newGun = [player, "arifle_SDAR_F", 6] call BIS_fnc_addWeapon; - Example 2:
- Adds 2 × 30 Rnd Stanag Tracer (Red) magazines to bluforUnit, with an Mk20_F:
newGun = [bluforUnit, "arifle_Mk20_F", 2, 1] call BIS_fnc_addWeapon; - Example 3:
- Alternative syntax of second example, with magazine name written out:
newGun = [bluforUnit, "arifle_Mk20_F", 2, "30Rnd_556x45_Stanag_Tracer_red"] call BIS_fnc_addWeapon;
Additional Information
- See also:
- addWeaponselectWeapon
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
Notes
Bottom Section
- Posted on September 29, 2014 - 18:13 (UTC)
- Tryteyker-
- This function only returns the primary muzzle name of a gun. For more info on how to select guns' secondary muzzle names (like an underhand grenade launcher), view the notes on selectWeapon.