Skip to main content

OnPlayerWeaponShot

คำอธิบาย​

This callback is called when a player fires a shot from a weapon. Only bullet weapons are supported. Only passenger drive-by is supported (not driver drive-by, and not sea sparrow / hunter shots).

NameDescription
playeridThe ID of the player that shot a weapon.
WEAPON:weaponidThe ID of the weapon shot by the player.
BULLET_HIT_TYPE:hittypeThe type of thing the shot hit (none, player, vehicle, or (player)object).
hitidThe ID of the player, vehicle or object that was hit.
Float:fXThe X coordinate that the shot hit.
Float:fYThe Y coordinate that the shot hit.
Float:fZThe Z coordinate that the shot hit.

ส่งคืน​

0 - Prevent the bullet from causing damage.

1 - Allow the bullet to cause damage.

It is always called first in filterscripts so returning 0 there also blocks other scripts from seeing it.

ตัวอย่าง​

public OnPlayerWeaponShot(playerid, WEAPON:weaponid, BULLET_HIT_TYPE:hittype, hitid, Float:fX, Float:fY, Float:fZ)
{
    new szString[144];
    format(szString, sizeof(szString), "Weapon %i fired. hittype: %i   hitid: %i   pos: %f, %f, %f", weaponid, hittype, hitid, fX, fY, fZ);
    SendClientMessage(playerid, -1, szString);
    return 1;
}

บันทึก​

tip

This callback is only called when lag compensation is enabled. If hittype is:

  • BULLET_HIT_TYPE_NONE: the fX, fY and fZ parameters are normal coordinates, will give 0.0 for coordinates if nothing was hit (e.g. far object that the bullet can't reach);
  • Others: the fX, fY and fZ are offsets relative to the hitid.
tip

GetPlayerLastShotVectors can be used in this callback for more detailed bullet vector information.

warning

Known Bug(s):

  • Isn't called if you fired in vehicle as driver or if you are looking behind with the aim enabled (shooting in air).
  • It is called as BULLET_HIT_TYPE_VEHICLE with the correct hitid (the hit player's vehicleid) if you are shooting a player which is in a vehicle. It won't be called as BULLET_HIT_TYPE_PLAYER at all.
  • Partially fixed in SA-MP 0.3.7: If fake weapon data is sent by a malicious user, other player clients may freeze or crash. To combat this, check if the reported weaponid can actually fire bullets.

ฟังก์ชั่นที่เกี่ยวข้องกัน​