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

Minigame 1 người: cược, multiplier tăng theo đồng hồ server, cash out trước khi nổ. Client nói WebSocket binary protobuf trực tiếp crash_event — không lobby, không phòng, không bọc game_event.

1. Tổng quan

cashout_at phải nằm trong [min_multiplier, max_multiplier] từ snapshot (mặc định 1.01 … 100 nếu game.json không khai báo). Bet chỉ gửi giá trị trong bets[].

2. Proto cho client

Tải file .proto rồi generate code (protoc / buf). Frame WS là binary protobuf, không JSON. Crash không bọc game_event.

GET /crash/crash_event.proto
# Host = domain DOCUMENT (trang docs này), không phải domain GAME.

3. Demo đồ thị

Ví dụ ván bet 1000, auto cash out 2.00×. Đường vàng = multiplier đang chạy. Nét đứt xanh = mục tiêu auto. Chấm đỏ = crash point server (client không biết trước).

Animate theo start_time + tick next. Snap multiplier mỗi tick (~200ms). Đừng tự random điểm nổ. 10 giây = +1.0×.

4. WS envelope

GET /ws?access_token=<JWT>     // domain game crash
// mỗi frame binary = protobuf crash_event.Request  (C→S)
//                   hoặc crash_event.Response (S→C)

Handshake HTTP 200 JSON {"code": N} nếu không giữ được socket:

Một user một socket. Login máy khác → socket cũ đóng WS code 69 ("other player logged in your account"). Giữ socket mới.

Keepalive: server gửi binary 1 byte 0x00 ~15s; client trả 0x01 trong 25s. Frame 1 byte này không phải protobuf.

crash_event.Request { gameplay {} }
crash_event.Request { play { bet: 1000  cashout_at: 2.0 } }
crash_event.Request { cashout { timestamp: 1720000015000000000 } }

crash_event.Response { gameplay { ... } }
crash_event.Response { play { bet, cashout_at, max_profit } }
crash_event.Response { next { elapse, start_time, multiplier, status, ... } }
crash_event.Response { cashout { multiplier, profit, user_money } }
crash_event.Response { error { code, tag } }

5. RequestGameplay — snapshot

Gửi sau mỗi lần connect / reconnect. Server không tự đẩy snapshot lúc Connected. Nếu is_playing thì restore HUD, không gửi Play lại.

Request { gameplay {} }

Response { gameplay {
  is_playing: true
  current_bet: 1000
  current_cashout_multiplier: 2.0
  current_multiplier: 1.50
  current_profit: 1500
  bets: [200, 1000, 2000, 10000]
  show_bets: [200, 1000, 2000, 10000]
  user_money: 499000
  min_multiplier: 1.01
  max_multiplier: 100
} }

6. RequestPlay

Debit bet ngay. Một user chỉ 1 ván: Play khi is_playing → error code 1 tag 1.

Request { play { bet: 1000  cashout_at: 2.0 } }

Response { play {
  bet: 1000
  cashout_at: 2.0
  max_profit: 2000
} }

Sau Play: khóa nút Play, trừ chip local = bet (hoặc đợi tick đầu / gửi lại gameplay nếu cần user_money chính xác — Play response không có money). Bắt đầu animate từ 0×.

7. Tick / ResponseNext

Server đẩy ~200ms khi ván đang chạy. Dùng để vẽ đồ thị. Không phải tín hiệu thắng.

Response { next {
  elapse: 15
  start_time: 1720000000000000000
  multiplier: 1.50
  status: Processing
  timestamp: 1720000015000000000
  is_cashed_out: false
  profit: 0
  profit_multiplier: 1.50
} }

8. Cash out

Manual — RequestCashOut

Gửi khi đang Processing. Server lấy multiplier tại lúc handle request, không dùng field timestamp.

Request { cashout { timestamp: <unix nano, debug> } }

Response { cashout {
  multiplier: 1.50
  profit: 1500
  user_money: 500500
} }

Ví dụ: bet 1000 đã trừ lúc Play, cash out 1.50× → profit = 1500, net +500, user_money tăng 1500 so với sau Play.

Auto

Nếu multiplier chạm cashout_at trước crash, server tự gửi cùng ResponseCashOut (multiplier đúng bằng target, không phải tick trễ). Client không cần gửi cashout.

9. Crash

Không có message riêng. Server gửi ResponseNext với status: Crash. Stake đã trừ lúc Play, không hoàn, không WIN.

Response { next {
  elapse: 18.4
  start_time: 1720000000000000000
  multiplier: 1.84
  status: Crash
  timestamp: 1720000018400000000
  is_cashed_out: false
  profit: 0
  profit_multiplier: 1.84
} }

multiplier lúc này = crash point. Animate nổ tại điểm đó, hiện “CRASHED”, mở lại nút Play. Chip không đổi so với sau Play (đã mất bet).

Điểm nổ được sample lúc Play, client không bao giờ thấy trước. Một phần ván nổ dưới 1.0× — dưới sàn auto cash out nên luôn thua nếu không (và không thể) cash out sớm hơn min_multiplier.

10. Tiền

11. Luồng ghép

1. Connect JWT trên domain crash. JSON code 2/4/5/6 → dừng. Socket cũ đóng 69 → coi như bị đá, giữ connection mới.
2. Gửi gameplay. Render bets / show_bets, slider cashout_at trong min/max, chip = user_money.
3. Nếu is_playing: restore đồ thị từ current_multiplier + start_time (tick kế sẽ tới), enable Cash out. Không Play.
4. User chọn bet + auto target → play. Khóa Play. Animate từ 0×. Cập nhật chip −bet.
5. Mỗi next Processing: set HUD = multiplier, vẽ điểm mới. Nút Cash out bật.
6. Tap Cash out → cashout. Nhận cashout: dừng đồ thị, hiện profit, chip = user_money.
7. Hoặc nhận auto cashout khi chạm target, hoặc next status: Crash → nổ, mất bet.
8. Mở lại Play. Không history / leaderboard trên WS này.

Reconnect giữa ván: listen ngay (có thể nhận next / cashout / Crash do settle lúc Connected), rồi gửi gameplay để sync HUD.

12. Error codes

Nằm trong Response.error. tag cho biết request nào: 1 = Play, 2 = Cash out. Comment proto (RequestBet / TipDealer) là copy game khác — bỏ qua.

Response { error { code: 1  tag: 1 } }   // Play lúc đang bay
Response { error { code: 6  tag: 2 } }   // Cash out trễ / trùng

13. Checklist client

• Tải proto: crash_event.proto.
• Domain crash, binary crash_event — không lobby, không JSON gameplay HTTP.
• Sau connect: luôn gameplay. Restore nếu is_playing.
• Bet ∈ bets; cashout_at ∈ [min_multiplier, max_multiplier].
• Đường cong từ 0, 10s / 1.0×. Snap theo next.multiplier.
• Thắng chỉ khi nhận cashout. Crash = next.status == Crash, không cộng chip.
• profit / max_profit là gross (stake đã trừ).
• cashout.timestamp không ảnh hưởng kết quả — có thể gửi unix nano local.
• Disconnect không hủy ván. Reconnect listen + gameplay. Socket cũ đóng 69.
• Pong 0x01 cho ping 0x00. Không spam cash out.
• Không có top-win / history trên node này.