forked from WikiDeck/wikideck
Night 1: DESIGN.md v1.1, balance-report conclusions (#32)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit was merged in pull request #32.
This commit is contained in:
+79
-26
@@ -66,9 +66,15 @@ down. A `null` attention gives `pct_attention = null`.
|
|||||||
### 1.2 Fame → Cost
|
### 1.2 Fame → Cost
|
||||||
`fame` = the integer mean (rounded half up) of the non-null percentiles.
|
`fame` = the integer mean (rounded half up) of the non-null percentiles.
|
||||||
`cost` = 1 + the number of thresholds in `costThresholds` (5 ascending values, default
|
`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.
|
`[26, 39, 51, 63, 78]` in v1.1) 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
|
**Thresholds are data, not guesses (v1.1).** `fame` is a *mean* of up to 3 percentiles, so it clusters
|
||||||
sample's fame distribution.
|
around 50 even though each percentile is uniform. The v1.0 values `[15, 35, 55, 75, 90]` treated fame as
|
||||||
|
uniform, so 82% of the pool landed on cost 2–4 (3/23/37/22/10/5 %). `costThresholds` is therefore set to
|
||||||
|
the fame values at the **15/35/55/75/90 % points of the reference sample** (the same `card-sample.json`
|
||||||
|
whose `percentiles` table §1.1 uses). That's the integer set that brings the sample's cost spread closest
|
||||||
|
to the target 15/20/20/20/15/10 %. The v1.1 defaults come from the 236-card sample (fame 8–98) and
|
||||||
|
give 13/20/22/20/15/10 %. Whenever council-data refreshes the sample, the percentile table and
|
||||||
|
`costThresholds` are regenerated together and ship as one change. Pinned loaners (§2.1) are unaffected.
|
||||||
|
|
||||||
### 1.3 Power
|
### 1.3 Power
|
||||||
`power` = `powerByCost[cost]`, default `[_, 1, 2, 4, 6, 8, 10]` (cost 1 → 1 … cost 6 → 10). The
|
`power` = `powerByCost[cost]`, default `[_, 1, 2, 4, 6, 8, 10]` (cost 1 → 1 … cost 6 → 10). The
|
||||||
@@ -96,7 +102,9 @@ mono-faction deck gains no consistency edge (§10: no v1 keyword scales with fac
|
|||||||
which means there is **no down arrow in v1**: 69% of cards trend negative, so a ▼ would mostly land as
|
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
|
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
|
**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.
|
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
|
### 1.7 Rarity
|
||||||
The hash-derived `rarity` (`shared/protocol.ts:38`) is **cosmetic in v1** (frame colour only). Mining luck must not
|
The hash-derived `rarity` (`shared/protocol.ts:38`) is **cosmetic in v1** (frame colour only). Mining luck must not
|
||||||
@@ -155,7 +163,7 @@ The engine does no I/O and only ever sees one version of each card.
|
|||||||
These are the default `starterDecks`: four 12-card loaner decks.
|
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 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.
|
- **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
|
- **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.
|
`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`.
|
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.
|
A mode that changes those numbers changes loaners exactly as it changes owned cards.
|
||||||
@@ -168,10 +176,12 @@ These are the default `starterDecks`: four 12-card loaner decks.
|
|||||||
The decks below pin their values on purpose, for two reasons. Famous, recognisable articles would all derive to cost 5–6.
|
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).
|
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%,
|
- **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
|
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.
|
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)
|
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,
|
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. **BALANCE.md v1.1:** starters 52–53% overall, and owned vs starters 42–51%
|
||||||
|
(weakest vs Headliners and Stargazers; v1.2 candidates: `nostalgic`/`translated` `powerDelta -1`, `local.amount 2`). 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`).
|
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).
|
Keywords follow from §10.1: cost 1 → vanilla, otherwise the faction keyword (shown in brackets).
|
||||||
@@ -208,7 +218,7 @@ Keywords follow from §10.1: cost 1 → vanilla, otherwise the faction keyword (
|
|||||||
| 5 | Great Wall of China | History | reach |
|
| 5 | Great Wall of China | History | reach |
|
||||||
| 6 | World War II | History | depth |
|
| 6 | World War II | History | depth |
|
||||||
|
|
||||||
**C. Headliners: People (local) + Culture (viral)**
|
**C. Headliners: People (local) + Culture (by home stat: attention → viral, depth → encyclopedic, reach → translated)**
|
||||||
| Cost | Card | Faction | Home |
|
| Cost | Card | Faction | Home |
|
||||||
|---|---|---|---|
|
|---|---|---|---|
|
||||||
| 1 | Haiku | Culture | attention |
|
| 1 | Haiku | Culture | attention |
|
||||||
@@ -311,6 +321,8 @@ The match lasts `turns` turns (default **6**, hard cap). Each turn has these pha
|
|||||||
- Each player queues an ordered list of plays `(handIndex, topic)`.
|
- 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.
|
- 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.
|
- Plays can be undone freely until **Commit**. Passing is an empty commit.
|
||||||
|
- **Hidden means nothing leaks.** While you plan, the opponent's hand count and energy don't change
|
||||||
|
visibly. Only the bare fact "opponent is ready" (`committed`) is shown. No queue count, no spent energy.
|
||||||
- The turn timer is `turnSeconds` (default **25**). On timeout, whatever is queued is committed.
|
- The turn timer is `turnSeconds` (default **25**). On timeout, whatever is queued is committed.
|
||||||
4. **Reveal (interleaved)**
|
4. **Reveal (interleaved)**
|
||||||
- Plays reveal **one at a time, alternating**: the initiative player's 1st, the other player's
|
- Plays reveal **one at a time, alternating**: the initiative player's 1st, the other player's
|
||||||
@@ -360,13 +372,14 @@ the last turn's, and every "at scoring" Portal resolves **before** Topics are ju
|
|||||||
|
|
||||||
| Line | Why it isn't dominant |
|
| 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-famous (all max-stat) deck | It becomes an all-cost-5/6 deck with four dead early turns. Cheap cards are more efficient **per energy**, expensive cards **per card**, and only 9 cards are seen per match (3 + 6 draws). So a pure cost-5/6 deck is **weak by design**: **BALANCE.md v1: 15%**, and no lever (power curve, energy ramp) fixes it without breaking curve or swarm decks. There is no hard deck rule; the deck builder warns below 4 cards of cost ≤ 2, and every starter is curve-shaped (§2.1). **Target met:** a **top-heavy curve** (half the deck at cost 4 or more) wins **57%** (target ≥ 40%). `energyByTurn [2..7]` was rejected for v1.1: it lifts heavy decks but kills swarm (20%). |
|
||||||
| 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-cheap flood (cost 1–2) | Weak by design: only 9 slots and 9 cards seen. **BALANCE.md v1: 2%** (critic's sim 7–11%). Every lever that revives it breaks curve decks (sweep in BALANCE.md). viral (base +1, v1.1) is its consolation, not its fix. |
|
||||||
| All one faction | No v1 keyword scales with faction count. `factionSynergyCap` is reserved for modes. Culture, the largest pool, has the weakest keyword (viral). |
|
| 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%). |
|
| Owning NFTs buys power (pay-to-win) | Power depends only on cost (§1.3), and cost follows a fixed curve. **BALANCE.md v1.1 re-run (real `RULESET_V1_1`):** each starter deck averages **52–53%** overall. A realistic owned deck from `card-sample.json` wins **42–51%** against the starters (n ≈ 55 per pairing, ±13 pp). So owning cards buys variety, not power. v1.2 levers if owned decks should be a little stronger: `local.amount 2`, and `nostalgic`/`translated` `powerDelta -1` (the two strongest keywords, about +1.65 net per card). |
|
||||||
|
| "Always play the highest-power card" | It ignores the on-topic bonus, lane capacity and the hidden Portals. **BALANCE.md v1:** the naive max-power line wins **40%** against greedy, and lookahead-lite beats greedy **60–70%**, so skill shows (target < 55%). Critic's sim: 18–21% against a smart bot. |
|
||||||
| Stall or pass | Passing leaves lanes to any 1-power card. Two passing players draw. |
|
| 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. |
|
| 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%. |
|
| Seat or initiative | Planning is simultaneous and initiative strictly alternates (each seat has it for 3 of the 6 turns). **BALANCE.md v1.1 re-run (real `RULESET_V1_1`): first player 51.2% [48.8–53.6]** (target 48–52%; v1 was 53.4%). |
|
||||||
| 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. |
|
| 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. |
|
| 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). |
|
| 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). |
|
||||||
@@ -379,7 +392,7 @@ The engine takes a `RulesConfig` object. Peer-hosted modes override it (§11). D
|
|||||||
|
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
"version": "1.0",
|
"version": "1.1",
|
||||||
"deckSize": 12, "maxCopiesPerPage": 2, "maxLoaners": 12,
|
"deckSize": 12, "maxCopiesPerPage": 2, "maxLoaners": 12,
|
||||||
"openingHand": 3, "handLimit": 7, "mulligan": false,
|
"openingHand": 3, "handLimit": 7, "mulligan": false,
|
||||||
"turns": 6, "turnSeconds": 25, "afkTurns": 2,
|
"turns": 6, "turnSeconds": 25, "afkTurns": 2,
|
||||||
@@ -388,10 +401,10 @@ The engine takes a `RulesConfig` object. Peer-hosted modes override it (§11). D
|
|||||||
"topicPool": [ /* inline Topic objects {id, name, stat, portal}; default = the 9 in §10.3 */ ],
|
"topicPool": [ /* inline Topic objects {id, name, stat, portal}; default = the 9 in §10.3 */ ],
|
||||||
"keywordParams": { /* per-keyword numbers, keyed by keyword id (§10) */ },
|
"keywordParams": { /* per-keyword numbers, keyed by keyword id (§10) */ },
|
||||||
"portalParams": { /* per-Portal numbers, keyed by Topic id (§10.3) */ },
|
"portalParams": { /* per-Portal numbers, keyed by Topic id (§10.3) */ },
|
||||||
"costThresholds": [15, 35, 55, 75, 90],
|
"costThresholds": [26, 39, 51, 63, 78],
|
||||||
"powerByCost": [0, 1, 2, 4, 6, 8, 10],
|
"powerByCost": [0, 1, 2, 4, 6, 8, 10],
|
||||||
"onTopicBonus": [0, 1, 1, 2, 2, 3, 3], "vanillaBonus": 1,
|
"onTopicBonus": [0, 1, 1, 2, 2, 3, 3], "vanillaBonus": 1,
|
||||||
"keywordsEnabled": ["viral","rising","local","encyclopedic","nostalgic","translated"], "ownedCards": true,
|
"keywordsEnabled": ["viral","rising","local","encyclopedic","nostalgic","translated"], "cultureKeyword": "home", "ownedCards": true,
|
||||||
"trendUp": 25, "trendDown": -200, "trendMinDaily": 20, "uncheckedCostCap": 4,
|
"trendUp": 25, "trendDown": -200, "trendMinDaily": 20, "uncheckedCostCap": 4,
|
||||||
"factionSynergyCap": 3,
|
"factionSynergyCap": 3,
|
||||||
"verifyStats": true,
|
"verifyStats": true,
|
||||||
@@ -418,7 +431,12 @@ Topics carry only a **stat**, never a faction. Every keyword below that mentions
|
|||||||
First rule that matches:
|
First rule that matches:
|
||||||
1. `cost == 1` → **no keyword** (vanilla). The card gets +`vanillaBonus` power (default **1**), so a cost-1 card is 2.
|
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**.
|
2. `"edition"` is in `keywordsEnabled` (off by default) and the deck holds another card with the same `pageId` → **edition**.
|
||||||
3. Otherwise → the card's **faction keyword** from 10.2, if it's in `keywordsEnabled`. If not, the card is vanilla, *without* `vanillaBonus`.
|
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.
|
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).
|
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).
|
||||||
@@ -427,16 +445,16 @@ If sim shows that a keyword is worth more than about 1 power on average, sim-bal
|
|||||||
|
|
||||||
| Faction | id (card word) | Trigger | Reminder text | Cap | Order-sensitive? |
|
| Faction | id (card word) | Trigger | Reminder text | Cap | Order-sensitive? |
|
||||||
|---|---|---|---|---|---|
|
|---|---|---|---|---|---|
|
||||||
| Culture | **viral** | On reveal | +1 power for each other card you revealed earlier this turn. | +2 | yes: your queue order |
|
| 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 |
|
| 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 |
|
| 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 there are no other cards here (either side). | +2 | **yes: interleaving** |
|
| 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** |
|
| 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 |
|
| 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,
|
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 2 from a keyword. Nothing scales with faction count, so a mono-Culture deck gets no
|
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 in v1). Viral is Culture's weakest keyword, and it rewards wide turns.
|
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.
|
Three keywords (encyclopedic, nostalgic, translated) react to the interleaved reveal (§5.4), so initiative and queue order matter.
|
||||||
|
|
||||||
Precise rules (for engine-b):
|
Precise rules (for engine-b):
|
||||||
@@ -444,10 +462,12 @@ Precise rules (for engine-b):
|
|||||||
including earlier reveals this turn). The bonuses it grants are permanent counters.
|
including earlier reveals this turn). The bonuses it grants are permanent counters.
|
||||||
- **Ongoing** is a condition, recalculated whenever power is read.
|
- **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.
|
- **End of turn** resolves in §5.5 order: the initiative player's cards first, then Topic 1→3, then reveal order.
|
||||||
- **viral:** counts the owner's cards revealed earlier in *this* turn's Reveal phase, in any Topic. Cards that went back to hand don't count.
|
- **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.
|
- **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`.
|
- **local:** "on-topic" is exactly the §1.4/§6 condition. It's simply an extra +1 on top of `onTopicBonus`.
|
||||||
- **encyclopedic:** "no other cards here" means both sides of this Topic are empty, apart from this card, when it reveals.
|
- **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.
|
- **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.
|
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.
|
- **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.
|
||||||
@@ -463,8 +483,8 @@ These are engine-b's existing implementations. The faction-based versions of `lo
|
|||||||
|
|
||||||
**`keywordParams` defaults** (keyed by keyword id; modes may change them within the §11 ranges):
|
**`keywordParams` defaults** (keyed by keyword id; modes may change them within the §11 ranges):
|
||||||
```json
|
```json
|
||||||
{ "viral": {"amount": 1, "cap": 2, "powerDelta": 0}, "rising": {"amount": 1, "cap": 2, "powerDelta": 0},
|
{ "viral": {"base": 1, "amount": 1, "cap": 3, "powerDelta": 0}, "rising": {"amount": 1, "cap": 2, "powerDelta": -1},
|
||||||
"local": {"amount": 1, "powerDelta": 0}, "encyclopedic": {"amount": 2, "powerDelta": 0},
|
"local": {"amount": 1, "powerDelta": 0}, "encyclopedic": {"amount": 2, "sides": 1, "powerDelta": 0},
|
||||||
"nostalgic": {"amount": 2, "powerDelta": 0}, "translated": {"amount": 1, "powerDelta": 0},
|
"nostalgic": {"amount": 2, "powerDelta": 0}, "translated": {"amount": 1, "powerDelta": 0},
|
||||||
"edition": {"amount": 2, "powerDelta": 0}, "obscure": {"powerDelta": 0}, "wildcard": {"powerDelta": 0} }
|
"edition": {"amount": 2, "powerDelta": 0}, "obscure": {"powerDelta": 0}, "wildcard": {"powerDelta": 0} }
|
||||||
```
|
```
|
||||||
@@ -529,7 +549,8 @@ A **mode** is data, published by a node operator and run by the match host:
|
|||||||
| `trendUp` / `trendDown` | 0–200 / −200–0 |
|
| `trendUp` / `trendDown` | 0–200 / −200–0 |
|
||||||
| `factionSynergyCap` | 0–6 |
|
| `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` |
|
| `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, `powerDelta` −3–0 |
|
| `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) |
|
| `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 |
|
| `topicPool` | 3–20 Topics, Portal kinds only from 10.3 |
|
||||||
|
|
||||||
@@ -552,6 +573,9 @@ Example modes (good defaults for operators to publish):
|
|||||||
|
|
||||||
## 12. Worked example match *(owner: council-designer-b)*
|
## 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. *(The v1.1 numbers are in §12.1.)*
|
||||||
|
|
||||||
These are the §1–9 rules as of this PR:
|
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`
|
- `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]`
|
- `laneCapacity 3`, `energyCarryMax 1`, interleaved reveals, alternating initiative, `portalReveal [2,3,4]`
|
||||||
@@ -613,3 +637,32 @@ Final card values:
|
|||||||
- after turn 5, T2 is a 9–9 tie with Bo leading by consensus
|
- 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
|
- 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
|
- Bo's carried energy is 1 at the start of turn 3
|
||||||
|
|
||||||
|
### 12.1 The same match under the v1.1 ruleset
|
||||||
|
Same cards, Topics, hands and commit lists; ruleset = §9 defaults (v1.1: `viral {base 1, cap 3}`, `encyclopedic {sides 1}`,
|
||||||
|
`rising.powerDelta -1`, `cultureKeyword "home"`). The example's Culture cards (Jazz, Pop music, Mona Lisa) are attention-home, so they stay viral.
|
||||||
|
Energy and carry are unchanged.
|
||||||
|
|
||||||
|
What changes:
|
||||||
|
- **rising −1:** Coral reef is 1 base and ends at 1+1+2 = **4**; Fern is 3 base and ends at 3+2+1 = **6**.
|
||||||
|
- **viral base 1:** Jazz +2 (Mars earlier), Pop music +1 (base only), Mona Lisa +2 (Fern earlier).
|
||||||
|
- **nostalgic still fires** for Library (Ana is losing T1 8–13 just before it). **encyclopedic still doesn't** (Einstein is already on Ana's side of T2).
|
||||||
|
|
||||||
|
| After turn | T1 | T2 | T3 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| 1 | 3–0 | 0–3 | 0–0 |
|
||||||
|
| 2 | 4–0 | 0–3 | 3–0 |
|
||||||
|
| 3 | 7–0 | 0–9 | 3–3 |
|
||||||
|
| 4 | 8–0 | 9–9 | 3–10 |
|
||||||
|
| 5 | 8–8: **Ana leads** (consensus: on-topic 2 vs 0) | 9–10 | 13–11 |
|
||||||
|
| 6, before scoring | 18–14 | 13–18 | 13–11 |
|
||||||
|
| **final** (Main Page +1 per card in T2) | **18–14** | **15–21** | **13–11** |
|
||||||
|
|
||||||
|
**Ana still wins 2–1.** The moments in v1.1:
|
||||||
|
- **Carry-over:** unchanged.
|
||||||
|
- **Consensus:** moves to **T1 after turn 5** (8–8). Ana has two on-topic depth cards there (Octopus, Coral reef) and Bo has only the off-topic Jupiter.
|
||||||
|
- **Interleaving:** unchanged in kind. If Ana had revealed Library before Fern, T1 would have been 8–8 at that moment, a tie is not losing,
|
||||||
|
so nostalgic would not fire and T1 would end 16–14.
|
||||||
|
|
||||||
|
**v1.1 golden test:** expected `lanePower [[18,14],[15,21],[13,11]]`, winner p0. Also assert the T1 8–8 consensus lead for p0 after turn 5.
|
||||||
|
(Cross-checked by council-critic with the #27 engine, `tower-plus:scratchpad/critic/golden11.ts`, and by hand by designer-b.)
|
||||||
|
|||||||
Reference in New Issue
Block a user