Outils pour utilisateurs

Outils du site


fr:yaml:hud

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 · droite
  • haut-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 bas
  • haut/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

fr/yaml/hud.txt · Dernière modification : de cyrilfiesta