SetPlayerMapIcon

SetPlayerMapIcon

Description:

Function SetPlayerMapIcon place an icon/marker on a player's map. Can be used to mark locations such as banks and hospitals to players.

If you use an invalid marker type, it will create ID 1 (White Square). If you use an icon ID that is already in use, it will replace the current map icon using that ID.

You can only have 100 map icons! Marker type 1 , 2, 4 and 56 will cause your game to crash if you have map legends enabled while viewing the map.

Parameters:

(playerid, iconid, Float:x, Float:y, Float:z, markertype, color, style)

int

playerid

The ID of the player to set the map icon for.

int

iconid

The player's icon ID, ranging from 0 to 99. This means there is a maximum of 100 map icons. ID can be used in RemovePlayerMapIcon.

float

X

The X coordinate to place the map icon at.

float

Y

The Y coordinate to place the map icon at.

float

Z

The Z coordinate to place the map icon at.

int

markertype

The icon to set.

int

color

The color of the icon, as an integer or hex in RGBA color format. This should only be used with the square icon (ID: 0).

int

style

The style of icon.

Return Values:

• 1: The function was executed successfully.
• 0: The function failed to execute. Player is not connected.

Examples:

Example 1

public OnPlayerConnect( playerid )
{
    // This example demonstrates how to create a dollar-icon on top of a 24/7 located
    // in Las Venturas. This way new players know where to go with their money!
    SetPlayerMapIcon(playerid, 12, 2204.9468, 1986.2877, 16.7380, 52, 0, MAPICON_LOCAL);
}

Related Functions

The following functions may be useful, as they are related to this function in one way or another.

• RemovePlayerMapIcon: Remove a map icon for a player.
• SetPlayerMarkerForPlayer: Set a player's marker.