election-game/backend/docs/25-gameplay-v3.md

191 lines
21 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 25 選戰卡牌第三版:讓人一場接一場(玩法規格)
> 2026-10-28。使用者要「把遊戲改得非常好玩、一場玩過一場、不中斷、更豐富」,並提出「每個候選人要有本命區、本命技能,
> 搭配某些卡片」;之後又要求「增加遊戲的黏著度以及可完成度,不然好像隨完即丟」。本文件是給實作用的規格:每一節寫現況(附程式位置與數據)、要加什麼、怎麼改、怎麼驗收。
> 所有數字都是起始值,一律用 `apps/sim` 的 `rogue-balance`、`career-balance` 跑過再定案。
## 實作狀態(2026-10-29)
| 節 | 狀態 | 實際做法 |
|---|---|---|
| 1a 本命區 | 完成 | `rogue/src/archetypes.ts` 的 `homeTowns`;雙方都有。你的牌 ×1.2、失守聲勢 −2;攻下對手的本命區聲勢 +2、對手下週少一個行動(`rivalStun`);對手在自己本命區 ×1.2。新牌「回鄉造勢」(`homecoming`,只能打在本命區) |
| 1b 類型與技能 | 完成(數字已依模擬調過) | 六種類型照規格,調整:黑馬型每點聲勢 +12%(規格 +16% 太強)、財務型每週 +150 萬、地面牌 −5%,另外週末依手上的資金自動加票(每 100 萬全市 +150 票,最多算 1,000 萬;隨手玩的人不會花錢,財務型原本最難)。真實候選人:資歷三項取最高,同級比實際數字超過門檻多少;資歷都是 0 才看經費(多 → 財務型,少 → 黑馬型)。2022 縣市長 42 位主要候選人:組織 20、媒體 9、資深 7、財務 5、黑馬 1。每日一戰也套用;選人畫面就看得到類型(`/api/scenarios` 的 `archetype`,伺服器啟動時先算好)。對手也有類型(同樣依選舉紀錄,`rival.ts` 的 `RIVAL_TYPES`):決定出招比例、比較常抽到哪幾條規則,強項和弱點各一個(例如媒體型對手空戰 +10%,但你的比較文宣對他 +20%),畫面上和對手規則並排、第一週的快報也會說。依模擬調過,讓「隨手玩」對上各種類型的勝率不要差太多 |
| 1c 接上流派 | 完成 | 下一站、物資行裡和類型搭配的牌、幕僚權重 ×1.5,牌面標「適合你的類型」 |
| 2 流派與爆分 | 完成 | 9 張核心牌(走透透、遍地開花、樁腳網、聲量滾雪球、懶人包、反將一軍、沙盤推演、地毯式廣告、小額募款)+5 位幕僚(鐵腿、派系協調人、懶人包小編、危機變轉機、精算師)。「全面動員令+」沒改。14 張專屬插圖用 `art/cards.tsv` 的題材補上。依模擬加強:聲量每點 +5%、空戰牌花費 −30%;懶人包每點聲量 +6%;樁腳網三成;反將一軍把這週擋下的所有行動一半變成票;沙盤推演每週前兩張;危機變轉機算所有擋下的行動(最多 +2)。**流派傾向**(`route.ts` 的 `schoolPull`):牌組裡某一派的牌越多,那一派的牌、幕僚越常出現;同一派 3 張以上算成形,拜會地方、物資行一定有一張那一派還沒拿的核心牌 |
| 3 對手規則與精英站 | 完成 | 7 條規則(名嘴加持、地方大老、大打空戰、鐵票區、網路謠言、地毯式掃街、形象牌;後發制人維持原本的風格),逆風 5 起抽 2 條。精英站「地方派系談判」:第 2、4 週結束後可能出現,選了就接下挑戰(不進門),下週結算。下一站畫面灰色顯示下下週的門(到時候不能用的會重抽) |
| 4 隨機行事曆 | 完成 | 8 週的局辯論 3–5、民調 4–5、黑函 5–6 週,5 種排法;上方週次標「辯、民、函、勢、夜」。地方事件週:縣市裡有宮廟多、客家庄、人口密集、長輩多、年輕人多的區,開局就排 1 個(一半的局 2 個)神明遶境、義民祭、捷運通車剪綵、重陽敬老、青年音樂祭,在第 2–6 週沒有大場面的週;只加成有那個特色的區,雙方都算(`data.ts` 的 `EVENTS` 裡有 `local` 的)。週次上標「遶、義、捷、敬、音」 |
| 5 局中小勝利 | 完成 | 翻區抽牌(每週最多 2 張,黑馬型另外再抽);民調領先多一張稀有牌(偏向你的類型)、落後下週體力 +1;結果頁標「最關鍵的一區」 |
| 6 張力與難度 | 不改基準數字 | 見下面的模擬。預估數字照舊完整顯示(docs/21 的決定:畫面上的數字和打出去一致) |
| 7 再來一局 | 完成 | 結果頁:贏了就有「挑戰逆風 N+1 級」(已解鎖就出現)、Enter 直接再來、「攻下一塊地盤」;出牌不等伺服器(牌先飛出去、手牌體力先扣,伺服器回來校正);設定的「快速模式」讓開票夜、週末結算、選情快報快一倍 |
| 8 跨局進度 | 完成 | 完成度:全台制霸(22 縣市+總統大選)、六種類型、類型逆風挑戰(每種類型 0–10 級)、成就;大廳一條、圖鑑完整面板(`web/src/game/rogue/Completion.tsx`、`progress.ts`);選人畫面顯示這個類型的逆風紀錄。聲望解鎖:聲望 = 打完的局數+勝場(輸了 +1、贏了 +2,舊玩家照已有的紀錄算),9 張核心牌和 5 位新幕僚依聲望 1–22 逐一解鎖(`rogue/src/unlocks.ts`),開局帶給伺服器;圖鑑寫解鎖條件、結果頁寫「解鎖了什麼/再幾點解鎖什麼」,完成度多一項「聲望解鎖」。每日一戰、模擬全部解鎖。流派熟練度沒做(和聲望合併) |
模擬(`node apps/sim/src/rogue-balance.ts`,桃園 2022 勢均力敵,每種 100 局,兩位候選人;2026-10-29 加完地方事件週、對手類型、流派傾向之後):
| 難度 | 打得好(greedy) | 隨手玩(casual) |
|---|---|---|
| 標準 | 99%(差距 +7.6~+8.4) | 37–46% |
| 逆風 6 | 63–74% | 7–10% |
- **流派**(逆風 6,`--bots greedy,ground,air,attack`;標準難度大家都贏,看不出差別):混打 63–74%;只拿地面牌 69–78%(比混打多 4–6 個百分點,達到規格);只拿攻防牌 53–70%(少 4–10);只拿空戰牌 51–61%(少 12–13)。
空戰派卡在錢:電視廣告一張 300 萬,逆風 2、3 級又砍資金和收入;核心牌加強、空戰牌打七折之後還是追不上。之後可以考慮空戰派的錢從哪裡來(例如網路牌回收一點資金)。
- **你的類型**(`--archetypes all`):「打得好」98–100%(差距 +6.2~+10.8);「隨手玩」資深型 32–46%、清廉型 44–50%、媒體型 44–61%、黑馬型 55%、財務型 49–62%(原本最難,加了「資金自動加票」)、組織型 60–74%。
- **對手的類型**(`--rivals all`,隨手玩):媒體型 33–46%、組織型 50–58%、資深型 43–55%、財務型 29–45%、清廉型 47–60%、黑馬型 36–47%(沒有類型時 37–46%)。
第 6 節的兩個目標(打得好 75–85%、隨手玩 35–45%)在目前的技術差距下互相衝突:兩種玩家差 8 個百分點,
把會打的人壓到 85% 以下,隨手玩會掉到一成左右。所以標準難度不再加難(隨手玩已經落在目標裡),
會打的人靠「贏了直接挑戰下一級逆風」往上爬(逆風 6 約七成)。
## 0. 現況診斷
| 問題 | 證據 |
|---|---|
| 最佳解太明顯 | `rogue-balance`:標準難度「看預估挑最划算的」勝率 100%(雙方),平均贏 7.9 個百分點;逆風 6 才降到 85%/77%。前端把每張手牌打在每一區的票數都算好(`view.ts previewsFor`) |
| 流派沒有身分感 | 只拿某一派牌,差距都在 2.3 個百分點內;67 張牌裡單區加票 16 張、全市加票 12 張,改規則的能力牌只有 2 張(媒體訓練、蹲點研究) |
| 選誰都一樣 | 真實候選人只有 `recordAbilities`(`apps/server/src/people-routes.ts`)算出的 0–2 級媒體/組織/口才,財務、清廉固定 0;效果是口才每級 +4%、組織每級盾 +10%、媒體每級爆紅 +3%;每日一戰完全不套用。出身專屬牌只給自創角色。沒有本命區 |
| 每局行程一樣 | `scenes.ts`:`DEBATE_WEEK = 3`、`POLL_WEEK = 4`、`CRISIS_WEEK = 6`;`rival.ts`:`BIG_RALLY_WEEK = 7` |
| 對手單薄 | 7 種意圖;三種風格只是倍率(`STYLE_WEIGHTS`、組織戰盾 ×1.4、空戰廣告 ×1.2) |
| 局中回饋小 | 翻轉一區只有聲勢 +1(`mechanics.ts`),插旗每週 20 萬 |
| 跨局目標分散 | 政績點、小鎮幣、聲望、政策島、成就、逆風、生涯同時存在 |
## 1. 候選人特色:本命區+類型技能(第一優先)
參考:《殺戮尖塔》每個角色的起始遺物與專屬牌、《小丑牌》每副牌的開局規則、《怪物火車》的氏族。
目標:選不同候選人,第一週就打得不一樣。
### 1a 本命區
- **怎麼決定**(只用客觀資料,附依據文字):開局時(`rogue/src/setup.ts`)對每一區算 `lean.you − 全縣市平均 lean.you`,
只看選舉人數至少佔全市 3% 的區,取最大的 1 區(縣市長、立委)或 2 個縣市(總統)。自創角色在政治生涯用家鄉那一區(里長、議員關就是自己的里那一塊)。
對手用同樣的算法也有本命區(規則對稱)。
- **資料**:`TownSetup.home?: "you" | "rival"` → `TownState.home`;`protocol/src/rogue.ts` 的 `RogueTown` 加 `home`;`RunOptions.homeBasis`(「這區你的底盤比全市平均高 X 個百分點」)。
- **效果**(常數放 `state.ts`):
- `HOME_MULT = 1.2`:你的牌打在你的本命區 +20%(在 `cards.ts` 的加成鏈裡,跟 `POLICY_HOME` 同一段寫法,畫面上一樣逐項跳出「本命區 ×1.2」)。
- 代價與高潮:本命區的旗被翻走,你的聲勢 −2(一般是對手 +1);你翻走**對手**的本命區,你的聲勢 +2,且對手下週少一個行動。
- 每個人開局牌組多一張「回鄉造勢」(新牌 `homecoming`;插圖先共用農會總幹事的 `homecoming`,之後用 `art/` 腳本補專屬插圖):1 體力,只能打在本命區,+2,600(以全市 100 萬人為基準,照 `scale` 縮放)、聲勢 +1。
- **畫面**:選人畫面在小地圖上標本命區並寫依據;局內地圖本命區加一個家的圖示;對手的本命區也標出來(變成目標)。
### 1b 類型與技能
- **怎麼決定**:
- 真實候選人:用 `recordAbilities` 已經算好的媒體、組織、口才三項,取最高的一項當類型;同分依 媒體 → 組織 → 口才;全部 0 → 黑馬型。
`candidateStats(...).wealth ≥ 8` 且三項都不到 2 級 → 財務型(財力來自劇本的真實政治獻金,`content/src/candidates.ts`)。
- 自創角色:出身對應的能力(`protocol/src/origins.ts` 的 `ORIGINS`)就是類型,五種都可能。
- **每日一戰也要套用**(目前 `rogue-routes.ts:159` 每日一戰把能力設成 null):同一天大家玩同一個人、同一個類型,仍然公平。
- **資料**:`RunOptions.archetype: "media" | "organization" | "eloquence" | "finance" | "integrity" | "newcomer"`;
技能用現有的 `powers` 機制實作(`powers: ["arch_media"]` 這類),畫面上和「媒體訓練」一樣常駐顯示。舊的每級小加成保留給政治生涯練等用。
- **技能表**(強項要「改規則」而不是小 %;弱點一律是中性的機制,不寫對真人的評價,見第 9 節):
| 類型 | 依據 | 技能(強項) | 弱點 | 開局專屬牌(取代 1 張掃街) |
|---|---|---|---|---|
| 媒體型 | 單次最高得票多 | 空戰牌(media、online、tv)+15%;每週第一次爆紅成功,下一張空戰牌再 ×2 | 對手的批評 +20% | 臉書直播(`live`) |
| 組織型 | 當選次數多 | 每週開始,本命區自動有一座樁腳(盾 = 佈樁基礎值);佈樁牌每週第一張不花體力 | 空戰牌 −15% | 志工大隊(`volunteers`) |
| 資深型 | 從政年資長 | 記者會類(press)+20%;辯論多一張論點;「記者追問」不花體力 | 年輕人多的區 −10%(規格 −15%,依模擬調過) | 政策白皮書(`whitepaper`) |
| 財務型 | 政治獻金多 | 每週資金 +100 萬;物資行八折;新牌「地毯式廣告」可以把錢換成票 | 地面牌 −10% | 募款餐會(`dinner`)多一張 |
| 清廉型 | 自創角色出身(醫師) | 黑函危機損失減半;「記者追問」不會被塞進牌組 | 每週資金 −20% | 巡迴義診(`origin_clinic`) |
| 黑馬型 | 沒有當選紀錄、小黨 | 聲勢每點 +16%(一般 +8%);每翻轉一區多抽 1 張 | 起始資金 −30% | 徒步掃街(`walkx`) |
- **對手也有類型**(同一套算法,用對手的選舉紀錄):對手的類型決定 `rivalStyle`(媒體型 → air、組織型 → ground、其他 → balanced),並影響第 3 節的對手規則抽籤。
### 1c 接上流派
- 「拜會地方」三選一時,和類型相同派系的牌權重 ×1.5(`route.ts` 產生牌的地方)。
- 牌組裡同一派系的牌到 4 張以上,該派系的核心牌(第 2 節)開始會出現在獎勵裡。
## 2. 流派與爆分
參考:《小丑牌》的小丑牌(乘數疊乘數)、《怪物火車》的兩條主線交叉。
目標:組成形的單一流派,比混著打多 5–10 個百分點;各流派最好的打法彼此差 ±3 個百分點以內。
每派加 2 張核心牌(稀有)+1 位改規則的幕僚(`data.ts`、`advisors.ts`)。能力牌(power)打出後整局有效,沿用現有 `powers`。
| 派系 | 核心牌 1 | 核心牌 2 | 幕僚 |
|---|---|---|---|
| 地面 | 「走透透」能力:同一週每多打一張地面牌,之後的地面牌 +8%(疊加,週末歸零) | 「遍地開花」(原名挨家挨戶,和一般牌撞名):這週在幾個不同的區出過牌,就 +幾倍的基礎票 | 「鐵腿」:一週在 3 個以上不同的區出牌,週末聲勢 +2 |
| 組織 | 「樁腳網」能力:週末每座還在的樁腳,在那區把盾剩下的一成轉成你的票 | 「全面動員令+」改成插旗的區每區 +票(現有 `mobilize` 加強) | 「派系協調人」:樁腳擋下對手的票,一半轉成你的 |
| 空戰 | 「聲量滾雪球」能力:每打一張空戰牌,聲量 +1(整局不歸零,上限 15);空戰牌 +4% × 聲量 | 「懶人包」:全市 +票,聲量每點多 5% | 「懶人包小編」:爆紅成功後,那張牌回到手上(每週一次) |
| 攻防 | 「反將一軍」:這週擋下的批評,一半變成你的票 | 「沙盤推演」能力:每週多看到對手下週的一個意圖 | 「危機變轉機」:每擋下一次攻擊,聲勢 +1 |
| 資金 | 「地毯式廣告」:花掉手上所有錢,每 100 萬換全市 +票 | 「小額募款」:資金 +,你插旗的區越多募越多 | 「精算師」:週末每 100 萬存款 +3%(錢滾錢,上限 1,000 萬) |
- 新牌的插圖:14 張都用 `art/cards.tsv` 的題材、`art/gen-card-grokcli.sh` 的流程補上專屬插圖(`walk_everywhere`、`snowball_buzz`、`donation_box`…)。
- 新牌、新幕僚加進圖鑑(`view.ts catalog`)。
## 3. 對手規則與精英站
參考:《小丑牌》的 Boss 盲注(每關一條規則)、《殺戮尖塔》的精英怪。
- **對手規則**:開局從規則池抽 1 條(逆風 5 起抽 2 條),選人後、第 1 週前用一張卡片亮出來,局內常駐顯示(`rival.ts`;`RunState.rivalRules: string[]`)。
對手的類型決定池子的權重。起始規則池:
| 規則 | 效果 |
|---|---|
| 名嘴加持 | 對手的批評 ×1.5;被你澄清時,對手聲勢 −1 |
| 地方大老 | 對手插旗的區,你要多領先 4 個百分點才翻得動 |
| 大打空戰 | 對手每週多一個電視或網路行動 |
| 鐵票區 | 對手本命區的盾 ×2 |
| 網路謠言 | 每週隨機一區你的票被拉走一點;打探成功可以停掉一週 |
| 地毯式掃街 | 對手的掃街會擴散到隔壁區兩成 |
| 後發制人 | 現有的風格改成規則:前期弱、每週成長多 |
| 形象牌 | 對手不受黑函影響,但辯論輸了損失加倍 |
- **精英站**:`route.ts` 的下一站多一種「地方派系談判」(`StopKind` 加 `elite`):給一個這週的目標(例如「這週在某區 +X 票」),
下週結算時達成給稀有幕僚或升級兩張牌,沒達成聲勢 −1。第 3、5 週各有一次機會出現。
- **看得到前方**:下一站的面板灰色顯示「下下週」會出現的兩扇門(`prepareRoute` 先抽好兩週),讓玩家規劃。
## 4. 每局行程隨機
- 開局用種子排行事曆,存在 `RunState.schedule`(`rules.ts createRun`):辯論在第 3–5 週、民調在第 4–5 週、黑函在第 5–6 週,不重疊;對手大型造勢第 7 週、選前之夜最後一週不變。
- 另外依縣市特色抽 0–2 個「地方事件週」(`setup.ts` 已有區的特色):宮廟多 → 遶境週(宮廟牌 ×2、造勢會被搶);客家庄 → 義民祭;人口密集 → 捷運通車剪綵;長輩多 → 重陽敬老。
- 畫面上方加一條行事曆,事件週事先看得到。
- `scenes.ts sceneFor` 改讀 `s.schedule`,不再用 `DEBATE_WEEK` 等常數判斷(常數保留當預設值給新手教學)。
## 5. 局中的小勝利
- **翻區**:每翻轉一區,立刻抽 1 張牌(每週最多 2 次),聲勢照舊 +1;翻走對手本命區見 1a。
- **民調週**:領先 → 三選一稀有牌;落後 → 現有的「悲情催票」再加下週體力 +1。
- **結果頁**:最大的字是「贏/差 N 票」,下面標出「最關鍵的一區」(差距最小、被翻最多次的區)。
## 6. 決策要有張力
- **預估**:手牌上的數字只算基礎值與看得到的加成;爆紅、擴散、組合拳改成「+?」圖示,機率牌顯示範圍。新手教學維持完整預估。
- **難度重調**(`rival.ts` 的 `RIVAL_POWER`、`intentsThisWeek`;`mechanics.ts` 的插旗門檻):
標準難度目標:「打得好」75–85%、「隨手玩」35–45%(目前 100%/53%)。
方向:對手每週行動從第 4 週起 +1、意圖數字略大,讓「擋對手」和「自己拉票」搶同一份體力。
- 重調後重跑逆風 0、3、6、10 與生涯的平衡表,寫回 docs/22、23。
## 7. 不中斷、再來一局
- **結果頁**(`web/src/game/rogue/finale.tsx`):主要按鈕「再來一局(逆風 +1)」,同劇本、同候選人;次要按鈕「換一場」(隨機挑一場沒打過的);Enter 鍵直接再來。
- **出牌不等伺服器**(`RogueScreen.tsx`):先用預估值更新畫面和跳字,伺服器回來再校正(不同時只修正數字,不重播動畫)。
- **快速模式**(設定):動畫時間減半;開票夜按住任一鍵快轉。
- 目標一局 15–20 分鐘:前端記錄每週花的時間,寫進 `progress.ts` 的統計。
## 8. 跨局進度收斂
參考:《殺戮尖塔》用勝場解鎖新牌、《小丑牌》每副牌各自的賭注等級、《黑帝斯》輸了也有收穫。
- **一種主要進度**:每局(不論輸贏)依表現給「聲望」,聲望解鎖第 2 節的核心牌與新幕僚(一開始鎖住,圖鑑顯示怎麼拿)。小鎮幣只買外觀(維持 docs/24),政績點只給政策島。
- **逆風分類型記**:`progress.ts` 的最高逆風改成依類型記(媒體型逆風 4、組織型逆風 2…),選人畫面顯示。
- 輸了也給:本局用到的流派累積「熟練度」,滿了解鎖該派的第 2 張核心牌。
## 9. 真實人物的界線(docs/14)
- 本命區、類型只用客觀資料(選民模型底盤、中選會選舉紀錄、政治獻金),每一項附依據文字(沿用 `abilitiesBasis`)。
- 類型名稱、弱點都是中性的機制描述(媒體型、組織型…;「空戰牌 −15%」),不寫「金權」「奧步」這類評價。
- 規則對所有政黨、所有候選人一樣;AI 控制的真實人物照舊不用奧步。
## 10. 實作順序與驗收
| 步驟 | 內容 | 主要檔案 | 驗收 |
|---|---|---|---|
| 1 | 本命區、類型技能、回鄉造勢、每日一戰套用類型 | `rogue/src/setup.ts`、`state.ts`、`cards.ts`、`rules.ts`、`view.ts`、`data.ts`;`protocol/src/rogue.ts`;`apps/server/src/rogue-routes.ts`;`web/src/game/rogue/RogueStart.tsx`、`RogueScreen.tsx` | 新測試:本命區算法、每種類型的技能;`bots.ts` 加依類型的模擬;各類型「打得好」勝率差 ±5 個百分點內 |
| 2 | 流派核心牌與幕僚、獎勵權重 | `data.ts`、`advisors.ts`、`route.ts`、圖鑑 | 單一流派 greedy 比混打多 5–10 個百分點;流派之間 ±3 |
| 3 | 對手規則、精英站、隨機行事曆 | `rival.ts`、`route.ts`、`scenes.ts`、`state.ts` | 每條規則有測試;同一個種子重播結果相同 |
| 4 | 翻區、民調獎勵;結果頁再來一局 | `mechanics.ts`、`scenes.ts`、`web/.../finale.tsx` | 瀏覽器實測:結果頁一鍵開新局 |
| 5 | 難度重調、預估顯示 | `rival.ts`、`mechanics.ts`、`view.ts`、前端手牌 | 標準難度 greedy 75–85%、casual 35–45% |
| 6 | 出牌不等伺服器、快速模式 | `web/src/game/rogue/RogueScreen.tsx`、設定 | 網路延遲 300 ms 時出牌沒有停頓感 |
| 7 | 跨局進度收斂 | `web/src/game/rogue/progress.ts`、`Collection.tsx` | 舊進度能讀、不歸零 |
- **存檔**:`RunState` 加欄位後 `SAVE_VERSION` 升到 3,`migrateRun`(`scenes.ts`)把舊存檔補上預設值(沒有本命區、類型 newcomer、行事曆用舊的固定週次)。
`backend/data/runs/` 有進行中的局,不要直接拒讀舊版。
- 每一步:更新 `packages/rogue/test`、跑 `apps/sim` 的 `rogue-balance`、`career-balance`,結果寫回 docs/22、23。