Spaces:
Sleeping
Sleeping
|
Download guide/README.md from WorstCardGame/worst-card-game: direct link, hf CLI and curl.
- Browser
- Download file 4.23 kB
-
https://huggingface.co/spaces/WorstCardGame/worst-card-game/resolve/main/guide/README.md
- Command line
-
hf download hf://spaces/WorstCardGame/worst-card-game/guide/README.md
-
curl -L -o README.md https://huggingface.co/spaces/WorstCardGame/worst-card-game/resolve/main/guide/README.md
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), 交付前請你確認那些是不是你要的設計。