GetPlayerWeapon
From SA-MP Wiki
Description:
Returns the ID of the weapon a player is currently holding.
(playerid)
| playerid | The ID of the player to get the currently held weapon of. |
Return Values:
The ID of the player's current weapon. Returns -1 if the player specified does not exist.
Example Usage:
public OnPlayerDeath(playerid, killerid, reason) { if(killerid != INVALID_PLAYER_ID) { if(GetPlayerWeapon(killerid) == 38) Ban(killerid); //Ban if they have a minigun } return 1; }
 Important | 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. |
Note | 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. |
Related Functions
The following functions may be useful, as they are related to this function in one way or another.
- GetPlayerWeaponData: Find out information about weapons a player has.
- GivePlayerWeapon: Give a player a weapon.
- ResetPlayerWeapons: Remove all weapons from a player.
