From Bohemia Interactive Community
Jump to navigation Jump to search
Introduced with Operation Flashpoint version 1.00
  Arguments of this scripting command have to be local to the client the command is executed onEffects of this scripting command are broadcasted over the network and happen on every computer in the network

Click on the images for descriptions

Introduced in

Operation Flashpoint


Sets object heading. Angles are measured in degrees clockwise from north, and regular range goes from 0 to 360 (0° = N, 90° = E, 180° = S, 270° = W). Negative angles represent a counter-clockwise angle.


object setDir heading
object: Object
heading: Number
Return Value:


Example 1:
unit1 setDir 45; // will set unit1 to face North-East
Example 2:
unit1 setDir -675; // will also set unit1 to face North-East (= 45-360-360)
Example 3:
unit1 setDir 30; unit1 setFormDir 30;// needed for AI to keep the given direction

Additional Information

See notes below for more details on setDir behaviour.
See also:


Only post proven facts here. Report bugs on the feedback tracker. Use the talk page or the forums for discussions.
Add New Note | How To


Posted on May 9, 2007 - 20:43 CET
Though effects of this command remain local, you can do a setPos afterwards to synchronize the direction on all machines in MP. myObj setDir 90; myObj setPos getPos myObj;
Posted on January 9, 2009 - 22:21
In ArmA, the effect of setDir is synchronized across the network.
Posted on April 5th, 2011
In OA 1.59 the comment of Manny still holds true for createVehicle'd empty vehicles by the server. For the player object a local setDir alone is enough.
Posted on November 25, 2013
In Arma 3, setDir affects vectorUp, vectorDir and velocity of the object it applied to. While this is not noticeable with stationary objects, a moving objects will have its orientation and velocity reset. So if you are planning on using setDir on a moving object, make sure you read the velocity value before and restore it after if you want the object to continue to move. _vel = velocity _object; _object setDir 45; _object setVelocity _vel; With orientation it is a bit more complicated. setDir resets vectorUp to [0,0,1] and changes vectorDir accordingly to accommodate set direction. If your object's vectorUp is not [0,0,1] and you want to keep it this way, then you have to use setVectorDirAndUp to change object's direction not setDir. This is also the reason why it is better to use setVectorDirAndUp instead of setDir on attached objects for a better control of object's orientation.
Posted on November 27, 2013
Make sure you setDir BEFORE you set position. Setting direction after set position could lead to unpredictable behaviour. For example main part of the hospital building in Arma 3 can lose collision detection near both side entrances. AI will also get confused and will stop detecting obstacles if setDir is called after setPos.
Posted on February 9, 2018 - 14:57 (UTC)
setDir is not propagated across the network when used on mines. Clients will see mines facing zero. This is especially noticeable on tripwire mines.
Use remoteExec to run the setDir command on the mine for all clients.

Bottom Section