
2026 · Chrome Extension · Manifest V3
Catan Colonist Buddy
Colonist only tells you how many cards a player holds. The log tells you which ones.
Unofficial · reads the log only · not affiliated with Colonist
The log already knows every card.
It just never does the arithmetic.
The panel
Every hand, as an exact total and an honest range.
Each row is one player. The large number is their total hand size; the five values beneath it are wood, brick, sheep, wheat and ore. A plain number means every hand still consistent with the log agrees. A highlighted range like 2-3 means the log genuinely cannot tell those apart.
A green header marks your own row. The DICE strip is a roll histogram for the match, so you can see whether the numbers are behaving. Everything is drawn in place, over the game you are already playing.

The match
It reads the same log you do.
Every roll, gain, build, trade, steal, discard and monopoly is written into the feed. The extension tokenises each virtualised row into words, resource icons and dice, then parses the tokens into a typed card event. Chat, setup placement and dev-card announcements are filtered out first, so a word like “built” in conversation can never be mistaken for an event.

It reads the DOM and draws a panel. It never clicks, sends, or mutates the game.
How it works
From log line to possible world.
Everything above the DOM layer is pure logic, and it is unit-tested under Node.
01
Tokenise
Words, resource icons and dice are pulled out of each row in the virtualised feed.
02
Parse
Tokens become typed card events: gain, spend, bank trade, player trade, steal, monopoly or roll.
03
Replay
A weighted set of complete hand assignments is pruned by every event until only consistent worlds survive.
04
Summarise
Surviving worlds collapse into per-player minima, maxima and expected values for the panel.
When the log contradicts the tracked state — a missing line, a misread event — the panel flags a ⚠ desync instead of guessing. If a card gain is missing after a disconnect, it credits the obvious deficit and marks the row ⚙ auto-adjusted. Honest uncertainty beats a confident wrong answer.
Privacy
Nothing leaves the browser.
There are no host permissions, no network requests, no analytics and no remote code. The content script runs only on colonist.io. The single stored value is the player name you pick, kept in localStorage.
0
manifest permissions
0
network calls
0
analytics
100%
local logic
A visible steal is exact. An unseen one is a distribution. The panel never pretends the log knows more than it does — and that is precisely why you can trust it.
Scope
Strictly what is in the log.
Only the log
Cards played face down, or production missed by not scrolling, can only be inferred — hence ranges and the auto-adjust note.
English client
Every keyword is matched against the English log text.
Chrome, Manifest V3
Load unpacked from chrome://extensions. Version 0.7.7, MIT licensed.
Fragile by nature
Colonist ships hashed CSS class names; discovery relies on stable prefixes and can break after a client update.
Read the log for yourself.
One content script, one manifest, no build step. Clone the repo, load it unpacked, and open any Colonist game.