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

Cluster 5 cột × 6 hàng + 3 minigame: Wings of Horus, Falcon Strike, Divine Grace. Có buy minigame. Chip MG chỉ credit khi is_finish. Trang này chỉ serve khi ENVIRONMENT != production.

1. Tổng quan

2. Luồng ghép

1. GET /gameplay — board 5×6, giá 3 MG, snapshot nếu đang dở.
2. POST /spins. Play win_result[] (cluster tumble).
3. Nếu is_bonus_game → gọi đúng endpoint theo bonus_game_type tới is_finish.
4. Buy: /buy-minigame rồi vào MG (line win spin buy không cộng chip).
5. Chip MG chỉ lấy từ user_money khi is_finish.

3. Auth & envelope

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

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

4. Grid & symbol

Cluster board 5 cột × 6 hàng. Hàng đầu = row 0.

Ô vàng = cluster High1 (5). 10 Scatter. 11–14 Wings. 16 Sun orb / 17 Sky orb wild.

5. GET /api/v1/gameplay

GET /api/v1/gameplay

{
  "code": 0,
  "msg": {
    "user_money": 500000, "bet": 1000,
    "bets": [200, 1000, 2000], "show_bets": [200, 1000, 2000],
    "pay_table": [[50,20,10],[25,10,5],[15,8,4],[10,5,2],[8,3,1.5],[40,15,8],[30,12,6],[20,8,4],[15,6,3],[10,4,2]],
    "game_type": 0,
    "init_reels": [[5,5,0,9,1,8],[5,5,11,0,0,9],[2,5,6,2,12,5],[3,4,7,3,6,1],[10,1,8,4,7,0]],
    "wings_of_horus_price": 80, "falcon_strike_price": 100, "divine_grace_price": 120
  }
}

6. POST /api/v1/spins

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

WinResult / WinLine

{
  "code": 0,
  "msg": {
    "bet": 1000, "user_money": 499000, "win_amount": 6000,
    "is_bonus_game": true, "bonus_game_type": 1,
    "win_result": [{
      "lines": [{ "symbol": 5, "positions": [[0,1],[0,1],[1],[],[]], "win_amount": 6000, "line_size": 5, "multiplier": 8, "has_wild": false, "wild_multiplier": 0, "active_col_multiplier": 1 }],
      "reels": [[5,5,0,9,1,8],[5,5,11,0,0,9],[2,5,6,2,12,5],[3,4,7,3,6,1],[10,1,8,4,7,0]],
      "win_amount": 6000, "total_win_amount": 6000,
      "positions": [[0,1],[0,1],[1],[],[]],
      "wild_bonus_multiplier": 0, "wild_multiplier": 0, "special_symbols": [],
      "active_cols": [0,1,2], "bonus_spins": 0, "col_multipliers": [1,1,1,1,1]
    }],
    "wings_of_horus": { "cards": [{ "symbol": 0, "multiplier": 0 }, { "symbol": 0, "multiplier": 0 }], "spins": 3, "multipliers": [1,1,1,1,1] }
  }
}

7. POST /api/v1/wings-of-horus

POST /api/v1/wings-of-horus
{ "position": 2 }

{
  "code": 0,
  "msg": {
    "position": 2, "symbol": { "symbol": 11, "multiplier": 2 },
    "bonus_spins": 1, "spins": 2, "multipliers": [1, 2, 1, 1, 1],
    "is_finish": false, "win_amount": 0, "user_money": 499000
  }
}

8. POST /api/v1/falcon-strike

POST /api/v1/falcon-strike
{ }

{
  "code": 0,
  "msg": {
    "bet": 1000, "user_money": 499000, "win_amount": 4000,
    "win_result": [], "pot": 12000, "multipliers": [2,2,1,1,1],
    "spins": 3, "active_cols": [true, true, true, false, false], "is_finish": false
  }
}

9. POST /api/v1/divine-grace

POST /api/v1/divine-grace

{
  "code": 0,
  "msg": {
    "reels": [[{ "symbol": 5, "multiplier": 0 }]], "end_reels": [[{ "symbol": 5, "multiplier": 2 }]],
    "multipliers": [2,1,1,1,1],
    "orbs": [{ "col": 0, "row": 1, "symbol": 18, "multiplier": 2 }],
    "special_symbols": [{ "col": 1, "row": 2, "symbol": 11, "multiplier": 2, "col_multipliers": [2,2,1,1,1], "affected_cols": [0,1] }],
    "spins": 2, "is_finish": false, "win_amount": 0, "user_money": 499000
  }
}

10. POST /api/v1/buy-minigame

POST /api/v1/buy-minigame
{ "bet": 1000, "mini_game_type": 2 }

mini_game_type: 1 Wings · 2 Falcon · 3 Divine. Giá = price field × bet. Response gần giống SpinResult: board planted, line win không credit. Rồi vào loop MG.

{
  "code": 0,
  "msg": {
    "bet": 1000, "user_money": 400000, "win_amount": 0,
    "win_result": [], "is_bonus_game": true, "bonus_game_type": 2,
    "falcon_strike": { "active_cols": [true,true,true,true,true], "multipliers": [1,1,1,1,1], "spins": 5, "pot": 0, "max_spins": 5 }
  }
}

11. Animation

1. Base: play tumble win_result, highlight cluster, special wings affect cột.
2. Wings: user tap position, lật symbol, cập nhật multipliers.
3. Falcon: tumble như base, cột active_cols sáng, cộng pot (chưa chip).
4. Divine: interpolate reels → end_reels, overlay orbs.
5. is_finish: cộng chip, về base.

12. Cheat (chỉ non-prod)

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

Falcon nhận reels cheat tương tự. Production bỏ qua.

13. Error & tiền

14. Checklist client

• GET /gameplay trước. Board 5×6 cluster.
• is_bonus_game → đúng endpoint tới is_finish.
• Buy: planted board, không cộng line win.
• Chip MG chỉ lúc finish. Restore snapshot khi reconnect.
• Không spam 2 request song song.