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

Slot Megaways 6×5 + top reel. Mallet tích lũy, Mallet Wish, jackpot, buy bonus. Client nói HTTP JSON với server game. 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. Render board preview, bet, paytable, mallet meter, FS/wish nếu đang dở.
2. Base: POST /spins {"bet":...}. Play tuần tự win_result[].
3. bonus_mini_game_type = 2 (Mallet Wish) → khóa spin, lặp POST /mallet-wish tới is_stopped / is_win rồi vào FS.
4. FS: is_free_spin, không trừ bet. Line win cộng pot; jackpot credit ngay qua total_jackpot_win_amount.
5. Buy → POST /buy-bonus (cấm khi đang FS/wish). Animate board planted rồi vào FS; đừng cộng WIN của board buy.
6. Luôn lấy số dư từ user_money của response vừa nhận.

3. Auth & envelope

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

Mọi API dưới /api/v1 cần JWT. Trang docs không cần token. HTTP 200 + code = 0 là thành công; payload nằm trong msg.

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

4. Grid, packed cell & symbol

Mỗi ô là int packed: bit 0–4 symbol, bit 5 mallet, bit 6–7 border (0 none · 1 silver · 2 gold).

symbol = packed & 31
is_mallet = (packed & 32) != 0
border   = (packed >> 6) & 3     // 0 none, 1 silver, 2 gold
// ví dụ 42 = Wild(10) + mallet(32)

Top reel (4 ô, nằm trên cột 1–4). Ô xanh = wild, vàng = scatter, xanh dương = mallet.

mini_game_type: 0 base · 1 free spin · 2 mallet wish. Dùng pay_table từ /gameplay, đừng hardcode.

5. GET /api/v1/gameplay

Gọi 1 lần khi vào game. Thiếu bước này thì spin/buy/wish trả code 69.

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": [[10,25,50],[5,15,30],[3,10,20],[2,8,15],[1.5,6,12],[1,4,10],[0.8,3,8],[0.5,2,5],[0.4,1.5,4],[0.3,1,3]],
    "is_free_spin": false, "free_spins": 0, "max_free_spins": 0, "free_spin_pot": 0, "free_spin_multiplier": 1,
    "init_reels": [[0,1,2,3,4],[5,6,7,8,9],[0,10,1,2,3],[11,4,5,6,7],[8,9,0,1,2],[3,4,5,6,7],[8,9,10,11]],
    "mini_game_type": 0, "total_mallets": [2,4,1,0], "max_mallets": 8,
    "mallet_wish_free_spins": [8,10,12,15], "mallet_wish_win_rates": [80,60,40,20],
    "mallet_wish_current_level": 0, "free_spin_price": 100
  }
}

6. GET /api/v1/jackpot

GET /api/v1/jackpot

{ "code": 0, "msg": [{ "bet": 200, "amount": 480000 }, { "bet": 1000, "amount": 2400000 }] }

7. POST /api/v1/spins

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

• Phải /gameplay trước. Cấm khi mini_game_type = 2 (đang wish).
• Base trừ bet ngay. FS không trừ; vẫn gửi bet hiện tại, không đổi bet.

SpinResult

WinResult / WinLine

{
  "code": 0,
  "msg": {
    "bet": 1000, "price": 0, "user_money": 499000, "win_amount": 8000,
    "mini_game_type": 0, "is_free_spin": false, "free_spins": 0, "free_spin_pot": 0,
    "is_finish_free_spin": false, "is_bonus_free_spin": false, "bonus_mini_game_type": 2,
    "number_of_bonus_free_spins": 0, "max_free_spins": 0, "free_spin_init_multiplier": 1, "multiplier": 1,
    "total_jackpot_win_amount": 0, "jackpot_amount": 2400000,
    "win_result": [{
      "lines": [{ "symbol": 8, "positions": [[0,1],[0],[],[],[],[],[]], "win_amount": 8000, "line_size": 8, "number_of_lines": 12 }],
      "reels": [[8,8,2,3,4],[8,6,7,8,9],[0,10,1,2,3],[4,4,5,6,7],[8,9,0,1,2],[3,4,5,6,7],[8,9,10,11]],
      "positions": [[0,1],[0],[],[],[],[],[]], "multiplier": 1, "bonus_multiplier": 0, "mega_ways": 3240,
      "total_bonus_mallets": 2, "total_mallets": 8, "is_jackpot": false, "jackpot_win_amount": 0
    }]
  }
}

8. POST /api/v1/buy-bonus

POST /api/v1/buy-bonus
{ "bet": 1000 }

• Giá = free_spin_price × bet. Trừ ngay. Response cùng SpinResult, price = số đã trừ.
• Board planted (scatter) — không credit WIN của board này. Animate rồi vào FS.
• Cấm khi đang FS hoặc Mallet Wish → code 69.

{
  "code": 0,
  "msg": {
    "bet": 1000, "price": 100000, "user_money": 400000, "win_amount": 0,
    "mini_game_type": 1, "is_free_spin": false, "free_spins": 10, "free_spin_pot": 0,
    "is_finish_free_spin": false, "is_bonus_free_spin": true, "bonus_mini_game_type": 1,
    "number_of_bonus_free_spins": 10, "max_free_spins": 10, "free_spin_init_multiplier": 1, "multiplier": 1,
    "total_jackpot_win_amount": 0, "jackpot_amount": 2400000, "win_result": []
  }
}

9. POST /api/v1/mallet-wish

POST /api/v1/mallet-wish
{ "request_stop": false }

Lặp đến khi is_stopped (hoặc is_win ở đỉnh). Sau đó mini_game_type = FS — tiếp tục POST /spins.

{ "code": 0, "msg": { "bet": 1000, "level": 2, "number_of_bonus_free_spins": 12, "free_spin_init_multiplier": 1, "is_stopped": true, "is_win": true } }

10. Animation / tumble

1. Unpack từng ô win_result[i].reels. Vẽ 6×5 + top reel.
2. Highlight positions / từng lines. Ô mallet (bit 5) pulse meter.
3. Xóa ô thắng, gravity theo cột, fill từ trên. Board mới = phần tử tiếp theo — đừng tự random.
4. Nếu is_jackpot: fanfare + cộng chip ngay (không chờ hết FS).
5. FS: cộng line win vào counter pot; chỉ credit chip khi is_finish_free_spin.

11. Cheat (chỉ non-prod / cheater)

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

7 cột packed. Production bỏ qua reels, luôn random.

12. Error & tiền

13. Checklist client

• GET /gameplay trước mọi spin/buy/wish.
• Unpack packed cell trước khi map sprite. Top reel = reels[6] (4 ô).
• Play tuần tự win_result. Bet chỉ giá trị trong bets.
• Wish: loop /mallet-wish tới stop rồi mới /spins.
• Buy: khóa khi không phải base; không credit WIN board buy.
• JP credit ngay. FS line win vào pot. Không gọi song song 2 request cho 1 user.