From Bohemia Interactive Community
Jump to navigation Jump to search
Introduced with Armed Assault version 1.001.00Arguments of this scripting command don't have to be local to the client the command is executed on
Hover & click on the images for descriptions


Returns the direction that the vehicle weapon is aiming in. For addons the weapon name must be an entry in CfgWeapons.
Alternatively, you can get turret and gun angle in degrees using animationSourcePhase or animationPhase commands


vehicleName weaponDirection weaponName
vehicleName: Object
weaponName: String
Return Value:
Array - format Vector3D


Example 1:
_weaponVectorDir = player weaponDirection currentWeapon player;
Example 2:
Draw AI eye direction (green) and weapon direction (red) in 3D: bob = createGroup east createUnit ["O_Soldier_F", [0,0,0], [], 0, "NONE"]; bob setVehiclePosition [player modelToWorld [0,100,0], [], 0, "NONE"]; onEachFrame { _beg = ASLToAGL eyePos bob; _endE = (_beg vectorAdd (eyeDirection bob vectorMultiply 100)); drawLine3D [ _beg, _endE, [0,1,0,1]]; _endW = (_beg vectorAdd (bob weaponDirection currentWeapon bob vectorMultiply 100)); drawLine3D [_beg, _endW, [1,0,0,1]]; };

Additional Information

See also:
WeaponsUnit Control


Only post proven facts here. Report bugs on the Feedback Tracker and discuss on the Arma Discord or on the Forums.


Posted on August 18, 2007 - 12:18
HWM mainframe
Works great in multiplayer. The numbers are representing offset as follows : [X axis,Y axis,Z axis] The return array can be processed-converted into degrees as follows: _array = _this weaponDirection "weapon class" ; _dir_degrees = (_array select 0) atan2 (_array select 1);
Posted on November 11, 2007 - 01:41
WeaponClass can only be the primary turret of the vehicle. For example it is not possible to get direction of commander's M2 on M1Abrams.
Posted on November 13, 2007 - 15:54
For an alternative to the weaponDirection command, see the following post on the official forums. On how to obtain the direction of multiple turrets on vehicles. Turret Animations - new forum
Posted on December 9, 2014 - 18:25 (UTC)
The suggestion above using atan2 and weaponDirection get the direction the barrel of a weapon is pointing, but this is not the same as the direction a shell will be fired (verify this by getting in an M4 Scorcher, parking it on a slope, elevating the barrel "across" the slope and watching the shell come out in third person).

Bottom Section