**Language / Langue :** **FR** | [[en:editeur:timers-hud|EN]]

====== Éditeur graphique - Timers et HUD ======

===== Timers =====

Les timers se configurent dans l'inspecteur d'une salle (section Événements, action ''timer:'') ou dans le Panneau Globaux (Timers globaux).

**Champs d'un timer global :**

^ Champ ^ Rôle ^
| ''id'' | Identifiant unique du timer |
| ''duree'' | Durée en secondes |
| ''etat'' | État initial : ''ON'' ou ''OFF'' |
| ''faire'' | Actions exécutées quand le timer arrive à zéro |
| ''texte'' | Message affiché quand le timer arrive à zéro |
| ''tick'' | Actions exécutées chaque seconde (optionnel) |

**Actions à l'expiration et au tick** : même syntaxe que ''faire:'', par exemple ''score.+.1'', un identifiant de salle ou ''declencher_event:id''.

Pour **démarrer ou arrêter un timer global** depuis un événement ou un choix, utilisez l'action :

<code yaml>
faire: "timer_global:nom_timer:ON"       # ON, OFF ou SWITCH
</code>

Un **timer local** s'annule tout seul quand le joueur quitte la salle. Un **timer global** se met en pause avec ''OFF'', qui conserve le temps restant.

===== HUD (encadrés persistants) =====

Le HUD permet d'afficher des informations permanentes à l'écran du joueur (points de vie, score, mini-carte, etc.). Il est configuré via ''encadre:'' dans les événements.

**8 positions disponibles :**

  * ''haut'' - bandeau haut
  * ''bas'' - bandeau bas
  * ''gauche'' - bord gauche
  * ''droite'' - bord droite
  * ''haut-gauche'', ''haut-droite'' - coins haut
  * ''bas-gauche'', ''bas-droite'' - coins bas

**Configurer un encadré depuis l'éditeur :**

Dans l'inspecteur, section Événements, action ''encadre:'' :

^ Champ ^ Rôle ^
| ''position'' | Une des 8 positions ci-dessus |
| ''texte'' | Contenu, avec variables ''v_nom_v'' et séparation ''%%[[split]]%%'' |
| ''taille'', ''largeur'', ''hauteur'' | Dimensions optionnelles |
| ''fond'', ''couleur-texte'', ''police'' | Apparence optionnelle |
| ''redimensionnable'' | Autoriser le joueur à redimensionner l'encadré |

L'encadré est mis à jour à chaque fois que l'événement qui le définit est exécuté. Placez la condition ''si:'' ou ''visible-si:'' sur cet événement lorsque l'encadré doit être conditionnel. Pour un HUD dynamique, placez la mise à jour dans un événement global ou dans un timer tick.