weaponState

1.601.000.50

Hover & click on the images for description

Description

Description:

Returns the currently selected weapon state for unit or vehicle.

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

• A vehicle's weapon query doesn't need a weapon operator provided the weapon or muzzle is specified in optional param.
  (keep in mind that by default a vehicle has no weapons selected)
• Driver turret can now be accessed as well with turret path [-1].
• Muzzle name is supported as well as weapon name. The command searches for weapon first, then if not found, muzzle is searched for.

Groups:

Weapons

Syntax

Syntax:

weaponState unit

Parameters:

unit: Object

Return Value:

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

• weapon: String
• muzzle: String
• firemode: String
• magazine: String
• ammoCount: Number
• roundReloadPhase: Number - current ammo round reload phase (see weaponReloadingTime Since Arma 3 v2.05.147785)

Alternative Syntax

Syntax:

weaponState [vehicle, turretPath, weapon]

Parameters:

[vehicle, turretPath, weapon]: Array

vehicle: Object

turretPath: Array

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

Return Value:

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

• weapon: String
• muzzle: String
• firemode: String
• magazine: String
• ammoCount: Number
• roundReloadPhase: Number - current ammo round reload phase (see weaponReloadingTime Since Arma 3 v2.05.147785)

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:

weaponsselectWeaponTurretloadMagazinemagazinesTurretweaponsTurretweaponReloadingTime

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