OnPlayerClickMap

From SA-MP Wiki

Jump to: navigation, search


OnPlayerClickMap was added in SA-MP 0.3d This callback was added in SA-MP 0.3d and will not work in earlier versions!


Description:

OnPlayerClickMap is called when a player places a target/waypoint on the pause menu map (by right-clicking).


Parameters:
(playerid, Float:fX, Float:fY, Float:fZ)
playeridThe ID of the player that placed a target/waypoint
Float:fXThe X float coordinate where the player clicked
Float:fYThe Y float coordinate where the player clicked
Float:fZThe Z float coordinate where the player clicked (inaccurate - see note below)


Return Values:

  • 1 - Will prevent other filterscripts from receiving this callback.
  • 0 - Indicates that this callback will be passed to the next filterscript.
  • It is always called first in gamemode.


Image:32px-Ambox_warning_orange.png

Note

The Z value returned will be 0 (invalid) if it is far away from the player; use the MapAndreas plugin to get a more accurate Z coordinate.


Example Usage:

public OnPlayerClickMap(playerid, Float:fX, Float:fY, Float:fZ)
{
    SetPlayerPosFindZ(playerid, fX, fY, fZ); 
    return 1;
}

Related Callbacks

The following callbacks might be useful as well, as they are related to this callback in one way or another.

Personal tools