---
title: "SetPlayerMapIcon | open.mp"
description: "Place an icon/marker on a player's map."
canonical: https://omp.itsneufox.com/docs/scripting/functions/SetPlayerMapIcon
language: en
---

# 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](https://omp.itsneufox.com/docs/scripting/functions/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](https://omp.itsneufox.com/docs/scripting/resources/mapicons) 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](https://omp.itsneufox.com/docs/scripting/resources/mapiconstyles) of icon. |

## Returns

**true** - The function executed successfully.

**false** - The function failed to execute. Player is not connected.

## Examples

```c
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

note

-   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](https://github.com/samp-incognito/samp-streamer-plugin) 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](https://omp.itsneufox.com/docs/scripting/functions/RemovePlayerMapIcon): Remove a map icon for a player.
-   [SetPlayerMarkerForPlayer](https://omp.itsneufox.com/docs/scripting/functions/SetPlayerMarkerForPlayer): Set a player's marker.

## Related Resources

-   [Map Icons](https://omp.itsneufox.com/docs/scripting/resources/mapicons): A list of map icons.
-   [Map Icon Styles](https://omp.itsneufox.com/docs/scripting/resources/mapiconstyles): A list of map icon styles.