OnMarkerHit

This event is triggered when an element enters a marker created using createMarker.

[[{{{image}}}|link=|]]	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

element hitElement, bool matchingDimension

• hitElement: the element that hit the marker.
• matchingDimension: a boolean representing whether the element is in the same dimension as the marker.

Source

The source of this event is the marker that got hit by the element.

Example

This example will output a message what type of element has entered a marker.

local playerMarker = createMarker(0, 0, 2, "cylinder", 5, 10, 244, 23, 200, root)

function handlePlayerMarker(hitElement)
	local elementType = getElementType(hitElement)

	outputChatBox("Element ("..elementType..") has entered marker.")
end
addEventHandler("onMarkerHit", playerMarker, handlePlayerMarker)

Issues

Issue ID	Description
#551	If a marker was attached to another element, onMarkerHit won't be triggered
#519	onMarkerHit not always triggered in interiors
#923	Server side markers with size < 1.5 don't trigger event

See Also

Marker events

• onMarkerHit
• onMarkerLeave

Event functions

• addEvent
• addEventHandler
• cancelEvent
• cancelLatentEvent
• getCancelReason
• getEventHandlers
• getLatentEventHandles
• getLatentEventStatus
• removeEventHandler
• triggerEvent
• triggerClientEvent
• triggerLatentClientEvent
• wasEventCancelled