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

Payline 5×3. Diamond pot, jungle treasure, minigame lật bài. Trang này chỉ được serve khi ENVIRONMENT != production.

1. Tổng quan

2. Luồng ghép

1. Vào game → GET /gameplay. Vẽ board, diamond meter, jungle map theo bet.
2. POST /spins. Highlight win_lines.
3. Nếu claim_diamond_pot → animation claim, cộng diamond_win.
4. Nếu is_bonus_treasure → mở ô treasure_row/col trên map, cập nhật treasures.
5. Nếu is_mini_game → khóa spin, loop POST /minigame tới is_finished.
6. FS: không trừ bet; credit chip khi is_finish_free_spin.

3. Auth & envelope

Authorization: Bearer <access_token>
Content-Type: application/json

{
  "code": 0,
  "msg": { ... }
}

4. Grid & symbol

Board 5×3 (trái) và 5 lá bài úp của minigame (dưới).

Minigame — 5 lá úp, user gửi card_index 0–4

11 Diamond (xanh dương). 12 Wild. 13 Scatter. Lá xanh = đang chọn.

5. GET /api/v1/gameplay

GET /api/v1/gameplay

{
  "code": 0,
  "msg": {
    "init_reels": [[8,11,0],[12,5,2],[8,9,6],[4,1,7],[13,3,10]],
    "user_money": 500000,
    "bets": [200, 1000, 2000, 10000], "show_bets": [200, 1000, 2000, 10000],
    "pay_table": [[1,2,5],[1.5,3,8],[2,4,10],[2.5,5,12],[3,8,15],[4,10,20],[5,12,25],[8,15,40],[10,25,80],[15,40,100],[20,50,150]],
    "bet": 1000, "game_type": 0,
    "is_free_spin": false, "free_spins": 0, "max_free_spins": 0, "free_spin_pot": 0,
    "diamond_count": 3, "diamond_pot": 15000,
    "treasures": [{ "bet": 1000, "treasures": [false, false, true, false, false] }]
  }
}

6. POST /api/v1/spins

POST /api/v1/spins
{ "bet": 1000 }

{
  "code": 0,
  "msg": {
    "user_money": 499000, "win_amount": 4000, "bet": 1000,
    "is_tarzan": true, "is_bonus": true, "number_of_bonus_free_spins": 10,
    "is_free_spin": false, "free_spins": 10, "max_free_spins": 10, "free_spin_pot": 0,
    "is_finish_free_spin": false,
    "claim_diamond_pot": true, "diamond_win": 15000, "diamond_count": 0, "diamond_pot": 0,
    "win_lines": [{ "win_amount": 4000, "line": [8,12,8,4,13], "line_number": 0, "symbol": 8, "number_of_symbols": 3 }],
    "reels": [[8,11,0],[12,5,2],[8,9,6],[4,1,7],[13,3,10]],
    "is_bonus_treasure": true, "treasure_id": 2, "treasure_row": 0, "treasure_col": 2,
    "treasures": [false, false, true, false, false],
    "is_mini_game": true, "number_of_tarzan_symbols": 3, "tarzan_win_amount": 2000
  }
}

7. POST /api/v1/minigame

Chỉ gọi khi is_mini_game = true (hoặc restore mini_game_info). User chọn lá.

POST /api/v1/minigame
{ "card_index": 2 }

{
  "code": 0,
  "msg": {
    "user_money": 499000, "bet": 1000, "turns": 2,
    "card": { "card_type": 1, "multiplier": 5, "win_amount": 5000, "card_index": 2 },
    "win_amount": 5000, "is_finished": false
  }
}

8. Animation

1. Spin: vẽ reels, highlight payline theo win_lines.
2. Diamond: tăng meter; nếu claim_diamond_pot thì nổ nồi, cộng diamond_win.
3. Treasure: flip ô treasure_row/col trên map bet hiện tại.
4. Tarzan feature: hiện number_of_tarzan_symbols / tarzan_win_amount.
5. Minigame: 5 lá úp. Mỗi response lật card.card_index, hiện multiplier / win. Hết turns hoặc is_finished → đóng.
6. FS: khóa bet; credit khi is_finish_free_spin.

9. Cheat (chỉ non-prod)

{ "bet": 1000, "reels": [[8,11,0],[12,5,2],[8,9,6],[4,1,7],[13,3,10]] }

5 cột × 3 hàng. Production bỏ qua.

10. Error & tiền

11. Checklist client

• GET /gameplay trước spin. Restore diamond / treasure / mini_game_info.
• Board 5×3. Map jungle theo treasures[].bet.
• is_mini_game → loop /minigame {card_index} tới is_finished.
• claim_diamond_pot bắt buộc play claim, đừng bỏ animation.
• FS: khóa bet; credit khi is_finish_free_spin.
• Không spam 2 request song song.