OnExplosion - Revision history

DColeman: Add explosion sync information

2025-12-17T09:25:22Z

Add explosion sync information

← Older revision		Revision as of 09:25, 17 December 2025
Line 15:		Line 15:
	===Canceling===		===Canceling===
	If this event is [[Event system #Canceling\|canceled]], the explosion will not occur.		If this event is [[Event system #Canceling\|canceled]], the explosion will not occur.
			If an explosion is notified by a player, that explosion will still be visible to this player.

	==Example==		==Example==

Srslyyyy: /* Example */

2024-01-11T14:09:12Z

Example

← Older revision		Revision as of 14:09, 11 January 2024
Line 40:		Line 40:

	function onExplosion(explosionX, explosionY, explosionZ, explosionType)		function onExplosion(explosionX, explosionY, explosionZ, explosionType)
	local explosionPos = (explosionX..", "..explosionY..", "..explosionZ)		local explosionPos = explosionX..", "..explosionY..", "..explosionZ
	local explosionTypeName = explosionTypes[explosionType]		local explosionTypeName = explosionTypes[explosionType]
	local explosionSource = inspect(source)		local explosionSource = inspect(source)
	local debugMsg = (explosionTypeName.." explosion has occured at "..explosionPos.." (source: "..explosionSource..")")		local debugMsg = explosionTypeName.." explosion has occured at "..explosionPos.." (source: "..explosionSource..")"

	outputDebugString(debugMsg, debugMsgLevel, debugMsgR, debugMsgG, debugMsgB)		outputDebugString(debugMsg, debugMsgLevel, debugMsgR, debugMsgG, debugMsgB)

Srslyyyy: /* Example */

2024-01-11T14:08:59Z

Example

← Older revision		Revision as of 14:08, 11 January 2024
Line 31:		Line 31:
	[5] = "Car Quick",		[5] = "Car Quick",
	[6] = "Boat",		[6] = "Boat",
	[7] = "~~Heli~~",		[7] = "Aircraft",
	[8] = "Mine",		[8] = "Mine",
	[9] = "Object",		[9] = "Object",

Srslyyyy: Update explosion types.

2024-01-11T11:43:54Z

Update explosion types.

← Older revision		Revision as of 11:43, 11 January 2024
Line 9:		Line 9:
	*'''y:''' Y 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		*'''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 [[player]] who notified server about explosion, or [[root]] if explosion was created server-side along without specifying creator in [[createExplosion]].		The [[event system#Event source\|source]] of this event is the [[player]] who notified server about explosion, or [[root]] if explosion was created server-side along without specifying creator in [[createExplosion]].

Srslyyyy: More clear explanation of source behaviour

2023-10-31T14:57:10Z

More clear explanation of source behaviour

← Older revision		Revision as of 14:57, 31 October 2023
Line 12:		Line 12:
	{{Explosions}}		{{Explosions}}
	==Source==		==Source==
	The [[event system#Event source\|source]] of this event is the [[player]] who notified server about explosion, or [[root]] if explosion was created without specifying creator in [[createExplosion]].		The [[event system#Event source\|source]] of this event is the [[player]] who notified server about explosion, or [[root]] if explosion was created server-side along without specifying creator in [[createExplosion]].

	===Canceling===		===Canceling===
	If this event is [[Event system #Canceling\|canceled]], the explosion will not occur.		If this event is [[Event system #Canceling\|canceled]], the explosion will not occur.

	==Example==		==Example==

Srslyyyy: /* Example */

2023-10-31T14:25:07Z

Example

← Older revision		Revision as of 14:25, 31 October 2023
Line 20:		Line 20:
	This example outputs information about occuring explosion.		This example outputs information about occuring explosion.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
			local debugMsgLevel = 4
			local debugMsgR = 255
			local debugMsgG = 127
			local debugMsgB = 0
	local explosionTypes = {		local explosionTypes = {
	[0] = "Grenade",		[0] = "Grenade",
Line 40:		Line 44:
	local explosionTypeName = explosionTypes[explosionType]		local explosionTypeName = explosionTypes[explosionType]
	local explosionSource = inspect(source)		local explosionSource = inspect(source)

	local debugMsg = (explosionTypeName.." explosion has occured at "..explosionPos.." (source: "..explosionSource..")")		local debugMsg = (explosionTypeName.." explosion has occured at "..explosionPos.." (source: "..explosionSource..")")
	~~local debugMsgLevel = 4~~
	~~local debugMsgR = 255~~
	~~local debugMsgG = 127~~
	~~local debugMsgB = 0~~

	outputDebugString(debugMsg, debugMsgLevel, debugMsgR, debugMsgG, debugMsgB)		outputDebugString(debugMsg, debugMsgLevel, debugMsgR, debugMsgG, debugMsgB)
Line 51:		Line 50:
	addEventHandler("onExplosion", root, onExplosion)		addEventHandler("onExplosion", root, onExplosion)
	</syntaxhighlight>		</syntaxhighlight>

	{{See also/Server event\|Server events}}		{{See also/Server event\|Server events}}

Srslyyyy: Missing word

2023-07-30T14:26:11Z

Missing word

← Older revision		Revision as of 14:26, 30 July 2023
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{Server event}}		{{Server event}}
	{{Added feature/item\|1.6.1\|1.6.0\|21914\|This event is triggered every time an explosion is created either by server-side [[createExplosion]], or reported by [[player]].}}		{{Added feature/item\|1.6.1\|1.6.0\|21914\|This event is triggered every time an explosion is created either by server-side [[createExplosion]], or when reported by [[player]].}}
	==Parameters==		==Parameters==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">

Botder at 13:20, 30 July 2023

2023-07-30T13:20:18Z

← Older revision		Revision as of 13:20, 30 July 2023
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{Server event}}		{{Server event}}
	{{Added feature/item\|1.6.0\|1.5.9\|21914\|This event is triggered every time an explosion is created either by server-side [[createExplosion]], or reported by [[player]].}}		{{Added feature/item\|1.6.1\|1.6.0\|21914\|This event is triggered every time an explosion is created either by server-side [[createExplosion]], or reported by [[player]].}}
	==Parameters==		==Parameters==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">

Srslyyyy: Adjust information about source element.

2023-07-30T13:19:49Z

Adjust information about source element.

← Older revision		Revision as of 13:19, 30 July 2023
Line 12:		Line 12:
	{{Explosions}}		{{Explosions}}
	==Source==		==Source==
	The [[event system#Event source\|source]] of this event is the [[player]] who notified server about explosion.		The [[event system#Event source\|source]] of this event is the [[player]] who notified server about explosion, or [[root]] if explosion was created without specifying creator in [[createExplosion]].

	===Canceling===		===Canceling===

Srslyyyy: Add onExplosion event (https://github.com/multitheftauto/mtasa-blue/pull/3130)

2023-07-30T13:05:05Z

Add onExplosion event (https://github.com/multitheftauto/mtasa-blue/pull/3130)

New page

__NOTOC__
{{Server event}}
{{Added feature/item|1.6.0|1.5.9|21914|This event is triggered every time an explosion is created either by server-side [[createExplosion]], or reported by [[player]].}}
==Parameters==
<syntaxhighlight lang="lua">
float x, float y, float z, int theType
</syntaxhighlight>
*'''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, values are:
{{Explosions}}
==Source==
The [[event system#Event source|source]] of this event is the [[player]] who notified server about explosion.

===Canceling===
If this event is [[Event system #Canceling|canceled]], the explosion will not occur.

==Example==
This example outputs information about occuring explosion.
<syntaxhighlight lang="lua">
local explosionTypes = {
[0] = "Grenade",
[1] = "Molotov",
[2] = "Rocket",
[3] = "Rocket Weak",
[4] = "Car",
[5] = "Car Quick",
[6] = "Boat",
[7] = "Heli",
[8] = "Mine",
[9] = "Object",
[10] = "Tank Grenade",
[11] = "Small",
[12] = "Tiny",
}

function onExplosion(explosionX, explosionY, explosionZ, explosionType)
local explosionPos = (explosionX..", "..explosionY..", "..explosionZ)
local explosionTypeName = explosionTypes[explosionType]
local explosionSource = inspect(source)

local debugMsg = (explosionTypeName.." explosion has occured at "..explosionPos.." (source: "..explosionSource..")")
local debugMsgLevel = 4
local debugMsgR = 255
local debugMsgG = 127
local debugMsgB = 0

outputDebugString(debugMsg, debugMsgLevel, debugMsgR, debugMsgG, debugMsgB)
end
addEventHandler("onExplosion", root, onExplosion)
</syntaxhighlight>

{{See also/Server event|Server events}}