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

OnPlayerGiveDamageActor

هشدار

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

توضیحات​

این کالبک زمانی فراخوانده می‌شود که یک بازیکن به یک اکتور آسیب برساند.

نامتوضیحات
playeridشناسه بازیکنی که آسیب زده است.
damaged_actoridشناسه اکتوری که آسیب دیده است.
Float:amountمقدار سلامتی/زره که damaged_actorid از دست داده است.
WEAPON:weaponidدلیلی که باعث آسیب شده است.
bodypartقسمت بدن که مورد اصابت قرار گرفته

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

1 - کالبک در filterscript های دیگر فراخوانده نخواهد شد.

0 - اجازه می‌دهد این کالبک در filterscript های دیگر فراخوانده شود.

همیشه اول در filterscript ها فراخوانده می‌شود بنابراین برگرداندن 1 در آنجا سایر filterscript ها را از پردازش آن مسدود می‌کند.

مثال‌ها​

public OnPlayerGiveDamageActor(playerid, damaged_actorid, Float:amount, WEAPON:weaponid, bodypart)
{
    new string[128];
    new attackerName[MAX_PLAYER_NAME];
    new weaponName[24];

    GetPlayerName(playerid, attackerName, sizeof (attackerName));
    GetWeaponName(weaponid, weaponName, sizeof (weaponName));

    format(string, sizeof(string), "%s has made %.0f damage to actor id %d, weapon: %s", attackerName, amount, damaged_actorid, weaponName);
    SendClientMessageToAll(0xFFFFFFFF, string);
    return 1;
}

نکته‌ها​

نکته

اگر اکتور تنظیم شده به عنوان غیرقابل آسیب باشد (که به طور پیش‌فرض است) این تابع فراخوانده نمی‌شود. SetActorInvulnerable را ببینید.

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

کالبک‌های زیر ممکن است مفید باشند، زیرا به نوعی با این کالبک مرتبط هستند.

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

توابع مرتبط​

توابع زیر ممکن است مفید باشند، زیرا به نوعی با این کالبک مرتبط هستند.

منابع مرتبط​