OnClientPedWeaponFire: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Added a Compatability notice.)
No edit summary
 
(9 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Client event}}
{{Client event}}
__NOTOC__  
__NOTOC__  
'''NOTE In 1.0 revision 854 this event is being Temporarily replaced by the upgrader to onClientPlayerWeaponFire for compatability purposes (This event will no longer fire for players), Therefore it is advised you run the upgrader before we remove this Temporary Compatability measure.'''
This event is called when ped shoots a weapon.  This does not trigger for projectiles based, or melee weapons.
 
{{Note|This event is only triggered for peds that are streamed in}}
This event is called when ped shoots a weapon.  This does not trigger for projectiles based, or melee weapons. Also note that this event is only triggered for peds nearby the local player's camera. This is due to elements far away being streamed out.
 
==Parameters==
==Parameters==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
int weapon, int ammo, int ammoInClip, float hitX, float hitY, float hitZ, element hitElement
int weapon, int ammo, int ammoInClip, float hitX, float hitY, float hitZ, element hitElement
</syntaxhighlight>  
</syntaxhighlight>  
*'''weapon''':  an [[int]] representing [[weapons|weapon]] used for making a shot.
*'''weapon''':  an [[int]] representing [[weapons|weapon]] used for making a shot.
Line 18: Line 16:
The [[event system#Event source|source]] of this event is the [[ped]] who fired the weapon.
The [[event system#Event source|source]] of this event is the [[ped]] who fired the weapon.


==Example==  
==Example==
 
<syntaxhighlight lang="lua">
addEventHandler("onClientPedWeaponFire", root,
    function(weapon, ammo, ammoInClip, hitX, hitY, hitZ, hitElement)
          if isElement(hitElement) and getElementType(hitElement) == "player" then
              outputChatBox("You hit " .. getPlayerName(hitElement), 0, 255, 0)
          end
    end
)
</syntaxhighlight>


==See Also==
==See Also==

Latest revision as of 03:12, 30 September 2019

This event is called when ped shoots a weapon. This does not trigger for projectiles based, or melee weapons.

[[{{{image}}}|link=|]] Note: This event is only triggered for peds that are streamed in

Parameters

 int weapon, int ammo, int ammoInClip, float hitX, float hitY, float hitZ, element hitElement
  • weapon: an int representing weapon used for making a shot.
  • ammo: an int ammount of ammo left for this weapon type.
  • ammoInClip: an int ammount of ammo left for this weapon type in clip.
  • hitX, hitY, hitZ: float world coordinates representing a hit point.
  • hitElement: an element which was hit by a shot.

Source

The source of this event is the ped who fired the weapon.

Example

addEventHandler("onClientPedWeaponFire", root,
     function(weapon, ammo, ammoInClip, hitX, hitY, hitZ, hitElement)
          if isElement(hitElement) and getElementType(hitElement) == "player" then
               outputChatBox("You hit " .. getPlayerName(hitElement), 0, 255, 0)
          end
     end
)

See Also

Client ped events


Client event functions