note Help Needed
This wiki is the result of an ongoing community effort — thank you all for helping!
If you want to provide changes to this page then please click here.
SetPlayerMapIcon
Description
Place an icon/marker on a player's map. Can be used to mark locations such as banks and hospitals to players.
| Name | Description |
|---|---|
| playerid | The ID of the player to set the map icon for. |
| 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. |
| markerType | The icon to set. |
| colour | 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). |
| MAPICON:style | The style of icon. |
Returns
true - The function executed successfully.
false - The function failed to execute. Player is not connected.
Examples
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);
}
Notes
tip
- 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.
warning
- You can only have 100 map icons. To circumvent this limit, you can use the streamer plugin.
- Marker type 1 (), 2 (
), 4 (
), and 56 (
) will cause your game to crash if you have map legends enabled while viewing the map.
Related Functions
- RemovePlayerMapIcon: Remove a map icon for a player.
- SetPlayerMarkerForPlayer: Set a player's marker.
Related Resources
- Map Icons: A list of map icons.
- Map Icon Styles: A list of map icon styles.