# 05 — Kiến thức về game ARES: The Iron Vanguard

> Nguồn: trang chủ https://aresglobal.com2us.com/ — cần bổ sung từ trải nghiệm chơi thực tế
> ở Phase 1 của [07-roadmap.md](07-roadmap.md).

## 1. Thông tin chung

- **Thể loại:** Action MMORPG (space opera), đồ họa console-quality.
- **Nền tảng:** iOS, Android và **PC (Windows 10 64-bit, DirectX 11+, khởi chạy qua Crossplay Launcher)** — dự án chỉ nhắm client PC.
- **Cơ chế cốt lõi chiến đấu:** **Suit Change** — hoán đổi giữa 2 suit trong lúc đánh để đổi phong cách/bộ skill.

## 2. Bốn class & ý nghĩa với bot

| Class | Đặc điểm | Hướng behavior cho bot |
|-------|----------|------------------------|
| **Engineer** | Firepower áp đảo, bombardment, Heavy Gauntlet, control | Giữ khoảng cách, tối ưu chuỗi nạp đạn/bomb, burst theo cooldown |
| **Warlord** | Hammer + shield, block/counter vào thời điểm chuẩn | Bot cần **block chính xác** theo cue của boss — phần khó nhất, giá trị "pro" cao nhất |
| **Hunter** | Dual blade, tốc độ, combo, chui khe hở | Maintains combo, cơ động, dodge liên tục; rotation gọn nhất để tự động hóa đầu tiên |
| **Warlock** | AoE spells, mạnh dần theo số địch | Target switching + giữ khoảng cách, Ưu tiên spawn-add |

**Thứ tự triển khai bot đề xuất:** Hunter → Engineer → Warlock → Warlord (tăng dần độ khó của timing).

## 3. Suit Change — cơ chế quan trọng nhất cho DecisionEngine

- Người chơi mang **2 suit** cùng lúc, swap real-time giữa combat.
- Với bot, Suit Change là quyết định dạng **2-state problem**:
  - Chọn suit OFFENSIVE khi: boss vào stagger/down window, cooldown burst sẵn sàng, add spawn đông.
  - Chọn suit DEFENSIVE khi: boss chuẩn bị ra đòn telegraphed (`state_id` báo trước), HP player < ngưỡng, cần regen/keo dai.
- Cần recon xác định trong bộ nhớ có: `player.suit_id`, `player.suit_cooldown[2]`, danh sách skill của từng suit.

## 4. Nội dung chơi & chế độ cần auto

| Chế độ | Mô tả | Mức ưu tiên auto | Ghi chú |
|--------|-------|-------------------|---------|
| Story / Field combat | Đánh quái theo map | P0 (đầu tiên) | Làm nền tảng: di chuyển, rotation, loot |
| Dungeons | PvE có boss | P0 | Kịch bản lặp — phù hợp auto |
| Raids / Pilgrim Raids | Co-op nhiều người, boss lớn | P2 | Cần tôn trọng vai trò trong team, auto cho vai trò DPS cơ bản |
| Arena PvP | Đối đầu người chơi | P3 (dài hạn) | Đối thủ là người ⇒ reaction model phải thật tự nhiên |

## 5. Kiến thức chiến đấu cần thu thập (Phase 1)

1. **Boss telegraph cues:** mỗi đòn mạnh có animation/state ID báo trước (windup 0.5–1.5s) — đây là tín hiệu để dodge/block. Cần bảng: `boss_id → state_id → hành vi phản ứng`.
2. **Rotation chuẩn mỗi class:** chuỗi skill tối ưu DPS + thời gian hồi.
3. **i-frames:** có được không, sau dodge bao lâu?
4. **Stagger/down window:** boss đổ lúc nào, DPS window kéo dài bao lâu.
5. **Kinh tế & loop hằng ngày:** dungeon nào cho loot tốt nhất để ưu tiên auto (nếu mục tiêu gồm farm).

## 6. Điểm tựa dữ liệu cho bot

Mọi kiến thức trên được mã hóa thành 2 loại config:

```
configs/
├── rotations/hunter.json      # chuỗi skill, điều kiện dùng
├── rotations/engineer.json
├── encounter_db/
│   ├── boss_XXX.json          # state_id → telegraph → reaction (dodge/block/continue)
│   └── ...
└── profiles/
    ├── daily_loop.json        # kịch bản hằng ngày: dungeon nào, thứ tự, điều kiện dừng
    └── safety.json            # ngưỡng HP dùng potion, giới hạn giờ chạy
```

> Không bỏ kiến thức vào code — patch game hoặc chỉnh lối chơi chỉ cần sửa JSON.