Chatguessr

ChatGuessr is a desktop app that lets your Twitch chat play GeoGuessr along with you — viewers drop their guess on a map by typing a command, the app scores everyone in real time, and the streamer plays a normal solo round on top.

This is my customized branch — same core experience, with extra game modes, scoring tweaks, visual mods, and a pile of small quality-of-life fixes.

A community-driven fork.

This is a customized ChatGuessr build extending the main app (v3.0.3) with additional game modes, scoring modifiers, visual mods, and advanced settings. It's shaped by the ChatGuessr community on Twitch — most ideas come from streamers and viewers who wanted something the official version didn't have yet. ❤

The fork is in constant development. Releases should be stable, but if you'd rather run the official version, grab it from chatguessr.com. That's also where you'll find the donation link if you'd like to support the underlying project — all credit there goes to the original ChatGuessr authors.

What's different

Everything the official build does, plus the extras below. Sections collapse — open what you care about.

Game Modes 10

Game of Chicken 🐔

The winner of the previous round scores 0 points the next round — unless they 5k. The last round is always free.

  • 5k avoids chicken — a 5k saves you from the penalty.
  • Chicken can 5k — a 5k during your chicken round still scores in full.

Wrong Country Only

Guessing in the correct country gives you 0 points. Only wrong-country plonks score. Borders aren't always perfectly mapped — the line is dangerous.

Inverted Scoring (Antipode)

Distance is reversed — the further from the actual location, the more points. Closest to the antipode wins. Best on tough maps like Pain and Suffering or Random Pan and Zoom World.

Exclusive Mode

You only score if you are the only player who guessed in your country. Share a country with anyone else and you both get 0. Being close doesn't matter — picking a country nobody else thought of does.

Countdown / Countup

Guesses must follow a sequence based on country name length. Players who break the sequence are disqualified for that round.

  • Countdown — each round shorter than the last. e.g. United Kingdom (13) → Afghanistan (11) → Thailand (8) → Myanmar (7) → China (5)
  • Countup — each round longer than the last. e.g. Iran (4) → Malta (5) → Greece (6) → Myanmar (7) → United Kingdom (13)

Alphabetical Mode

Guesses must follow alphabetical order across rounds.

  • A → Z — each round's country comes later in the alphabet.
  • Z → A — each round's country comes earlier.

ABC Mode

Each round must be guessed in a country starting with the next allowed letter. The allowed letters are configurable — e.g. ABCDE means round 1 starts with A, round 2 with B, etc.

Darts Mode

Get as close to a target score as possible — not necessarily the highest score.

  • Target score — configurable, default 25,000.
  • Bust — exceeding the target eliminates you for that round.

Battle Royale Mode

Multiple guesses per round, with points deducted for reguesses.

  • Reguess limit — max guesses per round (default 3).
  • Points subtracted per reguess — applied per attempt (default 0).

Random Plonk Only

Only !randomplonk commands are accepted. Manual guesses are rejected.

Water Plonk Modes

Two opposites — pick one.

  • Mandatory — all guesses must be in international waters (coast doesn't count). Tip: OpenStreetMap helps spot the gaps.
  • Illegal — all guesses must be on land. Water plonks rejected.
Scoring Modifiers 4

Multi-Guess

Players can update their guess during the round. Streaks are calculated at round end based on the final country.

Wrong Country Penalty

Deducts a configurable number of points from any guess that lands in the wrong country.

Allow Negative Scores

Scores can drop below 0 instead of being capped.

Random Multipliers

Each round can receive a random score multiplier applied to all players. Two systems: random weighted distribution, or "Multi Merchant" mode.

Visual Mods 3 + NCNC

Toggled per-session from the game setup screen. None of these affect scoring.

Satellite Mode

Satellite/aerial view for the guessing map, with a configurable bounds limit (how much of the map is visible).

Blink Mode

Hides the panorama and briefly reveals it on a timer.

  • Time limit — reveal duration, 0.1–5s (default 0.8s).
  • Round delay — wait before the first reveal each round, 0.1–5s (default 1s).

No Car / No Compass (NCNC)

A collection of visual filters and element removals, each toggleable on its own.

OptionEffect
No CarHides the car icon
No CompassHides the compass UI
WaterApplies a water/wave filter
ScrambleDistorts the image
RescrambleRe-distorts on a timer (requires Scramble)
PixelatePixelates the view
GreyscaleConverts to greyscale
SepiaApplies sepia tone
Upside DownRotates the entire page 180°
CRTCRT monitor effect
ToonCartoon/toon shader
Twitch Channel Point Rewards 3

Triggered by custom channel point redemptions. Reward IDs need to be configured to match your channel.

Disappointment Island

Forces the targeted viewer to plonk at Disappointment Island (−50.607°, 165.972°).

Pay2Win

Forces the redeemer to plonk at the exact correct location — guaranteed 5k.

Russian Roulette

Applies a hidden random penalty or effect to the redeemer.

Commands & Settings extras

Additional Twitch Commands

  • !randomplonk / !rp — random guess (respects water plonk mode).
  • !randomplonk [countrycode] — random guess inside a specific country (if enabled).
  • !randomplonkwater / !taquitoplonk — random guess in international waters.
  • !mode — shows the currently active game mode.
  • !countrycode — posts a link to the country code list.

Points Gifting

Award bonus points to round or game winners via a bot command (Nightbot, StreamElements, etc.). Both the command and amount are configurable.

Message Customization

Every type of ChatGuessr Twitch message can be individually enabled/disabled and rewritten.

Custom Flags

Drop image files into %AppData%\ChatGuessr\flags\. Supported: .svg, .png, .jpg, .jpeg, .webp, .gif, .apng. The filename becomes the flag command — test.jpg!flag test.

Other Fixes & Improvements QoL
  • Flags on the results screen fade on hover so you can read the city names behind them.
  • The info box and map hide together with the scoreboard.
  • Fixed repeating "Guesses are opened" / "Round Started" messages on Play Again.
  • Random plonk fixes — no more missing avatars, no more double-plonks for renamed players.
  • Streamer data excluded from !best commands.