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

====== Choix et boutons (YAML) ======

Les choix définissent les sorties disponibles depuis une salle — navigation, conditions d'accès et boutons affichés au joueur.

===== Syntaxe minimale =====

La forme la plus simple : une destination, rien d'autre.

<code yaml>
choix:
  - vers: foret
  - vers: village
</code>

La salle ''foret'' est accessible en tapant ''avancer foret''. Aucun bouton n'est affiché.

===== Ajouter un bouton =====

''bouton:'' affiche un bouton cliquable sous le texte de la salle.

<code yaml>
choix:
  - bouton: "⬆️ Aller au nord"
    vers: foret

  - bouton: "🏠 Retour au village"
    vers: village
</code>

===== Commande textuelle =====

''commande:'' définit le mot-clé que le joueur peut taper (en plus du bouton).

<code yaml>
choix:
  - commande: nord
    bouton: "⬆️ Aller au nord"
    vers: foret
</code>

Le joueur peut cliquer le bouton **ou** taper ''avancer nord''.
Sans ''commande:'', seul ''avancer foret'' (l'id de la salle) fonctionne.

Voir [[fr:yaml:alias|Alias et commandes]] pour les raccourcis globaux et les alias d'action.

===== Bouton hérité de la salle =====

Si la salle de destination possède un ''bouton:'', les choix qui pointent vers elle sans ''bouton:'' propre héritent de ce label automatiquement.

<code yaml>
salles:
  - id: laboratoire
    bouton: "⚗️ Laboratoire"
    texte: "..."

  - id: couloir
    choix:
      - vers: laboratoire   # affiche "⚗️ Laboratoire" sans le répéter ici
</code>

===== vers: precedent =====

''vers: precedent'' retourne à la salle d'où le joueur vient.

<code yaml>
choix:
  - commande: retour
    bouton: "↩️ Retour"
    vers: precedent
</code>

===== Condition d'accès (si:) =====

''si:'' bloque l'accès si la condition n'est pas remplie. Le joueur voit le texte ''texte_ko:'' en retour.

<code yaml>
choix:
  - commande: entrer
    bouton: "🚪 Entrer"
    vers: salle_secrete
    si: "cle"
    texte_ko: "La porte est verrouillée."
    texte_ok: "Vous entrez dans la salle secrète."
</code>

  * ''texte_ko:'' — affiché si la condition échoue (accès refusé)
  * ''texte_ok:'' — affiché si la condition réussit, avant le déplacement

Sans condition, ''texte_ok:'' et ''texte_ko:'' ne sont pas utilisés.

===== Bouton conditionnel (visible-si / grise-si) =====

<code yaml>
choix:
  - commande: expert
    bouton: "🏆 Mode expert"
    vers: salle_expert
    visible-si: "v_score_v > 50"    # bouton masqué si score <= 50

  - commande: avancer
    bouton: "💀 Avancer"
    vers: salle_suivante
    grise-si: "v_pv_v <= 0"         # bouton visible mais inactif si PV = 0
</code>

  * ''visible-si:'' — le bouton n'apparaît pas si la condition est fausse
  * ''grise-si:'' — le bouton reste visible mais ne peut pas être cliqué

===== Effet au clic (effet:) =====

''effet:'' exécute une action **avant** le déplacement.

<code yaml>
choix:
  - commande: acheter
    bouton: "🪙 Acheter (-10 pièces)"
    vers: boutique
    si: "v_or_v >= 10"
    effet: "or.-.10"
</code>

===== Supprimer des encadrés au clic =====

<code yaml>
choix:
  - commande: retour
    bouton: "↩️ Retour"
    vers: accueil
    supprimer-encadre:
      - all           # supprime tous les HUD actifs
</code>

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