OnClientExplosion: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
(Update explosion types.)
 
(4 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Client event}}
{{Client event}}
{{Needs_Checking|Is this also triggered for explosions outside the stream distance?}}
This event is triggered every time an explosion is created on the current '''clients scene''' (inside the streamer).
This event is triggered every time an explosion is created on the current clients scene (inside the streamer)
==Parameters==
==Parameters==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
float x, float y, float z, int theType
float x, float y, float z, int theType
</syntaxhighlight>
</syntaxhighlight>
*'''x:''' the X Coordinate of where the explosion was created
*'''x:''' X coordinate of where the explosion was created
*'''y:''' the Y Coordinate of where the explosion was created
*'''y:''' Y coordinate of where the explosion was created
*'''z:''' the z Coordinate of where the explosion was created
*'''z:''' Z coordinate of where the explosion was created
*'''theType:''' the type of explosion created, Values are:
*'''theType:''' the type of explosion created, see: [[Explosion types]]
{{Explosions}}
 
==Source==
==Source==
The [[event system#Event source|source]] of this event is the explosions creator element (object/vehicle/player)
The [[event system#Event source|source]] of this event is the [[player]] who created the explosion.
If the explosion is from a [[vehicle]] the source is the [[player]] who syncs the vehicle.


===Canceling===
===Canceling===
Line 22: Line 20:
This example outputs the type of element that created the explosion into the chatbox.
This example outputs the type of element that created the explosion into the chatbox.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function ClientExplosionFunction(x,y,z,theType)
function onClientExplosion(x, y, z, theType)
outputChatBox("Explosion created by a "..getElementType(source))
outputChatBox("Explosion created by a "..getElementType(source))
end
end
addEventHandler("onClientExplosion",getRootElement(),ClientExplosionFunction)
addEventHandler("onClientExplosion", root, onClientExplosion)
</syntaxhighlight>
</syntaxhighlight>



Latest revision as of 11:43, 11 January 2024

This event is triggered every time an explosion is created on the current clients scene (inside the streamer).

Parameters

float x, float y, float z, int theType
  • x: X coordinate of where the explosion was created
  • y: Y coordinate of where the explosion was created
  • z: Z coordinate of where the explosion was created
  • theType: the type of explosion created, see: Explosion types

Source

The source of this event is the player who created the explosion. If the explosion is from a vehicle the source is the player who syncs the vehicle.

Canceling

If this event is canceled, the explosion will not occur.

Example

This example outputs the type of element that created the explosion into the chatbox.

function onClientExplosion(x, y, z, theType)
	outputChatBox("Explosion created by a "..getElementType(source))
end
addEventHandler("onClientExplosion", root, onClientExplosion)

See Also

Other client events


Client event functions