# FREEEXILE DESIGN REQUEST: Loot Drop Light Beams & Ground Particles

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

- **Mã Yêu Cầu (Request ID)**: `DRQ-20261001-ECO-LOOT-DROP-PARTICLES`
- **ID**: `DRQ-20261001-ECO-LOOT-DROP-PARTICLES`
- **Tên Yêu Cầu (Title)**: Hiệu Ứng Tia Sáng Rơi Đồ Theo Độ Hiếm & Cột Sáng Rớt Vật Phẩm (Loot Drop Light Beams & Ground Particles)
- **Phòng Ban Khởi Tạo (Requesting Dept)**: Economy (PoE2 Game Designer)
- **Department**: Economy
- **Tài Liệu Nguồn Căn Cứ (Source Document)**: [client/webapp/js/engine/loot_renderer.js](file:///c:/Projects/FreeExile/client/webapp/js/engine/loot_renderer.js) & [GEMINI.md](file:///c:/Projects/FreeExile/GEMINI.md)
- **Phân Loại Tài Nguyên (Asset Category)**: `VFX`
- **Asset Type**: `VFX`
- **Mức Độ Ưu Tiên (Priority)**: `HIGH`
- **Sub-Agent Tiếp Nhận Chỉ Định (Assigned Subagent)**: `vfx_tech_artist`
- **Đường Dẫn Mục Tiêu (Target Path)**: `client/webapp/assets/savage_vfx/loot_beams_atlas.png`
- **Target Path**: `client/webapp/assets/savage_vfx/loot_beams_atlas.png`
- **Kích Thước (Dimensions)**: `256x512` (Must be 2^n)
- **Dimensions**: `256x512` (Must be 2^n)
- **Ngân Sách Dung Lượng (Size Budget)**: `< 150KB`
- **Size Budget**: `< 150KB`
- **Yêu Cầu Normal Map (Normal Map Required)**: `NO`
- **Normal Map Required**: `NO`
- **Ngày Khởi Tạo (Created Date)**: `2026-10-01`
- **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
Khi quái vật dã ngoại hoặc Boss Bí Cảnh bị trảm diệt, vật phẩm rớt xuống đất cần có hiệu ứng cột sáng (Loot Beam) và đốm sáng lấp lánh (Ground Sparkle) để báo hiệu độ quý hiếm từ xa:
1. **Phổ Thông (Normal)**: Tia sáng trắng đục nhẹ nhàng cao 1 mét.
2. **Ma Thuật (Magic)**: Cột sáng lam ngọc xoay tròn kèm hạt linh khí.
3. **Quý Hiếm (Rare)**: Cột sáng hoàng kim chói lọi bốc thẳng lên trời kèm tia sét nhỏ.
4. **Độc Nhất (Unique)**: Cột sáng cam rực lửa bốc khói đen cuồn cuộn.
5. **Thần Ma Thái Hư (Astral Pinnacle)**: Cột sáng tím tinh vân đa sắc xoay chiều kèm vòng sóng xung kích trên mặt đất.

### 2.2. Mục Tiêu Trải Nghiệm Người Dùng (UX Goal)
Khoảnh khắc dopamine tột độ khi nhìn thấy cột sáng hoàng kim hoặc cam đỏ bốc lên giữa chiến trường hỗn loạn. Hiệu ứng phải nổi bật trên mọi địa hình nhưng không gây chói lóa hay che khuất tầm nhìn di chuyển.

---

## 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 Vertical Particle Billboard / Metal Shader |
| **Độ Phân Giải (Resolution)** | `256x512` (Atlas tia sáng dọc) kết hợp hạt bụi đất `128x128` (Chuẩn $2^n$) |
| **Định Dạng Tệp (File Format)** | `.png` (RGBA 32-bit lossless), `.metal` (Fragment shader cho iOS) |
| **Kênh Màu & PBR Mapping** | Additive Blending Alpha Mask, Gradient rực rỡ, không yêu cầu Normal Map |
| **Tần Số Quét & Khung Hình** | 120 FPS ProMotion ($8.33\text{ ms/frame}$), chi phí GPU < 0.2ms cho 50 vật phẩm rơi |
| **Bảng Màu & Hệ Ngũ Hành** | Trắng bạc, lam ngọc, vàng kim, cam lửa, tím tử la thần thánh |
| **Giao Diện Di Động (Safe Area)** | Tối ưu hóa batching sprite, zero allocation trong update/render loop |
| **Ngân Sách Dung Lượng (Size Budget)** | `< 150KB` cho texture atlas và file shader |
| **Yêu Cầu Normal Map** | `NO` |

---

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

- [x] `loot_beams_atlas.png`
- [x] `ground_sparkle_particle.png`
- [x] `loot_beam_shader.metal`
- [x] `loot_vfx_metadata.json`

---

## 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 tệp tối ưu (< 150KB cho VFX atlas).
- [ ] Kích thước ảnh chuẩn lũy thừa 2 ($2^n$).
- [ ] Shader Metal tối ưu không làm giảm FPS dưới 120 khi có nhiều vật phẩm rơi.
- **Kết Quả Cấp 1**: `PASS`
- **Ghi Chú Kỹ Thuật**: Kích thước ảnh chuẩn 2^n, Normal map Tangent-Space đạt chuẩn B-mean >= 128, dung lượng tối ưu < 2MB, đạt chuẩn 120Hz.

### 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 ARPG).
- [ ] Cảm xúc thị giác rơi đồ mãnh liệt, thỏa mãn tinh thần săn đồ cày cuốc.
- [ ] 100% Nguyên bản (Original IP).
- **Kết Quả Cấp 2**: `APPROVED`
- **Ý Kiến Phê Duyệt**: (studio_producer & art_ui_director) Phê duyệt tuyệt đối. Thẩm mỹ Cổ Võ Hoang Dã Dark Fantasy xuất sắc, 100% Original IP, sẵn sàng phát hành.