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

# TwistTok

> A 7-letter anagram race — find as many words as you can

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

A Text-Twist-style anagram race for chat. Each round shows a rack of 7 letters;
chat types as many words (3–7 letters) as they can spell from them. The first
person to type a given word claims its points, and the highest total across the
rounds wins.

## Gameplay

<Steps>
  <Step title="Read the rack">
    Seven letters appear. Find words 3–7 letters long using only those letters
    (each letter as many times as it appears in the rack).
  </Step>

  <Step title="Type words">
    Just type any word you spot — no command. The first to type a given word
    claims its points; nobody else can score the same word.
  </Step>

  <Step title="Twist for a fresh angle">
    The host can **twist** the rack — shuffle the same letters — to help chat
    spot new anagrams. Same letters, same valid words.
  </Step>
</Steps>

## How scoring works

Longer words are worth more, and every word is a race — only the first person to
type it scores.

<Frame caption="Longer words score more; the first to type a word claims it">
  <img className="block dark:hidden" src="https://mintcdn.com/livehub/rxLM0Xvl5AlVtm-w/images/games/twist-rack.svg?fit=max&auto=format&n=rxLM0Xvl5AlVtm-w&q=85&s=a45f23f23cacc670446893845afaa8d6" alt="A 7-letter rack with example words of increasing length and point values" width="860" height="236" data-path="images/games/twist-rack.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/livehub/rxLM0Xvl5AlVtm-w/images/games/twist-rack-dark.svg?fit=max&auto=format&n=rxLM0Xvl5AlVtm-w&q=85&s=16ed2ba0249b28b0a73cf85c569424bd" alt="A 7-letter rack with example words of increasing length and point values" width="860" height="236" data-path="images/games/twist-rack-dark.svg" />
</Frame>

* **Longer words score more** — a 3-letter word is 1 point, rising to 4 for a
  6-letter word (about one point per letter beyond the minimum).
* **One claim per word.** The first to type a word claims it; duplicates and
  latecomers don't score it again.
* **Clear the rack for a 2× bonus.** If chat collectively finds *every* valid
  word in a round, everyone's points for that round double.

## Configuration

| Option             | Values                           | Default                                                 |
| ------------------ | -------------------------------- | ------------------------------------------------------- |
| **Rounds**         | number of racks                  | 5                                                       |
| **Round length**   | seconds per rack                 | 120s                                                    |
| **Difficulty**     | rack difficulty bucket           | Mixed                                                   |
| **Free-word gift** | gift → unlock a word of a length | Doughnut → 3, Hand Heart → 4, Money Gun → 5, Galaxy → 6 |

**Rounds / Round length.** How many racks the session plays and how long chat
has on each.

**Difficulty.** Filters the rack pool — leave on Mixed to draw from every rack,
or pick a bucket for easier or harder letter sets.

**Free-word gift.** Maps gifts to a word length to unlock (see [Gifts](#gifts)).

## Layout

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

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

1. **Marquee** — game title and how-to hint.
2. **Round + gift strip** — round number, and the free-word gifts when configured.
3. **Letter rack** — the seven letters to build from.
4. **Word-slot wall** — every valid word as a blank slot, grouped by length and filled in as chat finds them.
5. **Leaderboard** — players ranked by total points.

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

## Gifts

TwistTok's gift is a **free word** — it claims a word off the board for the
gifter, scored exactly like a chat find.

* Sending a configured gift unlocks a random unfound word of that gift's mapped
  length — Doughnut → 3-letter, Hand Heart → 4, Money Gun → 5, Galaxy → 6.
* The unlocked word scores the gifter and comes off the board, so bigger gifts
  claim longer, higher-scoring words.
* Capped at a few claims per round, so a gifter can't farm the rack or deny
  chat.

## Scoring

* Every word scores by length (3–6 letters → 1–4 points); clearing the whole
  rack doubles the round for everyone who contributed.
* The highest total across the rounds wins; ties are shipped as co-winners.
* Points feed the per-streamer win tally behind
  [avatar ring tiers](/games/leaderboards). Wins are tracked per streamer.
