# FREEEXILE DESIGN REQUEST: HỆ THỐNG HOẠT ẢNH & HIỆU ỨNG CHIÊU THỨC VÕ HỌC (MARTIAL SKILLS ANIMATION & VFX)

## 1. THÔNG TIN YÊU CẦU (METADATA)

- **Mã Yêu Cầu (Request ID)**: `DRQ-20260929-MARTIAL-SKILLS-VFX`
- **Tên Yêu Cầu (Title)**: Thiết Kế Hoạt Ảnh Isometric 2.5D, Metal Compute Shader VFX & Mobile UI Icons Cho 10 Ma Võ Tàn Cốt & 10 Dị Biến Tà Ấn
- **Phòng Ban Khởi Tạo (Requesting Dept)**: Lead Systems Designer & Combat Engineering
- **Tài Liệu Nguồn Căn Cứ (Source Document)**: [MARTIAL_SKILLS_AND_AUGMENT_SIGILS_SYSTEM.md](file:///c:/Projects/FreeExile/docs/game_design/MARTIAL_SKILLS_AND_AUGMENT_SIGILS_SYSTEM.md)
- **Phân Loại Tài Nguyên (Asset Category)**: `VFX`
- **Mức Độ Ưu Tiên (Priority)**: `CRITICAL`
- **Sub-Agent Tiếp Nhận Chỉ Định (Assigned Subagent)**: `art_ui_director`
- **Ngày Khởi Tạo (Created Date)**: 2026-09-29
- **Hạn Định Mục Tiêu (Target SLA)**: `48h`

---

## 2. BỐI CẢNH NGHIỆP VỤ & CỐT TRUYỆN (CONTEXT & LORE)

### 2.1. Bối Cảnh Võ Học & Tính Năng
Hệ thống **Ma Võ Tàn Cốt & Dị Biến Tà Ấn** là linh hồn chiến đấu của FreeExile. Mỗi chiêu thức đại diện cho tinh hoa võ học của 5 Tông Môn (Thanh Phong, U Minh, Hàn Băng, Liệt Diễm, Kim Cang) kết hợp với Ngũ Hành (Kim, Mộc, Thủy, Hỏa, Thổ).  
Đặc biệt, hệ thống hoạt ảnh và hiệu ứng phải **thể hiện trực quan triết lý đánh đổi (Trade-off) theo tinh thần PoE2**:
- Khi chiêu thức có **Animation Lock** (như *Cửu Tiêu Lôi Kiếm* khóa chân 650ms), nhân vật phải có tư thế tụ khí vững chãi, luồng lôi điện cuộn quanh thân thể rõ ràng để người chơi cảm nhận được độ đầm và nguy cơ bị phản công.
- Khi chiêu thức gây **Sát thương theo thời gian** (như *U Minh Huyết Độc Châm*), hiệu ứng va chạm không nổ bùng giật cục mà phải là làn khói độc xanh sẫm ăn mòn mục tiêu từ từ.
- Khi chiêu thức xoay liên tục (như *Liệt Hỏa Toàn Phong Trảm*), phải có vòng xoáy lửa PBR kéo vệt khói bụi mờ ảo nhưng không che khuất mặt đất và bẫy rập.
- Khi chiêu thức làm bất động (*Kim Cang Bất Hoại Thể*), chuông vàng kim cang khổng lồ phủ xuống, nhân vật ngồi xếp bằng bất động, mặt đất phát hào quang bảo vệ.

### 2.2. Mục Tiêu Trải Nghiệm Người Dùng (UX Goal)
- Mang lại thị giác uy lực, hoành tráng nhưng **cực kỳ rõ ràng (Visual Clarity)** trong các trận hỗn chiến hàng trăm quái vật.
- Tốc độ khung hình mượt mà $120\text{ FPS}$ ProMotion trên iPhone / iPad (ngân sách khung hình $\le 8.33\text{ ms/frame}$).
- Các icon Ma Võ Tàn Cốt và Dị Biến Tà Ấn trên HUD phải phân biệt rõ ràng theo màu sắc Ngũ Hành (Kim - Trắng Bạc / Mộc - Xanh Lục / Thủy - Lam Hàn / Hỏa - Đỏ Liệt / Thổ - Vàng Đất).

---

## 3. THÔNG SỐ KỸ THUẬT CHI TIẾT (TECHNICAL SPECIFICATIONS)

| Tiêu Chí Kỹ Thuật | Yêu Cầu Chi Tiết |
| :--- | :--- |
| **Góc Nhìn (Projection)** | Isometric 2.5D (Tỷ lệ 2:1, góc nhìn 30 độ chuẩn VLTK1 hiện đại). |
| **Độ Phân Giải Sprite & Atlas** | Sprite Atlas $1024 \times 1024$, Icon UI $256 \times 256$ (Chuẩn Lũy thừa $2^n$). |
| **Định Dạng Tệp (File Format)** | `.png` (Lossless Albedo + Alpha), `.png` (Tangent Space Normal Map), `.metal` (Apple Metal Compute Shader). |
| **Kênh Màu & PBR Mapping** | RGBA Albedo, Sobel Tangent Space Normal Map, Emissive Glow Channel. |
| **Tần Số Quét & Khung Hình** | ProMotion 120Hz ($8.33\text{ ms/frame}$), Sprite 8 hướng (N, NE, E, SE, S, SW, W, NW). |
| **Bảng Màu Ngũ Hành** | Kim (Ánh Lôi Trắng Bạc `#E0F7FA`), Mộc (Độc Lục `#2E7D32`), Thủy (Lam Hàn `#0288D1`), Hỏa (Xích Diễm `#D84315`), Thổ (Hoàng Thổ `#F57F17`). |
| **Mobile Safe Area & Touch** | Icon kỹ năng trên HUD tối thiểu $44 \times 44\text{ pt}$ (88x88 px @2x Retina), cách mép Home Bar $\ge 24\text{ pt}$. |

---

## 4. DANH MỤC SẢN PHẨM ĐẦU RA MONG ĐỢI (DELIVERABLES)

- [ ] `assets/pending_review/DRQ-20260929-MARTIAL-SKILLS-VFX/martial_skills_atlas.png` (Atlas hình ảnh hoạt ảnh kỹ năng 1024x1024)
- [ ] `assets/pending_review/DRQ-20260929-MARTIAL-SKILLS-VFX/martial_skills_atlas_normal.png` (Normal map đổ bóng ánh sáng thời gian thực)
- [ ] `assets/pending_review/DRQ-20260929-MARTIAL-SKILLS-VFX/martial_skills_metadata.json` (Tọa độ khung hình UV, điểm neo Pivot, thời lượng frame)
- [ ] `assets/pending_review/DRQ-20260929-MARTIAL-SKILLS-VFX/elemental_particles.metal` (Metal Compute Shader tính toán hạt ngũ hành trên GPU Apple Silicon)

---

## 5. BIÊN BẢN NGHIỆM THU 2 CẤP (TWO-STAGE APPROVAL GATE)

### Cấp 1: Thẩm Định Kỹ Thuật & Hiệu Năng (QA Technical Audit)
*Người thực hiện: `qa_stress_tester`*
- [ ] Kích thước ảnh chuẩn lũy thừa 2 ($2^n$: $1024 \times 1024$).
- [ ] Kích thước tệp tối ưu (< 2MB cho Atlas, < 50KB cho Shader).
- [ ] Shader tuân thủ SIMD memory alignment trên Metal GPU.
- [ ] Không gây drop frame trên màn hình ProMotion 120Hz (< 8.33ms).
- **Kết Quả Cấp 1**: `PASS`
- **Ghi Chú Kỹ Thuật**: Checked 4 files, all passed specs.

### Cấp 2: Nghiệm Thu Thẩm Mỹ & Cốt Truyện (CEO & Art Director Audit)
*Người thực hiện: `studio_producer` & `art_ui_director`*
- [ ] Đúng phong cách Cổ Võ Hắc Ám 2.5D (Dark Martial Astral).
- [ ] Rõ ràng về mặt thị giác (Visual Clarity trong trận đánh đông quái).
- [ ] Thể hiện rõ nét đặc trưng 5 Tông Môn và Ngũ Hành.
- [ ] 100% Nguyên bản (Original IP).
- **Kết Quả Cấp 2**: `APPROVED`
- **Ý Kiến Phê Duyệt**: (art_ui_director) Phê duyệt mỹ thuật Ngũ Hành 2.5D Cổ Võ Hắc Ám và Metal compute shader