Clubhouse Games — Game Specifications Overview

This project collects specification and gameplay documents for each game, for use in subsequent development. Game implementations live under Games/ and are accessible via the Game Overview Menu, with deployment on GitHub Pages. GPT-6 / Astra one-shot demos live under gpt6-astra/ and appear in the menu under 07 Astra.

• Game Overview Menu: index.html (site homepage; select a game to enter)
• Architecture and Deployment: docs/PROJECT-STRUCTURE.md (document structure, Games folder conventions)
• GitHub Pages Build and Deployment: docs/DEPLOYMENT.md (build process, CI, local build:pages)
• Astra gallery: gpt6-astra/ (static one-shots; brief specs in 07-astra/)
• Implemented examples: Blackjack → Games/Blackjack-main/; FreeCell → Games/FreeCell/; Klondike → Games/Klondike/; Block the Smash → Games/Block-the-smash/; Instant Flash → Games/Instant-Flash/; Mystery Liquid Sort → Games/Mystery-Liquid-Sort/

Local Development (Single Server)

Only one development server is started; the menu and all built games are served from the same port.

1. Install dependencies once at the repo root (npm workspaces covers every game):

   npm run setup
   

2. Build the game(s) you want to play, or build all at once:

   npm run build:game Blackjack-main
   # or
   npm run build:all
   

3. Start the server:

   npm run dev
   

4. Open http://localhost:3000: you will see the overview menu; click "Enter Game" to open a built game (e.g. Blackjack).

New games are also built first with npm run build:game <folder-name>, then entered from the menu—you do not need to run 51 separate services.

Directory Structure

類別	資料夾	遊戲數
紙牌類型	01-cards/	6
棋盤類型	02-board/	3
牌張類型	03-tiles-dice/	1
運動機檯類型	04-sports-arcade/	13
串聯拼砌類型	05-puzzle/	8
迷你遊戲類型	06-minigames/	3
Astra 實驗	07-astra/	15

Clubhouse Games

01-紙牌遊戲

• 二十一點 → Games/Blackjack-main/
• 連環新接龍（FreeCell） → Games/FreeCell/
• 克朗代克接龍 → Games/Klondike/
• 花牌 Koi-Koi → Games/Koi-Koi/
• 撿紅點 → Games/Pick-Red/
• 大老二 → Games/Big-Two/

02-棋盤遊戲

• 黑白棋 → Games/Reversi/
• 西洋跳棋 → Games/Checkers/
• 四子棋 → Games/Connect-Four/

03-牌塊與骰子

• 西洋骨牌 → Games/Dominoes/

04-運動與街機

• 玩具拳擊 → Games/Toy-Boxing/
• 玩具棒球 → Games/Toy-Baseball/
• 羽毛球接殺訓練 → Games/Block-the-smash/
• 積木賽車 → Games/Brick-Kart-Racing/
• 海灣帆航 → Games/Sailing/
• 霓虹疾馳 → Games/Cyber-Neon-Rush/
• 棒球人生 → Games/Baseball-Life/
• 球團王朝 → Games/Dynasty/
• →

05-益智遊戲

• 神秘液體排序 → Games/Mystery-Liquid-Sort/
• 俄羅斯方塊 → Games/Tetris/
• 蛇窟迴廊（Roguelike 貪吃蛇） → Games/Roguelike-Snake/
• 魔法氣泡 → Games/Puyo-Puyo/
• 發條守城 → Games/Clockwork-Keep/
• 數字推盤 → Games/Fifteen-Puzzle/
• 記憶配對 → Games/Memory-Match/
• 走透透 → Games/Every-Corner/

06-迷你遊戲

• 武士反應訓練 → Games/Instant-Flash/
• 色感記憶 → Games/Dialed-Color/
• 幣潮 → Games/Coin-Cascade/

07-Astra（GPT-6）

• AI 智慧家庭 → gpt6-astra/webmcp-ai-smart-home/
• 迷你電商 → gpt6-astra/webmcp-mini-amazon/
• 迷你戰術地牢 → gpt6-astra/webmcp-mini-tactical-dungeon/
• 迷你工廠 → gpt6-astra/webmcp-mini-factory/
• 密室逃脫 → gpt6-astra/webmcp-escape-room/
• Agent 看板 → gpt6-astra/webmcp-agent-trello/
• 披薩／漢堡組裝 → gpt6-astra/webmcp-pizza/
• 魔術方塊學院 → gpt6-astra/webmcp-rubiks-cube/