Sesku — tài liệu ghép client

4 hạt (đỏ/trắng). Cược even / odd / pattern. Envelope lobby game_event; payload bàn proto sesku_event. Frame binary, không JSON.

1. Tổng quan

Side enum

State: Pending · Countdown · DealTime · ShowdownTime · BetTime · PreShowdownTime. Multiplier mặc định [1, 1, 14, 14, 3, 3] — luôn đọc side_list.

2. Demo 4 hạt

Highlight theo finish.win_sides. Pattern và even/odd có thể thắng cùng lúc.

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 sesku

game_event.Request.data_send { room_id: 5  data: <bytes sesku_event.Request> }
game_event.Response.game_message { room_id: 5  data: <bytes sesku_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 sesku_event

C→S Request (oneof)

Request { bet { side: Odd  bet_amount: 1000  count { bet: 1000 count: 1 } } }
Request { multiple_bet {
  bets { side: Odd bet_amount: 1000 }
  bets { side: ThreeRedOneWhite bet_amount: 200 }
} }

S→C Response (oneof)

Response { start_bet { delay_millis: 30000 } }
Response { finish {
  seeds: [true, false, true, true]
  win_sides: [Odd, ThreeRedOneWhite]
  sides_win_amount { side: Odd win_amount: 40000 }
  sides_win_amount { side: ThreeRedOneWhite win_amount: 12000 }
  players_sides_win_amount {
    user_id: 1001  total_amount: 1600  user_money: 501600
    sides_win_amount { side: Odd win_amount: 1000 }
    sides_win_amount { side: ThreeRedOneWhite win_amount: 600 }
  }
} }

room_state — restore

Response { bet {
  user_id: 1001  side: Odd  bet_amount: 1000
  side_total_bet: 9000  seat: 0  player_total_bet: 1000
  count { bet: 1000 count: 1 }
} }
Response { pre_showdown {
  result { user_id: 1001  amount: -1200  user_money: 498800 }
  bet_sides { side: Odd bet_amount: 9000 }
  bet_sides { side: ThreeRedOneWhite bet_amount: 200 }
} }

Lobby payload mẫu

Request { room_config {} }
Request { join_room { room_id: 5  password: ""  is_viewer: false } }
Request { data_send { room_id: 5  data: <sesku_event.Request multiple_bet> } }

Cheat seeds: [true,true,true,true] → FourRed (non-prod). 2 đỏ 2 trắng → Even, không trúng pattern 3+1 / 4.

6. Luồng ghép

1. Connect JWT. Close 1/2/4/5 → dừng.
2. Join. Restore 4 hạt nếu room_state đang showdown.
3. start_bet: enable Even/Odd + 4 pattern. Gửi bet Tag=1.
4. deal khóa. pre_showdown sync chip. finish lật hạt, highlight win_sides, cộng tiền.

7. Error codes

Khi nào chip đổi

8. Checklist client

• Binary protobuf, domain game, một socket / user.
• Bàn = bytes sesku_event.Request trong data_send.
• seeds[i] true = đỏ. Even/odd đếm số đỏ, không đếm trắng.
• Pattern có thể thắng cùng even/odd — cộng mọi win_sides.
• Money: pre_showdown + finish. Cheat seeds chỉ non-prod.