weaponsItems: Difference between revisions

Revision as of 21:36, 7 September 2020

Hover & click on the images for description

Description:

Returns an array with subarrays contains class names and also names of connected items of all the vehicle's weapons.

ⓘ

This command will return weapon magazines as well in format [magazineName, ammoCount], or empty array [] if weapon has no magazine

Since Arma 3 v1.21.124406 it is possible to query weapon holders and ammo crates with this command. If the argument is a vehicle, the command will return vehicle's weapons. If the argument is a container, the command will act identical to weaponsItemsCargo.
Since Arma 3 v1.95.145811 the returned array always contains secondary muzzle magazine info and consistent with getUnitLoadout format for weapon items.
Since Arma 3 v2.01.146668 the returned array always contains binocular weapon items.

Groups:

Uncategorised

Syntax:: weaponsItems vehicle
Parameters:: vehicle: Object - unit or vehicle
Return Value:: Array - array containing arrays of weapon items info in format [weapon:String, muzzle:String, flashlight:String, optics:String, primaryMuzzleMagazine:Array, secondaryMuzzleMagazine:Array, bipod:String], for example: ["hgun_P07_F","","","",["16Rnd_9x21_Mag",16],[],""]

Example 1:: hint str weaponsItems player; [ ["arifle_MX_ACO_pointer_F","muzzle_snds_H","acc_pointer_IR","optic_Aco",["30Rnd_65x39_caseless_mag",30],[],"bipod_01_F_blk"], ["launch_NLAW_F","","","",["NLAW_F",1],[],""], ["hgun_P07_F","muzzle_snds_L","","",["16Rnd_9x21_Mag",11],[],""] ]
Example 2:: hint str weaponsItems vehicle player; [ ["gatling_30mm","","","",["250Rnd_30mm_HE_shells",250],[],""], ["missiles_SCALPEL","","","",["8Rnd_LG_scalpel",8],[],""], ["rockets_Skyfire","","","",["38Rnd_80mm_rockets",38],[],""] ]

See also:: weaponsItemsCargo primaryWeaponItems secondaryWeaponItems handgunItems addPrimaryWeaponItem addSecondaryWeaponItem addHandgunItem primaryWeapon secondaryWeapon handgunWeapon weaponAccessories addWeaponWithAttachmentsCargoGlobal BIS_fnc_weaponComponents

: 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

Posted on August 17, 2013
AgentRev: Be careful with this function. The weapons are listed in the order they were taken by the unit, with the most recent at the bottom of the array. Therefore, do not assume the first one is always the primary weapon, and so on. Also, here's how the primary weapon looks if it has a grenade launcher with a loaded grenade:

[ "arifle_MX_GL_F", "muzzle_snds_H", "acc_pointer_IR", "optic_Aco", [ "30Rnd_65x39_caseless_mag", 30 ], [ "1Rnd_HE_Grenade_shell", 1 ], "" ]

@@ Line 7: / Line 7: @@
 ____________________________________________________________________________________________
-| [[Image:Weaponsitems.jpg|150px|right|border]]Returns an array with subarrays contains class names and also names of connected items of all the vehicle's weapons. If weapon has no magazine, an empty array [] is returned instead of magazine info.<br>
+| [[Image:Weaponsitems.jpg|150px|right|border]]Returns an array with subarrays contains class names and also names of connected items of all the vehicle's weapons.
+{{Informative | This command will return weapon magazines as well in format [magazineName, ammoCount], or empty array [] if weapon has no magazine}}
 * Since Arma 3 v1.21.124406 it is possible to query weapon holders and ammo crates with this command. If the argument is a vehicle, the command will return vehicle's weapons. If the argument is a container, the command will act identical to [[weaponsItemsCargo]].
-* Since Arma 3 v1.95.145811 the returned array always contains secondary muzzle magazine info and consistent with [[getUnitLoadout]] format for weapon items.  |DESCRIPTION=
+* Since Arma 3 v1.95.145811 the returned array always contains secondary muzzle magazine info and consistent with [[getUnitLoadout]] format for weapon items.
+* Since Arma 3 v2.01.146668 the returned array always contains binocular weapon items.  |DESCRIPTION=
 ____________________________________________________________________________________________