OnPlayerWeaponShot

Description

Called when a player has shot their weapon and the hit was authorized by the server but not yet processed its impact. You can call return false in this event to prevent this hit from further processing. (Server only)

Syntax

OnPlayerWeaponShot(player, weapon, hittype, hitid, hitX, hitY, hitZ, startX, startY, startZ, normalX, normalY, normalZ, BoneName)

Parameters

• player
  The player that has shot the weapon.
• weapon
  Weapon model id.
• hittype
  The type of entity which was hit.
• hitid
  The identifier of the entity which was hit.
• hitX
  The X coordinate of this hit.
• hitY
  The Y coordinate of this hit.
• hitZ
  The Z coordinate of this hit.
• startX
  The X coordinate of where this shot started from.
• startY
  The Y coordinate of where this shot started from.
• startZ
  The Z coordinate of where this shot started from.
• normalX
  Impact normal X of the hit.
• normalY
  Impact normal Y of the hit.
• normalZ
  Impact normal Z of the hit.
• BoneName
  Bone name of this hit. (For players)

Example Server

function OnPlayerWeaponShot(player, weapon, hittype, hitid, hitx, hity, hitz, startx, starty, startz, normalx, normaly, normalz, BoneName)
	local action = {
		"in the air",
		"at player",
		"at vehicle",
		"an NPC",
		"at object",
		"on ground",
		"in water"
	}
	
	print(GetPlayerName(player).."("..player..") shot "..action[hittype].." (ID "..hitid..") using weapon ("..weapon..")")
	
	if (hittype == HIT_NPC) then
		AddPlayerChat(player, "Hey you, don't shoot at NPCs!")
	end
end
AddEvent("OnPlayerWeaponShot", OnPlayerWeaponShot)

Example Client

The parameters on the client are slightly different. If you want to detect weapon shots on the client for other players you can use OnPlayWeaponHitEffects.

function OnPlayerWeaponShot(weaponid, hittype, hitid, hitX, hitY, hitZ, startX, startY, startZ, normalX, normalY, normalZ, BoneName)
    print(hitX, hitY, hitZ)
end
AddEvent("OnPlayerWeaponShot", OnPlayerWeaponShot)

See also

• OnPlayerServerAuth
• OnPlayerSteamAuth
• OnPlayerStreamIn
• OnPlayerStreamOut
• OnPlayerJoin
• OnPlayerQuit
• OnPlayerSpawn
• OnPlayerDeath
• OnPlayerWeaponShot
• OnPlayerDamage
• OnPlayerChat
• OnPlayerChatCommand
• OnPlayerInteractDoor
• OnPlayWeaponHitEffects
• OnPlayerSwitchCamera
• OnPlayerEnterWater
• OnPlayerLeaveWater
• OnPlayerCrouch
• OnPlayerEndCrouch
• OnPlayerEndFall
• OnPlayerFall
• OnPlayerTalking