> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livehub.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Pairdle

> King-of-the-grid 1v1 Wordle duels

<Info>**Category:** Word · **Players:** 1v1 duels (queue) · **Status:** Beta</Info>

<Note>Pairdle is in beta — details may change.</Note>

A king-of-the-hill Wordle. Two chatters take the chair — **Champion** and
**Challenger** — and race the same secret on their own 6×5 grid. First to solve
wins, stays on as Champion, and faces the next challenger from the queue. Type
`!queue` to line up.

## Gameplay

<Steps>
  <Step title="Queue up">
    Type `!join` (or `!queue`) to get in line. The first two in line seat as
    Champion and Challenger; everyone else waits their turn.
  </Step>

  <Step title="Race the grid">
    Both seated players' chat messages are their guesses on their own board.
    Only the two seated players' guesses count. First to solve wins the match.
  </Step>

  <Step title="Hold the throne">
    The winner stays on as Champion; the loser goes to the back of the queue and
    the next challenger steps up. A win streak builds as the Champion holds.
  </Step>
</Steps>

Pairdle is a **seat** game: because there's an actual chair to claim, it needs a
`!join` (or `!queue`) — unlike the open-roster games where playing is joining.

## How feedback works

Each guess is scored letter by letter, standard Wordle colours — the same board
for both duelists.

<Frame caption="Green = right spot, present = right letter wrong spot, absent = not in the word">
  <img className="block dark:hidden" src="https://mintcdn.com/livehub/rxLM0Xvl5AlVtm-w/images/games/wordle-grid.svg?fit=max&auto=format&n=rxLM0Xvl5AlVtm-w&q=85&s=56924b46b063a0fd18ec2b34d27ac15c" alt="A Wordle board showing correct, present, and absent letter feedback with a legend" width="860" height="244" data-path="images/games/wordle-grid.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/livehub/rxLM0Xvl5AlVtm-w/images/games/wordle-grid-dark.svg?fit=max&auto=format&n=rxLM0Xvl5AlVtm-w&q=85&s=0c6d6d77ab624a72feb02338b834d56b" alt="A Wordle board showing correct, present, and absent letter feedback with a legend" width="860" height="244" data-path="images/games/wordle-grid-dark.svg" />
</Frame>

* **Same secret, two grids.** Champion and Challenger race the identical word
  side by side; first to an all-green solve wins.
* **Six rows each.** Run out of rows without solving and you forfeit that board;
  if both miss, it's decided on most greens, then fewer rows used.
* **Don't stall.** Going idle for two rows in a row forfeits the seat, so an
  AFK player can't block the queue. Matches also have a time cap.

## Configuration

| Option            | Values                            | Default       |
| ----------------- | --------------------------------- | ------------- |
| **Match length**  | 15–300s                           | 180s          |
| **Priority gift** | a gift that bumps your queue slot | Off until set |

**Match length.** The per-duel time cap; on expiry the match resolves on most
greens, then fewer rows used.

**Priority gift.** An optional queue-jump gift (see [Gifts](#gifts)).

## Layout

<Frame caption="Pairdle — play surface">
  <img className="block dark:hidden" src="https://mintcdn.com/livehub/ThHsVKe9JG-qGYAN/images/games/pairdle.svg?fit=max&auto=format&n=ThHsVKe9JG-qGYAN&q=85&s=38c1a31f57216e55f465cefe70c39457" alt="Labeled layout of the Pairdle play surface" width="860" height="436" data-path="images/games/pairdle.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/livehub/ThHsVKe9JG-qGYAN/images/games/pairdle-dark.svg?fit=max&auto=format&n=ThHsVKe9JG-qGYAN&q=85&s=75aabae318906df1ceabaca4f80016ff" alt="Labeled layout of the Pairdle play surface" width="860" height="436" data-path="images/games/pairdle-dark.svg" />
</Frame>

1. **Marquee** — game title and how-to hint.
2. **Champion vs Challenger** — the two seated players.
3. **Streak** — the Champion's current king-of-the-hill run.
4. **Grids** — the two 6×5 boards, one per duelist.
5. **Queue** — who's lined up to challenge next.

The game moves through **Lobby → Match → Match done → Finished**.

## Gifts

Pairdle's gift is a **queue jump** — it moves the sender up the line, but never
helps them win a match. It's off unless the host sets it.

* Sending the configured gift bumps your queue slot up by one (and auto-joins
  you to the line if you weren't already in it).
* It only affects your place in line — the duel itself is still won on the grid.

## Scoring

* Each match won adds one to your win count; a **streak** tracks consecutive
  holds of the throne.
* The session winner is whoever won the most matches. Every match win counts
  toward the per-streamer tally behind [avatar ring tiers](/games/leaderboards).
