diff --git a/docs/game/DESIGN.md b/docs/game/DESIGN.md index 530ad7f..70bb5d9 100644 --- a/docs/game/DESIGN.md +++ b/docs/game/DESIGN.md @@ -206,7 +206,10 @@ The match lasts `turns` turns (default **6**, hard cap). Each turn has these pha min(`energyCarryMax`, unspent energy from last turn), default max **1**. Saving one energy on turn 2 makes a turn-3 four-drop possible: a real tempo choice. - Each player draws 1 card if their deck isn't empty and their hand holds fewer than `handLimit` - (default **7**) cards. Otherwise they don't draw. + (default **7**) cards. Otherwise they don't draw. This includes turn 1, so the turn-1 hand is + 3 + 1 = 4 cards. + - Order within Start: Portal reveal, then energy, then draw. The Underdog check (step 2) comes after + all three. 2. **Underdog check** (mode option, `underdog: false` by default, because it can be sandbagged). When it's on, from turn 2, a player who leads in 0 Topics while the opponent leads in ≥ 2 gets **+1 energy** this turn. @@ -221,8 +224,8 @@ The match lasts `turns` turns (default **6**, hard cap). Each turn has these pha reveal in order. - Each card enters its Topic and its "on reveal" effect resolves at once. - So the order in which you queue cards matters: lead with the card you want resolved first. - - A queued play that is no longer legal at reveal (the lane is full or the card was removed) goes - back to hand and its energy is lost. + - Energy is reserved when a card is queued. A queued play that is no longer legal at reveal (the + lane is full, or a Portal rejects it) **fizzles**: the card stays in hand and its energy is lost. 5. **End** - Recompute all Topic powers (§6). - End-of-turn effects resolve, the initiative player's first. @@ -287,7 +290,9 @@ The engine takes a `RulesConfig` object. Peer-hosted modes override it (§11). D "turns": 6, "turnSeconds": 25, "afkTurns": 2, "energyByTurn": [1, 2, 3, 4, 5, 6], "energyCarryMax": 1, "bonusEnergy": 0, "underdog": false, "topicCount": 3, "distinctStats": true, "portalReveal": [2, 3, 4], "laneCapacity": 3, - "topicPool": "default", + "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], "powerByCost": [0, 1, 2, 4, 6, 8, 10], "onTopicBonus": [0, 1, 1, 2, 2, 3, 3], "vanillaBonus": 1,