Différences

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

--- fr:yaml:choix [2026/05/03 17:01] – Choix et boutons YAML cyrilfiesta
+++ fr:yaml:choix [2026/05/03 21:16] (Version actuelle) – mise a jour wiki cyrilfiesta
@@ Ligne 1: / Ligne 1: @@
-====== Syntaxe YAML — Choix et boutons ======
+**Language / Langue :** **FR** | [[en:yaml:choix|EN]]
-Les choix permettent au joueur de naviguer entre les salles via des boutons.
+====== Choix et boutons (YAML) ======
-===== Structure d'un choix =====
+Les choix définissent les boutons de navigation présentés au joueur.
+===== Syntaxe de base =====
 <code yaml>
 choix:
-  - commande: aller_nord
+  - commande: nord
     bouton: "⬆️ Aller au nord"
-    vers: salle_nord
+    vers: foret
-    si: "~"
+  - commande: retour
+    vers: accueil
 </code>
-===== Champs disponibles =====
+  * ''commande:'' — mot-clé que le joueur peut taper (commande ''avancer nord'')
+  * ''bouton:'' — label affiché sur le bouton (si absent, pas de bouton visible)
+  * ''vers:'' — salle de destination
-^ Champ ^ Description ^ Obligatoire ^
+===== Bouton défini sur la salle =====
-| ''commande:'' | Identifiant de la commande | ✅ |
-| ''bouton:'' | Texte affiché sur le bouton | ✅ |
-| ''vers:'' | Salle de destination | ✅ |
-| ''si:'' | Condition d'accès | ✅ (mettre ''~'' si aucune) |
-| ''texte_ko:'' | Message si condition non remplie | non |
-| ''grise-si:'' | Grise le bouton si condition vraie | non |
-| ''visible-si:'' | Affiche le bouton uniquement si condition vraie | non |
-| ''effet:'' | Action déclenchée avant le déplacement | non |
-===== Exemple complet =====
+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 tour"
+    bouton: "🚪 Entrer dans la salle"
-    vers: tour_interieur
+    vers: salle_secrete
-    si: "o_cle_tour_o"
+    si: "cle v_score_v > 10"
-    texte_ko: "La porte est verrouillée. Il vous faut une clé."
+</code>
-    grise-si: "!o_cle_tour_o"
-  - commande: partir
+Le champ ''si:'' fonctionne comme pour les événements — objets, variables, opérateurs.
-    bouton: "↩️ Repartir"
-    vers: carrefour
-    si: "~"
-  - commande: attaquer
+===== Boutons conditionnels (visible-si / grise-si) =====
-    bouton: "⚔️ Attaquer le garde"
-    vers: combat_garde
+<code yaml>
-    si: "v_armee_v >= 10"
+choix:
-    texte_ko: "Vous n'êtes pas assez fort."
+  - commande: expert
-    visible-si: "v_armee_v >= 5"
+    bouton: "🏆 Mode expert (score > 50)"
-    effet: "reput.-.10"
+    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 avant déplacement =====
+===== Effet au clic (effet:) =====
-''effet:'' s'exécute **avant** le déplacement vers la salle cible.
+''effet:'' exécute une action **avant** le déplacement vers la salle de destination :
-Si ''effet:'' contient un ''vers:'', le déplacement principal est annulé.
 <code yaml>
-- commande: fuir
+choix:
-  bouton: "🏃 Fuir le combat"
+  - commande: acheter
-  vers: couloir
+    bouton: "🪙 Acheter (-10 pièces)"
-  si: "~"
+    vers: boutique
-  effet:
+    effet: "or.-.10"     # déduit 10 pièces AVANT d'entrer en boutique
-    - "reput.-.5"
+    si: "v_or_v >= 10"
-    - "o-bouclier"
 </code>
-===== Voir aussi =====
+===== 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>
-  * [[fr:yaml:conditions|Conditions]]
+Dans n'importe quelle salle, un choix avec ''commande: retour'' vers ''accueil'' affichera automatiquement le bouton "🏠 Accueil" sans avoir à répéter ''bouton:'' partout.
-  * [[fr:yaml:actions|Actions personnalisées]]
+**Retrouvez nous sur le [[https://discord.gg/Z63DtVV|discord Make&Play]]**