diff --git a/docs/game/DESIGN.md b/docs/game/DESIGN.md index 11cd6ba..03341f8 100644 --- a/docs/game/DESIGN.md +++ b/docs/game/DESIGN.md @@ -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:`, 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