OnPlayerTeleport: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Server event}}
{{Server event}}
{{Added feature/item|1.6.1|1.6.0|22930|This event is triggered when a player's position changes significantly without being caused by [[setElementPosition]].}}
{{Added feature/item|1.6.1|1.6.0|22930|This event is triggered when a player's position changes significantly without direct server intervention, such as the use of [[setElementPosition]] or [[spawnPlayer]].}}
 
During intervals defined by the '''player_teleport_alert''' setting, the server monitors player positions to detect significant unexpected movements. If a player's position deviates beyond the established threshold without server functions like [[setElementPosition]] or [[spawnPlayer]] being used, this event will be triggered.
During each interval (''player_teleport_alert''), the server monitors player positions and checks for significant unexpected movements. If a player's position deviates beyond the defined threshold without using [[setElementPosition]], this event will be fired.
{{Note|The sensitivity threshold can be adjusted through the '''player_teleport_alert''' setting, which accepts values between 5 and 500 (default: 100).}}
 
The threshold can be configured using ''player_teleport_alert'', which can be set between 5 and 500 (default: 100).


==Parameters==   
==Parameters==   

Revision as of 01:34, 31 January 2025

BETA: NEW FEATURE (BUILD: 1.6.0 r22930)
This event is triggered when a player's position changes significantly without direct server intervention, such as the use of setElementPosition or spawnPlayer.

During intervals defined by the player_teleport_alert setting, the server monitors player positions to detect significant unexpected movements. If a player's position deviates beyond the established threshold without server functions like setElementPosition or spawnPlayer being used, this event will be triggered.

[[{{{image}}}|link=|]] Note: The sensitivity threshold can be adjusted through the player_teleport_alert setting, which accepts values between 5 and 500 (default: 100).

Parameters

None

Source

The source of this event is the player who triggered the teleport detection.

Canceling

Canceling this event has no effect.

Example

This example will disconnect the suspected player from the server and display a warning about the teleport.

addEventHandler("onPlayerTeleport", root, function()
    kickPlayer(source, "AC", "You were disconnected from the server for attempting to teleport. If this was a mistake, please contact the administration.")
end)

See Also

Player events


Event functions