election-game/backend/docs/22-rogue-v2.md

142 lines
13 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.

# 22 選戰卡牌第二版:更多機制、精緻度、重玩性、政治生涯
2026-10-26 使用者試玩第一版後說「趣味性確實變多了,請繼續把該做的東西都做完,也要更多有趣的遊戲機制」。
這一版照改造計劃(https://claude.ai/artifact/UdMUGSaWTcp8jNZQS9w55B)做完第 2–4 階段(線上排行榜除外),另外加了幾個新機制。
參考了使用者提供的遊戲開發工具清單(gamedev-skills/awesome-gamedev-agent-skills)裡 card-game、game-feel、game-ui-ux、save-systems 的原則:
效果用資料描述、回饋分輕重兩級、畫面震動可以關、存檔加版本號。清單裡大多是 Godot/Unity/Unreal 專用,沒有安裝。
## 玩法入口(#/rogue)
| 模式 | 內容 |
|---|---|
| 新手教學 | 虛構的「幸福里里長選舉」,3 個里、3 週、固定牌組,畫面上一步一步提示(隨手玩約九成會贏) |
| 每日一戰 | 每天從縣市長劇本挑一場、挑一位候選人,逆風 3 級、勢均力敵,同一天同一個種子;成績記在瀏覽器 |
| 自由選戰 | 全台縣市長(2014/2018/2022)、區域立委(2020/2024)、總統(1996–2024),可選任何候選人;「勢均力敵」開關(關掉就是照當年底盤);逆風 0 到已解鎖的等級 |
| 政治生涯 | 自創角色從里長一路選到總統(#/rogue/career);現行規則見 docs/23「完整的政治生涯」 |
| 朋友挑戰 | 結果畫面「挑戰朋友」複製連結:同一場選舉、同一個種子、同樣的逆風,朋友打開就能比(伺服器要在同一個網路或上線後才連得到) |
| 圖鑑與成就 | 牌、幕僚、事件看過才會亮;22 個成就;統計局數、勝場、逆風解鎖(#/rogue/collection) |
## 首頁(2026-10-26,18 第 28 項)
使用者確認「主要遊戲機制就是要變這樣」,首頁改成以選戰卡牌為主(web/src/game/home):
- 上面保留會動的 3D 選戰小鎮,標語改成「出牌拉票 一區一區翻過來」。右下角有一手示範牌,點一張就打進小鎮(牌飛過去、造勢放煙火、宣傳車加速、群眾跳起來、跳出票數),一進首頁就摸得到核心動作。
- 主按鈕看進度:有沒打完的局就「繼續選戰」,第一次玩就「開始選戰(先玩 5 分鐘新手教學)」,其他時候往下捲到大廳;旁邊是「政治生涯」。
- 下面依序是:選戰卡牌大廳(和 #/rogue 同一個元件:教學、每日一戰、自由選戰、政治生涯、圖鑑與成就、朋友的挑戰)、一週怎麼玩、真實資料(22 縣市、368 鄉鎮市區、7,781 村里、65 場縣市長、146 區立委、8 屆總統)、牌與幕僚預覽、捏人物。
- 捏人物多一個「存起來,去政治生涯」。(舊的十週行程版在 2026-10-26 依使用者要求刪除。)
- 捏人物、圖鑑、資料檢視器等改成用到才下載,首頁的程式從 1.4 MB 降到 1.08 MB。
開票夜同時加上地圖:還沒開的區是灰的,開出來的區塗上贏家的顏色(贏越多越深),剛開的那一區框起來並跳出差距。
堵麥題目擴充到 24 題、地方抉擇 22 個、每週事件 16 種。
## 一局的節奏(8 週)
| 週 | 開場 | 特色 |
|---|---|---|
| 每週 | 電視快報(鄉民直播台,七秒) | 上週戰果、全市支持度、本週事件、對手動向 |
| 1 | — | 打底盤,對手不批評 |
| 2、5、7 | 記者堵麥 | 依上週發生的事出題(被批評、造勢、翻轉、颱風、錢多錢少…),2–3 個回應 |
| 3 | 電視辯論 | 論點連擊辯論(見 docs/23「論點連擊辯論」,取代原本的三回合猜拳) |
| 4 | 民調公布 | 領先:西瓜效應聲勢 +1;落後:手上多一張「悲情催票」 |
| 5 | — | 對手預告第 7 週的大型造勢(地圖上標出來) |
| 6 | 匿名黑函危機 | 提告(250 萬,損失剩三成)/冷處理(一半機率剩四成,否則更慘)/悲情反擊(剩七成、聲勢 +2)/公開資料自清(體力 −1、沒有損失) |
| 7 | 記者堵麥 | 對手的大型造勢(預告值 ×2.4) |
| 8 | 選前之夜 | 體力 +1,造勢牌 ×1.3,可以下跪 |
| 開票 | 開票夜 | 小區先開、大區最後,最後三區放慢;領先換人時閃一下 |
每週結束選**下一站**(三選一,第 2、4、6 週一定有招募幕僚;逆風 4 級起只有兩個選項),或回總部休息拿 150 萬:
- 拜會地方:三選一新牌(普通 3:稀有 1)
- 招募幕僚:三選一幕僚(最多 5 位)
- 黨部研習:升級一張牌
- 整頓行程:從牌組拿掉一張牌(牌組 8 張以下不會出現)
- 競選物資行:3 張牌(普通 120 萬、稀有 220 萬)、1 位幕僚(300 萬)、刪牌服務(100 萬),可以買好幾樣
- 深入基層:拜票副本(沿用 content/encounters.ts 的虛構路人),三個人的應對分數(−6 到 +6)決定那區加多少票,總分 4 分以上聲勢 +1
- 地方抉擇:12 種有代價的選擇(企業主捐款附帶人情包袱、網紅業配、廟方邀請、颱風清淤、老牌操盤手…)
## 機制
- **牌(44 張可抽到的牌+6 張開局牌+6 張劇情與狀態牌)**:地面、組織、空戰、攻防、資金五派,稀有牌有金框。
- **關鍵字**:消耗(這局用一次就沒了)、保留(週末留在手上)、虛無(週末還在手上就消失)、不能打。
- **升級(+版)**:數字 ×1.35;有些改成少 1 點體力、多一點效果(造勢+聲勢 +3、打探+一定拿到把柄)。
- **能力牌**:媒體訓練(之後媒體牌 +25%)、蹲點研究(之後地面牌 +15%),打出後整局有效。
- **狀態牌**:記者追問(對手批評你沒擋下、黑函會塞進來;花 1 點體力回應就移除,留著過週末全市掉票)、人情包袱(不能打,要整頓行程才拿得掉)、疲勞(不能打,週末消失)。
- **插旗與翻轉**:已表態的票裡領先 8 個百分點就插旗。每面旗每週 20 萬小額捐款;把對手插過旗的區拿過來(中間掉成沒人插旗也算),聲勢 +1;被翻走,對手聲勢 +1。
- **隔壁區**:造勢、宣傳車、宣傳車隊長會擴散到相鄰的區。相鄰由地圖拓撲算(共用邊界的區),總統選舉用縣市。
- **幕僚(32 位)**:地區型(客家事務主任、農會總幹事…)、牌型(宮廟通、造勢天王…)、規則型(開場哥:每週第一張牌 +50%;夜貓子:用掉最後一點體力的牌 +50%;行程秘書:體力 +1 但少抽一張;鐵票部隊:插旗的區對手行動減半…)。都是虛構職位,頭像用漫畫產生器。
- **對手性格**:組織戰(佈樁盾 ×1.4)、空戰(廣告 ×1.2)、後發制人(前期 ×0.92、每週成長 9%),依劇本的 AI 風格決定。
- **逆風 0–10**(2026-10-30 重排,現行版本見 docs/26 第 4 節):贏了第 n 級開第 n+1 級。1 對手 +12%、2 起始資金 −40%、3 每週收入 −40%、4 選項只剩 2 個、5 開局多一張人情包袱、6 對手第 4 週起多一個行動、7 對手開局聲勢 2、8 你的牌 −8%、9 黑函加倍且壞事件變多、10 開局落後 3 個百分點。
- **成就(22 個)**:凍蒜、壓倒性勝利、驚險過關、逆轉勝、以小搏大、全區插旗、乾淨選戰、辯論三戰全勝、黑函零損失、四連拳、翻轉王、一張定江山、精實牌組、財源滾滾、滿編團隊、物資行常客、逆風高手、逆風傳說、每日一戰、國會新科、地方首長、登上大位。
- **當選判斷**:要贏過對手,也要贏過「其他候選人」裡最強的那一位(不是其他人的票加起來)。
## 手感與畫面(第 2 階段)
- 卡牌重做:稀有度外框、類型色條與圖示、大數字、關鍵字、+版發光(web/src/game/rogue/cards.tsx)。
- 出牌:牌飛向地圖、爆分(加成一個一個跳出來、音越來越高、總票數蹦出來)、翻轉時畫面震動。設定裡可以關「畫面震動」;系統「減少動態效果」時不飛牌、不震動。
- 手機直式:地圖和「各區・對手」用分頁切換,狀態列三行,手牌固定在下面;按鈕至少 40px。
- 開票夜、結果畫面、分享結果圖卡(canvas 畫 1080×1350 PNG,標「遊戲模擬」,真實人物只畫號次章)。
## 真實人物的約束(docs/14、18 第 27 項)
- 對手的行動名稱一律中性:批評你的政見、到你的票倉拉票,不寫抹黑、爆料。
- 黑函一律是「匿名黑函」,畫面寫「內容沒有根據、來源不明」,不算在任何候選人頭上。
- 堵麥題目寫「有人質疑」,不捏造真人的話;玩家的爆料只寫「對手支持者動搖」,不寫具體指控。
- 政治生涯讓自創角色和真實候選人同場,畫面標「假設情境,不代表真實選情」。
## 數字從哪來
- 開局底盤:選民模型(人口、年齡、政黨傾向、歷史投票率)算各區預期得票;30% 還沒表態。地區特色和全縣市平均比(`packages/rogue/src/setup.ts`)。
- 牌面與對手行動以「全市 100 萬人投票」為準,乘上比例尺(全市投票人數/100 萬);區的大小係數 (人數/平均)^0.3,夾在 0.6–1.4。
- 其他都是遊戲數字,寫在 backend/packages/rogue/src/data.ts、advisors.ts、content.ts、rival.ts。
## 平衡(apps/sim rogue-balance,2022 桃園勢均力敵)
標準難度,每種玩家 200 局:
| 玩家 | 玩張善政:差距/勝率 | 玩鄭運鵬:差距/勝率 |
|---|---|---|
| 什麼都不做 | −11.4/0% | −12.0/0% |
| 亂出牌 | −5.5/1% | −6.2/0% |
| 都打在人最多的區、不理對手 | −1.6/24% | −2.3/14% |
| 隨手玩(照順序出、打推薦第一名) | +0.2/54% | −0.5/39% |
| 看預估挑最划算的 | +7.9/100% | +7.6/100% |
| +只拿地面/空戰/攻防牌 | +8.5/+6.7/+6.6 | +8.2/+6.4/+6.0 |
逆風階梯(每種 120 局,隨手玩/打得好的勝率):
| 逆風 | 張善政 | 鄭運鵬 |
|---|---|---|
| 0 | 53%/100% | 38%/100% |
| 3 | 38%/98% | 25%/100% |
| 6 | 5%/85% | 4%/77% |
| 10 | 0%/31% | 1%/17% |
- 技術有差:打得好比隨手玩多約 8 個百分點,比亂打多 13 個百分點。
- 沒有一招通吃:只拿某一派牌的差距在 2.3 個百分點以內。
- 新手教學:隨手玩 96%、亂出牌 75%、什麼都不做 0%。
- 逆風階梯是修正審查問題之前跑的;修正後標準難度重跑,差距只變動 0.2 個百分點以內。
## 審查後修正(2026-10-26)
另一個助手逐行審查並跑了約 780 局隨機測試,找到並已修正:
- 打出去的牌在效果結算、抽完牌之後才進棄牌堆(原本「志工大隊+」可以把自己抽回來無限循環);「志工大隊+」改成抽 3 張、不再是 0 體力;「熬夜跑行程」每週只能打一次;手牌上限 10 張。
- 一次打好幾區的牌(志工電話催票、電話拜票中心、全面動員令)也算打過那幾區,重複打不再有組合拳。
- 預估:第二次佈樁只算還沒擋住的威脅;有公關高手、鐵票部隊時,打對台和澄清的預估跟著打折。
- 夜貓子看實際花的體力(網路小編免費的那張不算)。
- 爆分顯示伺服器實際結算的加成(例如爆紅、失言),不是預估。
- 請求失敗後畫面自動重新拿一次這局的狀態。
- 存檔:同一局同時有好幾個請求從檔案讀時共用同一次讀檔,不會互相覆蓋。
- 政治生涯:結果畫面不再出現「挑戰逆風」(自創角色的局不能直接重開);贏了之後重新整理,挑幕僚和牌的畫面還在。
## 程式位置
- 規則:backend/packages/rogue/src(state 型別與常數、data 牌、advisors 幕僚、content 堵麥/抉擇/辯論、cards 出牌、rival 對手、scenes 開場劇情、route 下一站、rules 每週流程與開票、feats 成就、view 畫面資料、setup 開局與相鄰區、tutorial 新手教學、bots 模擬玩家)。
- 存檔:apps/server/src/run-store.ts,每局一個 JSON(backend/data/runs/,可用 ROGUE_SAVE_DIR 改),版本號 SAVE_VERSION=2,舊版存檔不讀;先寫暫存檔再改名。伺服器重開也能繼續玩。
- API:POST /api/rogue/runs(scenarioId、candidateId、seed、ascension、even、daily、custom、career、carry)、/api/rogue/tutorial、GET /api/rogue/catalog、/runs/:id、/play、/end-week、/choose。
- 畫面:web/src/game/rogue(RogueStart 開始、RogueScreen 主畫面、flow 劇情與下一站、finale 開票夜與結果、Career 政治生涯、Collection 圖鑑、brief 電視快報、coach 教學提示、juice 手感、progress 瀏覽器裡的進度)。
## 還沒做
- 線上排行榜、跨裝置的每日一戰排名:要把伺服器放上網路並處理防作弊,另外評估。
- 真機(手機實機)試玩:目前用 Playwright 模擬 390×844 手機畫面。