**Language / Langue :** [[fr:yaml:evenements-globaux|FR]] | **EN**

====== Global Events, Global Aliases and Global Actions (YAML) ======

===== global_events: =====

Global events can run in every room. They are OFF by default unless ''state: ON'' is set.

<code yaml>
global_events:
  - id: visit_bonus
    state: OFF
    if: ~
    do: "score.+.1"
    text: "Visit bonus: +1 score!"
</code>

Enable or disable them from any event or choice:

<code yaml>
do: "event_global:visit_bonus:ON"
do: "event_global:visit_bonus:OFF"
do: "event_global:visit_bonus:SWITCH"
</code>

Trigger directly:

<code yaml>
do: "trigger_event:visit_bonus"
</code>

===== Global Event Buttons =====

<code yaml>
global_events:
  - id: call_help
    state: ON
    if: ~
    button: "Call for help"
    visible-if: "v_hp_v < 5"
    do: "hp.+.3"
    text: "An ally appears! +3 HP."
</code>

===== Global event tied to a timer =====

A global event can be fired when a global timer runs out:

<code yaml>
global_events:
  - id: alarm
    state: OFF
    if: "v_bombcount_v = 0"
    do:
      - "event_global:alarm:OFF"
      - "score.+.10"
    to: fin_defaite
    text: "💥 BOOM! The bomb went off!"
</code>

See [[en:yaml:timers|Timers]] for how a global timer is declared and switched.


===== global_aliases: =====

<code yaml>
global_aliases:
  back: "Home"
  help: "Help"
</code>

Any choice with ''command: back'' can reuse this label without repeating ''button:''.

===== global_actions: =====

<code yaml>
global_actions:
  - verb: go
    target: all
    if: ~
    do: "t_action_cible_ok_t"
    text_ko: "Unknown destination: t_action_cible_t."
</code>

===== global_events_order: =====

<code yaml>
global_events_order: before
</code>

Accepted values are ''before'' and ''after''. Default is ''after''.