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

====== Événements globaux, alias globaux, actions globales (YAML) ======

===== evenements_globaux: =====

Les événements globaux s'exécutent dans **toutes les salles** (après les événements locaux par défaut). Ils sont **OFF par défaut** et doivent être activés.

<code yaml>
evenements_globaux:
  - id: bonus_visite
    etat: OFF        # OFF par défaut — activé via event_global:bonus_visite:ON
    si: ~
    faire: "score.+.1"
    texte: "✨ Bonus visite : +1 score !"

  - id: soin_urgence
    etat: OFF
    si: "v_pv_v < 5"  # condition supplémentaire
    faire: "pv.+.2"
    texte: "🚑 Soin d'urgence ! +2 PV"
</code>

Activation depuis n'importe quel événement ou choix :
<code yaml>
faire: "event_global:bonus_visite:ON"
faire: "event_global:bonus_visite:OFF"
faire: "event_global:bonus_visite:SWITCH"  # inverse l'état
</code>

Ou via ''declencher_event:id'' pour déclencher directement (sans passer par ON/OFF) :
<code yaml>
faire: "declencher_event:bonus_visite"
</code>

===== Boutons sur les événements globaux =====

Un événement global peut avoir un bouton — il apparaît dans **toutes les salles** :

<code yaml>
evenements_globaux:
  - id: appel_aide
    etat: ON
    si: ~
    bouton: "🆘 Appeler à l'aide"
    visible-si: "v_pv_v < 5"    # masqué si PV suffisants
    faire: "pv.+.3"
    texte: "Un allié surgit ! +3 PV"
</code>

Les mêmes clés que les événements locaux sont supportées : ''bouton:'', ''visible-si:'', ''grise-si:'', ''max:'', ''texte: liste''.

===== Événement global lié à un timer =====

Un événement global peut être déclenché à l'expiration d'un timer global :

<code yaml>
evenements_globaux:
  - id: alarme
    etat: OFF
    si: "v_comptebombe_v = 0"
    faire:
      - "event_global:alarme:OFF"
      - "score.+.10"
    vers: fin_defaite
    texte: "💥 BOOM ! La bombe a explosé !"
</code>

===== alias_globaux: =====

Les alias globaux définissent des labels réutilisables dans tous les choix :

<code yaml>
alias_globaux:
  retour: "🏠 Accueil"
  aide: "❓ Aide"
</code>

Dans n'importe quelle salle, un choix ''commande: retour'' vers ''accueil'' affichera automatiquement le bouton "🏠 Accueil" — sans répéter ''bouton:'' dans chaque salle.

===== actions_globales: =====

Les actions globales sont des [[fr:yaml:actions|actions personnalisées]] disponibles dans **toutes les salles** :

<code yaml>
actions_globales:
  # Navigation libre : taper "aller destination"
  - verbe: aller
    cible: all
    si: ~
    faire: "t_action_cible_ok_t"
    texte_ko: "Destination «t_action_cible_t» inconnue."

  # Afficher le score depuis n'importe où
  - verbe: score
    cible: all
    si: ~
    texte_ok: "⭐ Score : v_score_v | Record : v_record_o_v"
</code>

Les actions locales (dans une salle) sont testées avant les globales.

===== 997_globaux: (ordre d'exécution) =====

Par défaut, les événements globaux s'exécutent **après** les locaux :

<code yaml>
997_globaux: avant   # pour les exécuter avant les événements locaux
</code>

**Retrouvez nous sur le [[https://discord.gg/Z63DtVV|discord Make&Play]]**