---
title: "OnNPCWeaponShot | open.mp"
description: "This callback is called when an NPC fires a weapon."
canonical: https://omp.itsneufox.com/th/docs/scripting/callbacks/OnNPCWeaponShot
language: th
---

# OnNPCWeaponShot

warning

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

## Description

This callback is called when an NPC fires a weapon.

| Name | Description |
| --- | --- |
| npcid | The ID of the NPC that fired the weapon |
| WEAPON:weaponid | The weapon ID that was fired |
| BULLET\_HIT\_TYPE:hittype | The type of entity that was hit (if any) |
| hitid | The ID of the entity that was hit (if any) |
| Float:fX | The X coordinate where the bullet hit |
| Float:fY | The Y coordinate where the bullet hit |
| Float:fZ | The Z coordinate where the bullet hit |

## Returns

Return `false` to prevent the shot from being processed, or `true` to allow it.

## Examples

```c
public OnNPCWeaponShot(npcid, WEAPON:weaponid, BULLET_HIT_TYPE:hittype, hitid, Float:fX, Float:fY, Float:fZ)
{
    // Only notify players tracking this NPC
    for (new playerid = 0; playerid < MAX_PLAYERS; playerid++)
    {
        if (!IsPlayerConnected(playerid))
            continue;

        if (PlayerNPC[playerid] == npcid)
        {
            static hitTypeNames[5][32] = {
                "None",
                "Player",
                "Vehicle",
                "Object",
                "Player Object"
            };

            SendClientMessage(playerid, 0xFFFF00FF, "NPC %d fired weapon %d at %s %d (%.2f, %.2f, %.2f)",
                npcid, _:weaponid, hitTypeNames[_:hittype], hitid, fX, fY, fZ);
        }
    }
    return 1;
}
```

## Notes

-   This callback is called for each shot fired by the NPC
-   The `hittype` parameter indicates what was hit (none, player, vehicle, object, etc.)
-   The `hitid` parameter contains the ID of the hit entity (player ID, vehicle ID, etc.)
-   Hit coordinates show where the bullet impacted
-   Returning `false` prevents the shot from being processed by the server

## Related Functions

The following functions might be useful, as they're related to this callback in one way or another.

-   [NPC\_AimAt](https://omp.itsneufox.com/th/docs/scripting/functions/NPC_AimAt): Make NPC aim at a position
-   [NPC\_AimAtPlayer](https://omp.itsneufox.com/th/docs/scripting/functions/NPC_AimAtPlayer): Make NPC aim at a player
-   [NPC\_StopAim](https://omp.itsneufox.com/th/docs/scripting/functions/NPC_StopAim): Stop NPC from aiming
-   [NPC\_SetWeapon](https://omp.itsneufox.com/th/docs/scripting/functions/NPC_SetWeapon): Set NPC's weapon
-   [NPC\_GetAmmo](https://omp.itsneufox.com/th/docs/scripting/functions/NPC_GetAmmo): Get NPC's ammo count

## Related Callbacks

-   [OnNPCGiveDamage](https://omp.itsneufox.com/th/docs/scripting/callbacks/OnNPCGiveDamage): Called when NPC gives damage to a player
-   [OnPlayerWeaponShot](https://omp.itsneufox.com/th/docs/scripting/callbacks/OnPlayerWeaponShot): Called when a player fires a weapon