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 → 00-roadmap.md。

第一原則

battle-core = 純規則引擎:不碰畫面、不碰網路,決定性 + 可注入亂數種子;前端、後端、三種模式(單人 / 鬼影 / PvP)共用同一份。規則見 01,卡牌見 02。

建置順序(里程碑)

M0 技術骨架 → M1 純 battle-core + 卡表(寫單元測試)→ M2 單人 11 關網頁可破關 → M3–M4 鬼影對戰(先上線) → **M3+ 即時 PvP(獨立增量)**。詳見 00-roadmap.md。

多人(兩種都做)

  • 非同步鬼影對戰:破關上傳每回合攻防,別人第 12 關下載「鬼影」當對手;只需 REST + DB,先做先上線。
  • 即時 PvP(同時暗回合 + 權威伺服器,設計在 07),已定案:雙方 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。
  • PvP MVP:對稱固定牌組(卡 id 0/2/3/4/6/7/9)、HP×2、四相同時暗回合。

可直接照做、無阻擋

07 §11 與 06 的每一題都有「★已拍板」或「◆建議預設」,工程師照做即可、日後可微調。因 MVP 用固定牌組,處決/百分比卡(17/35/27)與升級鏈的平衡校正延到 M4 draft 才需要。目前沒有任何阻擋開工的待決項;06 中單人規則相關的幾項(怪物史詩 Buff、傳說卡池擴充、消耗卡等)屬「之後再決定」。

技術棧建議

TypeScript + React(前端)+ Node(後端);三層分離、資料/API/WS 協定見 03 / 04。