weaponState: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - " \{\{GameCategory\|[a-z]+[0-9]?\|Scripting Commands\}\}" to "") |
Lou Montana (talk | contribs) m (Text replacement - " \| *(game[0-9]|version[0-9]|gr[0-9]|serverExec|mp|pr|descr|s[0-9]|p[0-9]{1,3}|r[0-9]|x1?[0-9]|seealso) *= +" to " |$1= ") |
||
| Line 18: | Line 18: | ||
* Muzzle name is supported as well as weapon name. The command searches for weapon first, then if not found, muzzle is searched for. }} | * Muzzle name is supported as well as weapon name. The command searches for weapon first, then if not found, muzzle is searched for. }} | ||
|s1= | |s1= [[weaponState]] unit | ||
|p1= unit: [[Object]] | |p1= unit: [[Object]] | ||
| Line 31: | Line 31: | ||
|s2= [[weaponState]] [vehicle, turretPath, weapon] | |s2= [[weaponState]] [vehicle, turretPath, weapon] | ||
|p21= | |p21= [vehicle, turretPath, weapon]: [[Array]] | ||
|p22= vehicle: [[Object]] | |p22= vehicle: [[Object]] | ||
Revision as of 22:52, 19 June 2021
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.
- A vehicle's weapon query doesn't need a weapon operator provided the weapon or muzzle is specified in optional param.
- Groups:
- Weapons
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.70) - 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