Bork Deng — tài liệu ghép client

PvP bài đối banker: cược → chia bài → rút/sẵn sàng → so bài. Có jackpot. Client nói WebSocket binary protobuf với domain GAME.

1. Tổng quan

ID lá bài: rank × 4 + suit. Rank 0=2 … 12=A. Suit 0=♠ 1=♣ 2=♦ 3=♥. Ví dụ 3♠ = 4. Banker ngồi cố định; player cược rồi nhận 2 lá. drawable thì rút thêm hoặc ready. Bork lật ngay (deal_bork / is_bork).

2. Demo bàn (CSS)

Bàn oval: banker đối diện 2 ghế player. Lá ngửa = đã chia; lá xanh = úp.

3. Kết nối & envelope

Mọi frame WebSocket là binary protobuf — không JSON. Một user chỉ được một connection; login trùng → lobby error 102.

GET /ws?access_token=<JWT>
# Host = domain GAME (không phải docs). Frame = bytes proto, không text JSON.

Envelope lobby package game_event (internal/proto/game-event). Payload bàn nằm trong data_send.data (C→S) và game_message.data (S→C) — bytes của proto game.

4. Lobby C→S (game_event.Request)

create_room { bet: 1000, password: "", max_players: 4, name: "ban-1" }
join_room   { room_id: 42, password: "", is_viewer: false }
data_send   { room_id: 42, data: <marshal(game Request)> }
data_send   { room_id: 42, auto_leave: {} }

5. Lobby S→C (game_event.Response)

RoomType (trong room_config)

Flag room_config: disable_create · disable_find · disable_get_list · disable_select (chỉ Play now) · play_now · best_choice (bet gợi ý). Room: room_id, is_private, bet, create_time, metadata map, name. metadata thường có max_players, number_of_players, label.

game_message.msg

error.tag — gói nào gây lỗi

Luồng sảnh (mọi game WS này)

1. Mở WS GET /ws?access_token= trên domain GAME. Đọc close code nếu fail.
2. Gửi room_config. Render mức cược; ẩn nút theo disable_* ; Play now nếu play_now.
3. Tuỳ UI: get_room_list / find_room / create_room / join_any_room / join_room.
4. Ngồi bàn: nhận user_joined (kể cả mình), có thể room_state trong game_message.data.
5. Đủ người: start_countdown rồi start_game. Từ đây chỉ gửi action qua data_send.data.
6. Chat: send_chat_message → chat_message. Mời: free_users_list → invite → đối phương nhận someone_invited_you.
7. Hết ván: reset_game. Rời: leave_room hoặc data_send.auto_leave (out sau ván).

6. Gameplay C→S (proto borkdeng_event)

Marshal message dưới thành bytes, gửi trong data_send.data.

Cheat (start_cheat / cheat) chỉ non-prod. Production bỏ qua.

// C→S data_send.data = borkdeng_event.Request
bet  { amount: 5000 }          // TagBet=1
draw { }                       // TagDraw=2
ready { }                      // TagReady=3
jackpot { }
jackpot_history { }

7. Gameplay S→C

Nằm trong game_message.data. Reconnect: unmarshal room_state trước, rồi sync UI.

8. Luồng ghép

1. WS GET /ws?access_token=. Gửi room_config rồi join_any_room / create_room / join_room.
2. Nhận user_joined, start_countdown, rồi start_game.
3. start_bet → gửi bet{amount}. Đợi echo bet + user_money.
4. deal: render cards. Nếu is_bork lật luôn. Nếu drawable cho nút rút / sẵn sàng tới end_at.
5. draw hoặc ready. Người khác: animate theo seat.
6. show_down: so với banker, cộng win_amount / jackpot_amount từ player_results.
7. Rời: leave_room hoặc data_send.auto_leave.

9. Error codes

10. Checklist client

• Binary protobuf 2 lớp; một WS / user.
• Chip lấy từ bet.user_money / show_down.player_results[].user_money — đừng tự trừ.
• Timer theo end_at unix, không hardcode giây.
• Bork: lật bài khi is_bork hoặc nhận deal_bork.
• Jackpot UI từ jackpot + field jackpot_amount trên showdown.
• Reconnect: parse room_state (state, cards, players, max_bet).