OnPlayerTeleport: Difference between revisions
Jump to navigation
Jump to search
Imfelipedev (talk | contribs) |
Imfelipedev (talk | contribs) No edit summary |
||
(4 intermediate revisions by the same user not shown) | |||
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 | {{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]].}} | ||
When the player synchronizes data with the server, 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]] being used, this event will be triggered. | |||
{{Note|The sensitivity threshold can be adjusted through the '''player_teleport_alert''' setting, which accepts values between 5 and 500 (default: 100).}} | |||
==Parameters== | |||
<syntaxhighlight lang="lua"> | |||
float previousX, float previousY, float previousZ, float currentX, float currentY, float currentZ | |||
</syntaxhighlight> | |||
*'''previousX''': A [[float]] representing the player X-coordinate before teleporting. | |||
*'''previousY''': A [[float]] representing the player Y-coordinate before teleporting. | |||
*'''previousZ''': A [[float]] representing the player Z-coordinate before teleporting. | |||
*'''currentX''': A [[float]] representing the player current X-coordinate after teleporting. | |||
*'''currentY''': A [[float]] representing the player current Y-coordinate after teleporting. | |||
*'''currentZ''': A [[float]] representing the player current Z-coordinate after teleporting. | |||
==Source== | ==Source== | ||
Line 17: | Line 24: | ||
==Example== | ==Example== | ||
This example | This example logs unexpected teleportation events. | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
addEventHandler("onPlayerTeleport", root, function() | addEventHandler("onPlayerTeleport", root, function() | ||
outputServerLog("Player "..getPlayerName(source).." teleported unexpectedly. Possible hack detected.") | |||
end) | end) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
{{See also/Server event|Player events}} | {{See also/Server event|Player events}} |
Latest revision as of 20:04, 16 February 2025
When the player synchronizes data with the server, 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 being used, this event will be triggered.
Parameters
float previousX, float previousY, float previousZ, float currentX, float currentY, float currentZ
- previousX: A float representing the player X-coordinate before teleporting.
- previousY: A float representing the player Y-coordinate before teleporting.
- previousZ: A float representing the player Z-coordinate before teleporting.
- currentX: A float representing the player current X-coordinate after teleporting.
- currentY: A float representing the player current Y-coordinate after teleporting.
- currentZ: A float representing the player current Z-coordinate after teleporting.
Source
The source of this event is the player who triggered the teleport detection.
Canceling
Canceling this event has no effect.
Example
This example logs unexpected teleportation events.
addEventHandler("onPlayerTeleport", root, function() outputServerLog("Player "..getPlayerName(source).." teleported unexpectedly. Possible hack detected.") end)
See Also
Player events
- onPlayerACInfo
- onPlayerBan
- onPlayerChangeNick
- onPlayerChat
- onPlayerClick
- onPlayerCommand
- onPlayerConnect
- onPlayerContact
- onPlayerDamage
- onPlayerJoin
- onPlayerLogin
- onPlayerLogout
- onPlayerMarkerHit
- onPlayerMarkerLeave
- onPlayerModInfo
- onPlayerMute
- onPlayerNetworkStatus
- onPlayerPickupHit
- onPlayerPickupLeave
- onPlayerPickupUse
- onPlayerPrivateMessage
- onPlayerQuit
- onPlayerScreenShot
- onPlayerSpawn
- onPlayerStealthKill
- onPlayerTarget
- onPlayerUnmute
- onPlayerVehicleEnter
- onPlayerVehicleExit
- onPlayerVoiceStart
- onPlayerVoiceStop
- onPlayerWasted
- onPlayerWeaponFire
- onPlayerWeaponSwitch
Event functions
- addEvent
- addEventHandler
- cancelEvent
- cancelLatentEvent
- getEventHandlers
- getLatentEventHandles
- getLatentEventStatus
- removeEventHandler
- triggerEvent
- wasEventCancelled