---
title: "OnPlayerGiveDamageActor | open.mp"
description: "Esta callback é chamada quando o jogador causa dano a um ator."
canonical: https://omp.itsneufox.com/pt-BR/docs/scripting/callbacks/OnPlayerGiveDamageActor
language: pt-BR
---

# OnPlayerGiveDamageActor

aviso

Esta callback foi adicionada no SA-MP 0.3.7 e não funcionará em versões anteriores!

## Descrição

Esta callback é chamada quando o jogador causa dano a um ator.

| Nome | Descrição |
| --- | --- |
| playerid | ID do jogador que realizou o dano. |
| damaged\_actorid | ID do ator que recebeu o dano. |
| Float:amount | A quantidade de vida/colete que o damaged\_actorid perdeu. |
| WEAPON:weaponid | O motivo que causou o dano. |
| bodypart | A parte do corpo que foi acertada |

## Retorno

1 - Callback não será chamada em outros fillterscripts.

0 - Permite que essa callback seja chamada em outros filterscripts.

É sempre chamada primeiro em filterscripts então ao retornar 1 bloqueia outros filterscripts de vê-la.

## Exemplos

```c
public OnPlayerGiveDamageActor(playerid, damaged_actorid, Float:amount, WEAPON:weaponid, bodypart)
{
    new string[128], attacker[MAX_PLAYER_NAME];
    new weaponname[24];
    GetPlayerName(playerid, attacker, sizeof (attacker));
    GetWeaponName(weaponid, weaponname, sizeof (weaponname));

    format(string, sizeof(string), "%s realizou %.0f de dano no ator de id %d, arma: %s", attacker, amount, damaged_actorid, weaponname);
    SendClientMessageToAll(0xFFFFFFFF, string);
    return 1;
}
```

## Notas

nota

Esta função não é chamada se o ator é posto como vulnerável (QUE É O PADRÃO). Veja a função [SetActorInvulnerable](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/SetActorInvulnerable).

## Funções relacionadas

-   [CreateActor](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/CreateActor): Cria um ator (NPC estático).
-   [SetActorInvulnerable](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/SetActorInvulnerable): Coloca o actor como invulnerável.
-   [SetActorHealth](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/SetActorHealth): Informa a vida de um ator.
-   [GetActorHealth](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetActorHealth): Obtém a vida de um ator.
-   [IsActorInvulnerable](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/IsActorInvulnerable): Verifica se um ator é invulnerável.
-   [IsValidActor](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/IsValidActor): Verifica se o ID de um ator é válido.

## Callbacks relacionadas

-   [OnActorStreamOut](https://omp.itsneufox.com/pt-BR/docs/scripting/callbacks/OnActorStreamOut): Chamada quando um ator é removido da área visível por um jogador.
-   [OnPlayerStreamIn](https://omp.itsneufox.com/pt-BR/docs/scripting/callbacks/OnPlayerStreamIn): Chamada quando um jogador aparece na área visível de outro jogador.

## Recursos relacionados

-   [Partes do Corpo](https://omp.itsneufox.com/pt-BR/docs/scripting/resources/bodyparts)