weaponState: Difference between revisions
Jump to navigation
Jump to search
m (template:command argument fix) |
m (template:command argument fix) |
||
| Line 11: | Line 11: | ||
* 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. | * 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]. | * 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. |= | * 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. |DESCRIPTION= | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| '''weaponState''' unit |= | | '''weaponState''' unit |SYNTAX= | ||
|p1= unit: [[Object]] |= | |p1= unit: [[Object]] |PARAMETER1= | ||
| [[Array]] - in format [weapon, muzzle, firemode, magazine, ammoCount], where: | | [[Array]] - in format [weapon, muzzle, firemode, magazine, ammoCount], where: | ||
| Line 23: | Line 23: | ||
* firemode: [[String]] | * firemode: [[String]] | ||
* magazine: [[String]] | * magazine: [[String]] | ||
* ammoCount: [[Number]] |= | * ammoCount: [[Number]] |RETURNVALUE= | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
|s2= '''weaponState''' [vehicle, turretPath, weapon] |= | |s2= '''weaponState''' [vehicle, turretPath, weapon] |SYNTAX= | ||
|p21 = [vehicle, turretPath, weapon]: [[Array]] |= | |p21 = [vehicle, turretPath, weapon]: [[Array]] |= | ||
|p22= vehicle: [[Object]] |= | |p22= vehicle: [[Object]] |PARAMETER1= | ||
|p23= turretPath: [[Array]] |= | |p23= turretPath: [[Array]] |PARAMETER2= | ||
|p24= weapon (Optional): [[String]] (since Arma 3 v1.69.140397) - weapon or muzzle name |= | |p24= weapon (Optional): [[String]] (since Arma 3 v1.69.140397) - weapon or muzzle name |= | ||
| Line 38: | Line 38: | ||
* firemode: [[String]] | * firemode: [[String]] | ||
* magazine: [[String]] | * magazine: [[String]] | ||
* ammoCount: [[Number]] |= | * ammoCount: [[Number]] |RETURNVALUE= | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
Revision as of 15:51, 7 April 2019
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:
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:
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
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
Bottom Section
Categories:
- Scripting Commands
- Introduced with Arma 2: Operation Arrowhead version 1.60
- Arma 2: Operation Arrowhead: New Scripting Commands
- Arma 2: Operation Arrowhead: Scripting Commands
- Command Group: Uncategorised
- Scripting Commands ArmA2
- Scripting Commands Arma 3
- Scripting Commands Take On Helicopters
- ArmA 2 OA: New Scripting Commands List