Files
wikideck/docs/game/DESIGN.md
T
2026-11-16 23:35:30 -05:00

41 KiB
Raw Blame History

WikiDeck: Edit War — game design v1 (draft)

Status: v1 DRAFT, freeze target 23:30 EST 2026-11-16. Owners: council-designer-a owns sections 0–9 (research, card derivation, rules). council-designer-b owns sections 10–12 (keywords, peer-hosted modes, worked example). council-critic reviews. Every number in code font is a rules-config key (see §9). Modes can override any of them.

A two-player lane game for 3–6 minute matches. Each player has a 12-card deck and there are 3 Topics (lanes) with 3 slots per side. There are 6 turns, both players plan at the same time, and energy ramps from 1 to 6, with 1 unspent energy carried over. Reveals interleave one card at a time. Win 2 of the 3 Topics. Each Topic is judged on one Wikipedia stat (Attention, Depth or Reach), and a card is stronger in a Topic that matches its best stat. Fame (how high a card's stats are overall) sets its cost, not its efficiency, so famous cards are sidegrades. They are not upgrades.


0. Research summary (what we took, what we left)

Game Why it's fun Taken Left
Marvel Snap 3-minute matches; simultaneous turns; 3 lanes, so the decision is where, not just what lanes, about 6 turns, simultaneous planning, small deck stakes betting (modes only); we deliberately diverge in lane size (3), energy carry-over, interleaved alternating reveals, stats visible from turn 1 with hidden Portals, and on-topic tie-breaks
Hearthstone mana curve; readable cards; tempo energy = turn number, curve-shaped costs 30-card decks and 15-minute matches; hero powers
Magic: The Gathering factions (colours) with distinct identities; deckbuilding depth 6 factions with their own keyword flavour land screw (resource variance); the stack; long text
Balatro huge "moment" when a combo goes off; simple base rules plus modifiers lane modifiers (Portals) as the run-to-run variety single-player scoring
Slay the Spire readable intents; every card is a choice open information about lane state and power roguelike runs (could be a mode)
Gwent rows; best 2 of 3; passing and bluffing best 2 of 3 Topics; hidden commitments multi-round card advantage (too long)
Pokémon TCG type advantage on-topic bonus (card stat matches lane stat) energy attachment; coin flips
Top Trumps instantly understood: "my number beats yours" lanes judged on one stat picking the stat is solved play (always pick your best)
Dominion deck building as play — (too long for 3–6 min) —

What is ours, not borrowed:

  • (a) each Topic is judged on one Wikipedia stat (the Top Trumps twist)
  • (b) cost comes from an article's fame instead of being printed
  • (c) a trend arrow driven by live pageviews
  • (d) a total-power and consensus tie-break instead of stakes betting
  • smaller choices: 3 slots per lane, 1 carried-over energy, interleaved reveals, and stats visible from turn 1 with hidden Portals

The core loop is a lanes game in the style of Snap. The Top Trumps twist is that each lane asks for one Wikipedia stat. That makes every stat matter and gives each turn its main decision: play the card on-topic for the bonus, or put it where the fight is.


1. Card derivation (card data → game card)

The engine never reads raw 0–100 stats as power. Every game card is derived deterministically from a CardInput that the match host freezes at match start:

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)
              pinned?: { cost, home, faction } }  // loaners only (§2.1): replaces §1.1–1.5

1.1 Percentiles (rank-normalisation)

For each stat s in {attention, depth, reach}, pct_s = the percentile (0–100, integer) of the card's snapshot score in the reference table percentiles.<s>. That table holds 99 ascending cut points from council-data's docs/game/card-sample.json. pct_s = the number of cut points strictly below the score, plus half the number equal to it, rounded 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.

1.3 Power

power = powerByCost[cost], default [_, 1, 2, 4, 6, 8, 10] (cost 1 → 1 … cost 6 → 10). The critic's sim showed that heavy decks were too weak with […5,7,9]. Power depends only on cost. Two cards of the same cost have the same base power, whatever their fame. Inflating stats (forged snapshots, template shopping) only moves a card up the curve. It never makes a card more efficient.

1.4 Home stat

home = the stat with the highest pct_s. Ties are broken in this order: depth, reach, attention. Depth and reach are the hardest to inflate. A null stat can never be home. When a card is in a Topic whose stat equals its home, it gets +onTopicBonus[cost] power (default [0, 1, 1, 2, 2, 3, 3], i.e. ⌈cost/2⌉). On-topic efficiency is then about 2 power per energy at every cost (2.0 / 1.5 / 2.0 / 1.75 / 2.0 / 2.0). Off-topic, cheap cards are weaker (1.0) than expensive ones (1.5). Cheap cards want their Topic, and big cards are flexible.

1.5 Faction

faction = the card's category (Space, Nature, People, Science, History, Culture), from server/wiki.ts. Culture is about half the pool, so faction keywords are written so that a 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 −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. Why no ▼ by default: 69% of the sample has a negative trendPercent, and only busy (mostly owned, famous) cards pass trendMinDaily, so a ▼ would quietly penalise collectors. Modes may turn it back on with e.g. trendDown: -25.

1.7 Rarity

The hash-derived rarity (shared/protocol.ts:38) is cosmetic in v1 (frame colour only). Mining luck must not become power or keyword choice.

1.8 Keyword

Each card has at most one keyword: cost-1 cards are vanilla, and the others get their faction's keyword (§10.1).

1.9 Card face (phone)

The card face shows cost (top-left), power (big, centre; the bonus shows as a "+N" badge on the home icon when the card is on-topic), a home-stat icon (📣 attention / 📚 depth / 🌐 reach), an optional trend arrow, and one keyword word. That is two numbers, plus the live lane power when the card is on the board.

1.10 Plausibility (anti-forgery, off-chain)

When verifyStats is true (the default for hosted matches), the match host checks each owned card's snapshot before the match: pageBytes against that revision's byte size, languageCount ≤ the live count + 5, and views for the snapshot month within ±10 % of the pageviews API. A card that fails is played with its live values. The host replaces snapshot with a snapshot built from the live values (deriveStats on the live bytes, languages and views) before it builds the CardInput. The match log marks the card unverified. The engine does no I/O and only ever sees one version of each card.

  • Caching: results are cached per (pageId, revisionId, snapshotMonth). They are immutable, so a cached pass or fail never expires. Live values for a failed card are cached for 24 h.
  • Card can't be verified (the pageId or revision doesn't exist, or the title or category doesn't match): the card is rejected at deck validation, and the player is asked to swap in a loaner.
  • API failure: if Wikipedia can't be reached and nothing is cached, the card plays from its snapshot with check: 'unchecked'. The engine then caps its cost at uncheckedCostCap (default 4), and power follows the capped cost. Matches are never blocked.
  • The engine's only use of check is that cost cap. Loaner cards are check: 'loaner'.

2. Decks

  • Deck size: exactly deckSize cards (default 12).
  • Copies: at most maxCopiesPerPage cards with the same pageId (default 2). Owned and loaner copies count together. Each copy keeps its own snapshot, so the two copies may differ in cost.
  • Deck validation (engine): the size is right, the copy limit holds, every card's check is valid, and there are no more loaners than maxLoaners. An invalid deck can't start a match.
  • 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 (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 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.
  • Mixed decks: an owned deck may fill any slots with loaners, up to maxLoaners (default 12, which 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. Cost, home and faction are hand-set (not derived from starter-cards.json), 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 (v1 pins the 4 shared/catalog.ts ones: Moon 19331, Periodic table 23053, Octopus 22780, Albert Einstein 736; the rest are filled in from one batched API call in v1.1, null until then). The copy limit counts per pageId together with owned copies (§2); a loaner with pageId: null counts 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%. In v1, owned decks were therefore about 50% viral and 30% local. Viral was 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. v1.1 fix: viral gets a base of +1, and Culture cards take a keyword by home stat (§10.1), so owned decks now have all six keywords in the mix (critic sim, #1: owned vs starters 46–52%). 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 (by home stat: attention → viral, depth → encyclopedic, reach → translated)

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

  • 3 Topics (lanes), numbered 1–3 from left to right (top to bottom in portrait).
  • Each Topic has a stat (attention, depth or reach) and an optional Portal modifier (§10.3). Topics have no faction. No v1 keyword counts factions: faction only picks the keyword.
  • Each player has at most laneCapacity cards per Topic (default 3). That gives 9 slots per side, which caps cheap-card flooding and fits 3 cards across a 360 px phone.
  • Topic pool: topicPool is a list of Topics, each { id, name, stat, portal | null }. The default pool has 9 Topics: 3 per stat, one plain and two with Portals. pool_s is the sub-list with stat s, in file order.
  • Topic draw (exact):
    • If distinctStats is true (the default): for each stat in the fixed order [attention, depth, reach], pick pool_s[floor(next() × len(pool_s))]. That uses 3 next() calls. Then Fisher–Yates the 3 picks into lanes 1–3 (i = 2, 1; j = floor(next() × (i+1))), which uses 2 calls.
    • If distinctStats is false: Fisher–Yates the whole pool (i from n−1 down to 1) and take the first topicCount entries as lanes 1–3.
  • Stats visible, Portals hidden: every Topic's stat is face-up from turn 1. Its Portal modifier is face-down until the start of turn portalReveal[i] (default [2, 3, 4]). You always know where your card is on-topic, but not what twist a lane will get.

4. Match setup (deterministic)

  1. The input is { seed: uint32, rules, players: [p0, p1] }, and each player's input is { id, deck: CardInput[12] }. Seat order is input order.
  2. RNG: mulberry32(seed). Every random choice draws next() in this fixed order:
    1. shuffle p0's deck (Fisher–Yates, i from n−1 down to 1, j = floor(next() × (i+1)))
    2. shuffle p1's deck the same way
    3. draw and shuffle the Topics
    4. the initiative coin: p0 has initiative on odd turns if next() < 0.5, otherwise p1
    5. later random events (keywords only), in resolution order
  3. Each player draws openingHand cards (default 3). There are no mulligans in v1 (mulligan: false).
  4. Seed fairness (hosted PvP): commit–reveal. Each party i (host, p0, p1) sends sha256(r_i) for a random 32-byte r_i, then reveals r_i once all commits are in. seed = the first 4 bytes (big-endian uint32) of sha256(r_host ‖ r_p0 ‖ r_p1). The host still relays the hidden plans, so hosted PvP trusts the host not to leak them. Local and bot matches use any seed.

5. Turn structure

The match lasts turns turns (default 6, hard cap). Each turn has these phases:

  1. Start
    • Reveal any Portal scheduled for turn t (resolve its "on reveal").
    • Each player's energy = energyByTurn[t-1] + carry + bonusEnergy. Carry is 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. 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.
  3. Plan (simultaneous, hidden)
    • Each player queues an ordered list of plays (handIndex, topic).
    • Total cost must be ≤ their energy, and each Topic needs room on that player's side.
    • Plays can be undone freely until Commit. Passing is an empty commit.
    • The turn timer is turnSeconds (default 25). On timeout, whatever is queued is committed.
  4. Reveal (interleaved)
    • Plays reveal one at a time, alternating: the initiative player's 1st, the other player's 1st, the initiative player's 2nd, and so on. When one player runs out, the rest of the other's 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.
    • 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.
    • Initiative strictly alternates each turn (set by the coin in §4).
    • Plans are locked before anything reveals, so initiative gives away no information. It only decides the order of on-reveal effects. §10 includes keywords where that order matters.

A typical turn is: look at the lanes, tap a card, tap a Topic (×1–3), tap Commit. That is under 10 seconds, done with one thumb, with no dragging.


6. Power and Topic control

  • A card's lane power = power + (onTopicBonus[cost] if its home stat is the Topic's stat) + trend
    • keyword and Portal modifiers. It is never below 0.
  • A player's Topic power = the sum of their cards' lane power in that Topic.
  • A player leads a Topic if their Topic power is strictly greater than the opponent's.
  • Consensus tie-break: if the powers are equal and > 0, the player with more on-topic cards there leads. If that is also equal, nobody leads. 0–0 has no leader.

7. Win conditions and tie-breaks

Scoring happens after the last turn's End phase (§5.5): every end-of-turn effect, including the last turn's, and every "at scoring" Portal resolves before Topics are judged. Then:

  1. The player who leads more Topics wins (2–1, 2–0, 1–0 and 3–0 all count).
  2. If they lead the same number of Topics: the higher total power across all Topics wins.
  3. If that is also equal: the match is a draw.

Concede: a player can concede at any time, and the opponent wins at once. A player who misses afkTurns timeouts in a row (default 2) with nothing queued concedes.


8. Degenerate lines and why they fail (for the critic)

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. 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, splits over three keywords by home stat (§10.1), so it has no single keyword to stack.
"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%).
Stall or pass Passing leaves lanes to any 1-power card. Two passing players draw.
Mirror the AI Hidden simultaneous commits: you only see the opponent's cards after you commit.
Seat or initiative Planning is simultaneous and initiative strictly alternates (each seat has it for 3 of the 6 turns). Target: each seat wins 48–52%.
Forged or shopped stats They only raise cost (§1.3), the host check falls back to live stats (§1.10), and trend is capped at ±1.
Inflated live pageviews Worth at most +1, frozen at match start, and only counts for articles with ≥ 20 views a day.
Swinginess No effect may change a lane by more than 6 power or move cards between lanes in v1 (a keyword-design rule for §10).

9. Rules config (all defaults)

The engine takes a RulesConfig object. Peer-hosted modes override it (§11). Defaults:

{
  "version": "1.0",
  "deckSize": 12, "maxCopiesPerPage": 2, "maxLoaners": 12,
  "openingHand": 3, "handLimit": 7, "mulligan": false,
  "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": [ /* 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,
  "keywordsEnabled": ["viral","rising","local","encyclopedic","nostalgic","translated"], "cultureKeyword": "home", "ownedCards": true,
  "trendUp": 25, "trendDown": -200, "trendMinDaily": 20, "uncheckedCostCap": 4,
  "factionSynergyCap": 3,
  "verifyStats": true,
  "percentiles": "card-sample-2026-11-16",
  "starterDecks": "default"
}

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)

The v1 keyword set is these six, one per faction. The ids are the ones engine-b already uses on night/engine/keywords. Topics carry only a stat, never a faction. Every keyword below that mentions a Topic keys off stats or board state.

10.1 Which keyword a card gets

First rule that matches:

  1. cost == 1 → no keyword (vanilla). The card gets +vanillaBonus power (default 1), so a cost-1 card is 2.
  2. "edition" is in keywordsEnabled (off by default) and the deck holds another card with the same pageId → edition.
  3. If the faction is Culture and cultureKeyword is "home" (v1.1 default) → the keyword for its home stat: attention → viral, depth → encyclopedic, reach → translated. ("faction" gives v1 behaviour: every Culture card is viral.)
  4. Otherwise → the card's faction keyword from 10.2.

In steps 3–4, if the chosen keyword isn't in keywordsEnabled, the card is vanilla, without vanillaBonus. Why step 3: Culture is about half of all owned cards. Without it, owned decks are half viral and see only 2 of the 6 keywords.

Rarity plays no part here (it's cosmetic, §1.7). Keywords don't lower power, and v1 has no per-keyword power deltas. If sim shows that a keyword is worth more than about 1 power on average, sim-balance sets keywordParams.<id>.powerDelta (default 0, range −3 to 0).

10.2 Keyword list (v1)

Faction id (card word) Trigger Reminder text Cap Order-sensitive?
Culture viral On reveal +1 power, plus +1 for each other card you revealed earlier this turn. +3 yes: your queue order
Nature rising End of turn +1 power. +2 total no
People local Ongoing +1 power while on-topic (the Topic's stat is its home stat). +1 no
Science encyclopedic On reveal +2 power if you have no other cards here. +2 yes: interleaving
History nostalgic On reveal +2 power if you are losing here. +2 yes: interleaving
Space translated On reveal +1 power to your most recently revealed card in each other Topic. +2 yes

Why this set: every keyword is one line and one trigger, and only adds power. The largest swing is +2 on one card, so no lane moves by more than 3 from a keyword (viral at its cap). Nothing scales with faction count, so a mono-Culture deck gets no consistency edge (factionSynergyCap is unused). Viral rewards wide turns, and Culture cards are spread over three keywords (§10.1 step 3). Three keywords (encyclopedic, nostalgic, translated) react to the interleaved reveal (§5.4), so initiative and queue order matter.

Precise rules (for engine-b):

  • On reveal resolves the moment the card enters its Topic, and sees every card revealed before it (both players, including earlier reveals this turn). The bonuses it grants are permanent counters.
  • Ongoing is a condition, recalculated whenever power is read.
  • End of turn resolves in §5.5 order: the initiative player's cards first, then Topic 1→3, then reveal order.
  • viral: gain = min(base + amount × N, cap), where N = the owner's cards revealed earlier in this turn's Reveal phase, in any Topic. Cards that went back to hand don't count. v1.1: base 1, amount 1, cap 3 (v1 was base 0, cap 2).
  • rising: stops after it has gained +2 in total.
  • local: "on-topic" is exactly the §1.4/§6 condition. It's simply an extra +1 on top of onTopicBonus.
  • encyclopedic: with sides: 1 (v1.1 default), "no other cards here" means your side of this Topic is empty, apart from this card, when it reveals; the opponent's cards don't matter. sides: 2 is v1 (both sides empty).
  • nostalgic: "losing here" means the opponent's Topic power here is strictly greater than yours, counted just before this card is added. The consensus tie-break doesn't count: a tie is not losing.
  • translated: "most recently revealed" means the highest global reveal sequence number among your cards in that Topic. Topics where you have no card are skipped.
  • No v1 keyword uses the RNG. §4's "later random events" slot stays empty in v1.

Already in code, disabled by default (keywordsEnabled excludes them; for modes only):

  • edition: +2 for each other copy of this pageId on your side.
  • obscure: the opponent sees it face down until the end of the match.
  • wildcard: its home stat becomes the Topic's stat on reveal.

These are engine-b's existing implementations. The faction-based versions of local and wildcard, and the token version of viral, are replaced by the definitions above.

keywordParams defaults (keyed by keyword id; modes may change them within the §11 ranges):

{ "viral": {"base": 1, "amount": 1, "cap": 3, "powerDelta": 0}, "rising": {"amount": 1, "cap": 2, "powerDelta": -1},
  "local": {"amount": 1, "powerDelta": 0}, "encyclopedic": {"amount": 2, "sides": 1, "powerDelta": 0},
  "nostalgic": {"amount": 2, "powerDelta": 0}, "translated": {"amount": 1, "powerDelta": 0},
  "edition": {"amount": 2, "powerDelta": 0}, "obscure": {"powerDelta": 0}, "wildcard": {"powerDelta": 0} }

End-of-turn effects on the last turn resolve before scoring (§7).

10.3 Portals (Topic modifiers) and the default Topic pool

Each Topic has { id, name, stat, portal | null }. The default topicPool has 9 Topics, one plain and two with Portals for each stat. A Portal applies from the moment its Topic is revealed (§3), except where it says otherwise.

Topic Stat Portal rule
Current Events attention –
Main Page attention At scoring, each card here gets +1 power.
Trending attention Trend arrows (§1.6) count double here (±2).
Archive depth –
Featured Article depth At end of the match, the player with the single highest-power card here gets +2 Topic power here. If the highest card power here is tied (between the two players), nobody gets the bonus.
Stub depth Lane capacity here is 2 per player.
Translations reach –
Interwiki reach +1 Topic power here for a player who has at least one card in all 3 Topics.
Disambiguation reach Every card here counts as on-topic, whatever its home stat.

As data: portal = { kind: "scoringCardBonus", amount: 1 } | { kind: "trendMultiplier", factor: 2 } | { kind: "highestCardBonus", amount: 2 } | { kind: "laneCapacity", value: 2 } | { kind: "spreadBonus", amount: 1 } | { kind: "allOnTopic" }. Modes may add Topics with these kinds, using new numbers, but not new kinds (engine code).

portalParams defaults (keyed by Topic id): { "main-page": {"amount": 1}, "trending": {"factor": 2}, "featured-article": {"amount": 2}, "stub": {"value": 2}, "interwiki": {"amount": 1} }. Disambiguation has no numbers. Topic ids are the names in kebab-case: current-events, main-page, trending, archive, featured-article, stub, translations, interwiki, disambiguation. The UI shows each Portal's one-line rule on the lane itself, not behind a tap.


11. Peer-hosted modes (owner: council-designer-b)

A mode is data, published by a node operator and run by the match host:

{
  "id": "blitz",                       // [a-z0-9-]{3,32}, unique per host
  "name": "Blitz", "description": "Four quick turns.",   // ≤ 40 and ≤ 280 chars, plain text
  "rules": { "turns": 4, "energyByTurn": [2, 3, 4, 5], "portalReveal": [1, 1, 2], "deckSize": 10 },
  "topicPool": [ /* optional: Topic objects (10.3); default if omitted */ ],
  "starterDecks": [ /* optional: lists of loaner pageIds */ ]
}
  • rules is a partial RulesConfig (§9) merged over the defaults. Unknown keys are rejected.
  • Validation (modes owns the code; these are the limits). If any check fails, the mode is refused:
Key Allowed
turns 3–8, and turns × turnSeconds ≤ 240
energyByTurn length = turns, each 0–10
bonusEnergy 0–3
portalReveal length = topicCount, each 1..turns, non-decreasing
topicCount 1–5; distinctStats only if ≤ 3
laneCapacity 1–6
deckSize 6–20; maxCopiesPerPage 1–4; maxLoaners 0..deckSize
openingHand 0–6; handLimit 1–10
turnSeconds 10–60; afkTurns 1–5
costThresholds 5 strictly ascending integers in 0–100
powerByCost 7 integers in 0–20, non-decreasing from index 1
onTopicBonus (7 entries), vanillaBonus 0–5 each
trendUp / trendDown 0–200 / −200–0
factionSynergyCap 0–6
keywordsEnabled any subset of the 9 implemented ids (the 6 v1 defaults + edition, obscure, wildcard); a card whose keyword is disabled is vanilla, without vanillaBonus
keywordParams, portalParams only the keys listed in §10 / §10.3; amounts and caps 0–6, viral.base 0–3, encyclopedic.sides 1–2, powerDelta −3–0
cultureKeyword "home" or "faction"
verifyStats the host may only turn this off for modes that use only loaners (maxLoaners == deckSize and owned cards banned)
topicPool 3–20 Topics, Portal kinds only from 10.3
  • Identity: modeHash = SHA-256 of the canonical JSON (sorted keys, no whitespace) of the merged rules plus the topicPool. A match record holds { modeHash, seed, both decks' CardInputs, both players' commit lists }, and that is enough to replay it exactly.
  • What modes can't change is the "Fixed for all modes" list in §9. Modes also can't add keywords or Portal kinds, or stake, move or burn NFTs.

Example modes (good defaults for operators to publish):

Mode Overrides Feel
Blitz turns 4, energyByTurn [2,3,4,5], portalReveal [1,1,2], deckSize 10, turnSeconds 20 about 2 minutes
Deep Cuts topicPool: only the 3 depth Topics, distinctStats false rewards long, obscure articles
Loaner League maxLoaners 12 and owned cards banned ("ownedCards": false, a new boolean key, default true) fully level, for tournaments
Big Board topicCount 5, distinctStats false, portalReveal [1,2,3,4,5], laneCapacity 3 win 3 of 5; tablet/desktop only (5 × 3 slots won't fit a 360 px phone)
No Keywords keywordsEnabled [], onTopicBonus [0,3,3,3,3,3,3] Top Trumps–style tutorial mode

12. Worked example match (owner: council-designer-b)

Ruleset for this example: v1.0 (the golden test pins it): cultureKeyword "faction", viral {base 0, cap 2}, encyclopedic {sides 2}, rising.powerDelta 0; everything else as §9. (v1.1 golden numbers: to be added once the engine has the v1.1 hooks.)

These are the §1–9 rules as of this PR:

  • powerByCost [0,1,2,4,6,8,10], onTopicBonus [0,1,1,2,2,3,3], vanillaBonus 1
  • laneCapacity 3, energyCarryMax 1, interleaved reveals, alternating initiative, portalReveal [2,3,4]
  • underdog false, no trend arrows

The derived cards are given directly (the §1 output), so the test needs no percentile table. Topics: T1 Archive (depth, plain), T2 Main Page (attention; Portal revealed turn 3; at scoring, each card here gets +1), T3 Translations (reach, plain; revealed turn 4). Ana (p0) has initiative on odd turns and Bo (p1) on even turns.

Player Card Faction Cost Base Home Keyword
Ana Octopus Nature 1 2 depth – (vanilla)
Ana Moon Space 2 2 reach translated
Ana Coral reef Nature 2 2 depth rising
Ana Albert Einstein People 4 6 attention local
Ana Ancient Rome History 5 8 depth nostalgic
Ana Library of Alexandria History 4 6 depth nostalgic
Ana Periodic table Science 3 4 depth encyclopedic
Bo Haiku Culture 1 2 attention – (vanilla)
Bo Mars Space 2 2 reach translated
Bo Jazz Culture 2 2 attention viral
Bo Pop music Culture 4 6 attention viral
Bo Jupiter Space 5 8 reach translated
Bo Fern Nature 3 4 depth rising
Bo Mona Lisa Culture 3 4 attention viral

Topic power is written as Ana–Bo after End of turn. Energy is "available / spent".

Turn Init Energy Ana / Bo Reveals, in interleaved order T1 T2 T3
1 Ana 1/1, 1/1 Ana Octopus → T1: 2 +1 on-topic = 3. Bo Haiku → T2: 2+1 = 3 3–0 0–3 0–0
2 Bo 2/2, 2/0 Bo passes (to carry 1). Ana Moon → T3: 2+1 = 3. translated: Octopus +1 → 4 4–0 0–3 3–0
3 Ana 3/2, 4/4 Main Page Portal revealed. Ana Coral reef → T1: 2+1 = 3. Bo Mars → T3: 2+1 = 3, translated: Haiku +1 → 4. Bo Jazz → T2: 2+1 = 3, viral (Mars earlier) +1 → 4. End: rising Coral reef → 4 8–0 0–8 3–3 (tie; on-topic 1–1, so no leader)
4 Bo 5/4, 4/4 Bo Pop music → T3: 6 (off-topic), viral +0. Ana Einstein → T2: 6+2 on-topic, local +1 = 9. End: rising Coral reef → 5 (cap reached) 9–0 9–8 3–9
5 Ana 6/5, 5/5 Ana Ancient Rome → T3: 8 (off-topic). nostalgic: losing 3–9, so +2 → 10. Bo Jupiter → T1: 8 (off-topic). translated: Jazz → 5 (T2), Pop music → 7 (T3) 9–8 9–9: Bo leads (consensus: on-topic 1 vs 2) 13–10
6 (last) Bo 7/7, 6/6 Bo Fern → T1: 4+2 = 6. Ana Library → T1: 6+2 = 8. nostalgic: losing 9–14, so +2 → 10. Bo Mona Lisa → T2: 4+2 = 6, viral (Fern earlier) +1 → 7. Ana Periodic table → T2: 4 (off-topic), encyclopedic: no (cards here). End: rising Fern → 7. Scoring: Main Page +1 per card in T2 19–15 15–19 13–10

Final card values:

  • T1:
    • Ana: Octopus 4 + Coral reef 5 + Library 10 = 19.
    • Bo: Jupiter 8 + Fern 7 = 15.
  • T2: each card +1 from Main Page.
    • Ana: Einstein 10 + Periodic table 5 = 15.
    • Bo: Haiku 5 + Jazz 6 + Mona Lisa 8 = 19.
  • T3:
    • Ana: Moon 3 + Ancient Rome 10 = 13.
    • Bo: Mars 3 + Pop music 7 = 10.

Ana wins 2–1. Three moments show the v1 mechanics:

  • Carry-over: Bo passed on turn 2 to afford two plays on turn 3 (4 energy).
  • Consensus: T2 at 9–9 after turn 5 went to Bo, who had two on-topic attention cards to Ana's one.
  • Interleaving decides the match: on turn 6 Bo had initiative, so Fern revealed before Library. Ana was then losing T1 (9 vs 14) and nostalgic fired (+2). If Ana had revealed first, she'd have been ahead 9–8, nostalgic would not have fired, and T1 would have been 17–15. Ana still wins that lane, but by 2 instead of 4.

Golden test for engine-b:

  • Inject: the Topic order, the opening hands and the draw order directly, with each player's commit list per turn as in the table. The queue order within a turn is as listed.
  • Expected final Topic powers: T1 19–15, T2 15–19, T3 13–10. Winner: p0, by 2 Topics to 1.
  • Also assert:
    • after turn 5, T2 is a 9–9 tie with Bo leading by consensus
    • Ana's carried energy is 1 at the start of turns 4, 5 and 6
    • Bo's carried energy is 1 at the start of turn 3