diff --git a/docs/game/DESIGN.md b/docs/game/DESIGN.md index 2030ab3..2a7f335 100644 --- a/docs/game/DESIGN.md +++ b/docs/game/DESIGN.md @@ -66,9 +66,15 @@ down. A `null` attention gives `pct_attention = null`. ### 1.2 Fame → Cost `fame` = the integer mean (rounded half up) of the non-null percentiles. `cost` = 1 + the number of thresholds in `costThresholds` (5 ascending values, default -`[15, 35, 55, 75, 90]`) that are ≤ `fame`. So cost runs 1–6. -The defaults aim at a pool cost spread of about 15/20/20/20/15/10 %. They are retuned from the -sample's fame distribution. +`[26, 39, 51, 63, 78]` in v1.1) that are ≤ `fame`. So cost runs 1–6. +**Thresholds are data, not guesses (v1.1).** `fame` is a *mean* of up to 3 percentiles, so it clusters +around 50 even though each percentile is uniform. The v1.0 values `[15, 35, 55, 75, 90]` treated fame as +uniform, so 82% of the pool landed on cost 2–4 (3/23/37/22/10/5 %). `costThresholds` is therefore set to +the fame values at the **15/35/55/75/90 % points of the reference sample** (the same `card-sample.json` +whose `percentiles` table §1.1 uses). That's the integer set that brings the sample's cost spread closest +to the target 15/20/20/20/15/10 %. The v1.1 defaults come from the 236-card sample (fame 8–98) and +give 13/20/22/20/15/10 %. Whenever council-data refreshes the sample, the percentile table and +`costThresholds` are regenerated together and ship as one change. Pinned loaners (§2.1) are unaffected. ### 1.3 Power `power` = `powerByCost[cost]`, default `[_, 1, 2, 4, 6, 8, 10]` (cost 1 → 1 … cost 6 → 10). The @@ -382,7 +388,7 @@ The engine takes a `RulesConfig` object. Peer-hosted modes override it (§11). D ```json { - "version": "1.0", + "version": "1.1", "deckSize": 12, "maxCopiesPerPage": 2, "maxLoaners": 12, "openingHand": 3, "handLimit": 7, "mulligan": false, "turns": 6, "turnSeconds": 25, "afkTurns": 2, @@ -391,7 +397,7 @@ The engine takes a `RulesConfig` object. Peer-hosted modes override it (§11). D "topicPool": [ /* inline Topic objects {id, name, stat, portal}; default = the 9 in §10.3 */ ], "keywordParams": { /* per-keyword numbers, keyed by keyword id (§10) */ }, "portalParams": { /* per-Portal numbers, keyed by Topic id (§10.3) */ }, - "costThresholds": [15, 35, 55, 75, 90], + "costThresholds": [26, 39, 51, 63, 78], "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"], "cultureKeyword": "home", "ownedCards": true,