That's all Folks!

itsneufox · itsneufox · commit 7aad7a89c98e · 2025-11-07T00:58:12.000Z
diff --git a/frontend/docs/scripting/callbacks/OnNPCChangeNode.md b/frontend/docs/scripting/callbacks/OnNPCChangeNode.md
@@ -26,21 +26,20 @@ Return `true` to allow the node change, or `false` to deny it.
 ```c
 public OnNPCChangeNode(npcid, newnodeid, oldnodeid)
 {
-    printf("NPC %d is changing from node %d to node %d", npcid, oldnodeid, newnodeid);
+    printf("[NPC] NPC %d changed from node %d to node %d", npcid, oldnodeid, newnodeid);
 
-    // Check if the new node is open
-    if (!NPC_IsNodeOpen(newnodeid))
+    // Notify players tracking this NPC
+    for (new playerid = 0; playerid < MAX_PLAYERS; playerid++)
     {
-        return false; // Deny change to closed node
-    }
+        if (!IsPlayerConnected(playerid))
+            continue;
 
-    // Prevent NPCs from going to node 5
-    if (newnodeid == 5)
-    {
-        return false; // Block access to node 5
+        if (PlayerNPC[playerid] == npcid)
+        {
+            SendClientMessage(playerid, 0x00FF00FF, "NPC %d changed from node %d to node %d", npcid, oldnodeid, newnodeid);
+        }
     }
-
-    return true; // Allow the change
+    return 1;
 }
 ```
 
diff --git a/frontend/docs/scripting/callbacks/OnNPCCreate.md b/frontend/docs/scripting/callbacks/OnNPCCreate.md
@@ -20,13 +20,17 @@ This callback is called when an NPC is successfully created and added to the ser
 ```c
 public OnNPCCreate(npcid)
 {
-    printf("NPC %d has been created", npcid);
+    printf("[NPC] NPC %d has been created", npcid);
 
-    // Set initial properties
-    NPC_SetSkin(npcid, 23);
-    NPC_SetPos(npcid, 1958.33, 1343.12, 15.36);
+    // Notify all connected players
+    for (new playerid = 0; playerid < MAX_PLAYERS; playerid++)
+    {
+        if (!IsPlayerConnected(playerid))
+            continue;
 
-    return true;
+        SendClientMessage(playerid, 0x00FF00FF, "NPC %d has been created", npcid);
+    }
+    return 1;
 }
 ```
 
diff --git a/frontend/docs/scripting/callbacks/OnNPCDeath.md b/frontend/docs/scripting/callbacks/OnNPCDeath.md
@@ -20,27 +20,29 @@ This callback is called when an NPC dies.
 ## Examples
 
 ```c
-public OnNPCDeath(npcid, killerid, reason)
+public OnNPCDeath(npcid, killerid, WEAPON:reason)
 {
-    if (killerid != INVALID_PLAYER_ID)
-    {
-        printf("NPC %d was killed by %d with reason %d", npcid, killerid, reason);
-    }
-    else
+    printf("[NPC] NPC %d died (killer: %d, weapon: %d)", npcid, killerid, _:reason);
+
+    // Notify players tracking this NPC
+    for (new playerid = 0; playerid < MAX_PLAYERS; playerid++)
     {
-        printf("NPC %d died", npcid);
+        if (!IsPlayerConnected(playerid))
+            continue;
+
+        if (PlayerNPC[playerid] == npcid)
+        {
+            if (killerid == INVALID_PLAYER_ID)
+            {
+                SendClientMessage(playerid, 0xFF0000FF, "Your tracked NPC %d died (weapon: %d)", npcid, _:reason);
+            }
+            else
+            {
+                SendClientMessage(playerid, 0xFF0000FF, "Your tracked NPC %d was killed by player %d (weapon: %d)", npcid, killerid, _:reason);
+            }
+        }
     }
-
-    // Respawn after 5 seconds
-    SetTimerEx("RespawnNPC", 5000, false, "i", npcid);
-
-    return true;
-}
-
-forward RespawnNPC(npcid);
-public RespawnNPC(npcid)
-{
-    NPC_Respawn(npcid);
+    return 1;
 }
 ```
 
diff --git a/frontend/docs/scripting/callbacks/OnNPCDestroy.md b/frontend/docs/scripting/callbacks/OnNPCDestroy.md
@@ -20,17 +20,27 @@ This callback is called when an NPC is destroyed and removed from the server.
 ```c
 public OnNPCDestroy(npcid)
 {
-    printf("NPC %d has been destroyed", npcid);
+    printf("[NPC] NPC %d has been destroyed", npcid);
 
-    // Clean up timers
-    if (g_NPCTimer[npcid] != -1)
+    // Clear any player tracking this NPC and notify
+    for (new playerid = 0; playerid < MAX_PLAYERS; playerid++)
     {
-        KillTimer(g_NPCTimer[npcid]);
-        g_NPCTimer[npcid] = -1;
+        if (!IsPlayerConnected(playerid))
+            continue;
+
+        if (PlayerNPC[playerid] == npcid)
+        {
+            PlayerNPC[playerid] = INVALID_NPC_ID;
+            SendClientMessage(playerid, 0xFF0000FF, "Your tracked NPC %d has been destroyed", npcid);
+        }
+        else
+        {
+            SendClientMessage(playerid, 0xFFFF00FF, "NPC %d has been destroyed", npcid);
+        }
     }
-
-    return true;
+    return 1;
 }
+
 ```
 
 ## Notes
diff --git a/frontend/docs/scripting/callbacks/OnNPCFinishMove.md b/frontend/docs/scripting/callbacks/OnNPCFinishMove.md
@@ -20,14 +20,20 @@ This callback is called when an NPC finishes moving to its target destination.
 ```c
 public OnNPCFinishMove(npcid)
 {
-    printf("NPC %d has reached its destination", npcid);
-
-    // Move to next destination
-    new Float:x, Float:y, Float:z;
-    NPC_GetPos(npcid, x, y, z);
-    NPC_Move(npcid, x + 10.0, y + 10.0, z, NPC_MOVE_TYPE_WALK);
-
-    return true;
+    // Find all players tracking this NPC
+    for (new playerid = 0; playerid < MAX_PLAYERS; playerid++)
+    {
+        if (!IsPlayerConnected(playerid))
+            continue;
+
+        if (PlayerNPC[playerid] == npcid)
+        {
+            new Float:x, Float:y, Float:z;
+            NPC_GetPos(npcid, x, y, z);
+            SendClientMessage(playerid, 0x00FF00FF, "NPC %d finished moving to position (%.2f, %.2f, %.2f)", npcid, x, y, z);
+        }
+    }
+    return 1;
 }
 ```
 
diff --git a/frontend/docs/scripting/callbacks/OnNPCFinishMovePath.md b/frontend/docs/scripting/callbacks/OnNPCFinishMovePath.md
@@ -21,13 +21,20 @@ This callback is called when an NPC finishes moving along a predefined path.
 ```c
 public OnNPCFinishMovePath(npcid, pathid)
 {
-    printf("NPC %d finished moving along path %d", npcid, pathid);
-
-    // Start moving on another path
-    NPC_MoveByPath(npcid, pathid + 1, NPC_MOVE_TYPE_WALK);
-
-    return true;
+    // Find all players tracking this NPC
+    for (new playerid = 0; playerid < MAX_PLAYERS; playerid++)
+    {
+        if (!IsPlayerConnected(playerid))
+            continue;
+
+        if (PlayerNPC[playerid] == npcid)
+        {
+            SendClientMessage(playerid, 0x00FF00FF, "NPC %d finished moving along path %d", npcid, pathid);
+        }
+    }
+    return 1;
 }
+
 ```
 
 ## Notes
diff --git a/frontend/docs/scripting/callbacks/OnNPCFinishMovePathPoint.md b/frontend/docs/scripting/callbacks/OnNPCFinishMovePathPoint.md
@@ -19,6 +19,25 @@ This callback is called when an NPC finishes moving to a specific point in a pat
 
 ## Examples
 
+```c
+public OnNPCFinishMovePathPoint(npcid, pathid, pointid)
+{
+    // Find all players tracking this NPC
+    for (new playerid = 0; playerid < MAX_PLAYERS; playerid++)
+    {
+        if (!IsPlayerConnected(playerid))
+            continue;
+
+        if (PlayerNPC[playerid] == npcid)
+        {
+            SendClientMessage(playerid, 0xFFFF00FF, "NPC %d reached point %d on path %d", npcid, pointid, pathid);
+        }
+    }
+    return 1;
+}
+
+```
+
 ## Notes
 
 - This callback is triggered for each point in the path
diff --git a/frontend/docs/scripting/callbacks/OnNPCFinishNode.md b/frontend/docs/scripting/callbacks/OnNPCFinishNode.md
@@ -19,14 +19,20 @@ This callback is called when an NPC finishes navigating a complete node during n
 ## Examples
 
 ```c
-public OnNPCFinishNode(npcid, nodeid)
+public OnNPCFinishNodePoint(npcid, nodeid, pointid)
 {
-    printf("NPC %d finished navigating node %d", npcid, nodeid);
-
-    // Start navigation on next node
-    NPC_PlayNode(npcid, nodeid + 1, NPC_MOVE_TYPE_WALK, 1.0, 2.0, true);
-
-    return true;
+    // Notify players tracking this NPC
+    for (new playerid = 0; playerid < MAX_PLAYERS; playerid++)
+    {
+        if (!IsPlayerConnected(playerid))
+            continue;
+
+        if (PlayerNPC[playerid] == npcid)
+        {
+            SendClientMessage(playerid, 0xFFFF00FF, "NPC %d reached node %d point %d", npcid, nodeid, pointid);
+        }
+    }
+    return 1;
 }
 ```
 
diff --git a/frontend/docs/scripting/callbacks/OnNPCFinishNodePoint.md b/frontend/docs/scripting/callbacks/OnNPCFinishNodePoint.md
@@ -20,24 +20,22 @@ This callback is called when an NPC reaches a specific point during node-based n
 ## Examples
 
 ```c
-public OnNPCFinishNodePoint(npcid, nodeid, pointid)
+public OnNPCFinishNode(npcid, nodeid)
 {
-    printf("NPC %d reached point %d in node %d", npcid, pointid, nodeid);
+    printf("[NPC] NPC %d finished node %d", npcid, nodeid);
 
-    // Pause at specific point
-    if (pointid == 10)
+    // Notify players tracking this NPC
+    for (new playerid = 0; playerid < MAX_PLAYERS; playerid++)
     {
-        NPC_PausePlayingNode(npcid);
-        SetTimerEx("ResumeNavigation", 3000, false, "i", npcid);
-    }
-
-    return true;
-}
+        if (!IsPlayerConnected(playerid))
+            continue;
 
-forward ResumeNavigation(npcid);
-public ResumeNavigation(npcid)
-{
-    NPC_ResumePlayingNode(npcid);
+        if (PlayerNPC[playerid] == npcid)
+        {
+            SendClientMessage(playerid, 0x00FF00FF, "NPC %d finished node %d", npcid, nodeid);
+        }
+    }
+    return 1;
 }
 ```
 
diff --git a/frontend/docs/scripting/callbacks/OnNPCGiveDamage.md b/frontend/docs/scripting/callbacks/OnNPCGiveDamage.md
@@ -26,17 +26,21 @@ Return `false` to prevent the damage from being applied, or `true` to allow it.
 ## Examples
 
 ```c
-public OnNPCGiveDamage(npcid, damagedid, Float:amount, weaponid, bodypart)
+public OnNPCGiveDamage(npcid, damagedid, Float:amount, WEAPON:weaponid, bodypart)
 {
-    printf("NPC %d gave %.2f damage to player %d", npcid, amount, damagedid);
-
-    // Prevent NPCs from killing admins
-    if (IsPlayerAdmin(damagedid))
+    // Only notify players tracking this NPC
+    for (new playerid = 0; playerid < MAX_PLAYERS; playerid++)
     {
-        return false; // Block the damage
+        if (!IsPlayerConnected(playerid))
+            continue;
+
+        if (PlayerNPC[playerid] == npcid)
+        {
+            SendClientMessage(playerid, 0xFF8800FF, "NPC %d dealt %.1f damage to player %d (weapon: %d, bodypart: %d)",
+                npcid, amount, damagedid, _:weaponid, bodypart);
+        }
     }
-
-    return true; // Allow the damage
+    return 1;
 }
 ```
 
diff --git a/frontend/docs/scripting/callbacks/OnNPCPlaybackEnd.md b/frontend/docs/scripting/callbacks/OnNPCPlaybackEnd.md
@@ -21,13 +21,22 @@ This callback is called when an NPC finishes playback of a recorded file.
 ```c
 public OnNPCPlaybackEnd(npcid, recordid)
 {
-    printf("NPC %d finished playing record %d", npcid, recordid);
-
-    // Start another recording
-    NPC_StartPlayback(npcid, "another_recording", true);
-
-    return true;
+    printf("[NPC] NPC %d finished playback (record: %d)", npcid, recordid);
+
+    // Notify players tracking this NPC
+    for (new playerid = 0; playerid < MAX_PLAYERS; playerid++)
+    {
+        if (!IsPlayerConnected(playerid))
+            continue;
+
+        if (PlayerNPC[playerid] == npcid)
+        {
+            SendClientMessage(playerid, 0x00FF00FF, "NPC %d finished playback (record ID: %d)", npcid, recordid);
+        }
+    }
+    return 1;
 }
+
 ```
 
 ## Notes
diff --git a/frontend/docs/scripting/callbacks/OnNPCPlaybackStart.md b/frontend/docs/scripting/callbacks/OnNPCPlaybackStart.md
@@ -21,14 +21,22 @@ This callback is called when an NPC starts playback of a recorded file.
 ```c
 public OnNPCPlaybackStart(npcid, recordid)
 {
-    printf("NPC %d started playing record %d", npcid, recordid);
-
-    // Set properties during playback
-    NPC_SetHealth(npcid, 100.0);
-    NPC_SetArmour(npcid, 50.0);
-
-    return true;
+    printf("[NPC] NPC %d started playback (record: %d)", npcid, recordid);
+
+    // Notify players tracking this NPC
+    for (new playerid = 0; playerid < MAX_PLAYERS; playerid++)
+    {
+        if (!IsPlayerConnected(playerid))
+            continue;
+
+        if (PlayerNPC[playerid] == npcid)
+        {
+            SendClientMessage(playerid, 0x00FF00FF, "NPC %d started playback (record ID: %d)", npcid, recordid);
+        }
+    }
+    return 1;
 }
+
 ```
 
 ## Notes
diff --git a/frontend/docs/scripting/callbacks/OnNPCRespawn.md b/frontend/docs/scripting/callbacks/OnNPCRespawn.md
diff --git a/frontend/docs/scripting/callbacks/OnNPCSpawn.md b/frontend/docs/scripting/callbacks/OnNPCSpawn.md
diff --git a/frontend/docs/scripting/callbacks/OnNPCTakeDamage.md b/frontend/docs/scripting/callbacks/OnNPCTakeDamage.md
diff --git a/frontend/docs/scripting/callbacks/OnNPCWeaponShot.md b/frontend/docs/scripting/callbacks/OnNPCWeaponShot.md
diff --git a/frontend/docs/scripting/callbacks/OnNPCWeaponStateChange.md b/frontend/docs/scripting/callbacks/OnNPCWeaponStateChange.md
