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

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

Les choix définissent les boutons de navigation présentés au joueur.

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

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

  - commande: retour
    vers: accueil
</code>

  * ''commande:'' — mot-clé que le joueur peut taper (''j!avancer nord'')
  * ''bouton:'' — label affiché sur le bouton (si absent, pas de bouton visible)
  * ''vers:'' — salle de destination

===== Bouton défini sur la salle =====

Le label du bouton associé à une salle peut être défini dans la salle elle-même (plutôt que dans le choix) :

<code yaml>
- id: demo_timers
  bouton: "⏱️ Timers"    # label utilisé par tous les choix vers: demo_timers
  texte: "..."
</code>

Un choix vers cette salle sans ''bouton:'' utilisera automatiquement le bouton de la salle.

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

''vers: precedent'' permet de retourner à la salle d'où le joueur vient.
Cela active aussi l'affichage du bouton permanent ''precedent'' dans ''options:'' :

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

===== Conditions d'accès =====

<code yaml>
choix:
  - commande: entrer
    bouton: "🚪 Entrer dans la salle"
    vers: salle_secrete
    si: "cle v_score_v > 10"
</code>

Le champ ''si:'' fonctionne comme pour les événements — objets, variables, opérateurs.

===== Boutons conditionnels (visible-si / grise-si) =====

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

  - commande: affaibli
    bouton: "💀 Avancer (grisé si PV = 0)"
    vers: salle_suivante
    grise-si: "v_pv_v <= 0"        # visible mais inactif si PV = 0
</code>

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

''effet:'' exécute une action **avant** le déplacement vers la salle de destination :

<code yaml>
choix:
  - commande: acheter
    bouton: "🪙 Acheter (-10 pièces)"
    vers: boutique
    effet: "or.-.10"     # déduit 10 pièces AVANT d'entrer en boutique
    si: "v_or_v >= 10"
</code>

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

<code yaml>
choix:
  - commande: retour
    bouton: "↩️ Retour (ferme le HUD)"
    vers: accueil
    supprimer-encadre:
      - all                    # supprime tous les HUD actifs
      # ou : - haut-droite     # supprime uniquement ce coin
</code>

===== Choix sans bouton ni commande =====

Un choix sans ''commande:'' ni ''bouton:'' est accessible uniquement par l'id de la salle :

<code yaml>
choix:
  - vers: aide   # accessible par "avancer aide" uniquement — aucun bouton affiché
</code>

===== Alias globaux =====

Les ''alias_globaux:'' définissent des labels réutilisables dans tous les choix :

<code yaml>
alias_globaux:
  retour: "🏠 Accueil"
</code>

Dans n'importe quelle salle, un choix avec ''commande: retour'' vers ''accueil'' affichera automatiquement le bouton "🏠 Accueil" sans avoir à répéter ''bouton:'' partout.

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