Ocean King — tài liệu ghép client

Bắn cá realtime: spawn → shoot (trừ đạn) → hit. Có ultimate, gun skill, đóng băng, vòng quay may mắn. TagHit=1.

1. Tổng quan

Cá có đường direction[] (Coordinate x,y), lifetime, bornTime. Item nổi: Fire / Electromagnetic / Ice / Chest. Boss: GoldDragon, GodOfWealth, Wukong…

2. Demo bàn (CSS)

Bể 3 cá + pháo dưới đáy. Client nội suy vị trí theo bornTime + sync_time.

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 oceanking_event)

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

shoot { gun: Default, bullet: 100, metadata: <aim bytes>, user_money: 500000 }
hit   { fish_id: 17, gun: Default, bullet: 100 }          // TagHit=1
cast_ultimate_skill { skill: Kraken, bullet: 100 }
cast_gun_skill { gun: Torpedo, affected_fish: [17,18], metadata: <aoe> }
sync_time { time: 1710000000123 }
update_fps { fps: 60 }

7. Gameplay S→C

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

LuckyWheelResult: multipliers[7], pos 0–6, win_amount, user_money. SpecialGunClaimed: item_id, duration, frozen_time, frozen_end_at.

8. Luồng ghép

1. Join room → start_game + room_state (cá đang bơi).
2. fish_spawned liên tục. Nội suy path.
3. shoot (trừ bullet) — broadcast cho ghế khác.
4. Collision client → hit. Cá chết: ResponseHit + amount. Cá sống: update_money.
5. Định kỳ sync_time / update_fps. Ultimate/gun skill khi đủ điều kiện.
6. Rời ngay (AllowLeaveNow) bằng leave_room.

9. Error codes

10. Checklist client

• Không đoán kill local — đợi hit / update_money.
• user_money trên shoot/hit là source of truth.
• skill_castable khi total_shots=100; cast xong reset.
• Đồng bộ đồng hồ bằng delay của sync_time.
• Frozen/stun theo frozen_end_at / stun_end_at (ms).