forked from WikiDeck/wikideck
Night 1: DESIGN.md v1 freeze, §2.1 starter decks, §8 top-heavy target, trendDown off (#23)
Supersedes #18 and #21. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit was merged in pull request #23.
This commit is contained in:
+101
-6
@@ -52,7 +52,8 @@ The engine never reads raw 0–100 stats as power. Every game card is derived **
|
||||
CardInput = { cardId, pageId, title, category, rarity,
|
||||
snapshot: MintStatsSnapshot, // at mint, immutable
|
||||
live: { trendPercent: number | null, dailyAverage: number | null }, // frozen at match start
|
||||
check: 'verified' | 'unverified' | 'unchecked' | 'loaner' } // set by the host (§1.10)
|
||||
check: 'verified' | 'unverified' | 'unchecked' | 'loaner', // set by the host (§1.10)
|
||||
pinned?: { cost, home, faction } } // loaners only (§2.1): replaces §1.1–1.5
|
||||
```
|
||||
|
||||
### 1.1 Percentiles (rank-normalisation)
|
||||
@@ -91,8 +92,9 @@ 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),
|
||||
otherwise 0. A `null` value gives 0. Trend also needs `live.dailyAverage ≥ trendMinDaily` (default
|
||||
`trend` = +1 if `live.trendPercent ≥ trendUp` (default 25), −1 if `≤ trendDown` (default **−200**,
|
||||
which means there is **no down arrow in v1**: 69% of cards trend negative, so a ▼ would mostly land as
|
||||
a quiet penalty on famous owned cards; modes can turn it back on), 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.
|
||||
|
||||
@@ -140,7 +142,7 @@ The engine does no I/O and only ever sees one version of each card.
|
||||
- **Loaner cards:** off-chain preview cards with a fixed `CardInput`, shipped with the game data
|
||||
(`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.
|
||||
Loaners follow the same curve (§2.1 pins their cost, home and faction), 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, and is **curve-shaped**: at least 3 cards of cost 4 or more,
|
||||
and at most 4 of cost 1. A new player picks one and can play at once.
|
||||
@@ -148,6 +150,99 @@ The engine does no I/O and only ever sees one version of each card.
|
||||
means no limit). Owning NFTs gives **variety**, not power: owned and loaner cards follow the same
|
||||
curve.
|
||||
|
||||
### 2.1 Starter decks v1 *(owner: council-designer-b)*
|
||||
|
||||
These are the default `starterDecks`: four 12-card loaner decks.
|
||||
- **Every deck has the same curve:** costs `1,1,2,2,3,3,3,4,4,5,5,6`. That's an average of 3.25, with 5 cards of cost 4 or more and 2 of cost 1.
|
||||
- **Every deck has the same shape:** 6 cards from each of two factions, and 4 cards for each home stat. So every deck can play on-topic in every lane.
|
||||
- **Loaner values are pinned.** council-data's percentile table and `starter-cards.json` don't exist yet, so a loaner carries
|
||||
`pinned: { cost, home, faction }`. For `check: 'loaner'` the engine takes these instead of §1.1–1.5.
|
||||
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:<kebab-title>`, and `pageId` = the article's real pageId if the UI has it, otherwise `null`. Copies are counted 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.
|
||||
And the random sample has no Space cards (CARD_DATA.md finding 6).
|
||||
- **v1.1 note (factions):** CARD_DATA.md finding 6 shows the legacy `category()` split as Culture 53%, People 30%, Nature 9%,
|
||||
History 5%, Science 3%, Space 0%. Owned decks will therefore be about 50% viral and 30% local. Viral is the weakest keyword, so a typical owned deck
|
||||
may be *weaker* than the starter decks. That's the wrong way round for "NFTs give variety, not power". v1 ships as is.
|
||||
For v1.1, sim-balance runs a **realistic owned deck** (12 cards drawn from `card-sample.json` with its real category mix)
|
||||
against each starter. If it wins under 45%, viral gets buffed first (e.g. cap 3, or a minimum of +1). The P31-based factions council-data proposes (People, Places, Nature, Works & Culture,
|
||||
Structures, Events & Ideas) are the v2 fix, and would need the host to fetch P31 (it isn't in `PageEnrichment`).
|
||||
|
||||
Keywords follow from §10.1: cost 1 → vanilla, otherwise the faction keyword (shown in brackets).
|
||||
|
||||
**A. Stargazers: Space (translated) + Science (encyclopedic)**
|
||||
| Cost | Card | Faction | Home |
|
||||
|---|---|---|---|
|
||||
| 1 | Moon | Space | reach |
|
||||
| 1 | Electron | Science | depth |
|
||||
| 2 | Mars | Space | attention |
|
||||
| 2 | Periodic table | Science | depth |
|
||||
| 3 | Saturn | Space | reach |
|
||||
| 3 | Photosynthesis | Science | attention |
|
||||
| 3 | Black hole | Space | depth |
|
||||
| 4 | Quantum mechanics | Science | reach |
|
||||
| 4 | Milky Way | Space | attention |
|
||||
| 5 | DNA | Science | attention |
|
||||
| 5 | Sun | Space | reach |
|
||||
| 6 | Theory of relativity | Science | depth |
|
||||
|
||||
**B. Field Guide: Nature (rising) + History (nostalgic)**
|
||||
| Cost | Card | Faction | Home |
|
||||
|---|---|---|---|
|
||||
| 1 | Octopus | Nature | depth |
|
||||
| 1 | Stonehenge | History | attention |
|
||||
| 2 | Axolotl | Nature | attention |
|
||||
| 2 | Rosetta Stone | History | reach |
|
||||
| 3 | Coral reef | Nature | depth |
|
||||
| 3 | Roman Empire | History | reach |
|
||||
| 3 | Honey bee | Nature | attention |
|
||||
| 4 | Ancient Egypt | History | depth |
|
||||
| 4 | Amazon rainforest | Nature | reach |
|
||||
| 5 | Blue whale | Nature | attention |
|
||||
| 5 | Great Wall of China | History | reach |
|
||||
| 6 | World War II | History | depth |
|
||||
|
||||
**C. Headliners: People (local) + Culture (viral)**
|
||||
| Cost | Card | Faction | Home |
|
||||
|---|---|---|---|
|
||||
| 1 | Haiku | Culture | attention |
|
||||
| 1 | Ada Lovelace | People | depth |
|
||||
| 2 | Jazz | Culture | attention |
|
||||
| 2 | Marie Curie | People | reach |
|
||||
| 3 | Mona Lisa | Culture | reach |
|
||||
| 3 | Frida Kahlo | People | attention |
|
||||
| 3 | Chess | Culture | depth |
|
||||
| 4 | Leonardo da Vinci | People | reach |
|
||||
| 4 | The Beatles | Culture | attention |
|
||||
| 5 | William Shakespeare | People | depth |
|
||||
| 5 | Olympic Games | Culture | reach |
|
||||
| 6 | Wolfgang Amadeus Mozart | People | depth |
|
||||
|
||||
**D. Pioneers: People (local) + Space (translated)**
|
||||
| Cost | Card | Faction | Home |
|
||||
|---|---|---|---|
|
||||
| 1 | Sputnik 1 | Space | reach |
|
||||
| 1 | Nikola Tesla | People | attention |
|
||||
| 2 | Hubble Space Telescope | Space | depth |
|
||||
| 2 | Isaac Newton | People | reach |
|
||||
| 3 | Neil Armstrong | People | attention |
|
||||
| 3 | Jupiter | Space | reach |
|
||||
| 3 | Galileo Galilei | People | depth |
|
||||
| 4 | Albert Einstein | People | attention |
|
||||
| 4 | International Space Station | Space | depth |
|
||||
| 5 | Apollo 11 | Space | attention |
|
||||
| 5 | Charles Darwin | People | reach |
|
||||
| 6 | Solar System | Space | depth |
|
||||
|
||||
- **Coverage:** all 6 factions appear, and all 4 `shared/catalog.ts` cards are included (Moon, Periodic table, Octopus, Albert Einstein).
|
||||
- **Tutorial:** Field Guide vs Stargazers, seed 1, against the easy bot.
|
||||
- **sim-balance:** please run the 4 decks round robin first. The target is every pairing at 45–55%. If a pairing misses, retune by
|
||||
swapping home stats within a deck, never by changing the curve.
|
||||
|
||||
---
|
||||
|
||||
## 3. Board
|
||||
@@ -263,7 +358,7 @@ the last turn's, and every "at scoring" Portal resolves **before** Topics are ju
|
||||
|
||||
| Line | Why it isn't dominant |
|
||||
|---|---|
|
||||
| All-famous (all max-stat) deck | It becomes an all-cost-5/6 deck with dead early turns. Cheap cards are more efficient **per energy**, expensive cards **per card**. Only 9 cards are seen per match (3 + 6 draws), so both matter. The 1-energy carry-over lets a heavy deck bank energy for a turn-5 six-drop. **sim-balance target: heavy vs curve ≥ 40%.** |
|
||||
| All-famous (all max-stat) deck | It becomes an all-cost-5/6 deck with dead early turns. Cheap cards are more efficient **per energy**, expensive cards **per card**. Only 9 cards are seen per match (3 + 6 draws), so both matter. An all-cost-5/6 deck is **weak by design**: it has four dead turns (sim-balance interim: 0–15%). There is no hard deck rule in v1; the deck builder warns when a deck has fewer than 4 cards of cost ≤ 2, and every starter deck is curve-shaped (§2.1). **sim-balance target: a **top-heavy curve** (half the deck at cost 4 or more) vs curve ≥ 40%.** `energyByTurn [2..7]` is a v1.1 candidate. |
|
||||
| All-cheap flood (cost 1–2) | Weak by design: only 9 slots and 9 cards seen. Critic's sim under these rules: swarm vs curve about 7–11%. Its home is Culture's wide-turn keyword (§10). |
|
||||
| All one faction | No v1 keyword scales with faction count. `factionSynergyCap` is reserved for modes. Culture, the largest pool, has the weakest keyword (viral). |
|
||||
| "Always play the highest-power card" | It ignores the on-topic bonus, lane capacity and the hidden Portals. Critic's sim: 18–21% against a smart bot (target < 55%). |
|
||||
@@ -295,7 +390,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",
|
||||
|
||||
Reference in New Issue
Block a user