OnClientPlayerWeaponFire: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 9: Line 9:
==Parameters==
==Parameters==
*The '''source''' of this event refers to the player who made a shot.
*The '''source''' of this event refers to the player who made a shot.
*'''weapon''':  a [[weapons|weapon]] [[integer]] of a weapon used.
*'''weapon''':  an [[int]] representing [[weapons|weapon]] used for making a shot.
*'''ammo''': an [[integer]] ammount of ammo left for this weapon type.
*'''ammo''': an [[int]] ammount of ammo left for this weapon type.
*'''ammoInClip''': an [[integer]] ammount of ammo left for this weapon type in clip.
*'''ammoInClip''': an [[int]] ammount of ammo left for this weapon type in clip.
*'''hitX''', '''hitY''', '''hitZ''': [[float]] world coordinates representing a hit point.
*'''hitX''', '''hitY''', '''hitZ''': [[float]] world coordinates representing a hit point.
*'''hitElement''': an [[element]] which was hit by a shot.
*'''hitElement''': an [[element]] which was hit by a shot.
Line 27: Line 27:
addEventHandler ( "onPlayerSpawn", getRootElement(), onClientPlayerWeaponFireFunc )
addEventHandler ( "onPlayerSpawn", getRootElement(), onClientPlayerWeaponFireFunc )
</syntaxhighlight>
</syntaxhighlight>
==See also==
{{Projectile functions}}

Revision as of 22:01, 6 July 2007

This event is called when player shoots a weapon.

Syntax

void onClientPlayerWeaponFire ( int weapon, int ammo, int ammoInClip, float hitX, float hitY, float hitZ, element hitElement )

Parameters

  • The source of this event refers to the player who made a shot.
  • 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.

Example

This example shows player a warning if he hits any other player with minigun.

-- trigger the event every time player shots
function onClientPlayerWeaponFireFunc(weapon, ammo, ammoInClip, hitX, hitY, hitZ, hitElement )
    if weapon == 38 and getElementType(hitElement)=="player" then -- if player shots from minigun and he hits another player...
         outputChatBox ( "Don't kill people with minigun, it's lame!", source ) -- then we output him a warning
    end
end
-- don't forget to add the onClientPlayerWeaponFireFunc function as a handler for onClientPlayerWeaponFire
addEventHandler ( "onPlayerSpawn", getRootElement(), onClientPlayerWeaponFireFunc )