This commit is contained in:
2026-04-30 00:55:16 +07:00
parent 1222d39fdf
commit a8d268c42b
18 changed files with 326 additions and 464 deletions

35
GEMINI.md Normal file
View File

@@ -0,0 +1,35 @@
/# 🌑 PROJECT HALLUCINATE - AI Instructions
Đây là file hướng dẫn dành cho Gemini CLI để hiểu bối cảnh và quy chuẩn của dự án HALLUCINATE.
## 🛠 Stack Kỹ thuật
- **Engine:** Unity 6 (6000.3.10f1 LTS)
- **Networking:** Photon Fusion (State Sync, Client-Side Prediction)
- **Render Pipeline:** Universal Render Pipeline (URP)
- **Architecture:** State Machine (Player), Interface-based Interaction (`IInteractable`).
## 📂 Quy chuẩn Cấu trúc Thư mục
Tuân thủ nghiêm ngặt cấu trúc:
- `Assets/Scripts/GameSetup/Maze/`: Các thuật toán tạo mê cung.
- `Assets/Scripts/Player Controller/`: Logic di chuyển và State Machine của người chơi.
- `Assets/Scripts/UI/`: Logic giao diện và Lobby.
- `Assets/Scripts/Fusion/`: Các script liên quan đến Network và Spawner.
## 📜 Quy ước Coding & Logic
1. **Networking:**
- Luôn sử dụng `FixedUpdateNetwork` thay vì `Update/FixedUpdate` cho các logic cần đồng bộ.
- Sử dụng thuộc tính `[Networked]` cho các biến cần đồng bộ trạng thái.
- Ưu tiên Client-Side Prediction và Reconciliation.
2. **Character Control:**
- Sử dụng State Machine để quản lý trạng thái di chuyển (Idle, Move, Sprint, Jump, Dash).
- Camera Dynamics (Shake, FOV Kick) phải được xử lý mượt mà.
3. **Interactions:**
- Mọi vật thể có thể tương tác phải kế thừa từ `IInteractable` hoặc `BaseInteractable`.
4. **Formatting:**
- Luôn sử dụng PascalCase cho tên Method và Class.
- camelCase cho biến private/local.
## 🤖 Chỉ thị cho AI
- **Phản hồi:** Ngắn gọn, súc tích, đi thẳng vào vấn đề kỹ thuật.
- **An toàn:** Không bao giờ tự ý commit code trừ khi được yêu cầu rõ ràng.
- **Tự động hóa:** Luôn cập nhật `MEMORY.md` sau mỗi thay đổi lớn hoặc khi kết thúc phiên làm việc.