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 23:59] (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 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: aller_nord
+  - commande: nord
     bouton: "⬆️ Aller au nord"
-    vers: salle_nord
+    vers: foret
-    si: "~"
 </code>
-===== Champs disponibles =====
+Le joueur peut cliquer le bouton **ou** taper ''avancer nord''.
+Sans ''commande:'', seul ''avancer foret'' (l'id de la salle) fonctionne.
-^ Champ ^ Description ^ Obligatoire ^
+Voir [[fr:yaml:alias|Alias et commandes]] pour les raccourcis globaux et les alias d'action.
-| ''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 =====
+===== 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 dans la tour"
+    bouton: "🚪 Entrer"
-    vers: tour_interieur
+    vers: salle_secrete
-    si: "o_cle_tour_o"
+    si: "cle"
-    texte_ko: "La porte est verrouillée. Il vous faut une clé."
+    texte_ko: "La porte est verrouillée."
-    grise-si: "!o_cle_tour_o"
+    texte_ok: "Vous entrez dans la salle secrète."
+</code>
-  - commande: partir
+  * ''texte_ko:'' — affiché si la condition échoue (accès refusé)
-    bouton: "↩️ Repartir"
+  * ''texte_ok:'' — affiché si la condition réussit, avant le déplacement
-    vers: carrefour
-    si: "~"
-  - commande: attaquer
+Sans condition, ''texte_ok:'' et ''texte_ko:'' ne sont pas utilisés.
-    bouton: "⚔️ Attaquer le garde"
-    vers: combat_garde
+===== Bouton conditionnel (visible-si / grise-si) =====
-    si: "v_armee_v >= 10"
-    texte_ko: "Vous n'êtes pas assez fort."
+<code yaml>
-    visible-si: "v_armee_v >= 5"
+choix:
-    effet: "reput.-.10"
+  - 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>
-===== Effet avant déplacement =====
+  * ''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:'' s'exécute **avant** le déplacement vers la salle cible.
+===== Effet au clic (effet:) =====
-Si ''effet:'' contient un ''vers:'', le déplacement principal est annulé.
+''effet:'' exécute une action **avant** le déplacement.
 <code yaml>
-- commande: fuir
+choix:
-  bouton: "🏃 Fuir le combat"
+  - commande: acheter
-  vers: couloir
+    bouton: "🪙 Acheter (-10 pièces)"
-  si: "~"
+    vers: boutique
-  effet:
+    si: "v_or_v >= 10"
-    - "reput.-.5"
+    effet: "or.-.10"
-    - "o-bouclier"
 </code>
-===== Voir aussi =====
+===== Supprimer des encadrés au clic =====
+<code yaml>
+choix:
+  - commande: retour
+    bouton: "↩️ Retour"
+    vers: accueil
+    supprimer-encadre:
+      - all           # supprime tous les HUD actifs
+</code>
-  * [[fr:yaml:conditions|Conditions]]
+**Retrouvez nous sur le [[https://discord.gg/Z63DtVV|discord Make&Play]]**
-  * [[fr:yaml:actions|Actions personnalisées]]