Add documentation for NPC_SetAngleToPlayer and NPC_SetAngleToPos functions

Author: itsneufox

frontend/docs/scripting/functions/NPC_SetAngleToPlayer.md

@@ -0,0 +1,63 @@
+---
+title: NPC_SetAngleToPlayer
+sidebar_label: NPC_SetAngleToPlayer
+description: Rotates an NPC to face a specific player.
+tags: ["npc", "angle", "player"]
+---
+
+<VersionWarn version='omp v1.1.0.changemelater' />
+
+## Description
+
+Rotates an NPC to face a specific player by using the player's current position.
+
+| Name     | Description |
+| -------- | ----------- |
+| npcid    | The ID of the NPC. |
+| playerid | The ID of the player that the NPC should face. |
+
+## Returns
+
+Returns `true` if the NPC was rotated successfully, `false` otherwise.
+
+## Examples
+
+```c
+public OnPlayerCommandText(playerid, cmdtext[])
+{
+    if (!strcmp(cmdtext, "/lookatme", true))
+    {
+        new npcid = PlayerNPC[playerid];
+        if (npcid == INVALID_NPC_ID)
+            return SendClientMessage(playerid, 0xFF0000FF, "You are not debugging a NPC.");
+
+        if (!NPC_IsValid(npcid))
+            return SendClientMessage(playerid, 0xFF0000FF, "Invalid NPC.");
+
+        if (!IsPlayerConnected(playerid))
+            return SendClientMessage(playerid, 0xFF0000FF, "Invalid player.");
+
+        NPC_SetAngleToPlayer(npcid, playerid);
+        SendClientMessage(playerid, 0x00FF00FF, "NPC %d is now facing you.", npcid);
+        return 1;
+    }
+    return 0;
+}
+```
+
+## Notes
+
+:::warning
+
+- This function performs a single rotation; call it again to keep the NPC facing a moving player.
+- The player must be connected, otherwise the NPC will not rotate.
+- Internally uses [NPC_SetAngleToPos](NPC_SetAngleToPos) with the player's current position.
+
+:::
+
+## Related Functions
+
+- [NPC_SetAngleToPos](NPC_SetAngleToPos): Face a specific position.
+- [NPC_SetFacingAngle](NPC_SetFacingAngle): Set a numeric angle.
+- [NPC_GetFacingAngle](NPC_GetFacingAngle): Get the NPC's facing angle.
+- [NPC_MoveToPlayer](NPC_MoveToPlayer): Move the NPC toward a player.

frontend/docs/scripting/functions/NPC_SetAngleToPos.md

@@ -0,0 +1,64 @@
+---
+title: NPC_SetAngleToPos
+sidebar_label: NPC_SetAngleToPos
+description: Rotates an NPC so it faces a specific world position.
+tags: ["npc", "angle", "position"]
+---
+
+<VersionWarn version='omp v1.1.0.changemelater' />
+
+## Description
+
+Rotates an NPC so it faces a specific world position.
+
+| Name   | Description |
+| ------ | ----------- |
+| npcid  | The ID of the NPC. |
+| Float:x | X coordinate of the target position. |
+| Float:y | Y coordinate of the target position. |
+| Float:z | Z coordinate of the target position. |
+
+## Returns
+
+Returns `true` if the NPC was rotated successfully, `false` otherwise.
+
+## Examples
+
+```c
+public OnPlayerCommandText(playerid, cmdtext[])
+{
+    if (!strcmp(cmdtext, "/lookatpos", true))
+    {
+        new npcid = PlayerNPC[playerid];
+        if (npcid == INVALID_NPC_ID)
+            return SendClientMessage(playerid, 0xFF0000FF, "You are not debugging a NPC.");
+
+        if (!NPC_IsValid(npcid))
+            return SendClientMessage(playerid, 0xFF0000FF, "Invalid NPC.");
+
+        new Float:x, Float:y, Float:z;
+        GetPlayerPos(playerid, x, y, z);
+
+        NPC_SetAngleToPos(npcid, x + 3.0, y, z);
+        SendClientMessage(playerid, 0x00FF00FF, "NPC %d now faces %.2f, %.2f, %.2f", npcid, x + 3.0, y, z);
+        return 1;
+    }
+    return 0;
+}
+```
+
+## Notes
+
+:::warning
+
+- Only the horizontal plane (X/Y) is considered when calculating the facing angle.
+- The NPC will not move; it only rotates to face the position.
+
+:::
+
+## Related Functions
+
+- [NPC_SetFacingAngle](NPC_SetFacingAngle): Set an exact angle value.
+- [NPC_SetAngleToPlayer](NPC_SetAngleToPlayer): Face a player automatically.
+- [NPC_GetFacingAngle](NPC_GetFacingAngle): Get the NPC's current facing.
+- [NPC_Move](NPC_Move): Move the NPC toward a position.