OnPlayerGiveDamageActor

From SA-MP Wiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 18:06, 31 December 2016
OstGot (Talk | contribs)

← Previous diff
Current revision
OstGot (Talk | contribs)

Line 13: Line 13:
{{Param|bodypart|The [[Body_Parts|body part]] that was hit}} {{Param|bodypart|The [[Body_Parts|body part]] that was hit}}
-{{NoReturnCallback}}+{{Returns|
 +* '''1''' - Callback will not be called in other filterscripts.
 +* '''0''' - Allows this callback to be called in other filterscripts.
 +* It is always called first in filterscripts so returning 1 there blocks other filterscripts from seeing it.}}
{{Note|This function does not get called if the actor is set invulnerable (WHICH IS BY DEFAULT). See [[SetActorInvulnerable]].}} {{Note|This function does not get called if the actor is set invulnerable (WHICH IS BY DEFAULT). See [[SetActorInvulnerable]].}}
 +{{Example}}
<pawn> <pawn>
public OnPlayerGiveDamageActor(playerid, damaged_actorid, Float: amount, weaponid, bodypart) public OnPlayerGiveDamageActor(playerid, damaged_actorid, Float: amount, weaponid, bodypart)

Current revision


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


Description:

This callback is called when a player gives damage to an actor.



Parameters:
(playerid, damaged_actorid, Float:amount, weaponid, bodypart)
playeridThe ID of the player that gave damage.
damaged_actoridThe ID of the actor that received damage.
amountThe amount of health/armour damaged_actorid has lost.
weaponidThe reason that caused the damage.
bodypartThe body part that was hit


Return Values:

  • 1 - Callback will not be called in other filterscripts.
  • 0 - Allows this callback to be called in other filterscripts.
  • It is always called first in filterscripts so returning 1 there blocks other filterscripts from seeing it.


Image:32px-Ambox_warning_orange.png

Note

This function does not get called if the actor is set invulnerable (WHICH IS BY DEFAULT). See SetActorInvulnerable.


Example Usage:

public OnPlayerGiveDamageActor(playerid, damaged_actorid, Float: amount, 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 has made %.0f damage to actor id %d, weapon: %s", attacker, amount, damaged_actorid, weaponname);
    SendClientMessageToAll(0xFFFFFFFF, string);
    return 1;
}

Related Functions

The following functions may be useful, as they are related to this function in one way or another.


Related Callbacks

The following callbacks might be useful as well, as they are related to this callback in one way or another.

Personal tools
In other languages