weaponsItems: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(some info)
(moving note to talk)
Line 78: Line 78:
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on October 25, 2014 - 01:45 (UTC)</dd>
<dt class="note">[[User:DreadedEntity|DreadedEntity]]</dt>
<dd class="note">
The output of this command is an array of arrays and is as follows: (If the unit only has 1 weapon, output is an array within an array.)
<code>[
[
((_arr select 0) select 0) //STRING - The weapon's classname
((_arr select 0) select 1) //STRING - Classname of the unit's equipped 'Muzzle/Barrel Accessory'
((_arr select 0) select 2) //STRING - Classname of the unit's equipped 'Side Accessory'
((_arr select 0) select 3) //STRING - Classname of the unit's equipped 'Top/Optic Accessory'
((_arr select 0) select 4) //ARRAY - Magazine information
[
(((_arr select 0) select 4) select 0) //STRING - Classname of the loaded magazine
(((_arr select 0) select 4) select 1) //SCALAR(Number) - Amount of bullets in the mag
]
] //If unit has more than one weapon, the output will follow the same pattern as above except with a new element
]</code>
</dd>
</dl>
<!-- DISCONTINUE Notes -->

Revision as of 14:57, 2 July 2019

Hover & click on the images for description

Description

Description:
Weaponsitems.jpg
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.
  • 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.
Groups:
Uncategorised

Syntax

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],[],""]

Examples

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],[],""] ]

Additional Information

See also:
weaponsItemsCargoprimaryWeaponItemssecondaryWeaponItemshandgunItemsaddPrimaryWeaponItemaddSecondaryWeaponItemaddHandgunItemprimaryWeaponsecondaryWeaponhandgunWeaponweaponAccessoriesBIS_fnc_weaponComponents

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

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 ], "" ]

Bottom Section