DUEL_DESIGN v1.2: secondPlayerCitations 1 (balance v1, #64), targets, Location finding

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-17 23:43:18 -05:00
co-authored by Claude Opus 5.5
parent 6182dff1cd
commit 6e97e2c8ee
+4 -3
View File
@@ -1,6 +1,6 @@
# WikiDeck Duel: design v1 # WikiDeck Duel: design v1
**Status:** v1.1, Night 2 (2026-11-17): v1 plus night-review's nits on PR #66 and duel-cards' implementation choices from PR #70. Owner: duel-design (issue #60). **Status:** v1.2, Night 2 (2026-11-17): v1 plus night-review's nits on PR #66, duel-cards' implementation choices from PR #70, and the balance v1 second-player rule (#64). Owner: duel-design (issue #60).
**Base:** `docs/night2/BRIEF.md` (Eric's locked decisions). Where this file and BRIEF disagree, BRIEF wins. Reviews used: designer (rules), data §2–4 (derivation), critic S7 (tone). **Base:** `docs/night2/BRIEF.md` (Eric's locked decisions). Where this file and BRIEF disagree, BRIEF wins. Reviews used: designer (rules), data §2–4 (derivation), critic S7 (tone).
**Consumers:** duel-core (`shared/duel/` engine and `types.ts`), duel-cards (`classify/derive/effects/text.ts`), sim-balance (bots, `DUEL_BALANCE.md`), ui-duel / ui-pvp (faces, recap), host-pvp (rulesets). **Consumers:** duel-core (`shared/duel/` engine and `types.ts`), duel-cards (`classify/derive/effects/text.ts`), sim-balance (bots, `DUEL_BALANCE.md`), ui-duel / ui-pvp (faces, recap), host-pvp (rulesets).
@@ -30,6 +30,7 @@ Testnet end-to-end mode files may lower `deckSize`. Production stays at 40.
- **Empty library:** drawing from an empty library loses (`libraryEmpty: 'lose'`). - **Empty library:** drawing from an empty library loses (`libraryEmpty: 'lose'`).
- **Opening hand:** `openingHand` **7**. One mulligan (`mulligans: 1`): shuffle, draw 7, put 1 on the bottom. - **Opening hand:** `openingHand` **7**. One mulligan (`mulligans: 1`): shuffle, draw 7, put 1 on the bottom.
- **First player** (seeded coin flip) skips their first draw. - **First player** (seeded coin flip) skips their first draw.
- **Second player** gets +1 Citation maximum on their first turn only (`secondPlayerCitations` **1**). Balance v1: this moved the first-player win rate from 60.1% to 54.4% in 1,500 heuristic-mirror matches (engine 4623930, #64). Neither an extra opening card (washed out by the mulligan and the hand limit) nor `firstPlayerDraws` worked.
### 2.3 Turn structure: refresh → draw → main → combat → end ### 2.3 Turn structure: refresh → draw → main → combat → end
1. **Refresh.** Citation maximum +1 (to `maxCitations` **10**), plus Territory (§2.5). Citations refill to the maximum. Your permanents untap. "Pending review" ends for your Figures. Start-of-turn triggers (Stub, Institutions) resolve in the order the permanents entered. 1. **Refresh.** Citation maximum +1 (to `maxCitations` **10**), plus Territory (§2.5). Citations refill to the maximum. Your permanents untap. "Pending review" ends for your Figures. Start-of-turn triggers (Stub, Institutions) resolve in the order the permanents entered.
@@ -63,7 +64,7 @@ Classification order (duel-cards owns it): P31 → P279 anchor classes → P31 l
### 2.6 Clock and length ### 2.6 Clock and length
- `turnSeconds` **60** per turn plus `bankSeconds` **300** per player. The turn timer runs first; when it expires, the player's bank drains; when the bank is also empty, the turn passes (`timeout` action). The bank does not refill. Three timeouts in a row concede. - `turnSeconds` **60** per turn plus `bankSeconds` **300** per player. The turn timer runs first; when it expires, the player's bank drains; when the bank is also empty, the turn passes (`timeout` action). The bank does not refill. Three timeouts in a row concede.
- No turn cap by default. If the sim shows stalls, add `turnCap` (suggested 20 turns each; at the cap the higher Notability wins, then the higher total power in play, then the second player). - No turn cap by default. If the sim shows stalls, add `turnCap` (suggested 20 turns each; at the cap the higher Notability wins, then the higher total power in play, then the second player).
- **Sim targets** (for sim-balance): median 8–11 turns each; first-player win rate 48–54%; < 5% of games reach turn 20 each. - **Sim targets** (agreed with sim-balance, #64): median 8–12 turns each; first-player win rate 48–54%; < 5% of games past 20 turns each. Balance v1 baseline with Doctrines working: median 8, p90 12, 3.4% past 20, so no `turnCap` is needed.
### 2.7 Determinism ### 2.7 Determinism
All randomness (shuffles, coin flip, template variants) comes from the match seed via `shared/game/rng.ts`. The same seed and actions always replay to the same state, log and recap. All randomness (shuffles, coin flip, template variants) comes from the match seed via `shared/game/rng.ts`. The same seed and actions always replay to the same state, log and recap.
@@ -275,4 +276,4 @@ Sample log:
## 11. Open questions for the sim (not blockers) ## 11. Open questions for the sim (not blockers)
1. Disaster T4 at k−1 may be weak against 40-card boards; try k. 1. Disaster T4 at k−1 may be weak against 40-card boards; try k.
2. Stub at +2 counters on cheap bodies may be too strong (33% of Figures); try max 1. 2. Stub at +2 counters on cheap bodies may be too strong (33% of Figures); try max 1.
3. With 33% Locations in random collections and a Territory cap of 2, decks may flood; consider letting extra Locations cycle ("When this enters, if you control 3 or more Locations, draw a card") as a v2 template. 3. **Locations (balance v1 finding):** Location-heavy decks win ~20% and Locations are the weakest cards. `territoryCap` 3, `locationsPerTurn` 2 and `garrisonStep` 15 move them ±3 points at most. Proposal under test: T2 gains "When this enters, draw a card" (a plain `onEnter` + `draw` effect, no condition), so a Location replaces itself.