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

# MemeSweeper

> Chat-driven Minesweeper — sweep the grid, dodge the memes

<Info>**Category:** Puzzle · **Players:** free-for-all · **Status:** Beta</Info>

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

Minesweeper for the whole chat, with the mines re-skinned as memes. Everyone
works one shared board: type a coordinate to reveal a cell, read the numbers to
deduce where the memes hide, and flag the ones you've worked out. Reveal a meme
and you get clowned — you're out. Clear every safe cell together and the board
is swept.

## Gameplay

<Steps>
  <Step title="Reveal a cell">
    Type a coordinate like `d5` (column D, row 5) to uncover it. The very first
    reveal of the game is always safe.
  </Step>

  <Step title="Read the numbers">
    A revealed number counts the memes touching that cell. A blank (zero) cascades
    open its neighbours — a big free reveal.
  </Step>

  <Step title="Flag the memes">
    Mark a suspected meme with `flag d5` (or `f d5`). Correct flags score at the
    end; wrong ones cost nothing.
  </Step>
</Steps>

## How the board works

The numbers are the whole game: each one counts the memes in the eight cells
around it. Step on a meme and you're out; a blank cell opens a cascade.

<Frame caption="Numbers count adjacent memes; a blank cascades open, a flag marks a suspected meme, and stepping on one is out">
  <img className="block dark:hidden" src="https://mintcdn.com/livehub/3i6c6dt6ajmVldMw/images/games/memesweeper-board.svg?fit=max&auto=format&n=3i6c6dt6ajmVldMw&q=85&s=4a0c92cf25fd1415881fcbce01022611" alt="A minesweeper grid with numbered cells, a flagged cell, and revealed meme cells, beside a legend" width="860" height="300" data-path="images/games/memesweeper-board.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/livehub/3i6c6dt6ajmVldMw/images/games/memesweeper-board-dark.svg?fit=max&auto=format&n=3i6c6dt6ajmVldMw&q=85&s=03823758abd21e3eb8313be48964a19f" alt="A minesweeper grid with numbered cells, a flagged cell, and revealed meme cells, beside a legend" width="860" height="300" data-path="images/games/memesweeper-board-dark.svg" />
</Frame>

* **Numbers count memes.** A cell's number is how many of its eight neighbours
  are memes; a blank has none and opens the surrounding cells automatically.
* **A cascade is yours.** Every cell a blank cascade uncovers is credited to
  whoever triggered it.
* **First reveal is safe.** The board seeds its memes around the opening cell, so
  the first click never loses.
* **Step on a meme, you're out** — unless a lifeline saves you (see
  [Gifts](#gifts)). The meme still reveals so chat learns where it was.

## Configuration

| Option            | Values                    | Default       |
| ----------------- | ------------------------- | ------------- |
| **Board size**    | rows × columns            | 9 × 9         |
| **Meme count**    | number of hidden memes    | 10            |
| **Lifeline gift** | a gift that grants a save | Off until set |

**Board size.** How large the grid is — bigger boards take the room longer to
clear.

**Meme count** must leave at least one safe cell; a denser board is riskier.

**Lifeline gift.** An optional gift that banks a save (see [Gifts](#gifts)).

## Layout

<Frame caption="MemeSweeper — play surface">
  <img className="block dark:hidden" src="https://mintlify.s3.us-west-1.amazonaws.com/livehub/images/games/memesweeper.svg" alt="Labeled layout of the MemeSweeper play surface" />

  <img className="hidden dark:block" src="https://mintlify.s3.us-west-1.amazonaws.com/livehub/images/games/memesweeper-dark.svg" alt="Labeled layout of the MemeSweeper play surface" />
</Frame>

1. **Marquee** — game title and how-to hint.
2. **Progress strip** — safe cells remaining and survivor count.
3. **Board** — the shared grid; revealed cells show their number or a meme.
4. **Gift strip** — the lifeline gift when configured.
5. **Leaderboard** — players ranked by cells uncovered.

The game moves through **Lobby → Active → Finished**.

## Gifts

MemeSweeper's lifeline gift **banks a save**. If you step on a meme with a
lifeline in hand, it's spent automatically — you survive and keep playing, and
the meme still reveals so the board stays honest. It's off unless the host sets
it.

## Scoring

* **+1 per cell** you uncover — including every cell in a cascade you set off.
* **+1 per correctly-flagged meme** at the end of the game; wrong flags carry no
  penalty.
* The game ends when the board is cleared or everyone has been clowned; the top
  score wins, and ties are shipped as co-winners.
* Points feed the per-streamer tally behind
  [avatar ring tiers](/games/leaderboards). Wins are tracked per streamer.
