Getting Started
Three ways to play
Section titled “Three ways to play”1. Browser, zero install (recommended)
Section titled “1. Browser, zero install (recommended)”npx @mcptoolshop/sovereignThis downloads the package, opens the digital simulator in your default browser, and exits. No global install required. The CLI accepts a few flags:
npx @mcptoolshop/sovereign --print # the printable 34-sheet board gamenpx @mcptoolshop/sovereign --start # audience-routed landing page (player / designer / auditor)npx @mcptoolshop/sovereign --path # print the playable HTML path and exitnpx @mcptoolshop/sovereign --help # all flags2. Hosted (no install at all)
Section titled “2. Hosted (no install at all)”Open https://mcp-tool-shop-org.github.io/sovereign/ in any modern browser. Click Play now.
3. Offline release bundle
Section titled “3. Offline release bundle”Each tagged release attaches sovereign-vX.Y.Z-release.zip to its GitHub Release page. Download it, unzip, and double-click 00-START-HERE.html. Everything runs offline.
What you need
Section titled “What you need”- A modern browser (Chrome / Firefox / Safari / Edge — anything from the last 3 years).
- For
npx: Node 18 or newer. - Nothing else. No account, no key, no network connection during gameplay.
First game
Section titled “First game”The default game seats you (slot 0) against:
- Hamilton (Treasury / Finance) — slot 1.
- Morris (Merchant / Infrastructure) — slot 2.
7 laps, 21 turns total. The header shows seed: 2026 — that’s the default deterministic seed.
Click Roll dice, Buy / Decline / Bid / Vote as the surfaces present them. Every decision lands in the Ledger (bottom panel) with a human-readable reason.
When the game ends, the Endgame Report appears automatically with your Influence breakdown vs. the opponents’. The post-game Balance Report sits below it.
File map
Section titled “File map”After npm install @mcptoolshop/sovereign (or unzipping the release):
release/├── 00-START-HERE.html ← hyperlinked entry point├── README.txt ← plain-text version├── CHANGELOG.md ← v0.2 → v0.10 evolution├── board-game/│ ├── sovereign-board-game.html ← printable 34-sheet board game│ ├── sovereign-economy-audit.html│ └── sovereign-print-audit.html├── digital-mode/│ ├── sovereign-solo.html ← the playable digital game│ └── sovereign-v0.10-freeze-audit.html├── balance-evidence/ ← all v0.10 batch reports + raw JSON└── design-history/ ← Phase 1 concept + Phase 2–5 audits- How to play — the actual game loop, board, Acts, and scoring.
- Profiles — what your scripted opponents do, and why.