OnPlayerTakeDamage FR
From SA-MP Wiki
Page d'Accueil | Les Fonctions | Les Callbacks | Les bases du Scripting | Plugins de Serveur | Tutoriaux
Ne prenez pas en compte les FR dans les noms
Description:
Cette callback est appelée lorsqu'un joueur prends des degats..
| Cette callback a été ajoutée dans SA-MP 0.3d et ne fonctionnera pas sur des versions antérieures |
(playerid, issuerid, Float:amount, weaponid, bodypart)
| playerid | L'ID du joueur qui prends les dégats. |
| issuerid | L'ID du joueur qui cause les dégats. Si il vaut INVALID_PLAYER_ID, le joueur les a infligés lui même. |
| amount | Le montant des dégats reçus. (Vie et armure combinés). |
| weaponid | L'ID de l'arme/la raison qui a causé les dégats. |
| bodypart | La partie du corps qui s'est faite touchée. (NOTE: Ce paramètre a été ajouté dans la 0.3z. Enlevez le si vous utilisez une version antérieure !) |
Retourne:
- 1 - Autorise la callback à être utilisée dans un autre script
- 0 - La callback ne sera pas appelée dans les autres scripts
- Elle est toujours appelée en premier dans le gamemode donc retourner 0 dans le gamemode blockera la callback dans les filterscripts.
Exemple - Débogage
public OnPlayerTakeDamage(playerid, issuerid, Float: amount, weaponid, bodypart) { if(issuerid != INVALID_PLAYER_ID) // Si il ne se les inflige pas lui même { new infoString[128], weaponName[24], victimName[MAX_PLAYER_NAME], attackerName[MAX_PLAYER_NAME]; GetPlayerName(playerid, victimName, sizeof (victimName)); GetPlayerName(issuerid, attackerName, sizeof (attackerName)); GetWeaponName(weaponid, weaponName, sizeof (weaponName)); format(infoString, sizeof(infoString), "%s a proféré %.0f dégats à %s, arme: %s", attackerName, amount, victimName, weaponName); SendClientMessageToAll(-1, infoString); } return 1; }
Exemple - Lors d'un headshot au sniper le joueur meurt instantanément.
public OnPlayerTakeDamage(playerid, issuerid, Float: amount, weaponid, bodypart) { if(issuerid != INVALID_PLAYER_ID && weaponid == 34 && bodypart == 9) { //Tirez une fois dans la tête au sniper tue instantanément SetPlayerHealth(playerid, 0.0); } return 1; }
Callback Relatives
Les Callbacks ci dessous sont indirectement ou directement liées à cette Callback.
- OnPlayerGiveDamage: Cette callback est appelée lorsqu'un joueur profère des dégâts à un autre joueur.
- OnPlayerWeaponShot: Appelée lorsqu'un joueur fait feu avec une arme.
