پرش به مطلب اصلی

CreateActor

هشدار

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

توضیحات​

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

نامتوضیحات
skinشناسه مدل که بازیگر باید داشته باشد.
Float:xمختصات X برای ایجاد بازیگر.
Float:yمختصات Y برای ایجاد بازیگر.
Float:zمختصات Z برای ایجاد بازیگر.
Float:angleزاویه رو به جلو (چرخش) که بازیگر باید داشته باشد.

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

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

INVALID_ACTOR_ID (65535) اگر به حد مجاز بازیگر (1000) رسیده باشد.

مثال‌ها​

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.

هشدار
  • بازیگرها کاملاً از NPC ها جدا هستند. آنها از شناسه/اسلات بازیکن در سرور استفاده نمی‌کنند و نمی‌توان آنها را مانند NPC ها مدیریت کرد. بازیگرها محدود به 1000 (MAX_ACTORS) هستند.
  • بازیگرها می‌توانند توسط وسایل نقلیه هل داده شوند، از تایمر استفاده کنید تا آنها را به موقعیت خود برگردانید.
  • بازیگرها به طور پیش‌فرض آسیب‌ناپذیر هستند.

توابع مرتبط​

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

  • OnActorStreamIn: زمانی فراخوانی می‌شود که بازیگر توسط بازیکن استریم شود.
  • OnActorStreamOut: زمانی فراخوانی می‌شود که بازیگر توسط بازیکن از استریم خارج شود.
  • OnPlayerGiveDamageActor: این کالبک زمانی فراخوانی می‌شود که بازیکن به بازیگر آسیب برساند.