docs(game): starter cards file, mode-variable fields

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-16 22:49:12 -05:00
co-authored by Claude Opus 5.5
parent 01b83f9c9f
commit f808f963c6
+8 -1
View File
@@ -112,7 +112,8 @@ The engine itself does no I/O: it receives already-checked `CardInput`s.
- **Owned cards:** any card the player's wallet owns at match start. Ownership is read off-chain. The
match never moves, locks or burns a card.
- **Loaner cards:** off-chain preview cards with a fixed `CardInput`, shipped with the game data
(`shared/game/loaners.json`). They are drawn from `shared/catalog.ts` and council-data's sample.
(`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.
- **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. A new player picks one and can play at once.
@@ -250,6 +251,12 @@ The engine takes a `RulesConfig` object. Peer-hosted modes override it (§11). D
(`energyByTurn[t-1]` replaces "energy = t" in §5 so that modes can change the ramp.)
**What modes may vary:** every key above, plus `topicPool` contents and the starter-deck lists.
**Fixed for all modes:** matches are off-chain and never move or burn NFTs; the RNG and its draw order
(§4); the shape of the derivation (§1: percentile → fame → cost → power); at most one keyword per card;
the phases of a turn (§5).
A mode must keep `turns × turnSeconds ≤ 240` so that matches stay within 3–6 minutes.
---
## 10. Keywords *(owner: council-designer-b)*