OnPlayerTriggerEventThreshold: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
 
(4 intermediate revisions by 2 users 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 10: Line 10:


==Parameters==
==Parameters==
None
{{New feature/item|3.0161|1.6.0|23281|'''eventName:''' the name of last called event.}}


==Source==
==Source==
Line 20: Line 20:
==Example==
==Example==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function start()
function processPlayerTriggerEventThreshold(eventName)
    setServerConfigSetting("player_triggered_event_interval", "500") -- set event usage interval to 500ms (default is 1000)
     kickPlayer(source, "Event spam | Event name: " .. eventName)
    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
end
addEventHandler("onPlayerTriggerEventThreshold", root, processPlayerTriggerEventThreshold)
addEventHandler("onPlayerTriggerEventThreshold", root, processPlayerTriggerEventThreshold)

Latest revision as of 13:52, 24 August 2025

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

ADDED/UPDATED IN VERSION 1.6.0 r23281:
eventName: the name of last called event.

Source

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

Canceling

Canceling this event has no effect.

Example

function processPlayerTriggerEventThreshold(eventName)
    kickPlayer(source, "Event spam | Event name: " .. eventName)
end
addEventHandler("onPlayerTriggerEventThreshold", root, processPlayerTriggerEventThreshold)

See Also

Player events


Event functions


Retrieved from "https://wiki.multitheftauto.com/wiki/OnPlayerTriggerEventThreshold?oldid=82415"