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

====== Choices and Buttons (YAML) ======

Choices define navigation commands and buttons shown to the player.

===== Base Syntax =====

<code yaml>
choices:
  - command: north
    button: "Go north"
    to: forest

  - command: back
    to: home
</code>

  * ''command:'' — keyword the player can type.
  * ''button:'' — visible button label. If absent, no local button is shown unless a global alias provides one.
  * ''to:'' — destination room.

===== Button Defined on the Room =====

<code yaml>
- id: timers_demo
  button: "Timers"
  text: "..."
</code>

A choice pointing to this room without its own ''button:'' can inherit the room button.

===== to: previous =====

<code yaml>
choices:
  - command: back
    button: "Back"
    to: previous
</code>

===== Access Conditions =====

<code yaml>
choices:
  - command: enter
    button: "Enter the secret room"
    to: secret_room
    if: "key v_score_v > 10"
    text_ko: "The door remains closed."
</code>

===== Conditional Buttons =====

<code yaml>
choices:
  - command: expert
    button: "Expert mode"
    to: expert_room
    visible-if: "v_score_v > 50"

  - command: weakened
    button: "Move on"
    to: next_room
    disabled-if: "v_hp_v <= 0"
</code>

===== Click Effect =====

''effect:'' runs before moving to the destination.

<code yaml>
choices:
  - command: buy
    button: "Buy (-10 gold)"
    to: shop
    effect: "gold.-.10"
    if: "v_gold_v >= 10"
</code>

===== Clear HUD on Click =====

<code yaml>
choices:
  - command: back
    button: "Back"
    to: home
    clear-hud:
      - all
</code>