---
doc_id: "DOC-GDD-012"
title: "Hệ Thống Quái Vật Hoang Dã & Trí Tuệ Thú Tính (Savage Monster & Feral AI System)"
category: "game_design"
diataxis_type: "reference"
status: "canonical"
version: "2026.1"
owner_role: "poe2_game_designer"
last_updated: "2026-09-29"
tags: ["monsters", "procedural-generation", "feral-ai", "10k-variants", "shader-palettes"]
related_code:
  - "server/world/monster_types.py"
  - "server/world/monster_archetype_catalog.py"
  - "server/world/monster_procedural_engine.py"
  - "server/world/monster_ai_engine.py"
related_docs:
  - "docs/client/SAVAGE_PRIMAL_ART_AND_VFX_BIBLE.md"
  - "docs/standards/DESIGN_PIPELINE_AND_CROSS_DEPT_WORKFLOW.md"
summary: "Đặc tả 10.000 biến thể quái vật qua 100 level, kiến trúc ghép mảnh thủ tục & GPU Shader Palette chống quá tải phần cứng mobile, công thức phân bổ kích thước và độ hung dữ."
---

# HỆ THỐNG QUÁI VẬT HOANG DÃ & TRÍ TUỆ THÚ TÍNH (SAVAGE MONSTER ECOSYSTEM)

> **Mã định danh**: `DOC-GDD-012`  
> **Phiên bản**: `2026.1 Canonical`  
> **Mã nguồn lõi**: [`server/world/monster_procedural_engine.py`](file:///c:/Projects/FreeExile/server/world/monster_procedural_engine.py), [`server/world/monster_types.py`](file:///c:/Projects/FreeExile/server/world/monster_types.py), [`server/world/monster_ai_engine.py`](file:///c:/Projects/FreeExile/server/world/monster_ai_engine.py)

---

## 1. TRIẾT LÝ TẠO HÌNH & 10 HỌ QUÁI CỐT LÕI (CORE GENUS)

Tuân thủ nghiêm ngặt [Kinh Thánh Mỹ Thuật Hoang Dã](file:///c:/Projects/FreeExile/docs/client/SAVAGE_PRIMAL_ART_AND_VFX_BIBLE.md): **Triệt tiêu hoàn toàn quái thú tiên hiệp hoa mỹ**. Mọi quái vật trong FreeExile đều mang dấu ấn **Gai Góc, Bùn Lầy, Máu Đông, Xiềng Xích và Dị Biến Tàn Khốc**.

| Mã Genus | Tên Họ Quái Vật | Đặc Tả Tạo Hình & Dị Biến Sinh Học | Ngũ Hành | Base Scale |
| :--- | :--- | :--- | :--- | :--- |
| `RISEN_SKELETON` | **Hủ Cốt Khô Lâu** | Khung xương người rỉ máu, găm xiềng xích tù đày, cầm đao mẻ và giáo gãy. | Kim | 0.90x |
| `FERAL_HELLHOUND` | **Hoang Vực Cuồng Khuyển** | Chó săn 4 chân teo tóp do đói khát, sống lưng mọc gai xương nhọn hoắt, mắt đỏ ngầu. | Hỏa | 0.95x |
| `BLOOD_CRAWLER` | **Huyết Trùng Hủ Độc** | Côn trùng giáp xác nhiều chân, mai chitin cứng ngắc, vòi hút máu và gai đuôi tiết axit. | Mộc | 0.85x |
| `SHADOW_WRAITH` | **U Minh Dạ Bộc** | Thể oán linh lơ lửng, quấn vải liệm rách nát, móng vuốt dài ngoằng xé toạc linh hồn. | Thủy | 1.00x |
| `PRIMAL_CANNIBAL` | **Man Tộc Đoạt Mệnh** | Kẻ lưu đày biến dị, cơ bắp cuồn cuộn dị dạng, đao rìu đá thô sơ, mang mặt nạ sọ thú. | Thổ | 1.10x |
| `IRONHIDE_BEHEMOTH` | **Hắc Giáp Ngưu Ma** | Thú lớn bọc sừng dày như thép nguội, chân móng chẻ xới tung bùn lầy khi húc càn. | Thổ | 1.35x |
| `CORRUPTED_RAPTOR` | **Huyết Dực Dơi Đêm** | Quái điểu cánh màng rách rưới, móng vuốt quắp sắc lẹm, lao bổ xuống từ không trung. | Kim | 0.95x |
| `BRAMBLE_TREANT` | **Mộc Yêu Thụ Tinh** | Khối rễ cây cổ thụ mục rữa cuộn máu đông, cành gai nhọn đâm tua tủa từ bùn đen. | Mộc | 1.25x |
| `TOMB_LORD` | **Cổ Mộ Thi Vương** | Xác khô ướp tà ấn hắc ám, khoác giáp rỉ sét cổ đại, quyền trượng đầu lâu phát oán khí. | Thủy | 1.15x |
| `FLESH_ABOMINATION`| **Huyết Nhục Cự Thú** | Khối thịt chắp vá khổng lồ, nhiều giác hút và hàm răng lởm chởm, rỉ dịch độc bầy nhầy. | Hỏa | 1.45x |

---

## 2. KIẾN TRÚC 10.000 BIẾN THỂ KHÔNG NẶNG PHẦN CỨNG MOBILE

### 2.1. Thách Thức Kỹ Thuật & Giới Hạn VRAM iOS ProMotion 120Hz
- Nếu vẽ tay riêng $10.000$ bộ Spritesheet độc lập $\implies$ Dung lượng cài đặt vượt **60GB**, tiêu tốn **12GB VRAM**, làm crash tức thì GPU iPhone/iPad.
- **Mục tiêu kỹ thuật**: Tối đa **15MB VRAM** cho toàn bộ hệ thống quái vật, duy trì $8.33\text{ ms/frame}$ (120 FPS).

### 2.2. Giải Pháp Ghép Mảnh Thủ Tục (Combinatorial Modular Composition)

```mermaid
flowchart TD
    MID["Monster ID (1 .. 10,000)"] --> Hash["Deterministic Hash Engine (Murmur/SplitMix64)"]
    Hash --> Genus["10 Họ Quái Cốt Lõi (Base Skeleton - 4MB VRAM)"]
    Hash --> Sub["100 Phân Loài Sinh Học (Behavior & Mesh Variant)"]
    Hash --> Elem["Ngũ Hành Palette LUT (Compute Shader Tinting - 0MB)"]
    Hash --> Affix["Ma Trận 20 Tiền Tố x 25 Hậu Tố (500 Affix Combinations)"]
    Hash --> Attach["8 Mảnh Ngoại Trang Động (Bone & Flesh Attachment Atlas - 1.2MB)"]
    
    Genus --> FinalMob["Procedural Monster Instance: 10.000 Biến Thể Độc Nhất"]
    Sub --> FinalMob
    Elem --> FinalMob
    Affix --> FinalMob
    Attach --> FinalMob
```

1. **Atlas Khung Xương Đa Hướng (Shared Archetype Spritesheet)**:
   - Chỉ xuất 10 bộ Spritesheet cho 10 Họ Quái Cốt Lõi (8 hướng x 4 trạng thái: Idle, Run, Attack, Die).
   - Định dạng nén ASTC $4\times 4$ / WebP Lossless $\implies$ Tổng dung lượng chỉ **4.0MB VRAM**.
2. **Bộ Lọc Màu Kim Loại & Da Thịt (GPU Palette LUT & Fragment Shader)**:
   - Đổi màu da, máu và gân cơ trực tiếp trong Apple Metal / WebGL Shader qua chỉ số Look-Up Table (LUT index $1..15$) và mã màu `elemental_tint_hex`. **Không tốn thêm 1 byte texture nào**.
3. **Mảnh Ghép Xương & Vũ Khí (Modular Bone/Flesh Attachment Overlay)**:
   - 1 Texture Atlas duy nhất ($1024\times 1024$, **1.2MB**) chứa các phụ kiện gắn kết: Sừng xoắn (`horn_twisted_bone`), Gai lưng (`spike_dorsal_ridge`), Xiềng xích (`chains_rusted_iron`), Vuốt hắc diện thạch (`claws_obsidian_gouge`).
4. **Sinh Thủ Tục Xác Định (Deterministic $O(1)$ Hash)**:
   - Server và Client chỉ truyền `monster_id` (4 bytes). Cả hai bên tính toán ra cùng 1 quái vật với 0 độ trễ mạng và không cần lưu bảng dữ liệu $10.000$ dòng tĩnh trong database.

---

## 3. PHÂN BỔ KÍCH THƯỚC & ĐỘ HUNG DỮ THEO 100 LEVEL

### 3.1. Phân Vùng 100 Level Cổ Võ
- **Level 1 - 20 (Ven Biển & Bãi Tha Ma)**: Kẻ đói khát, còi cọc, chuyển động lờ đờ, đòn đánh chậm.
- **Level 21 - 40 (Đầm Lầy Thối Rữa & Tàn Tích Man Tộc)**: Bắt đầu săn mồi bầy đàn, tốc độ tăng nhanh.
- **Level 41 - 60 (Rừng Gai Máu & Hẻm Núi Xương Trắng)**: Thể xác nở lớn, mọc gai sừng nhọn, truy đuổi quyết liệt.
- **Level 61 - 80 (Cổ Quan Ma Vực & Núi Lửa Tro Tàn)**: Quái vật khổng lồ, đòn đánh tạo sóng chấn động, combo liên hoàn.
- **Level 81 - 100 (Cõi Bị Lãng Quên & Endgame Atlas Tier 1-16)**: Thể phách Titan / Cổ Thần, tốc độ cực nhanh, bao vây bầy đàn.

### 3.2. Công Thức Toán Học Quy Chuẩn

$$\text{Scale}(L, R) = \text{BaseScale} \times \left(0.80 + 0.50 \times \left(\frac{L}{100}\right)^{0.75}\right) \times \text{RankScaleMultiplier}(R)$$

$$\text{Ferocity}(L, R) = \min\left(1.0, 0.20 + 0.55 \times \left(\frac{L}{100}\right)^{0.85} + \text{RankFerocityBonus}(R)\right)$$

$$\text{AggroRadius}(L, R) = 5.0 + 15.0 \times \left(\frac{L}{100}\right)^{0.90} + \text{RankAggroBonus}(R) \quad (\text{meters})$$

$$\text{MovementSpeed}(L, R) = 2.2 + 4.5 \times \left(\frac{L}{100}\right)^{0.80} + \text{RankSpeedBonus}(R) \quad (\text{m/s})$$

$$\text{AttackWindup}(L) = \max\left(180, 1800 - 1500 \times \left(\frac{L}{100}\right)^{0.75}\right) \quad (\text{ms})$$

$$\text{AttackCooldown}(L) = \max\left(350, 2500 - 2000 \times \left(\frac{L}{100}\right)^{0.80}\right) \quad (\text{ms})$$

### 3.3. Bảng Tham Số Đối Soát Theo Mốc Level (Rank Common)

| Level | Scale Factor | Bán Kính Va Chạm | Độ Hung Dữ | Bán Kính Aggro | Tốc Chạy | Windup Đòn Đánh | Hồi Chiêu Đòn Đánh | Combo |
| :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: |
| **1** | 0.81x | 0.40m | 0.21 | 5.2m | 2.3 m/s | 1752ms | 2450ms | 1 Hit |
| **20** | 0.95x | 0.48m | 0.34 | 7.6m | 3.4 m/s | 1350ms | 1970ms | 1 Hit |
| **40** | 1.05x | 0.53m | 0.45 | 10.4m | 4.3 m/s | 1050ms | 1580ms | 2 Hits |
| **60** | 1.14x | 0.57m | 0.56 | 13.5m | 5.2 m/s | 780ms | 1220ms | 2 Hits |
| **80** | 1.22x | 0.61m | 0.66 | 16.7m | 6.0 m/s | 530ms | 870ms | 3 Hits |
| **100**| 1.30x | 0.65m | 0.75 | 20.0m | 6.7 m/s | 180ms | 500ms | 3-4 Hits |

*Ghi chú*: Với Rank **RARE** hoặc **BOSS**, kích thước nhân thêm hệ số $1.55\times$ đến $2.20\times$, độ hung dữ chạm ngưỡng $1.00$, tốc độ di chuyển đạt $7.9 - 9.5\text{ m/s}$, bán kính phát hiện đạt $28.0\text{m}$.

---

## 4. TRÍ TUỆ THÚ TÍNH 30HZ & CƠ CHẾ CHỐNG KITING (SERVER FERAL AI)

```mermaid
stateDiagram-v2
    [*] --> IDLE
    IDLE --> PATROL: Ngửi thấy mùi máu / Tuần tra
    PATROL --> IDLE: Hết thời gian tuần tra
    
    IDLE --> PURSUIT: Người chơi vào Aggro Radius
    PATROL --> PURSUIT: Người chơi vào Aggro Radius
    
    PURSUIT --> ATTACK: Khoảng cách <= Melee Reach
    ATTACK --> PURSUIT: Mục tiêu di chuyển ra xa
    
    PURSUIT --> LEASH_RETURN: Vượt Leash Radius (Chống Kiting)
    ATTACK --> LEASH_RETURN: Vượt Leash Radius (Chống Kiting)
    
    LEASH_RETURN --> IDLE: Về đến điểm Spawn (Hồi 100% HP, Hủy Miễn Nhiễm)
    ATTACK --> DEAD: Máu <= 0 (Tử nạn)
    PURSUIT --> DEAD: Máu <= 0 (Tử nạn)
```

1. **Cơ Chế Bó Cương Chống Kiting (Anti-Kiting Leash Anchor)**:
   - Khi bị người chơi dụ chạy quá `leash_radius_meters` ($2.2\times$ bán kính Aggro, tối đa $45\text{m}$ tính từ điểm sinh ra):
   - Quái vật lập tức kích hoạt trạng thái `LEASH_RETURN`:
     - **Bất tử hoàn toàn (`is_invulnerable = True`)**: Triệt tiêu triệt để thủ đoạn đứng ngoài tầm đánh rỉa máu của bot/hacker.
     - **Hồi phục sinh lực thần tốc**: Tự động hồi phục $30\%\text{ Max HP / giây}$.
     - **Tăng tốc trở về**: Vận tốc di chuyển tăng $150\%$ hướng thẳng về tọa độ `(spawn_x, spawn_y)`.
2. **Chiến Thuật Bầy Đàn (Flocking & Swarm Intercept)**:
   - Hệ số `flocking_cohesion` tăng theo cấp độ. Quái vật cấp cao không xếp hàng 1-1 mà chủ động tản ra tạo góc kẹp $120^\circ - 180^\circ$ khép góc người chơi.