OnPlayerWeaponShot: Difference between revisions
From Onset Developer Wiki
m Player events. |
No edit summary |
||
| Line 20: | Line 20: | ||
{{FuncParam|normalZ|Impact normal Z of the hit.}} | {{FuncParam|normalZ|Impact normal Z of the hit.}} | ||
== Example == | == Example Server == | ||
<syntaxhighlight lang="Lua"> | <syntaxhighlight lang="Lua"> | ||
function OnPlayerWeaponShot(player, weapon, hittype, hitid, hitx, hity, hitz, startx, starty, startz, normalx, normaly, normalz) | function OnPlayerWeaponShot(player, weapon, hittype, hitid, hitx, hity, hitz, startx, starty, startz, normalx, normaly, normalz) | ||
| Line 38: | Line 38: | ||
AddPlayerChat(player, "Hey you, don't shoot at NPCs!") | AddPlayerChat(player, "Hey you, don't shoot at NPCs!") | ||
end | end | ||
end | |||
AddEvent("OnPlayerWeaponShot", OnPlayerWeaponShot) | |||
</syntaxhighlight> | |||
== 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]]. | |||
<syntaxhighlight lang="Lua"> | |||
function OnPlayerWeaponShot(hittype, hitid, hitX, hitY, hitZ, startX, startY, normalX, normalY, normalZ) | |||
print(hitX, hitY, hitZ) | |||
end | end | ||
AddEvent("OnPlayerWeaponShot", OnPlayerWeaponShot) | AddEvent("OnPlayerWeaponShot", OnPlayerWeaponShot) | ||
Revision as of 14:57, 21 June 2020
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, normalX, normalY, normalZ)
Parameters
- player
The player that has shot the weapon. - player
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 short started from. - startY
The Y coordinate of where this short started from. - startY
The Z coordinate of where this short started from. - normalX
Impact normal X of the hit. - normalY
Impact normal Y of the hit. - normalZ
Impact normal Z of the hit.
Example Server
function OnPlayerWeaponShot(player, weapon, hittype, hitid, hitx, hity, hitz, startx, starty, startz, normalx, normaly, normalz)
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(hittype, hitid, hitX, hitY, hitZ, startX, startY, normalX, normalY, normalZ)
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
