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

# LiveLocator

> Drop into a Street View panorama and name the country

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

A GeoGuessr-style round. Each round drops the room into a Street View panorama;
everyone guesses which country it's in, and each guess is scored by how close it
lands. Unlike the other guessing games, everyone gets a chance every round —
you're scored on accuracy, not just who was first.

## Gameplay

<Steps>
  <Step title="Explore the panorama">
    A Street View scene fills the stage. Read the road signs, plants,
    architecture, and terrain for clues.
  </Step>

  <Step title="Guess a country">
    Type a country name in chat — no command. You can refine your guess; your
    last answer is the one that counts.
  </Step>

  <Step title="Score by distance">
    At reveal, each guess scores by how close your country is to the real one —
    a bullseye is worth the full 5,000 points.
  </Step>
</Steps>

## How scoring works

LiveLocator scores accuracy on a smooth curve: the closer your country sits to
the real one, the more points you bank — no all-or-nothing.

<Frame caption="Closer guesses score more, up to 5,000 for the right country">
  <img className="block dark:hidden" src="https://mintcdn.com/livehub/rxLM0Xvl5AlVtm-w/images/games/livelocator-distance.svg?fit=max&auto=format&n=rxLM0Xvl5AlVtm-w&q=85&s=fa529814ed3e4647ccda4c8b89531c27" alt="A distance-to-points curve peaking at 5,000 for a bullseye and decaying with distance" width="860" height="248" data-path="images/games/livelocator-distance.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/livehub/rxLM0Xvl5AlVtm-w/images/games/livelocator-distance-dark.svg?fit=max&auto=format&n=rxLM0Xvl5AlVtm-w&q=85&s=8c82711aa66d8e48f2b9c49ac6fd9b38" alt="A distance-to-points curve peaking at 5,000 for a bullseye and decaying with distance" width="860" height="248" data-path="images/games/livelocator-distance-dark.svg" />
</Frame>

* **Right country = 5,000.** Naming the exact country always scores the maximum,
  wherever in it the panorama sits.
* **Close counts.** A wrong-but-neighbouring country still scores well; the
  further off you are, the less you bank.
* **Guess early for a speed bonus.** When enabled, an earlier correct guess is
  worth more than a late one.
* **No copying.** Guessing a country someone else already called, seconds later,
  is discounted — so reading the scene beats reading chat.

## Configuration

| Option               | Values                                 | Default       |
| -------------------- | -------------------------------------- | ------------- |
| **Scoring**          | `points`, `elimination`                | `points`      |
| **Round timer**      | seconds per round, or manual           | Manual        |
| **Speed bonus**      | on / off                               | On            |
| **Score-floor gift** | a gift that sets a minimum round score | Galaxy → 2500 |

**Scoring.** **points** (default) crowns the highest cumulative score. In
**elimination**, the lowest-scoring guesser is cut each round and the last one
standing wins.

**Round timer.** Manual by default (the host reveals when ready); set a number
of seconds to run a per-round countdown instead.

**Speed bonus.** When on, a correct guess early in the round is worth more than
a late one — turn it off for classic distance-only scoring.

**Score-floor gift.** A gift that locks in a minimum score for the sender this
round (see [Gifts](#gifts)). Defaults to Galaxy setting a 2,500 floor; the max
floor is a perfect 5,000.

## Layout

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

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

1. **Marquee** — game title and how-to hint.
2. **Round + gift strip** — round number, and the score-floor gift when configured.
3. **Panorama** — the Street View scene to place.
4. **Leaderboard** — players ranked by score, with each round's best distance.
5. **Got-it pill** — a safe live count of how many have the right country.
6. **Gift floors** — which players locked in a score with a gift this round.

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

## Gifts

LiveLocator's gift sets a **score floor** — a guaranteed minimum for the sender
this round. It rewards spend without buying accuracy.

* Sending a configured gift sets your round score to at least the gift's floor —
  e.g. a Galaxy locks in 2,500.
* It only ever *raises* your score: if your typed guess already scored higher,
  the floor does nothing.
* The maximum floor is 5,000 — a perfect round — and floors reset every round.

## Scoring

<Frame caption="Points crowns the highest total; elimination cuts the lowest scorer each round">
  <img className="block dark:hidden" src="https://mintcdn.com/livehub/rxLM0Xvl5AlVtm-w/images/games/hol-scoring.svg?fit=max&auto=format&n=rxLM0Xvl5AlVtm-w&q=85&s=620e2f605ff5f87f565973fb82f263da" alt="Left: an elimination funnel narrowing to one winner. Right: points bars with the highest total marked winner" width="860" height="236" data-path="images/games/hol-scoring.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/livehub/rxLM0Xvl5AlVtm-w/images/games/hol-scoring-dark.svg?fit=max&auto=format&n=rxLM0Xvl5AlVtm-w&q=85&s=8b891f4896cc2e55ca0a4c71627ea0c0" alt="Left: an elimination funnel narrowing to one winner. Right: points bars with the highest total marked winner" width="860" height="236" data-path="images/games/hol-scoring-dark.svg" />
</Frame>

* **Points:** the highest cumulative score across all rounds wins.
* **Elimination:** the lowest-scoring guesser (or guessers, if tied) is cut each
  round; the last standing wins. Only players who actually guessed are eligible
  to be cut.
* Scores feed the per-streamer tally behind
  [avatar ring tiers](/games/leaderboards). Wins are tracked per streamer.
