**Language / Langue :** [[fr:ui:deck|FR]] | **EN**

====== Deck mode (ui: deck) ======

In ''deck'' mode, each room becomes a **single card** at the center of the screen, resting on a pile - like decision games in the style of //Reigns//. The room illustration fills the card, the text is shown in a readable panel at its bottom, and choices become **directions**.

<code yaml>
title: "Crown of Mist"
ui: deck
</code>

===== Choosing by swiping =====

Three ways to confirm a choice:

  * **drag the card** in the desired direction (it follows the pointer, tilts, and an edge glow shows the targeted direction - released too early, it snaps back);
  * click the **direction pills** anchored on the card edges;
  * the **keyboard arrows**.

The first four visible choices are automatically mapped to directions, in declaration order: left, right, up, down.

<code yaml>
rooms:
  - id: council
    text: "The council awaits your seal."
    choices:
      - button: "Hand the letter to the envoy"   # left
        to: envoy
      - button: "Open the gates"                  # right
        to: gates
      - button: "Hear the scouts"                 # up
        to: scouts
      - button: "Receive the innkeeper"           # down
        to: inn
</code>

Every button type can be a direction: navigation, events with ''button:'', custom actions. A long label wraps over several lines inside its pill.

===== Artwork and card backs =====

The room image (''%%[[url]]%%'' in the text) becomes the card artwork. ''back_title:'' and ''back_subtitle:'' (see [[en:ui:cards|cards mode]]) remain available to dress up the cards.

===== Independent HUDs =====

In deck mode, HUD panels never overlap: ''top''/''bottom'' bands are limited to the card width, ''left''/''right'' to its height, and corners anchor to the screen corners. Each position is therefore **independent**: placing a band no longer clears the corners, and ''clear-hud: top'' only removes the top band. Ideal for //Reigns//-style gauges (people, army, gold, faith...).

<code yaml>
hud:
  - position: top-left
    text: "People: v_people_v"
  - position: top-right
    text: "Gold: v_gold_v"
</code>

===== Tips =====

  * The visual mood (board, card material) derives from the **palette** picked by the player: a light palette gives a light deck.
  * The input bar is hidden by default (''hide_input: false'' to keep it).
  * Keep at most 4 visible choices per room: beyond that, only the first 4 become directions.
  * The ''test-ui-deck'' demo scenario shows 12 illustrated cards with gauges.

See also: [[en:ui:presentation|Interface modes]], [[en:ui:cards|Cards mode]], [[en:yaml:hud|HUD panels]].

**Join us on [[https://discord.gg/Z63DtVV|Discord Make&Play]]**