# 00 — Tổng quan dự án ARES AutoPlay

> **Trạng thái:** Draft v0.1 · **Ngày:** 2026-09-15 · **Ngôn ngữ:** C++23 · **Nền tảng mục tiêu:** Windows 10/11 x64

## 1. Dự án là gì?

ARES AutoPlay là công cụ **tự động điều khiển nhân vật** trong game *ARES: The Iron Vanguard*
(Com2uS Holdings) trên client PC, với mục tiêu chơi **giống một pro-player thật** — tức là
không spam skill máy móc, mà ra quyết định theo ngữ cảnh chiến đấu: né đòn đúng thời điểm,
giữ uptime DPS, hoán đổi Suit theo tình huống, ưu tiên mục tiêu hợp lý.

## 2. Mục tiêu (Goals)

| # | Mục tiêu | Thước đo (KPI) |
|---|----------|----------------|
| G1 | Tự clear dungeon/field không cần người can thiệp | 100% vòng auto không bị kẹt > 30s |
| G2 | Hành xử giống người thật | Nhịp bấm/độ trễ có phân bố tự nhiên, có jitter, có sai số |
| G3 | Combat hiệu quả | DPS uptime ≥ 85%, dodge thành công ≥ 70% đòn telegraphed |
| G4 | Suit Change đúng lúc | Hoán đổi theo ngữ cảnh (burst/a defensive) ≥ 90% tình huống |
| G5 | Bot ổn định lâu | Chạy liên tục ≥ 4h không crash, tự recover khi mất kết nối KMBox |
| G6 | Cấu hình hóa | Toàn bộ offsets + hành vi nằm trong file config, không build lại |

## 3. Phi mục tiêu (Non-goals)

- ❌ Không can thiệp vào server, không gửi packet giả — chỉ đọc bộ nhớ + mô phỏng input thật qua KMBox.
- ❌ Không aimbot "không thực tế" (snap tức thời, 180°/s) — chuyển động chuột giới hạn trong ngưỡng vật lý người chơi.
- ❌ Không phát hành/cộng đồng hóa — công cụ nội bộ, tài khoản thử nghiệm riêng.
- ❌ Không tối ưu cho việc lách kiểm tra anti-cheat — thiết kế dựa trên việc input là HID thật qua KMBox.

> ⚠️ **Disclaimer:** Công cụ tự động hóa này vi phạm Điều khoản dịch vụ của Com2uS.
> Chỉ sử dụng trên tài khoản/môi trường thử nghiệm do bản thân tự chịu trách nhiệm.

## 4. Định nghĩa "pro-player" của dự án

Bot được coi là đạt chuẩn khi tái hiện được các hành vi sau:

1. **Rotations** — chuỗi skill đúng thứ tự tối ưu DPS của từng class (Engineer / Warlord / Hunter / Warlock).
2. **Suit Change context-aware** — suit công khi có cửa sổ burst, suit thủ khi boss ra đòn telegraphed.
3. **Defensive play** — dodge/block theo animation cue của boss (đọc từ bộ nhớ: state ID của boss).
4. **Targeting** — ưu tiên mục tiêu: add đang hồi máu > elite > boss, dựa trên entity list trong bộ nhớ.
5. **Reaction delay** — phản ứng trễ 120–250ms như người thật, không phản ứng trong 1 frame.

## 5. Ràng buộc kỹ thuật chính

- **Ngôn ngữ:** C++23 (MSVC 19.38+ / Clang 17+), build bằng CMake.
- **Runtime:** Windows 10/11 x64, client PC của ARES (DirectX 11+, khởi chạy qua Crossplay Launcher).
- **Input:** Virtual KMBox (thiết bị HID thật — hỗ trợ cả KMBox Net qua UDP và các bản USB qua serial).
- **Perception:** Ưu tiên đọc bộ nhớ process (nhanh, chính xác); phương án dự phòng là screen capture + computer vision.
- **Chi tiết công cụ reverse engineering:** xem [`08-reversing-toolchain.md`](08-reversing-toolchain.md).

## 6. Tài liệu liên quan

| File | Nội dung |
|------|----------|
| [01-architecture.md](01-architecture.md) | Kiến trúc tổng thể & luồng dữ liệu |
| [02-tech-stack.md](02-tech-stack.md) | Công nghệ, build system, thư viện |
| [03-memory-module.md](03-memory-module.md) | Thiết kế module đọc/ghi bộ nhớ |
| [04-input-module.md](04-input-module.md) | Điều khiển input qua Virtual KMBox |
| [05-game-knowledge.md](05-game-knowledge.md) | Kiến thức về game ARES |
| [06-decision-engine.md](06-decision-engine.md) | Não bộ ra quyết định của bot |
| [07-roadmap.md](07-roadmap.md) | Lộ trình phát triển |
| [08-reversing-toolchain.md](08-reversing-toolchain.md) | Workflow Ghidra/CE/x64dbg/ReClass |