OnPlayerTriggerEventThreshold: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
m (Update version)
 
(One intermediate revision 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|22311|This event is triggered when a player exceeds the maximum threshold for events via [[triggerServerEvent]].}}
{{Added feature/item|1.6.1|1.6.0|22313|This event is triggered when a player exceeds the maximum threshold for events via [[triggerServerEvent]].}}


During each interval (''player_triggered_event_interval''), all usage of [[triggerServerEvent]] will be counted for each player. This includes registered events, non-registered events and non-remote events.
During each interval (''player_triggered_event_interval''), all usage of [[triggerServerEvent]] will be counted for each player. This includes registered events, non-registered events and non-remote events.
Line 20: Line 20:
==Example==
==Example==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function start()
    setServerConfigSetting("player_triggered_event_interval", "500") -- set event usage interval to 500ms (default is 1000)
    setServerConfigSetting("max_player_triggered_events_per_interval", "50") -- set max events per interval to 50 (default is 100)
end
addEventHandler("onResourceStart", resourceRoot, start)
function processPlayerTriggerEventThreshold()
function processPlayerTriggerEventThreshold()
     kickPlayer(source, "Event spam")
     kickPlayer(source, "Event spam")

Latest revision as of 19:20, 28 November 2023

BETA: NEW FEATURE (BUILD: 1.6.0 r22313)
This event is triggered when a player exceeds the maximum threshold for events via triggerServerEvent.

During each interval (player_triggered_event_interval), all usage of triggerServerEvent will be counted for each player. This includes registered events, non-registered events and non-remote events.

If the count exceeds max_player_triggered_events_per_interval, this event will be fired. The count is reset each interval.

You can set these options via setServerConfigSetting.

Parameters

None

Source

The source of this event is the player who exceeded the threshold.

Canceling

Canceling this event has no effect.

Example

function processPlayerTriggerEventThreshold()
    kickPlayer(source, "Event spam")
end
addEventHandler("onPlayerTriggerEventThreshold", root, processPlayerTriggerEventThreshold)

See Also

Player events


Event functions