---
title: "OnPlayerGiveDamageActor | open.mp"
description: "این کالبک زمانی فراخوانده می‌شود که یک بازیکن به یک اکتور آسیب برساند."
canonical: https://omp.itsneufox.com/fa/docs/scripting/callbacks/OnPlayerGiveDamageActor
language: fa
---

# 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 | [قسمت بدن](https://omp.itsneufox.com/fa/docs/scripting/resources/bodyparts) که مورد اصابت قرار گرفته |

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

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

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

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

## مثال‌ها

```c
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](https://omp.itsneufox.com/fa/docs/scripting/functions/SetActorInvulnerable) را ببینید.

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

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

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

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

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

-   [CreateActor](https://omp.itsneufox.com/fa/docs/scripting/functions/CreateActor): ایجاد یک اکتور (NPC ثابت).
-   [SetActorInvulnerable](https://omp.itsneufox.com/fa/docs/scripting/functions/SetActorInvulnerable): تنظیم اکتور به عنوان غیرقابل آسیب.
-   [SetActorHealth](https://omp.itsneufox.com/fa/docs/scripting/functions/SetActorHealth): تنظیم سلامتی اکتور.
-   [GetActorHealth](https://omp.itsneufox.com/fa/docs/scripting/functions/GetActorHealth): دریافت سلامتی اکتور.
-   [IsActorInvulnerable](https://omp.itsneufox.com/fa/docs/scripting/functions/IsActorInvulnerable): بررسی اینکه آیا اکتور غیرقابل آسیب است یا نه.
-   [IsValidActor](https://omp.itsneufox.com/fa/docs/scripting/functions/IsValidActor): بررسی اینکه آیا شناسه اکتور معتبر است یا نه.

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

-   [Body Parts](https://omp.itsneufox.com/fa/docs/scripting/resources/bodyparts)