OnClientVehicleDamage: Difference between revisions
Jump to navigation
Jump to search
m (→Parameters) |
|||
Line 7: | Line 7: | ||
==Parameters== | ==Parameters== | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
element theAttacker, int theWeapon, float loss, float damagePosX, float damagePosY, float damagePosZ, int | element theAttacker, int theWeapon, float loss, float damagePosX, float damagePosY, float damagePosZ, int tireID | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Line 16: | Line 16: | ||
*'''damagePosY''': A float representing the Y co-ordinate of where the damage took place. | *'''damagePosY''': A float representing the Y co-ordinate of where the damage took place. | ||
*'''damagePosZ''': A float representing the Z co-ordinate of where the damage took place. | *'''damagePosZ''': A float representing the Z co-ordinate of where the damage took place. | ||
*''' | *'''tireID''': A number representing the tire which took damage, if there is one. | ||
==Source== | ==Source== |
Revision as of 19:25, 24 March 2018
This event is triggered when a vehicle is damaged.
Parameters
element theAttacker, int theWeapon, float loss, float damagePosX, float damagePosY, float damagePosZ, int tireID
- theAttacker: An element if there was an attacker.
- theWeapon: An integer specifying the weapon ID if a weapon was used.
- loss: A float representing the amount of damage taken.
- damagePosX: A float representing the X co-ordinate of where the damage took place.
- damagePosY: A float representing the Y co-ordinate of where the damage took place.
- damagePosZ: A float representing the Z co-ordinate of where the damage took place.
- tireID: A number representing the tire which took damage, if there is one.
Source
The source of this event is the vehicle that got damaged.
Cancel effect
If this event is canceled, the vehicle health won't be reduced. Physical damage to the vehicle will remain.
Example
This example makes every SWAT tank immune from all weapon attacks.
Click to collapse [-]
Clientfunction handleVehicleDamage(attacker, weapon, loss, x, y, z, tyre) if (weapon and getElementModel(source) == 601) then -- A weapon was used and the vehicle model ID is that of the SWAT tank so cancel the damage. cancelEvent() end end addEventHandler("onClientVehicleDamage", root, handleVehicleDamage)
This example allows the Rhino to take damage from bullets even though they're bullet proof, this example doesn't work with explosions though.
Click to collapse [-]
Client-- Only let these weapons damage a Rhino local weaponsToDamageRhino = { [38] = true, -- minigun [33] = true, -- country rifle [34] = true, -- sniper rifle [30] = true, -- AK-47 [31] = true, -- M4 } function handleRhinoDamage(attacker, weapon, loss, x, y, z, tyre) if (weapon and getElementModel(source) == 432 and loss > 0) then if (weaponsToDamageRhino[weapon]) then setElementHealth(source, getElementHealth(source) - loss) end end end addEventHandler("onClientVehicleDamage", root, handleRhinoDamage)
This example will makes all vehicle Fireproof.
Click to collapse [-]
Clientfunction fireproofvehicle(theAttacker, theWeapon) if(theWeapon == 37) then cancelEvent() end end addEventHandler("onClientVehicleDamage", getRootElement(), fireproofvehicle)
See Also
Client vehicle events
- onClientTrailerAttach
- onClientTrailerDetach
- onClientVehicleCollision
- onClientVehicleDamage
- onClientVehicleEnter
- onClientVehicleExit
- onClientVehicleExplode
- onClientVehicleNitroStateChange
- onClientVehicleRespawn
- onClientVehicleStartEnter
- onClientVehicleStartExit
- onClientVehicleWeaponHit
Client event functions
- triggerLatentServerEvent
- triggerServerEvent
- Shared
- addEvent
- addEventHandler
- cancelEvent
- cancelLatentEvent
- getEventHandlers
- getLatentEventHandles
- getLatentEventStatus
- removeEventHandler
- triggerEvent
- wasEventCancelled