dafuweng / README.md
HelloSun's picture
Add development handoff docs and Playwright tests
d8c54c4 verified
|
Raw History Blame Contribute Delete
2.05 kB
metadata
title: 大富翁:Q版小鎮
emoji: 🎲
colorFrom: yellow
colorTo: green
sdk: static
pinned: false
short_description: Q版雙人大富翁,支援自動代玩

大富翁:Q版小鎮

一款可直接在瀏覽器遊玩的 Q 版雙人大富翁。純 HTML/CSS/JavaScript,沒有後端,所有遊戲邏輯都在前端執行。

特色

  • 32 格環形棋盤:地產、車站、公用事業、機會、命運、稅金、監獄、免費停車與銀行。
  • 兩位角色「阿富」與「小滿」,頭像會隨目前玩家切換。
  • 自動代玩:1×/2×/3× 速度,會自動買地、升級、繳費與處理事件。
  • 完整規則:同色地段租金加倍、房屋升級、車站與公用事業租金、坐牢與保釋、破產判定。
  • 30 回合後以總身家決勝,顯示資產結算與獲勝者。
  • 事件紀錄、音效開關、玩法說明、重新開始、手機版排版。

操作

  1. 按「擲骰子」移動目前玩家。
  2. 停在可購買地產時,選擇購買或放棄。
  3. 在自己的地產上可升級房屋;同色地段全部持有時租金加倍。
  4. 按「自動代玩」讓兩位角色自動對戰,可隨時停止。
  5. 30 回合結束或一方破產時,遊戲結束並顯示結果。

圖像

所有角色與場景圖像皆由 Z-Image-Turbo OpenVINO INT4 生成,統一為 Q 版黏土玩具風格,尺寸 256×256。

本機執行

python3 -m http.server 8000

開啟 http://localhost:8000/。

開發文件

  • AGENTS.md:給 AI 接手者的最短規則與指令。
  • DEVELOPMENT.md:完整架構、狀態機、規則公式、測試與部署。
  • tests/:Playwright 冒煙、手機、modal、手動與完整對局測試。
npm install
npx playwright install chromium
npm test
npm run test:full

技術

  • HTML5/CSS3/Vanilla JavaScript
  • 響應式版面與可橫向捲動的棋盤
  • Web Audio API 音效
  • Hugging Face Static Space