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

# Guess the Flag

> A flag appears — race to type the country

<Info>**Category:** Trivia · **Players:** free-for-all · **Status:** Stable</Info>

A geography speed-run. Each round shows a country's flag; chat races to type the
country name. The first correct guess wins the round and ends it. Play a set of
rounds; the most flags named takes the crown.

## Gameplay

<Steps>
  <Step title="See the flag">
    A flag fills the stage. No timer pressure from a reveal — it's pure
    recognition speed.
  </Step>

  <Step title="Type the country">
    Type the country's name in chat — no command. Friendly aliases are accepted,
    so **USA**, **America**, and **United States** all count, as do **UK** and
    **South Korea**.
  </Step>

  <Step title="First correct wins the round">
    The first correct guess ends the round and banks a point; the host then
    advances to the next flag.
  </Step>
</Steps>

Late joiners are welcome between rounds — there's no elimination, so a viewer
arriving mid-set just starts scoring from the next round.

## How matching works

Guess the Flag is a recognition race with forgiving name-matching, so you're
never punished for spelling a country the common way.

* **Aliases count.** Each country carries a set of accepted names — official,
  common, and abbreviated — so USA / America / United States all resolve to the
  same answer.
* **Case and punctuation don't matter.** Type it however you like.
* **The answer stays hidden.** The country name isn't in the live data until the
  round ends, so it can't leak early.

## Configuration

| Option               | Values                                     | Default       |
| -------------------- | ------------------------------------------ | ------------- |
| **Letter-hint gift** | a gift that reveals letters of the country | Off until set |

**Letter-hint gift.** Off until the host picks a gift. When set, sending it
uncovers letters of the current country's name for the whole room, up to a cap
(see [Gifts](#gifts)).

## Layout

<Frame caption="Guess the Flag — play surface">
  <img className="block dark:hidden" src="https://mintcdn.com/livehub/vMXRdNH3i0sK6lNA/images/games/guess-the-flag.svg?fit=max&auto=format&n=vMXRdNH3i0sK6lNA&q=85&s=363121143851063cfacf2b79b9148b1a" alt="Labeled layout of the Guess the Flag play surface" width="860" height="436" data-path="images/games/guess-the-flag.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/livehub/vMXRdNH3i0sK6lNA/images/games/guess-the-flag-dark.svg?fit=max&auto=format&n=vMXRdNH3i0sK6lNA&q=85&s=8484466a584b7d1403866b4b7f49c4e8" alt="Labeled layout of the Guess the Flag play surface" width="860" height="436" data-path="images/games/guess-the-flag-dark.svg" />
</Frame>

1. **Marquee** — game title and how-to hint.
2. **Round + hint strip** — round number, and the letter-hint gift when configured.
3. **Flag** — the flag to identify.
4. **Name skeleton** — the country name as blanks, with any gift-revealed letters filled in.
5. **Leaderboard** — players ranked by flags named.

The game moves through **Lobby → Round → Revealed → Finished**.

## Gifts

Guess the Flag's gift is a cooperative **letter hint** — the same capped reveal
as Chatexto. It's off unless the host sets it.

<Frame caption="Each gift uncovers a slice of the name's letters, up to a cap — the rest is always guessed">
  <img className="block dark:hidden" src="https://mintcdn.com/livehub/WZDLPJOAmyxnINsO/images/games/chatexto-gift-reveal.svg?fit=max&auto=format&n=WZDLPJOAmyxnINsO&q=85&s=73d562c2ddaba6480e328246814b18fc" alt="Letter tiles filling in as gifts are sent, stopping at a cap" width="860" height="260" data-path="images/games/chatexto-gift-reveal.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/livehub/WZDLPJOAmyxnINsO/images/games/chatexto-gift-reveal-dark.svg?fit=max&auto=format&n=WZDLPJOAmyxnINsO&q=85&s=c62d643b9a4c8b56730eec8d4a46be74" alt="Letter tiles filling in as gifts are sent, stopping at a cap" width="860" height="260" data-path="images/games/chatexto-gift-reveal-dark.svg" />
</Frame>

* Each send uncovers about 10% of the name's letters (scaled to length), at
  random positions.
* Reveals are capped at \~70% of the letters — the rest is always won by
  guessing, so a gift can never buy the answer.

## Scoring

* Each flag named adds one to your per-streamer win count (which drives
  [avatar ring tiers](/games/leaderboards)).
* The most flags named across the set wins; ties are shipped as co-winners.
* Wins are tracked per streamer.