From Bohemia Interactive Community
Jump to navigation Jump to search
Hover & click on the images for description


Returns the direction that the vehicle weapon is aiming in. For addons the weapon name must be an entry in CfgWeapons.
Turret and gun angle in degrees can also be obtained using animationSourcePhase or animationPhase commands.
WeaponsUnit Control


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:
positionCameraToWorld getCameraViewDirection eyeDirection vectorDir vectorDirVisual


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
Posted on 2007-08-18 - 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 2007-11-11 - 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 2007-11-13 - 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 (dead link) - new forum
Posted on 2014-12-09 - 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).