---
title: "SetPlayerMapIcon | open.mp"
description: "یک icon/marker روی نقشه پلیر قرار می‌ده."
canonical: https://omp.itsneufox.com/fa/docs/scripting/functions/SetPlayerMapIcon
language: fa
---

# SetPlayerMapIcon

## توضیحات

یک icon/marker روی نقشه پلیر قرار می‌ده. می‌تونه برای مشخص کردن مکان‌هایی مثل بانک و بیمارستان به پلیر ها استفاده بشه.

| نام | توضیحات |
| --- | --- |
| playerid | آیدی پلیری که قراره map icon براش تنظیم بشه |
| iconid | آیدی icon پلیر، از 0 تا 99. یعنی حداکثر 100 تا map icon می‌تونی داشته باشی. ID می‌تونه توی [RemovePlayerMapIcon](https://omp.itsneufox.com/fa/docs/scripting/functions/RemovePlayerMapIcon) استفاده بشه |
| Float:x | مختصات X برای قرار دادن map icon |
| Float:y | مختصات Y برای قرار دادن map icon |
| Float:z | مختصات Z برای قرار دادن map icon |
| markerType | [آیکونی](https://omp.itsneufox.com/fa/docs/scripting/resources/mapicons) که قراره تنظیم بشه |
| colour | رنگ آیکون، به عنوان عدد صحیح یا hex با فرمت رنگ RGBA. این باید فقط با آیکون مربعی (ID: 0) استفاده بشه |
| MAPICON:style | [سبک](https://omp.itsneufox.com/fa/docs/scripting/resources/mapiconstyles) آیکون |

## مقادیر بازگشتی

**true** - تابع با موفقیت اجرا شد.

**false** - تابع نتونست اجرا بشه. پلیر متصل نیست.

## مثال‌ها

```c
public OnPlayerConnect(playerid)
{
    // in mesal neshoon mide che juri ye dollar-icon bala ye 24/7
    // ke dar Las Venturas gharar dare besazim. be in tariigh player haye jadid
    // midunan kojam baran ba puleshunn!
    SetPlayerMapIcon(playerid, 12, 2204.9468, 1986.2877, 16.7380, 52, 0, MAPICON_LOCAL);
}
```

## نکات

یادداشت

-   اگه از marker type نامعتبری استفاده کنی، ID 1 (مربع سفید ) رو می‌سازه.
-   اگه از icon ID ای استفاده کنی که قبلاً در حال استفاده هست، map icon فعلی که از اون ID استفاده می‌کنه رو جایگزین می‌کنه.

هشدار

-   فقط می‌تونی 100 تا map icon داشته باشی. برای دور زدن این محدودیت، می‌تونی از plugin [streamer](https://github.com/samp-incognito/samp-streamer-plugin) استفاده کنی.
-   Marker type های 1 ()، 2 ()، 4 ()، و 56 () باعث کرش بازیت می‌شن اگه map legend ها فعال باشن در حین دیدن نقشه.

## توابع مرتبط

-   [RemovePlayerMapIcon](https://omp.itsneufox.com/fa/docs/scripting/functions/RemovePlayerMapIcon): یک map icon رو برای پلیر حذف می‌کنه.
-   [SetPlayerMarkerForPlayer](https://omp.itsneufox.com/fa/docs/scripting/functions/SetPlayerMarkerForPlayer): marker پلیر رو تنظیم می‌کنه.

## منابع مرتبط

-   [Map Icons](https://omp.itsneufox.com/fa/docs/scripting/resources/mapicons): لیست map icon ها.
-   [Map Icon Styles](https://omp.itsneufox.com/fa/docs/scripting/resources/mapiconstyles): لیست سبک‌های map icon.