worst-card-game / guide /README.md
freeguy2006's picture
Claude Opus 4.8
feat(ui)+docs: 牌堆檢視翻頁箭頭/選卡不放大;規格資料夾改名 guide
f7c0e6c
|
Raw History Blame Contribute Delete
4.23 kB

guide/ — 網頁多人版重製規格與計畫

這個資料夾是「交給工程師重新實作」用的完整規格 + 計畫。 不含任何實作程式碼;所有遊戲邏輯與設計都從原版 C++ 專案抽取、文件化於此。 原版 ../Lengend-of-Strategy-Card-Game-/ 完全保留、不修改。


這是什麼

原版是一個 raylib + C++ 的單人卡牌 Rogue-like:玩家用「硬幣 / 連擊 / 標籤」系統打牌, 一路打 11 關不斷變強的怪物。本資料夾的目標是把它重做成網頁、可多人連線的版本, 但遊戲規則、卡牌、數值、關卡設計全部沿用(這些才是專案真正的價值)。

工程師只要讀完本資料夾,就能在不看原始 C++ 的情況下,用任何網頁技術棧重建相同的遊戲。


文件導覽(建議閱讀順序)

檔案 內容 給誰看
HANDOFF.md 交付說明(一頁讀完即可開工的轉發版) 全員 / 新進
00-roadmap.md 實作計畫:階段、里程碑、風險、驗收標準 PM / 全員
01-game-design-spec.md 核心玩法與戰鬥規則引擎(連擊/硬幣/標籤、傷害公式、回合流程) 邏輯工程師
02-card-catalog.md 全 41 張卡的數值與精確效果(即時效果 + 連擊效果) 邏輯工程師 / 企劃
03-architecture.md 網頁 + 多人架構、技術棧、模組邊界、多人模式選擇 架構師
04-data-schemas-and-api.md 資料結構(卡表、存檔/鬼影、遊戲狀態)、API 契約 前後端
05-ui-ux-spec.md 畫面、狀態機、版面(沿用原版 UI 行為) 前端 / 設計
07-pvp-design.md 即時 PvP 設計(同時暗回合、權威伺服器、平衡參數) 邏輯 / 後端 / 前端
06-open-questions.md 需要你/團隊拍板的決定 + 原版已知問題清單 決策者
08-card-effectops.md 全 41 張卡 → EffectOp 對照表(可直接填 cards.json) 邏輯工程師
09-golden-tests.md 黃金測試清單(可執行版的規格,進 CI) 邏輯工程師 / QA
10-diagrams.md 架構圖 + 流程圖(系統 / 玩家流程 / 戰鬥 / PvP,Mermaid) 全員
11-content-pipeline.md 內容擴充流程:新增卡牌 / 新增角色(設計→實作→測試→收尾) 全員
12-debugging-guide.md 全端除錯指南(分層定位、工具、實戰案例) 全員 / QA

多人模式:兩者都做(已拍板)

「多人連線」兩種模式都要做,並存於同一份 battle-core:

  • A. 非同步鬼影對戰:錄下你的戰鬥 → 別人下載你的「鬼影」當第 12 關對手。原版已設計好、 技術風險最低、完全沿用現有戰鬥引擎。先做、先上線。詳見 03-architecture.md §3 模式 A。
  • C. 即時 PvP:兩位真人同時暗回合對戰(消除先手優勢)+ 權威伺服器。為原版沒有的全新對稱玩法, 作為鬼影上線後的獨立增量。完整設計見 07-pvp-design.md。

兩模式共用同一規則引擎與卡表,PvP 只在「對局協調 / 同步結算層」與前端相位 UI 新增,鬼影部分不受影響。 PvP 的平衡參數(HP×2、回合攻擊倍率遞增)已由使用者拍板,見 07-pvp-design.md §0。 其餘待拍板事項見 06-open-questions.md。


給原作者(你)的提醒

  • 你在課堂上學的 OOP / 多型設計在重製版仍然用得到(對手介面 Opponent → Monster / Ghost 子類), 這部分的設計理由寫在 03-architecture.md。
  • 本規格忠實記錄原版「實際行為」,包含幾個看起來可能非預期的地方(見 06-open-questions.md), 交付前請你確認那些是不是你要的設計。