Bandar QQ — tài liệu ghép client

Betting kiểu Baccarat nhưng lá là domino (bộ 28). Red vs Blue, mỗi bên 2 lá. Điểm = tổng pip mod 10. Có tip dealer. Envelope game_event + proto bandarqq_event.

1. Tổng quan

Side enum

State: Pending · Countdown · DealTime · ShowdownTime · BetTime · PreShowdownTime. room_state.tip_dealer_amount = số chip mỗi lần tip.

2. Demo Red vs Blue

Red 3-3 + 2-0 = 8; Blue 3-1 + 3-4 = 11 → 1. Red thắng. Twin: lá 3-3.

3. WS envelope (đầy đủ)

Frame binary protobuf. Handshake: 0 closed · 1 other device playing · 2 too many conn · 4 token expired · 5 banned.

GET /ws?access_token=<JWT>     // domain game bandarqq

game_event.Request.data_send { room_id: 3  data: <bytes bandarqq_event.Request> }
game_event.Response.game_message { room_id: 3  data: <bytes bandarqq_event.Response> }

Ngoài data: user_joined / user_left / start_countdown / start_game / reset_game / auto_leave.

4. Lobby C→S / S→C

5. Gameplay proto bandarqq_event

C→S Request (oneof)

Request { bet { side: Red  bet_amount: 1000  count { bet: 1000 count: 1 } } }
Request { tip_dealer {} }

S→C Response (oneof)

Response { tip_dealer { user_id: 1001  amount: 1000  user_money: 499000 } }
Response { finish {
  red_cards: [24, 14]
  blue_cards: [22, 25]
  win_sides: [Red]
  red_score: 8
  blue_score: 1
  sides_win_amount { side: Red win_amount: 50000 }
  players_sides_win_amount {
    user_id: 1001  total_amount: 1000  user_money: 501000  vip: 1
    sides_win_amount { side: Red win_amount: 1000 }
  }
} }

room_state — restore

Response { bet {
  user_id: 1001  side: Red  bet_amount: 1000
  side_total_bet: 15000  seat: 1  player_total_bet: 1000
} }
Response { pre_showdown {
  result { user_id: 1001  amount: -1000  user_money: 498000 }
  bet_sides { side: Red bet_amount: 15000 }
} }

Lobby payload mẫu

Request { room_config {} }
Request { join_any_room { bet: 1000  max_players: 0 } }
Request { data_send { room_id: 3  data: <bandarqq_event.Request tip_dealer> } }

Tip Tag=2 có thể gửi ngoài BetTime (tùy server ActionNotAllowed). amount trên ResponseTipDealer = số đã trừ, không phải số dư.

6. Luồng ghép

1. Connect JWT. Close 1/2/4/5 → dừng.
2. Join. Restore từ room_state (kể cả 4 lá nếu đang showdown).
3. start_bet → cược Red/Blue/side. Tip bất kỳ lúc đủ chip (Tag=2).
4. deal khóa cược. finish lật 2 cặp domino, highlight win_sides, cập nhật money.

7. Error codes

Khi nào chip đổi

8. Checklist client

• Binary protobuf, domain game, một socket / user.
• Bàn = bytes bandarqq_event.Request trong data_send.
• Card id = head×7+tail. Vẽ 2 pip, không phải bài tây.
• Nút tip enable khi user_money ≥ tip_dealer_amount.
• Money: echo tip + pre_showdown + finish. Cheat chỉ non-prod.