---
title: "CreateActor | open.mp"
description: "ایجاد یک 'بازیگر' ایستا در جهان."
canonical: https://omp.itsneufox.com/fa/docs/scripting/functions/CreateActor
language: fa
---

# CreateActor

هشدار

This function was added in SA-MP 0.3.7 and will not work in earlier versions!

## توضیحات

ایجاد یک 'بازیگر' ایستا در جهان. این 'بازیگرها' مانند NPC هستند، اما عملکرد محدودی دارند. آنها اسلات بازیکن سرور را اشغال نمی‌کنند.

| نام | توضیحات |
| --- | --- |
| skin | [شناسه مدل](https://omp.itsneufox.com/fa/docs/scripting/resources/skins) که بازیگر باید داشته باشد. |
| Float:x | مختصات X برای ایجاد بازیگر. |
| Float:y | مختصات Y برای ایجاد بازیگر. |
| Float:z | مختصات Z برای ایجاد بازیگر. |
| Float:angle | زاویه رو به جلو (چرخش) که بازیگر باید داشته باشد. |

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

شناسه بازیگر ایجادشده (شروع از 0).

INVALID\_ACTOR\_ID (65535) اگر به حد مجاز بازیگر (1000) رسیده باشد.

## مثال‌ها

```c
new gActorCJ;

public OnGameModeInit()
{
    // ایجاد بازیگر (CJ) در Blueberry Acres (مرکز نقشه SA)
    gActorCJ = CreateActor(0, 0.0, 0.0, 3.0, 0.0);
}

public OnGameModeExit()
{
    // نابود کردن بازیگر دوست‌داشتنی ما (CJ)
    DestroyActor(gActorCJ);
}
```

## نکات

یادداشت

-   بازیگرها برای ایستادن در جایی طراحی شده‌اند، مثلاً صندوقداران و بارمن‌ها. آنها می‌توانند انیمیشن اجرا کنند (یک بار یا حلقه‌ای) با استفاده از [ApplyActorAnimation](https://omp.itsneufox.com/fa/docs/scripting/functions/ApplyActorAnimation).
-   بازیگرها به طور پیش‌فرض آسیب‌ناپذیر هستند.

هشدار

-   بازیگرها کاملاً از NPC ها جدا هستند. آنها از شناسه/اسلات بازیکن در سرور استفاده نمی‌کنند و نمی‌توان آنها را مانند NPC ها مدیریت کرد. بازیگرها محدود به 1000 (MAX\_ACTORS) هستند.
-   بازیگرها می‌توانند توسط وسایل نقلیه هل داده شوند، از تایمر استفاده کنید تا آنها را به موقعیت خود برگردانید.

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

-   [DestroyActor](https://omp.itsneufox.com/fa/docs/scripting/functions/DestroyActor): نابود کردن یک بازیگر.
-   [SetActorPos](https://omp.itsneufox.com/fa/docs/scripting/functions/SetActorPos): تنظیم موقعیت یک بازیگر.
-   [GetActorPos](https://omp.itsneufox.com/fa/docs/scripting/functions/GetActorPos): دریافت موقعیت یک بازیگر.
-   [GetActorSpawnInfo](https://omp.itsneufox.com/fa/docs/scripting/functions/GetActorSpawnInfo): دریافت نقطه اسپاون اولیه بازیگر.
-   [SetActorFacingAngle](https://omp.itsneufox.com/fa/docs/scripting/functions/SetActorFacingAngle): تنظیم زاویه رو به جلو بازیگر.
-   [GetActorFacingAngle](https://omp.itsneufox.com/fa/docs/scripting/functions/GetActorFacingAngle): دریافت زاویه رو به جلو بازیگر.
-   [SetActorVirtualWorld](https://omp.itsneufox.com/fa/docs/scripting/functions/SetActorVirtualWorld): تنظیم جهان مجازی بازیگر.
-   [GetActorVirtualWorld](https://omp.itsneufox.com/fa/docs/scripting/functions/GetActorVirtualWorld): دریافت جهان مجازی بازیگر.
-   [ApplyActorAnimation](https://omp.itsneufox.com/fa/docs/scripting/functions/ApplyActorAnimation): اعمال انیمیشن به بازیگر.
-   [ClearActorAnimations](https://omp.itsneufox.com/fa/docs/scripting/functions/ClearActorAnimations): پاک کردن انیمیشن‌های اعمال شده به بازیگر.
-   [GetActorAnimation](https://omp.itsneufox.com/fa/docs/scripting/functions/GetActorAnimation): دریافت انیمیشنی که بازیگر در حال انجام است.
-   [GetPlayerCameraTargetActor](https://omp.itsneufox.com/fa/docs/scripting/functions/GetPlayerCameraTargetActor): دریافت شناسه بازیگری که بازیکن به آن نگاه می‌کند.
-   [IsActorStreamedIn](https://omp.itsneufox.com/fa/docs/scripting/functions/IsActorStreamedIn): بررسی اینکه آیا بازیگر برای بازیکن استریم شده است.
-   [SetActorSkin](https://omp.itsneufox.com/fa/docs/scripting/functions/SetActorSkin): تنظیم اسکین بازیگر.
-   [GetActorSkin](https://omp.itsneufox.com/fa/docs/scripting/functions/GetActorSkin): دریافت اسکین بازیگر.
-   [SetActorHealth](https://omp.itsneufox.com/fa/docs/scripting/functions/SetActorHealth): تنظیم سلامتی بازیگر.
-   [GetActorHealth](https://omp.itsneufox.com/fa/docs/scripting/functions/GetActorHealth): دریافت سلامتی بازیگر.
-   [SetActorInvulnerable](https://omp.itsneufox.com/fa/docs/scripting/functions/SetActorInvulnerable): تنظیم آسیب‌ناپذیری بازیگر.
-   [IsActorInvulnerable](https://omp.itsneufox.com/fa/docs/scripting/functions/IsActorInvulnerable): بررسی آسیب‌ناپذیری بازیگر.
-   [IsValidActor](https://omp.itsneufox.com/fa/docs/scripting/functions/IsValidActor): بررسی اعتبار شناسه بازیگر.
-   [GetActorPoolSize](https://omp.itsneufox.com/fa/docs/scripting/functions/GetActorPoolSize): دریافت بالاترین شناسه بازیگر ایجادشده در سرور.
-   [GetPlayerTargetActor](https://omp.itsneufox.com/fa/docs/scripting/functions/GetPlayerTargetActor): دریافت شناسه بازیگری که بازیکن مشخصی به آن هدف گرفته.

## کالبک‌های مرتبط

-   [OnActorStreamIn](https://omp.itsneufox.com/fa/docs/scripting/callbacks/OnActorStreamIn): زمانی فراخوانی می‌شود که بازیگر توسط بازیکن استریم شود.
-   [OnActorStreamOut](https://omp.itsneufox.com/fa/docs/scripting/callbacks/OnActorStreamOut): زمانی فراخوانی می‌شود که بازیگر توسط بازیکن از استریم خارج شود.
-   [OnPlayerGiveDamageActor](https://omp.itsneufox.com/fa/docs/scripting/callbacks/OnPlayerGiveDamageActor): این کالبک زمانی فراخوانی می‌شود که بازیکن به بازیگر آسیب برساند.