| 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](https://huggingface.co/HelloSun/Z-Image-Turbo-OpenVINO-INT4) 生成，統一為 Q 版黏土玩具風格，尺寸 256×256。 | |
| ## 本機執行 | |
| ```bash | |
| python3 -m http.server 8000 | |
| ``` | |
| 開啟 `http://localhost:8000/`。 | |
| ## 開發文件 | |
| - [`AGENTS.md`](AGENTS.md)：給 AI 接手者的最短規則與指令。 | |
| - [`DEVELOPMENT.md`](DEVELOPMENT.md)：完整架構、狀態機、規則公式、測試與部署。 | |
| - `tests/`：Playwright 冒煙、手機、modal、手動與完整對局測試。 | |
| ```bash | |
| npm install | |
| npx playwright install chromium | |
| npm test | |
| npm run test:full | |
| ``` | |
| ## 技術 | |
| - HTML5／CSS3／Vanilla JavaScript | |
| - 響應式版面與可橫向捲動的棋盤 | |
| - Web Audio API 音效 | |
| - Hugging Face Static Space | |