======Rotate Player To Direction======
----

Rotates the player to face towards the specified [[cardinal direction]] (i.e. north, south, west, or east).

====Signature:====
<code python>
rotate_player_to_direction(direction)
</code>

^Argument^Description^Type^Required^
|direction|[[Cardinal direction]] for the player to face towards.|[[Cardinal Direction]]|Yes|

<WRAP center round info 100%>
[[set_player_movement_locked|Lock/Unlock Player Movement]] must be called before using this function to prevent the player from interfering with the scripted movement.
</WRAP>

====Example:====
<code bauxite>
rotate_player_to_direction(SOUTH);
</code>
//Results:// Rotates the player until they are facing south.

<WRAP center round tip 100%>
Use the **Rotate Player To Direction** function to force the player's viewpoint before an event occurs or to have them facing a specific direction at the end of a cutscene.
</WRAP>

----

<WRAP group>
<WRAP half column>
====Editor Node:====
{{:wiki:rotate_player_to_direction_node.png?nolink|}}
</WRAP>

<WRAP half column>
====Visual Demo:====
{{:wiki:rotate_player_to_direction_demo.gif?nolink|}}
</WRAP>
</WRAP>

~~NOTOC~~