**Language / Langue :** **FR** | [[en:yaml:hud|EN]]

====== HUD — Encadrés persistants (YAML) ======

Les encadrés HUD (''encadre:'') permettent d'afficher des informations permanentes à l'écran du joueur : PV, score, mini-carte, compte à rebours, etc.

⚠ Les encadrés sont visibles sur **web et desktop uniquement**. Sur Discord et terminal, ils sont ignorés — si une information est essentielle, écrivez-la aussi dans le texte narratif.

===== Positions disponibles =====

8 positions :
  * ''haut'' · ''bas'' · ''gauche'' · ''droite''
  * ''haut-gauche'' · ''haut-droite'' · ''bas-gauche'' · ''bas-droite''

Les bandes (''haut'', ''bas''…) remplacent les coins correspondants si elles coexistent.

===== Syntaxe de base =====

<code yaml>
# Sur une salle : posé à l'entrée, persiste jusqu'au remplacement ou suppression
- id: salle_combat
  encadre:
    position: haut-droite
    texte: |
      ❤️ v_pv_v / v_pvmax_v PV
      ⭐ v_score_v pts

# Sur un événement ou un choix : mis à jour au moment du clic
evenements:
  - si: ~
    faire: "pv.-.3"
    bouton: "💥 Perdre 3 PV"
    texte: "Aïe !"
    encadre:
      position: haut-droite
      texte: |
        ❤️ v_pv_v / v_pvmax_v PV
        ⭐ v_score_v pts
</code>

===== Taille =====

^ Clé ^ Effet ^
| ''taille: 30'' | 30 % de la zone de jeu dans l'axe principal |
| ''largeur: 25'' | Largeur explicite en % |
| ''hauteur: 15'' | Hauteur explicite en % |

''largeur:'' et ''hauteur:'' sont indépendants — on peut en spécifier un seul.
Si aucun n'est précisé : valeur par défaut selon la position.

===== Style =====

<code yaml>
encadre:
  position: haut-droite
  taille: 38
  fond: "#1a1a2e"
  couleur-texte: "#e0e0ff"
  texte: "HUD stylisé"
</code>

===== Texte conditionnel =====

Le ''texte:'' d'un encadré accepte une liste de blocs conditionnels. Le moteur s'arrête au premier bloc vrai — **mettre le plus restrictif en premier** :

<code yaml>
encadre:
  position: haut-droite
  texte:
    - si: "v_pv_v <= 0"
      texte: "💀 MORT"
    - si: "v_pv_v <= 3"
      texte: "⚠️ CRITIQUE ! ❤️ v_pv_v"
    - texte: "❤️ v_pv_v / v_pvmax_v"  # fallback
</code>

===== Split : deux zones côte à côte =====

''[[split]]'' dans le texte divise l'encadré en deux zones. L'ordre dépend de la position :
  * ''gauche/droite'' → zone haut / zone bas
  * ''haut/bas'' → zone gauche / zone droite

<code yaml>
encadre:
  position: gauche
  largeur: 28
  texte: |
    🗺️ Zone actuelle
    demo_split
    [[split]]
    ❤️ v_pv_v PV
    ⭐ v_score_v pts
</code>

Les images ''[[url]]'' sont supportées dans les zones.

===== Plusieurs encadrés simultanés =====

<code yaml>
encadre:
  - position: haut-gauche
    texte: "❤️ v_pv_v PV"
  - position: haut-droite
    texte: "⭐ v_score_v pts"
  - position: bas-droite
    texte: "📍 Zone : v_zone_v"
</code>

===== Supprimer des encadrés =====

<code yaml>
# Sur un choix ou événement :
supprimer-encadre:
  - all          # supprime tous les encadrés
  # ou :
  - haut-droite  # supprime uniquement ce coin

# Sur une salle :
supprimer-encadre:
  - all
</code>

===== Vidéo dans un HUD =====

La syntaxe vidéo peut être utilisée dans le texte d'un encadré :

<code yaml>
encadre:
  position: haut
  texte:
    - "((loop;muted:https://exemple.com/video.mp4))"
</code>

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