OnPlayerTeleport - Revision history

Fernando187: desc

2025-05-31T23:45:54Z

desc

← Older revision		Revision as of 23:45, 31 May 2025
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 direct server intervention, such as the use of [[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]]. 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.}}
	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).}}		{{Note\|The sensitivity threshold can be adjusted through the '''player_teleport_alert''' setting, which accepts values between 5 and 500 (default: 100).}}

Imfelipedev at 20:04, 16 February 2025

2025-02-16T20:04:56Z

← Older revision		Revision as of 20:04, 16 February 2025
Line 24:		Line 24:

	==Example==		==Example==
	This example ~~will disconnect the suspected player from the server and display a warning about the teleport~~.		This example logs unexpected teleportation events.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	addEventHandler("onPlayerTeleport", root, function()		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~~.")		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}}

Imfelipedev at 20:00, 16 February 2025

2025-02-16T20:00:16Z

← Older revision		Revision as of 20:00, 16 February 2025
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 direct server intervention, such as the use of [[setElementPosition~~]] or [[spawnPlayer~~]].}}		{{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~~]] or [[spawnPlayer~~]] being used, this event will be triggered.		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).}}		{{Note\|The sensitivity threshold can be adjusted through the '''player_teleport_alert''' setting, which accepts values between 5 and 500 (default: 100).}}

Imfelipedev at 23:33, 4 February 2025

2025-02-04T23:33:09Z

← Older revision		Revision as of 23:33, 4 February 2025
Line 2:		Line 2:
	{{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 direct server intervention, such as the use of [[setElementPosition]] or [[spawnPlayer]].}}		{{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.		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]] or [[spawnPlayer]] 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).}}		{{Note\|The sensitivity threshold can be adjusted through the '''player_teleport_alert''' setting, which accepts values between 5 and 500 (default: 100).}}

Imfelipedev: /* Parameters */

2025-02-04T23:28:31Z

Parameters

← Older revision		Revision as of 23:28, 4 February 2025
Line 5:		Line 5:
	{{Note\|The sensitivity threshold can be adjusted through the '''player_teleport_alert''' setting, which accepts values between 5 and 500 (default: 100).}}		{{Note\|The sensitivity threshold can be adjusted through the '''player_teleport_alert''' setting, which accepts values between 5 and 500 (default: 100).}}

	==Parameters==		==Parameters==
	~~None~~		<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==

Imfelipedev at 01:34, 31 January 2025

2025-01-31T01:34:47Z

← Older revision		Revision as of 01:34, 31 January 2025
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==

Imfelipedev: /* Example */

2025-01-29T19:35:54Z

Example

← Older revision		Revision as of 19:35, 29 January 2025
Line 16:		Line 16:
	Canceling this event has no effect.		Canceling this event has no effect.

	==Example==		==Example==
	<syntaxhighlight lang="lua">		This example will disconnect the suspected player from the server and display a warning about the teleport.
	function ~~handlePlayerTeleportCheat~~()		<syntaxhighlight lang="lua">
	~~outputChatBox~~("~~Stop teleporting!~~", ~~source~~)		addEventHandler("onPlayerTeleport", root, function()
	end		kickPlayer(source, "AC", "You were disconnected from the server for attempting to teleport. If this was a mistake, please contact the administration.")
	~~addEventHandler("onPlayerTeleport", root, handlePlayerTeleportCheat~~)		end)
	~~</syntaxhighlight>~~

			</syntaxhighlight>
	{{See also/Server event\|Player events}}		{{See also/Server event\|Player events}}

Xenius: Created page with "NOTOC {{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.}} 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. The threshold can..."

2025-01-29T07:34:11Z

Created page with "__NOTOC__ {{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.}} 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. The threshold can..."

New page

__NOTOC__
{{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]].}}

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.

The threshold can be configured using ''player_teleport_alert'', which can be set between 5 and 500 (default: 100).

==Parameters==
None

==Source==
The [[event system#Event source|source]] of this event is the [[player]] who triggered the teleport detection.

===Canceling===
Canceling this event has no effect.

==Example==
<syntaxhighlight lang="lua">
function handlePlayerTeleportCheat()
outputChatBox("Stop teleporting!", source)
end
addEventHandler("onPlayerTeleport", root, handlePlayerTeleportCheat)
</syntaxhighlight>

{{See also/Server event|Player events}}