Spaces:
Sleeping
Sleeping
|
Download guide/HANDOFF.md from WorstCardGame/worst-card-game: direct link, hf CLI and curl.
- Browser
- Download file 2.92 kB
-
https://huggingface.co/spaces/WorstCardGame/worst-card-game/resolve/main/guide/HANDOFF.md
- Command line
-
hf download hf://spaces/WorstCardGame/worst-card-game/guide/HANDOFF.md
-
curl -L -o HANDOFF.md https://huggingface.co/spaces/WorstCardGame/worst-card-game/resolve/main/guide/HANDOFF.md
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。