Multi Theft Auto: Wiki - User contributions [en]

OnPlayerTeleport

2025-02-16T20:04:56Z

Imfelipedev:

__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 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==
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==
This example logs unexpected teleportation events.
<syntaxhighlight lang="lua">
addEventHandler("onPlayerTeleport", root, function()
outputServerLog("Player "..getPlayerName(source).." teleported unexpectedly. Possible hack detected.")
end)

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

OnPlayerTeleport

2025-02-16T20:00:16Z

Imfelipedev:

__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 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==
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==
This example will disconnect the suspected player from the server and display a warning about the teleport.
<syntaxhighlight lang="lua">
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)

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

OnPlayerTeleport

2025-02-04T23:33:09Z

Imfelipedev:

__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 direct server intervention, such as the use of [[setElementPosition]] or [[spawnPlayer]].}}
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).}}

==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==
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==
This example will disconnect the suspected player from the server and display a warning about the teleport.
<syntaxhighlight lang="lua">
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)

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

OnPlayerTeleport

2025-02-04T23:28:31Z

Imfelipedev: /* Parameters */

__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 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.
{{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==
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==
This example will disconnect the suspected player from the server and display a warning about the teleport.
<syntaxhighlight lang="lua">
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)

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

OnPlayerTeleport

2025-01-31T01:34:47Z

Imfelipedev:

OnPlayerTeleport

2025-01-29T19:35:54Z

Imfelipedev: /* Example */

__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==
This example will disconnect the suspected player from the server and display a warning about the teleport.
<syntaxhighlight lang="lua">
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)

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

OnPlayerChangesProtectedData

2025-01-29T19:35:17Z

Imfelipedev:

__NOTOC__
{{Server event}}
{{Added feature/item|1.6.1|1.6.0|22790|This event is triggered when a player tries to change protected element data. The server protects element data with using [[Server_mtaserver.conf#elementdata_whitelisted|elementdata_whitelisted]] from '''mtaserver.conf''' and the '''clientChangesPolicy''' parameter in [[setElementData]].}}
==Parameters==
*'''element''': The affected element.
*'''key''': The name of the element data entry that has changed.
*'''value''': The value that the player sends.

==Source==
The [[event system#Event source|source]] of this event is the [[player]] who changes protected element data.

==Example==
The below example will ban all players who are trying to change protected element data.
<syntaxhighlight lang="lua">
function processPlayerElementDataHack()
addBan(source, "Element data hacking attempt")
end
addEventHandler("onPlayerChangesProtectedData", root, processPlayerElementDataHack)

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

OnPlayerChangesProtectedData

2025-01-29T19:34:42Z

Imfelipedev: /* Example */

__NOTOC__
{{Server event}}
{{Added feature/item|1.6.1|1.6.0|22790|This event is triggered when a player tries to change protected element data. The server protects element data with using [[Server_mtaserver.conf#elementdata_whitelisted|elementdata_whitelisted]] from '''mtaserver.conf''' and the '''clientChangesPolicy''' parameter in [[setElementData]].}}
==Parameters==
*'''element''': The affected element.
*'''key''': The name of the element data entry that has changed.
*'''value''': The value that the player sends.

==Source==
The [[event system#Event source|source]] of this event is the [[player]] who changes protected element data.

==Example==
This example will disconnect the suspected player from the server and display a warning about the teleport.
<syntaxhighlight lang="lua">
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)

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