# Medium's Good Words Solver

> Medium's Good Words game ships its own solver, and solo boards come from the round number. A case study and a Chrome extension that plays every word.

- Author: glizzykingdreko
- Published: 2026-10-07
- Tags: medium, good-words, chrome-extension, reverse-engineering, websocket, game
- URL: https://takionapi.tech/blog/medium-good-words-solver

---

A case study / chrome extension to auto solve Medium's **Good Words** game.

- [Get the extension](https://chromewebstore.google.com/detail/good-words-solver-by-taki/aeagbadhifkaigikmlbepfhggbdgmomk)
- [Check the source](https://github.com/glizzykingdreko/medium-good-words)
- [Start bypassing antibots](https://takionapi.tech/trial)

## Introduction

Medium just launched **Good Words**, a little multiplayer word game living at `medium.com/games/good-words`. 

So I just wondered how hard would have been to "automatize" the solving of it.
Just a quick project done in a few minutes that, posting just as a study case.

## The game

Simples rules:
- 5x5 grid of letter
- 3m for round
- 30s break
- everyone plays the same board at the same moment
- u have to find words by matching nearby letters in whatever direction, min 4 letters for word

<figure>
<svg viewBox="0 0 580 274" role="img" aria-label="A 5 by 5 Good Words board. The word SOLVER is traced through six touching tiles, moving sideways and diagonally: 6 letters, 4 points. Tiles touch in any direction, diagonals included, 4 letters minimum. A round lasts 3 minutes, followed by a 30 second break, and everyone plays the same board." style="max-width:100%;height:auto;color:inherit">
  <line x1="33.0" y1="85.0" x2="85.0" y2="85.0" stroke="#7cb470" stroke-width="10" stroke-linecap="round"/><line x1="85.0" y1="85.0" x2="137.0" y2="137.0" stroke="#7cb470" stroke-width="10" stroke-linecap="round"/><line x1="137.0" y1="137.0" x2="189.0" y2="85.0" stroke="#7cb470" stroke-width="10" stroke-linecap="round"/><line x1="189.0" y1="85.0" x2="241.0" y2="137.0" stroke="#7cb470" stroke-width="10" stroke-linecap="round"/><line x1="241.0" y1="137.0" x2="241.0" y2="189.0" stroke="#7cb470" stroke-width="10" stroke-linecap="round"/><rect x="10" y="10" width="46" height="46" rx="7" fill="currentColor" fill-opacity="0.05" stroke="currentColor" stroke-opacity="0.18"/><text style="font-family:var(--font-mono),monospace" x="33.0" y="39.0" font-size="17" font-weight="700" text-anchor="middle" fill="currentColor" fill-opacity="0.55">W</text><rect x="62" y="10" width="46" height="46" rx="7" fill="currentColor" fill-opacity="0.05" stroke="currentColor" stroke-opacity="0.18"/><text style="font-family:var(--font-mono),monospace" x="85.0" y="39.0" font-size="17" font-weight="700" text-anchor="middle" fill="currentColor" fill-opacity="0.55">O</text><rect x="114" y="10" width="46" height="46" rx="7" fill="currentColor" fill-opacity="0.05" stroke="currentColor" stroke-opacity="0.18"/><text style="font-family:var(--font-mono),monospace" x="137.0" y="39.0" font-size="17" font-weight="700" text-anchor="middle" fill="currentColor" fill-opacity="0.55">R</text><rect x="166" y="10" width="46" height="46" rx="7" fill="currentColor" fill-opacity="0.05" stroke="currentColor" stroke-opacity="0.18"/><text style="font-family:var(--font-mono),monospace" x="189.0" y="39.0" font-size="17" font-weight="700" text-anchor="middle" fill="currentColor" fill-opacity="0.55">D</text><rect x="218" y="10" width="46" height="46" rx="7" fill="currentColor" fill-opacity="0.05" stroke="currentColor" stroke-opacity="0.18"/><text style="font-family:var(--font-mono),monospace" x="241.0" y="39.0" font-size="17" font-weight="700" text-anchor="middle" fill="currentColor" fill-opacity="0.55">S</text><rect x="10" y="62" width="46" height="46" rx="7" fill="#7cb470"/><text style="font-family:var(--font-mono),monospace" x="33.0" y="91.0" font-size="17" font-weight="700" text-anchor="middle" fill="#0A081E" fill-opacity="1">S</text><rect x="62" y="62" width="46" height="46" rx="7" fill="#7cb470"/><text style="font-family:var(--font-mono),monospace" x="85.0" y="91.0" font-size="17" font-weight="700" text-anchor="middle" fill="#0A081E" fill-opacity="1">O</text><rect x="114" y="62" width="46" height="46" rx="7" fill="currentColor" fill-opacity="0.05" stroke="currentColor" stroke-opacity="0.18"/><text style="font-family:var(--font-mono),monospace" x="137.0" y="91.0" font-size="17" font-weight="700" text-anchor="middle" fill="currentColor" fill-opacity="0.55">A</text><rect x="166" y="62" width="46" height="46" rx="7" fill="#7cb470"/><text style="font-family:var(--font-mono),monospace" x="189.0" y="91.0" font-size="17" font-weight="700" text-anchor="middle" fill="#0A081E" fill-opacity="1">V</text><rect x="218" y="62" width="46" height="46" rx="7" fill="currentColor" fill-opacity="0.05" stroke="currentColor" stroke-opacity="0.18"/><text style="font-family:var(--font-mono),monospace" x="241.0" y="91.0" font-size="17" font-weight="700" text-anchor="middle" fill="currentColor" fill-opacity="0.55">T</text><rect x="10" y="114" width="46" height="46" rx="7" fill="currentColor" fill-opacity="0.05" stroke="currentColor" stroke-opacity="0.18"/><text style="font-family:var(--font-mono),monospace" x="33.0" y="143.0" font-size="17" font-weight="700" text-anchor="middle" fill="currentColor" fill-opacity="0.55">G</text><rect x="62" y="114" width="46" height="46" rx="7" fill="currentColor" fill-opacity="0.05" stroke="currentColor" stroke-opacity="0.18"/><text style="font-family:var(--font-mono),monospace" x="85.0" y="143.0" font-size="17" font-weight="700" text-anchor="middle" fill="currentColor" fill-opacity="0.55">N</text><rect x="114" y="114" width="46" height="46" rx="7" fill="#7cb470"/><text style="font-family:var(--font-mono),monospace" x="137.0" y="143.0" font-size="17" font-weight="700" text-anchor="middle" fill="#0A081E" fill-opacity="1">L</text><rect x="166" y="114" width="46" height="46" rx="7" fill="currentColor" fill-opacity="0.05" stroke="currentColor" stroke-opacity="0.18"/><text style="font-family:var(--font-mono),monospace" x="189.0" y="143.0" font-size="17" font-weight="700" text-anchor="middle" fill="currentColor" fill-opacity="0.55">I</text><rect x="218" y="114" width="46" height="46" rx="7" fill="#7cb470"/><text style="font-family:var(--font-mono),monospace" x="241.0" y="143.0" font-size="17" font-weight="700" text-anchor="middle" fill="#0A081E" fill-opacity="1">E</text><rect x="10" y="166" width="46" height="46" rx="7" fill="currentColor" fill-opacity="0.05" stroke="currentColor" stroke-opacity="0.18"/><text style="font-family:var(--font-mono),monospace" x="33.0" y="195.0" font-size="14" font-weight="700" text-anchor="middle" fill="currentColor" fill-opacity="0.55">QU</text><rect x="62" y="166" width="46" height="46" rx="7" fill="currentColor" fill-opacity="0.05" stroke="currentColor" stroke-opacity="0.18"/><text style="font-family:var(--font-mono),monospace" x="85.0" y="195.0" font-size="17" font-weight="700" text-anchor="middle" fill="currentColor" fill-opacity="0.55">A</text><rect x="114" y="166" width="46" height="46" rx="7" fill="currentColor" fill-opacity="0.05" stroke="currentColor" stroke-opacity="0.18"/><text style="font-family:var(--font-mono),monospace" x="137.0" y="195.0" font-size="17" font-weight="700" text-anchor="middle" fill="currentColor" fill-opacity="0.55">T</text><rect x="166" y="166" width="46" height="46" rx="7" fill="currentColor" fill-opacity="0.05" stroke="currentColor" stroke-opacity="0.18"/><text style="font-family:var(--font-mono),monospace" x="189.0" y="195.0" font-size="17" font-weight="700" text-anchor="middle" fill="currentColor" fill-opacity="0.55">K</text><rect x="218" y="166" width="46" height="46" rx="7" fill="#7cb470"/><text style="font-family:var(--font-mono),monospace" x="241.0" y="195.0" font-size="17" font-weight="700" text-anchor="middle" fill="#0A081E" fill-opacity="1">R</text><rect x="10" y="218" width="46" height="46" rx="7" fill="currentColor" fill-opacity="0.05" stroke="currentColor" stroke-opacity="0.18"/><text style="font-family:var(--font-mono),monospace" x="33.0" y="247.0" font-size="17" font-weight="700" text-anchor="middle" fill="currentColor" fill-opacity="0.55">D</text><rect x="62" y="218" width="46" height="46" rx="7" fill="currentColor" fill-opacity="0.05" stroke="currentColor" stroke-opacity="0.18"/><text style="font-family:var(--font-mono),monospace" x="85.0" y="247.0" font-size="17" font-weight="700" text-anchor="middle" fill="currentColor" fill-opacity="0.55">K</text><rect x="114" y="218" width="46" height="46" rx="7" fill="currentColor" fill-opacity="0.05" stroke="currentColor" stroke-opacity="0.18"/><text style="font-family:var(--font-mono),monospace" x="137.0" y="247.0" font-size="17" font-weight="700" text-anchor="middle" fill="currentColor" fill-opacity="0.55">I</text><rect x="166" y="218" width="46" height="46" rx="7" fill="currentColor" fill-opacity="0.05" stroke="currentColor" stroke-opacity="0.18"/><text style="font-family:var(--font-mono),monospace" x="189.0" y="247.0" font-size="17" font-weight="700" text-anchor="middle" fill="currentColor" fill-opacity="0.55">O</text><rect x="218" y="218" width="46" height="46" rx="7" fill="currentColor" fill-opacity="0.05" stroke="currentColor" stroke-opacity="0.18"/><text style="font-family:var(--font-mono),monospace" x="241.0" y="247.0" font-size="17" font-weight="700" text-anchor="middle" fill="currentColor" fill-opacity="0.55">N</text><rect x="306" y="12" width="34" height="34" rx="6" fill="#7cb470"/><text style="font-family:var(--font-mono),monospace" x="323.0" y="35" font-size="15" font-weight="700" text-anchor="middle" fill="#0A081E">S</text><rect x="346" y="12" width="34" height="34" rx="6" fill="#7cb470"/><text style="font-family:var(--font-mono),monospace" x="363.0" y="35" font-size="15" font-weight="700" text-anchor="middle" fill="#0A081E">O</text><rect x="386" y="12" width="34" height="34" rx="6" fill="#7cb470"/><text style="font-family:var(--font-mono),monospace" x="403.0" y="35" font-size="15" font-weight="700" text-anchor="middle" fill="#0A081E">L</text><rect x="426" y="12" width="34" height="34" rx="6" fill="#7cb470"/><text style="font-family:var(--font-mono),monospace" x="443.0" y="35" font-size="15" font-weight="700" text-anchor="middle" fill="#0A081E">V</text><rect x="466" y="12" width="34" height="34" rx="6" fill="#7cb470"/><text style="font-family:var(--font-mono),monospace" x="483.0" y="35" font-size="15" font-weight="700" text-anchor="middle" fill="#0A081E">E</text><rect x="506" y="12" width="34" height="34" rx="6" fill="#7cb470"/><text style="font-family:var(--font-mono),monospace" x="523.0" y="35" font-size="15" font-weight="700" text-anchor="middle" fill="#0A081E">R</text><text x="306" y="72" font-size="14" fill="currentColor"><tspan font-weight="700">6 letters</tspan><tspan opacity="0.6">, worth </tspan><tspan font-weight="700" fill="#7cb470">4 points</tspan></text><line x1="306" y1="94" x2="570" y2="94" stroke="currentColor" stroke-opacity="0.14"/><rect x="306" y="112" width="12" height="12" rx="2.5" fill="#7cb470" fill-opacity="0.32"/><rect x="322" y="112" width="12" height="12" rx="2.5" fill="#7cb470" fill-opacity="0.32"/><rect x="338" y="112" width="12" height="12" rx="2.5" fill="#7cb470" fill-opacity="0.32"/><rect x="306" y="128" width="12" height="12" rx="2.5" fill="#7cb470" fill-opacity="0.32"/><rect x="322" y="128" width="12" height="12" rx="2.5" fill="#7cb470" fill-opacity="1"/><rect x="338" y="128" width="12" height="12" rx="2.5" fill="#7cb470" fill-opacity="0.32"/><rect x="306" y="144" width="12" height="12" rx="2.5" fill="#7cb470" fill-opacity="0.32"/><rect x="322" y="144" width="12" height="12" rx="2.5" fill="#7cb470" fill-opacity="0.32"/><rect x="338" y="144" width="12" height="12" rx="2.5" fill="#7cb470" fill-opacity="0.32"/><text x="368" y="123" font-size="14" font-weight="700" fill="currentColor">touching tiles</text><text x="368" y="141" font-size="13" fill="currentColor" opacity="0.6">any direction, diagonals included</text><text x="368" y="158" font-size="13" fill="currentColor" opacity="0.6">4 letters minimum</text><line x1="306" y1="182" x2="570" y2="182" stroke="currentColor" stroke-opacity="0.14"/><text x="306" y="204" font-size="14" font-weight="700" fill="currentColor">3:00 round</text><text x="570" y="204" font-size="13" fill="currentColor" opacity="0.6" text-anchor="end">0:30 break</text><rect x="306" y="214" width="223.3" height="12" rx="3" fill="#7cb470"/><rect x="532.3" y="214.5" width="37.2" height="11" rx="3" fill="none" stroke="currentColor" stroke-opacity="0.35" stroke-dasharray="3 3"/><text x="306" y="252" font-size="13" fill="currentColor" opacity="0.6">same board for everyone, every round</text>
</svg>
</figure>

The points you earn for words are based on the letters count

<figure>
<svg viewBox="0 0 580 244" role="img" aria-label="Points per word by length: 4 letters 1 point, 5 letters 2, 6 letters 4, 7 letters 8, 8 letters 15, 9 letters 25, 10 letters 40, 11 or more letters 60." style="max-width:100%;height:auto;color:inherit">
  <line x1="40" y1="196" x2="570" y2="196" stroke="currentColor" stroke-opacity="0.25"/>
  <rect x="52" y="193.0" width="44" height="3.0" rx="4" fill="#7cb470" fill-opacity="0.35"/><text x="74.0" y="185.0" font-size="13" font-weight="600" fill="currentColor" text-anchor="middle" style="font-family:var(--font-mono),monospace">1</text><text x="74.0" y="216" font-size="12" fill="currentColor" text-anchor="middle" opacity="0.7" style="font-family:var(--font-mono),monospace">4</text><rect x="116" y="191.0" width="44" height="5.0" rx="4" fill="#7cb470" fill-opacity="0.44"/><text x="138.0" y="183.0" font-size="13" font-weight="600" fill="currentColor" text-anchor="middle" style="font-family:var(--font-mono),monospace">2</text><text x="138.0" y="216" font-size="12" fill="currentColor" text-anchor="middle" opacity="0.7" style="font-family:var(--font-mono),monospace">5</text><rect x="180" y="186.0" width="44" height="10.0" rx="4" fill="#7cb470" fill-opacity="0.52"/><text x="202.0" y="178.0" font-size="13" font-weight="600" fill="currentColor" text-anchor="middle" style="font-family:var(--font-mono),monospace">4</text><text x="202.0" y="216" font-size="12" fill="currentColor" text-anchor="middle" opacity="0.7" style="font-family:var(--font-mono),monospace">6</text><rect x="244" y="176.0" width="44" height="20.0" rx="4" fill="#7cb470" fill-opacity="0.61"/><text x="266.0" y="168.0" font-size="13" font-weight="600" fill="currentColor" text-anchor="middle" style="font-family:var(--font-mono),monospace">8</text><text x="266.0" y="216" font-size="12" fill="currentColor" text-anchor="middle" opacity="0.7" style="font-family:var(--font-mono),monospace">7</text><rect x="308" y="158.5" width="44" height="37.5" rx="4" fill="#7cb470" fill-opacity="0.69"/><text x="330.0" y="150.5" font-size="13" font-weight="600" fill="currentColor" text-anchor="middle" style="font-family:var(--font-mono),monospace">15</text><text x="330.0" y="216" font-size="12" fill="currentColor" text-anchor="middle" opacity="0.7" style="font-family:var(--font-mono),monospace">8</text><rect x="372" y="133.5" width="44" height="62.5" rx="4" fill="#7cb470" fill-opacity="0.78"/><text x="394.0" y="125.5" font-size="13" font-weight="600" fill="currentColor" text-anchor="middle" style="font-family:var(--font-mono),monospace">25</text><text x="394.0" y="216" font-size="12" fill="currentColor" text-anchor="middle" opacity="0.7" style="font-family:var(--font-mono),monospace">9</text><rect x="436" y="96.0" width="44" height="100.0" rx="4" fill="#7cb470" fill-opacity="0.86"/><text x="458.0" y="88.0" font-size="13" font-weight="600" fill="currentColor" text-anchor="middle" style="font-family:var(--font-mono),monospace">40</text><text x="458.0" y="216" font-size="12" fill="currentColor" text-anchor="middle" opacity="0.7" style="font-family:var(--font-mono),monospace">10</text><rect x="500" y="46.0" width="44" height="150.0" rx="4" fill="#7cb470" fill-opacity="0.95"/><text x="522.0" y="38.0" font-size="13" font-weight="600" fill="currentColor" text-anchor="middle" style="font-family:var(--font-mono),monospace">60</text><text x="522.0" y="216" font-size="12" fill="currentColor" text-anchor="middle" opacity="0.7" style="font-family:var(--font-mono),monospace">11+</text>
  <text x="40" y="16" font-size="12" fill="currentColor" opacity="0.6">points per word</text>
  <text x="305" y="238" font-size="12" fill="currentColor" opacity="0.6" text-anchor="middle">word length (letters)</text>
</svg>
</figure>

Basically a [Boggle](https://en.wikipedia.org/wiki/Boggle) modernized.

But let's get to the point!

## Analyzing the requests

By checking the game page, the important requests I found where:

### The dictionary files

- `.../goodwords/words.txt?v=6eeb79b5190c` - dictionary
- `.../goodwords/freq.bin?v=6eeb79b5190c` - word frequencies
- `.../goodwords/vocab.json?v=6eeb79b5190c` - definition

The three static files all carry the same version tag, `?v=6eeb79b5190c`, hardcoded in the bundle:

```js
function Vn(){return"https://cdn-client.medium.com/lite/static/goodwords"}
function qn(){return"?v=6eeb79b5190c"}
```

- `words.txt` - 171,624 words, one per line. the words you type gets checked against this list.
- `freq.bin` - tells the game how common a word is.
- `vocab.json` - the definitions. used for the bonus clue and the "Worth knowing" list after each round.

### The websocket

The multiplayer part runs on `wss://goodwords.medium.com/api/play`. Protected under Cloudflare.

When the websocket fails, the game doesn't care. It just switches to **solo mode** and keeps going. Keep this in mind.

The messages are simple JSON:

```js
// client -> server
{ t: "hello", name, id, token }
{ t: "word", w: "pestered" }

// server -> client
{ t: "board", round, board, ... }
{ t: "ok", w }
```

## The game solves itself

After every round the game shows "X of Y points". To know `Y`, it has to find every possible word on the board. So the solver is already inside the bundle.

How it works:

1. Load `words.txt` into a **trie** (a letter tree)
2. Start from every tile
3. Walk to the nearby tiles, one letter at a time
4. Stop as soon as no word starts with those letters
5. Save every real word with 4+ letters

Pretty simple logic.

## Solo boards are predictable

In solo mode the board is not sent by any server. The game creates it from the current round number:

```js
const round = Math.floor(Date.now() / 210000); // 3m + 30s
const board = dealBoard(round);
```

`dealBoard` shuffles the 25 dice with a random generator seeded with the round number. Same round, same board, for everyone.

I ported it to Python and checked it against the original JS. Same boards, same words. So you can get the board of any round, even future ones.

## Building the extension

The extension does three things.

### 1. Read the board

Every tile in the page has its position in a `data-cell` attribute:

```html
<div data-testid="goodWordsBoard">
  <button data-cell="0">S</button>
  <button data-cell="1">QU</button>
  ...
</div>
```

So reading the board is just reading 25 buttons.

### 2. Find the words

Now we have the 25 letters. The extension downloads the same `words.txt` the game uses and runs the same search the game runs. So we validate an input exactly like the game does.

### 3. Submit a word

The input box is a React input. Setting `input.value` alone doesn't work, React ignores it. This does:

```js
Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, "value").set.call(input, word);
input.dispatchEvent(new Event("input", { bubbles: true }));
requestAnimationFrame(() => input.form.requestSubmit());
```

Set the value, tell React it changed, submit. The game then checks the word and sends it like you typed it.

## Demo

Here's the extension in action:

<div style="position:relative;aspect-ratio:16/9;margin-block:2.25em;border-radius:12px;overflow:hidden;border:1px solid var(--color-border)">
  <iframe src="https://www.youtube-nocookie.com/embed/mLdeQa603z8" title="Good Words Solver demo" style="position:absolute;inset:0;width:100%;height:100%;border:0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen loading="lazy"></iframe>
</div>


## Note

While writing this article I forgot a chrome window opened for some hours, getting me to the last 24h leaderboard

![leaderboard](https://takionapi.tech/blog/medium-good-words-solver/leaderboard.png)

seems I got noticed by some platers too

![message recived](https://takionapi.tech/blog/medium-good-words-solver/message.png)

A fun fact is that I discovered this new medium game while getting to the website in order to write an article about an IT / development cybersecurity company game, will publish it next week.


## Conclusion

And that's pretty much it. I added a nice UI just in case, but in the end it's a simple search over every word the available letters can make, checked against the game's own dictionary.

Did I achieve anything by doing this? Not at all. It was just for fun, to see how the game is made. It's not my intention to ruin anyone's game experience, and I don't recommend using this extension to anyone.

## Need help with Cloudflare?

[![TakionAPI, we handle the wall. You ship the rest.](https://takionapi.tech/og.webp)](https://takionapi.tech/bypass/cloudflare)


A websocket getting challenged by Cloudflare is the kind of thing that breaks every automation the moment it leaves a real browser. If you need to get through Cloudflare and friends without babysitting a headless browser, check out [TakionAPI](https://takionapi.tech), we know what we're doing.

Start right away with a [free trial](https://takionapi.tech/trial)

## Connect with me

If you enjoyed this article, follow me on GitHub and on Medium to receive notifications whenever I post or open-source something.

- [GitHub](https://github.com/glizzykingdreko)
- [Twitter](https://mobile.twitter.com/glizzykingdreko)
- [Medium](https://medium.com/@glizzykingdreko)
- [Email](mailto:glizzykingdreko@protonmail.com)
- [Buy me a coffee ❤️](https://www.buymeacoffee.com/glizzykingdreko)
- [TakionAPI](https://takionapi.tech)
