election-game/backend/docs/27-gameplay-v5-and-assets.md

141 lines
16 KiB
Markdown
Raw Permalink 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.

# 27 選戰卡牌第五版:趕場、政見支票,與資源瘦身
> 2026-10-30。使用者要求:「研究一下目前的遊戲機制,網路上好玩的桌遊機制,引人入勝,然後針對資源來說,前後端量都要再小一點,載入速度更快一點。」
> 本文件記錄:資源怎麼量、改了什麼、改完多快;桌遊機制研究;新增的兩個機制(趕場、政見支票)與平衡量測;開局能力和升等改成同一套(第 6 節)。
## 1. 資源與載入速度
### 1a 怎麼量
用 Playwright 開正式版(`vite build` 後 `vite preview`,`/api` 轉給伺服器),每次都是全新的瀏覽器(沒有快取),
網路模擬 4G(10 Mbps、延遲 40 ms),記錄每個請求實際傳了多少(壓縮後)、首頁載入畫面什麼時候放開。量測腳本不進 repo。
### 1b 結果
| | 改前 | 改後 |
|---|---:|---:|
| 首頁:下載量 | 8.7 MB(66 個請求) | **1.6 MB**(60 個) |
| 首頁:載入畫面放開 | 4.4 秒(撐到 4 秒上限,3D 小鎮還沒搭好) | **1.5 秒**(小鎮搭好) |
| 進一局:下載量 | 5.0 MB | **1.3 MB** |
| 首頁連外部網站 | Google Fonts(CSS 207 KB+字型) | 0 個 |
| `public/assets` 音樂 | 16 MB | 11 MB |
| 3D 模型合計 | 5.5 MB | 1.0 MB |
| 首頁要的劇本清單 | 1.52 MB(壓縮後 59 KB) | 0.44 MB(壓縮後 28 KB) |
改前首頁的 8.7 MB:字型 3.4 MB、3D 模型 3.3 MB、Google Fonts 0.7 MB、卡圖 0.4 MB、木紋貼圖 0.3 MB、程式 0.3 MB。
### 1c 做了什麼
| 項目 | 問題 | 做法 | 重做的指令 |
|---|---|---|---|
| 中文字型 | jf 粉圓 2.1 MB、源泉圓體子集 1.3 MB,每個畫面都整個下載 | 切成約 200 字一片的 unicode-range 小片,照「這個遊戲畫面上多常出現」排:首頁看得到的字(含載入中、3D 看板上的字)在第 1 片,接著一局的畫面、卡牌目錄、鄉鎮區名與候選人、程式裡的字、村里與歷屆參選人,最後其他字照字碼。首頁只要每種字型 2 片(約 140 KB) | `uv run art/fonts/split-webfonts.py`(畫面文字大改後,`art/fonts/screens.txt` 可以重抓) |
| 字型的 CSS | 依頻率排的字要一個一個列,CSS 153 KB | 其他字的片可以跨過字型裡沒有的字碼(範圍合併):153 KB → 124 KB,壓縮後 14 KB(brotli)/33 KB(gzip)。**範圍不能重疊**:重疊時 Chrome 兩片都下載(試過把「其他字」寫成一整段放在前面,首頁多抓了 6 片) | 同上 |
| OFL | 切過的字型是修改版 | 內部名稱改成 Tongsuan UI Regular/Tongsuan Rounded Heavy(不用 open huninn、huninn、Varela、Source),版權與授權欄位保留;原始檔放 `art/fonts/` | — |
| Google Fonts | 載入時先下載 Noto Sans TC 當替代字型;CSS 本身 750 KB(壓縮後 207 KB) | Noto Sans TC 拿掉(只是替代字,改用系統字);Barlow Condensed(數字)自己放 3 個 22 KB 的檔;報紙用的 Noto Serif TC 進任期小遊戲才載(`web/src/game/ui/newsFont.ts`) | — |
| canvas 上的字 | 3D 看板、名牌、分享圖用 canvas 畫字,切片後那幾個字的片可能還沒下載 | 先畫,字型片載好再畫一次(`web/src/game/ui/canvasFont.ts`);分享圖先載圖上會出現的所有字 | — |
| 3D 模型 | 每個角色 250 KB:32 段動作(只用 4 段)、用不到的切線和第二組貼圖座標、浮點數座標 | glTF-Transform:只留 static、idle、emote-yes、jump,拿掉用不到的頂點資料,量化+meshopt 壓縮;貼圖維持外部共用檔。角色 250 → 33 KB,合計 5.5 → 1.0 MB。前端統一用 `web/src/game/gltf.ts`(MeshoptDecoder)。`board3d/town.ts` 會把模型套上矩陣再合併,量化的整數座標要先換回浮點數 | `cd art && npm i --no-save @gltf-transform/core@4 @gltf-transform/extensions@4 @gltf-transform/functions@4 meshoptimizer@0.22 && node optimize-3d.mjs`(已經壓過的跳過) |
| 卡圖 | 640×640(平均 50 KB),手牌只顯示約 120 px 寬 | 另存 320 px 小圖(平均 21 KB),`CardArt` 用 `srcset` + `sizes="auto, 200px"` 讓瀏覽器照實際寬度挑 | `art/cards-small.sh`(新增卡圖後跑) |
| 木紋貼圖 | 1024 px,桌面重複貼 7–9 次 | 512 px(199 → 37 KB);法線貼圖幾乎是平的(46 → 2 KB) | — |
| 背景音樂 | Chrome、Firefox 用 OGG:150–320 kbps 的 Vorbis,主題曲 2.6 MB(第一次點擊就下載) | Opus 96 kbps(主題曲 0.9 MB)。先轉 48 kHz 無損再壓:直接用 ffmpeg 壓 Vorbis 或 Opus,有的曲子開頭或結尾會多幾百個取樣,迴圈會有小空隙;兩段式壓完每首都和原曲一樣長(瀏覽器 `decodeAudioData` 驗證過)。Safari 照舊用 MP3 | `art/music-opus.sh` |
| 主畫面圖示 | iPhone 加到主畫面的圖示:投票箱擠在下面、選票頂到上緣被 iOS 的圓角切掉,平塗、角落有灰點 | 重畫(`art/icon/icon.svg` 1024 滿版原稿):放射光+彩帶的黃底、投票箱放大置中有立體感、選票插進投票口、臉放大。apple-touch 滿版不透明(iOS 自己切圓角);manifest 另加 Android 用的 maskable(圖案縮進安全圓);連結加 `?v=2` 讓舊的圖示快取失效 | `art/icon/render-icons.sh`(rsvg-convert、ImageMagick) |
| 劇本清單 | `/api/scenarios` 438 個劇本 1.52 MB:說明、數字出處、政治獻金、能力值…首頁都用不到,前端還要用 Zod 驗證整包 | 新增 `GET /api/scenarios/list`(`ScenarioListItem`,只留畫面用到的欄位,伺服器算一次、轉一次 JSON);完整版保留給需要出處的地方 | — |
後端每一步的回應本來就小(出牌、結束這週壓縮後 5–6 KB),沒有改。
## 2. 桌遊機制研究
docs/26 第 2 節已經借了《殺戮尖塔》的意圖、《冷戰熱鬥》的關鍵區、追趕機制、進階難度、流派。這次找的是「還沒有的」,
原則是多一個決定、不要多一段說明(使用者說過字太多)。
| 排名 | 機制 | 來源 | 為什麼好玩 | 放進這個遊戲 | 成本 | 這次 |
|---|---|---|---|---|---|---|
| 1 | 推運氣:自己決定要不要再抽 | 《Quacks of Quedlinburg》的鍋子爆炸([評論](https://www.meeplemountain.com/reviews/the-quacks-of-quedlinburg/)) | 風險是自己選的,「再抽一顆就停」撐過去特別爽,爆了也會想再來 | **趕場**(第 3 節) | M | 做了 |
| 2 | 藏起來的長期目標 | 《鐵道任務》的目的地車票([維基](https://en.wikipedia.org/wiki/Ticket_to_Ride_(board_game)));蔡格尼克效應([說明](https://learningloop.io/plays/psychology/zeigarnik-effect)) | 沒做完的事放不下、離目標越近越想衝 | **政見支票**(第 4 節) | S–M | 做了 |
| 3 | 雙方共用的紅線 | 《冷戰熱鬥》的 DEFCON([維基](https://en.wikipedia.org/wiki/Twilight_Struggle)、[設計分析](https://brandonthegamedev.com/twilight-struggle-maintaining-tension/)) | 比膽量,還能誘對手先踩線 | 負面選戰溫度計:攻擊雙方都加溫,推到頂的一方掉票;越熱攻擊越有效 | S(對手 AI 要學會避線是 M) | 之後 |
| 4 | 一次性的錦囊 | 《殺戮尖塔》的藥水([wiki](https://slaythespire.wiki.gg/wiki/Potions)) | 不花能量、留著保命還是現在用 | 贏戰場、翻區掉錦囊:換戰場、延後一個對手意圖、重抽手牌 | M | 之後 |
| 5 | 一張牌兩種用途 | 《1960》行動點或事件([維基](https://en.wikipedia.org/wiki/1960:_The_Making_of_the_President))、《沙丘:帝國》回合末掀牌([評論](https://gamingtrend.com/feature/reviews/dune-imperium-review-you-must-not-fear/)) | 沒有廢牌 | 週末還在手上的牌依流派給小獎勵 | S | 之後 |
| 6 | 開局祝福 | 《殺戮尖塔》的 Neow([wiki](https://slaythespire.wiki.gg/wiki/Neow)) | 第一個決定就帶賭性 | 第 1 週前四選一(刪牌、資金、稀有幕僚換人情包袱…) | S | 之後(和支票都在第 1 週,先只做支票) |
| 7 | 越貪越危險的強化 | 《Inscryption》的營火([攻略](https://happymag.tv/inscryption-guide-tips-tricks/)) | 一直加強同一張牌,但可能被吃掉 | 黨部研習「再練一次」 | S | 之後(和趕場都是推運氣,避免重複) |
考慮過但沒排:地盤連成一片加分(《鐵道任務》最長路線)——18 個只有一區的立委選區、離島沒有鄰區可連,而且 219 張地圖都要重新校準。
## 3. 趕場(`rogue/src/overtime.ts`、`POST /api/rogue/runs/:id/overtime`)
- 這週體力用完,「結束這週」上面出現「趕場 ⚠ 2/11」:翻牌庫最上面一張,**這週打它不花體力**(錢照付)。
- 每趕一場,牌庫隨機位置多 2 張「疲勞」(虛無牌:抽到後留在手上過週末就消失)。越趕越容易出包,而且下週的手牌也會比較髒。
- 翻到負面狀態牌(疲勞、記者追問、人情包袱、黨中央風波;悲情催票、黨部動員這種好的狀態牌不算)就**翻車**:
這週不能再趕,下週體力 −1、聲勢 −1;翻到的那張照樣進手牌(記者追問不回應,週末一樣掉票)。
- 按鈕上的「⚠ 2/11」是牌庫 11 張裡有 2 張會翻車;三成以上框變紅。規則寫在滑過提示,不加說明文字。
- 翻到的牌在手牌上體力圓點是夜色、寫 0;只免費打一次,同一週又洗回手上(重抽、退回手上)就照付體力。新手教學沒有。
- 模擬玩家:打得好的人風險低於 25% 就再翻(`bots.ts OVERTIME_RISK`);隨手玩的人每週翻一張試試。
平衡(`node apps/sim/src/overtime-balance.ts --seeds 30 --asc <n>`:桃園、新竹市、連江、金門、台南 2022 的勢均力敵版,兩大黨各一位,
你和對手的類型輪流、對手風格照實際比例;每格 300 局,同一批種子比較):
| 逆風 | 玩家 | 沒有趕場:勝率/平均差距 | 有趕場 | 每局翻幾張 | 每局翻車 |
|---:|---|---:|---:|---:|---:|
| 0 | 隨手玩 | 46%/−0.4 | 49%/−0.2 | 6.1 | 0.9 |
| 0 | 打得好 | 94%/+3.3 | 94%/+3.5 | 5.9 | 0.5 |
| 3 | 隨手玩 | 15%/−2.7 | 22%/−2.3 | 6.5 | 1.1 |
| 3 | 打得好 | 74%/+1.5 | 79%/+1.8 | 6.1 | 0.5 |
| 5 | 隨手玩 | 6%/−3.8 | 13%/−3.6 | 6.2 | 1.4 |
| 5 | 打得好 | 54%/−0.2 | 56%/+0.3 | 5.2 | 0.6 |
| 8 | 隨手玩 | 1%/−5.4 | 5%/−5.2 | 6.1 | 1.4 |
| 8 | 打得好 | 31%/−1.6 | 30%/−1.4 | 5.2 | 0.6 |
平均差距多 0.2–0.5 個百分點,不到逆風半級(每級 0.3–0.9),所以沒有重調對手強度和逐張地圖校準。
每局平均翻 5–6 張、翻車 0.5–1.4 次:不看風險一直翻的人(隨手玩)翻車的比例是打得好的兩倍多,風險是真的。
## 4. 政見支票(`rogue/src/pledges.ts`)
- 第 1 週是「開跑記者會」:手牌最左邊的事件牌(和記者堵麥同一套畫面),三張支票加「不開支票」。沒回答就結束這週當作不開;API 送 `skip` 也是不開。
- 開票夜揭曉:照投票日的票數判定(投票率加完之後,所以「本命區領先幾個百分點」和開票畫面的數字一致),**兌現全市 +0.6%**(已表態的票)、**跳票 −0.6%**。開票畫面多一行「政見支票『插旗 5 區』兌現 +1,234 票」。
- 狀態列多一格「支票 2/4」(做到了變綠;「不打負面選戰」寫守住/破功),條件寫在滑過提示。
- 題目都用局裡原本就有的東西,依地圖決定開不開得出來:
| 支票 | 條件 | 什麼地圖有 |
|---|---|---|
| 插旗 N 區 | 開票時至少 N 區插著你的旗(N=區數的四成,至少 2) | 4 區以上 |
| 贏下 N 次本週戰場 | 整局贏 N 次(N=週數的一半) | 2 區以上 |
| 本命區大勝 | 開票時本命區領先 15 個百分點 | 有本命區 |
| 翻轉 N 區 | 整局翻過來 N 區(12 區以上 3,其他 2) | 3 區以上 |
| 同一區打出 4 種牌 | 有一週在同一區打出 4 種不同的牌 | 全部 |
| 不打負面選戰 | 整局不打攻擊牌 | 全部 |
- 抽哪三張用這局種子另外起一串亂數,不動到局裡的亂數:同一個種子的其他內容和沒有支票時一樣(挑戰朋友、每日一戰、測試都靠這點)。
- 模擬玩家一律不開,連「什麼都不做」的基準也不開(它們不會照著目標打),平衡報告和逐張地圖校準不受影響。會打的人可以挑自己做得到的,算是技術的回報。
## 6. 開局能力和升等是同一套(`protocol/origins.ts`)
> 使用者回報:「總覺得一開始選的能力,跟升等之後可以增加的,好像沒關係?」
**原本的問題**:捏人物的「能力」是經典模式(2026-10-26 刪掉)留下來的知名度、口才、謀略、財力、人脈,各 0–10、共 25 點;政治生涯升等加的是口才、組織、媒體、財務、清廉。開局時在背後換算((點數 − 3) ÷ 3 四捨五入、最多 2 級),畫面上都沒寫:
- 只有口才同名;知名度→媒體、人脈→組織、財力→財務。**謀略完全沒有作用**,清廉不能配(只有醫師、社運出身 +1)。
- 換算是看不到的階梯:0–4 點都是 0 級、5–7 點都是 1 級。
- 說明文字(失言機率、自掏腰包上限、幕僚人數、祕密行動)是經典模式的,選戰卡牌裡沒有。
- **藏起來的效果**:知名度、財力、人脈和出身還會經過舊引擎的候選人數值(知名度、資金、組織)改開局得票和資金。彰化縣長的劇本知名度配滿,開局 31.6% → 48.7%(勢均力敵也多約 5 個百分點),所以「知名度配滿」是最強的配法;前藝人、政二代開局多約 1 個百分點,企業家多 60–90 萬。
**改成**:
- 捏人物的「能力」分頁就是那五項(同樣的圖示、顏色、5 格能力條):**總共 5 點、每項自己最多配 2 點**(平均分配=每項 1 點,政治生涯「快速捏一個」也用這組)。斜線格是出身、黨給的(各 +1,旁邊標「律師 +1」「大黨 +1」),實心格是自己配的,虛線空格是之後升等再加(每項最多 5 級)。每項寫每一級的效果(`ABILITY_EFFECTS`,捏人物、角色卡、圖鑑共用一份)。
- 政治生涯角色卡的能力條加圖例:淺色=開局(捏人物配的+出身+黨),深色=升等加的。
- 藏起來的效果拿掉:`content/custom.ts` 給引擎的知名度、口才、資金、組織固定用舊版每項 5 點的數值(平衡模擬一直用這組),只依政黨分大黨、民眾黨、其他。黨的資源寫著的「資金多/中等/少」照舊。
- 相容:`CustomCandidate.points` 是新的開局能力點;`stats`(舊版點數)變成選填。舊存檔讀進來用 `legacyPoints` 換算(舊的階梯,再補滿或扣回 5 點:補的先給清廉,扣的從最多的扣);政治生涯存檔的規則版本 2 → 3,開局那部分重算、升等加的點保留(舊存檔每項 5 點的角色清廉多 1 級)。前端開局時另外送每項 5 點的 `stats`,還沒重啟的舊版伺服器也收(政治生涯本來就自己送能力,不受影響)。
**平衡**(政治生涯的條件:照真實底盤、最多落後 10 個百分點、逆風 2;桃園市第 1 選區立委、台中市長 × 大黨/無黨籍 × 10 種出身 × 10 個種子):
| | 開局得票(同一黨的 10 種出身) | 隨手玩 | 打得好 |
|---|---|---:|---:|
| 改前 | 差到 2.3 個百分點(前藝人、政二代最高,基層里長最低) | 8.8% | 70.3% |
| 改後 | 完全一樣 | 8.0% | 68.0% |
勝率的差距在雜訊範圍內(每種玩家 800 局,打得好的標準誤約 1.6 個百分點)。
## 5. 之後可以做
- 第 2 節排名 3–7 的機制;負面選戰溫度計最便宜,可以順便補強攻防流派。
- 模擬玩家學會照支票打(例如支票是戰場就加重戰場的分數),量「開支票的人」的勝率。
- three.js 那一包(壓縮後 155 KB)首頁、一局都要;可以再看能不能只引入用到的部分。
- `cardboard-diff.jpg`(100 KB,首頁的棋盤紙板)還是 1024 px。