Catan Card Tracker for Colonist.io

About

A polished, real-time analytics overlay for Colonist.io. Reads the public game log and gives you a complete picture of every player's hand, plus advanced predictions for who's likely to win and how lucky each player has been.

WHAT'S NEW (v2.3)
- Brand-new Game Theme UI: dark navy + neon green design
- Win Predictor tab with weighted scoring across VP, production, army/road lead, dev cards, luck
- Luck Factor with combined roll-count + VP decay so early-game events count more
- Dev Card VP Suspicion: held cards accumulate VP probability the longer they sit unused
- Unknown Pool tracking: hover the ? count to see which resources could be in a player's hand
- Cities scored separately for snowball advantage
- Hot/Cold dice ranking using Laplace-smoothed deviation (handles zero-actual cases correctly)
- Resource text pills replace SVG icons in the log for cleaner readability
- Player names colored in their actual game color throughout the log

CARD TRACKING
- Per-player resource breakdown (Wood, Brick, Sheep, Wheat, Ore)
- Smart deduction from trades, builds, steals, discards, monopoly, year of plenty, road building
- Auto-corrects against the game's authoritative card-count badge (both up and down)
- Unknown card pool with type-possibility tracking — hover to see what types could be there
- Mid-game start supported: syncs with the site totals so you don't need to be there from turn 1

WIN PREDICTOR
- Weighted score combining VP (50), resources (1.5), army (lead-relative), road (lead-relative), dev cards held (6), production capacity (5), city snowball bonus (12), luck momentum (3), dev card VP suspicion (1.5)
- Lead-relative army/road scoring rewards players approaching the LA/LR thresholds
- Leader gets a glowing crown highlight
- Each player's bar uses their actual game color

LUCK FACTOR
- Per-player weighted luck score: positive for resources gained from dice, negative for steals (2x weight) and discards (2x weight)
- Combined decay: weight = 1 / (1 + rollCount × 0.015 + maxVP × 0.08) so early-game events count more
- Diverging bar visualization with gain/loss breakdown

DICE STATISTICS
- Total Rolls + Hot/Cold ranking using smoothed actual-vs-expected ratios
- Polished histogram with gradient bars, glow on 6/8, dashed expected curve overlay
- Robber Rate & Variance quick-stat tiles

STATS TAB
- Robber activity card (current robber holder & last person who robbed you)
- Dev card summary with bought/played/remaining pills and per-player chips (knight/monopoly/YoP/road building)
- Steal Matrix: who stole from whom, with totals

GAME LOG TAB
- Color-coded player names matching their game color
- Resource text pills (e.g. `2 Wheat`, `1 Brick`) instead of SVG icons
- Hand snapshot in monospace below each entry: `[W:2 B:1 S:0 Wh:3 O:1 ?:0 =7]`
- Filter chips with colored player dots — clicking one filters the log to that player
- Copy log to clipboard button
- Robber move locations rendered as `Ore (6)` instead of raw `prob_6 Ore`

PLAYER INFO OVERLAY
- Replaces colonist.io's player info panel with a richer compact view
- Shows VP, total cards, dev cards, army size, longest road, plus all 5 resources + Unknown
- Active player highlighted with green glow ring
- Hover Unknown to see possible resource types and counts
- Toggle the entire UI off to compare with original colonist.io interface

QUALITY OF LIFE
- 4 tabs: Log, Stats, Predict, Dice (keyboard shortcuts 1/2/3/4)
- Floating tab bar pinned to bottom of log container, repositions on chat open/close
- Persists across page reloads (action replay system)
- MutationObserver for real-time message capture (no missed events)
- Reset button (R) to clear and reprocess from scratch

HOW IT WORKS
The extension reads the public game log every player can see. It automates the card counting that competitive Catan players do mentally. No private data accessed, no gameplay modified, nothing sent to external servers.

CONTROLS
- CT button (bottom-right): Toggle tracker UI on/off
- R button (bottom-right): Reset game data and reprocess from log
- Keyboard 1/2/3/4: Switch between Log/Stats/Predict/Dice tabs