Skip to content
heliana docs

Create an event trigger

An event trigger runs automatically every time a matching game event occurs — no button required. heliana watches the Squad server log in real time and fires the trigger when the event and any conditions you set are met.

See all available event types in the Event types reference.

Steps

Section titled “Steps”
  1. Navigate to your server, then open the Triggers tab.
  2. Click New trigger. An empty trigger builder opens.
  3. Set Type to Event.
  4. In the Name field, enter a descriptive name.
  5. Under Enabled, leave the switch On to run the trigger immediately, or switch it Off to save it disabled.
  6. Under When, select the event that should fire this trigger:
    • Chat — any player chat message
    • Join / Leave — a player connecting or disconnecting
    • Teamkill / Death / Ban
    • Broadcast — an admin broadcast
    • Map — map change / Round — round ended
  7. Under If, add conditions to filter which events actually run the actions. Leave it empty to run on every occurrence of the selected event. See Build conditions.
  8. Under Rate limit, set a cooldown or threshold to keep the trigger from firing too often. See Rate-limit a trigger.
  9. Under Then, add the action(s) that run when the trigger fires. Click Add action to add more. See Trigger actions reference.
  10. Under Servers, choose All servers or restrict the trigger to a specific server.
  11. Click Save.

Start from a ready-made trigger instead

Section titled “Start from a ready-made trigger instead”

A new organization already has a set of common triggers seeded for you — they show up in the table switched Off. Several are event triggers, including Teamkill autoban, Flag on first join, Playtime command (!time), and Discord log. Instead of building from scratch, open one that fits, switch it On, and edit it. See Trigger templates.

Edit or delete a trigger

Section titled “Edit or delete a trigger”

To edit a trigger, find it in the table and click Edit (the pencil icon). The builder reopens with the current settings. The Type can’t be changed after creation. To delete the trigger, open it with Edit, click Delete at the bottom of the form, and confirm.

See also

Section titled “See also”