docs/game/DESIGN.md: s2.1 starter decks v1 (4 loaner decks, pinned values)

Four 12-card loaner decks (Stargazers, Field Guide, Headliners, Pioneers):
identical curve 1,1,2,2,3,3,3,4,4,5,5,6, two factions x6, homes 4/4/4,
all 6 factions and all 4 catalog cards covered. Loaners carry
pinned {cost, home, faction} (CardInput.pinned) until council-data's
starter-cards.json exists; everything downstream (powerByCost, on-topic,
keywords) still comes from the rules config.

Refs #1.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-16 23:12:33 -05:00
co-authored by Claude Opus 5.5
parent 6fb9a2e8b4
commit 6ba2bc3a56
+88 -2
View File
@@ -52,7 +52,8 @@ The engine never reads raw 0–100 stats as power. Every game card is derived **
CardInput = { cardId, pageId, title, category, rarity,
snapshot: MintStatsSnapshot, // at mint, immutable
live: { trendPercent: number | null, dailyAverage: number | null }, // frozen at match start
check: 'verified' | 'unverified' | 'unchecked' | 'loaner' } // set by the host (§1.10)
check: 'verified' | 'unverified' | 'unchecked' | 'loaner', // set by the host (§1.10)
pinned?: { cost, home, faction } } // loaners only (§2.1): replaces §1.1–1.5
```
### 1.1 Percentiles (rank-normalisation)
@@ -140,7 +141,7 @@ The engine does no I/O and only ever sees one version of each card.
- **Loaner cards:** off-chain preview cards with a fixed `CardInput`, shipped with the game data
(`docs/game/starter-cards.json`, picked by council-data: about 24 pageIds across all 6 categories,
with frozen, hand-checked snapshot stats, including the 4 cards in `shared/catalog.ts`).
Loaners follow the same derivation, so they are no weaker or stronger than owned cards.
Loaners follow the same curve (§2.1 pins their cost, home and faction), so they are no weaker or stronger than owned cards.
- **Starter decks:** `starterDecks` (default: 4 fixed 12-card loaner decks). Each one has two leading
factions and an average cost of 3.0–3.3, and is **curve-shaped**: at least 3 cards of cost 4 or more,
and at most 4 of cost 1. A new player picks one and can play at once.
@@ -148,6 +149,91 @@ The engine does no I/O and only ever sees one version of each card.
means no limit). Owning NFTs gives **variety**, not power: owned and loaner cards follow the same
curve.
### 2.1 Starter decks v1 *(owner: council-designer-b)*
These are the default `starterDecks`: four 12-card loaner decks.
- **Every deck has the same curve:** costs `1,1,2,2,3,3,3,4,4,5,5,6`. That's an average of 3.25, with 5 cards of cost 4 or more and 2 of cost 1.
- **Every deck has the same shape:** 6 cards from each of two factions, and 4 cards for each home stat. So every deck can play on-topic in every lane.
- **Loaner values are pinned.** council-data's percentile table and `starter-cards.json` don't exist yet, so a loaner carries
`pinned: { cost, home, faction }`. For `check: 'loaner'` the engine takes these instead of §1.1–1.5.
Everything after them still applies: `powerByCost`, `onTopicBonus`, `vanillaBonus`, the §10.1 keyword choice and `keywordParams`.
A mode that changes those numbers changes loaners exactly as it changes owned cards.
- **Pinned cost isn't fame.** Cost was set by hand to fit the curve, not from the article's fame. Rarity is `Common` (frame only) and trend is 0.
- **Loaner ids:** `cardId` = `loaner:<kebab-title>`, and `pageId` = the article's real pageId if the UI has it, otherwise `null`. Copies are counted per `cardId`.
- **Later:** if council-data later publishes `starter-cards.json` with real snapshots, it may replace these values in v1.1.
It must keep the same curve and home-stat spread.
Keywords follow from §10.1: cost 1 → vanilla, otherwise the faction keyword (shown in brackets).
**A. Stargazers: Space (translated) + Science (encyclopedic)**
| Cost | Card | Faction | Home |
|---|---|---|---|
| 1 | Moon | Space | reach |
| 1 | Electron | Science | depth |
| 2 | Mars | Space | attention |
| 2 | Periodic table | Science | depth |
| 3 | Saturn | Space | reach |
| 3 | Photosynthesis | Science | attention |
| 3 | Black hole | Space | depth |
| 4 | Quantum mechanics | Science | reach |
| 4 | Milky Way | Space | attention |
| 5 | DNA | Science | attention |
| 5 | Sun | Space | reach |
| 6 | Theory of relativity | Science | depth |
**B. Field Guide: Nature (rising) + History (nostalgic)**
| Cost | Card | Faction | Home |
|---|---|---|---|
| 1 | Octopus | Nature | depth |
| 1 | Stonehenge | History | attention |
| 2 | Axolotl | Nature | attention |
| 2 | Rosetta Stone | History | reach |
| 3 | Coral reef | Nature | depth |
| 3 | Roman Empire | History | reach |
| 3 | Honey bee | Nature | attention |
| 4 | Ancient Egypt | History | depth |
| 4 | Amazon rainforest | Nature | reach |
| 5 | Blue whale | Nature | attention |
| 5 | Great Wall of China | History | reach |
| 6 | World War II | History | depth |
**C. Headliners: People (local) + Culture (viral)**
| Cost | Card | Faction | Home |
|---|---|---|---|
| 1 | Haiku | Culture | attention |
| 1 | Ada Lovelace | People | depth |
| 2 | Jazz | Culture | attention |
| 2 | Marie Curie | People | reach |
| 3 | Mona Lisa | Culture | reach |
| 3 | Frida Kahlo | People | attention |
| 3 | Chess | Culture | depth |
| 4 | Leonardo da Vinci | People | reach |
| 4 | The Beatles | Culture | attention |
| 5 | William Shakespeare | People | depth |
| 5 | Olympic Games | Culture | reach |
| 6 | Wolfgang Amadeus Mozart | People | depth |
**D. Pioneers: People (local) + Space (translated)**
| Cost | Card | Faction | Home |
|---|---|---|---|
| 1 | Sputnik 1 | Space | reach |
| 1 | Nikola Tesla | People | attention |
| 2 | Hubble Space Telescope | Space | depth |
| 2 | Isaac Newton | People | reach |
| 3 | Neil Armstrong | People | attention |
| 3 | Jupiter | Space | reach |
| 3 | Galileo Galilei | People | depth |
| 4 | Albert Einstein | People | attention |
| 4 | International Space Station | Space | depth |
| 5 | Apollo 11 | Space | attention |
| 5 | Charles Darwin | People | reach |
| 6 | Solar System | Space | depth |
- **Coverage:** all 6 factions appear, and all 4 `shared/catalog.ts` cards are included (Moon, Periodic table, Octopus, Albert Einstein).
- **Tutorial:** Field Guide vs Stargazers, seed 1, against the easy bot.
- **sim-balance:** please run the 4 decks round robin first. The target is every pairing at 45–55%. If a pairing misses, retune by
swapping home stats within a deck, never by changing the curve.
---
## 3. Board