OnPlayerClickMap

warning

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).

NameDescription
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)

Returns

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.

Examples

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

Notes

tip

As the callback name says, its only called when the player click to mark the target and not when pressed the key. The Z value returned will be 0 (invalid) if the clicked area on the map is far away from the player; use the MapAndreas or ColAndreas plugin to get a more accurate Z coordinate.

Related Functions