diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000000000000000000000000000000000000..7c00a590eb5966c356c1f68cad4f63e6bec5af28 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,108 @@ +# CLAUDE.md + +This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. + +> 溝通與註解一律用**繁體中文**(整個 codebase 皆如此)。 + +## 這是什麼 + +卡牌 Rogue-like 的 TypeScript / React / Node 重製版(原版為 C++)。單人闖 11 關打逐關變強的怪物、每關三選一加卡;第 12 關打別人存檔產生的「鬼影」;另有即時 PvP。 + +- **規則的唯一事實來源是 [`guide/`](guide/)**(中文規格,逐項抽取自原版程式)。原版 C++ 在 `../Lengend-of-Strategy-Card-Game-/`,**凍結不動、不讀不改**。 +- 推薦先讀 `guide/HANDOFF.md` → `guide/01-game-design-spec.md`(規則)→ `guide/03-architecture.md`(架構)→ `guide/04-data-schemas-and-api.md`(型別/API)。 +- ⚠️ `guide/00-roadmap.md`、`HANDOFF.md` 等是**早期規格**,部分敘述(如「尚未開工」)已過時。**程式碼是實作現況的事實來源**:battle-core 規則引擎、鬼影、PvP、野蠻人職業皆已落地(見 `src/version.ts` 的 `RULE_VERSION`,目前 `1.2.0`)。 + +## 指令(一律在 `worst-card-game/` 根目錄執行;Node ≥ 20) + +```bash +npm install # 安裝 workspaces +npm test # 跑所有套件測試(主要是 battle-core 的 vitest,含 golden 測試) +npm run typecheck # 全套件型別檢查(最快抓錯的一步) +npm run build # 編譯全套件(battle-core 先,web/server 吃其 dist) +npm run dev # 啟前端 vite dev(:5173,proxy /api 與 /ws 到 :3001) +npm run dev:server # 啟後端 fastify(tsx watch,:3001) +``` + +PvP / 鬼影要兩個都開:一個終端 `npm run dev:server`,另一個 `npm run dev`。 + +battle-core 專屬(在根目錄用 `-w` 指定): + +```bash +npm run test:watch -w @wcg/battle-core # 規則層 watch 模式(改規則時常駐) +npm run build -w @wcg/battle-core # 只重建 battle-core 的 dist +npm run gen:cards -w @wcg/battle-core # 由 src/data/cards.ts 產生 data/cards.json(改卡後必跑) +npm run gen:ghost -w @wcg/battle-core # 產生種子鬼影 +# 跑單一測試檔 / 單一案例(vitest): +npx vitest run packages/battle-core/test/golden.test.ts +npx vitest run -t "G4" # 用測試名稱過濾 +``` + +CI(`.github/workflows/ci.yml`)只跑三步:`npm run build -w @wcg/battle-core` → `npm run typecheck` → `npm test`。送 PR 前本機跑這三步即綠。 + +## 架構:三層分離(最高原則) + +``` +battle-core(純規則引擎,零相依、決定性、可注入種子,不碰畫面/網路) + ▲ import ▲ import + web(React 前端) ◀─HTTP/WS─▶ server(Fastify:鬼影 REST + PvP WebSocket,權威解算) +``` + +**單機 / 鬼影 / PvP 三模式共用同一份 battle-core**。模式差異只能透過: +1. `cards.json` 的 `modeOverride.PVP`(卡的 PvP 數值覆寫),或 +2. 薄協調層(server 的 `pvpHub` / `pvpMatch`)。 + +**嚴禁在 core 內寫 `if (isPvp)` 之類分叉規則。** 職業差異也不在 core 內散落 `if (classType)`,而是集中在 `classes.ts` 的 `CLASS_INIT` 行為旗標(`hasDef` / `handAlwaysFull` / `hasCoinGate`)。 + +### battle-core(`packages/battle-core/`)— 純規則引擎 + +- 對外只透過 `src/index.ts`。核心是 `createGame(opts)` 與 `step(state, action)`:**純函式,同輸入→同輸出**。`step()` 先 `structuredClone` 再在副本上改,確保零副作用、可重播。`replay(seed, actions)` 供後端反作弊重算。 +- **一切亂數走可種子化 PRNG**(`rng.ts` 的 `makeRng`/`shuffle`),`RngState = { seed, cursor }`。**core 內絕不可用 `Math.random()`**——否則破壞決定性,鬼影/PvP 重算會對不上。亂數消費順序固定。 +- `GameState`(見 `types.ts`)是純可序列化資料。`Action`:`PLAY_CARD` / `END_TURN` / `PICK_REWARD` / `CHOOSE_CARDS`。`BattlePhase`:`PLAYER_TURN` / `PENDING_CHOICE`(互動選牌暫停態)/ `REWARD_SELECT` / `GAME_OVER` / `VICTORY`。 +- 檔案分工:`engine.ts`(流程/回合結算/獎勵/關卡推進)、`player.ts`(出牌 PlayCardLogic、回合結算、互動選牌)、`effects.ts`(EffectOp 指令集解譯)、`opponent.ts`(怪物 + 鬼影 GhostOpponent)、`deck.ts`(抽牌/洗牌)、`pileView.ts`(三堆檢視)、`pvp*.ts`(PvP 結算/抽牌/數值)、`progress.ts`(升級鏈)。 +- **卡牌是純資料**:每張卡 = `onPlay[]` + `onCombo[]`(外加 `onDraw`/`onChosen`/`playableIf` 等互動鉤子),由有限的 `EffectOp` 指令集表達(`ADD_ATK` / `SET_FLAG` / `IF` / `BRANCH_NEXT_TAG` …)。`ValueExpr` 可寫動態值(`Combo*2`、`floor(effMaxHp*3/10)`…)。新增行為儘量組合既有 op,必要時才擴 op。 +- **卡表單一事實來源 = `src/data/cards.ts`**(型別化 TS)。`data/cards.json` 是**衍生物**,由 `npm run gen:cards` 產生,勿手改。 + +### 兩段式效果(整個遊戲最關鍵、最易出錯的機制) + +每張卡有兩段效果,觸發時機不同: +- **即時效果 `onPlay`**:打出當下立刻結算(每次成功出牌都跑)。 +- **連擊效果 `onCombo`**:屬於「**上一張卡**」,要等下一張**成功接上**才結算——即**延遲一張**。連擊中斷或回合結束 → 最後一張的 `onCombo` **不結算**。 + +實作上由 `pendingComboCardId` 記住上一張待結算的卡。改動出牌/連擊邏輯時,務必先讀 `guide/01-game-design-spec.md §3-§4` 與對應 golden 測試(`test/golden.test.ts` 的 G1/G2)。 + +### 職業(`classType`) + +- `WARRIOR`(0-40 號卡,對應 `web/public/resources/cards/.png`):硬幣啟動連擊、依標籤(A 攻 / B 守 / Any / None)串連、每 5 連抽 1。 +- `BARBARIAN`(100-191 號卡,白底文字卡無圖):**無 DEF、無硬幣/連擊/標籤閘門、手牌恆滿**;核心是「每出 1 張先 `n+1` 再扣 `n` 點 HP」的自傷曲線,加上臨時血量上限(`tempMaxHp`)、token 衍生卡、真實傷害、跨戰計數、互動選牌、條件變形鏈、特殊勝利(蓄力 ×15)、復活等機制。設計見 `guide/13-barbarian-design.md`。 +- 各職業**卡池完全獨立、不可混用**。 + +### server(`packages/server/`)— 鬼影 REST + PvP + +- 入口 `index.ts` → `server.ts` 的 `buildServer()`(Fastify)。監聽 `PORT ?? 3001`。 +- 鬼影 REST:`POST /api/ghosts`(破關上傳,含 per-IP 速率限制 + 形狀驗證 + 可選重播驗證)、`GET /api/ghosts/random`(第 12 關抽鬼影,無存檔回 204)。 +- **PvP 走 `/ws/pvp` WebSocket,server 為唯一權威**:四相狀態機 `PLAN → LOCK → RESOLVE → ADVANCE`(同時暗回合,消先手優勢),協調層在 `pvpHub.ts`(房間/配對/draft/rematch)與 `pvpMatch.ts`,**解算仍呼叫 core 的 `pvpResolve`**。**seed 絕不下發 client**(會洩漏牌序/擲骰)。 +- 鬼影儲存(`repository.ts`):預設 `/tmp/ghosts.json`(短暫,重啟清空);設了 `UPSTASH_REDIS_REST_URL` + `_TOKEN` 則改用 Upstash Redis 永久保存。 +- 部署時設 `WEB_ROOT` → 同進程用 `@fastify/static` 服務前端靜態檔(單容器、同源免 CORS)。 + +### web(`packages/web/`)— React + Vite + +- `App.tsx` 是單檔狀態機(`start` / `select` / `map` / `playing` / `pvp` 畫面),**直接在 client 跑 battle-core**(單機/鬼影本機即時跑,體驗流暢);PvP 則透過 `pvpClient.ts` 連 WebSocket,由 server 權威解算。 +- battle-core 以**原始碼**形式被 import(workspace),Vite 直接吃 TS。dev proxy 把 `/api`、`/ws` 導到 `:3001`。 +- **三堆檢視(deck/discard/burn)只能給合併計數、絕不洩漏順序**(順序=預告下一張抽牌)。PvP 尤其:永不把有序 deck 或 seed 給 client。用 `pileView()`。 + +## 開發鐵則(最容易踩雷之處) + +- **改了 core 沒效果?** web/server 在 dev 下吃原始碼,但 build/部署吃 `dist`——改完 core 要 `npm run build -w @wcg/battle-core`(CI 與 Docker 都先 build battle-core)。 +- **改卡牌?** 只改 `src/data/cards.ts`,然後 `npm run gen:cards` 重產 `data/cards.json`,並視語意變更在 `src/version.ts` bump `RULE_VERSION`(鬼影/PvP 存檔靠它與 `CARDS_HASH` 判斷是否降級不校驗)。 +- **出牌順序**:永遠「先把牌移出手牌,再結算效果」。 +- **測試釘的是「應然」(規格),不是「現況」**:規格與原版行為衝突時,以 `guide/` 的修訂為準(例:重擊強制結束改採 §4.6、鬼影 DEF 不外推)。新增卡/規則要同步補 golden 測試與 `guide/02`、`guide/08`、`guide/09`。 +- **`maxLevel` 是除錯旋鈕**(`createGame` 選項,預設 11):除錯可設小(如 3)秒到最後一關驗證破關/結算/鬼影串接,**正式版務必維持 11,勿把除錯值帶上線**。所有「最後一關」判斷讀 `state.maxLevel`,不寫死數字。 + +## 部署 + +單容器(`Dockerfile`,HuggingFace Spaces Docker SDK):build 三套件 → `node packages/server/dist/index.js` 監聽 `7860`,同進程服務前端 + `/api` + `/ws`。細節與環境變數見 `DEPLOY.md`。本機驗證 production 行為: + +```bash +npm run build -w @wcg/battle-core && npm run build -w @wcg/web && npm run build -w @wcg/server +WEB_ROOT="$PWD/packages/web/dist" PORT=7860 node packages/server/dist/index.js +``` diff --git a/guide/01-game-design-spec.md b/guide/01-game-design-spec.md index 871a12a2ea26f0ec226fd673ecd295c4d3f97924..fc5829533f5ad71ece98f7a97d2188371a04ef36 100644 --- a/guide/01-game-design-spec.md +++ b/guide/01-game-design-spec.md @@ -194,12 +194,16 @@ | 情況 | 攻擊 | 防禦 | |---|---|---| | `n ≤ k`(紀錄內) | `atk[n]` | `def[n]` | -| `n > k`(紀錄用完) | `平均atk + n` | `平均def + n` | +| `n > k`(紀錄用完) | `平均atk + n` | `平均def`(**固定,不加 n**) | | 完全沒有任何存檔 | 退化成預設怪物 | 同左 | - 「平均」是**固定值**:永遠用存檔那 `k` 筆算出來,不隨外推變動。 - 鬼影血量 = 存檔那位玩家的 maxHP。 -- 設計目的:紀錄用完後越打越痛,逼戰鬥盡快結束,避免無限拖。 +- 設計目的:紀錄用完後**攻擊**越打越痛,逼戰鬥盡快結束,避免無限拖。 +- ⚠ **防禦不外推(2026 修正)**:原版/舊 spec 對 DEF 也用 `平均def + n`,但這會讓鬼影防禦每回合 +1 直到 + 超過玩家攻擊力 → 變成「永遠打不死」的無敵怪,且出現紀錄裡從未有過的合成防禦值(玩家會看到「顯然 + 不可能是過 11 關的人打出來的數值」)。逼速戰的壓力交給 ATK 即可,故 DEF 外推固定在 `平均def`, + 確保鬼影永遠可被擊殺。(實作:`opponent.ts` `ghostTurnValues`。) - 詳細範例見原版 [`../Lengend-of-Strategy-Card-Game-/PLAN.md`](../Lengend-of-Strategy-Card-Game-/PLAN.md) 第三節。 --- diff --git a/guide/04-data-schemas-and-api.md b/guide/04-data-schemas-and-api.md index 0811797a99b65787fc762212b90385129f5180ad..923f5c70bdfcbce7c09209a20c7fafab3eac4c8c 100644 --- a/guide/04-data-schemas-and-api.md +++ b/guide/04-data-schemas-and-api.md @@ -161,9 +161,13 @@ interface GhostRecord { **鬼影出招計算**(GhostOpponent;`k = turns.length`,平均為固定值): - 第 n 回合(n 從 1): - `n <= k` → `atk = turns[n-1].atk`,`def = turns[n-1].def` - - `n > k` → `atk = avgAtk + n`,`def = avgDef + n`(avg 用 k 筆固定算出) + - `n > k` → `atk = avgAtk + n`,`def = avgDef`(**DEF 固定,不加 n**;avg 用 k 筆固定算出) - 沒有任何鬼影 → 用預設怪物。 +> ⚠ DEF 外推固定在 `avgDef`(2026 修正):若比照 ATK 用 `avgDef + n`,鬼影防禦會無限上升 → +> 超過玩家攻擊力後變「永遠打不死」的無敵怪,且是紀錄裡從未出現過的合成數值。逼速戰交給 ATK, +> DEF 不外推,確保鬼影恆可被擊殺。詳見 `01` §9 與 `opponent.ts` `ghostTurnValues`。 + --- ## 5. API(模式 A,REST,極簡) diff --git a/guide/13-barbarian-design.md b/guide/13-barbarian-design.md index 6b9392438fa4319d4ba190a8b0e426ba10fe769d..4168dab7eaaa1080e97db32f131701ff82152c1b 100644 --- a/guide/13-barbarian-design.md +++ b/guide/13-barbarian-design.md @@ -1,7 +1,7 @@ # 野蠻人實作藍圖(Barbarian Implementation Blueprint) ## ★ 已拍板決策(2026-06-21,覆寫下方建議) -1. **專注 token**:`isToken + exhaust`(使用後進消耗堆)。**抽到即自動釋放**(on-draw 觸發,**不計入出牌數 n、不扣血**),效果=**臨時血量上限 +1**(依機制2 同時回 1 HP)。→ 需在 `drawCards` 加 on-draw hook(轉世之門/萬象寂滅同此管道)。 +1. **專注 token**:`isToken + exhaust`(使用後進消耗堆)。**抽到即自動釋放**(on-draw 觸發,**不計入出牌數 n、不扣血**),效果=**臨時血量上限 +2**(依機制2 同時回 2 HP)。→ 需在 `drawCards` 加 on-draw hook(轉世之門/萬象寂滅同此管道)。 2. **野蠻人出牌限制**:**全部取消**——無起手硬幣、無連擊、無 A/B 標籤鎖。手牌恆滿、隨意出牌,唯一代價是 n 扣血。 3. **傷害模型**:多數「造成 X 傷害」**併入回合總攻擊**(`ADD_ATK`,過 DEF/倍率一次結算);僅真實傷害/抽到即傷用即時管道。多段攻擊折算成總和。 4. **變數 n 扣血**:**野蠻人沒有 DEF**(不吃 DEF 機制、受傷不減免);每成功出 1 張先 +1 再**直接扣 n 點 HP**;「因出牌失去的血」只計 n 自傷。回合/戰鬥結束 n 歸 0。 diff --git a/guide/barbarian-original-spec.md b/guide/barbarian-original-spec.md new file mode 100644 index 0000000000000000000000000000000000000000..660e6f404de42c54ec1ebf1927d6cae298143df4 --- /dev/null +++ b/guide/barbarian-original-spec.md @@ -0,0 +1,162 @@ +新職業:野蠻人特性如下 +單人初始血量:130 +pvp初始血量:260 + +機制說明: +1.手牌永遠保持上限(打出牌後會自動抽牌) +2.有「臨時血量上限機制」,增加臨時血量上限時同時回復等量hp(相當於 餘裕 的運作模式) +3.單人模式的臨時血量上限會在戰鬥勝利後消失,其中20%會轉為永久的血量上限 +4.具有塞入Token卡的機制:Token卡中「專注」跟「蓄力」跟「轉世之門」會在每場戰鬥結束時消失(不論其在抽牌棄牌或消耗牌堆中都消失) +5.有變數n存放當回合所打牌數,每打一張牌+1,並扣除玩家n點hp,回合結束及戰鬥結束時歸零。 +6.衍生卡不會是玩家可選擇的卡(不在卡池中),只有在滿足特定條件後才會出現。 + +卡牌製作說明: +由於製作卡片耗費時間長。此角色卡片先以web裡面的public中的barbarian裡的CardBack為主,將每張卡都以此基底表示。希望可以寫個程式讓它在抽取及獲取及使用卡片時,能將其對應的文字敘述放到底下卡片填字的方格中,其中「傷害:」後面的數值請填到CardBack的圓形中央格子當中。而效果說明則填到底下方格中。希望透過卡牌本身固定位置以及放大後固定的位置來讓此卡的文字說明能在正確的位置上。讓玩家雖然沒有看到卡圖,仍可以透過相關文字來使用卡片。 + +以下是卡牌稀有度及相關效果文字敘述描述: + +普通: + + +​凝神|傷害:4|效果:將 1 張「專注」洗入棄牌堆。若本回合出牌計數 (n) 大於等於 3,額外再洗入 1 張。 + +​戰術重整|傷害:0|效果:臨時血量上限 +2,並將 1 張「專注」洗入棄牌堆。 + +​雜念捨棄|傷害:2|效果:選擇並棄掉 1 張手牌,將 2 張「專注」洗入棄牌堆。 + +​厚皮打擊|傷害:5|效果:將 1 張「專注」洗入棄牌堆。 + +​尋思|傷害:0|效果:自身受到 3 點傷害,將 3 張「專注」洗入棄牌堆。 + +重擊|傷害:7|效果:無。 + + 雙持狂斬|傷害:3*2|效果:無。 + + 嗜血|傷害:6|效果:回復 6 點 HP。 + + 魯莽衝撞|傷害:12|效果:自身受到 3 點額外傷害。 + + 狂怒|傷害:15|效果:只有在當前 HP 低於 總數(含臨時上限)30% 時才能打出。 + + 打擊|傷害:?|效果:傷害等於「你本回合因出牌失去的總血量」。 + + 咆哮|傷害:0|效果:本回合下一張攻擊卡的傷害翻倍。 + + 肌肉膨脹|傷害:3|效果:臨時血量上限 +3。 + + 突破極限|傷害:0|效果:臨時血量上限 +10,但自身受到 5 點傷害。 + + 沸騰之血|傷害:0|效果:造成等同於「目前總血量上限5%」的傷害。 + + 強運一擊‖傷害:0‖效果:從棄牌堆中隨機抽取一張牌,若其為「專注」,重複施放此卡效果(抽到不是專注為止) + + 腎上腺素|傷害:0|效果:出牌計數 (n) 重置為 1,但臨時血量上限 -5。 + + 借力打力|傷害:?|效果:造成等同於「出牌計數 x 2」的傷害。 + + 以痛換力|傷害:0|效果:將出牌計數 (n) 直接提升至 5,臨時血量上限 +10。 + + 盲目亂揮|傷害:6|效果:隨機棄掉 1 張手牌。 + + 無腦傾瀉|傷害:0|效果:棄掉所有手牌(換 5 張全新的牌),自身受到 3 點傷害。 + +重整|傷害:0|效果:選擇並棄掉 1 張手牌,臨時血量上限 +1。 + + 血腥狂歡|傷害:0|效果:打出此卡後,到本回合結束前每棄掉 1 張手牌,回復 2 點 HP。 + + +蠻性試煉‖傷害:0‖效果:獲取這張卡時開始計入因自身被動所受到的傷害。若總數>100,打出這張卡時將它轉成「成神試煉」。(計數不隨戰鬥結束而重置) + +衍生卡:成神試煉(焚燒)‖傷害:8‖效果:打出後當洗牌時「神性」+1。(神性不會隨結束戰鬥而重置)「神性」到20時,此卡變為「致命一擊」。 + +衍生卡:致命一擊(焚燒)‖傷害 10‖效果:打出後將15張「蓄力」洗入棄牌堆。 + +衍生卡:蓄力(焚燒)‖傷害:3‖效果:若打出15張蓄力,獲得特殊勝利。 + +史詩: + +​ +​死境反擊|傷害:?|效果:造成等同於「你已損失的生命值 x 0.6」的傷害。 + +​血祭巨刃|傷害:15|效果:若當前血量低於 40%,此卡傷害翻倍。 + +​狂人亂舞|傷害:5|效果:隨機對敵人造成傷害 4 次。你每失去 20 點生命值,額外多砍一次。 + +​飲血巨斧|傷害:12|效果:回復等同於「此卡造成傷害 50%」的生命值。 + +​痛苦共鳴|傷害:0|效果:本回合你每次因出牌扣血時,敵人受到等量的真實傷害。 +​ +​泰坦之血|傷害:0|效果:臨時血量上限+20。 + +​血肉燃燒|傷害:0|效果:失去所有「臨時血量上限」,每失去 1 點對敵人造成 2 點傷害。 + +​巨神咆哮|傷害:10|效果:你的當前「最大生命值(含臨時上限)」每有 50 點,額外造成 5 點傷害。 + +​沸騰轉換|傷害:0|效果:將當前出牌計數 (n) 的數值乘上 3,轉化為臨時血量上限。 + + +無畏的莽撞衝鋒‖傷害:5‖效果:此卡攻擊次數等同本局(會因戰鬥結束重置)打出的次數。 + +​生命汲取|傷害:8|效果:將此卡造成的傷害 100% 轉化為臨時血量上限。 +​ +​痛覺逆轉|傷害:0|效果:將目前的出牌計數 (n) 轉化為生命回復(回復 n ) + +​血氣連爆|傷害:10|效果:目前的出牌計數 (n) 每有 3點,這張牌就自動額外打出 1 次。 + +​死神擦肩|傷害:0|效果:將出牌計數 (n) 強制鎖定在 1,持續接下來的 3 次出牌。 + +​千刀萬剮|傷害:?|效果:傷害等於 n x 3。打出後出牌計數 n 額外 +2。 + +​血腥連結|傷害:0|效果:本回合接下來你每次因出牌扣血時,敵人將受到等量的真實傷害,但你依然會受到原本的扣血效果。 +​ +​狂風掃落葉|傷害:0|效果:選擇並棄掉 3 張手牌,每棄一張對敵人造成 8 點傷害。 + +​戰術捨棄|傷害:0|效果:選擇並棄掉 1 張手牌,本回合出牌計數 (n) 減少 2(最低為 1)。 + +​血腥收割|傷害:10|效果:若這是本回合因「棄牌補滿」機制而抽上來的第一張牌,傷害 +15。 + +​無盡怒火|傷害:0|效果:棄掉所有手牌(立刻換 5 張新牌),本回合下一張攻擊牌將會被打出兩次。 + +​本能閃避|傷害:0|效果:隨機棄掉 2 張手牌,回復 15 點生命值。 + +​野蠻直覺|傷害:0|效果:檢視牌堆頂的 5 張牌,將其中 1 張加入手牌(並棄掉原本一張),其餘燒毀。 + +​血誓契約|傷害:0|效果:選擇手牌中的一張牌,使其本場戰鬥傷害永久 +8,但你立刻失去 8 點血。 + +​野性先手|傷害:12|效果:若此卡是本回合打出的第一張牌(即 n=1 時),將 n 變為 -2(n 為負數時視為回血)。否則 n 額外 +1。 + +​蠻荒震擊|傷害:18|效果:有 50% 機率讓敵人下回合造成的傷害直接減半。 + + +​專注湧現|傷害:0|效果:將 4 張「專注」直接洗入抽牌堆(而非棄牌堆)。本回合下一張打出的攻擊卡傷害 +4。 + +​冥想重擊|傷害:0|效果:此卡造成的傷害,等同「本局戰鬥中已被消耗(進入消耗牌堆)的『專注』總張數 x 2」。 +​ +​心流狂暴|傷害:0|效果:打出此卡後,本回合每當你抽到並釋放「專注」時,除了原本的加血上限效果,額外對敵人造成 3 點真實傷害。 + +​殘響喚醒|傷害:0|效果:從消耗牌堆(Burn Pile)中,將最多 3 張「專注」洗入棄牌堆。臨時血量上限 + 5。 + +​雜念絕殺|傷害:0|效果:打出此卡後,強制棄掉你手牌中的其他所有卡牌。將 5張「專注」放入棄牌堆。 + +傳說: + +地獄之門的殘響(焚燒)‖傷害:0‖效果:打出後本場戰鬥的專注將不再消耗。但每張專注會扣除自己1點生命值。 + +輪迴轉世(焚燒)‖傷害:0‖效果:將一張「轉世之門」放入棄牌堆中,此牌在洗入抽牌堆時固定於牌堆底部出現。 + +衍生:「轉世之門」‖傷害:0‖效果:抽到時自動施放,對敵人造成n點傷害,將n歸0。 + +放手一搏(焚燒)‖傷害:0‖效果:本回合n的計算由增加改為減少。當n小於或等於0時,結束這回合。 + +Inverse(焚燒)‖傷害:0‖效果:血量和已損血量交換。 + +專注斬擊‖傷害:5‖效果:將消耗牌堆中的所有「專注」全部移除。每移除一張,此卡額外攻擊一次。 + +死亡前的凝視(焚燒)‖傷害:0‖效果:若在本回合死亡。則將臨時生命以1:1全數轉為玩家永久生命,並以100%總生命值復活。若觸發成功,則此卡永久移除(也不進消耗牌堆) + +反刃血鎧|傷害:0|效果:本回合中,每當你的「臨時血量上限」替你抵擋了出牌扣血 (n) 時,將該次扣血量的 2 倍轉化為對敵人的傷害。 + + +狂神開眼(焚燒)|傷害:0|效果:本局戰鬥剩餘時間內,每當你釋放「專注」時,除原本的加血效果外,使你本回合的出牌計數 (n) 減少 1(最低為 1,一回合最多觸發5次)。 + +萬象寂滅(焚燒)|傷害:0|效果:將你棄牌堆中的隨機 5 張卡牌直接移入「消耗牌堆」。將 10 張「專注」洗入棄牌堆。 \ No newline at end of file diff --git a/packages/battle-core/data/cards.json b/packages/battle-core/data/cards.json index 031c53aaab7396322c0b1f0cc6d6af5b10d35a92..ea1f73cc6c019d461a8e841b4da83d34d1f507a1 100644 --- a/packages/battle-core/data/cards.json +++ b/packages/battle-core/data/cards.json @@ -7,6 +7,7 @@ "atk": 0, "def": 2, "rarity": "normal", + "desc": "連擊:抽 1 張,然後結束本次連擊。", "onCombo": [ { "op": "DRAW", @@ -25,6 +26,7 @@ "atk": 0, "def": 0, "rarity": "normal", + "desc": "連擊:ATK += 連擊數,然後結束本次連擊。", "onCombo": [ { "op": "ADD_ATK", @@ -45,6 +47,7 @@ "atk": 0, "def": 4, "rarity": "normal", + "desc": "連擊:基礎 DEF +1(本場戰鬥持續,過關重置)。", "onCombo": [ { "op": "ADD_BASE_DEF", @@ -60,6 +63,7 @@ "atk": 2, "def": 0, "rarity": "normal", + "desc": "即時:若為起手(出牌前連擊數為 0)→ 抽 1 張。", "onPlay": [ { "op": "IF", @@ -83,6 +87,7 @@ "atk": 6, "def": 0, "rarity": "normal", + "desc": "即時:設下強制結束旗標(再打一張接不上即強制結束回合)。", "onPlay": [ { "op": "SET_FLAG", @@ -98,6 +103,7 @@ "atk": 0, "def": 8, "rarity": "normal", + "desc": "即時:鎖 A,本回合無法再打出 A 標籤的牌。", "onPlay": [ { "op": "LOCK_TAG", @@ -113,6 +119,7 @@ "atk": 7, "def": 0, "rarity": "normal", + "desc": "即時:HP -2,並鎖 B,本回合無法再打出 B 標籤的牌。連擊:ATK +3。", "onPlay": [ { "op": "ADD_HP", @@ -138,6 +145,7 @@ "atk": 0, "def": 0, "rarity": "normal", + "desc": "即時:DEF += 隨機 0~8(每次不同,可能毫無作用)。連擊:DEF -3。", "onPlay": [ { "op": "RANDOM_DEF_0_8" @@ -158,6 +166,7 @@ "atk": 0, "def": 2, "rarity": "normal", + "desc": "連擊:若手牌中已無任何 A 標籤卡 → 抽 1。", "onCombo": [ { "op": "IF", @@ -182,6 +191,7 @@ "atk": 3, "def": 0, "rarity": "normal", + "desc": "即時:抽 1,並讓本回合怪物反擊 ATK +1。連擊:再抽 1。", "onPlay": [ { "op": "SET_FLAG", @@ -207,6 +217,7 @@ "atk": 1, "def": 0, "rarity": "normal", + "desc": "即時:若連擊數為偶數 → DEF +3,否則 ATK +3。", "onPlay": [ { "op": "IF", @@ -236,6 +247,7 @@ "atk": 0, "def": 5, "rarity": "normal", + "desc": "即時:回合末若硬幣 >0 → HP +5、maxHP +5。", "onPlay": [ { "op": "SET_FLAG", @@ -251,6 +263,7 @@ "atk": 0, "def": 4, "rarity": "normal", + "desc": "即時:若連擊數恰為 1(起手首張)→ 硬幣 +1。", "onPlay": [ { "op": "IF", @@ -275,6 +288,7 @@ "atk": 5, "def": 0, "rarity": "normal", + "desc": "即時:若硬幣為 0 且手牌已空 → ATK +15 並結束連擊。", "onPlay": [ { "op": "IF", @@ -310,6 +324,7 @@ "atk": 11, "def": 0, "rarity": "normal", + "desc": "即時:ATK -= 當前手牌張數。連擊(依下一張 tag):A→ATK -2;B→DEF -4;Any→ATK -2 且 DEF -3。", "onPlay": [ { "op": "ADD_ATK", @@ -359,6 +374,7 @@ "atk": 1, "def": 0, "rarity": "normal", + "desc": "即時:ATK += 新月計數 × 2。連擊:新月計數 +1(本場累積)。", "onPlay": [ { "op": "ADD_ATK", @@ -388,6 +404,7 @@ "atk": 0, "def": 0, "rarity": "normal", + "desc": "連擊:斷劍計數 +(當前硬幣 + 1)(累積達 20 升級為血劍)。", "onCombo": [ { "op": "ADD_COUNTER", @@ -411,6 +428,7 @@ "atk": 1, "def": 0, "rarity": "normal", + "desc": "即時:手牌上限 -1、抽 2 張。連擊:DEF +2。", "onPlay": [ { "op": "ADD_MAX_HAND", @@ -436,6 +454,7 @@ "atk": 7, "def": 0, "rarity": "epic", + "desc": "連擊:ATK +5。", "onCombo": [ { "op": "ADD_ATK", @@ -451,6 +470,7 @@ "atk": 5, "def": 0, "rarity": "epic", + "desc": "即時:若打出當下連擊數 ≥ 6 → 下回合硬幣回滿時額外 +1。", "onPlay": [ { "op": "IF", @@ -475,6 +495,7 @@ "atk": 4, "def": 0, "rarity": "epic", + "desc": "即時:本次出傷時回血 min(本波傷害÷2, 10)(夾當前生命上限)。", "onPlay": [ { "op": "SET_FLAG", @@ -490,6 +511,7 @@ "atk": 1, "def": 0, "rarity": "epic", + "desc": "連擊:抽 5 張。", "onCombo": [ { "op": "DRAW", @@ -505,6 +527,7 @@ "atk": 6, "def": 0, "rarity": "epic", + "desc": "即時:本次出傷額外 + 怪物當前 HP 的 30%(向下取整)。", "onPlay": [ { "op": "SET_FLAG", @@ -525,6 +548,7 @@ "atk": 0, "def": 3, "rarity": "epic", + "desc": "連擊:當前 DEF 翻倍(DEF += 當前 DEF)。", "onCombo": [ { "op": "ADD_DEF", @@ -542,6 +566,7 @@ "atk": 1, "def": 0, "rarity": "epic", + "desc": "即時:ATK += 連擊數 × 2。", "onPlay": [ { "op": "ADD_ATK", @@ -564,6 +589,7 @@ "atk": 0, "def": 0, "rarity": "epic", + "desc": "即時:ATK += 當前 DEF。連擊:ATK +1。", "onPlay": [ { "op": "ADD_ATK", @@ -587,6 +613,7 @@ "atk": 5, "def": 0, "rarity": "epic", + "desc": "連擊:基礎 ATK 永久 +1(整場累積、過關也不重置)。", "onCombo": [ { "op": "ADD_BASE_ATK", @@ -602,6 +629,7 @@ "atk": 4, "def": 4, "rarity": "epic", + "desc": "連擊:DEF +4、ATK +4。", "onCombo": [ { "op": "ADD_DEF", @@ -621,6 +649,7 @@ "atk": 2, "def": 0, "rarity": "epic", + "desc": "連擊:下一次出傷 +25%(無條件捨去)後消耗。", "onCombo": [ { "op": "SET_FLAG", @@ -636,6 +665,7 @@ "atk": 3, "def": 0, "rarity": "epic", + "desc": "連擊:ATK += 硬幣 × 硬幣 × 3,接著硬幣歸 0 並結束連擊。", "onCombo": [ { "op": "ADD_ATK", @@ -668,6 +698,7 @@ "atk": 0, "def": 1, "rarity": "epic", + "desc": "即時:DEF += 2 × 訓練計數(本場累積)。連擊:訓練計數 +1。", "onPlay": [ { "op": "ADD_DEF", @@ -697,6 +728,7 @@ "atk": 0, "def": 0, "rarity": "normal", + "desc": "即時:擲幸運硬幣(0/1)——0 則硬幣 +3,否則 DEF += 3 × 當前硬幣。連擊:結算相反那半,結束後幸運值歸 0。", "onPlay": [ { "op": "RANDOM_SET", @@ -773,6 +805,7 @@ "atk": 0, "def": 1, "rarity": "epic", + "desc": "即時:硬幣 -1、抽 1 張。連擊:抽 2 張。", "onPlay": [ { "op": "ADD_COIN", @@ -798,6 +831,7 @@ "atk": 0, "def": 15, "rarity": "legend", + "desc": "即時:本回合 DEF 延後一回合才重置(多撐一回合)。連擊:ATK +1。(焚燒:用完進消耗堆)", "onPlay": [ { "op": "SET_FLAG", @@ -820,7 +854,7 @@ "atk": 5, "def": 0, "rarity": "legend", - "exhaust": true, + "desc": "連擊(依下一張 tag):A→本回合 ATK 半數保留到下回合(連擊中斷也保留);B→抽 2;Any→抽 1 並 ATK +5。", "onCombo": [ { "op": "BRANCH_NEXT_TAG", @@ -857,6 +891,7 @@ "atk": 3, "def": 0, "rarity": "legend", + "desc": "即時:清空當前 DEF 並本場鎖 DEF=0;之後加 DEF 改以一半(四捨五入)轉 ATK,連擊改每 2 連抽 1。本場持續、下一關重置。(焚燒:用完進消耗堆)", "onPlay": [ { "op": "SET_FLAG", @@ -877,6 +912,7 @@ "atk": 5, "def": 5, "rarity": "legend", + "desc": "即時:互換當前 ATK 與 HP 數值,並結束連擊。", "onPlay": [ { "op": "SWAP_ATK_HP" @@ -899,6 +935,7 @@ "atk": 5, "def": 5, "rarity": "legend", + "desc": "即時:本場任何卡都能接續連擊(無視標籤閘門),硬幣上限設為 1。(焚燒:用完進消耗堆)", "onPlay": [ { "op": "SET_FLAG", @@ -919,6 +956,7 @@ "atk": 0, "def": 0, "rarity": "legend", + "desc": "即時:ATK += 本場此卡前已出牌數 × 3。", "onPlay": [ { "op": "ADD_ATK", @@ -941,6 +979,7 @@ "atk": 8, "def": 0, "rarity": "upgrade", + "desc": "連擊:血劍計數 +1(本場累積,達 8 升級為終極一擊)。", "onCombo": [ { "op": "ADD_COUNTER", @@ -957,6 +996,7 @@ "atk": 20, "def": 0, "rarity": "upgrade", + "desc": "即時:依連擊數推進處決——連擊 1 時 winValue÷2、2÷3、3÷5、4÷7(由 210 起);整除到 1 時本回合出傷額外 +怪物當前 HP(斬殺)。連擊:硬幣 +1。", "onPlay": [ { "op": "ULT_WIN_CHECK" @@ -2015,11 +2055,11 @@ "name": "野性先手", "tag": "None", "nextReq": "None", - "atk": 15, + "atk": 12, "def": 0, "rarity": "epic", - "dmgText": "15", - "desc": "造成 15 點傷害;若為本回合第一張牌,本次不扣血,否則出牌計數 n 額外 +1。", + "dmgText": "12", + "desc": "造成 12 點傷害;若為本回合第一張牌(n=1),出牌計數 n 變為 -2(n 為負時視為回血),否則 n 額外 +1。", "onPlay": [ { "op": "IF", @@ -2029,7 +2069,8 @@ }, "then": [ { - "op": "SUPPRESS_SELFDMG" + "op": "SET_N", + "value": -2 } ], "else": [ @@ -2239,11 +2280,11 @@ "def": 0, "rarity": "legend", "exhaust": true, - "desc": "本回合若你將死亡,改為復活並回復至總生命上限的 50%。若觸發,本卡將被永久移除(連消耗堆都不留)。", + "desc": "本回合若你將死亡,改為:臨時生命上限 1:1 全數轉為永久生命,並以 100% 總生命復活。若觸發,本卡將被永久移除(連消耗堆都不留)。", "onPlay": [ { "op": "ARM_REVIVE", - "fraction": 0.5 + "fraction": 1 } ] }, @@ -2309,14 +2350,17 @@ "def": 0, "rarity": "legend", "exhaust": true, - "desc": "將棄牌堆中隨機 5 張卡牌直接移入消耗堆;將 10 張「專注」放在抽牌堆頂部。", + "desc": "將棄牌堆中隨機 5 張卡牌直接移入消耗堆;將 10 張「專注」洗入棄牌堆。", "onPlay": [ { "op": "ANNIHILATE", + "moveCount": 5 + }, + { + "op": "SHUFFLE_TOKEN", "token": 110, - "moveCount": 5, - "tokenCount": 10, - "position": "top" + "pile": "discard", + "count": 10 } ] }, @@ -2367,11 +2411,11 @@ "isToken": true, "derived": true, "exhaust": true, - "desc": "(Token)抽到即釋放:臨時血量上限 +1(並回 1 HP,不計入出牌數)。用完進消耗堆。", + "desc": "(Token)抽到即釋放:臨時血量上限 +2(並回 2 HP,不計入出牌數)。用完進消耗堆。", "onDraw": [ { "op": "ADD_TEMP_MAXHP", - "value": 1 + "value": 2 } ] }, diff --git a/packages/battle-core/package.json b/packages/battle-core/package.json index 2b9b6d82a1ee44a45a57e79d86671f74330c38dc..fcd828d0ae1805c37393706baf91085fba3e203d 100644 --- a/packages/battle-core/package.json +++ b/packages/battle-core/package.json @@ -20,6 +20,7 @@ "build": "tsc -p tsconfig.json", "typecheck": "tsc -p tsconfig.json --noEmit", "gen:cards": "tsx scripts/gen-cards-json.ts", + "gen:ghost": "tsx scripts/gen-seed-ghost.ts", "test": "vitest run", "test:watch": "vitest" }, diff --git a/packages/battle-core/scripts/class-output-sim.ts b/packages/battle-core/scripts/class-output-sim.ts new file mode 100644 index 0000000000000000000000000000000000000000..ad6d76752f344eab5341a68fbc25acda4af950a9 --- /dev/null +++ b/packages/battle-core/scripts/class-output-sim.ts @@ -0,0 +1,175 @@ +/** + * 單人「每回合輸出」平衡量測(決定性):跑大量單人對局,統計每職業每回合的 ATK / DEF 平均。 + * 用來替 Sanctus 的 HP / DEF / 護盾 / 審判線 定數值。非玩法 AI,只為平衡訊號。 + * + * 策略: + * - 戰士:會「串連擊」的貪婪——combo 中優先打能接上 nextReq 的牌、否則才開新連擊;沒硬幣就收手。 + * (單純「打最高 ATK」不串連擊會嚴重低估戰士,故特別處理。) + * - 野蠻人:打最高 ATK,但守安全線(再出一張的自傷會使 HP < effMax×15% 就收手)。 + * - 互動選牌:scry 留最高 atk;keep 強化最高;棄牌棄最低。獎勵三選一挑最高 atk(進攻取向)。 + * + * 量測來源:GameState.turnLog(引擎權威的每回合 {atk, def}),逐回合標記當時關卡。 + * 執行:npx tsx scripts/class-output-sim.ts [gamesPerClass] + */ +import { createGame, step } from "../src/engine.js"; +import { getCard } from "../src/cards.js"; +import type { Action, ClassType, GameState, PlayerState, Tag } from "../src/types.js"; + +const cardAtk = (p: PlayerState, id: number): number => getCard(id).atk + (p.cardBuffs?.[id] ?? 0); +const tagLocked = (p: PlayerState, tag: Tag): boolean => (tag === "A" && !p.useA) || (tag === "B" && !p.useB); + +/** 戰士:會串連擊的貪婪。回傳要出的手牌 index,或 null = 收手(結束回合)。 */ +function warriorPick(p: PlayerState): number | null { + const hand = p.hand.map((id, i) => ({ i, id, card: getCard(id) })).filter((c) => !tagLocked(p, c.card.tag)); + if (hand.length === 0) return null; + if (p.combo === 0) { + if (p.coin <= 0) return null; // 無硬幣無法起手 + hand.sort((a, b) => b.card.atk - a.card.atk); + return hand[0]!.i; // 起手挑最高 atk + } + // combo > 0:優先能接上的牌(tag==nextReq / nextReq==Any / tag==Any) + const chains = hand.filter((c) => c.card.tag === p.nextReq || p.nextReq === "Any" || c.card.tag === "Any"); + if (chains.length > 0) { + chains.sort((a, b) => b.card.atk - a.card.atk); + return chains[0]!.i; + } + // 接不上:有硬幣就打最高(中斷後可再開新連擊),沒硬幣就收手 + if (p.coin <= 0) return null; + hand.sort((a, b) => b.card.atk - a.card.atk); + return hand[0]!.i; +} + +/** 野蠻人:打最高 atk,守 15% 安全線。 */ +function barbarianPick(p: PlayerState): number | null { + if (p.hand.length === 0) return null; + const nextN = p.nMode === "dec" ? Math.max(0, p.n - 1) : p.n + 1; + const effMax = p.maxHp + p.tempMaxHp; + if (p.hp - Math.max(0, nextN) < effMax * 0.15) return null; // 安全線:別把自己玩死 + let bi = 0, bv = -Infinity; + for (let i = 0; i < p.hand.length; i++) { + const v = cardAtk(p, p.hand[i]!); + if (v > bv) { bv = v; bi = i; } + } + return bi; +} + +/** 互動選牌:scry 留最高 atk;keep 強化最高;棄牌棄最低。 */ +function pickChoice(p: PlayerState, pend: { count: number; keep?: boolean; scry?: number[] }): number[] { + if (pend.scry) { + const order = pend.scry.map((id, i) => ({ i, v: getCard(id).atk })).sort((a, b) => b.v - a.v); + return order.slice(0, Math.min(pend.count, pend.scry.length)).map((o) => o.i); + } + const order = p.hand.map((id, i) => ({ i, v: cardAtk(p, id) })).sort((a, b) => (pend.keep ? b.v - a.v : a.v - b.v)); + return order.slice(0, Math.min(pend.count, p.hand.length)).map((o) => o.i); +} + +interface Row { level: number; atk: number; def: number; dmg: number; } + +function playGame(classType: ClassType, seed: number, maxLevel?: number): Row[] { + let s: GameState = createGame({ classType, seed, maxLevel }); + const rows: Row[] = []; + const apply = (a: Action) => { s = step(s, a).state; }; + let guard = 0; + while (s.phase !== "GAME_OVER" && s.phase !== "VICTORY" && guard++ < 5000) { + if (s.phase === "REWARD_SELECT") { + const ch = s.rewardChoices ?? []; + let bi = 0, bv = -1; + ch.forEach((id, i) => { const v = getCard(id).atk; if (v > bv) { bv = v; bi = i; } }); + apply({ type: "PICK_REWARD", choiceIndex: bi }); + continue; + } + if (s.phase === "PENDING_CHOICE") { + apply({ type: "CHOOSE_CARDS", indices: pickChoice(s.player, s.pendingChoice!) }); + continue; + } + if (s.phase === "PLAYER_TURN") { + let g = 0; + while (s.phase === "PLAYER_TURN" && g++ < 60) { + const pick = classType === "BARBARIAN" ? barbarianPick(s.player) : warriorPick(s.player); + if (pick === null) break; + const before = s.turnLog.length + "|" + s.player.hand.length + "|" + s.player.coin + "|" + s.player.combo; + apply({ type: "PLAY_CARD", handIndex: pick }); + if (s.phase !== "PLAYER_TURN") break; // forcedEnd / pending / reward + if (before === s.turnLog.length + "|" + s.player.hand.length + "|" + s.player.coin + "|" + s.player.combo) break; // 出牌無效化 → 收手 + } + if (s.phase === "PLAYER_TURN") { + const lvl = s.level; + const n0 = s.turnLog.length; + const hpB = s.opponent.hp; // 怪物掉血 = 本回合對怪實際輸出(含野蠻人真實傷害;slime DEF=0 故≈原始輸出) + apply({ type: "END_TURN" }); + const last = s.turnLog[s.turnLog.length - 1]; + const hpA = s.opponent.isAlive ? s.opponent.hp : 0; + if (s.turnLog.length > n0 && last) rows.push({ level: lvl, atk: last.atk, def: last.def, dmg: Math.max(0, hpB - hpA) }); + } + continue; + } + break; + } + return rows; +} + +interface Stat { turns: number; avgDmg: number; avgAtkBatched: number; avgDef: number; maxDmg: number; maxDef: number; } +function summarize(rows: Row[]): Stat { + if (rows.length === 0) return { turns: 0, avgDmg: 0, avgAtkBatched: 0, avgDef: 0, maxDmg: 0, maxDef: 0 }; + const avg = (f: (r: Row) => number) => +(rows.reduce((s, r) => s + f(r), 0) / rows.length).toFixed(2); + return { + turns: rows.length, + avgDmg: avg((r) => r.dmg), // 對怪實際輸出/回合(含真實傷害)= 真「攻擊力」 + avgAtkBatched: avg((r) => r.atk), // 批次 ATK(turnLog;野蠻人會少算真傷) + avgDef: avg((r) => r.def), + maxDmg: Math.max(...rows.map((r) => r.dmg)), + maxDef: Math.max(...rows.map((r) => r.def)), + }; +} + +/** 不死訓練假人:血量灌爆(不會過殺截斷)、低攻(讓角色撐久),量「基礎牌組」每回合真實總輸出(含真傷)。 */ +function dummyOutput(classType: ClassType, seed: number, turnsToMeasure = 8): number[] { + let s: GameState = createGame({ classType, seed }); + const dmgs: number[] = []; + let guard = 0; + while (dmgs.length < turnsToMeasure && guard++ < 400) { + if (s.phase === "PENDING_CHOICE") { s = step(s, { type: "CHOOSE_CARDS", indices: pickChoice(s.player, s.pendingChoice!) }).state; continue; } + if (s.phase !== "PLAYER_TURN") break; + s.opponent.hp = 1e9; s.opponent.maxHp = 1e9; s.opponent.def = 0; s.opponent.atk = 3; s.opponent.isAlive = true; // 不死假人 + let g = 0; + while (s.phase === "PLAYER_TURN" && g++ < 60) { + const pick = classType === "BARBARIAN" ? barbarianPick(s.player) : warriorPick(s.player); + if (pick === null) break; + const sig = s.player.hand.length + "|" + s.player.coin + "|" + s.player.combo; + s = step(s, { type: "PLAY_CARD", handIndex: pick }).state; + if (s.phase === "PENDING_CHOICE") { s = step(s, { type: "CHOOSE_CARDS", indices: pickChoice(s.player, s.pendingChoice!) }).state; continue; } + if (s.phase !== "PLAYER_TURN") break; + if (sig === s.player.hand.length + "|" + s.player.coin + "|" + s.player.combo) break; + } + if (s.phase !== "PLAYER_TURN") break; + s = step(s, { type: "END_TURN" }).state; + dmgs.push(1e9 - s.opponent.hp); // 本回合對假人總輸出(真傷+批次,未被過殺截斷) + if (s.phase === "GAME_OVER") break; + } + return dmgs; +} + +const N = Number(process.argv[2]) || 300; +const out: Record = { gamesPerClass: N, policy: "warrior=chain-aware-greedy; barbarian=highest-atk+15%-safety; reward=highest-atk" }; + +// 不死假人量基礎牌組真實輸出(特別是野蠻人真傷) +for (const cls of ["WARRIOR", "BARBARIAN"] as ClassType[]) { + const all: number[] = []; + for (let i = 0; i < Math.min(N, 120); i++) all.push(...dummyOutput(cls, 9000 + i * 11)); + const avg = all.length ? +(all.reduce((a, b) => a + b, 0) / all.length).toFixed(2) : 0; + out[`${cls}_不死假人_基礎牌組每回合輸出`] = { 取樣回合: all.length, 平均: avg, 最高: all.length ? Math.max(...all) : 0 }; +} + +for (const cls of ["WARRIOR", "BARBARIAN"] as ClassType[]) { + const all: Row[] = []; + for (let i = 0; i < N; i++) all.push(...playGame(cls, 7000 + i * 7)); + const early = all.filter((r) => r.level <= 2); + const lvl1 = all.filter((r) => r.level === 1); + out[cls] = { + 全程: summarize(all), + 早期_關1到2: summarize(early), + 只關1: summarize(lvl1), + }; +} + +console.log(JSON.stringify(out, null, 2)); diff --git a/packages/battle-core/scripts/gen-seed-ghost.ts b/packages/battle-core/scripts/gen-seed-ghost.ts new file mode 100644 index 0000000000000000000000000000000000000000..756489a4ee86d2482271895d860a222880bcd765 --- /dev/null +++ b/packages/battle-core/scripts/gen-seed-ghost.ts @@ -0,0 +1,214 @@ +/** + * 產生一筆「真實可驗證」的鬼影存檔,寫進 packages/server/data/ghosts.json,取代假樣本。 + * + * 為什麼需要這支腳本:這遊戲故意很難,單純「每回合出 0 號牌」的貪婪 AI 在 11 關打不贏, + * 無法產生合法存檔。這裡用 beam search(束搜索)自動探索「出牌順序+獎勵選擇」, + * 找出一場真的打到 VICTORY(第 11 關)的通關,再用「伺服器同款 verifyGhost」自驗後落檔。 + * + * 用法:cd packages/battle-core && npx tsx scripts/gen-seed-ghost.ts + * + * 設計依據:ultracode 工作流彙整的引擎事實—— + * - 怪物 DEF 恆 0,玩家原始 atk≈實際傷害;唯一壓力是怪物每回合 atk += trunc(growAtk) 的反擊爬升。 + * - 第 11 關 BOSS:195 HP、atk 17、growAtk 5。 + * - turnLog 在「傷害結算前」快照 {player.atk, player.def},每回合一筆。 + * - replay() 寫死 classType=WARRIOR、maxLevel=11 → 搜尋與落檔都必須用同樣設定。 + */ +import { writeFileSync } from "node:fs"; +import { fileURLToPath } from "node:url"; +import { dirname, join } from "node:path"; +import { createGame, step, replay } from "../src/engine.js"; +import { buildGhostRecord } from "../src/opponent.js"; +import { RULE_VERSION, CARDS_HASH } from "../src/version.js"; +import type { Action, GameState } from "../src/types.js"; + +// ---- 參數(可調;先用設計建議的保守值)---- +const SEEDS_TO_TRY = 200; // 掃描種子上限 +const BEAM_WIDTH = 64; // 束寬 K +const MAX_PLIES = 2000; // 每顆種子的最大展開層數(動作數,非回合數) +const PLAY_CHILD_CAP = 10; // 單一節點最多保留幾個 PLAY_CARD 後代(其餘靠去重收斂) + +// ---- 啟發式評分:對「套用一個動作後的 state」打一個分數(越高越好)---- +function score(s: GameState): number { + const p = s.player; + const opp = s.opponent; + if (p.hp <= 0 || s.phase === "GAME_OVER") return -1e9; // 死亡=最差,永不展開 + if (s.phase === "VICTORY") return 1e9; // 勝利=終局最佳 + const levelTerm = s.level * 100000; // 關卡權重壓過所有關內項 → 永遠優先往更深的關推進 + const dmgProgress = (opp.maxHp - opp.hp) * 50; // 本關已造成的傷害 + const hpTerm = p.hp * 30; // 存活 + const offenseTerm = p.atk * 12 + p.def * 4; // 本回合累積的攻防(堆爆發) + const resourceTerm = p.hand.length * 6 + p.coin * 8 + p.combo * 3; // 保留的選擇權 + return levelTerm + dmgProgress + hpTerm + offenseTerm + resourceTerm; +} + +// ---- 去重 key:只取「玩法相關」狀態,刻意排除 rng(否則束會爆炸、且交換出牌順序無法合併)---- +function key(s: GameState): string { + const p = s.player; + const opp = s.opponent; + const sortNum = (a: number[]) => [...a].sort((x, y) => x - y); + return JSON.stringify([ + s.phase, + s.level, + opp.hp, + opp.atk, + opp.def, + p.hp, + p.atk, + p.def, + p.coin, + p.combo, + p.nextReq, + sortNum(p.hand), // 排序後的手牌多重集合 → 合併「同一手牌不同出牌順序」抵達的相同狀態(最大的剪枝) + sortNum(p.deck), + sortNum(p.discard), + sortNum(p.burn), + s.rewardChoices ?? null, + s.turnLog.length, + ]); +} + +// ---- 依相位枚舉「候選動作」---- +function enumerateActions(s: GameState): Action[] { + const p = s.player; + if (s.phase === "PLAYER_TURN") { + const acts: Action[] = []; + const n = Math.min(p.hand.length, 64); + for (let i = 0; i < n; i++) acts.push({ type: "PLAY_CARD", handIndex: i }); + acts.push({ type: "END_TURN" }); // END_TURN 永遠保留 → 保證有前進 + return acts; + } + if (s.phase === "REWARD_SELECT") { + // 三個都展開(一場僅約 11 次,成本極低;不同選擇 → 不同牌組 → 去重不會誤併) + const m = (s.rewardChoices ?? []).length; + const acts: Action[] = []; + for (let c = 0; c < m && c < 3; c++) acts.push({ type: "PICK_REWARD", choiceIndex: c }); + return acts; + } + if (s.phase === "PENDING_CHOICE") { + // 純戰士跑不到這(選牌卡都是野蠻人);空 indices 永遠合法,僅作保險。 + return [{ type: "CHOOSE_CARDS", indices: [] }]; + } + return []; +} + +interface Node { + state: GameState; + actions: Action[]; +} + +/** 束搜索:找出一條打到 VICTORY 的動作序列;找不到回 null。 */ +function beamSearch(root: GameState): Action[] | null { + let beam: Node[] = [{ state: root, actions: [] }]; + for (let ply = 0; ply < MAX_PLIES; ply++) { + const children: { node: Node; sc: number; k: string }[] = []; + for (const node of beam) { + const parentKey = key(node.state); + const plays: { node: Node; sc: number; k: string }[] = []; + const others: { node: Node; sc: number; k: string }[] = []; + for (const a of enumerateActions(node.state)) { + const childState = step(node.state, a).state; + const childActions = [...node.actions, a]; + if (childState.phase === "VICTORY") return childActions; // 立刻收手 + if (childState.phase === "GAME_OVER") continue; // 丟棄死亡節點 + const k = key(childState); + const entry = { node: { state: childState, actions: childActions }, sc: score(childState), k }; + if (a.type === "PLAY_CARD") { + if (k === parentKey) continue; // 出牌無效化(無硬幣/標籤鎖/壞索引)→ no-op,丟棄避免死循環 + plays.push(entry); + } else { + others.push(entry); // END_TURN / PICK_REWARD / CHOOSE_CARDS 一律保留 + } + } + // 單節點 PLAY_CARD 後代上限(取分數最高的前 N 個)+全部 others + plays.sort((x, y) => y.sc - x.sc); + for (const e of plays.slice(0, PLAY_CHILD_CAP)) children.push(e); + for (const e of others) children.push(e); + } + if (children.length === 0) break; // 全滅(每條路都死) + + // 排序:分數↓ → 路徑短↑(偏好較短勝利)→ key(穩定);再依 key 去重保留第一筆(最佳) + children.sort((a, b) => b.sc - a.sc || a.node.actions.length - b.node.actions.length || (a.k < b.k ? -1 : a.k > b.k ? 1 : 0)); + const seen = new Set(); + const next: Node[] = []; + for (const c of children) { + if (seen.has(c.k)) continue; + seen.add(c.k); + next.push(c.node); + if (next.length >= BEAM_WIDTH) break; + } + beam = next; + } + return null; +} + +// ---- 自驗:完全照伺服器 verifyGhost(ghostService.ts)+ validateGhostShape 的邏輯(battle-core 不能 import @wcg/server,故就地複製)---- +function selfVerify(record: ReturnType): void { + const ok = (cond: boolean, msg: string) => { + if (!cond) throw new Error(`自驗失敗:${msg}`); + }; + const intIn = (v: unknown, lo: number, hi: number) => typeof v === "number" && Number.isInteger(v) && v >= lo && v <= hi; + // verifyGhost 等價檢查 + ok(record.ruleVersion === RULE_VERSION && record.cardsHash === CARDS_HASH, "版本/卡表指紋不符"); + ok(Array.isArray(record.actions) && record.actions.length > 0, "缺 actions(無法重播)"); + const f = replay(record.seed, record.actions!); + ok(f.phase === "VICTORY", `重播未達破關(phase=${f.phase})`); + ok(f.player.maxHp === record.playerMaxHp, "playerMaxHp 不符"); + ok(f.turnLog.length === record.turns.length, `turns 長度不符(replay=${f.turnLog.length} record=${record.turns.length})`); + for (let i = 0; i < record.turns.length; i++) { + ok(f.turnLog[i]!.atk === record.turns[i]!.atk && f.turnLog[i]!.def === record.turns[i]!.def, `第 ${i + 1} 回合 atk/def 不符`); + } + // validateGhostShape 邊界 + ok(intIn(record.playerMaxHp, 1, 100000), "playerMaxHp 超界"); + ok(record.turns.length <= 2000, "turns 過長"); + for (const t of record.turns) ok(intIn(t.atk, -100000, 100000) && intIn(t.def, -100000, 100000), "turn atk/def 超界"); + ok(intIn(record.seed, -0x80000000, 0xffffffff), "seed 超界"); + ok(record.actions!.length <= 20000, "actions 過長"); + for (const a of record.actions!) { + if (a.type === "PLAY_CARD") ok(intIn(a.handIndex, 0, 63), "PLAY_CARD handIndex 超界"); + if (a.type === "PICK_REWARD") ok(intIn(a.choiceIndex, 0, 9), "PICK_REWARD choiceIndex 超界"); + if (a.type === "CHOOSE_CARDS") ok(Array.isArray(a.indices) && a.indices.length <= 16 && a.indices.every((x) => intIn(x, 0, 63)), "CHOOSE_CARDS indices 超界"); + } +} + +// ================= 主流程 ================= +function main(): void { + let winning: { seed: number; actions: Action[] } | null = null; + const t0 = Date.now(); + for (let seed = 1; seed <= SEEDS_TO_TRY; seed++) { + const root = createGame({ classType: "WARRIOR", seed }); // 不帶 maxLevel → 與 replay 一致用 11 + const actions = beamSearch(root); + if (actions) { + winning = { seed, actions }; + console.log(`✅ seed=${seed} 找到通關線(${actions.length} 個動作,耗時 ${Date.now() - t0}ms)`); + break; + } + if (seed % 10 === 0) console.log(`…已掃到 seed=${seed}(${Date.now() - t0}ms)尚未找到,繼續`); + } + if (!winning) { + console.error(`❌ 在 seed 1..${SEEDS_TO_TRY}、K=${BEAM_WIDTH} 內沒找到通關線。請調高 BEAM_WIDTH(128/256)或 SEEDS_TO_TRY 再試。`); + process.exit(1); + } + + // 用「乾淨重播」重建破關狀態(不沿用 beam 節點),確保 turnLog/maxHp 與全新一場完全一致 + let s = createGame({ classType: "WARRIOR", seed: winning.seed }); + for (const a of winning.actions) s = step(s, a).state; + if (s.phase !== "VICTORY") throw new Error("重建破關狀態失敗(非 VICTORY)"); + + const record = buildGhostRecord(s, { seed: winning.seed, actions: winning.actions, createdAt: new Date().toISOString(), heroName: "範例勇者" }); + selfVerify(record); + console.log(`✅ 自驗通過:playerMaxHp=${record.playerMaxHp}、回合數 k=${record.turns.length}、動作數=${record.actions!.length}`); + + // 落檔:一元素 JSON 陣列,補上伺服器端欄位 id / verified(與 StoredGhost 形狀一致) + const here = dirname(fileURLToPath(import.meta.url)); + const outFile = join(here, "..", "..", "server", "data", "ghosts.json"); + const out = [{ id: "00000000-0000-4000-8000-000000000001", verified: true, ...record }]; + writeFileSync(outFile, JSON.stringify(out, null, 2), "utf8"); + console.log(`✅ 已寫入 ${outFile}(1 筆 verified:true 真實鬼影,取代假樣本)`); + + // 印出 turns 摘要,便於肉眼確認「數值像不像過 11 關的人」 + const k = record.turns.length; + console.log(` 前 5 回合:${JSON.stringify(record.turns.slice(0, 5))}`); + console.log(` 末 5 回合:${JSON.stringify(record.turns.slice(-5))}`); +} + +main(); diff --git a/packages/battle-core/scripts/sanctus-trace.ts b/packages/battle-core/scripts/sanctus-trace.ts new file mode 100644 index 0000000000000000000000000000000000000000..1d10f4f6a770c3f721ac39ca0a8b5c611cdc1ca4 --- /dev/null +++ b/packages/battle-core/scripts/sanctus-trace.ts @@ -0,0 +1,42 @@ +/** Sanctus 多回合追蹤:戰士(會串連擊的貪婪)打 Sanctus,逐回合印能量/意圖/護盾/技能,肉眼驗證能量×技能×意圖迴圈。 */ +import { createGame, step } from "../src/engine.js"; +import { getCard } from "../src/cards.js"; +import { SANCTUS_SKILLS } from "../src/foes.js"; +import type { GameState, PlayerState, Tag } from "../src/types.js"; + +const tagLocked = (p: PlayerState, t: Tag) => (t === "A" && !p.useA) || (t === "B" && !p.useB); +function pick(p: PlayerState): number | null { + const h = p.hand.map((id, i) => ({ i, c: getCard(id) })).filter((x) => !tagLocked(p, x.c.tag)); + if (h.length === 0) return null; + if (p.combo === 0) { if (p.coin <= 0) return null; h.sort((a, b) => b.c.atk - a.c.atk); return h[0]!.i; } + const ch = h.filter((x) => x.c.tag === p.nextReq || p.nextReq === "Any" || x.c.tag === "Any"); + if (ch.length) { ch.sort((a, b) => b.c.atk - a.c.atk); return ch[0]!.i; } + if (p.coin <= 0) return null; + h.sort((a, b) => b.c.atk - a.c.atk); return h[0]!.i; +} +const names = (ids: string[] = []) => ids.map((id) => SANCTUS_SKILLS[id]?.name ?? id).join("、") || "(蓄力中)"; + +let s: GameState = createGame({ classType: "WARRIOR", seed: 42, campaign: "sanctus" }); +for (let t = 1; t <= 12 && s.phase !== "GAME_OVER" && s.phase !== "VICTORY"; t++) { + let g = 0; + while (s.phase === "PLAYER_TURN" && g++ < 40) { + const i = pick(s.player); if (i === null) break; + const sig = s.player.hand.length + "|" + s.player.coin + "|" + s.player.combo; + s = step(s, { type: "PLAY_CARD", handIndex: i }).state; + if (s.phase === "PENDING_CHOICE") { s = step(s, { type: "CHOOSE_CARDS", indices: [] }).state; continue; } + if (s.phase !== "PLAYER_TURN") break; + if (sig === s.player.hand.length + "|" + s.player.coin + "|" + s.player.combo) break; + } + const o = s.opponent; + console.log(`關${s.level} T${t} 出牌後|玩家ATK ${s.player.atk}(審判線${o.judgeLine})|敵 HP ${o.hp}/${o.maxHp} 能量 ${o.energy}/${o.maxEnergy} 盾 ${o.aegis}|下一步: ${names(o.intent)}`); + if (s.phase === "PLAYER_TURN") { + const r = step(s, { type: "END_TURN" }); s = r.state; + const log = r.events.map((e) => + e.type === "SKILL_USED" ? `技【${e.name}】` : + e.type === "MONSTER_REFLECT" ? `聖裁反噬${e.damage}` : + e.type === "MONSTER_ATTACK" ? `普攻${e.damage}` : + e.type === "MONSTER_DEAD" ? "★擊敗" : "").filter(Boolean).join(" "); + console.log(` 結算: ${log}|玩家HP ${s.player.hp}`); + } + if (s.phase === "REWARD_SELECT") s = step(s, { type: "PICK_REWARD", choiceIndex: 0 }).state; +} diff --git a/packages/battle-core/src/data/cards.ts b/packages/battle-core/src/data/cards.ts index 8dc7381fc0ef0a8c2307b880ea9f391a124c8025..b9ce6c3eed1eb7d6c5ab5d845539279e2dfd6b40 100644 --- a/packages/battle-core/src/data/cards.ts +++ b/packages/battle-core/src/data/cards.ts @@ -19,67 +19,81 @@ export const CARDS: readonly CardData[] = [ // ===== A. 普通卡(獎勵池:0–12, 30, 31, 32, 33, 36)===== { id: 0, name: "閃躲", tag: "B", nextReq: "Any", atk: 0, def: 2, rarity: "normal", + desc: "連擊:抽 1 張,然後結束本次連擊。", onCombo: [{ op: "DRAW", value: 1 }, { op: "END_COMBO" }], }, { id: 1, name: "瘋狂連打", tag: "A", nextReq: "None", atk: 0, def: 0, rarity: "normal", + desc: "連擊:ATK += 連擊數,然後結束本次連擊。", onCombo: [{ op: "ADD_ATK", value: { var: "combo" } }, { op: "END_COMBO" }], }, { id: 2, name: "加固", tag: "B", nextReq: "B", atk: 0, def: 4, rarity: "normal", + desc: "連擊:基礎 DEF +1(本場戰鬥持續,過關重置)。", // BaseDEF +1:本局持續(過關時 initStates 把 baseDef 歸零而重置)。卡面即「此場戰鬥內 DEF+1」。 onCombo: [{ op: "ADD_BASE_DEF", value: 1 }], }, { id: 3, name: "好的開始", tag: "Any", nextReq: "Any", atk: 2, def: 0, rarity: "normal", + desc: "即時:若為起手(出牌前連擊數為 0)→ 抽 1 張。", // 抽牌只發生在「起手」這條路徑(01 §4.2) onPlay: [{ op: "IF", cond: { kind: "isStarter" }, then: [{ op: "DRAW", value: 1 }] }], }, { id: 4, name: "重擊", tag: "A", nextReq: "A", atk: 6, def: 0, rarity: "normal", + desc: "即時:設下強制結束旗標(再打一張接不上即強制結束回合)。", // 只設旗標;「再打一張即強制結束」由引擎處理(Q2 拍板) onPlay: [{ op: "SET_FLAG", flag: "重擊" }], }, { id: 5, name: "龜縮", tag: "B", nextReq: "B", atk: 0, def: 8, rarity: "normal", + desc: "即時:鎖 A,本回合無法再打出 A 標籤的牌。", onPlay: [{ op: "LOCK_TAG", tag: "A" }], }, { id: 6, name: "捨身一擊", tag: "A", nextReq: "A", atk: 7, def: 0, rarity: "normal", + desc: "即時:HP -2,並鎖 B,本回合無法再打出 B 標籤的牌。連擊:ATK +3。", onPlay: [{ op: "ADD_HP", value: -2 }, { op: "LOCK_TAG", tag: "B" }], onCombo: [{ op: "ADD_ATK", value: 3 }], }, { id: 7, name: "不穩定的格擋", tag: "Any", nextReq: "B", atk: 0, def: 0, rarity: "normal", + desc: "即時:DEF += 隨機 0~8(每次不同,可能毫無作用)。連擊:DEF -3。", onPlay: [{ op: "RANDOM_DEF_0_8" }], onCombo: [{ op: "ADD_DEF", value: -3 }], }, { id: 8, name: "深呼吸", tag: "B", nextReq: "Any", atk: 0, def: 2, rarity: "normal", + desc: "連擊:若手牌中已無任何 A 標籤卡 → 抽 1。", onCombo: [{ op: "IF", cond: { kind: "noTagInHand", tag: "A" }, then: [{ op: "DRAW", value: 1 }] }], }, { id: 9, name: "挑釁", tag: "Any", nextReq: "Any", atk: 3, def: 0, rarity: "normal", + desc: "即時:抽 1,並讓本回合怪物反擊 ATK +1。連擊:再抽 1。", onPlay: [{ op: "SET_FLAG", flag: "挑釁" }, { op: "DRAW", value: 1 }], onCombo: [{ op: "DRAW", value: 1 }], }, { id: 10, name: "節奏感", tag: "A", nextReq: "Any", atk: 1, def: 0, rarity: "normal", + desc: "即時:若連擊數為偶數 → DEF +3,否則 ATK +3。", onPlay: [ { op: "IF", cond: { kind: "comboEven" }, then: [{ op: "ADD_DEF", value: 3 }], else: [{ op: "ADD_ATK", value: 3 }] }, ], }, { id: 11, name: "餘裕", tag: "B", nextReq: "Any", atk: 0, def: 5, rarity: "normal", + desc: "即時:回合末若硬幣 >0 → HP +5、maxHP +5。", onPlay: [{ op: "SET_FLAG", flag: "餘裕" }], }, { id: 12, name: "沉穩應對", tag: "B", nextReq: "Any", atk: 0, def: 4, rarity: "normal", + desc: "即時:若連擊數恰為 1(起手首張)→ 硬幣 +1。", // 名為 COMBO_0 但檢查 Combo==1(起手後 Combo 立即為 1,06 已知問題 #7,行為照舊) onPlay: [{ op: "IF", cond: { kind: "comboEq", value: 1 }, then: [{ op: "ADD_COIN", value: 1 }] }], }, { id: 30, name: "終章決戰", tag: "None", nextReq: "None", atk: 5, def: 0, rarity: "normal", + desc: "即時:若硬幣為 0 且手牌已空 → ATK +15 並結束連擊。", onPlay: [ { op: "IF", @@ -90,6 +104,7 @@ export const CARDS: readonly CardData[] = [ }, { id: 31, name: "懸崖前的注視", tag: "A", nextReq: "Any", atk: 11, def: 0, rarity: "normal", + desc: "即時:ATK -= 當前手牌張數。連擊(依下一張 tag):A→ATK -2;B→DEF -4;Any→ATK -2 且 DEF -3。", onPlay: [{ op: "ADD_ATK", value: { mul: [-1, { var: "handCount" }] } }], onCombo: [ { @@ -102,16 +117,19 @@ export const CARDS: readonly CardData[] = [ }, { id: 32, name: "新月訓練", tag: "A", nextReq: "B", atk: 1, def: 0, rarity: "normal", + desc: "即時:ATK += 新月計數 × 2。連擊:新月計數 +1(本場累積)。", onPlay: [{ op: "ADD_ATK", value: { mul: [2, { var: "newmoon" }] } }], onCombo: [{ op: "ADD_COUNTER", counter: "newmoon", value: 1 }], }, { id: 33, name: "斷劍", tag: "A", nextReq: "A", atk: 0, def: 0, rarity: "normal", + desc: "連擊:斷劍計數 +(當前硬幣 + 1)(累積達 20 升級為血劍)。", // 連擊:鍛造(broken 計數)+(當前剩餘硬幣 + 1) onCombo: [{ op: "ADD_COUNTER", counter: "broken", value: { add: [{ var: "coin" }, 1] } }], }, { id: 36, name: "應急", tag: "A", nextReq: "B", atk: 1, def: 0, rarity: "normal", + desc: "即時:手牌上限 -1、抽 2 張。連擊:DEF +2。", onPlay: [{ op: "ADD_MAX_HAND", value: -1 }, { op: "DRAW", value: 2 }], onCombo: [{ op: "ADD_DEF", value: 2 }], }, @@ -119,53 +137,65 @@ export const CARDS: readonly CardData[] = [ // ===== B. 史詩卡(獎勵池:13–23, 37, 38, 39, 40)===== { id: 13, name: "連環爆發", tag: "Any", nextReq: "Any", atk: 7, def: 0, rarity: "epic", + desc: "連擊:ATK +5。", onCombo: [{ op: "ADD_ATK", value: 5 }], }, { id: 14, name: "黃金律動", tag: "A", nextReq: "A", atk: 5, def: 0, rarity: "epic", + desc: "即時:若打出當下連擊數 ≥ 6 → 下回合硬幣回滿時額外 +1。", onPlay: [{ op: "IF", cond: { kind: "comboGte", value: 6 }, then: [{ op: "SET_FLAG", flag: "黃金律動" }] }], }, { id: 15, name: "生命汲取", tag: "A", nextReq: "B", atk: 4, def: 0, rarity: "epic", + desc: "即時:本次出傷時回血 min(本波傷害÷2, 10)(夾當前生命上限)。", onPlay: [{ op: "SET_FLAG", flag: "生命汲取" }], }, { id: 16, name: "快速裝填", tag: "Any", nextReq: "Any", atk: 1, def: 0, rarity: "epic", + desc: "連擊:抽 5 張。", onCombo: [{ op: "DRAW", value: 5 }], }, { id: 17, name: "烈空斬", tag: "A", nextReq: "Any", atk: 6, def: 0, rarity: "epic", + desc: "即時:本次出傷額外 + 怪物當前 HP 的 30%(向下取整)。", onPlay: [{ op: "SET_FLAG", flag: "烈空斬" }], modeOverride: { PVP: { notes: "烈空斬上限綁對手 maxHP=floor(maxHP×3/10)(maxHP=200→60),見 pvpResolve outgoing()" } }, }, { id: 18, name: "盾牆", tag: "B", nextReq: "B", atk: 0, def: 3, rarity: "epic", + desc: "連擊:當前 DEF 翻倍(DEF += 當前 DEF)。", onCombo: [{ op: "ADD_DEF", value: { var: "def" } }], // 當前 DEF 翻倍 }, { id: 19, name: "連擊狂熱", tag: "A", nextReq: "A", atk: 1, def: 0, rarity: "epic", + desc: "即時:ATK += 連擊數 × 2。", onPlay: [{ op: "ADD_ATK", value: { mul: [{ var: "combo" }, 2] } }], }, { id: 20, name: "盾擊", tag: "A", nextReq: "A", atk: 0, def: 0, rarity: "epic", + desc: "即時:ATK += 當前 DEF。連擊:ATK +1。", onPlay: [{ op: "ADD_ATK", value: { var: "def" } }], onCombo: [{ op: "ADD_ATK", value: 1 }], }, { id: 21, name: "破綻偵測", tag: "A", nextReq: "B", atk: 5, def: 0, rarity: "epic", + desc: "連擊:基礎 ATK 永久 +1(整場累積、過關也不重置)。", // BaseATK +1:真·永久(整場累積、過關不重置)。原版只歸零 baseDef、不歸零 baseAtk,1:1 保留此不對稱。 onCombo: [{ op: "ADD_BASE_ATK", value: 1 }], }, { id: 22, name: "鋼鐵旋風", tag: "Any", nextReq: "Any", atk: 4, def: 4, rarity: "epic", + desc: "連擊:DEF +4、ATK +4。", onCombo: [{ op: "ADD_DEF", value: 4 }, { op: "ADD_ATK", value: 4 }], }, { id: 23, name: "蓄勢", tag: "A", nextReq: "A", atk: 2, def: 0, rarity: "epic", + desc: "連擊:下一次出傷 +25%(無條件捨去)後消耗。", onCombo: [{ op: "SET_FLAG", flag: "蓄勢" }], }, { id: 37, name: "最後的攻勢", tag: "A", nextReq: "A", atk: 3, def: 0, rarity: "epic", + desc: "連擊:ATK += 硬幣 × 硬幣 × 3,接著硬幣歸 0 並結束連擊。", onCombo: [ { op: "ADD_ATK", value: { mul: [{ var: "coin" }, { var: "coin" }, 3] } }, { op: "SET_COIN", value: 0 }, @@ -174,11 +204,13 @@ export const CARDS: readonly CardData[] = [ }, { id: 38, name: "強化訓練", tag: "B", nextReq: "A", atk: 0, def: 1, rarity: "epic", + desc: "即時:DEF += 2 × 訓練計數(本場累積)。連擊:訓練計數 +1。", onPlay: [{ op: "ADD_DEF", value: { mul: [2, { var: "training" }] } }], onCombo: [{ op: "ADD_COUNTER", counter: "training", value: 1 }], }, { id: 39, name: "幸運的硬幣之路", tag: "B", nextReq: "A", atk: 0, def: 0, rarity: "normal", + desc: "即時:擲幸運硬幣(0/1)——0 則硬幣 +3,否則 DEF += 3 × 當前硬幣。連擊:結算相反那半,結束後幸運值歸 0。", // 即時:lucky=rand∈[0,1];0→Coin+=3,否則 DEF+=3*Coin onPlay: [ { op: "RANDOM_SET", name: "lucky", lo: 0, hi: 1 }, @@ -202,6 +234,7 @@ export const CARDS: readonly CardData[] = [ }, { id: 40, name: "記憶之路", tag: "B", nextReq: "A", atk: 0, def: 1, rarity: "epic", + desc: "即時:硬幣 -1、抽 1 張。連擊:抽 2 張。", onPlay: [{ op: "ADD_COIN", value: -1 }, { op: "DRAW", value: 1 }], onCombo: [{ op: "DRAW", value: 2 }], }, @@ -209,13 +242,15 @@ export const CARDS: readonly CardData[] = [ // ===== C. 傳說卡(獎勵池:24–29)===== { id: 24, name: "絕對防禦", tag: "B", nextReq: "A", atk: 0, def: 15, rarity: "legend", + desc: "即時:本回合 DEF 延後一回合才重置(多撐一回合)。連擊:ATK +1。(焚燒:用完進消耗堆)", onPlay: [{ op: "SET_FLAG", flag: "絕對防禦" }], onCombo: [{ op: "ADD_ATK", value: 1 }], exhaust: true, // 黑玫瑰·前設:用完進消耗堆 }, { id: 25, name: "命運之路的抉擇", tag: "Any", nextReq: "Any", atk: 5, def: 0, rarity: "legend", - exhaust: true, // 焚燒 + desc: "連擊(依下一張 tag):A→本回合 ATK 半數保留到下回合(連擊中斷也保留);B→抽 2;Any→抽 1 並 ATK +5。", + // 取消焚燒:打出後比照正常卡洗入棄牌堆(可重複抽到再用),不進消耗堆。 // Combo(A):本回合 ATK 的 1/2 保留至下回合(用專屬「留攻」旗標,連擊中斷也不清除);B:抽 2;Any:抽 1 + ATK5 onCombo: [ { @@ -228,32 +263,38 @@ export const CARDS: readonly CardData[] = [ }, { id: 26, name: "失控侵蝕", tag: "A", nextReq: "A", atk: 3, def: 0, rarity: "legend", + desc: "即時:清空當前 DEF 並本場鎖 DEF=0;之後加 DEF 改以一半(四捨五入)轉 ATK,連擊改每 2 連抽 1。本場持續、下一關重置。(焚燒:用完進消耗堆)", // 焚燒(exhaust);出牌即 失控侵蝕:DEF 鎖 0(清當前 DEF)+ 連擊每 2 抽 1 + 加 DEF 一半轉 ATK;本場持續、下一關重置 onPlay: [{ op: "SET_FLAG", flag: "失控侵蝕" }, { op: "SET_DEF", value: 0 }], exhaust: true, }, { id: 27, name: "均衡天秤", tag: "B", nextReq: "None", atk: 5, def: 5, rarity: "legend", + desc: "即時:互換當前 ATK 與 HP 數值,並結束連擊。", onPlay: [{ op: "SWAP_ATK_HP" }, { op: "END_COMBO" }], modeOverride: { PVP: { notes: "SWAP 後夾 HP ≥ 1(07 §4.5);M3+ 實作" } }, }, { id: 28, name: "傳說之證", tag: "Any", nextReq: "Any", atk: 5, def: 5, rarity: "legend", + desc: "即時:本場任何卡都能接續連擊(無視標籤閘門),硬幣上限設為 1。(焚燒:用完進消耗堆)", onPlay: [{ op: "SET_FLAG", flag: "傳說之證" }, { op: "SET_MAX_COIN", value: 1 }], exhaust: true, // 黑玫瑰·誓言:用完進消耗堆 }, { id: 29, name: "最後的決斷", tag: "A", nextReq: "A", atk: 0, def: 0, rarity: "legend", + desc: "即時:ATK += 本場此卡前已出牌數 × 3。", onPlay: [{ op: "ADD_ATK", value: { mul: [{ var: "playCardCount" }, 3] } }], }, // ===== D. 升級專屬卡(不在獎勵池:34, 35)===== { id: 34, name: "血劍", tag: "A", nextReq: "A", atk: 8, def: 0, rarity: "upgrade", + desc: "連擊:血劍計數 +1(本場累積,達 8 升級為終極一擊)。", onCombo: [{ op: "ADD_COUNTER", counter: "blood", value: 1 }], }, { id: 35, name: "終極一擊", tag: "A", nextReq: "A", atk: 20, def: 0, rarity: "upgrade", + desc: "即時:依連擊數推進處決——連擊 1 時 winValue÷2、2÷3、3÷5、4÷7(由 210 起);整除到 1 時本回合出傷額外 +怪物當前 HP(斬殺)。連擊:硬幣 +1。", onPlay: [{ op: "ULT_WIN_CHECK" }], onCombo: [{ op: "ADD_COIN", value: 1 }], modeOverride: { PVP: { notes: "WIN → 無視對手 DEF 且 atk += 對手HP/2 半血處決(07 §4.5);M3+ 實作" } }, @@ -510,9 +551,9 @@ export const CARDS: readonly CardData[] = [ onPlay: [{ op: "LOCK_N", value: 1, duration: 3 }], }, { - id: 165, classType: "BARBARIAN", name: "野性先手", tag: "None", nextReq: "None", atk: 15, def: 0, rarity: "epic", - dmgText: "15", desc: "造成 15 點傷害;若為本回合第一張牌,本次不扣血,否則出牌計數 n 額外 +1。", - onPlay: [{ op: "IF", cond: { kind: "nEq", value: 1 }, then: [{ op: "SUPPRESS_SELFDMG" }], else: [{ op: "ADD_N", value: 1 }] }], + id: 165, classType: "BARBARIAN", name: "野性先手", tag: "None", nextReq: "None", atk: 12, def: 0, rarity: "epic", + dmgText: "12", desc: "造成 12 點傷害;若為本回合第一張牌(n=1),出牌計數 n 變為 -2(n 為負時視為回血),否則 n 額外 +1。", + onPlay: [{ op: "IF", cond: { kind: "nEq", value: 1 }, then: [{ op: "SET_N", value: -2 }], else: [{ op: "ADD_N", value: 1 }] }], }, { id: 166, classType: "BARBARIAN", name: "蠻荒震擊", tag: "None", nextReq: "None", atk: 8, def: 0, rarity: "epic", @@ -568,8 +609,8 @@ export const CARDS: readonly CardData[] = [ { id: 183, classType: "BARBARIAN", name: "死亡前的凝視", tag: "None", nextReq: "None", atk: 0, def: 0, rarity: "legend", exhaust: true, - desc: "本回合若你將死亡,改為復活並回復至總生命上限的 50%。若觸發,本卡將被永久移除(連消耗堆都不留)。", - onPlay: [{ op: "ARM_REVIVE", fraction: 0.5 }], + desc: "本回合若你將死亡,改為:臨時生命上限 1:1 全數轉為永久生命,並以 100% 總生命復活。若觸發,本卡將被永久移除(連消耗堆都不留)。", + onPlay: [{ op: "ARM_REVIVE", fraction: 1.0 }], }, { id: 184, classType: "BARBARIAN", name: "Inverse", tag: "None", nextReq: "None", atk: 0, def: 0, rarity: "legend", @@ -586,8 +627,8 @@ export const CARDS: readonly CardData[] = [ { id: 186, classType: "BARBARIAN", name: "萬象寂滅", tag: "None", nextReq: "None", atk: 0, def: 0, rarity: "legend", exhaust: true, - desc: "將棄牌堆中隨機 5 張卡牌直接移入消耗堆;將 10 張「專注」放在抽牌堆頂部。", - onPlay: [{ op: "ANNIHILATE", token: 110, moveCount: 5, tokenCount: 10, position: "top" }], + desc: "將棄牌堆中隨機 5 張卡牌直接移入消耗堆;將 10 張「專注」洗入棄牌堆。", + onPlay: [{ op: "ANNIHILATE", moveCount: 5 }, { op: "SHUFFLE_TOKEN", token: 110, pile: "discard", count: 10 }], }, { id: 187, classType: "BARBARIAN", name: "反刃血鎧", tag: "None", nextReq: "None", atk: 0, def: 0, rarity: "legend", @@ -605,8 +646,8 @@ export const CARDS: readonly CardData[] = [ { id: 110, classType: "BARBARIAN", name: "專注", tag: "None", nextReq: "None", atk: 0, def: 0, rarity: "normal", isToken: true, derived: true, exhaust: true, - desc: "(Token)抽到即釋放:臨時血量上限 +1(並回 1 HP,不計入出牌數)。用完進消耗堆。", - onDraw: [{ op: "ADD_TEMP_MAXHP", value: 1 }], + desc: "(Token)抽到即釋放:臨時血量上限 +2(並回 2 HP,不計入出牌數)。用完進消耗堆。", + onDraw: [{ op: "ADD_TEMP_MAXHP", value: 2 }], }, { id: 111, classType: "BARBARIAN", name: "蓄力", tag: "None", nextReq: "None", atk: 3, def: 0, rarity: "normal", diff --git a/packages/battle-core/src/deck.ts b/packages/battle-core/src/deck.ts index 21ff1b515516f3765dda1a4f7c7a9ddf98fb8eb6..d9bac299064e00918af665d98c6e093d089be34c 100644 --- a/packages/battle-core/src/deck.ts +++ b/packages/battle-core/src/deck.ts @@ -10,7 +10,7 @@ import { shuffle } from "./rng.js"; /** * 抽到卡時的「on-draw」解析器(註冊式,避免 deck ↔ effects 循環相依)。 - * 回傳 consumed=true 表示該卡被自動釋放(如野蠻人「專注」抽到即 +1 臨時上限、進消耗堆), + * 回傳 consumed=true 表示該卡被自動釋放(如野蠻人「專注」抽到即 +2 臨時上限、進消耗堆), * 不進手牌、不佔抽牌數(會補抽下一張)。由 player.ts 在載入時註冊。 */ export type OnDrawResolver = ( diff --git a/packages/battle-core/src/effects.ts b/packages/battle-core/src/effects.ts index 8c1cd3cbd29f0297116f1605dea2b3878d0d9f66..d96904eddec1b475f9c245e6a95422d82f08c21b 100644 --- a/packages/battle-core/src/effects.ts +++ b/packages/battle-core/src/effects.ts @@ -177,7 +177,7 @@ export function runOps(ops: EffectOp[] | undefined, ctx: EffectCtx): void { } break; } - case "SET_N": p.n = Math.max(0, op.value); break; + case "SET_N": p.n = op.value; break; // 可為負(野性先手 n→-2,負 n 於出牌結算回血) case "ADD_N": p.n = Math.max(op.min ?? 0, p.n + op.value); break; case "RANDOM_DISCARD": { let cnt = evalValue(op.count, p); @@ -256,18 +256,13 @@ export function runOps(ops: EffectOp[] | undefined, ctx: EffectCtx): void { break; } case "ANNIHILATE": { - // 棄牌堆隨機 moveCount 張 → 消耗堆(decisive,消耗亂數) + // 萬象寂滅:棄牌堆隨機 moveCount 張 → 消耗堆(decisive,消耗亂數)。token 生成由卡片另接 SHUFFLE_TOKEN。 const moveN = Math.min(op.moveCount, p.discard.length); for (let k = 0; k < moveN; k++) { const [idx, next] = nextInt(ctx.rng, p.discard.length); ctx.rng = next; p.burn.push(p.discard.splice(idx, 1)[0]!); } - // 於牌庫生成 tokenCount 個 token:top=尾端(下次先抽到→手牌恆滿會即時釋放);bottom=index0(隨牌庫循環逐步釋放) - for (let i = 0; i < op.tokenCount; i++) { - if (op.position === "top") p.deck.push(op.token); - else p.deck.unshift(op.token); - } break; } case "MOVE_TOKEN": { diff --git a/packages/battle-core/src/engine.ts b/packages/battle-core/src/engine.ts index 2317275fc8cdb964c9c3336315cb6d5f244e132f..0f01a1339f7cdf470a2450b8be0117b49563545f 100644 --- a/packages/battle-core/src/engine.ts +++ b/packages/battle-core/src/engine.ts @@ -5,7 +5,7 @@ * step() 對 GameState 做 structuredClone 後在副本上修改,確保無副作用、可重播。 */ -import type { Action, ClassType, GameEvent, GameState, StepResult } from "./types.js"; +import type { Action, Campaign, ClassType, GameEvent, GameState, StepResult } from "./types.js"; import { makeRng, shuffle } from "./rng.js"; import { drawCards } from "./deck.js"; import { CLASS_INIT } from "./classes.js"; @@ -30,6 +30,7 @@ import { opponentTakeDamage, upgradeMonsterForLevel, } from "./opponent.js"; +import { accrueCardEnergy, createSanctus, SANCTUS_MAX_LEVEL, sanctusEnemyTurn, upgradeSanctusForLevel } from "./foes.js"; import { rewardPoolFor, startingDeckFor } from "./cards.js"; import type { GhostRecord } from "./types.js"; @@ -38,21 +39,24 @@ export const MAX_LEVEL = 11; /** 預設鬼影關 = 預設最後一關 + 1(僅供 UI/參考;實際以 state.maxLevel+1 為準)。 */ export const GHOST_LEVEL = MAX_LEVEL + 1; -export function createGame(opts: { classType: ClassType; seed: number; maxLevel?: number }): GameState { +export function createGame(opts: { classType: ClassType; seed: number; maxLevel?: number; campaign?: Campaign }): GameState { let rng = makeRng(opts.seed); const created = createPlayer(opts.classType, rng, startingDeckFor(opts.classType)); rng = created.rng; const player = created.player; // 起手抽滿(戰士 5;野蠻人手牌恆滿亦為 5) rng = drawCards(player, rng, CLASS_INIT[opts.classType].handPerTurn, []); - // maxLevel 為除錯旋鈕:預設 11;帶 maxLevel:3 可秒到最後一關驗證破關/結算/鬼影串接。正式版維持 11。 - const maxLevel = opts.maxLevel && opts.maxLevel > 0 ? Math.floor(opts.maxLevel) : MAX_LEVEL; + const campaign: Campaign = opts.campaign ?? "slime"; + // maxLevel 為除錯旋鈕:預設史萊姆 11 / Sanctus 5;帶 maxLevel:3 可秒到最後一關驗證破關/結算。 + const defaultMax = campaign === "sanctus" ? SANCTUS_MAX_LEVEL : MAX_LEVEL; + const maxLevel = opts.maxLevel && opts.maxLevel > 0 ? Math.floor(opts.maxLevel) : defaultMax; return { level: 1, maxLevel, + campaign, phase: "PLAYER_TURN", player, - opponent: createMonster(), + opponent: campaign === "sanctus" ? createSanctus() : createMonster(), rng, turnLog: [], }; @@ -112,6 +116,7 @@ export function step(state: GameState, action: Action): StepResult { const res = playCard(next.player, next.rng, action.handIndex); next.rng = res.rng; events.push(...res.events); + if (res.ok) accrueCardEnergy(next.opponent); // Sanctus:玩家每 2 張牌 → 怪物 +1 能量 if (res.ok && next.player.specialWin) { // 蓄力 ×15 特殊勝利,優先於暫停/強制結束 next.phase = "VICTORY"; events.push({ type: "SPECIAL_WIN" }, { type: "VICTORY" }); @@ -220,12 +225,20 @@ function endTurnFlow(state: GameState, events: GameEvent[]): void { ghostBeginTurn(opp, (opp.ghost?.turnNo ?? 1) + 1); // 推進到下一回合攻防 } else { monsterResetForNextTurn(opp, buff); - const atkDealt = halveIfDebuffed(p, opp.atk); // 蠻荒震擊:敵下次攻擊減半 + const skillBonus = sanctusEnemyTurn(opp, events); // Sanctus:能量 +2、執行意圖(升盾 / 一次性攻擊加成)、預告下回合;非 Sanctus 回 0 + const atkDealt = halveIfDebuffed(p, opp.atk + skillBonus); // 蠻荒震擊:敵下次攻擊減半(含本回合技能加成) playerTakeDamage(p, atkDealt); if (opp.hasBloodlust && atkDealt > p.def) { opp.hp = Math.min(opp.maxHp, opp.hp + 3); // 吸血 } events.push({ type: "MONSTER_ATTACK", damage: atkDealt, hpAfter: p.hp }); + // Sanctus 審判:暫存反傷無視 DEF 直接扣 HP(無上限),於普攻後結算 + if (opp.pendingReflect && opp.pendingReflect > 0) { + p.hp -= opp.pendingReflect; + if (p.hp < 0) p.hp = 0; + events.push({ type: "MONSTER_REFLECT", damage: opp.pendingReflect, hpAfter: p.hp }); + opp.pendingReflect = 0; + } } } else { events.push({ type: "MONSTER_DEAD" }); @@ -283,9 +296,10 @@ function pickReward(state: GameState, choiceIndex: number, events: GameEvent[]): state.player.deck.push(cardId); events.push({ type: "REWARD_PICKED", cardId }); - // 推進下一關 + // 推進下一關(依路線升級:史萊姆數值放大 / Sanctus 解鎖技能 + 數值) state.level += 1; - upgradeMonsterForLevel(state.opponent, state.level); + if (state.campaign === "sanctus") upgradeSanctusForLevel(state.opponent, state.level); + else upgradeMonsterForLevel(state.opponent, state.level); initStates(state.player); checkCardUpgrades(state.player, events); // 進新關後補滿手牌至「已重置的」上限:修正上一關 應急(ADD_MAX_HAND -1) 殘留, diff --git a/packages/battle-core/src/foes.ts b/packages/battle-core/src/foes.ts new file mode 100644 index 0000000000000000000000000000000000000000..cf0ebd89f529fd81e4202bedf8c415cab7a9f041 --- /dev/null +++ b/packages/battle-core/src/foes.ts @@ -0,0 +1,206 @@ +/** + * Sanctus 路線(5 關)設定。史萊姆路線維持 opponent.ts 的 createMonster / upgradeMonsterForLevel。 + * + * 設計(13/14 設計團 + 平均輸出實測校正,見 scripts/class-output-sim.ts): + * - 審判 Judgment:玩家「原始 ATK」超過審判線 → 溢出 ½ 無視 DEF 反傷(**無上限**),下次怪物攻擊結算。 + * 審判線設在「高於戰士常態輸出(基礎 ~15、養成後 ~22)」,只懲罰刻意梭哈、不懲罰正常玩。 + * - Aegis 護盾:疊加吸收層;由能量技能升起(Phase 2)。 + * - 能量×技能×意圖:逐關解鎖(Phase 2)。 + */ +import type { GameEvent, OpponentState } from "./types.js"; + +/** 怪物技能(能量技能;資料驅動)。name/desc 供「意圖預告」與「地圖敵人詳情」顯示。 */ +export interface MonsterSkill { + id: string; + name: string; + desc: string; + icon: string; + cost: number; // 能量成本 + unlockLevel: number; // 第幾關解鎖 +} + +/** Sanctus 被動本體:審判(顯示用;實際結算在 opponentTakeDamage / endTurnFlow)。 */ +export const SANCTUS_PASSIVE = { + name: "聖裁(被動)", + icon: "⚖️", + desc: "你單一回合的攻擊力超過「審判線」時,超出部分的一半會無視你的防禦反噬到你身上,沒有上限。", +} as const; + +/** Sanctus 能量技能登錄表(逐關解鎖;數值好調)。 */ +export const SANCTUS_SKILLS: Record = { + aegis: { id: "aegis", name: "聖盾術", icon: "🛡️", cost: 3, unlockLevel: 1, desc: "升起聖盾,獲得護盾。護盾會吸收傷害,先於 HP 被扣掉。" }, + smite: { id: "smite", name: "聖光裁斬", icon: "✦", cost: 4, unlockLevel: 2, desc: "普攻追加一道聖光,本回合造成額外傷害。" }, + parry: { id: "parry", name: "格擋姿態", icon: "🛡", cost: 3, unlockLevel: 3, desc: "擺出格擋架式,下一回合防禦與護盾大幅提升。" }, + verdict: { id: "verdict", name: "裁決斬", icon: "⚔️", cost: 7, unlockLevel: 4, desc: "蓄力一記裁決重擊,預告後於下回合落下高額傷害。" }, + lastjudgment: { id: "lastjudgment", name: "神聖終審", icon: "☀️", cost: 10, unlockLevel: 5, desc: "降下神聖終審,造成大量傷害並同時升起聖盾。" }, +}; + +export interface SanctusLevelConfig { + hp: number; + def: number; + baseAtk: number; + aegisCap: number; + maxEnergy: number; + judgeLine: number; + intentDepth: number; // 一次預告幾步(前期 1、後期 boss 2) + skills: string[]; // 該關已習得的能量技能 id +} + +/** Sanctus 自己的 5 關曲線(數值錨定戰士每回合輸出,見上)。 */ +export const SANCTUS_LEVELS: readonly SanctusLevelConfig[] = [ + { hp: 28, def: 2, baseAtk: 5, aegisCap: 4, maxEnergy: 8, judgeLine: 18, intentDepth: 1, skills: ["aegis"] }, + { hp: 42, def: 3, baseAtk: 6, aegisCap: 6, maxEnergy: 8, judgeLine: 21, intentDepth: 1, skills: ["aegis", "smite"] }, + { hp: 58, def: 4, baseAtk: 7, aegisCap: 8, maxEnergy: 9, judgeLine: 24, intentDepth: 1, skills: ["aegis", "smite", "parry"] }, + { hp: 78, def: 5, baseAtk: 8, aegisCap: 10, maxEnergy: 10, judgeLine: 27, intentDepth: 2, skills: ["aegis", "smite", "parry", "verdict"] }, + { hp: 100, def: 6, baseAtk: 9, aegisCap: 12, maxEnergy: 10, judgeLine: 30, intentDepth: 2, skills: ["aegis", "smite", "parry", "verdict", "lastjudgment"] }, +] as const; + +export const SANCTUS_MAX_LEVEL = SANCTUS_LEVELS.length; + +const cfg = (level: number): SanctusLevelConfig => SANCTUS_LEVELS[Math.min(Math.max(level, 1), SANCTUS_MAX_LEVEL) - 1]!; + +/** 套用某關設定到 opponent(生成與升級共用)。HP 回滿、Aegis/能量歸零、技能依關卡解鎖。 */ +function applySanctusLevel(m: OpponentState, level: number): void { + const c = cfg(level); + m.maxHp = c.hp; + m.hp = c.hp; + m.baseAtk = c.baseAtk; + m.atk = c.baseAtk; + m.baseDef = c.def; + m.def = c.def; + m.aegisCap = c.aegisCap; + m.aegis = 0; + m.judgeLine = c.judgeLine; + m.pendingReflect = 0; + m.maxEnergy = c.maxEnergy; + m.energy = 0; + m.cardEnergyCounter = 0; + m.skills = c.skills.slice(); + m.intent = []; + m.intentDepth = c.intentDepth; + m.isAlive = true; +} + +/** 第 1 關 Sanctus。 */ +export function createSanctus(): OpponentState { + const m: OpponentState = { + kind: "monster", + name: "Sanctus", + hp: 0, + maxHp: 0, + atk: 0, + def: 0, + baseAtk: 0, + baseDef: 0, + growAtk: 1, // 同一關內每回合 ATK 微升(沿用既有 ResetForNextTurn 行為) + growHp: 0, + isAlive: true, + hasBloodlust: false, + hasHardening: false, + }; + applySanctusLevel(m, 1); + return m; +} + +/** 過關升級:套用新關卡的設定(HP 回滿、技能解鎖、數值上升)。 */ +export function upgradeSanctusForLevel(m: OpponentState, newLevel: number): void { + applySanctusLevel(m, newLevel); +} + +/** 某關 Sanctus 已習得的技能(含介紹),供地圖詳情面板顯示。 */ +export function sanctusSkillsForLevel(level: number): MonsterSkill[] { + return cfg(level).skills.map((id) => SANCTUS_SKILLS[id]).filter((s): s is MonsterSkill => Boolean(s)); +} + +/** 整條 Sanctus 路線會出現的全部技能(依解鎖關卡排序),供地圖詳情面板一覽。 */ +export function allSanctusSkills(): MonsterSkill[] { + return Object.values(SANCTUS_SKILLS).sort((a, b) => a.unlockLevel - b.unlockLevel); +} + +// ===== 能量 × 技能 × 意圖(執行)===== + +/** 是否為「能量技能型」怪物(目前=Sanctus;史萊姆/鬼影無 maxEnergy)。 */ +export function isSkillFoe(m: OpponentState): boolean { + return m.maxEnergy !== undefined; +} + +/** 玩家每出 2 張牌 → 怪物 +1 能量(封頂 maxEnergy)。在「成功出牌」後呼叫。 */ +export function accrueCardEnergy(m: OpponentState): void { + if (m.maxEnergy === undefined) return; + m.cardEnergyCounter = (m.cardEnergyCounter ?? 0) + 1; + if (m.cardEnergyCounter >= 2) { + m.cardEnergyCounter -= 2; + m.energy = Math.min(m.maxEnergy, (m.energy ?? 0) + 1); + } +} + +const clampAegis = (m: OpponentState, v: number): number => Math.min(m.aegisCap ?? 0, Math.max(0, v)); + +/** + * 執行單一技能(已扣能量)。防禦類(升盾/格擋)直接改 opp;攻擊類(聖光斬/裁決斬/終審) + * 回傳「本回合一次性攻擊加成」由呼叫端加進這回合普攻——不可直接改 m.atk,否則加成會永久累積 + * (monsterResetForNextTurn 只 += growAtk、不會把 atk 重置回 base)。 + */ +function applySanctusSkill(m: OpponentState, id: string, events: GameEvent[]): number { + let bonusAtk = 0; + switch (id) { + case "aegis": // 聖盾術:升盾 + m.aegis = clampAegis(m, (m.aegis ?? 0) + 4); + break; + case "parry": // 格擋姿態:本回合 DEF+3、護盾+3(守住下一次玩家攻擊,下個敵方回合 reset 才消) + m.def += 3; + m.aegis = clampAegis(m, (m.aegis ?? 0) + 3); + break; + case "smite": // 聖光裁斬:本回合普攻追加 ≈baseAtk + bonusAtk = m.baseAtk; + break; + case "verdict": // 裁決斬:預告後的重擊(本回合普攻 +baseAtk×2) + bonusAtk = m.baseAtk * 2; + break; + case "lastjudgment": // 神聖終審:大傷 + 升盾 + bonusAtk = m.baseAtk * 2; + m.aegis = clampAegis(m, (m.aegis ?? 0) + 6); + break; + default: + return 0; + } + const sk = SANCTUS_SKILLS[id]; + events.push({ type: "SKILL_USED", skill: id, name: sk ? sk.name : id }); + return bonusAtk; +} + +/** 規劃下回合意圖:在「目前能量」內,貪婪挑最貴可負擔的技能(至多 intentDepth 個),設為意圖(不立即扣能量)。 */ +function planSanctusIntent(m: OpponentState): void { + const depth = m.intentDepth ?? 1; + const owned = (m.skills ?? []).map((id) => SANCTUS_SKILLS[id]).filter((s): s is MonsterSkill => Boolean(s)); + owned.sort((a, b) => b.cost - a.cost); // 貴的優先 + let budget = m.energy ?? 0; + const picked: string[] = []; + for (const s of owned) { + if (picked.length >= depth) break; + if (budget >= s.cost) { + picked.push(s.id); + budget -= s.cost; + } + } + m.intent = picked; +} + +/** + * Sanctus 敵方回合(在 monsterResetForNextTurn 之後、普攻結算之前呼叫): + * 1) 回合能量 +2;2) 執行上回合預告的意圖(扣能量、套效果,可能加普攻/升盾);3) 規劃並預告下回合意圖。 + * 攻擊型技能(smite/verdict/終審)會墊高 m.atk,緊接著的普攻就會把加成一起打出去。 + */ +export function sanctusEnemyTurn(m: OpponentState, events: GameEvent[]): number { + if (m.maxEnergy === undefined) return 0; + m.energy = Math.min(m.maxEnergy, (m.energy ?? 0) + 2); // 回合能量 + let bonusAtk = 0; + for (const id of m.intent ?? []) { + const sk = SANCTUS_SKILLS[id]; + if (!sk || (m.energy ?? 0) < sk.cost) continue; // 付不起就略過 + m.energy = (m.energy ?? 0) - sk.cost; + bonusAtk += applySanctusSkill(m, id, events); + } + planSanctusIntent(m); // 預告下回合 + return bonusAtk; +} diff --git a/packages/battle-core/src/index.ts b/packages/battle-core/src/index.ts index 74851503c6bea52a3acbc76d5024c508a96f0d1e..56d67094e42b96a18694274c0746bccdcbe07ba8 100644 --- a/packages/battle-core/src/index.ts +++ b/packages/battle-core/src/index.ts @@ -56,6 +56,18 @@ export { buildGhostRecord, createGhostOpponent, } from "./opponent.js"; +export { + SANCTUS_SKILLS, + SANCTUS_PASSIVE, + SANCTUS_LEVELS, + SANCTUS_MAX_LEVEL, + sanctusSkillsForLevel, + allSanctusSkills, + createSanctus, + upgradeSanctusForLevel, + type MonsterSkill, + type SanctusLevelConfig, +} from "./foes.js"; export { PVP_DRAFT_PLAN, PVP_DRAFT_PICKS, @@ -68,3 +80,5 @@ export { type DraftTier, } from "./pvpDraft.js"; export { knifeProgress, type KnifeProgress } from "./progress.js"; +export { previewPlayHpCost } from "./player.js"; +export { cleanHeroName, containsProfanity, basicClean, HERO_NAME_MAX, HERO_NAME_FALLBACK } from "./nameFilter.js"; diff --git a/packages/battle-core/src/nameFilter.ts b/packages/battle-core/src/nameFilter.ts new file mode 100644 index 0000000000000000000000000000000000000000..31f3ce854a57f22f5903f49468a0e884e0d2de6d --- /dev/null +++ b/packages/battle-core/src/nameFilter.ts @@ -0,0 +1,141 @@ +/** + * 勇者名字過濾(鬼影 meta.heroName 用)。零相依、決定性,前後端共用。 + * + * 設計(經對抗式稽核強化): + * - basicClean:NFKC、去零寬/控制字元、collapse 空白、截長 16 → 「顯示用」字串(保留原文字母系,如俄文名)。 + * - containsProfanity:先 fold(NFKD 去重音 + 同形字摺疊 + leet 還原 + ph→f)成 ascii/CJK 偵測字串, + * 英文用「詞邊界 + 容許字母間分隔/重複」的正則(避免 Matsushita/Scunthorpe 之類子字串誤殺, + * 同時擋 "f u c k" / "fück" / "fuсk(西里爾)" / "shiit");中文用「去重複後子字串」比對(含簡繁/知名同音)。 + * - 命中 → 回退「無名勇者」。空字串 → ""(未命名)。 + * + * 安全模型:客戶端可被繞過,**伺服器才是權威過濾點**(server.ts 上傳時 + repository 入庫/載入時)。 + * 清單為「起始集」、可擴充;偵測只跑在「清理後(≤16 字)」字串上,天然界定 ReDoS 與避免截斷誤判。 + * 已知殘留(語意級難解,接受):未列入的中文同音/拆字。 + * 實作注意:所有正則一律用 ASCII 原始碼(\u 跳脫 / code-point 過濾),避免字面不可見字元造成隱性 bug。 + */ + +export const HERO_NAME_MAX = 16; +export const HERO_NAME_FALLBACK = "無名勇者"; + +/** 英文敏感詞(fold 後比對;以詞邊界錨定,故可放含常見字根者,誤殺由白名單兜底)。 */ +const BANNED_ASCII: string[] = [ + "fuck", "motherfuck", "fvck", "fxck", "shit", "bullshit", "dipshit", "bitch", "cunt", + "asshole", "dickhead", "pussy", "bastard", "whore", "slut", "nigger", "nigga", "faggot", + "retard", "jackass", "wank", "bollocks", "cocksuck", "twat", +]; + +/** 中文敏感詞(去重複後子字串比對;多字詞優先、含簡繁與知名同音,降低單字誤殺)。 */ +const BANNED_CJK: string[] = [ + "幹你娘", "幹妳娘", "幹你媽", "幹妳媽", "操你媽", "操你娘", "操你妈", + "干你娘", "干妳娘", "干你媽", "干你妈", "媽的", "妈的", "他媽", "他妈", "你媽死", "死全家", + "雞掰", "機掰", "鸡掰", "机掰", "雞巴", "鸡巴", "靠北", "靠腰", "靠杯", "婊子", + "賤人", "贱人", "賤貨", "贱货", "妓女", "屌你", "草泥馬", "草泥马", + "肏", "屄", "屌", "婊", "妓", +]; + +/** 整個名字「剛好等於」這些單字才擋(避免 幹勁/操作/才幹 等正常詞誤殺)。 */ +const EXACT_CJK = new Set(["幹", "操", "干", "屌", "婊", "妓", "肏", "屄"]); + +/** 已知良性詞(含敏感子字串),整名相符即放行(修正 Scunthorpe 類誤殺)。 */ +const ALLOWLIST = new Set([ + "scunthorpe", "cunthorpe", "matsushita", "ashitaka", "shitao", "shitake", "mishit", + "lightwater", "twatt", "wankel", "slutsky", "bastardo", "faggotini", "retardant", + "retardation", "niggard", "niggardly", "snigger", "sniggering", "pussycat", "pussyfoot", + "pussywillow", "whoreson", "shiitake", "dickson", "cassandra", +]); + +/** leet / 同形數字符號 → 字母。 */ +const LEET: Record = { + "0": "o", "1": "i", "3": "e", "4": "a", "5": "s", "7": "t", "8": "b", + "@": "a", "$": "s", "!": "i", "|": "i", +}; + +/** 同形字(西里爾/希臘/土耳其無點 i/帶斜線等)→ 拉丁小寫。重音類由 NFKD 去組合符號處理。 */ +const CONFUSABLES: Record = { + // 西里爾 + "а": "a", "в": "b", "е": "e", "ё": "e", "к": "k", "м": "m", "н": "h", "о": "o", "р": "p", + "с": "c", "т": "t", "у": "y", "х": "x", "ѕ": "s", "і": "i", "ј": "j", "ԁ": "d", "ѵ": "v", "ў": "y", + // 希臘 + "α": "a", "β": "b", "ε": "e", "η": "n", "ι": "i", "κ": "k", "μ": "u", "ν": "v", "ο": "o", + "ρ": "p", "σ": "s", "ς": "s", "τ": "t", "υ": "u", "χ": "x", "γ": "y", "ω": "w", + // 其他拉丁同形 + "ı": "i", "ø": "o", "đ": "d", "ł": "l", "ƒ": "f", "ɢ": "g", "ɪ": "i", "ϲ": "c", +}; + +/** 不可見字元碼位:零寬空白~不連接、word-joiner、BOM、軟連字號。 */ +const INVISIBLE_CP = new Set([0x200b, 0x200c, 0x200d, 0x2060, 0xfeff, 0x00ad]); + +/** 去不可見字元(code-point 過濾,避免字面不可見字元)。 */ +function stripInvisible(s: string): string { + let out = ""; + for (const ch of s) if (!INVISIBLE_CP.has(ch.codePointAt(0)!)) out += ch; + return out; +} + +/** 去 C0/C1 控制字元(0x00–0x1F 與 0x7F),保留空白(0x20)。 */ +function stripControl(s: string): string { + let out = ""; + for (const ch of s) { + const c = ch.codePointAt(0)!; + if (c > 0x1f && c !== 0x7f) out += ch; + } + return out; +} + +/** 顯示用清理:NFKC、去零寬/控制字元、collapse 空白、截長。 */ +export function basicClean(raw: string): string { + let s = (raw ?? "").normalize("NFKC"); + s = stripInvisible(s); + s = stripControl(s); + s = s.replace(/\s+/g, " ").trim(); // collapse 空白 + if (s.length > HERO_NAME_MAX) s = s.slice(0, HERO_NAME_MAX); + return s; +} + +/** 偵測用摺疊:小寫、NFKD 去重音、去零寬、同形字→拉丁、leet 還原、ph→f。保留空白/標點/CJK(分隔由正則處理)。 */ +function fold(raw: string): string { + let t = (raw ?? "").normalize("NFKD").toLowerCase(); + t = t.replace(/[̀-ͯ]/g, ""); // 去組合附加符號 → ü/ç/é → u/c/e + t = stripInvisible(t); + t = Array.from(t).map((ch) => CONFUSABLES[ch] ?? ch).join(""); // 同形字 → 拉丁 + t = t.replace(/[0134578@$!|]/g, (c) => LEET[c] ?? c); // leet + t = t.replace(/ph/g, "f"); // phuck → fuck + return t; +} + +/** 字母間容許的分隔(非英數;破解 "f u c k" / "f.u.c.k")。 */ +const SEP = "[^a-z0-9]*"; +/** 由敏感詞建字邊界正則:每字母可重複(破解 "shiit")、字母間可夾分隔。前置 \b 防詞中誤殺。 */ +const ASCII_PATTERNS: RegExp[] = BANNED_ASCII.map( + (w) => new RegExp("\\b" + Array.from(w).map((c) => c.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + "+").join(SEP)), +); + +const NON_TOKEN = /[^a-z0-9一-鿿]/g; // 去分隔(保留英數與 CJK) +const CJK_REPEAT = /([一-鿿])\1+/g; // 收合 CJK 連續重複 + +/** 是否含敏感詞(已處理大小寫/空白/標點/leet/重複/同形字/簡繁/部分同音)。 */ +export function containsProfanity(raw: string): boolean { + const folded = fold(raw).slice(0, 256); // 界定 ReDoS + const compact = folded.replace(NON_TOKEN, ""); + if (ALLOWLIST.has(compact)) return false; // 整名為已知良性詞 → 放行 + for (const re of ASCII_PATTERNS) if (re.test(folded)) return true; + const cjk = compact.replace(CJK_REPEAT, "$1"); // 破解 幹你你娘 + for (const w of BANNED_CJK) if (cjk.includes(w)) return true; + if (EXACT_CJK.has(cjk)) return true; // 整名剛好是單字髒字 + return false; +} + +/** + * 清理勇者名字 → 安全顯示名稱。 + * - 空/全空白 → ""(未命名)。 + * - 含敏感詞 → "無名勇者"。 + * - 其餘 → 清理後(截長 16、去控制/零寬字元、collapse 空白)。 + * + * 偵測只跑在「清理後字串」:天然 ≤16 字(界定 ReDoS),且避免「截斷後不顯示的內容」造成誤判。 + */ +export function cleanHeroName(raw: string): string { + const cleaned = basicClean(raw); + if (!cleaned) return ""; + if (containsProfanity(cleaned)) return HERO_NAME_FALLBACK; + return cleaned; +} diff --git a/packages/battle-core/src/opponent.ts b/packages/battle-core/src/opponent.ts index a4ff1bd8d0d141c8bcf18fd8848bc69136a3cbe0..0015a6c261a6a9e555d5df8cacd2345e930884d9 100644 --- a/packages/battle-core/src/opponent.ts +++ b/packages/battle-core/src/opponent.ts @@ -54,8 +54,18 @@ export function upgradeMonsterForLevel(m: OpponentState, newLevel: number): void /** 對手受玩家傷害(01 §5.2)。回傳實際扣血量。 */ export function opponentTakeDamage(m: OpponentState, damage: number): number { - let actual = Math.max(0, damage - m.def); - if (m.hasHardening && actual > 35) actual = 35; // 硬化:單次受傷上限 35 + // 審判(Sanctus):用「未經任何減免的原始傷害」判定;溢出審判線 ½(無條件進位)無視 DEF 反傷、無上限, + // 暫存於 pendingReflect,待怪物下次攻擊時直接扣玩家 HP。 + if (m.judgeLine !== undefined && damage > m.judgeLine) { + m.pendingReflect = (m.pendingReflect ?? 0) + Math.ceil((damage - m.judgeLine) / 2); + } + let actual = Math.max(0, damage - m.def); // 先扣 DEF + if (m.aegis !== undefined && m.aegis > 0) { // 再由 Aegis 護盾吸收,剩餘才進 HP + const absorbed = Math.min(m.aegis, actual); + m.aegis -= absorbed; + actual -= absorbed; + } + if (m.hasHardening && actual > 35) actual = 35; // 硬化:單次受傷上限 35(順序:DEF → Aegis → 硬化) m.hp -= actual; if (m.hp < 0) m.hp = 0; if (m.hp === 0) m.isAlive = false; @@ -95,21 +105,31 @@ export function createGhostRuntime(turns: { atk: number; def: number }[]): Ghost }; } -/** 鬼影第 n 回合(n 從 1)的攻防(01 §9 / 04 §4)。 */ +/** + * 鬼影第 n 回合(n 從 1)的攻防(01 §9 / 04 §4)。 + * - `n ≤ k`:照抄紀錄那一回合。 + * - `n > k`(紀錄用完):ATK 隨回合外推遞增(`avgAtk + n`),製造「越打越痛、逼速戰」的壓力; + * 但 DEF 維持在固定平均(`avgDef`),**不**隨 n 無限上升。 + * 理由:若 DEF 也用 `avgDef + n`,鬼影防禦會每回合 +1 直到超過玩家攻擊力 → 玩家一點傷害都打不進去, + * 鬼影成為「永遠打不死」的無敵怪;且那是紀錄裡從未出現過的合成數值(玩家會看到「顯然不可能是過 11 關的人 + * 打出來的」防禦值)。逼速戰的壓力交給 ATK 即可,DEF 不該爆走(原 spec 對稱外推 DEF 為設計疏漏)。 + */ export function ghostTurnValues(g: GhostRuntime, n: number): { atk: number; def: number } { const k = g.turns.length; if (n <= k) { const t = g.turns[n - 1]!; return { atk: t.atk, def: t.def }; } - return { atk: g.avgAtk + n, def: g.avgDef + n }; + return { atk: g.avgAtk + n, def: g.avgDef }; } /** 由破關後的 GameState 打包鬼影存檔(04 §4;不含 id,由伺服器產生)。 */ export function buildGhostRecord( state: GameState, - opts?: { seed?: number; actions?: Action[]; createdAt?: string; deckFinal?: number[] }, + opts?: { seed?: number; actions?: Action[]; createdAt?: string; deckFinal?: number[]; heroName?: string }, ): GhostRecord { + // heroName 僅在非空時寫入(呼叫端應先過濾;伺服器上傳時會再權威過濾一次)。 + const heroName = opts?.heroName && opts.heroName.length > 0 ? opts.heroName : undefined; return { playerMaxHp: state.player.maxHp, turns: state.turnLog.map((t) => ({ atk: t.atk, def: t.def })), @@ -117,7 +137,7 @@ export function buildGhostRecord( actions: opts?.actions, ruleVersion: RULE_VERSION, cardsHash: CARDS_HASH, - meta: { classType: "WARRIOR", createdAt: opts?.createdAt, deckFinal: opts?.deckFinal }, + meta: { classType: "WARRIOR", createdAt: opts?.createdAt, deckFinal: opts?.deckFinal, heroName }, }; } @@ -134,7 +154,8 @@ export function ghostBeginTurn(opp: OpponentState, turnNo: number): void { export function createGhostOpponent(record: GhostRecord): OpponentState { return { kind: "ghost", - name: "Ghost", + name: record.meta?.heroName || "Ghost", // 第 12 關顯示鬼影主人的勇者名字(伺服器已過濾) + hp: record.playerMaxHp, maxHp: record.playerMaxHp, atk: 0, diff --git a/packages/battle-core/src/player.ts b/packages/battle-core/src/player.ts index 07f1b8e2a3bd6e6dfb68804eb0bd3d84f6f79f0e..b0e5ef8a29dc16eb84a878fcaeb165812ce37070 100644 --- a/packages/battle-core/src/player.ts +++ b/packages/battle-core/src/player.ts @@ -8,7 +8,7 @@ import { CLASS_INIT } from "./classes.js"; import { getCard, STARTING_DECK, UPGRADE_BLOOD_TO_ULTIMATE, UPGRADE_BROKEN_TO_BLOOD } from "./cards.js"; import { endCombo, runOps, gainDef, evalCondPlayer, healOnCarnage, type EffectCtx } from "./effects.js"; import { drawCards, setOnDrawResolver, applyOnDraw } from "./deck.js"; -import { shuffle } from "./rng.js"; +import { shuffle, makeRng } from "./rng.js"; import { getOppHp } from "./opponent.js"; /** 戰士初始值(向後相容;= CLASS_INIT.WARRIOR)。 */ @@ -178,11 +178,18 @@ export function playCard( // 自傷:扣 max(0,n) 點 HP(無視 DEF;死亡於回合末判定)。野性先手可豁免本次;放手一搏(本回合 dec 模式) // 一律不扣血——含放手一搏本身與其後所有出牌(「不再扣血」自打出當下生效)。註:此為「被動出牌自傷」, // 卡牌自身明寫的代價(無腦傾瀉「額外受到 n」、血誓「-8」)屬該卡效果,不在此豁免。 - const selfDmg = player.suppressSelfDmgThisPlay || player.nMode === "dec" ? 0 : Math.max(0, player.n); + // 出牌結算:n>0 扣血、n<0 回血(野性先手「n 為負視為回血」);放手一搏 dec 模式或 SUPPRESS_SELFDMG 時為 0。 + const rawN = player.suppressSelfDmgThisPlay || player.nMode === "dec" ? 0 : player.n; player.suppressSelfDmgThisPlay = false; + const selfDmg = Math.max(0, rawN); // 真正失血(只計正值;供計數/反傷/反刃引用) + const selfHeal = Math.max(0, -rawN); // 負 n → 回血(夾 effMax) const hpBefore = player.hp; player.hp -= selfDmg; if (player.hp < 0) player.hp = 0; + if (selfHeal > 0) { + player.hp = Math.min(player.maxHp + player.tempMaxHp, player.hp + selfHeal); + events.push({ type: "HEAL", amount: selfHeal, hpAfter: player.hp }); + } player.hpLostThisTurn += selfDmg; // 打擊:本回合因出牌失去的血 player.persist.savageTrial += selfDmg; // 蠻性試煉:跨戰累積「因出牌(被動)所受傷害」 if (player.flags.反傷) player.trueDamage += selfDmg; // 痛苦共鳴/血腥連結:扣血 → 敵等量真實傷害 @@ -388,12 +395,14 @@ export function resolveChoice( } /** - * 死亡前的凝視:hp≤0 且已武裝 → 復活至 effMax×fraction、永久移除本卡(183,連消耗堆都不留)。 - * 回 true 表示有復活。單人引擎與 PvP 結算共用同一套(避免邏輯分歧)。 + * 死亡前的凝視:hp≤0 且已武裝 → 臨時生命 1:1 轉永久 maxHp、再以 maxHp×fraction(現 1.0=滿血)復活、 + * 永久移除本卡(183,連消耗堆都不留)。回 true 表示有復活。單人引擎與 PvP 結算共用同一套(避免邏輯分歧)。 */ export function reviveIfArmed(p: PlayerState, events: GameEvent[]): boolean { if (p.hp > 0 || !p.reviveArmed) return false; - p.hp = Math.max(1, Math.floor((p.maxHp + p.tempMaxHp) * p.reviveFraction)); + p.maxHp += p.tempMaxHp; // 死亡前的凝視:臨時生命 1:1 全數轉為永久生命 + p.tempMaxHp = 0; + p.hp = Math.max(1, Math.floor(p.maxHp * p.reviveFraction)); // fraction=1.0 → 以總生命滿血復活 p.reviveArmed = false; const bi = p.burn.indexOf(183); if (bi >= 0) p.burn.splice(bi, 1); @@ -420,6 +429,12 @@ export function onDealDamage(player: PlayerState, opponent: OpponentState, event player.flags.生命汲取 = false; events.push({ type: "HEAL", amount: heal, hpAfter: player.hp }); } + if (player.flags.終極一擊) { + // 終極一擊 處決(01 §5.4):本次出傷額外 += 怪物當前 HP → 等同斬殺。 + // 必須在「出傷時」結算才生效(舊版誤在回合末 onTurnEndResolve 才加 ATK,已扣血後才補、隨即被重置清掉 → 處決失效)。 + dmg += getOppHp(opponent); + player.flags.終極一擊 = false; + } // 註:卡26 已改用「失控侵蝕」機制(鎖 DEF=0 + DEF→ATK),原「狂戰士之魂 出傷歸零 DEF」已被取代而移除。 return dmg; } @@ -437,11 +452,8 @@ export function onTurnEndResolve(player: PlayerState, opponent: OpponentState): if (player.flags.餘裕 && player.coin > 0) { player.hp += 5; player.maxHp += 5; - } else if (player.flags.終極一擊) { - // 01 §5.4 忠實:此處在「已扣血之後」加 ATK,且隨即被 §5.6 重置清掉。 - // 屬原版疑似 quirk(處決實際不生效),1:1 還原並由測試釘死;見回報。 - player.atk += getOppHp(opponent); } + // 終極一擊「處決」已改於 onDealDamage(出傷當下)結算 → 真正斬殺;不再於回合末事後加 ATK(該寫法處決不生效)。 player.flags.餘裕 = false; player.flags.終極一擊 = false; } @@ -605,3 +617,30 @@ function tryUpgrade( } // 找不到舊卡:保留計數,待該卡再次出現時升級。 } + +/** + * 預覽「現在打出手牌第 handIndex 張」會讓自己損失多少 HP(野蠻人被動 n 自傷 + 卡面自身扣血代價)。 + * 純供 UI 顯示:在 player 的複本上跑一次「真正的」playCard 量測 hp 落差,因此與實際出牌邏輯零偏差 + * ——自動涵蓋 +1 進位(n 先 +1 才結算自傷)、千刀萬剮 ADD_N、無腦傾瀉 ADD_HP(-n) 等所有情況。 + * + * - 複本牌庫/棄牌清空:排除「補抽到『專注』回血」這種玩家看不到、又會稀釋代價的隱藏治療 → 顯示保守的「淨自傷」。 + * - 若代價 ≥ 目前 HP,self-damage 會把 hp 夾到 0,回傳值即等於目前 HP(代表「打了就死」),這正是要警示的紅線。 + * + * 回傳 HP 損失(>= 0);非野蠻人(戰士無此被動)或該牌當下不可打出(如狂怒 HP 不足)則回傳 null。 + */ +export function previewPlayHpCost( + player: PlayerState, + handIndex: number, + mode: "single" | "pvp" = "single", +): number | null { + if (CLASS_INIT[player.classType].hasCoinGate) return null; // 戰士走硬幣/連擊路徑,無「出牌自傷」被動 + if (handIndex < 0 || handIndex >= player.hand.length) return null; + const clone: PlayerState = JSON.parse(JSON.stringify(player)); // 深複本:所有變動只發生在複本上 + clone.deck = []; + clone.discard = []; // 補抽抽不到牌(不觸發專注回血)→ 量到的是純自傷代價 + const hpBefore = clone.hp; + const res = playCard(clone, makeRng(1), handIndex, mode); // 固定種子:RANDOM_DISCARD 等隨機只落在複本,不影響 hp 量測 + if (!res.ok) return null; // 條件不符 → 不顯示代價 + const cost = hpBefore - clone.hp; + return cost > 0 ? cost : 0; +} diff --git a/packages/battle-core/src/types.ts b/packages/battle-core/src/types.ts index 327826e7b9ba28555b2242b317d3b3ec1ad83c96..bdd9464b1ce2557a918e0b97729927c0cb6353d7 100644 --- a/packages/battle-core/src/types.ts +++ b/packages/battle-core/src/types.ts @@ -121,7 +121,7 @@ export type EffectOp = | { op: "SPECIAL_WIN_CHECK"; cond: CondExpr } // 條件成立 → 特殊勝利(蓄力 ×15) | { op: "ARM_REVIVE"; fraction: number } // 死亡前的凝視:本回合若死亡,復活至 effMaxHp × fraction(一次性) | { op: "SET_HP"; value: ValueExpr } // Inverse:直接設定 HP(夾 [0, effMaxHp]) - | { op: "ANNIHILATE"; token: number; moveCount: number; tokenCount: number; position: "top" | "bottom" } // 萬象寂滅:棄牌堆隨機 moveCount 張進消耗堆,於牌庫 position 生成 tokenCount 個 token + | { op: "ANNIHILATE"; moveCount: number } // 萬象寂滅:棄牌堆隨機 moveCount 張進消耗堆(token 由卡片另接 SHUFFLE_TOKEN) | { op: "RANDOM_DISCARD"; count: ValueExpr } // 隨機棄掉手牌 count 張(盲目亂揮/本能閃避) | { op: "DISCARD_HAND" } // 棄掉全部手牌(無腦傾瀉/雜念絕殺;打出的牌已先移出手牌) | { op: "BUFF_NEXT_ATTACK"; mult?: number; bonus?: number; self?: boolean } // 下一張攻擊卡:傷害 ×mult / +bonus(咆哮/專注湧現);self=改為攻擊自己(無盡怒火) @@ -149,7 +149,7 @@ export interface CardModeOverride { } export interface CardData { - id: number; // 戰士 0..40(對應 resources/.png);野蠻人 100+(白底文字卡、無圖) + id: number; // 戰士 0..40(對應 resources/cards/.png);野蠻人 100+(白底文字卡、無圖) /** 所屬職業(各職業卡牌獨立、不可混用);省略 = WARRIOR(相容既有 41 張)。 */ classType?: ClassType; name: string; @@ -166,7 +166,7 @@ export interface CardData { isToken?: boolean; /** 衍生卡:不進卡池(獎勵/draft),只由效果生成。 */ derived?: boolean; - /** 抽到即自動釋放的效果(專注:抽到 +1 臨時上限;不計入出牌 n);釋放後本卡進消耗堆。 */ + /** 抽到即自動釋放的效果(專注:抽到 +2 臨時上限;不計入出牌 n);釋放後本卡進消耗堆。 */ onDraw?: EffectOp[]; /** 出牌前置條件(不滿足則無法打出);狂怒:HP<30% 才能打。 */ playableIf?: CondExpr; @@ -285,10 +285,24 @@ export interface OpponentState { isAlive: boolean; hasBloodlust: boolean; // 吸血:本次傷害 > player.DEF → 怪物 HP+3 hasHardening: boolean; // 硬化:單次受傷上限 35 + // ===== Sanctus(能量×技能×意圖系統):其餘怪物(史萊姆/鬼影)這些欄位留空=不啟用 ===== + aegis?: number; // 當前護盾(疊加吸收層,先扣 DEF 再由護盾吸收,剩餘才進 HP) + aegisCap?: number; // 護盾上限 + judgeLine?: number; // 審判線:玩家「原始 ATK」超過此值 → 溢出 ½ 無視 DEF 反傷(無上限) + pendingReflect?: number; // 暫存反傷,於下次怪物攻擊時無視 DEF 直接扣玩家 HP + energy?: number; // 能量(放技能用) + maxEnergy?: number; // 能量上限(滿 10) + cardEnergyCounter?: number; // 玩家每出 2 張牌 → +1 能量的計數器 + skills?: string[]; // 已習得技能 id(逐關解鎖) + intent?: string[]; // 已規劃的下幾步技能 id(意圖預告) + intentDepth?: number; // 一次預告幾步(前期 1、後期 boss 2) /** 鬼影出招資料(kind==="ghost" 時存在)。 */ ghost?: GhostRuntime; } +/** 單人路線:史萊姆 11 關(經典、無技能)/ Sanctus 5 關(能量×技能×意圖系統)。 */ +export type Campaign = "slime" | "sanctus"; + export interface GhostRuntime { turns: { atk: number; def: number }[]; avgAtk: number; // 用 k 筆固定算出,不隨外推變動 @@ -305,7 +319,7 @@ export interface GhostRecord { actions?: Action[]; // 完整動作序列(後端可重算驗證) ruleVersion: string; // 規則版本(B-4,版本不符則降級不校驗) cardsHash: string; // 卡表指紋(B-4) - meta?: { createdAt?: string; classType: ClassType; deckFinal?: number[] }; + meta?: { createdAt?: string; classType: ClassType; deckFinal?: number[]; heroName?: string }; } export type BattlePhase = @@ -338,7 +352,8 @@ export interface PendingChoice { export interface GameState { level: number; // 1..maxLevel(破關後 maxLevel+1 = 鬼影關) - maxLevel: number; // 最後一關關卡數(預設 11;除錯可覆寫)。IsOnFinalLevel = level === maxLevel + maxLevel: number; // 最後一關關卡數(史萊姆 11;Sanctus 5;除錯可覆寫)。IsOnFinalLevel = level === maxLevel + campaign: Campaign; // 單人路線:史萊姆 / Sanctus phase: BattlePhase; player: PlayerState; opponent: OpponentState; @@ -380,6 +395,8 @@ export type GameEvent = | { type: "MONSTER_TAKE_DAMAGE"; actual: number; hpAfter: number } | { type: "MONSTER_DEAD" } | { type: "MONSTER_ATTACK"; damage: number; hpAfter: number } + | { type: "MONSTER_REFLECT"; damage: number; hpAfter: number } // Sanctus 審判:無視 DEF 的反傷 + | { type: "SKILL_USED"; skill: string; name: string } // Sanctus 施展能量技能 | { type: "HEAL"; amount: number; hpAfter: number } | { type: "CARD_UPGRADED"; from: number; to: number } | { type: "REVIVE"; hpAfter: number } // 死亡前的凝視:復活 diff --git a/packages/battle-core/src/version.ts b/packages/battle-core/src/version.ts index a18b0b3a19a1776c79cdb9efb9b0b4f34496921e..ea51f2ed22d3c09ae141e63ab1a590d9a2b20fa9 100644 --- a/packages/battle-core/src/version.ts +++ b/packages/battle-core/src/version.ts @@ -5,7 +5,7 @@ import { CARDS } from "./data/cards.js"; /** 規則引擎版本。卡表或 EffectOp 語意變更時手動 bump。 */ -export const RULE_VERSION = "1.2.0"; // 1.2.0: 野蠻人全卡完成(id 100-191)— n鎖定/遞減、探牌、卡牌增益、跨戰計數(savageTrial/divinity)、變形鏈、特殊勝利(蓄力×15)、復活、Inverse、殲滅、本場旗標(地獄之門/狂神開眼/反刃血鎧)。1.1.0: 職業框架 + 野蠻人(n/手牌恆滿/無DEF) +export const RULE_VERSION = "1.4.0"; // 1.4.0: 野蠻人卡調整——野性先手(傷害15→12、首張 n→-2、負 n 視為回血)、死亡前的凝視(臨時生命 1:1 轉永久 + 100% 復活)、萬象寂滅(10 專注改洗入棄牌堆而非牌庫頂)。1.3.0: 專注臨時上限 +1→+2;命運之路的抉擇(25)取消焚燒(改洗回棄牌堆);終極一擊(35)處決改於出傷當下結算(真正斬殺,修正原本回合末才加ATK而失效的quirk);戰士全卡(0-40)補上效果敘述 desc(顯示用,不影響規則)。1.2.0: 野蠻人全卡完成(id 100-191)— n鎖定/遞減、探牌、卡牌增益、跨戰計數(savageTrial/divinity)、變形鏈、特殊勝利(蓄力×15)、復活、Inverse、殲滅、本場旗標(地獄之門/狂神開眼/反刃血鎧)。1.1.0: 職業框架 + 野蠻人(n/手牌恆滿/無DEF) /** FNV-1a 32-bit,對卡表 JSON 取穩定指紋。 */ function fnv1a(s: string): string { diff --git a/packages/battle-core/test/barbarian.test.ts b/packages/battle-core/test/barbarian.test.ts index ee3f7abe7a3f5bd100844d6cdfd2d705b58f9d10..e840bdb308d31370fe3a588475bdee5ae86ea738 100644 --- a/packages/battle-core/test/barbarian.test.ts +++ b/packages/battle-core/test/barbarian.test.ts @@ -79,14 +79,14 @@ describe("野蠻人 play 機制(P1:n / 手牌恆滿 / 無 DEF / 無閘門) expect(p.discard.filter((x) => x === 110).length).toBe(2); }); - it("P3 專注抽到即釋放:臨時上限 +1、進消耗堆、不入手牌、不佔抽牌數", () => { + it("P3 專注抽到即釋放:臨時上限 +2、進消耗堆、不入手牌、不佔抽牌數", () => { const { player: p, rng } = createPlayer("BARBARIAN", makeRng(1), []); p.hp = 100; p.hand = []; p.deck = [100, 110, 100]; // 中間是專注 drawCards(p, rng, 5, []); expect(p.hand.length).toBe(2); // 兩張 100 入手;專注不入手、補抽 expect(p.hand).not.toContain(110); - expect(p.tempMaxHp).toBe(1); // 釋放 +1 - expect(p.hp).toBe(101); // 回 1 + expect(p.tempMaxHp).toBe(2); // 釋放 +2 + expect(p.hp).toBe(102); // 回 2 expect(p.burn).toContain(110); // 釋放後進消耗堆 }); @@ -102,7 +102,7 @@ describe("野蠻人 play 機制(P1:n / 手牌恆滿 / 無 DEF / 無閘門) const { player: p, rng } = createPlayer("BARBARIAN", makeRng(1), []); p.hand = [105]; p.deck = []; p.discard = [110, 110]; playCard(p, rng, 0); - expect(p.tempMaxHp).toBe(2); // 2 專注釋放各 +1 + expect(p.tempMaxHp).toBe(4); // 2 專注釋放各 +2 expect(p.burn.filter((x) => x === 110).length).toBe(2); expect(p.discard.filter((x) => x === 110).length).toBe(0); }); @@ -318,20 +318,20 @@ describe("野蠻人 P7b:n 鎖定 / n 模式 / 探牌 / 卡牌增益 / 豁免 / expect(p.hp).toBe(94); // 96 -2 }); - it("野性先手:首張(n==1)不扣血;非首張 n 額外 +1", () => { + it("野性先手:首張(n==1) n 變 -2 並回血;非首張 n 額外 +1", () => { const a = createPlayer("BARBARIAN", makeRng(1), []); - a.player.hp = 100; a.player.hand = [165]; a.player.deck = Array(10).fill(106); - playCard(a.player, a.rng, 0); // 首張:suppress - expect(a.player.atk).toBe(15); - expect(a.player.hp).toBe(100); // 不扣血 - expect(a.player.n).toBe(1); + a.player.hp = 100; a.player.hand = [165]; a.player.deck = Array(10).fill(106); // maxHp 130 + playCard(a.player, a.rng, 0); // 首張:n→1→SET_N -2;負 n 回血 2 + expect(a.player.atk).toBe(12); + expect(a.player.hp).toBe(102); // 100 +2(負 n 回血) + expect(a.player.n).toBe(-2); const b = createPlayer("BARBARIAN", makeRng(1), []); b.player.hp = 100; b.player.hand = [106, 165]; b.player.deck = Array(10).fill(106); let r = playCard(b.player, b.rng, 0); // 106 n=1 hp99 playCard(b.player, r.rng, b.player.hand.indexOf(165)); // 165 n=2→+1=3 expect(b.player.n).toBe(3); - expect(b.player.atk).toBe(22); // 7 + 15 + expect(b.player.atk).toBe(19); // 7 + 12 expect(b.player.hp).toBe(96); // 99 -3 }); @@ -377,7 +377,7 @@ describe("野蠻人 P7b:n 鎖定 / n 模式 / 探牌 / 卡牌增益 / 豁免 / const fBefore = p.focusBurnedCount; resolveChoice(p, [2], r.pending!, r.rng, []); // 留候選 index2(110 專注) expect(p.hand).not.toContain(110); // ★ 不留在手上 - expect(p.tempMaxHp).toBe(tBefore + 1); // 釋放:+1 臨時上限 + expect(p.tempMaxHp).toBe(tBefore + 2); // 釋放:+2 臨時上限 expect(p.focusBurnedCount).toBe(fBefore + 1); // 計入「已消耗專注」 expect(p.burn).toContain(110); // 釋放後進消耗堆 }); @@ -556,14 +556,17 @@ describe("野蠻人 P7c:變形鏈 / 特殊勝利 / 復活 / Inverse / 衍生 / expect(events.some((e) => e.type === "SPECIAL_WIN")).toBe(true); }); - it("死亡前的凝視:本回合致死 → 復活至 50% 並永久移除本卡", () => { + it("死亡前的凝視:本回合致死 → 臨時生命1:1轉永久、100%復活、永久移除本卡", () => { const g = createGame({ classType: "BARBARIAN", seed: 1 }); g.player.hp = 3; // 低血 + g.player.tempMaxHp = 20; // 有臨時生命上限,復活時應 1:1 轉永久 g.player.hand[0] = 183; const s1 = step(g, { type: "PLAY_CARD", handIndex: 0 }).state; // 武裝復活(hp 3-1=2) const { state } = step(s1, { type: "END_TURN" }); // 怪物反擊致死 → 復活 expect(state.phase).not.toBe("GAME_OVER"); - expect(state.player.hp).toBe(65); // floor(130 × 0.5) + expect(state.player.maxHp).toBe(150); // 130 + 臨時 20 轉永久 + expect(state.player.tempMaxHp).toBe(0); // 臨時生命已全數轉永久 + expect(state.player.hp).toBe(150); // 100% 總生命復活 expect(state.player.burn).not.toContain(183); // 永久移除 }); @@ -590,14 +593,14 @@ describe("野蠻人 P7c:變形鏈 / 特殊勝利 / 復活 / Inverse / 衍生 / expect(b.player.hand).not.toContain(112); }); - it("萬象寂滅:棄牌堆隨機 5 張進消耗堆、10 張專注放牌庫頂", () => { + it("萬象寂滅:棄牌堆隨機 5 張進消耗堆、10 張專注洗入棄牌堆(不放牌庫)", () => { const { player: p } = createPlayer("BARBARIAN", makeRng(1), []); p.discard = [106, 106, 106, 106, 106, 106, 106]; p.deck = [100]; p.burn = []; - runOps([{ op: "ANNIHILATE", token: 110, moveCount: 5, tokenCount: 10, position: "top" }], ctxOf(p)); - expect(p.discard.length).toBe(2); // 7 - 5 - expect(p.burn.length).toBe(5); - expect(p.deck.filter((x) => x === 110).length).toBe(10); - expect(p.deck.slice(-10).every((x) => x === 110)).toBe(true); // 10 專注在牌庫頂(尾端,先抽) + runOps([{ op: "ANNIHILATE", moveCount: 5 }, { op: "SHUFFLE_TOKEN", token: 110, pile: "discard", count: 10 }], ctxOf(p)); + expect(p.burn.length).toBe(5); // 5 張移入消耗堆 + expect(p.deck).toEqual([100]); // 牌庫不變(token 不再放牌庫) + expect(p.discard.filter((x) => x === 110).length).toBe(10); // 10 專注入棄牌堆 + expect(p.discard.length).toBe(2 + 10); // 剩 2 原牌 + 10 專注 }); it("反刃血鎧:僅 hp 在臨時段(>maxHp)時抵擋扣血 → 2× 真實傷害", () => { @@ -638,8 +641,8 @@ describe("野蠻人 P7c:變形鏈 / 特殊勝利 / 復活 / Inverse / 衍生 / drawCards(p, rng, 1, []); expect(p.discard).toContain(110); // 回棄牌堆 expect(p.burn).not.toContain(110); - expect(p.hp).toBe(100); // +1(臨時上限回血) -1(地獄之門) - expect(p.tempMaxHp).toBe(1); + expect(p.hp).toBe(101); // +2(臨時上限回血) -1(地獄之門) + expect(p.tempMaxHp).toBe(2); expect(p.focusBurnedCount).toBe(0); // 未進消耗堆 }); @@ -657,15 +660,6 @@ describe("野蠻人 P7c:變形鏈 / 特殊勝利 / 復活 / Inverse / 衍生 / expect(r.events.some((e) => e.type === "FORCED_END_TURN")).toBe(true); }); - it("萬象寂滅:token 生成於牌庫頂(position top,先抽到)", () => { - const { player: p } = createPlayer("BARBARIAN", makeRng(1), []); - p.discard = [106, 106, 101]; p.deck = [100, 100]; p.burn = []; - runOps([{ op: "ANNIHILATE", token: 110, moveCount: 5, tokenCount: 10, position: "top" }], ctxOf(p)); - expect(p.deck.slice(0, 2)).toEqual([100, 100]); // 原牌在底(index 0..1,最後抽) - expect(p.deck.slice(2).every((x) => x === 110)).toBe(true); // 10 專注在頂(尾端,先抽) - expect(p.deck.length).toBe(12); // 2 + 10 - }); - it("出牌自傷使 HP≤0 → 出牌階段立即判負(GAME_OVER)", () => { const g = createGame({ classType: "BARBARIAN", seed: 1 }); g.player.hp = 1; // 瀕死 @@ -682,7 +676,7 @@ describe("野蠻人 P7c:變形鏈 / 特殊勝利 / 復活 / Inverse / 衍生 / s1.player.hp = 1; s1.player.hand[0] = 106; // 瀕死後再出牌自傷 const { state } = step(s1, { type: "PLAY_CARD", handIndex: 0 }); expect(state.phase).not.toBe("GAME_OVER"); - expect(state.player.hp).toBe(65); // floor(130 × 0.5) + expect(state.player.hp).toBe(130); // 100% 復活(maxHp 130、無臨時生命) expect(state.player.burn).not.toContain(183); }); diff --git a/packages/battle-core/test/battle-core.test.ts b/packages/battle-core/test/battle-core.test.ts index f62288c5c89df56ef2f5e8c7008dcfe905b6f013..b2c52637c819faed9c021bbdf24c3d4c9722cd95 100644 --- a/packages/battle-core/test/battle-core.test.ts +++ b/packages/battle-core/test/battle-core.test.ts @@ -152,6 +152,15 @@ describe("OnDealDamage 旗標(01 §5.1)", () => { expect(dmg).toBe(20 + 5); // 25 }); + it("終極一擊:旗標亮起 → dmg += 怪物當前 HP(處決真正生效,出傷當下結算)", () => { + const p = makePlayer({ atk: 20, flags: { 終極一擊: true } }); + const m = createMonster(); + m.hp = 100; + const dmg = onDealDamage(p, m, []); + expect(dmg).toBe(20 + 100); // 20 + 怪物當前 HP → 必死 + expect(p.flags.終極一擊).toBe(false); // 用完即清 + }); + // 註:原「狂戰士之魂 出傷歸零 DEF」已由卡26「失控侵蝕」機制取代(鎖 DEF=0 + DEF→ATK),該旗標已移除。 }); diff --git a/packages/battle-core/test/ghost.test.ts b/packages/battle-core/test/ghost.test.ts index 1e5047bc273dbcd8df15c851e59239942d6e6058..1680cd43bad8f047487ebc99b9fa4a93c583bdc0 100644 --- a/packages/battle-core/test/ghost.test.ts +++ b/packages/battle-core/test/ghost.test.ts @@ -26,12 +26,23 @@ describe("鬼影數值(01 §9)", () => { expect(g.avgDef).toBe(1); // floor(3/2) }); - it("n<=k 照抄;n>k 用 平均+n(整數)", () => { + it("n<=k 照抄;n>k ATK 用 平均+n、DEF 固定平均(不爆走)", () => { const g = createGhostRuntime([{ atk: 3, def: 1 }, { atk: 4, def: 2 }]); expect(ghostTurnValues(g, 1)).toEqual({ atk: 3, def: 1 }); expect(ghostTurnValues(g, 2)).toEqual({ atk: 4, def: 2 }); - expect(ghostTurnValues(g, 3)).toEqual({ atk: 3 + 3, def: 1 + 3 }); // avg+n - expect(ghostTurnValues(g, 5)).toEqual({ atk: 3 + 5, def: 1 + 5 }); + expect(ghostTurnValues(g, 3)).toEqual({ atk: 3 + 3, def: 1 }); // ATK=avg+n;DEF 固定 avgDef + expect(ghostTurnValues(g, 5)).toEqual({ atk: 3 + 5, def: 1 }); + }); + + it("外推 DEF 有界:再長的回合鬼影防禦都不超過 avgDef → 永遠可被打死(避免無敵鬼影)", () => { + const g = createGhostRuntime([{ atk: 9, def: 5 }, { atk: 8, def: 5 }, { atk: 10, def: 5 }]); + // avgDef = floor(15/3) = 5。即使打到第 100 回合,DEF 仍夾在 avgDef,不會無限上升。 + for (const n of [4, 10, 50, 100]) { + expect(ghostTurnValues(g, n).def).toBe(g.avgDef); + expect(ghostTurnValues(g, n).def).toBeLessThanOrEqual(g.avgDef); + } + // ATK 仍隨回合遞增,逼速戰壓力保留。 + expect(ghostTurnValues(g, 50).atk).toBeGreaterThan(ghostTurnValues(g, 4).atk); }); it("createGhostOpponent:血量 = playerMaxHp,逐回合設攻防", () => { diff --git a/packages/battle-core/test/nameFilter.test.ts b/packages/battle-core/test/nameFilter.test.ts new file mode 100644 index 0000000000000000000000000000000000000000..3d0510d94e723279a08948ad41488dc7203cb15b --- /dev/null +++ b/packages/battle-core/test/nameFilter.test.ts @@ -0,0 +1,98 @@ +import { describe, it, expect } from "vitest"; +import { cleanHeroName, containsProfanity, basicClean, HERO_NAME_FALLBACK, HERO_NAME_MAX } from "../src/nameFilter.js"; +import { buildGhostRecord, createGhostOpponent } from "../src/opponent.js"; +import { createGame } from "../src/engine.js"; +import type { GhostRecord } from "../src/types.js"; + +describe("cleanHeroName:正常名字", () => { + it("一般中英文名字原樣保留", () => { + expect(cleanHeroName("Arthur")).toBe("Arthur"); + expect(cleanHeroName("小明")).toBe("小明"); + expect(cleanHeroName("龍騎士99")).toBe("龍騎士99"); + }); + it("去頭尾空白、collapse 連續空白", () => { + expect(cleanHeroName(" 小明 ")).toBe("小明"); + expect(cleanHeroName("a b")).toBe("a b"); + }); + it("空字串 / 全空白 → 空(未命名)", () => { + expect(cleanHeroName("")).toBe(""); + expect(cleanHeroName(" ")).toBe(""); + }); + it("超長截到 16", () => { + expect(cleanHeroName("a".repeat(40)).length).toBe(HERO_NAME_MAX); + }); +}); + +describe("敏感詞 → 回退無名勇者(基本)", () => { + const banned = ["fuck", "FUCK", "F U C K", "f.u.c.k", "sh1t", "fuuuck", "@sshole", "b1tch", "n1gger", "幹你娘", "幹 你 娘", "媽的", "靠北", "雞掰"]; + for (const w of banned) { + it(`「${w}」被過濾`, () => { + expect(containsProfanity(w)).toBe(true); + expect(cleanHeroName(w)).toBe(HERO_NAME_FALLBACK); + }); + } +}); + +describe("繞過手法(稽核補強)", () => { + // 同形字(西里爾/希臘/土耳其無點 i/重音/組合符號) + const homoglyph = ["fuсk", "ѕhit", "bіtch", "сunt", "whоre", "bаstard", "fυck", "cυnt", "whοre", "shıt", "bıtch", "fück", "çunt", "f́úćḱ"]; + for (const w of homoglyph) it(`同形字「${w}」被擋`, () => expect(containsProfanity(w)).toBe(true)); + + // 簡體 / 異體 / 知名同音 + const cjkVariants = ["操你妈", "干你娘", "干你妈", "干你媽", "鸡巴", "鸡掰", "贱人", "贱货", "妈的", "他妈的", "草泥马", "靠杯"]; + for (const w of cjkVariants) it(`中文變體「${w}」被擋`, () => expect(containsProfanity(w)).toBe(true)); + + // 單字整名 / 重複字母 / leet / ph / 字母替換 + const misc = ["幹", "操", "干", "shiit", "幹你你娘", "phuck", "fvck", "fxck"]; + for (const w of misc) it(`「${w}」被擋`, () => expect(containsProfanity(w)).toBe(true)); +}); + +describe("不誤殺(Scunthorpe 類 + 中文正常詞)", () => { + const safe = [ + "Cassandra", "Dickson", "classic", "assassin", "Matsushita", "Scunthorpe", "Ashitaka", + "Shitao", "Mishit", "Lightwater", "Twatt", "Wankel", "Slutsky", "Bastardo", "Faggotini", + "Retardant", "Niggard", "Snigger", "Pussycat", "Pussyfoot", "Whoreson", "Shiitake", + "操作員", "媽媽", "幹勁", "才幹", "骨幹", "幹活", + ]; + for (const w of safe) { + it(`「${w}」不被誤判`, () => { + expect(containsProfanity(w)).toBe(false); + expect(cleanHeroName(w)).toBe(w); + }); + } +}); + +describe("basicClean:去零寬/控制字元、保留空白", () => { + const ZW = String.fromCharCode(0x200b); // 零寬空白 + const BELL = String.fromCharCode(0x07); // C0 控制字元 + const DEL = String.fromCharCode(0x7f); // DEL 控制字元 + it("去零寬空白", () => expect(basicClean("ze" + ZW + "ro")).toBe("zero")); + it("去 C0/DEL 控制字元", () => { + expect(basicClean("ab" + BELL + "c")).toBe("abc"); + expect(basicClean("ab" + DEL + "c")).toBe("abc"); + }); + it("普通空白不被當控制字元刪除(只 collapse)", () => { + expect(basicClean("a b")).toBe("a b"); + expect(basicClean("a b")).toBe("a b"); + }); +}); + +describe("鬼影 meta.heroName 串接", () => { + function victoryState() { + const s = createGame({ classType: "WARRIOR", seed: 1 }); + s.turnLog = [{ atk: 5, def: 1 }]; + return s; + } + it("buildGhostRecord 帶 heroName → 寫入 meta", () => { + expect(buildGhostRecord(victoryState(), { seed: 1, heroName: "小明" }).meta?.heroName).toBe("小明"); + }); + it("buildGhostRecord 空 heroName → meta.heroName 為 undefined", () => { + expect(buildGhostRecord(victoryState(), { seed: 1, heroName: "" }).meta?.heroName).toBeUndefined(); + }); + it("createGhostOpponent:有名字 → 用名字當對手名;沒名字 → Ghost", () => { + const base: Omit = { playerMaxHp: 100, turns: [{ atk: 3, def: 1 }], seed: 1, ruleVersion: "x", cardsHash: "y" }; + expect(createGhostOpponent({ ...base, meta: { classType: "WARRIOR", heroName: "小明" } }).name).toBe("小明"); + expect(createGhostOpponent({ ...base }).name).toBe("Ghost"); + expect(createGhostOpponent({ ...base, meta: { classType: "WARRIOR" } }).name).toBe("Ghost"); + }); +}); diff --git a/packages/battle-core/test/preview-cost.test.ts b/packages/battle-core/test/preview-cost.test.ts new file mode 100644 index 0000000000000000000000000000000000000000..ad444c88cb93c83f4f5501e8478d43215dcd0acb --- /dev/null +++ b/packages/battle-core/test/preview-cost.test.ts @@ -0,0 +1,62 @@ +/** + * previewPlayHpCost:UI 顯示「現在打出這張牌會扣多少 HP」的真實代價(含 n 進位、ADD_N、卡面 ADD_HP、 + * 無盡怒火自擊轉向等)。用複本跑真正的 playCard 量測,與出牌邏輯零偏差。 + * 對應回報 bug:野蠻人在 ~10 血、N 看似安全時打牌卻暴斃 —— 代價必須在出牌前就看得見。 + */ +import { describe, it, expect } from "vitest"; +import { createPlayer, previewPlayHpCost } from "../src/player.js"; +import { makeRng } from "../src/rng.js"; +import type { PlayerState } from "../src/types.js"; + +function barb(ov: Partial): PlayerState { + const { player } = createPlayer("BARBARIAN", makeRng(1), []); + Object.assign(player, ov); + return player; +} + +describe("previewPlayHpCost — 出牌真實自傷代價", () => { + it("一般牌(106) n=6 → 下一張實扣 7(修正 N 顯示 off-by-one)", () => { + expect(previewPlayHpCost(barb({ hp: 100, n: 6, hand: [106], deck: [], discard: [] }), 0)).toBe(7); + }); + + it("千刀萬剮(150) n=7 → 實扣 10(n+1 再 ADD_N+2)", () => { + expect(previewPlayHpCost(barb({ hp: 100, n: 7, hand: [150], deck: [], discard: [] }), 0)).toBe(10); + }); + + it("無腦傾瀉(131) n=6 充足 HP → 實扣 14(卡面 -n 疊被動 -n)", () => { + expect(previewPlayHpCost(barb({ hp: 50, n: 6, hand: [131, 1, 1, 1, 1], deck: [], discard: [] }), 0)).toBe(14); + }); + + it("代價 ≥ 目前 HP → 夾為目前 HP(致命紅線)", () => { + expect(previewPlayHpCost(barb({ hp: 10, n: 6, hand: [131, 1, 1, 1, 1], deck: [], discard: [] }), 0)).toBe(10); + }); + + it("回報情境:沸騰之血(101) + 無盡怒火 在 10 血時 → 預覽即顯示致命的扣 10", () => { + // 無盡怒火(158)使下一張攻擊改打自己;沸騰之血(101)傷害=5%血上限被轉向自身,再疊被動 n 自傷。 + const p = barb({ hp: 10, n: 6, maxHp: 130, tempMaxHp: 70, hand: [101], deck: [], discard: [], nextAtkSelf: true }); + expect(previewPlayHpCost(p, 0)).toBe(10); // = 目前 HP → 打了就死,出牌前就看得到 + }); + + it("沒有無盡怒火時沸騰之血(101)只扣被動:10 血 n=6 → 只扣 7(不致命)", () => { + const p = barb({ hp: 10, n: 6, maxHp: 130, tempMaxHp: 70, hand: [101], deck: [], discard: [] }); + expect(previewPlayHpCost(p, 0)).toBe(7); + }); + + it("補抽『專注』回血不稀釋代價:牌庫頂是專注仍顯示淨自傷 7", () => { + expect(previewPlayHpCost(barb({ hp: 100, n: 6, hand: [106], deck: [110, 110, 110, 110], discard: [] }), 0)).toBe(7); + }); + + it("純預覽不更動真實狀態", () => { + const p = barb({ hp: 100, n: 6, hand: [106], deck: [], discard: [] }); + const before = JSON.stringify(p); + previewPlayHpCost(p, 0); + expect(JSON.stringify(p)).toBe(before); + }); + + it("戰士無此被動 → null;空手牌索引 → null", () => { + const { player: w } = createPlayer("WARRIOR", makeRng(1), []); + Object.assign(w, { hand: [1] }); + expect(previewPlayHpCost(w, 0)).toBeNull(); + expect(previewPlayHpCost(barb({ hand: [] }), 0)).toBeNull(); + }); +}); diff --git a/packages/battle-core/test/sanctus.test.ts b/packages/battle-core/test/sanctus.test.ts new file mode 100644 index 0000000000000000000000000000000000000000..4afa43e9a6a380befe78e1cb65f6e4e59e066bd0 --- /dev/null +++ b/packages/battle-core/test/sanctus.test.ts @@ -0,0 +1,134 @@ +import { describe, it, expect } from "vitest"; +import { createGame, step } from "../src/engine.js"; +import { accrueCardEnergy, createSanctus, sanctusEnemyTurn, upgradeSanctusForLevel } from "../src/foes.js"; +import { opponentTakeDamage } from "../src/opponent.js"; +import type { GameEvent } from "../src/types.js"; + +describe("Sanctus 路線(Phase 1:生成 / 審判 / Aegis / 升級)", () => { + it("createGame campaign=sanctus → Sanctus、maxLevel 5、有審判線", () => { + const g = createGame({ classType: "WARRIOR", seed: 1, campaign: "sanctus" }); + expect(g.campaign).toBe("sanctus"); + expect(g.maxLevel).toBe(5); + expect(g.opponent.name).toBe("Sanctus"); + expect(g.opponent.judgeLine).toBe(18); + expect(g.opponent.hp).toBe(28); + expect(g.opponent.def).toBe(2); + }); + + it("史萊姆路線完全不受影響(無審判線/無 Aegis)", () => { + const g = createGame({ classType: "WARRIOR", seed: 1 }); + expect(g.campaign).toBe("slime"); + expect(g.maxLevel).toBe(11); + expect(g.opponent.judgeLine).toBeUndefined(); + expect(g.opponent.aegis).toBeUndefined(); + }); + + it("審判:原始 ATK 超過審判線 → 溢出 ½(無條件進位)暫存反傷、無上限", () => { + const a = createSanctus(); // judgeLine 18 + opponentTakeDamage(a, 30); // 溢出 12 → 6 + expect(a.pendingReflect).toBe(6); + + const b = createSanctus(); + opponentTakeDamage(b, 19); // 溢出 1 → ceil(1/2)=1 + expect(b.pendingReflect).toBe(1); + + const c = createSanctus(); + opponentTakeDamage(c, 18); // 等於線,不觸發 + expect(c.pendingReflect ?? 0).toBe(0); + + const d = createSanctus(); + opponentTakeDamage(d, 118); // 溢出 100 → 50(無上限) + expect(d.pendingReflect).toBe(50); + }); + + it("Aegis:先扣 DEF 再由護盾吸收,剩餘才進 HP", () => { + const m = createSanctus(); // def 2, hp 28 + m.aegis = 5; + const actual = opponentTakeDamage(m, 12); // 12-2=10;護盾吸 5 → 5 進 HP + expect(m.aegis).toBe(0); + expect(actual).toBe(5); + expect(m.hp).toBe(23); + }); + + it("穿透(真實傷害)越過 DEF 與 Aegis 護盾,直接扣 HP", () => { + let g = createGame({ classType: "WARRIOR", seed: 9, campaign: "sanctus" }); + g = JSON.parse(JSON.stringify(g)) as typeof g; + g.opponent.hp = 200; g.opponent.maxHp = 200; g.opponent.def = 5; g.opponent.aegis = 10; + g.player.atk = 0; // 只測真傷,無一般傷害 + g.player.trueDamage = 8; + const r = step(g, { type: "END_TURN" }); + expect(r.state.opponent.aegis).toBe(10); // 護盾完全沒被碰(被穿透) + expect(r.state.opponent.hp).toBe(192); // 真傷 8 直接扣 HP(越過 def5 / 盾10) + }); + + it("審判反傷在怪物普攻後無視 DEF 扣玩家 HP", () => { + let g = createGame({ classType: "WARRIOR", seed: 3, campaign: "sanctus" }); + g = JSON.parse(JSON.stringify(g)) as typeof g; + g.opponent.hp = 200; g.opponent.maxHp = 200; // 確保不被打死、能反擊 + g.player.atk = 30; // 原始 ATK 30 > 18 → 溢出 12 → 反傷 6 + g.player.def = 99; // 擋掉 Sanctus 普攻,凸顯反傷無視 DEF + const hp0 = g.player.hp; + const r = step(g, { type: "END_TURN" }); + const reflect = r.events.find((e) => e.type === "MONSTER_REFLECT"); + expect(reflect).toBeTruthy(); + expect(r.state.player.hp).toBe(hp0 - 6); // 普攻被 DEF 擋、僅反傷 6 生效 + }); + + it("過關升級:逐關套用設定(HP / 審判線 / 技能解鎖)", () => { + const m = createSanctus(); + expect(m.skills).toEqual(["aegis"]); + upgradeSanctusForLevel(m, 5); + expect(m.hp).toBe(100); + expect(m.judgeLine).toBe(30); + expect(m.skills).toEqual(["aegis", "smite", "parry", "verdict", "lastjudgment"]); + }); +}); + +describe("Sanctus 路線(Phase 2:能量 / 意圖 / 技能執行)", () => { + it("能量:玩家每出 2 張牌 → +1", () => { + const m = createSanctus(); // energy 0, maxEnergy 8 + accrueCardEnergy(m); expect(m.energy).toBe(0); + accrueCardEnergy(m); expect(m.energy).toBe(1); + accrueCardEnergy(m); accrueCardEnergy(m); expect(m.energy).toBe(2); + }); + + it("意圖:能量不足不預告,足夠則貪婪挑可負擔技能", () => { + const m = createSanctus(); // skills [aegis](cost3), intentDepth 1 + sanctusEnemyTurn(m, []); // +2 → 2,不夠 aegis(3) → intent [] + expect(m.intent).toEqual([]); + expect(m.energy).toBe(2); + m.energy = 5; + sanctusEnemyTurn(m, []); // +2 → 7,規劃 → ["aegis"] + expect(m.intent).toEqual(["aegis"]); + }); + + it("技能執行:聖盾術升盾、扣能量、發 SKILL_USED,非攻擊技無加成", () => { + const m = createSanctus(); + m.energy = 6; m.intent = ["aegis"]; + const ev: GameEvent[] = []; + const bonus = sanctusEnemyTurn(m, ev); // +2 → 8;exec aegis cost3 → energy5、aegis4 + expect(m.aegis).toBe(4); + expect(m.energy).toBe(5); + expect(bonus).toBe(0); + expect(ev.some((e) => e.type === "SKILL_USED" && e.skill === "aegis")).toBe(true); + }); + + it("攻擊技能(裁決斬)只回傳一次性加成、不永久墊高 atk", () => { + const m = createSanctus(); + upgradeSanctusForLevel(m, 4); // baseAtk 8、含 verdict(cost7) + const atk0 = m.atk; + m.energy = 9; m.intent = ["verdict"]; + const bonus = sanctusEnemyTurn(m, []); // exec verdict → 加成 baseAtk×2 = 16 + expect(bonus).toBe(16); + expect(m.atk).toBe(atk0); // m.atk 未被永久改動 + }); + + it("整場 step:能量到位後 Sanctus 真的會放技能(升盾)", () => { + let g = createGame({ classType: "WARRIOR", seed: 7, campaign: "sanctus" }); + g = JSON.parse(JSON.stringify(g)) as typeof g; + g.opponent.energy = 6; g.opponent.intent = ["aegis"]; g.opponent.hp = 200; g.opponent.maxHp = 200; + const r = step(g, { type: "END_TURN" }); + expect(r.events.some((e) => e.type === "SKILL_USED" && e.skill === "aegis")).toBe(true); + expect(r.state.opponent.aegis).toBe(4); + }); +}); diff --git a/packages/server/src/ghostService.ts b/packages/server/src/ghostService.ts index 4f4e83d9f3195a4b65e2722210173d15d2080130..fdacd0fa25a50d7159cecfba5af80262802e43f0 100644 --- a/packages/server/src/ghostService.ts +++ b/packages/server/src/ghostService.ts @@ -23,6 +23,12 @@ export function validateGhostShape(body: unknown): string | null { if (!intInRange(r.seed, -0x80000000, 0xffffffff)) return "seed 必須是整數"; if (typeof r.ruleVersion !== "string" || r.ruleVersion.length > 32) return "缺/非法 ruleVersion"; if (typeof r.cardsHash !== "string" || r.cardsHash.length > 64) return "缺/非法 cardsHash"; + if (r.meta !== undefined) { + if (typeof r.meta !== "object" || r.meta === null) return "meta 必須是物件"; + const hn = (r.meta as Record).heroName; + // heroName 若有則必為字串、長度有界(防 DoS;實際內容由 cleanHeroName 截長/過濾)。 + if (hn !== undefined && (typeof hn !== "string" || hn.length > 1000)) return "meta.heroName 非法"; + } if (r.actions !== undefined) { if (!Array.isArray(r.actions)) return "actions 必須是陣列"; if (r.actions.length > 20000) return "actions 過長"; // 防重播 DoS diff --git a/packages/server/src/pvpMatch.ts b/packages/server/src/pvpMatch.ts index e3ea7333dc7889ef4221949c9a69d6475e06e8e0..6d16247c2c21461440141edaec149dd7870e8591 100644 --- a/packages/server/src/pvpMatch.ts +++ b/packages/server/src/pvpMatch.ts @@ -9,6 +9,7 @@ import { createPvpPlayer, planTurn, resolveSimultaneous, + previewPlayHpCost, pileView, DEFAULT_PVP_CONFIG, type Action, @@ -34,6 +35,8 @@ export interface PvpView { coin: number; maxCoin: number; combo: number; nextReq: Tag; n: number; useA: boolean; useB: boolean; locked: boolean; forcedEnd: boolean; hand: number[]; + handCost: (number | null)[]; // 野蠻人:每張手牌「現在打出會扣多少 HP」(權威端算,含 +1/ADD_N/卡面自傷);非野蠻人為 null + pending: { count: number; keep: boolean; scry?: number[] } | null; // 互動選牌待玩家選;scry=候選牌(野蠻直覺探牌) deckCount: number; deckView: PileEntry[]; discardCount: number; discardView: PileEntry[]; @@ -247,6 +250,8 @@ export class PvpMatch { coin: s.coin, maxCoin: s.maxCoin, combo: s.combo, nextReq: s.nextReq, n: s.n, useA: s.useA, useB: s.useB, locked: mp.locked, forcedEnd: mp.current.forcedEnd, hand: [...s.hand], + handCost: s.hand.map((_, i) => previewPlayHpCost(s, i, "pvp")), // 每張牌的真實自傷代價(顯示用) + pending: mp.current.pending ? { count: mp.current.pending.count, keep: mp.current.pending.keep === true, scry: mp.current.pending.scry } : null, deckCount: s.deck.length, deckView: viewState(s, "deck"), discardCount: s.discard.length, discardView: viewState(s, "discard"), diff --git a/packages/server/src/repository.ts b/packages/server/src/repository.ts index f10b061b442a478bb1394b4f41dbe2e3760f519e..e58de2ed057c75ae808c38b9c4358134d05e057b 100644 --- a/packages/server/src/repository.ts +++ b/packages/server/src/repository.ts @@ -4,13 +4,21 @@ import { randomUUID } from "node:crypto"; import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs"; import { dirname } from "node:path"; -import type { GhostRecord } from "@wcg/battle-core"; +import { cleanHeroName, type GhostRecord } from "@wcg/battle-core"; export interface StoredGhost extends GhostRecord { id: string; verified: boolean; } +/** 權威過濾勇者名字(防禦縱深:除上傳入口外,入庫/載入時亦清洗,涵蓋預先存在或手改的紀錄)。 */ +function sanitizeHeroName(g: GhostRecord): void { + if (g.meta && typeof g.meta.heroName === "string") { + const c = cleanHeroName(g.meta.heroName); + g.meta.heroName = c.length > 0 ? c : undefined; + } +} + export interface GhostRepository { add(record: GhostRecord, verified: boolean): StoredGhost; random(): StoredGhost | null; @@ -32,6 +40,7 @@ export class InMemoryGhostRepository implements GhostRepository { add(record: GhostRecord, verified: boolean): StoredGhost { const stored: StoredGhost = { ...record, id: randomUUID(), verified }; + sanitizeHeroName(stored); // 入庫前再清洗一次(涵蓋未經上傳入口的呼叫,如測試/未來路徑) this.items.push(stored); if (this.items.length > InMemoryGhostRepository.MAX_GHOSTS) { this.items.splice(0, this.items.length - InMemoryGhostRepository.MAX_GHOSTS); // 淘汰最舊 @@ -126,6 +135,7 @@ export class UpstashGhostRepository extends InMemoryGhostRepository { /* 略過壞資料 */ } } + loaded.forEach(sanitizeHeroName); // 載入時清洗(Redis 內可能有舊/未過濾名字) this.items = loaded; } @@ -152,7 +162,10 @@ export class JsonFileGhostRepository extends InMemoryGhostRepository { try { const raw = readFileSync(file, "utf8"); const parsed = JSON.parse(raw) as StoredGhost[]; - if (Array.isArray(parsed)) this.items = parsed; + if (Array.isArray(parsed)) { + parsed.forEach(sanitizeHeroName); // 載入時清洗(手改/舊檔可能含未過濾名字) + this.items = parsed; + } } catch { this.items = []; } diff --git a/packages/server/src/server.ts b/packages/server/src/server.ts index 8f81f1c21d5f067bbe63f3321dda964b12ea9916..7e794ad0098d746bfad8775d48a9f47f8abe9fb2 100644 --- a/packages/server/src/server.ts +++ b/packages/server/src/server.ts @@ -6,7 +6,7 @@ import Fastify, { type FastifyInstance } from "fastify"; import fastifyStatic from "@fastify/static"; import websocketPlugin from "@fastify/websocket"; import { randomUUID } from "node:crypto"; -import type { GhostRecord } from "@wcg/battle-core"; +import { cleanHeroName, type GhostRecord } from "@wcg/battle-core"; import type { GhostRepository } from "./repository.js"; import { validateGhostShape, verifyGhost } from "./ghostService.js"; import { PvpHub, type PvpConn } from "./pvpHub.js"; @@ -71,6 +71,11 @@ export function buildServer(opts: ServerOptions): FastifyInstance { if (requireVerified && !verdict.ok) { return reply.code(422).send({ error: "verification-failed", reason: verdict.reason }); } + // 權威過濾勇者名字(客戶端可繞過 → 後端為準)。meta 不參與 verifyGhost,故在驗證後清洗不影響判定。 + if (record.meta && typeof record.meta.heroName === "string") { + const cleaned = cleanHeroName(record.meta.heroName); + record.meta.heroName = cleaned.length > 0 ? cleaned : undefined; + } const stored = repo.add(record, verdict.ok); return reply.code(201).send({ id: stored.id, verified: stored.verified, reason: verdict.reason }); }); diff --git a/packages/web/public/resources/26.png b/packages/web/public/resources/26.png deleted file mode 100644 index e034c3ed352d5830c6f8e8a847b868a8976ec160..0000000000000000000000000000000000000000 --- a/packages/web/public/resources/26.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:707137d5ba6ef2b923717887f89967df33906e28a19481c8b46e974662baf643 -size 5068093 diff --git a/packages/web/public/resources/barbarian/CardBack.png b/packages/web/public/resources/barbarian/CardBack.png new file mode 100644 index 0000000000000000000000000000000000000000..1ce48c20af6b7a884cf6668b3acc38e83980ce56 --- /dev/null +++ b/packages/web/public/resources/barbarian/CardBack.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:4e83ecc79f39f84bf78a9fa5392f2eeb2fc80156a8d5110ec31971bc0edf4672 +size 3041259 diff --git a/packages/web/public/resources/0.png b/packages/web/public/resources/cards/0.png similarity index 100% rename from packages/web/public/resources/0.png rename to packages/web/public/resources/cards/0.png diff --git a/packages/web/public/resources/1.png b/packages/web/public/resources/cards/1.png similarity index 100% rename from packages/web/public/resources/1.png rename to packages/web/public/resources/cards/1.png diff --git a/packages/web/public/resources/10.png b/packages/web/public/resources/cards/10.png similarity index 100% rename from packages/web/public/resources/10.png rename to packages/web/public/resources/cards/10.png diff --git a/packages/web/public/resources/11.png b/packages/web/public/resources/cards/11.png similarity index 100% rename from packages/web/public/resources/11.png rename to packages/web/public/resources/cards/11.png diff --git a/packages/web/public/resources/12.png b/packages/web/public/resources/cards/12.png similarity index 100% rename from packages/web/public/resources/12.png rename to packages/web/public/resources/cards/12.png diff --git a/packages/web/public/resources/13.png b/packages/web/public/resources/cards/13.png similarity index 100% rename from packages/web/public/resources/13.png rename to packages/web/public/resources/cards/13.png diff --git a/packages/web/public/resources/14.png b/packages/web/public/resources/cards/14.png similarity index 100% rename from packages/web/public/resources/14.png rename to packages/web/public/resources/cards/14.png diff --git a/packages/web/public/resources/15.png b/packages/web/public/resources/cards/15.png similarity index 100% rename from packages/web/public/resources/15.png rename to packages/web/public/resources/cards/15.png diff --git a/packages/web/public/resources/16.png b/packages/web/public/resources/cards/16.png similarity index 100% rename from packages/web/public/resources/16.png rename to packages/web/public/resources/cards/16.png diff --git a/packages/web/public/resources/17.png b/packages/web/public/resources/cards/17.png similarity index 100% rename from packages/web/public/resources/17.png rename to packages/web/public/resources/cards/17.png diff --git a/packages/web/public/resources/18.png b/packages/web/public/resources/cards/18.png similarity index 100% rename from packages/web/public/resources/18.png rename to packages/web/public/resources/cards/18.png diff --git a/packages/web/public/resources/19.png b/packages/web/public/resources/cards/19.png similarity index 100% rename from packages/web/public/resources/19.png rename to packages/web/public/resources/cards/19.png diff --git a/packages/web/public/resources/2.png b/packages/web/public/resources/cards/2.png similarity index 100% rename from packages/web/public/resources/2.png rename to packages/web/public/resources/cards/2.png diff --git a/packages/web/public/resources/20.png b/packages/web/public/resources/cards/20.png similarity index 100% rename from packages/web/public/resources/20.png rename to packages/web/public/resources/cards/20.png diff --git a/packages/web/public/resources/21.png b/packages/web/public/resources/cards/21.png similarity index 100% rename from packages/web/public/resources/21.png rename to packages/web/public/resources/cards/21.png diff --git a/packages/web/public/resources/22.png b/packages/web/public/resources/cards/22.png similarity index 100% rename from packages/web/public/resources/22.png rename to packages/web/public/resources/cards/22.png diff --git a/packages/web/public/resources/23.png b/packages/web/public/resources/cards/23.png similarity index 100% rename from packages/web/public/resources/23.png rename to packages/web/public/resources/cards/23.png diff --git a/packages/web/public/resources/24.png b/packages/web/public/resources/cards/24.png similarity index 100% rename from packages/web/public/resources/24.png rename to packages/web/public/resources/cards/24.png diff --git a/packages/web/public/resources/25.png b/packages/web/public/resources/cards/25.png similarity index 100% rename from packages/web/public/resources/25.png rename to packages/web/public/resources/cards/25.png diff --git a/packages/web/public/resources/cards/26.png b/packages/web/public/resources/cards/26.png new file mode 100644 index 0000000000000000000000000000000000000000..9c8529a17435fb76b348aa14f5b01c01547ab5fb --- /dev/null +++ b/packages/web/public/resources/cards/26.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:f3f3c7ee726dc99dc039407da5bccfe9926ddc97b6ad3324bd093dfde845fc8b +size 788384 diff --git a/packages/web/public/resources/27.png b/packages/web/public/resources/cards/27.png similarity index 100% rename from packages/web/public/resources/27.png rename to packages/web/public/resources/cards/27.png diff --git a/packages/web/public/resources/28.png b/packages/web/public/resources/cards/28.png similarity index 100% rename from packages/web/public/resources/28.png rename to packages/web/public/resources/cards/28.png diff --git a/packages/web/public/resources/29.png b/packages/web/public/resources/cards/29.png similarity index 100% rename from packages/web/public/resources/29.png rename to packages/web/public/resources/cards/29.png diff --git a/packages/web/public/resources/3.png b/packages/web/public/resources/cards/3.png similarity index 100% rename from packages/web/public/resources/3.png rename to packages/web/public/resources/cards/3.png diff --git a/packages/web/public/resources/30.png b/packages/web/public/resources/cards/30.png similarity index 100% rename from packages/web/public/resources/30.png rename to packages/web/public/resources/cards/30.png diff --git a/packages/web/public/resources/31.png b/packages/web/public/resources/cards/31.png similarity index 100% rename from packages/web/public/resources/31.png rename to packages/web/public/resources/cards/31.png diff --git a/packages/web/public/resources/32.png b/packages/web/public/resources/cards/32.png similarity index 100% rename from packages/web/public/resources/32.png rename to packages/web/public/resources/cards/32.png diff --git a/packages/web/public/resources/33.png b/packages/web/public/resources/cards/33.png similarity index 100% rename from packages/web/public/resources/33.png rename to packages/web/public/resources/cards/33.png diff --git a/packages/web/public/resources/34.png b/packages/web/public/resources/cards/34.png similarity index 100% rename from packages/web/public/resources/34.png rename to packages/web/public/resources/cards/34.png diff --git a/packages/web/public/resources/35.png b/packages/web/public/resources/cards/35.png similarity index 100% rename from packages/web/public/resources/35.png rename to packages/web/public/resources/cards/35.png diff --git a/packages/web/public/resources/36.png b/packages/web/public/resources/cards/36.png similarity index 100% rename from packages/web/public/resources/36.png rename to packages/web/public/resources/cards/36.png diff --git a/packages/web/public/resources/37.png b/packages/web/public/resources/cards/37.png similarity index 100% rename from packages/web/public/resources/37.png rename to packages/web/public/resources/cards/37.png diff --git a/packages/web/public/resources/38.png b/packages/web/public/resources/cards/38.png similarity index 100% rename from packages/web/public/resources/38.png rename to packages/web/public/resources/cards/38.png diff --git a/packages/web/public/resources/39.png b/packages/web/public/resources/cards/39.png similarity index 100% rename from packages/web/public/resources/39.png rename to packages/web/public/resources/cards/39.png diff --git a/packages/web/public/resources/4.png b/packages/web/public/resources/cards/4.png similarity index 100% rename from packages/web/public/resources/4.png rename to packages/web/public/resources/cards/4.png diff --git a/packages/web/public/resources/40.png b/packages/web/public/resources/cards/40.png similarity index 100% rename from packages/web/public/resources/40.png rename to packages/web/public/resources/cards/40.png diff --git a/packages/web/public/resources/5.png b/packages/web/public/resources/cards/5.png similarity index 100% rename from packages/web/public/resources/5.png rename to packages/web/public/resources/cards/5.png diff --git a/packages/web/public/resources/6.png b/packages/web/public/resources/cards/6.png similarity index 100% rename from packages/web/public/resources/6.png rename to packages/web/public/resources/cards/6.png diff --git a/packages/web/public/resources/7.png b/packages/web/public/resources/cards/7.png similarity index 100% rename from packages/web/public/resources/7.png rename to packages/web/public/resources/cards/7.png diff --git a/packages/web/public/resources/8.png b/packages/web/public/resources/cards/8.png similarity index 100% rename from packages/web/public/resources/8.png rename to packages/web/public/resources/cards/8.png diff --git a/packages/web/public/resources/9.png b/packages/web/public/resources/cards/9.png similarity index 100% rename from packages/web/public/resources/9.png rename to packages/web/public/resources/cards/9.png diff --git a/packages/web/public/resources/monsters/sanctus.png b/packages/web/public/resources/monsters/sanctus.png new file mode 100644 index 0000000000000000000000000000000000000000..d79afcdac6d6c882fd02debf249cf42741fbaba7 --- /dev/null +++ b/packages/web/public/resources/monsters/sanctus.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:8f1480be34669be976fbb92e9f120a3a3946036fa6bc2bace5af6a1afe9b7e52 +size 402484 diff --git a/packages/web/public/resources/monster.png b/packages/web/public/resources/monsters/slime.png similarity index 100% rename from packages/web/public/resources/monster.png rename to packages/web/public/resources/monsters/slime.png diff --git a/packages/web/src/App.tsx b/packages/web/src/App.tsx index c02099abc8919a813bcaa7eec68efa5c87347bee..30ade7180090a8fc31b711f71fe86be5c222f232 100644 --- a/packages/web/src/App.tsx +++ b/packages/web/src/App.tsx @@ -8,20 +8,73 @@ import { enterGhostBattle, pileView, knifeProgress, + previewPlayHpCost, + cleanHeroName, + SANCTUS_PASSIVE, + SANCTUS_SKILLS, + allSanctusSkills, type Action, + type Campaign, type ClassType, type GameEvent, type GameState, + type MonsterSkill, type PileName, } from "@wcg/battle-core"; import { uploadGhost, fetchRandomGhost } from "./api.js"; import { PvpScreen } from "./PvpScreen.js"; -type Screen = "start" | "select" | "playing" | "pvp"; +type Screen = "start" | "select" | "map" | "playing" | "pvp"; const RES = "/resources"; const randomSeed = () => Math.floor(Math.random() * 0x7fffffff); +// ===== 單人關卡地圖:版面常數 ===== +const MAP_R = 60; // 節點圓半徑 +const MAP_GAP = 360; // 相鄰節點水平間距 +const MAP_PAD_X = 150; // 左右留白 +const MAP_H = 400; // viewBox 高 +const MAP_MID_Y = 195; // 垂直中線 +const MAP_AMP = [88, 72, 96, 64, 90, 76]; // 節點上下振幅(循環取用,數值略有變化避免過度規律) +/** 節點 y:依索引交替正負 → 任一段連線的斜率都與前一段相反,確保「線的走向不與上一條相同」。 */ +const mapNodeY = (i: number) => MAP_MID_Y + (i % 2 === 0 ? -1 : 1) * MAP_AMP[i % MAP_AMP.length]!; +const ROMAN = ["", "Ⅰ", "Ⅱ", "Ⅲ", "Ⅳ", "Ⅴ", "Ⅵ", "Ⅶ", "Ⅷ", "Ⅸ", "Ⅹ", "Ⅺ", "Ⅻ"]; + +/** 地圖節點=一條「路線(敵人)」。點擊先看詳情(名字/關卡數/技能)再開打。新增敵人只要在此追加,版面自動排。 */ +type FoeNode = { + campaign: Campaign; + name: string; + img: string; + levels: number; + status: "playable" | "soon"; + passive?: { name: string; icon: string; desc: string }; + skills: MonsterSkill[]; + blurb: string; +}; +const FOES: FoeNode[] = [ + { campaign: "slime", name: "史萊姆", img: `${RES}/monsters/slime.png`, levels: 11, status: "playable", skills: [], blurb: "經典試煉:純粹的數值對決,逐關變強的史萊姆。無技能、無花招。" }, + { campaign: "sanctus", name: "Sanctus", img: `${RES}/monsters/sanctus.png`, levels: 5, status: "playable", passive: SANCTUS_PASSIVE, skills: allSanctusSkills(), blurb: "聖裁護壁:它不屠戮你,而是審判你出手是否過度。能量×技能×意圖的試煉。" }, +]; +const CLASS_LABEL: Record = { WARRIOR: "戰士", BARBARIAN: "野蠻人" }; + +/** 勇者名字本地記憶(localStorage)。隱私模式/不支援時靜默退化為空字串。 */ +const HERO_NAME_KEY = "wcg.heroName"; +const HERO_NAME_MAX = 16; +function loadHeroName(): string { + try { + return (localStorage.getItem(HERO_NAME_KEY) ?? "").slice(0, HERO_NAME_MAX); + } catch { + return ""; + } +} +function saveHeroName(name: string): void { + try { + localStorage.setItem(HERO_NAME_KEY, name); + } catch { + /* localStorage 不可用(隱私模式/容量滿)→ 略過,不影響遊戲 */ + } +} + /** 從網址 hash 讀邀請房號(#room=CODE);朋友開連結即自動進 PvP 並加入。 */ function readRoomFromHash(): string { const m = /[#?&]room=([A-Za-z0-9]{1,16})/.exec(location.hash || location.search); @@ -35,6 +88,19 @@ export function App() { const [message, setMessage] = useState(""); const [uploadStatus, setUploadStatus] = useState(""); const [ghostMsg, setGhostMsg] = useState(""); + const [heroName, setHeroName] = useState(loadHeroName); // 勇者名字(本地記憶) + const [pendingClass, setPendingClass] = useState("WARRIOR"); // 已選職業,帶進地圖畫面 + + // heroNameRef 鏡像最新名字,供 dispatch(useCallback[] 閉包)上傳時讀取,避免 stale closure。 + const heroNameRef = useRef(heroName); + + // 輸入即存:限制長度,寫回 localStorage 與 ref。 + const updateHeroName = useCallback((raw: string) => { + const name = raw.slice(0, HERO_NAME_MAX); + setHeroName(name); + heroNameRef.current = name; + saveHeroName(name); + }, []); // 鬼影上傳需要:本場 seed 與完整動作序列 const seedRef = useRef(0); @@ -50,7 +116,7 @@ export function App() { // 破第 11 關 → 打包整場 GhostRecord 上傳(模式 A,03 §4)。除錯局(maxLevel≠11)不上傳,避免重播驗證誤判。 if (state.phase === "VICTORY" && !uploadedRef.current && state.maxLevel === MAX_LEVEL) { uploadedRef.current = true; - const record = buildGhostRecord(state, { seed: seedRef.current, actions: actionsRef.current.slice() }); + const record = buildGhostRecord(state, { seed: seedRef.current, actions: actionsRef.current.slice(), heroName: cleanHeroName(heroNameRef.current) }); setUploadStatus("上傳鬼影中…"); uploadGhost(record) .then((r) => setUploadStatus(`鬼影已上傳(${r.verified ? "已驗證" : "未驗證"})`)) @@ -60,21 +126,27 @@ export function App() { }); }, []); - const startBattle = useCallback((classType: ClassType) => { + const startBattle = useCallback((classType: ClassType, campaign: Campaign) => { const seed = randomSeed(); seedRef.current = seed; actionsRef.current = []; uploadedRef.current = false; setUploadStatus(""); setGhostMsg(""); - // 除錯旋鈕:網址帶 ?maxLevel=3 可秒到最後一關;未帶則預設 11 + // 除錯旋鈕:網址帶 ?maxLevel=3 可秒到最後一關;未帶則預設(史萊姆 11 / Sanctus 5) const ml = Number(new URLSearchParams(location.search).get("maxLevel")); const maxLevel = Number.isInteger(ml) && ml > 0 ? ml : undefined; - setGame(createGame({ classType, seed, maxLevel })); + setGame(createGame({ classType, seed, maxLevel, campaign })); setMessage(""); setScreen("playing"); }, []); + // 選完職業 → 進地圖(記住職業,於地圖點關卡才真正開局) + const pickClassToMap = useCallback((classType: ClassType) => { + setPendingClass(classType); + setScreen("map"); + }, []); + // 第 12 關:下載別人的鬼影開打(模式 A) const challengeGhost = useCallback(() => { setGhostMsg("尋找鬼影中…"); @@ -92,9 +164,19 @@ export function App() { }, []); if (screen === "start") { + const shownName = cleanHeroName(heroName); // 過濾後的顯示名(敏感詞 → 無名勇者) return (

Worst Card Game

+ updateHeroName(e.target.value)} + aria-label="勇者的名字" + /> + {shownName &&

歡迎你,勇者 {shownName}!

} @@ -110,8 +192,23 @@ export function App() { return { setScreen("start"); setPvpJoinCode(""); }} />; } - if (screen === "select" || !game) { - return setScreen("start")} />; + if (screen === "select") { + return setScreen("start")} />; + } + + if (screen === "map") { + return ( + startBattle(pendingClass, campaign)} + onBack={() => setScreen("select")} + /> + ); + } + + // 防呆:理論上進到 playing 一定有 game;若無則退回選職業 + if (!game) { + return setScreen("start")} />; } return ( @@ -165,13 +262,37 @@ function Battle({ {message} - {/* 怪物 */} + {/* 怪物:左=名字/HP/數值/意圖;右=立繪 + 立繪下方的能量條 */}
- {m.name}
{m.name}
-
ATK {m.atk}{m.def ? ` DEF ${m.def}` : ""}
+
+ ATK {m.atk} + {m.def ? DEF {m.def} : null} + {m.aegis ? 盾 {m.aegis} : null} +
+ {/* 意圖預告:講出下一步要施展的技能名稱 */} + {m.maxEnergy !== undefined && ( +
+ 下一步:{m.intent && m.intent.length > 0 + ? m.intent.map((id) => (SANCTUS_SKILLS[id] ? SANCTUS_SKILLS[id]!.name : id)).join(" ") + : "蓄力中…"} +
+ )} +
+
+ {/* 能量格子:放在立繪上方(亮起數=目前能量) */} + {m.maxEnergy !== undefined && ( +
+
+ {Array.from({ length: m.maxEnergy }, (_, i) => ( + + ))} +
+
+ )} + {m.name}
@@ -216,6 +337,7 @@ function Battle({ locked={!choosing && isTagLocked(getCard(id).tag, p.useA, p.useB)} selected={choosing && !scry && chosen.includes(i)} disabled={!!scry} /* 探牌階段:手牌不可選(改選候選牌) */ + selfCost={!choosing ? previewPlayHpCost(p, i) : null} /* 野蠻人:這張現在打出會扣多少血 */ onClick={() => (scry ? undefined : choosing ? toggleChosen(i) : dispatch({ type: "PLAY_CARD", handIndex: i }))} /> ))} @@ -284,11 +406,20 @@ function Battle({ {game.phase === "VICTORY" && game.level <= game.maxLevel && (

破關!

-

恭喜通過全部 11 關,英雄!

- {uploadStatus &&

{uploadStatus}

} - - {ghostMsg &&

{ghostMsg}

} - + {game.campaign === "slime" ? ( + <> +

恭喜通過全部 {game.maxLevel} 關,英雄!

+ {uploadStatus &&

{uploadStatus}

} + + {ghostMsg &&

{ghostMsg}

} + + + ) : ( + <> +

擊敗 Sanctus!通過全部 {game.maxLevel} 關。

+ + + )}
)} {game.phase === "VICTORY" && game.level > game.maxLevel && ( @@ -340,7 +471,129 @@ export function ClassSelect({ ); } -export function CardView({ id, onClick, big, locked, selected, disabled }: { id: number; onClick?: () => void; big?: boolean; locked?: boolean; selected?: boolean; disabled?: boolean }) { +/** + * 單人關卡地圖:由左到右的旅途。節點=圓形徽章(怪物肖像嵌入金環), + * 連線以交替斜率蜿蜒(mapNodeY 保證每段方向與前一段相反)。 + * 可挑戰節點有脈動光暈+可點擊;尚未開放的節點暗化、虛線環、標「即將登場」。 + */ +function LevelMap({ + classType, onStart, onBack, +}: { classType: ClassType; onStart: (campaign: Campaign) => void; onBack: () => void }) { + const nodes = FOES; + const [selected, setSelected] = useState(null); // 點敵人 → 詳情面板 + const W = MAP_PAD_X * 2 + (nodes.length - 1) * MAP_GAP; + const pts = nodes.map((_, i) => ({ x: MAP_PAD_X + i * MAP_GAP, y: mapNodeY(i) })); + const pathD = pts.map((p, i) => `${i === 0 ? "M" : "L"} ${p.x} ${p.y}`).join(" "); + // 路徑總長(直線段距離和)→ 給 stroke-dash 做「左到右描繪」動畫 + const trailLen = pts.reduce((sum, p, i) => (i === 0 ? 0 : sum + Math.hypot(p.x - pts[i - 1]!.x, p.y - pts[i - 1]!.y)), 0); + + return ( +
+
+

單人闖關

+

點選敵人查看詳情,再踏上旅途

+
+ +
+ + + + + + {/* 旅途路徑(在節點之下;載入時由左向右描繪) */} + + + {nodes.map((node, i) => { + const playable = node.status === "playable"; + return ( + setSelected(node) : undefined} + onKeyDown={playable ? (e) => { if (e.key === "Enter" || e.key === " ") { e.preventDefault(); setSelected(node); } } : undefined} + > + + + + + {ROMAN[i + 1] ?? i + 1} + {node.name} + {playable ? `${node.levels} 關` : "即將登場"} + + + ); + })} + +
+ +
+ 勇者職業 · {CLASS_LABEL[classType]} + +
+ + {selected && onStart(selected.campaign)} onClose={() => setSelected(null)} />} +
+ ); +} + +/** 地圖敵人詳情:名字、關卡數、被動+技能介紹、開始按鈕。 */ +function FoeDetail({ foe, onStart, onClose }: { foe: FoeNode; onStart: () => void; onClose: () => void }) { + return ( +
+
e.stopPropagation()}> +
+ {foe.name} +
+

{foe.name}

+ 共 {foe.levels} 關 +

{foe.blurb}

+
+
+ +
+ {foe.passive && ( +
+
+ {foe.passive.name} + {foe.passive.desc} +
+
+ )} + {foe.skills.map((s) => ( +
+
+ {s.name} 能量 {s.cost}・第 {s.unlockLevel} 關解鎖 + {s.desc} +
+
+ ))} + {!foe.passive && foe.skills.length === 0 && ( +

無特殊技能 —— 純粹的數值對決。

+ )} +
+ +
+ + +
+
+
+ ); +} + +export function CardView({ id, onClick, big, locked, selected, disabled, selfCost }: { id: number; onClick?: () => void; big?: boolean; locked?: boolean; selected?: boolean; disabled?: boolean; selfCost?: number | null }) { const card = useMemo(() => { try { return getCard(id); } catch { return null; } }, [id]); const cls = `${big ? "big" : ""} ${locked ? "locked" : ""} ${selected ? "selected" : ""}`; if (!card) { // 未知卡 id:不崩潰,顯示佔位卡 @@ -352,16 +605,23 @@ export function CardView({ id, onClick, big, locked, selected, disabled }: { id: const dmg = card.dmgText ?? (card.atk > 0 ? String(card.atk) : null); return ( ); } - const title = locked ? `${card.name}(${card.tag} 卡本回合被鎖:打過捨身一擊/龜縮)` : card.name; + // 戰士(及其他)圖卡:效果文字已印在卡面上,不另疊文字;焚燒卡右上角加火焰標記。 + const title = locked + ? `${card.name}(${card.tag} 卡本回合被鎖:打過捨身一擊/龜縮)` + : card.name; return ( ); } @@ -418,7 +678,7 @@ function PilePanel({ game, pile, onClose }: { game: GameState; pile: PileName; o {dmg !== null && 傷害 {dmg}} ) : ( - {c.name} + {c.name} )} ×{e.count} @@ -443,7 +703,7 @@ function PilePanel({ game, pile, onClose }: { game: GameState; pile: PileName; o function Bar({ value, max, kind, label }: { value: number; max: number; kind: string; label: string }) { const pct = max > 0 ? Math.max(0, Math.min(100, (value / max) * 100)) : 0; return ( -
+
{label}
@@ -467,6 +727,8 @@ function describeEvents(events: GameEvent[]): string { case "FORCED_END_TURN": parts.push("重擊:連擊中斷,結束回合"); break; case "PLAYER_DEAL_DAMAGE": parts.push(`造成 ${e.dealt} 傷害`); break; case "MONSTER_ATTACK": parts.push(`怪物反擊 ${e.damage}`); break; + case "MONSTER_REFLECT": parts.push(`聖裁反噬 ${e.damage}(無視防禦)`); break; + case "SKILL_USED": parts.push(`敵方施展【${e.name}】`); break; case "MONSTER_DEAD": parts.push("擊敗怪物!"); break; case "CARD_UPGRADED": parts.push(`卡牌升級:${getCard(e.from).name}→${getCard(e.to).name}`); break; case "LEVEL_UP": parts.push(`進入第 ${e.level} 關`); break; diff --git a/packages/web/src/PvpScreen.tsx b/packages/web/src/PvpScreen.tsx index 4f50bb18091b4b0bce1799e7007585fe1087ca1a..6c949f9fb2496c715f252c7aaf70231c41e2a2ba 100644 --- a/packages/web/src/PvpScreen.tsx +++ b/packages/web/src/PvpScreen.tsx @@ -345,7 +345,7 @@ function PvpBattle({ pvp }: { pvp: ReturnType }) { if (pending && !scry) { return toggleChosen(i)} />; } - return pvp.play(i)} />; + return pvp.play(i)} />; })}
diff --git a/packages/web/src/pvpClient.ts b/packages/web/src/pvpClient.ts index aaa07d9e49eaec8fb17dda7928623032479554a3..11f2bacd921319dbba1a645102a78d2dd55ae643 100644 --- a/packages/web/src/pvpClient.ts +++ b/packages/web/src/pvpClient.ts @@ -12,6 +12,7 @@ export interface PvpView { coin: number; maxCoin: number; combo: number; nextReq: Tag; n: number; useA: boolean; useB: boolean; locked: boolean; forcedEnd: boolean; hand: number[]; + handCost: (number | null)[]; // 野蠻人:每張手牌現在打出的真實 HP 自傷代價(伺服器權威算);非野蠻人為 null pending: { count: number; keep: boolean; scry?: number[] } | null; deckCount: number; deckView: PileEntry[]; discardCount: number; discardView: PileEntry[]; diff --git a/packages/web/src/styles.css b/packages/web/src/styles.css index caf92a6f69c2a2b51850828290e4bb0815792bcf..622d8fe4db59737dffa20e4297f438c90212ae73 100644 --- a/packages/web/src/styles.css +++ b/packages/web/src/styles.css @@ -124,6 +124,148 @@ html, body, #root { border-radius: 8px; } +/* ===== 單人關卡地圖 ===== */ +.level-map { + height: 100%; + overflow: hidden; /* 地圖一律塞進視窗,不出現捲軸 */ + display: flex; + flex-direction: column; + align-items: center; + justify-content: center; + gap: 14px; + padding: 16px; +} +.map-head { text-align: center; } +.map-title { + font-family: "Cinzel Decorative", "Cinzel", serif; + font-weight: 900; + font-size: clamp(28px, 5vw, 48px); + letter-spacing: 3px; + margin: 0; + background: linear-gradient(180deg, #f5e3a8 0%, var(--gold) 50%, #8a5a1e 100%); + -webkit-background-clip: text; + background-clip: text; + color: transparent; + text-shadow: 0 4px 24px rgba(217, 178, 90, .3); +} +.map-sub { color: var(--muted); margin: 8px 0 0; font-size: 15px; letter-spacing: 1px; } + +.map-stage { width: min(920px, 96vw); } +/* 限高 58vh:確保「標題+地圖+頁尾」整體不超過視窗高度(meet 會等比縮放、置中) */ +.map-svg { width: 100%; height: auto; max-height: 58vh; display: block; overflow: visible; } + +/* 旅途路徑:金色細線,載入時由左向右描繪一次 */ +.trail { + fill: none; + stroke: var(--gold); + stroke-width: 3; + stroke-linecap: round; + stroke-linejoin: round; + opacity: .8; + filter: drop-shadow(0 0 6px rgba(217, 178, 90, .5)); + stroke-dasharray: var(--len); + stroke-dashoffset: var(--len); + animation: trail-draw 1.15s ease forwards; +} +@keyframes trail-draw { to { stroke-dashoffset: 0; } } + +/* 節點:載入時依序淡入(只動 opacity,不動 transform,避免蓋掉定位用的 translate) */ +.map-node { opacity: 0; animation: node-pop .5s ease forwards; animation-delay: var(--delay); } +@keyframes node-pop { to { opacity: 1; } } +/* hover 放大需以「徽章自身中心」為支點:SVG 的 CSS transform 預設以 viewBox 原點為支點, + 故明確指定 fill-box + center,否則放大會偏移飛走。 */ +.node-inner { transition: transform .15s ease; transform-box: fill-box; transform-origin: center; } + +.map-node .halo { fill: rgba(217, 178, 90, .06); } +.map-node .ring { fill: #0c0d18; stroke: var(--gold); stroke-width: 3; } +.map-node .roman { + fill: var(--gold); + font-family: "Cinzel", "Cinzel Decorative", serif; + font-size: 30px; + font-weight: 700; + opacity: .92; +} +.map-node .node-name { fill: var(--text); font-size: 21px; font-weight: 700; } +.map-node .soon-tag { fill: var(--muted); font-size: 14px; letter-spacing: 3px; } + +/* 可挑戰:脈動光暈當行動召喚;hover / 鍵盤聚焦放大、金邊變亮 */ +.map-node.playable { cursor: pointer; } +.map-node.playable .ring { animation: ring-pulse 2.4s ease-in-out infinite; } +@keyframes ring-pulse { + 0%, 100% { filter: drop-shadow(0 0 4px rgba(217, 178, 90, .4)); } + 50% { filter: drop-shadow(0 0 16px rgba(217, 178, 90, .9)); } +} +.map-node.playable:hover .node-inner, +.map-node.playable:focus-visible .node-inner { transform: scale(1.06); } +.map-node.playable:focus { outline: none; } +.map-node.playable:focus-visible .ring { stroke: #f5e3a8; stroke-width: 5; } + +/* 即將登場:暗化、虛線環、去飽和肖像 */ +.map-node.soon { cursor: not-allowed; } +.map-node.soon .ring { stroke: #5b5e86; stroke-dasharray: 6 7; } +.map-node.soon .portrait { opacity: .38; filter: grayscale(.7); } +.map-node.soon .roman { fill: #5b5e86; opacity: .8; } +.map-node.soon .node-name { fill: var(--muted); } + +.map-foot { display: flex; align-items: center; gap: 18px; } +.map-class { color: var(--muted); font-size: 14px; letter-spacing: 1px; } + +@media (prefers-reduced-motion: reduce) { + .trail { animation: none; stroke-dashoffset: 0; } + .map-node { animation: none; opacity: 1; } + .map-node.playable .ring { animation: none; } + .node-inner { transition: none; } +} + +/* 地圖敵人詳情面板:名字 / 關卡數 / 被動+技能介紹 / 開始 */ +.foe-detail .foe-box { + width: min(760px, 94vw); + max-height: 90vh; + overflow-y: auto; + align-items: stretch; + text-align: left; + gap: 14px; +} +.foe-head { display: flex; gap: 16px; align-items: center; } +.foe-portrait { + width: 96px; + height: 96px; + border-radius: 50%; + object-fit: cover; + border: 2px solid var(--gold); + box-shadow: 0 0 16px rgba(217, 178, 90, .4); + flex: 0 0 auto; +} +.foe-headtext { display: flex; flex-direction: column; gap: 4px; min-width: 0; } +.foe-name { margin: 0; font-family: "Cinzel Decorative", "Cinzel", serif; font-size: 28px; color: var(--gold); } +.foe-levels { color: var(--muted); font-size: 14px; letter-spacing: 1px; } +.foe-blurb { margin: 4px 0 0; color: var(--text); font-size: 14px; line-height: 1.5; opacity: .92; } + +/* 技能分兩欄,整體變矮、不出捲軸;被動橫跨兩欄當標題 */ +.skill-list { display: grid; grid-template-columns: 1fr 1fr; gap: 8px; } +.skill-row.passive { grid-column: 1 / -1; } +@media (max-width: 620px) { + .skill-list { grid-template-columns: 1fr; } + .skill-row.passive { grid-column: auto; } +} +.skill-row { + display: flex; + gap: 12px; + align-items: flex-start; + background: rgba(255, 255, 255, .03); + border: 1px solid #33365a; + border-radius: 10px; + padding: 10px 12px; +} +.skill-row.passive { border-color: var(--gold); background: rgba(217, 178, 90, .08); } +.skill-icon { font-size: 22px; line-height: 1.3; flex: 0 0 auto; width: 28px; text-align: center; } +.skill-text { display: flex; flex-direction: column; gap: 3px; min-width: 0; } +.skill-text b { font-size: 15px; color: var(--text); } +.skill-meta { font-weight: 500; font-size: 12px; color: var(--gold); } +.skill-text > span { font-size: 13px; color: var(--muted); line-height: 1.5; } +.foe-noskill { color: var(--muted); text-align: center; padding: 12px; } +.foe-actions { display: flex; gap: 12px; justify-content: center; } + /* ===== 戰鬥畫面 ===== */ .battle { max-width: 1100px; @@ -139,18 +281,40 @@ html, body, #root { .level { color: var(--gold); font-weight: 600; } .msg { color: var(--muted); font-size: 14px; min-height: 18px; } +/* 左=資訊(名字/HP/數值/意圖);右=立繪 + 立繪下方能量條 */ .enemy { display: flex; - gap: 16px; - align-items: center; + align-items: flex-end; /* 立繪貼著面板底部(貼地)*/ + gap: 20px; background: var(--panel); border: 1px solid #33365a; border-radius: 12px; - padding: 12px 16px; + padding: 14px 18px 0; /* 底部不留白,讓立繪貼地 */ +} +.enemy-info { flex: 1; align-self: stretch; display: flex; flex-direction: column; gap: 6px; min-width: 0; padding-bottom: 14px; } +.enemy-info .name { font-weight: 700; font-size: 18px; } +/* 能量格子在上、立繪在下(貼地);整欄往左移一些 */ +.enemy-portrait { flex: 0 0 auto; display: flex; flex-direction: column; align-items: center; gap: 8px; margin-right: 60px; } +.enemy-img { width: 320px; height: auto; object-fit: contain; display: block; } +.enemy-stats { display: flex; gap: 12px; flex-wrap: wrap; } +.enemy-stats .shield { color: var(--gold); } + +/* 能量:格子狀格槽(亮起數=目前能量) */ +.enemy-energy { display: flex; flex-direction: column; align-items: center; gap: 5px; } +.ee-label { font-size: 13px; color: var(--muted); letter-spacing: .5px; } +.energy-pips { display: flex; gap: 4px; flex-wrap: wrap; justify-content: center; max-width: 220px; } +.energy-pips .pip { + width: 16px; + height: 16px; + border-radius: 3px; + background: #0c0d18; + border: 1px solid #33365a; +} +.energy-pips .pip.on { + background: linear-gradient(180deg, #6fd0ff, #2a6f97); + border-color: #4aa3ff; + box-shadow: 0 0 5px rgba(74, 163, 255, .6); } -.enemy-img { width: 84px; height: 84px; object-fit: contain; } -.enemy-info { flex: 1; } -.enemy-info .name { font-weight: 700; margin-bottom: 6px; } .player-stats { display: flex; @@ -177,6 +341,11 @@ html, body, #root { } .bar-fill { position: absolute; inset: 0; transition: width .25s; } .bar-fill.hp { background: linear-gradient(90deg, #2c8f3c, var(--hp)); } +.bar-fill.energy { background: linear-gradient(90deg, #2a6f97, #4aa3ff); } +/* 敵人能量條:放在 HP 條底下,略矮、藍色 */ +.bar.bar-energy { height: 16px; margin-top: 5px; } +.bar.bar-energy .bar-label { line-height: 16px; font-size: 12px; } +.enemy-info .intent { font-size: 13px; color: var(--gold); margin-top: 5px; letter-spacing: .5px; } .bar-label { position: relative; display: block; @@ -258,6 +427,16 @@ html, body, #root { } .card.big { width: calc(var(--card-w) * 1.364); } .card img { width: 100%; border-radius: 6px; display: block; } +/* 焚燒標記:任何職業有 exhaust 的卡,右上角火焰(用完進消耗堆) */ +.card-burn { + position: absolute; + top: 4px; right: 5px; + font-size: 15px; + line-height: 1; + filter: drop-shadow(0 1px 2px rgba(0, 0, 0, .8)); + pointer-events: none; + z-index: 2; +} /* 野蠻人白底文字卡(無卡圖):名稱 + 傷害 + 效果文字。aspect 仿一般卡比例,放大沿用 .card:hover scale。 */ .card.textcard { aspect-ratio: 198 / 278; @@ -274,6 +453,8 @@ html, body, #root { } .card.textcard .tc-name { font-weight: 800; font-size: 15px; line-height: 1.2; color: #3a2d18; } .card.textcard .tc-dmg { font-size: 12px; font-weight: 700; color: #9a2f2f; } +/* 出牌真實自傷代價:醒目紅底徽章,讓玩家一眼看出「打這張會扣多少血」,避免看 N 估錯而暴斃 */ +.card.textcard .tc-cost { font-size: 11px; font-weight: 800; color: #fff; background: #b3261e; border-radius: 999px; padding: 1px 8px; line-height: 1.4; box-shadow: 0 1px 2px rgba(0,0,0,.25); } .card.textcard .tc-desc { font-size: 11px; line-height: 1.32; opacity: .9; } /* 標籤被鎖(捨身鎖B / 龜縮鎖A):變灰,但仍可 hover 放大檢視 */ .card.locked { opacity: .4; filter: grayscale(.8); } @@ -389,6 +570,22 @@ html, body, #root { width: 160px; } .code-input:focus { outline: none; border-color: var(--gold); } + +/* 首頁:勇者名字輸入框(本地記憶) */ +.name-input { + background: #0c0d18; + border: 1px solid #33365a; + border-radius: 8px; + color: var(--text); + padding: 12px 16px; + font-size: 18px; + width: 260px; + max-width: 80vw; + text-align: center; + letter-spacing: 1px; +} +.name-input:focus { outline: none; border-color: var(--gold); } +.name-input::placeholder { color: var(--muted); } .resolve-banner { text-align: center; color: var(--gold); @@ -518,11 +715,13 @@ html, body, #root { .bar { width: 220px; } .title { font-size: 36px; } .menu-btn { min-width: 260px; } - .enemy-img { width: 72px; height: 72px; } + .enemy-img { width: 260px; height: auto; } .end-turn { width: 108px; height: 108px; right: 20px; font-size: 16px; } .card.textcard .tc-name { font-size: 13px; } .card.textcard .tc-dmg { font-size: 10px; } + .card.textcard .tc-cost { font-size: 10px; padding: 1px 6px; } .card.textcard .tc-desc { font-size: 9.5px; } + .card-burn { font-size: 13px; } } /* 手機 / 窄平板 */ @@ -535,7 +734,7 @@ html, body, #root { .subtitle { font-size: 13px; } .menu-btn { min-width: 200px; } .stat { font-size: 13px; } - .enemy-img { width: 60px; height: 60px; } + .enemy-img { width: 200px; height: auto; } .end-turn { width: 82px; height: 82px; right: 8px; font-size: 13px; } .end-turn .lock-label small { font-size: 9px; } .hand { gap: 7px; margin-bottom: 58px; } @@ -544,5 +743,7 @@ html, body, #root { .choice-bar { font-size: 12px; padding: 6px 10px; max-width: 94vw; justify-content: center; flex-wrap: wrap; } .card.textcard .tc-name { font-size: 10px; } .card.textcard .tc-dmg { font-size: 9px; } + .card.textcard .tc-cost { font-size: 9px; padding: 0 5px; } .card.textcard .tc-desc { font-size: 8px; line-height: 1.25; } + .card-burn { font-size: 12px; top: 3px; right: 4px; } } diff --git "a/\351\226\213\347\231\274\346\255\267\347\250\213.html" "b/\351\226\213\347\231\274\346\255\267\347\250\213.html" new file mode 100644 index 0000000000000000000000000000000000000000..77f4a387b575994e646dbaed1e459dd9f4edb718 --- /dev/null +++ "b/\351\226\213\347\231\274\346\255\267\347\250\213.html" @@ -0,0 +1,955 @@ + + + + + +Worst Card Game — 開發歷程 + + + + + + + +
+
+

// 開發歷程 · DEVLOG · battle-core v1.2.0

+
+
+

+ 最爛的卡牌遊戲 + A Rogue-like,從 C++ 單機重製成網頁多人。 +

+

+ 原版是 raylib + C++ 的桌面卡牌 Rogue-like。重製版把遊戲規則整包搬到一個純邏輯引擎, + 讓網頁、伺服器、單機/鬼影/PvP 三模式共用同一份規則——這份頁面記錄它怎麼一張一張接起來。 +

+

+ 硬幣→連擊→標籤→滾雪球 +

+
+ 3 套件 monorepo + 雙職業卡庫 + 11+1 關 + 19 測試檔 + 純規則 · 決定性 +
+
+ +
+
+
★ Legendary重製版
+
+
⛃COMBO ENGINE
+
+
battle-core
+
純規則引擎 · 零相依 · 可種子化
+
+ 即時:花 1 硬幣起手連擊。連擊:接對標籤 +1 連擊,效果延遲一張結算。每 5 連抽 1 張。 + 破 11 關,第 12 關打別人的鬼影。 +
+
+
輸入seed+動作
+
輸出狀態+事件
+
副作用0
+
+
+
+
+
+
+ + +
+
+
+

// 01 — 最高原則

+

規則、畫面、連線,完全分離。

+

原版把規則塞在 Entity.cpp 和 BattleEngine.cpp 裡、跟畫面綁死。重製版第一步就是把規則抽成一個純邏輯模組,因為這樣才能:前後端共用同一份規則(防作弊)、能單元測試、換 UI 不動規則。

+
+
+
+ +
packages/battle-core
+

battle-core — 純規則引擎

+

createGame() / step() 是純函式(同輸入 → 同輸出)。所有亂數走可注入種子的 PRNG,絕不用 Math.random()——否則鬼影回放與 PvP 重算會對不上。前端、後端、三模式都 import 這同一份。

+
+
+ +
packages/web
+

web — React 前端

+

單機/鬼影直接在瀏覽器跑 battle-core,體驗即時順暢;PvP 則連 WebSocket 交給伺服器。三堆檢視器只給合併計數、絕不洩漏抽牌順序。

+
+
+ +
packages/server
+

server — Fastify 後端

+

鬼影 REST(/api/ghosts)+ PvP WebSocket(/ws/pvp,唯一權威)。同一份 battle-core 以 seed + actions 重放驗證,反作弊與鬼影共用同一套機制。

+
+
+

// 鐵則:模式差異只能走 cards.json 的 modeOverride.PVP 或薄協調層,嚴禁在 core 內 if(isPvp) 分叉規則。

+
+
+ + +
+
+
+

// 02 — 開發路線圖

+

把里程碑當成一條連擊來打。

+

遊戲的玩法是「用標籤把卡牌串成連擊、滾雪球」。開發本身也是這樣:每個里程碑接上前一個、連擊數往上疊。計劃中的鏈是 M0–M5;接著連擊沒中斷,又疊出了 PvP 與野蠻人。

+
+ +
+ Combo + ×0 + / 8 連 · 連擊持續中 +
+ +
+ +
+
+
M0×1
+ 骨架 +

技術骨架

+

monorepo 三套件成形,前端假畫面、後端假 API、npm run dev 一鍵跑通。

+
完成
+
+
+ + +
+
+
M1×2
+ 引擎 +

規則引擎 + 卡表

+

純邏輯戰鬥引擎;41 張卡資料化成 EffectOp 指令;黃金測試進 CI。無畫面就能跑完整場。

+
完成
+
+
+ + +
+
+
M2×3
+ 介面 +

單人 11 關網頁

+

React 接上 battle-core,出牌/結束回合/三選一獎勵、三堆檢視器,規則上可破第 11 關。

+
規則完成 · 地圖美術進行中
+
+
+ + +
+
+
M3×4
+ 存檔 +

鬼影資料

+

每回合 ATK/DEF 串成存檔,後端 POST /api/ghosts、GET /random 上傳與抽取。

+
完成
+
+
+ + +
+
+
M4×5
+ 鬼影 +

第 12 關鬼影戰

+

多型 GhostOpponent 與怪物共用對手介面,破關後抽一份別人的存檔對打;沒存檔就退化成預設怪物。

+
完成
+
+
+ + +
+
+
M5×6
+ 上線 +

部署與打磨

+

單容器 Docker 上 HuggingFace Spaces,同進程服務前端 + /api;音效/動畫/RWD 打磨中。

+
進行中
+
+
+ + +
+
+
P+×7
+ PvP +

即時對戰

+

同時暗回合四相結算、/ws/pvp 權威伺服器、房間碼配對、開局輪抽、再戰。路線圖外的獨立增量。

+
核心完成
+
+
+ + +
+
+
++×8
+ 野蠻人 +

第二職業

+

路線圖外的加碼:n 自傷曲線、無 DEF、手牌恆滿、真實傷害、蓄力特殊勝利。RULE_VERSION 1.2.0。

+
完成 · PvP 暫鎖
+
+
+ +
+

↔ 水平捲動看完整連擊鏈 · 連擊未中斷,下一張還沒翻牌。

+
+
+ + +
+
+
+

// 03 — 最關鍵的機制

+

每張卡有兩段效果,延遲一張結算。

+

這是整個遊戲最容易寫錯的地方,也是測試釘得最死的地方。實作上用 pendingComboCardId 記住「上一張待結算的卡」。

+
+
+
+ on play · 立刻 +

即時效果 onPlay

+

打出當下立刻結算,每次成功出牌都會跑。加 ATK/DEF、抽牌、設旗標都在這。

+
+
+ on combo · 慢一拍 +

連擊效果 onCombo

+

屬於「上一張卡」,要等下一張成功接上才結算。連擊中斷或回合結束,最後一張的連擊效果就不會觸發。

+
+
+ 打出 卡 X → 跑 X.onPlay(立即) | 記住 X 待結算
+ 打出 卡 Y 且標籤接得上 → 跑 X.onCombo(延遲一張,此刻才發生)→ 跑 Y.onPlay → 記住 Y
+ // Y 接不上 → 連擊中斷,X.onCombo 永遠不結算 +
+
+
+
+ + +
+
+
+

// 04 — 卡牌系統

+

卡牌是資料,不是程式。

+

41 張戰士卡(0–40)的數值與效果全寫成 onPlay[] + onCombo[] 兩串 EffectOp 指令;單一事實來源是 src/data/cards.ts,npm run gen:cards 衍生出 cards.json。

+
+
+
+
+
普通
+
基礎構築,1·2·4·6·7·9 關發放。
+
18 張取 3
+
+
+
史詩
+
連擊放大、翻倍、百分比傷害。3·8 關。
+
15 張取 3
+
+
+
傳說
+
絕對防禦、命運、傳說之證等高張力卡。5·10 關。
+
6 張取 3
+
+
+
升級專屬
+
血劍/終極一擊,不進獎勵池,只能「養」出來。
+
id 34·35
+
+
+ +
+

養成:升級鏈

+
+
+ 斷劍 + 連擊累積 Broken += Coin,達 20 → 升級 +
+
+ 血劍 + 連擊累積 Blood++,達 8 → 升級 +
+
+ 終極一擊 + 把 210 在連擊第 1·2·3·4 張各整除一次到 1 → 處決 +
+
+

// 升級檢查在每次過關時跑(checkCardUpgrades)。

+
+
+
+
+ + +
+
+
+

// 05 — 多人連線

+

兩種多人,一份引擎。

+

鬼影與 PvP 共用同一份 battle-core;差別只在「對局協調層」與前端相位 UI。鬼影先做先上線,PvP 是上線後的獨立增量。

+
+
+
+
模式 A · 非同步
+

鬼影對戰

+

破 11 關後上傳整場每回合的攻防,別人第 12 關下載你的「鬼影」當對手。只需 REST + 儲存,技術風險最低。

+
    +
  • 對手用多型 GhostOpponent,戰鬥引擎一視同仁。
  • +
  • 紀錄用完後攻擊外推 avgAtk + n 逼速戰;防禦固定不外推,確保鬼影恆可被擊殺。
  • +
  • 儲存預設 /tmp,可接 Upstash Redis 永久保存。
  • +
+
+
+
模式 C · 即時
+

同時暗回合 PvP

+

兩位真人同時規劃、同時揭示,消除先手優勢。伺服器是唯一權威,seed 絕不下發 client。

+
+ ① PLAN + ② LOCK + ③ RESOLVE + ④ ADVANCE +
+
+ 傷害 = round( max(0, ATK − 對手DEF) × 倍率 )
+ 倍率 = 0.8 + 0.2 × floor((回合−1) / 3) +
+
+
+
+
+ + +
+
+
+

// 06 — 路線圖外的加碼

+

第二職業:野蠻人。

+

戰士靠硬幣節制、慢慢滾雪球;野蠻人把節制整個拆掉——換來的是每出一張牌都要用血付帳。為了它,職業差異被抽成 CLASS_INIT 行為旗標,避免在 core 內散落 if(classType)。

+
+
+
+
+
[無]沒有 DEF。不吃任何防禦機制,受傷不減免。
+
[無]沒有硬幣/連擊/標籤閘門。想打幾張打幾張。
+
[滿]手牌恆滿。出牌後自動補抽到上限。
+
[血]n 自傷曲線。每出 1 張先 n+1,再直接扣 n 點 HP。
+
[池]臨時血量上限。專注 token 抽到即釋放,effMaxHp = maxHp + tempMaxHp。
+
[真]真實傷害 + 蓄力特殊勝利 + 復活。無視 DEF、蓄力 ×15 直接獲勝、死亡前的凝視可復活。
+
+
+
+
1
+
2
+
3
+
4
+
5
+
6
+
+

第 N 張牌的自傷 = N · 打越多、付越痛

+
+
+
+
+
+ + +
+
+
+

// 07 — 決策日誌

+

開工前先拍板的那些事。

+

原版有些行為看起來像 bug、有些規則模糊。重製預設「忠實照舊 + 黃金測試釘死」,但有幾項由原作者明確拍板修改或保留。

+
+
+
+
✔Q1
+

兩種多人都做

+

鬼影先上線,PvP 為獨立增量,互不拖累。

+
+
+
✔Q2
+

重擊改成直觀規則

+

下一張接不上才強制結束;移除原版「中斷時 Coin=0」副作用。寫三案測試。

+
+
+
✔Q5
+

亂數可注入種子

+

統一 PRNG、規範消費順序,加「同 seed+動作 → 同結果」回歸測試。

+
+
+
✔Q7
+

先 1:1 還原

+

平衡校正列為核心交付後的獨立迭代,不在重製階段動數值。

+
+
+
✔Q8
+

只交付戰士

+

法師/盜賊介面預留、不實作。(野蠻人為後來追加的第二職業。)

+
+
+
✔PvP
+

平衡參數定案

+

HP×2、回合倍率遞增、DEF 為延續護盾池、第 10 回合起無視 DEF 灼燒保證收斂。

+
+
+
+
+ + +
+
+
+

// 08 — 怎麼保證不退步

+

黃金測試、內容管線、單容器部署。

+

規則引擎是純函式,所以「規格」可以變成「可執行的測試」。每次改卡、改規則都有固定流程把它鎖回去。

+
+
+
+
QUALITY
+

黃金測試 + CI

+

連擊延遲、重擊強制結束、FATE 加倍砍半、PvP 傷害公式、升級鏈、洗牌決定性……全部釘成測試進 CI。

+
# CI 三步
+npm run build -w @wcg/battle-core
+npm run typecheck
+npm test  # 19 測試檔
+
+
+
PIPELINE
+

改卡的流程

+

只改型別化的單一事實來源,再衍生 JSON、bump 版本指紋——鬼影/PvP 存檔靠指紋判斷是否降級不校驗。

+
# 改 src/data/cards.ts 後
+npm run gen:cards -w @wcg/battle-core
+# 視語意變更 bump
+RULE_VERSION · CARDS_HASH
+
+
+
DEPLOY
+

單容器上線

+

一個 Node 進程同時服務前端靜態檔 + 鬼影 REST + PvP WebSocket,同源免 CORS,部署到 HuggingFace Spaces。

+
# Dockerfile
+build battle-core → web → server
+CMD node server/dist/index.js
+PORT 7860 · WEB_ROOT=web/dist
+
+
+
+
+ + +
+
+
+

// 09 — 現況

+

程式碼才是事實來源。

+
+
+
+ v1.2.0 + RULE_VERSION +
+

+ 早期路線圖(00-roadmap/HANDOFF)寫的「尚未開工」已經過時。 + 實際上 battle-core 規則引擎、鬼影對戰、PvP WebSocket、野蠻人全職業都已落地—— + 野蠻人卡(id 100–191)完成、特殊勝利/復活/跨戰計數齊備。下一步是把 11 關的怪物美術與關卡地圖補齊、PvP 打磨上線,以及替野蠻人 PvP 適配解鎖。 +

+
+
+
+ +
+
+

Worst Card Game · 開發歷程 — 由 guide/ 規格與 packages/ 原始碼整理

+

battle-core v1.2.0 · warrior 0–40 · barbarian 100–191 · 2026-06-23

+

// 三模式共用一份純規則:單機闖關 · 第 12 關鬼影 · 即時 PvP

+
+
+ + + + +