OnClientVehicleCollision - Revision history

Fernando187: params

2025-06-01T15:31:17Z

params

← Older revision		Revision as of 15:31, 1 June 2025
Line 14:		Line 14:
	*'''bodyPart:''' the bodypart that hit the other element		*'''bodyPart:''' the bodypart that hit the other element
	{{VehicleParts}}		{{VehicleParts}}
	*'''collisionX/Y/Z:''' the position the collision took place		*'''collisionX:''' the X coordinate of the position the collision took place
	*'''normalX/Y/Z:''' the surface normal of the hit object		*'''collisionY:''' the Y coordinate of the position the collision took place
			*'''collisionZ:''' the Z coordinate of the position the collision took place
			*'''normalX:''' the X coordinate of the surface normal of the hit object
			*'''normalY:''' the Y coordinate of the surface normal of the hit object
			*'''normalZ:''' the Z coordinate of the surface normal of the hit object
	*'''hitElementForce:''' 0 for non vehicles or the force of the other vehicle		*'''hitElementForce:''' 0 for non vehicles or the force of the other vehicle
	*'''model:''' model of the hit element (useful to detect building collisions as hitElement will be nil)		*'''model:''' model of the hit element (useful to detect building collisions as hitElement will be nil)

Fernando187: /* Parameters */

2025-05-31T11:53:42Z

Parameters

← Older revision		Revision as of 11:53, 31 May 2025
Line 7:		Line 7:
	==Parameters==		==Parameters==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	element theHitElement, float damageImpulseMag, int ~~bodypart~~, float collisionX, float collisionY, float collisionZ, float normalX, float normalY, float normalZ, float hitElementForce, int model		element theHitElement, float damageImpulseMag, int bodyPart, float collisionX, float collisionY, float collisionZ, float normalX, float normalY, float normalZ, float hitElementForce, int model
	</syntaxhighlight>		</syntaxhighlight>
	'''Note:''' ''theHitElement'' will be nil or false if it's a default SA object and it will trigger twice for vehicles because one vehicle hit another and one got hit by another.		'''Note:''' ''theHitElement'' will be nil or false if it's a default SA object and it will trigger twice for vehicles because one vehicle hit another and one got hit by another.
Line 16:		Line 16:
	*'''collisionX/Y/Z:''' the position the collision took place		*'''collisionX/Y/Z:''' the position the collision took place
	*'''normalX/Y/Z:''' the surface normal of the hit object		*'''normalX/Y/Z:''' the surface normal of the hit object
	*'''~~hitElementforce~~:''' 0 for non vehicles or the force of the other vehicle		*'''hitElementForce:''' 0 for non vehicles or the force of the other vehicle
	*'''model:''' model of the hit element (useful to detect building collisions as hitElement will be nil)		*'''model:''' model of the hit element (useful to detect building collisions as hitElement will be nil)

Zangomangu: Updated issues

2022-01-30T10:35:37Z

Updated issues

← Older revision		Revision as of 10:35, 30 January 2022
Line 31:		Line 31:
	==Issues==		==Issues==
	{{Issues\|		{{Issues\|
	{{Issue\|~~7422~~\|onClientVehicleCollision ~~doesnt~~ trigger when ~~hitting some frozen~~ objects}}		{{Issue\|522\|onClientVehicleCollision doesn't trigger when world objects are broken}}
	{{Issue\|~~8265~~\|~~(Fixed~~ in ~~r14744)~~ onClientVehicleCollision ~~doesn't trigger~~ for ~~planes, trains and boats~~}}		{{Issue\|2320\|hitElement in onClientVehicleCollision returns nil for projectile}}
	}}		}}

Pirulax: change force to damageImpulseMag as in the source code

2020-07-17T18:58:32Z

change force to damageImpulseMag as in the source code

← Older revision		Revision as of 18:58, 17 July 2020
Line 7:		Line 7:
	==Parameters==		==Parameters==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	element theHitElement, float ~~force~~, int bodypart, float collisionX, float collisionY, float collisionZ, float normalX, float normalY, float normalZ, float hitElementForce, int model		element theHitElement, float damageImpulseMag, int bodypart, float collisionX, float collisionY, float collisionZ, float normalX, float normalY, float normalZ, float hitElementForce, int model
	</syntaxhighlight>		</syntaxhighlight>
	'''Note:''' ''theHitElement'' will be nil or false if it's a default SA object and it will trigger twice for vehicles because one vehicle hit another and one got hit by another.		'''Note:''' ''theHitElement'' will be nil or false if it's a default SA object and it will trigger twice for vehicles because one vehicle hit another and one got hit by another.
	*'''theHitElement:''' the other entity, or nil if the vehicle collided with the world		*'''theHitElement:''' the other entity, or nil if the vehicle collided with the world
	*'''~~force~~:''' the impact magnitude (Note: this is NOT the damage it is a force value which is then multiplied by the vehicles collision damage multiplier. for an example of this see below)		*'''damageImpulseMag:''' the impact magnitude (Note: this is NOT the damage it is a force value which is then multiplied by the vehicles collision damage multiplier. for an example of this see below)
	*'''bodyPart:''' the bodypart that hit the other element		*'''bodyPart:''' the bodypart that hit the other element
	{{VehicleParts}}		{{VehicleParts}}
Line 38:		Line 38:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	addEventHandler("onClientVehicleCollision", root,		addEventHandler("onClientVehicleCollision", root,
	function(collider,~~force~~, bodyPart, x, y, z, nx, ny, nz)		function(collider, damageImpulseMag, bodyPart, x, y, z, nx, ny, nz)
	if ( source == getPedOccupiedVehicle(localPlayer) ) then		if ( source == getPedOccupiedVehicle(localPlayer) ) then
	-- force does not take into account the collision damage multiplier (this is what makes heavy vehicles take less damage than banshees for instance) so take that into account to get the damage dealt		-- force does not take into account the collision damage multiplier (this is what makes heavy vehicles take less damage than banshees for instance) so take that into account to get the damage dealt
	local fDamageMultiplier = getVehicleHandling(source).collisionDamageMultiplier		local fDamageMultiplier = getVehicleHandling(source).collisionDamageMultiplier
	-- Create a marker (Scaled down to 1% of the actual damage otherwise we will get huge markers)		-- Create a marker (Scaled down to 1% of the actual damage otherwise we will get huge markers)
	local m = createMarker(x, y, z, "corona", ~~force~~ * fDamageMultiplier * 0.01, 0, 9, 231)		local m = createMarker(x, y, z, "corona", damageImpulseMag* fDamageMultiplier * 0.01, 0, 9, 231)
	-- Destroy the marker in 2 seconds		-- Destroy the marker in 2 seconds
	setTimer(destroyElement, 2000, 1, m)		setTimer(destroyElement, 2000, 1, m)

Zver-CR at 22:50, 16 January 2019

2019-01-16T22:50:17Z

← Older revision		Revision as of 22:50, 16 January 2019
Line 32:		Line 32:
	{{Issues\|		{{Issues\|
	{{Issue\|7422\|onClientVehicleCollision doesnt trigger when hitting some frozen objects}}		{{Issue\|7422\|onClientVehicleCollision doesnt trigger when hitting some frozen objects}}
	{{Issue\|8265\|onClientVehicleCollision doesn't trigger for planes, trains and boats}}		{{Issue\|8265\|(Fixed in r14744) onClientVehicleCollision doesn't trigger for planes, trains and boats}}
	}}		}}

Lexr128: Added VehicleParts Template

2017-07-01T14:15:21Z

Added VehicleParts Template

← Older revision		Revision as of 14:15, 1 July 2017
Line 13:		Line 13:
	*'''force:''' the impact magnitude (Note: this is NOT the damage it is a force value which is then multiplied by the vehicles collision damage multiplier. for an example of this see below)		*'''force:''' the impact magnitude (Note: this is NOT the damage it is a force value which is then multiplied by the vehicles collision damage multiplier. for an example of this see below)
	*'''bodyPart:''' the bodypart that hit the other element		*'''bodyPart:''' the bodypart that hit the other element
			{{VehicleParts}}
	*'''collisionX/Y/Z:''' the position the collision took place		*'''collisionX/Y/Z:''' the position the collision took place
	*'''normalX/Y/Z:''' the surface normal of the hit object		*'''normalX/Y/Z:''' the surface normal of the hit object

Lopez: /* Issues */

2015-07-07T06:05:05Z

Issues

← Older revision		Revision as of 06:05, 7 July 2015
Line 31:		Line 31:
	{{Issues\|		{{Issues\|
	{{Issue\|7422\|onClientVehicleCollision doesnt trigger when hitting some frozen objects}}		{{Issue\|7422\|onClientVehicleCollision doesnt trigger when hitting some frozen objects}}
	{{Issue\|8265\|onClientVehicleCollision doesn't trigger for ~~Planes~~ and ~~Boats~~}}		{{Issue\|8265\|onClientVehicleCollision doesn't trigger for planes, trains and boats}}
	}}		}}

Ccw at 02:57, 20 January 2015

2015-01-20T02:57:56Z

← Older revision		Revision as of 02:57, 20 January 2015
Line 4:		Line 4:

	Note that the collision reported by this event doesn't always damage the vehicle by default (this event triggers when hitting lamp posts, but the vehicle isn't damaged by them automatically, for example). If you want to deal with real damage, please refer to [[onClientVehicleDamage]].		Note that the collision reported by this event doesn't always damage the vehicle by default (this event triggers when hitting lamp posts, but the vehicle isn't damaged by them automatically, for example). If you want to deal with real damage, please refer to [[onClientVehicleDamage]].
			{{Note\|This event is only triggered for vehicles that are streamed in}}
	==Parameters==		==Parameters==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">

AlexTMjugador at 11:43, 7 December 2014

2014-12-07T11:43:48Z

← Older revision		Revision as of 11:43, 7 December 2014
Line 1:		Line 1:
	{{Client event}}		{{Client event}}
	__NOTOC__		__NOTOC__
	This event is triggered when a vehicle collides with ~~peds/vehicles/objects~~.		This event is triggered when a vehicle collides with an [[element]] or a world object.

	Note that the collision reported by this event doesn't always damage the vehicle by default~~, however~~ (this ~~events~~ triggers when hitting lamp posts, but the vehicle isn't damaged by them automatically, for example). If you want to deal with real damage, please refer to [[onClientVehicleDamage]].		Note that the collision reported by this event doesn't always damage the vehicle by default (this event triggers when hitting lamp posts, but the vehicle isn't damaged by them automatically, for example). If you want to deal with real damage, please refer to [[onClientVehicleDamage]].

	==Parameters==		==Parameters==

AlexTMjugador: Added a note

2014-12-07T11:41:42Z

Added a note

← Older revision		Revision as of 11:41, 7 December 2014
Line 2:		Line 2:
	__NOTOC__		__NOTOC__
	This event is triggered when a vehicle collides with peds/vehicles/objects.		This event is triggered when a vehicle collides with peds/vehicles/objects.

			Note that the collision reported by this event doesn't always damage the vehicle by default, however (this events triggers when hitting lamp posts, but the vehicle isn't damaged by them automatically, for example). If you want to deal with real damage, please refer to [[onClientVehicleDamage]].

	==Parameters==		==Parameters==