三公 Sam Gong — Multiplayer Card Game

即時多人三公牌局 · Colyseus 0.15 · Node.js · Kubernetes

🎴 線上文件

📖 https://ibalasite.github.io/sam-gong-game-test/

技術架構

遊戲功能

核心對戰

• ✅ 1 莊 + 最多 5 閒，即時多人對戰（Colyseus room state）
• ✅ 完整押注流程（莊家下注 → 閒家跟注/棄牌），傳統 Sam Gong 規則
• ✅ 中途加入（mid-game join）：空位即可入房，本局排隊等下一局
• ✅ Spectator 加入流程：進房預設觀察者，按黃色發光按鈕才算加入；60 秒未按自動踢出
• ✅ 莊家輪莊（順時鐘 + 跳過破產/斷線）

動畫與 UX

• ✅ Round-table 發牌動畫：牌由莊家順時鐘飛出，每張 1 秒（第 3 張 2 秒增加緊張感）
• ✅ 自己的牌逐張翻面：飛到座位時翻面 + coin drop 音效
• ✅ 開牌順序：閒家依 seat 順序先亮牌，莊家最後揭曉
• ✅ 圓桌相對座位：每位玩家看到的相對位置一致（你的右邊永遠是 seat+1）
• ✅ 頭頂計時器：輪到誰頭上浮現金色脈動秒數（≤ 5 秒變紅色急促）
• ✅ 金幣精準流向：結算時輸家→莊家、平手/贏家→退回 called_bet、莊家→贏家付 N× 賠率
• ✅ 自動跟注 / 最低押注（CHECKBOX 預設不勾選，需主動啟用）
• ✅ 結算泡泡顯示盈虧，獎池立即歸 0 對齊動畫
• ✅ 3 秒遊戲開始倒數（2 人按下加入後）
• ✅ 15 秒 per-turn timeout（莊家超時 auto-min-bet / 閒家超時 auto-fold）

聊天與介面

• ✅ 左下角聊天室 + 操作面板並排（可獨立縮合，縮合時跑馬燈顯示本局關鍵訊息）
• ✅ 房間代號分享 / 複製邀請連結 URL
• ✅ 離開按鈕守衛：籌碼押注中時變灰，避免意外損失

斷線與永續（BUG-20260422-019）

• ✅ 已押錢斷線照常結算：保留手牌，依牌贏輸，不影響其他玩家權益
• ✅ 莊家 banker-bet 階段離開：自動中止本局 + 重新倒數，無人損失
• ✅ PostgreSQL chip_balance 永續：結算後寫入 DB + 記 chip_transactions audit trail
• ✅ 重連保護：30 秒重連視窗 + 同暱稱自動接回上次的 chip_balance
• ✅ DB 失敗降級：退化為 in-memory，遊戲不中斷

本地啟動

# 1. 安裝依賴
npm install

# 2. 啟動 Kubernetes 本地環境
kubectl apply -f infra/k8s/local/ -n sam-gong-local

# 3. Port-forward
kubectl port-forward -n sam-gong-local svc/sam-gong-client-service 8080:80
kubectl port-forward -n sam-gong-local svc/sam-gong-server-service 2567:2567

# 4. 開啟瀏覽器
open http://localhost:8080

文件目錄

變更歷史

Generated with devsop-autodev · 2026-04-23