From SA-MP Wiki

Jump to: navigation, search

GetPlayerTargetActor was added in SA-MP 0.3.7 This function was added in SA-MP 0.3.7 and will not work in earlier versions!


Gets id of an actor which is aimed by certain player.

playeridThe ID of the player to get the target of.

Return Values:

The ID of the targeted actor, or INVALID_ACTOR_ID if none.



  • Does not work for joypads/controllers, and after a certain distance.
  • Does not work for the sniper rifle, as it doesn't lock on to anything and as such can't and won't return a player.

Example Usage:

public OnPlayerUpdate(playerid)
    new actorid = GetPlayerTargetActor(playerid);
    new string[32];
    format(string, sizeof(string), "You are aiming at actor id %d", actorid);
    SendClientMessage(playerid, -1, string);
    return 1;

Related Functions

The following functions may be helpful as they relate to this function in one way or another.

Related Callbacks

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

In other languages