Différences

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

--- fr:yaml:choix [2026/05/03 18:47] – Harmonize FR/EN language switch cyrilfiesta
+++ fr:yaml:choix [2026/05/03 23:59] (Version actuelle) – mise a jour wiki cyrilfiesta
@@ Ligne 3: / Ligne 3: @@
 ====== Choix et boutons (YAML) ======
-Les choix définissent les boutons de navigation présentés au joueur.
+Les choix définissent les sorties disponibles depuis une salle — navigation, conditions d'accès et boutons affichés au joueur.
-===== Syntaxe de base =====
+===== 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>
@@ Ligne 12: / Ligne 39: @@
     bouton: "⬆️ Aller au nord"
     vers: foret
-  - commande: retour
-    vers: accueil
 </code>
-  * ''commande:'' — mot-clé que le joueur peut taper (''j!avancer nord'')
+Le joueur peut cliquer le bouton **ou** taper ''avancer nord''.
-  * ''bouton:'' — label affiché sur le bouton (si absent, pas de bouton visible)
+Sans ''commande:'', seul ''avancer foret'' (l'id de la salle) fonctionne.
-  * ''vers:'' — salle de destination
-===== Bouton défini sur la salle =====
+Voir [[fr:yaml:alias|Alias et commandes]] pour les raccourcis globaux et les alias d'action.
-Le label du bouton associé à une salle peut être défini dans la salle elle-même (plutôt que dans le choix) :
+===== 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>
-- id: demo_timers
+salles:
-  bouton: "⏱️ Timers"    # label utilisé par tous les choix vers: demo_timers
+  - id: laboratoire
-  texte: "..."
+    bouton: "⚗️ Laboratoire"
-</code>
+    texte: "..."
-Un choix vers cette salle sans ''bouton:'' utilisera automatiquement le bouton de la salle.
+  - id: couloir
+    choix:
+      - vers: laboratoire   # affiche "⚗️ Laboratoire" sans le répéter ici
+</code>
 ===== vers: precedent =====
-''vers: precedent'' permet de retourner à la salle d'où le joueur vient.
+''vers: precedent'' retourne à la salle d'où le joueur vient.
-Cela active aussi l'affichage du bouton permanent ''precedent'' dans ''options:'' :
 <code yaml>
@@ Ligne 45: / Ligne 72: @@
 </code>
-===== Conditions d'accès =====
+===== 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 dans la salle"
+    bouton: "🚪 Entrer"
     vers: salle_secrete
-    si: "cle v_score_v > 10"
+    si: "cle"
+    texte_ko: "La porte est verrouillée."
+    texte_ok: "Vous entrez dans la salle secrète."
 </code>
-Le champ ''si:'' fonctionne comme pour les événements — objets, variables, opérateurs.
+  * ''texte_ko:'' — affiché si la condition échoue (accès refusé)
+  * ''texte_ok:'' — affiché si la condition réussit, avant le déplacement
-===== Boutons conditionnels (visible-si / grise-si) =====
+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 (score > 50)"
+    bouton: "🏆 Mode expert"
     vers: salle_expert
-    visible-si: "v_score_v > 50"   # masqué si score <= 50
+    visible-si: "v_score_v > 50"    # bouton masqué si score <= 50
-  - commande: affaibli
+  - commande: avancer
-    bouton: "💀 Avancer (grisé si PV = 0)"
+    bouton: "💀 Avancer"
     vers: salle_suivante
-    grise-si: "v_pv_v <= 0"        # visible mais inactif si PV = 0
+    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 vers la salle de destination :
+''effet:'' exécute une action **avant** le déplacement.
 <code yaml>
@@ Ligne 81: / Ligne 118: @@
     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"
+    effet: "or.-.10"
 </code>
@@ Ligne 90: / Ligne 127: @@
 choix:
   - commande: retour
-    bouton: "↩️ Retour (ferme le HUD)"
+    bouton: "↩️ Retour"
     vers: accueil
     supprimer-encadre:
-      - all                    # supprime tous les HUD actifs
+      - all           # supprime tous les HUD actifs
-      # ou : - haut-droite     # supprime uniquement ce coin
 </code>
-===== Choix sans bouton ni commande =====
+**Retrouvez nous sur le [[https://discord.gg/Z63DtVV|discord Make&Play]]**
-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]]**