worst-card-game / guide /HANDOFF.md
freeguy2006's picture
Claude Opus 4.8
feat(ui)+docs: 牌堆檢視翻頁箭頭/選卡不放大;規格資料夾改名 guide
f7c0e6c
|
Raw History Blame Contribute Delete
2.92 kB
# 交付說明(給工程師)
> 這頁讀完即可開工;細節進各章節文件(`00`–`07`)。原版 `../Lengend-of-Strategy-Card-Game-/` 保留、不讀、不改。
## 專案
一個卡牌 Rogue-like(原 C++/raylib 單機桌面版),重做成**網頁版 + 兩種多人連線**。遊戲規則、41 張卡、關卡與數值全部沿用,已抽取整理於本資料夾。
## 怎麼開始
- 以 **`guide/`** 為**唯一實作依據**,從頭重寫;舊 C++ 程式不需閱讀、不要修改。
- 先讀 [`README.md`](README.md) → [`00-roadmap.md`](00-roadmap.md)。
## 第一原則
**battle-core = 純規則引擎**:不碰畫面、不碰網路,**決定性 + 可注入亂數種子**;前端、後端、三種模式(單人 / 鬼影 / PvP)共用同一份。規則見 [`01`](01-game-design-spec.md),卡牌見 [`02`](02-card-catalog.md)。
## 建置順序(里程碑)
M0 技術骨架 → M1 純 battle-core + 卡表(寫單元測試)→ M2 單人 11 關網頁可破關 → **M3–M4 鬼影對戰(先上線)** → **M3+ 即時 PvP(獨立增量)**。詳見 [`00-roadmap.md`](00-roadmap.md)。
## 多人(兩種都做)
- **非同步鬼影對戰**:破關上傳每回合攻防,別人第 12 關下載「鬼影」當對手;只需 REST + DB,先做先上線。
- **即時 PvP**(同時暗回合 + 權威伺服器,設計在 [`07`](07-pvp-design.md)),已定案:雙方 **HP×2**;每回合攻擊倍率 `0.8 + 0.2×floor((r−1)/3)`;傷害 `round(max(0, ATK − 對手DEF) × 倍率)`(DEF 先擋、再乘、四捨五入);**DEF 為延續累積護盾池**;**不限單回合出牌數**(靠 `T_PLAN=30s`);反僵局用**無視 DEF 的對稱灼燒**(`RAMP_TURN=10`,逐回合遞增,保證收斂)。
## MVP 範圍內的功能(明確要做)
- 單人 11 關完整流程、41 張卡(即時效果 + 延遲一張的連擊效果 + 升級鏈)、三種獎勵卡池、怪物逐關成長。
- **三堆檢視器**:抽牌堆 / 棄牌堆 / 消耗堆三個指示器(顯示張數),可點開看該堆「有哪些卡」,但**不顯示順序**——以「同名合併計數 + 固定排序」呈現,抽牌堆的順序與 seed 絕不外流;由 battle-core 的 `pileView(state, pile)` 提供。完整規格見 [`05 §8`](05-ui-ux-spec.md)。
- PvP MVP:對稱固定牌組(卡 id 0/2/3/4/6/7/9)、HP×2、四相同時暗回合。
## 可直接照做、無阻擋
[`07 §11`](07-pvp-design.md) 與 [`06`](06-open-questions.md) 的每一題都有「★已拍板」或「◆建議預設」,工程師照做即可、日後可微調。因 MVP 用固定牌組,處決/百分比卡(17/35/27)與升級鏈的平衡校正**延到 M4 draft** 才需要。目前**沒有任何阻擋開工的待決項**;`06` 中單人規則相關的幾項(怪物史詩 Buff、傳說卡池擴充、消耗卡等)屬「之後再決定」。
## 技術棧建議
TypeScript + React(前端)+ Node(後端);三層分離、資料/API/WS 協定見 [`03`](03-architecture.md) / [`04`](04-data-schemas-and-api.md)。