Table des matières
Language / Langue : FR | 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·droitehaut-gauche·haut-droite·bas-gauche·bas-droite
Les bandes (haut, bas…) remplacent les coins correspondants si elles coexistent.
Syntaxe de base
# 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
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
encadre: position: haut-droite taille: 38 fond: "#1a1a2e" couleur-texte: "#e0e0ff" texte: "HUD stylisé"
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 :
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
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 bashaut/bas→ zone gauche / zone droite
encadre: position: gauche largeur: 28 texte: | 🗺️ Zone actuelle demo_split [[split]] ❤️ v_pv_v PV ⭐ v_score_v pts
Les images url sont supportées dans les zones.
Plusieurs encadrés simultanés
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"
Supprimer des encadrés
# 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
Vidéo dans un HUD
La syntaxe vidéo peut être utilisée dans le texte d'un encadré :
encadre: position: haut texte: - "((loop;muted:https://exemple.com/video.mp4))"
Retrouvez nous sur le discord Make&Play
