Aladin Megaways — tài liệu ghép client

Megaways tumble 6×5 + top reel (cột index 6, 4 ô). Treasure chest, wild dài / super wild, mini & grand jackpot. Trang này chỉ được serve khi ENVIRONMENT != production.

1. Tổng quan

2. Luồng ghép

1. Vào game → GET /gameplay + GET /jackpot.
2. POST /spins. Play tuần tự win_result[] (tumble).
3. Mỗi bước: vẽ reels (6×5 + top), highlight positions, hiện mega_ways, long/super wild.
4. Treasure chest / multiplier / bonus_multiplier animate trước khi bước tiếp.
5. Nếu jackpot trên bước hoặc top-level jackpot_win_amount > 0 → credit ngay (kể cả đang FS).
6. FS: không trừ bet; line win vào pot; credit pot khi is_finish_free_spin.

3. Auth & envelope

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

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

4. Grid & symbol

Top reel (4 ô, index cột 6) nằm trên board 6×5. Row 0 = trên cùng.

Top reel

Main 6×5

Ô vàng = ways thắng. 11 Wild xanh. 12 Scatter. 13–16 rương (ô xanh dương trên top).

5. GET /api/v1/jackpot

GET /api/v1/jackpot

{
  "code": 0,
  "msg": { "mini_jackpot": 88000, "grand_jackpot": 4200000, "bet": 1000 }
}

6. GET /api/v1/gameplay

GET /api/v1/gameplay

{
  "code": 0,
  "msg": {
    "user_money": 500000, "bet": 1000,
    "bets": [200, 1000, 2000, 10000], "show_bets": [200, 1000, 2000, 10000],
    "pay_table": [[50,20,10],[25,10,5],[15,8,4],[10,5,2],[8,3,1.5],[20,8,3],[15,6,2],[12,5,2],[8,3,1],[5,2,0.8],[4,1.5,0.5]],
    "is_free_spin": false, "free_spins": 0, "max_free_spins": 0, "free_spin_pot": 0,
    "free_spin_multiplier": 0,
    "init_reels": [[0,5,1,3,9],[0,6,2,4,10],[11,7,14,5,0],[3,8,0,6,1],[4,9,1,7,2],[12,10,2,8,3],[13,5,11,8]]
  }
}

7. POST /api/v1/spins

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

SpinResult

WinResult / WinLine

{
  "code": 0,
  "msg": {
    "bet": 1000, "user_money": 512000, "win_amount": 8000,
    "is_free_spin": false, "free_spins": 12, "free_spin_pot": 0,
    "is_finish_free_spin": false, "is_bonus_free_spin": true, "number_of_bonus_free_spins": 12,
    "max_free_spins": 12, "free_spin_init_multiplier": 1, "multiplier": 2,
    "jackpot_win_amount": 88000, "mini_jackpot": 5000, "grand_jackpot": 4200000,
    "win_result": [{
      "lines": [{ "symbol": 0, "positions": [[0],[0],[0],[],[],[],[]], "win_amount": 8000, "line_size": 3, "number_of_lines": 2 }],
      "reels": [[0,5,1,3,9],[0,6,2,4,10],[11,7,14,5,0],[3,8,0,6,1],[4,9,1,7,2],[12,10,2,8,3],[13,5,11,8]],
      "positions": [[0],[0],[0],[],[],[],[]],
      "treasure_chest": [[],[],[2],[],[],[],[0]],
      "multiplier": 2, "bonus_multiplier": 0, "win_amount": 8000, "total_win_amount": 8000,
      "mega_ways": 3240, "is_long_wild": false, "is_super_wild": false,
      "mini_jackpot_win_amount": 88000, "grand_jackpot_win_amount": 0,
      "mini_jackpot": 5000, "grand_jackpot": 4200000
    }]
  }
}

8. Tumble / animation

1. Vẽ 6 cột main + hàng top từ reels[6].
2. Highlight positions / từng line. Hiện mega_ways.
3. Nếu is_long_wild / is_super_wild → animation wild phủ cột.
4. Rương: đọc treasure_chest, nhân multiplier / bonus_multiplier.
5. JP bước: popup mini/grand, cập nhật meter, chip đã nằm trong user_money top-level.
6. Xóa ô thắng, gravity, board tiếp = win_result[i+1].reels.

9. Free spins

• Trigger scatter trên board cuối → is_bonus_free_spin, number_of_bonus_free_spins.
• Giữa FS không trừ bet. free_spin_multiplier / multiplier bank suốt feature.
• Spin cuối: is_finish_free_spin, win_amount = pot line-win, cộng chip.

10. Cheat (chỉ non-prod)

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

7 cột: 6×5 + top 4 ô. Production bỏ qua, luôn random.

11. Error & tiền

12. Checklist client

• GET /gameplay trước spin. Board 6×5 + top reel reels[6].
• Play tuần tự win_result; tin mega_ways / wild flags.
• JP credit ngay — đừng gộp vào pot FS.
• FS: khóa bet; credit line-win khi is_finish_free_spin.
• Không spam 2 spin song song.