Skip to content

Event Handlers

Event handlers run a script when a server event fires. Each handler binds an event to a script, with a priority, a timeout, an enabled flag, and an option to run asynchronously. Disabled handlers are kept but never run.

Event handlers are a license gated feature. If your license does not include scripting, the page shows a locked notice in place of the list and the Save action is hidden.

Create a script first

Event handlers need a script to run. You must create at least one script on the Scripts page before you can add a handler. Until a script exists, the page shows the message Create a script first; event handlers need one to run, and the Add handler button is disabled.

Add a handler

Click Add handler to append a new handler to the list. When no handlers are configured, the page shows No event handlers configured.

Each handler exposes the following fields:

  • Event: the server event that triggers the handler. The list is filterable.
  • Script: the script to run when the event fires. The list is filterable; the placeholder reads Select a script.
  • Priority: the order in which handlers run, within the context of its associated event handler, starting at 0. Multiple scripts can have the same priority, if they are associated to different event-handlers.
  • Timeout (s): the maximum time in seconds the script is allowed to run.
  • Enabled: when checked, the handler is active. When unchecked, the handler is kept but never runs.
  • Run asynchronously: when checked, the script runs without blocking the event.

A single handler showing event, script, priority, timeout, and the flags

After you change handlers, click Save to persist the whole set.

Remove a handler

Use the trash icon on a handler to remove it from the list. Remember to Save so the removal is persisted.

Disabled handlers

Clearing the Enabled checkbox keeps the handler in the list but stops it from running. This is useful for temporarily turning off automation without losing the configuration.

Per user event handlers

The handlers on this page are server wide. Individual users can also have their own event handlers, defined on the Event handlers tab of the user editor. See the Users page for details on per user automation.