From ae50e62535f17803ff00139cf5d248706ac7f7a2 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 17 Nov 2026 04:21:29 +0000 Subject: [PATCH] =?UTF-8?q?Night=201:=20DESIGN.md=20v1=20freeze,=20=C2=A72?= =?UTF-8?q?.1=20starter=20decks,=20=C2=A78=20top-heavy=20target,=20trendDo?= =?UTF-8?q?wn=20off=20(#23)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Supersedes #18 and #21. Co-Authored-By: Claude Opus 5.5 --- docs/game/DESIGN.md | 107 +++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 101 insertions(+), 6 deletions(-) diff --git a/docs/game/DESIGN.md b/docs/game/DESIGN.md index 11cd6ba..262efcd 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) @@ -91,8 +92,9 @@ big cards are flexible. mono-faction deck gains no consistency edge (§10: no v1 keyword scales with faction count). ### 1.6 Trend (live, small, capped) -`trend` = +1 if `live.trendPercent ≥ trendUp` (default 25), −1 if `≤ trendDown` (default −25), -otherwise 0. A `null` value gives 0. Trend also needs `live.dailyAverage ≥ trendMinDaily` (default +`trend` = +1 if `live.trendPercent ≥ trendUp` (default 25), −1 if `≤ trendDown` (default **−200**, +which means there is **no down arrow in v1**: 69% of cards trend negative, so a ▼ would mostly land as +a quiet penalty on famous owned cards; modes can turn it back on), otherwise 0. A `null` value gives 0. Trend also needs `live.dailyAverage ≥ trendMinDaily` (default **20**), because percentages on tiny articles are noise; otherwise trend is 0. The host computes it **once at match start**, and it is frozen for the match. It shows as an arrow (▲/▼), not a number. It adds to power in every Topic. @@ -140,7 +142,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 +150,99 @@ 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`. +- **Relation to `docs/game/starter-cards.json`** (council-data, real frozen snapshots of random articles): that file is the + **loaner pool** for the sim and for "fill a slot with a loaner" in the deck builder. It is **not** the default starter decks. + The decks below pin their values on purpose, for two reasons. Famous, recognisable articles would all derive to cost 5–6. + And the random sample has no Space cards (CARD_DATA.md finding 6). +- **v1.1 note (factions):** CARD_DATA.md finding 6 shows the legacy `category()` split as Culture 53%, People 30%, Nature 9%, + History 5%, Science 3%, Space 0%. Owned decks will therefore be about 50% viral and 30% local. Viral is the weakest keyword, so a typical owned deck + may be *weaker* than the starter decks. That's the wrong way round for "NFTs give variety, not power". v1 ships as is. + For v1.1, sim-balance runs a **realistic owned deck** (12 cards drawn from `card-sample.json` with its real category mix) + against each starter. If it wins under 45%, viral gets buffed first (e.g. cap 3, or a minimum of +1). The P31-based factions council-data proposes (People, Places, Nature, Works & Culture, + Structures, Events & Ideas) are the v2 fix, and would need the host to fetch P31 (it isn't in `PageEnrichment`). + +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 @@ -263,7 +358,7 @@ the last turn's, and every "at scoring" Portal resolves **before** Topics are ju | Line | Why it isn't dominant | |---|---| -| All-famous (all max-stat) deck | It becomes an all-cost-5/6 deck with dead early turns. Cheap cards are more efficient **per energy**, expensive cards **per card**. Only 9 cards are seen per match (3 + 6 draws), so both matter. The 1-energy carry-over lets a heavy deck bank energy for a turn-5 six-drop. **sim-balance target: heavy vs curve ≥ 40%.** | +| All-famous (all max-stat) deck | It becomes an all-cost-5/6 deck with dead early turns. Cheap cards are more efficient **per energy**, expensive cards **per card**. Only 9 cards are seen per match (3 + 6 draws), so both matter. An all-cost-5/6 deck is **weak by design**: it has four dead turns (sim-balance interim: 0–15%). There is no hard deck rule in v1; the deck builder warns when a deck has fewer than 4 cards of cost ≤ 2, and every starter deck is curve-shaped (§2.1). **sim-balance target: a **top-heavy curve** (half the deck at cost 4 or more) vs curve ≥ 40%.** `energyByTurn [2..7]` is a v1.1 candidate. | | All-cheap flood (cost 1–2) | Weak by design: only 9 slots and 9 cards seen. Critic's sim under these rules: swarm vs curve about 7–11%. Its home is Culture's wide-turn keyword (§10). | | All one faction | No v1 keyword scales with faction count. `factionSynergyCap` is reserved for modes. Culture, the largest pool, has the weakest keyword (viral). | | "Always play the highest-power card" | It ignores the on-topic bonus, lane capacity and the hidden Portals. Critic's sim: 18–21% against a smart bot (target < 55%). | @@ -295,7 +390,7 @@ The engine takes a `RulesConfig` object. Peer-hosted modes override it (§11). D "powerByCost": [0, 1, 2, 4, 6, 8, 10], "onTopicBonus": [0, 1, 1, 2, 2, 3, 3], "vanillaBonus": 1, "keywordsEnabled": ["viral","rising","local","encyclopedic","nostalgic","translated"], "ownedCards": true, - "trendUp": 25, "trendDown": -25, "trendMinDaily": 20, "uncheckedCostCap": 4, + "trendUp": 25, "trendDown": -200, "trendMinDaily": 20, "uncheckedCostCap": 4, "factionSynergyCap": 3, "verifyStats": true, "percentiles": "card-sample-2026-11-16",