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.69.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 given name, the muzzles will be searched.

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, weapon]: 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; // ["arifle_MXC_ACO_F","arifle_MXC_ACO_F","Single","30Rnd_65x39_caseless_mag",30]

Example 2:

_wsVehicle = weaponState [_apc, [0]]; // ["autocannon_40mm_CTWS","HE","player","60Rnd_40mm_GPR_Tracer_Red_shells",60]

Example 3:

_wsVehicle = weaponState [_apc, [0], "AP"]; // ["autocannon_40mm_CTWS","AP","player","40Rnd_40mm_APFSDS_Tracer_Red_shells",40]

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