Skip to main content

GetPlayerWeapon

คำอธิบาย​

Returns the ID of the weapon a player is currently holding.

NameDescription
playeridThe ID of the player to get the currently held weapon of.

ส่งคืน​

The ID of the player's current weapon. Returns -1 if the player specified does not exist.

ตัวอย่าง​

public OnPlayerDeath(playerid, killerid, WEAPON:reason)
{
    // Check if the killerid is not an invalid player (which means is connected).
    if (killerid != INVALID_PLAYER_ID)
    {
        // The WEAPON_MINIGUN constant is pre-defined in the standard library and is equal to 38.
        if (GetPlayerWeapon(killerid) == WEAPON_MINIGUN)
        {
            //Ban if they have a minigun
            Ban(killerid);
        }
    }
    return 1;
}

บันทึก​

tip

When the player state is PLAYER_STATE_DRIVER or PLAYER_STATE_PASSENGER this function returns the weapon held by the player before they entered the vehicle. If a cheat is used to spawn a weapon inside a vehicle, this function will not report it.

warning

Sometimes the result can be -1 which is an invalid weapon ID. Circumstances of this are not yet known, but it is best to discard information when returned weapon is -1.

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

  • GetPlayerWeaponData: Find out information about weapons a player has.
  • GivePlayerWeapon: Give a player a weapon.
  • ResetPlayerWeapons: Remove all weapons from a player.