OnPlayerTriggerEventThreshold: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "__NOTOC__ {{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.}} ==Parameters== None ==Source== The source of this event is the player who exceeded the threshold. ===Canceling=== Canceling this event has no effect. ==Example== <syntaxhighlight lang="lua"> function start() setServerConfigSetting("player_triggered_event_inte...")
 
No edit summary
Line 2: Line 2:
{{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|22311|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==
==Parameters==
None
None

Revision as of 13:55, 27 November 2023

BETA: NEW FEATURE (BUILD: 1.6.0 r22311)
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 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()
    kickPlayer(source, "Event spam")
end
addEventHandler("onPlayerTriggerEventThreshold", root, processPlayerTriggerEventThreshold)

See Also

Player events


Event functions