Ga naar hoofdinhoud

OnNPCWeaponShot

waarschuwing

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.

NameDescription
npcidThe ID of the NPC that fired the weapon
weaponidThe weapon ID that was fired
hittypeThe type of entity that was hit (if any)
hitidThe ID of the entity that was hit (if any)
fXThe X coordinate where the bullet hit
fYThe Y coordinate where the bullet hit
fZThe Z coordinate where the bullet hit

Returns​

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

Examples​

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

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