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

Mini-game 3 xúc xắc. Cược cửa Big / Small. Có leaderboard, history, sessions, logs trên cùng WS. Envelope lobby game_event; payload bàn proto sicbo_event. Frame binary, không JSON.

1. Tổng quan

State: Pending=0 · Countdown=1 · DealTime=2 · ShowdownTime=3 · BetTime=4.

2. Demo xúc xắc

Chip vàng = cửa API thắng. Even/Odd là hiển thị tổng (15 lẻ) — không gửi trong RequestBet.side.

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 sicbo

game_event.Request.data_send { room_id: 7  data: <bytes sicbo_event.Request> }
game_event.Response.game_message { room_id: 7  data: <bytes sicbo_event.Response> }

4. Lobby C→S / S→C

5. Gameplay proto sicbo_event

C→S Request (oneof)

Request { bet { side: Big  bet_amount: 5000 } }
Request { session_commands { session: 8821  side: Big  from: 0  to: 50 } }

S→C ResponseBet (echo ngay khi cược)

S→C vòng chơi

Response { start_bet { delay_millis: 30000  end_at: 1720000030 } }
Response { deal { session: 8821 } }
Response { finish {
  dices: [4, 5, 6]
  win_side: Big
  score: 15
  win_amount: 10000
  user_money: 505000
  win_bet_amount: 5000
  returned_amount: 5000
} }

room_state — restore

Response { bet {
  user_id: 1001  side: Big  bet_amount: 5000
  total_bet: 5000  user_money: 495000  total_side_bet: 1200000
} }
Response { update_status {
  user_big_count: 86  user_small_count: 41
  big_total_bet: 1200000  small_total_bet: 800000
} }

Bảng phụ

ResponseHistory.history[]: session, time, bet_side, win_side, bet, returned_amount, win_amount
ResponseSessions.sessions[]: time, session, dices, score, total_bet_big/small, total_returned_*, win_side, number_of_commands_*
ResponseSessionCommands: session, from, to, side, commands[{time, total_bet, returned, side, user_id, username}]
ResponseLeaderboard.members[]: rank, name, user_id, total_win
ResponseLogs: logs[{dices, score, win_side, session}], current_session

Lobby payload mẫu

Request { room_config {} }
Request { join_any_room { bet: 5000  max_players: 0 } }
Request { create_room { bet: 5000  password: ""  max_players: 100  name: "sicbo-1" } }
Request { data_send { room_id: 7  data: <sicbo_event.Request bet> } }

Một user một socket. Gửi join lần 2 khi đã trong phòng → lobby 114/119. Hết chip → 120.

6. Luồng ghép

1. Connect JWT trên domain sicbo. Close 1/2/4/5 → dừng.
2. room_config rồi join. Restore room_state (session, totals, dices nếu đang showdown).
3. start_bet: đếm end_at, enable Big/Small.
4. Gửi bet Tag=1. Cập nhật chip từ echo user_money, vẽ total_side_bet.
5. deal khóa cửa. Animate 3 xúc xắc theo finish.dices, highlight win_side, cộng win_amount.
6. Mở panel: leaderboard / history / sessions / session_commands khi user tap.

7. Error codes

Khi nào chip đổi

8. Checklist client

• Binary protobuf, domain game, một socket / user.
• Action bàn = data_send.data bytes sicbo_event.Request.
• API side chỉ Big/Small. Even/Odd chỉ UI từ tổng dices.
• Chip: echo bet + finish.user_money. Công thức win = win_bet + returned.
• Phiên: dùng session trên deal/logs/session_commands.
• Cheat dices chỉ non-prod. Không spam bet ngoài BetTime (code 1).
• update_status định kỳ — vẽ lại thanh Big/Small totals, đừng interpolate.