Différences

Ci-dessous, les différences entre deux révisions de la page.

--- fr:yaml:hud [2026/05/03 17:01] – HUD / Encadrés YAML cyrilfiesta
+++ fr:yaml:hud [2026/05/03 18:49] (Version actuelle) – Restore accents after HUD video footnote fix cyrilfiesta
@@ Ligne 1: / Ligne 1: @@
-====== Syntaxe YAML — HUD / Encadrés persistants ======
+**Language / Langue :** **FR** | [[en:yaml:hud|EN]]
-Les encadrés HUD (''encadre:'') affichent des informations persistantes en overlay — stats, timer, mini-carte, portrait de personnage...
+====== 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 =====
+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>
-- id: ma_salle
+# Sur une salle : posé à l'entrée, persiste jusqu'au remplacement ou suppression
-  texte: "..."
+- id: salle_combat
   encadre:
-    position: haut
+    position: haut-droite
-    texte: "⚔️ PV : v_pv_v / 20  |  💰 Or : v_or_v"
+    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>
-L'encadré reste affiché jusqu'à sa suppression explicite, même en changeant de salle.
+===== Taille =====
-===== Positions disponibles =====
+^ Clé ^ Effet ^
+| ''taille: 30'' | 30 % de la zone de jeu dans l'axe principal |
+| ''largeur: 25'' | Largeur explicite en % |
+| ''hauteur: 15'' | Hauteur explicite en % |
-^ Position ^ Description ^
+''largeur:'' et ''hauteur:'' sont indépendants — on peut en spécifier un seul.
-| ''haut'' | Bande en haut de l'écran |
+Si aucun n'est précisé : valeur par défaut selon la position.
-| ''bas'' | Bande en bas de l'écran |
-| ''gauche'' | Panneau latéral gauche |
-| ''droite'' | Panneau latéral droit |
-| ''haut-gauche'' | Coin haut gauche |
-| ''haut-droite'' | Coin haut droit |
-| ''bas-gauche'' | Coin bas gauche |
-| ''bas-droite'' | Coin bas droit |
-===== Personnalisation =====
+===== Style =====
 <code yaml>
 encadre:
-  position: haut
+  position: haut-droite
-  taille: 12           # hauteur en % pour bandes, largeur pour panneaux
+  taille: 38
-  largeur: 80          # largeur en % (indépendant)
+  fond: "#1a1a2e"
-  hauteur: 15          # hauteur en % (indépendant)
+  couleur-texte: "#e0e0ff"
-  fond: "#1a1a2e"      # couleur de fond CSS
+  texte: "HUD stylisé"
-  couleur-texte: "#c9a84c"
-  texte:
-    - texte: "⚔️ Tour v_tour_v/30  •  🏰 v_peuple_v  💰 v_or_v"
-      taille: 14
-      police: serif
 </code>
-===== Contenu riche =====
+===== 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-gauche
+  position: haut-droite
-  texte: |
+  texte:
-    [[https://monsite.fr/portrait.png]]
+    - si: "v_pv_v <= 0"
-    **Héros**
+      texte: "💀 MORT"
-    PV : v_pv_v/v_pv_max_v
+    - 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 : 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: haut
+  position: gauche
+  largeur: 28
   texte: |
-    Score : v_score_v
+    🗺️ Zone actuelle
+    demo_split
     [[split]]
-    ⏱️ v_timer_v|pad2 s
+    ❤️ v_pv_v PV
+    ⭐ v_score_v pts
 </code>
-''[[split]]'' divise l'encadré en deux zones indépendantes.
+Les images ''[[url]]'' sont supportées dans les zones.
-===== Texte conditionnel dans le HUD =====
+===== Plusieurs encadrés simultanés =====
 <code yaml>
 encadre:
-  position: haut
+  - position: haut-gauche
-  texte:
+    texte: "❤️ v_pv_v PV"
-    - texte: "🔴 DANGER — PV : v_pv_v"
+  - position: haut-droite
-      si: "v_pv_v <= 5"
+    texte: "⭐ v_score_v pts"
-    - texte: "🟡 PV : v_pv_v"
+  - position: bas-droite
-      si: "v_pv_v <= 10"
+    texte: "📍 Zone : v_zone_v"
-    - texte: "🟢 PV : v_pv_v"
-      si: "~"
 </code>
-===== Supprimer un encadré =====
+===== Supprimer des encadrés =====
 <code yaml>
-evenements:
+# Sur un choix ou événement :
-  - si: "~"
+supprimer-encadre:
-    faire: "supprimer-encadre:haut"
+  - all          # supprime tous les encadrés
-    # ou plusieurs :
+  # ou :
-    faire:
+  - haut-droite  # supprime uniquement ce coin
-      - "supprimer-encadre:haut"
-      - "supprimer-encadre:haut-gauche"
+# Sur une salle :
+supprimer-encadre:
+  - all
 </code>
-===== Voir aussi =====
+===== Vidéo dans un HUD =====
-  * [[fr:yaml:timers|Timers dans le HUD]]
+La syntaxe vidéo peut être utilisée dans le texte d'un encadré :
-  * [[fr:yaml:texte|Texte conditionnel]]
+<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]]**