Différences

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

--- en:yaml:choix [2026/05/03 23:59] – mise a jour wiki cyrilfiesta
+++ en:yaml:choix [2026/10/19 21:20] (Version actuelle) – Textes des choix : tentative, resultat et ordre des effets cyrilfiesta
@@ Ligne 3: / Ligne 3: @@
 ====== Choices and Buttons (YAML) ======
-Choices define the exits available from a room — navigation, access conditions and buttons shown to the player.
+Choices define the exits available from a room - navigation, access conditions and buttons shown to the player.
 ===== Minimal syntax =====
@@ Ligne 41: / Ligne 41: @@
 </code>
-The player can click the button **or** type ''go north''.
+The player can click the button **or** type ''north'' or ''go north''. Without ''command:'', use the destination id, for example ''go forest''.
-Without ''command:'', only ''go forest'' (the room id) works.
+With [[en:yaml:texte#listing_choices_in_the_text|choice lists in the text]], a choice without an alias uses its position in the list. An explicit numeric alias takes priority over a room number or an automatic button shortcut.
 See [[en:yaml:alias|Aliases and commands]] for global shortcuts and action aliases.
@@ Ligne 74: / Ligne 75: @@
 ===== Access condition (if:) =====
-''if:'' blocks access if the condition is not met. The player receives ''text_ko:'' as feedback.
+''text:'' describes the attempt, including when ''if:'' fails. ''text_ok:'' and ''text_ko:'' describe the result of that condition.
 <code yaml>
 choices:
   - command: enter
-    button: "🚪 Enter"
+    button: Enter
     to: secret_room
+    text: "You push the door."
     if: "key"
-    text_ko: "The door is locked."
+    text_ok: "The lock gives way."
-    text_ok: "You enter the secret room."
+    text_ko: "The door stays locked."
 </code>
-  * ''text_ko:'' — shown if the condition fails (access denied)
+^ Situation ^ Texts shown ^ Effect and movement ^
-  * ''text_ok:'' — shown if the condition succeeds, before moving
+| No ''if:'' | ''text'' | Yes |
+| Condition passes | ''text'' and ''text_ok'' | Yes |
+| Condition fails | ''text'' and ''text_ko'' | No |
+| ''text_ok'' without ''if:'' | No OK text | Yes |
+| Disabled button | None | No |
-Without a condition, ''text_ok:'' and ''text_ko:'' are not used.
+Texts follow their order in the YAML. In the editor, use the move buttons beside the text fields to change that order; a new choice starts with the Text field.
+''effect:'' runs after checking ''if:'', before the texts and movement. Texts therefore read the values updated by the effect, even when ''effect:'' is written after them.
+This rule applies to choices. An action uses ''text_ok:'' on success, including without a condition. An event uses ''text:'' when it runs; that text is not shown when its condition fails.
 ===== Conditional button (visible-if / disabled-if) =====
@@ Ligne 106: / Ligne 116: @@
 </code>
-  * ''visible-if:'' — the button disappears if the condition is false
+  * ''visible-if:'' - the button disappears if the condition is false
-  * ''disabled-if:'' — the button stays visible but cannot be clicked
+  * ''disabled-if:'' - the button stays visible but cannot be clicked
 ===== Click effect (effect:) =====
@@ Ligne 132: / Ligne 142: @@
       - all
 </code>
-**Join us on [[https://discord.gg/Z63DtVV|Discord Make&Play]]**