Dragon Tiger — tài liệu ghép client

Cược Dragon / Tiger / Tie (+ Big/Small từng cửa). Mỗi bên 1 lá. Envelope lobby game_event; payload bàn proto dragontiger_event. Frame binary protobuf.

1. Tổng quan

Side enum

State: Pending · Countdown · DealTime · ShowdownTime · BetTime · PreShowdownTime. Tỷ lệ lấy room_state.side_list (vd Tie 10:1).

Cược chỉ trong BetTime sau start_bet. multiple_bet để đặt Dragon + Tie một lúc.

2. Demo Dragon vs Tiger

Viền vàng = win_sides chứa Dragon. Lật 2 lá theo finish.dragon_card / tiger_card. Rank K > 7 → Dragon thắng; Tie nếu hai rank bằng nhau.

Card id

id = rank * 4 + suit. Rank 0=A … 12=K (tuỳ enum gamecard). Suit 0–3. Ví dụ K♥ ≈ 44, 7♠ ≈ 20 — lấy đúng field int32, client map sprite.

3. WS envelope (đầy đủ)

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

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

game_event.Request.data_send { room_id: 11  data: <bytes dragontiger_event.Request> }
game_event.Response.game_message { room_id: 11  data: <bytes dragontiger_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 dragontiger_event

C→S Request (oneof)

Request { bet { side: Dragon  bet_amount: 1000  count { bet: 1000 count: 1 } } }
Request { multiple_bet { bets { side: Dragon bet_amount: 500 } bets { side: Tie bet_amount: 100 } } }

S→C Response (oneof)

Response { start_bet { delay_millis: 30000 } }
Response { finish {
  dragon_card: 44
  tiger_card: 20
  win_sides: [Dragon, DragonBig]
  dragon_score: 13
  tiger_score: 7
  sides_win_amount { side: Dragon  win_amount: 80000 }
  players_sides_win_amount {
    user_id: 1001  total_amount: 1000  user_money: 501000
    sides_win_amount { side: Dragon win_amount: 1000 }
  }
} }

room_state — restore

Response { bet {
  user_id: 1001  side: Dragon  bet_amount: 1000
  side_total_bet: 22000  seat: 0  player_total_bet: 1000
  count { bet: 1000 count: 1 }
} }
Response { pre_showdown {
  result { user_id: 1001  amount: -1000  user_money: 499000 }
  bet_sides { side: Dragon  bet_amount: 22000 }
} }

Lobby payload mẫu

Request { room_config {} }
Request { join_room { room_id: 11  password: ""  is_viewer: false } }
Request { data_send { room_id: 11  data: <dragontiger_event.Request bet> } }

Big/Small là side bet theo rank lá (không phải tổng điểm). Multiplier mặc định Tie 10:1; đọc side_list chứ đừng hardcode. Cheat dragon_card/tiger_card chỉ non-prod.

6. Luồng ghép

1. Connect JWT. Close 1/2/4/5 → dừng.
2. room_config rồi join. Restore felt từ room_state.
3. start_bet mở cửa. Gửi bet Tag=1 (hoặc multiple_bet).
4. deal khóa. pre_showdown sync money. finish lật 2 lá, highlight win_sides.

7. Error codes

Khi nào chip đổi

8. Checklist client

• Binary protobuf, domain game, một socket / user.
• Bàn = data_send.data bytes dragontiger_event.Request.
• Decode card id = rank×4+suit. So sánh rank, không phải điểm baccarat.
• Side bet Big/Small theo side_list — đừng hardcode multiplier.
• Money: pre_showdown + finish. Cheat chỉ non-prod.
• Restore: nếu room_state đã có dragon_card/tiger_card thì lật sẵn, đừng chờ finish.
• Tie thường trả side bet Dragon/Tiger = 0 (push/mất tùy room_config) — tin win_sides.
• Không gửi bet khi không phải BetTime (gameplay error 1).
• count[] chỉ để animate chip stack — server tính theo bet_amount.