weaponState

1.60

Hover & click on the images for description

Description

Description:

Returns the currently selected weapon state for unit or vehicle.

Since Arma 3 v1.67.140397 this command has been improved and extended:

• It is now possible to query any weapon of a vehicle without the need to place a weapon operator first, provided the weapon or muzzle is specified in optional param. By default a vehicle has no weapons selected, so querying currently selected weapon returns no weapon, unless weapon is specified.
• Driver turret can now be accessed as well with turret path [-1].
• Muzzle name is supported as well as weapon name. Weapon search gets priority, but if there is no weapon with such name, the muzzle will be selected.

Groups:

Uncategorised

Syntax

Syntax:

weaponState unit

Parameters:

unit: Object

Return Value:

Array - in format [weapon, muzzle, firemode, magazine, ammoCount], where:

• weapon: String
• muzzle: String
• firemode: String
• magazine: String
• ammoCount: Number

Alternative Syntax

Syntax:

weaponState [vehicle, turretPath, weapon]

Parameters:

[vehicle, turretPath]: Array

vehicle: Object

turretPath: Array

weapon (Optional): String (since Arma 3 v1.69.140397) - weapon or muzzle name

Return Value:

Array - in format [weapon, muzzle, firemode, magazine, ammoCount], where:

• weapon: String
• muzzle: String
• firemode: String
• magazine: String
• ammoCount: Number

Examples

Example 1:

_wsPlayer = weaponState player;// ["m16a4","m16a4","Single","30Rnd_556x45_Stanag",29]

Example 2:

_wsVehiclePlayer = weaponState [vehicle player,[0]]; //["M256","M256","M256","20Rnd_120mmSABOT_M1A2",20]

Example 3:

_SecondPositionOfThefirstTurret = weaponState [vehicle player,[0,0,1]];

Additional Information

See also:

weaponsselectWeaponTurretloadMagazinemagazinesTurretweaponsTurret

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