OnPlayerMarkerHit: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (See Also for server events)
m (Changed example, added note about attaching this event)
 
(5 intermediate revisions by 3 users not shown)
Line 2: Line 2:
{{Server event}}
{{Server event}}
This event is triggered when a [[player]] hits a [[marker]].
This event is triggered when a [[player]] hits a [[marker]].
{{Note|This event is triggered for <b>players</b> only. Attaching this event to a marker does nothing.}}


==Parameters==
==Parameters==
Line 8: Line 9:
</syntaxhighlight>  
</syntaxhighlight>  


*'''markerHit''': The marker the player hit
*'''markerHit''': the [[marker]] the [[player]] hit.
*'''matchingDimension''': Whether the player and the marker he hit are in the same dimension
*'''matchingDimension''': a [[boolean]] representing whether the [[player]] and the hit [[marker]] are in the same [[dimension]].


==Source==
==Source==
Line 15: Line 16:


==Example==  
==Example==  
<!-- Explain what the example is in a single sentance -->
This example outputs when a player hits a marker.
This example does...
<!-- 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">
--This line does...
addEventHandler('onPlayerMarkerHit', root, function(marker, dimension)
blah()
if not dim then return end -- check if player is actually going into the marker
--This line does this...
outputChatBox('You have just entered a marker!', source, 255, 255, 0) -- output something
mooo
end)
</syntaxhighlight>
</syntaxhighlight>


{{See also/Server event|Player events}}
{{See also/Server event|Player events}}
[[Category:Needs Example]]

Latest revision as of 18:20, 2 September 2023

This event is triggered when a player hits a marker.

[[{{{image}}}|link=|]] Note: This event is triggered for players only. Attaching this event to a marker does nothing.

Parameters

marker markerHit, bool matchingDimension

Source

The source of this event is the player that hit the marker.

Example

This example outputs when a player hits a marker.

addEventHandler('onPlayerMarkerHit', root, function(marker, dimension)
	if not dim then return end -- check if player is actually going into the marker
	outputChatBox('You have just entered a marker!', source, 255, 255, 0) -- output something
end)

See Also

Player events


Event functions