Cards mode (ui: cards)

In cards mode, the choices of each room are displayed as illustrated cards on a horizontal rail below the room text. A click selects a card; a drag scrolls the rail without triggering anything. Keyboard arrows and the side arrows work too.

title: "The crossroads"
ui: cards

Every button type becomes a card: navigation choices, events with button:, custom actions, global aliases.

A card look is configured with the following keys, from general to specific (each level overrides the previous one):

1. cards: at scenario level: default values for all cards;
2. cards: slots: : one design per position on the rail;
3. card: on a room: design of the cards leading to that room;
4. card: on a choice: design of that specific card.

cards:
  image: "https://example.com/standard-back.png"
  color: "#7c5cff"

rooms:
  - id: sanctuary
    card:
      image: "https://example.com/sanctuary.png"
      title: "The Sanctuary"
      subtitle: "A deceptive calm"
      rarity: rare
    text: "..."

hidden: true presents the card face down, without revealing its destination. On click, the card flips (3D animation) and reveals its face before the room change. A normal card reveals its back when flipped; back_title: and back_subtitle: let you write something there.

choices:
  - button: "Mystery card"
    card:
      hidden: true
      back_title: "?"
    to: surprise_room

A random: N block draws N cards from a list each time the player enters the room. The draw stays stable until the player leaves the room.

choices:
  - random: 2
    cards:
      - button: "The cave"
        to: cave
      - button: "The cliff"
        to: cliff
      - button: "The swamp"
        to: swamp

• The input bar is hidden by default in cards mode (hide_input: false to keep it).
• The usual conditions apply: visible-if: hides the card, disabled-if: makes it inactive.
• The mode pairs well with a HUD showing the player's resources.

See also: Interface modes, Deck mode.

Join us on Discord Make&Play