OnMarkerHit - Revision history

Pirulax: Add important note regarding weird behavior

2023-09-20T20:40:31Z

Add important note regarding weird behavior

← Older revision		Revision as of 20:40, 20 September 2023
Line 2:		Line 2:
	{{Server event}}		{{Server event}}
	This event is triggered when an element enters a marker created using [[createMarker]].		This event is triggered when an element enters a marker created using [[createMarker]].
			{{Important Note\|The event is not triggered when only the dimension changes of the player. So, if you use the `matchingDimension` when teleporting players into existing markers you should always first set their dimension/interior and only then the position}}

	==Parameters==		==Parameters==

2022-01-30T10:39:52Z

Updated issues

← Older revision		Revision as of 10:39, 30 January 2022
Line 31:		Line 31:
	==Issues==		==Issues==
	{{Issues\|		{{Issues\|
	{{Issue\|~~6098~~\|If a marker was attached to another element, onMarkerHit won't be triggered}}		{{Issue\|551\|If a marker was attached to another element, onMarkerHit won't be triggered}}
			{{Issue\|519\|onMarkerHit not always triggered in interiors}}
			{{Issue\|923\|Server side markers with size < 1.5 don't trigger event}}
	}}		}}

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

2021-02-24T13:44:50Z

Improve example.

← Older revision		Revision as of 13:44, 24 February 2021
Line 19:		Line 19:
	<!-- Add the code below, an emphasis should be on making it clear, not optimized. You could provide two versions if you wish, one clear and well commented, the other optimized -->		<!-- Add the code below, an emphasis should be on making it clear, not optimized. You could provide two versions if you wish, one clear and well commented, the other optimized -->
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
			local playerMarker = createMarker(0, 0, 2, "cylinder", 5, 10, 244, 23, 200, root)

	~~playerMarker~~ = ~~createMarker~~(~~1601, 1212, 12.434, "cylinder", 15, 10, 244, 23, 2~~)		function handlePlayerMarker(hitElement)
			local elementType = getElementType(hitElement)

	~~addEventHandler~~("~~onMarkerHit", playerMarker, function(hitElement)~~		outputChatBox("Element ("..elementType..") has entered marker.")
	~~local tps = getPlayerFromName~~("~~MR Mariusz~~")		end
	~~if tps then~~		addEventHandler("onMarkerHit", playerMarker, handlePlayerMarker)
	~~local x, y, z, = getElementPosition(hitElement~~)
	~~veh = createVehicle(416, x, y-2, z)~~
	~~outputChatBox~~("~~You create vehicle!~~", ~~hitElement)~~
	~~else~~
	~~outputChatBox("No, no!"~~, ~~hitElement)~~
	~~end~~
	~~end~~)
	</syntaxhighlight>		</syntaxhighlight>

2020-06-09T21:38:23Z

Example

← Older revision		Revision as of 21:38, 9 June 2020
Line 29:		Line 29:
	outputChatBox("You create vehicle!", hitElement)		outputChatBox("You create vehicle!", hitElement)
	else		else
	outputChatBox("No, no!", ~~player~~)		outputChatBox("No, no!", hitElement)
	end		end
	end)		end)

2020-06-09T21:38:00Z

Example

← Older revision		Revision as of 21:38, 9 June 2020
Line 20:		Line 20:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">

	~~local myMarker~~ = createMarker(~~-2596.625~~, ~~579.358~~, 15.~~626~~, 'cylinder', ~~2.0~~, ~~255~~, 0, 0, ~~150~~) ~~-- create myMarker~~		playerMarker = createMarker(1601, 1212, 12.434, "cylinder", 15, 10, 244, 23, 2)

	function ~~MarkerHit~~( hitElement~~, matchingDimension~~ ) ~~-- define MarkerHit function for the handler~~		addEventHandler("onMarkerHit", playerMarker, function(hitElement)
	local ~~elementType~~ = ~~getElementType~~( hitElement ) -~~- get the hit element's type~~		local tps = getPlayerFromName("MR Mariusz")
	outputChatBox( ~~elementType..~~" ~~inside myMarker~~", ~~getRootElement~~(), ~~255~~, ~~255, 0~~ ) ~~-- attach the element's type with the text, and output it~~		if tps then
	end		local x, y, z, = getElementPosition(hitElement)
	~~addEventHandler( "onMarkerHit", myMarker, MarkerHit~~ ) ~~-- attach onMarkerHit event to MarkerHit function~~</syntaxhighlight>		veh = createVehicle(416, x, y-2, z)
			outputChatBox("You create vehicle!", hitElement)
			else
			outputChatBox("No, no!", player)
			end
			end)
			</syntaxhighlight>

	==Issues==		==Issues==

2018-09-27T02:57:16Z

← Older revision		Revision as of 02:57, 27 September 2018
Line 33:		Line 33:
	}}		}}

	==See ~~Also==~~		{{See also/Server event\|Marker events}}
	~~===~~Marker events~~===~~
	~~{{Marker_events}}~~
	~~===Event functions===~~
	~~{{Event functions~~}}

2018-09-27T02:08:44Z

← Older revision		Revision as of 02:08, 27 September 2018
Line 33:		Line 33:
	}}		}}

	{{See ~~also/Server event\|~~Marker events}}		==See Also==
			===Marker events===
			{{Marker_events}}
			===Event functions===
			{{Event functions}}

2018-04-02T22:05:49Z

Parameters

← Older revision		Revision as of 22:05, 2 April 2018
Line 8:		Line 8:
	</syntaxhighlight>		</syntaxhighlight>

	*'''hitElement''': ~~The~~ element that hit the marker.		*'''hitElement''': the [[element]] that hit the [[marker]].
	*'''matchingDimension''': ~~True if~~ the element is in the same dimension as the marker.		*'''matchingDimension''': a [[boolean]] representing whether the [[element]] is in the same dimension as the [[marker]].

	==Source==		==Source==

2018-04-02T21:24:45Z

Parameters

← Older revision		Revision as of 21:24, 2 April 2018
Line 8:		Line 8:
	</syntaxhighlight>		</syntaxhighlight>

	*'''hitElement''': The element that hit the marker		*'''hitElement''': The element that hit the marker.
	*'''matchingDimension''': True if the element is in the same dimension as the marker ~~he hit~~		*'''matchingDimension''': True if the element is in the same dimension as the marker.

	==Source==		==Source==

2013-01-25T20:24:32Z

← Older revision		Revision as of 20:24, 25 January 2013
Line 27:		Line 27:
	end		end
	addEventHandler( "onMarkerHit", myMarker, MarkerHit ) -- attach onMarkerHit event to MarkerHit function</syntaxhighlight>		addEventHandler( "onMarkerHit", myMarker, MarkerHit ) -- attach onMarkerHit event to MarkerHit function</syntaxhighlight>

			==Issues==
			{{Issues\|
			{{Issue\|6098\|If a marker was attached to another element, onMarkerHit won't be triggered}}
			}}

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