PvP · betting table

Domino Bet — tài liệu ghép client

Cùng handler và proto domino_event với Domino Gaple, khác GAME_ID và gói deploy. Document đầy đủ dưới branding bàn cược — không tái sử dụng trang Gaple.

1. Tổng quan

Reuse code: gameplay handler + package domino_event của dominogaple. Client vẫn kết nối domain GAME của dominobet, GAME_ID = dominobet. TagPlay=1.

Mục	Giá trị
GAME_ID	`dominobet`
Proto / handler	`domino_event` · shared dominogaple
Tag	`TagPlay=1`
EndType	NormalEnd · DeadEnd
Connect	`GET /ws?access_token=` trên domain GAME dominobet

ID quân: head × 7 + tail (head/tail 0–6). Chuỗi bàn: table_cards[0] = đầu, phần tử cuối = đuôi. Lobby (create/join/list/invite/chat/data_send) đầy đủ như mục 4–5 — không được bỏ qua vì “giống Gaple”.

2. Demo bàn (CSS)

Cùng chuỗi domino nhưng felt nâu/vàng kiểu bàn cược, chip mức bet giữa bàn.

BET 1.000

H 6

T 0

Seat 0

Seat 1

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.

Handshake close	Ý nghĩa — client phải làm
`0`	Closed — đóng bình thường, có thể reconnect
`1`	Other device — đang chơi máy khác, hiện toast, đừng spam reconnect
`2`	Too many — quá nhiều connection, đợi rồi thử lại
`4`	Expired — JWT hết hạn, lấy token mới rồi connect lại
`5`	Banned — tài khoản bị cấm, dừng retry

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.

C→S game_event.Request

data_send.data = bytes game Request

S→C game_event.Response

game_message.data = bytes game Response

Unmarshal 2 lớp: (1) lobby Request/Response. (2) Nếu oneof là data thì unmarshal tiếp proto game. room_id trên envelope phải khớp bàn đang ngồi. Cheat chỉ non-prod.

4. Lobby C→S (game_event.Request)

oneof	Field	Mô tả
`room_config`	(empty)	Lấy config sảnh ngay sau handshake
`get_room_list`	`bet` int64	List bàn theo đúng mức cược
`create_room`	`bet` int64, `password` string, `max_players` int32, `name` string	Tạo bàn. password rỗng = public
`join_room`	`room_id` int32, `password` string, `is_viewer` bool	Vào bàn chỉ định. Viewer tạm để `false`
`join_any_room`	`bet` int64, `max_players` uint32	Matchmaking. max_players=0 = mọi size
`leave_room`	`room_id` int32	Rời bàn ngay
`find_room`	`room_id` int32	Tra cứu trước khi join (private?)
`invite`	`room_id`, `password`, `user_id`	Mời user rảnh
`free_users_list`	`bet` int64	User rảnh cùng mức cược, không đang bàn khác
`send_chat_message`	`room_id`, `message`, `to[]` int32, `is_private_chat`	Chat bàn; whisper khi is_private_chat + to
`data_send`	`room_id` + oneof `data` bytes \| `auto_leave`	Mọi action gameplay. auto_leave = đăng ký out cuối ván

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)

oneof	Field	Mô tả
`error`	`code` uint32, `tag` uint32	Lỗi lobby. tag = request gây lỗi (bảng dưới)
`game_message`	`room_id`, `create_time`, oneof `msg`	Tin từ bàn
`chat_message`	`room_id, user_id, message, name, vip`	Chat broadcast
`room_list`	`bet`, `rooms[]`	Danh sách bàn
`room_config`	xem bảng RoomType + flag	UI sảnh
`find_room`	`room_id`, `is_private`	true → hiện ô mật khẩu
`free_users_list`	`players[]` {user_id, avatar, name, vip}	Danh sách mời
`invite`	`user_id`	Ack đã gửi lời mời
`someone_invited_you`	`user_id, name, avatar, room_id, password`	Push khi bị mời — join_room với password này

RoomType (trong room_config)

Field	Ý nghĩa
`bet, ccu, joinable`	Mức cược, số người online, có vào được không
`vip_min/max, level_min/max`	Điều kiện VIP / level
`chip_amount_min/max`	Sàn/trần chip để ngồi bàn
`number_of_played_games_min/max`	Số ván đã chơi

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

oneof	Field	Client
`data`	bytes	Unmarshal proto game Response
`user_joined`	user_id, name, chip, avatar, seat, room_id, state, vip, level	state 0=view · 1=play. Seat 0..max
`user_left`	user_id, disconnect	disconnect=true nếu mất WS giữa ván
`start_countdown`	seconds, data bytes	Đếm ngược; data có thể chứa payload game
`start_game`	players[] (cùng field user_joined trừ room_id), data	Khóa ghế, bắt đầu ván
`reset_game`	players[]	Ván xong, bàn về pending
`auto_leave`	user_id, auto_exit	Ack đăng ký thoát cuối ván

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

tag	Request	tag	Request
100	room_config	106	data_send
101	create_room	107	send_chat_message
102	join_room	108	find_room
103	join_any_room	109	free_users_list
104	get_room_list	110	invite
105	auto_leave

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

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

Reconnect giữa ván: giữ cùng JWT, join_room lại (cùng room_id). Server trả game_message.data = room_state proto game. Đừng tạo phòng mới. Một user một socket — socket cũ bị đóng với handshake 1 hoặc lobby 102.

Cấm	Lý do
JSON trên WS	Server chỉ unmarshal protobuf binary
Hai tab cùng account	102 duplicated login / handshake 1
data_send khi chưa join	118 not in room / 103 not found
create_room bet lạ	115 bet not found

Lỗi lobby: 100 missing payload · 102 duplicated login · 103 room not found · 108 bad password · 113 room full · 114 in other room · 115 bet not found · 120 not enough money. Bảng đầy đủ mục Errors.

6. Gameplay C→S (proto domino_event)

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

oneof	Field	Tag
`play`	`card` (id = head×7+tail), `head` bool	TagPlay=1. Gửi trong data_send của phòng dominobet

Không có message cược riêng trong proto game — mức bet là bet của phòng lobby (create_room.bet / Room.bet).

play { card: 48, head: true }   // 6-6 = 6*7+6, gắn đầu
play { card: 14, head: false }  // 2-0 gắn đuôi

7. Gameplay S→C

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

oneof	Field	Khi nào
`deal`	cards[], dealer_id	Chia quân, hiện dealer
`player_turn`	seconds, user_id, update_chip[], is_lewat, passed_values[], end_at	Lượt + thanh toán lewat (chip bay trên felt)
`player_play`	user_id, card, head, number_of_cards, head_value, tail_value, is_auto	Cập nhật chuỗi
`finish`	winner_id, multiplier, result[{amount,user_money,cards,lewats,total_win_amount}], end_type, bright_cards	Tính tiền bàn cược: multiplier × điểm + lewat
`room_state`	bet, table_cards, head_value, tail_value, dealer_id, current_player_id	Reconnect

8. Luồng ghép

Connect domain dominobet, room_config, chọn bet sảnh, join/create.
start_game → deal. UI felt + mức bet phòng.
Tới lượt: play card/head. Lewat: bay chip theo update_chip.
finish: hiện multiplier, total_win_amount, lật bright_cards.
reset_game → ván mới cùng bet. Rời bằng leave_room / auto_leave.

9. Error codes

code	Nguồn	Ý nghĩa
0 / 1 / 2 / 4 / 5	Handshake	closed · other device · too many · expired · banned
100 · 102 · 103 · 108 · 113 · 114 · 115 · 120	Lobby	missing payload · duplicated login · room not found · bad password · room full · in other room · bet not found · not enough money
1 WrongState	TagPlay	Sai state
2 NotTurn	TagPlay	Không phải lượt
3 InvalidCard	TagPlay	Quân không hợp lệ

10. Checklist client

Endpoint WS là game dominobet, không trỏ nhầm Gaple.
Unmarshal đúng domino_event dù GAME_ID khác.
Lobby đầy đủ: password, invite, chat, auto_leave.
Hiển thị bet phòng + multiplier finish cho cảm giác bàn cược.
Một user một connection.