diff --git a/docs/game/DESIGN.md b/docs/game/DESIGN.md index 3340094..090b52b 100644 --- a/docs/game/DESIGN.md +++ b/docs/game/DESIGN.md @@ -92,10 +92,12 @@ 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), +`trend` = +1 if `live.trendPercent ≥ trendUp` (default 25), −1 if `≤ trendDown` (default **−200**, i.e. off: there is no down arrow in v1), 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. +the match. It shows as an arrow (▲), not a number. It adds to power in every Topic. *Why no ▼ in v1:* 69% of the sample has a +negative `trendPercent`, and only busy (mostly owned, famous) cards pass `trendMinDaily`, so a ▼ would quietly penalise collectors. +Modes may turn it back on with e.g. `trendDown: -25`. ### 1.7 Rarity The hash-derived `rarity` (`shared/protocol.ts:38`) is **cosmetic in v1** (frame colour only). Mining luck must not @@ -159,7 +161,9 @@ These are the default `starterDecks`: four 12-card loaner decks. 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`. +- **Loaner ids:** `cardId` = `loaner:`, and `pageId` = the article's real pageId (v1 pins the 4 `shared/catalog.ts` ones: Moon 19331, Periodic table 23053, Octopus 22780, + Albert Einstein 736; the rest are filled in from one batched API call in v1.1, `null` until then). The copy limit counts per `pageId` + together with owned copies (§2); a loaner with `pageId: null` counts 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. @@ -389,7 +393,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",