Choices and Buttons (YAML)

Choices define navigation commands and buttons shown to the player.

choices:
  - command: north
    button: "Go north"
    to: forest

  - command: back
    to: home

• 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.

- id: timers_demo
  button: "Timers"
  text: "..."

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

choices:
  - command: back
    button: "Back"
    to: previous

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

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"

effect: runs before moving to the destination.

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

choices:
  - command: back
    button: "Back"
    to: home
    clear-hud:
      - all