---
title: "NPC_AddPointToPath | open.mp"
description: "Adds a waypoint to an NPC path."
canonical: https://omp.itsneufox.com/docs/scripting/functions/NPC_AddPointToPath
language: en
---

# NPC\_AddPointToPath

warning

This function was added in omp v1.5.8.3079 and will not work in earlier versions!

## Description

Adds a waypoint to an NPC path.

| Name | Description |
| --- | --- |
| pathid | The ID of the path to add the point to |
| x | The X coordinate of the waypoint |
| y | The Y coordinate of the waypoint |
| z | The Z coordinate of the waypoint |
| stopRange | The distance from point at which to consider it reached |

## Returns

Returns `true` on success, `false` on failure.

## Examples

```c
public OnPlayerCommandText(playerid, cmdtext[])
{
    if (!strcmp(cmdtext, "/addpatrolpos", true))
    {
        new Float:x, Float:y, Float:z;
        GetPlayerPos(playerid, x, y, z);

        // Try to add patrol point
        if (NPC_AddPointToPath(PlayerPatrolPath[playerid], x, y, z, 1.5))
        {
            SendClientMessage(playerid, 0x00FF00FF, "Added point to path %d at your current location", PlayerPatrolPath[playerid]);
        }
        else
        {
            SendClientMessage(playerid, 0xFF0000FF, "Failed add point to path");
        }
        return 1;
    }
    return 0;
}

```

## Notes

-   Points are added sequentially to form the path route
-   The `stopRange` parameter defines how close the NPC needs to get before moving to the next point
-   A smaller `stopRange` makes the NPC follow the path more precisely
-   The path must be created with `NPC_CreatePath` before adding points

## Related Functions

-   [NPC\_CreatePath](https://omp.itsneufox.com/docs/scripting/functions/NPC_CreatePath): Create a new path
-   [NPC\_RemovePointFromPath](https://omp.itsneufox.com/docs/scripting/functions/NPC_RemovePointFromPath): Remove a point from a path
-   [NPC\_GetPathPoint](https://omp.itsneufox.com/docs/scripting/functions/NPC_GetPathPoint): Get details about a specific point
-   [NPC\_MoveByPath](https://omp.itsneufox.com/docs/scripting/functions/NPC_MoveByPath): Make NPC follow a path
-   [NPC\_GetPathPointCount](https://omp.itsneufox.com/docs/scripting/functions/NPC_GetPathPointCount): Get number of points in a path

## Related Callbacks

-   [OnNPCFinishMovePathPoint](https://omp.itsneufox.com/docs/scripting/callbacks/OnNPCFinishMovePathPoint): Called when NPC reaches each path point
-   [OnNPCFinishMovePath](https://omp.itsneufox.com/docs/scripting/callbacks/OnNPCFinishMovePath): Called when NPC finishes moving along a path
-   [OnNPCFinishMove](https://omp.itsneufox.com/docs/scripting/callbacks/OnNPCFinishMove): Called when NPC finishes any movement