OnPlayerWasted: Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
|||
Line 14: | Line 14: | ||
*'''totalAmmo''': an integer representing the total ammo the victim had when he died. | *'''totalAmmo''': an integer representing the total ammo the victim had when he died. | ||
*'''killer''': an [[element]] representing the player or vehicle who was the killer. If there was no killer this is ''false''. | *'''killer''': an [[element]] representing the player or vehicle who was the killer. If there was no killer this is ''false''. | ||
*'''killerWeapon''': an integer representing the [[Weapons|killer weapon]] or the [[ | *'''killerWeapon''': an integer representing the [[Weapons|killer weapon]] or the [[Damage Types|damage type]]. | ||
*'''bodypart''': an integer representing the bodypart ID the victim was hit on when he died. | *'''bodypart''': an integer representing the bodypart ID the victim was hit on when he died. | ||
{{BodyParts}} | {{BodyParts}} |
Revision as of 15:14, 17 January 2017
This event is triggered when a player is killed or dies.
Parameters
int totalAmmo, element killer, int killerWeapon, int bodypart, bool stealth
- totalAmmo: an integer representing the total ammo the victim had when he died.
- killer: an element representing the player or vehicle who was the killer. If there was no killer this is false.
- killerWeapon: an integer representing the killer weapon or the damage type.
- bodypart: an integer representing the bodypart ID the victim was hit on when he died.
- 3: Torso
- 4: Ass
- 5: Left Arm
- 6: Right Arm
- 7: Left Leg
- 8: Right Leg
- 9: Head
- stealth: boolean value representing whether or not this was a stealth kill
Source
The source of this event is the player that died or got killed.
Example
This example prints the killer and bodypart to the chat when a player dies.
-- register player_Wasted as a handler for onPlayerWasted function player_Wasted ( ammo, attacker, weapon, bodypart ) -- if there was an attacker if ( attacker ) then -- we declare our variable outside the following checks local tempString -- if the element that killed him was a player, if ( getElementType ( attacker ) == "player" ) then -- put the attacker, victim and weapon info in the string tempString = getPlayerName ( attacker ).." killed "..getPlayerName ( source ).." ("..getWeaponNameFromID ( weapon )..")" -- else, if it was a vehicle, elseif ( getElementType ( attacker ) == "vehicle" ) then -- we'll get the name from the attacker vehicle's driver tempString = getPlayerName ( getVehicleController ( attacker ) ).." killed "..getPlayerName ( source ).." ("..getWeaponNameFromID ( weapon )..")" end -- if the victim was shot in the head, append a special message if ( bodypart == 9 ) then tempString = tempString.." (HEADSHOT!)" -- else, just append the bodypart name else tempString = tempString.." ("..getBodyPartName ( bodypart )..")" end -- display the message outputChatBox ( tempString ) -- if there was no attacker, else -- output a death message without attacker info outputChatBox ( getPlayerName ( source ).." died. ("..getWeaponNameFromID ( weapon )..") ("..getBodyPartName ( bodypart )..")" ) end end addEventHandler ( "onPlayerWasted", getRootElement(), player_Wasted )
And another example, this will spawn you in the middle of GTA SA world (x=0, y=0, z=3) after 2 seconds of your death
addEventHandler( "onPlayerWasted", getRootElement( ), function() setTimer( spawnPlayer, 2000, 1, source, 0, 0, 3 ) end )
Click to collapse [-]
Example 1This Example is a script for Tactics Servers , the script giving the killer health as a reward for killing.
function GiveHealth(ammo, killer, killerweapon, bodypart) if ( killer ) and ( killer ~= source ) and ( (getElementHealth(killer)) ~= 100 ) --Here we have selcted that who will be gave a health is the killer setElementHealth(killer, (getElementHealth(killer)) + 20) --He will get +20 health, if you want to reward him by sitting him health 100 you can just type 100 after (killer, outputChatBox("#ff0000[ Server ] : #ffff00You Have Got Health +20",killer,255,0,0,true) --out put chat box for the killer end --End if end --End function addEventHandler("onPlayerWasted", getRootElement(), GiveHealth)
See Also
Player events
- onPlayerACInfo
- onPlayerBan
- onPlayerChangeNick
- onPlayerChat
- onPlayerClick
- onPlayerCommand
- onPlayerConnect
- onPlayerContact
- onPlayerDamage
- onPlayerJoin
- onPlayerLogin
- onPlayerLogout
- onPlayerMarkerHit
- onPlayerMarkerLeave
- onPlayerModInfo
- onPlayerMute
- onPlayerNetworkStatus
- onPlayerPickupHit
- onPlayerPickupLeave
- onPlayerPickupUse
- onPlayerPrivateMessage
- onPlayerQuit
- onPlayerScreenShot
- onPlayerSpawn
- onPlayerStealthKill
- onPlayerTarget
- onPlayerUnmute
- onPlayerVehicleEnter
- onPlayerVehicleExit
- onPlayerVoiceStart
- onPlayerVoiceStop
- onPlayerWasted
- onPlayerWeaponFire
- onPlayerWeaponSwitch
Event functions
- addEvent
- addEventHandler
- cancelEvent
- cancelLatentEvent
- getEventHandlers
- getLatentEventHandles
- getLatentEventStatus
- removeEventHandler
- triggerEvent
- wasEventCancelled