From Multi Theft Auto: Wiki
Revision as of 20:42, 5 April 2020 by Motar2k (talk | contribs) (→‎Example)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

This event is called when a vehicle weapon hits an element or the world.

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


 int weaponType, element hitElement, float hitX, float hitY, float hitZ, int model, int materialID
  • weaponType: The type of vehicle weapon. (See the list below)
  • hitElement: The vehicle, ped or player that was hit by the weapon sometimes false.
  • hitX: The X world co-ordinate of where the hit occured.
  • hitY: The Y world co-ordinate of where the hit occured.
  • hitZ: The Z world co-ordinate of where the hit occured.
  • model: The model ID of the element that was hit.
  • materialID: The material ID of the element that was hit.

Weapon types

  • 0: Invalid
  • 1: Water Canon
  • 2: Tank Gun - Not yet implemented.
  • 3: Rocket - Not yet implemented.
  • 4: Heat Seeking Rocket - Not yet implemented.


The source of this event is the vehicle that fired the weapon.


Minimum supported server n/a
Minimum supported client

Note: Using this function/event requires the resource to have the above minimum version declared in the meta.xml <min_mta_version> section. e.g. <min_mta_version client="" />


Click to collapse [-]
addEventHandler("onClientVehicleWeaponHit", root,
     function(weaponType, hitElement, hitX, hitY, hitZ, model, materialID)
          outputChatBox(tostring(weaponType).." "..tostring(hitElement).." "..tostring(hitX).." "..tostring(hitY).." "..tostring(hitZ).." "..tostring(model).." "..tostring(materialID))

See Also

Client vehicle events

Client event functions