'
+' '
+f'SYSTEM READINESS '
+f'{avg_progress:.1f}% '
+'
| '
+''
+' Phase Breakdown '
+f' | '
+'
| {name} | {p_avg:.0f}% ({p_done}/{p_total}) |
| '
+''
+f' SYSTEM READINESS '
+f'{avg_progress:.1f}% '
+'
| '
+''
+' Phase Breakdown '
+f' | '
+'
SYSTEM READINESS 29.0%
| Phase Breakdown
| |||||||||||||||||||
+
+
+ 
+  + Cognitive War Tâm lý chiến + |
+
+  + Spatial Audio Âm thanh 3D + |
+
+  + Procedural Maze Mê cung vô tận + |
+
Tầm nhìn Dự án (Project Vision)
+
Tầm nhìn Dự án (Project Vision)
-Dự án hướng tới việc tạo ra một trải nghiệm **"High-Stakes Hide & Seek"**. Trọng tâm không nằm ở hành động nhanh mà ở sự **kiên nhẫn** và **tính toán**.
-* **Minimalist UI:** Giảm thiểu UI để người chơi tập trung hoàn toàn vào môi trường.
-* **Spatial Audio:** Âm thanh là "bản đồ" thứ hai.
-* **Dynamic Lighting:** Ánh sáng không chỉ để nhìn, mà là công cụ để lộ diện hoặc ẩn mình.
+
Cơ chế Trò chơi (Core Mechanics)
+
Sự bất đối xứng (The Asymmetry)
+### 
DANH MỤC HỆ THỐNG
-| Chỉ số | Seeker (Người Tìm Đường) | Trapper (Kẻ Đặt Bẫy) |
-| :--- | :--- | :--- |
-| **Vai trò** | Chủ động di chuyển, tìm lối thoát. | Phòng thủ, đặt bẫy, chặn đường. |
-| **Tầm nhìn** | Góc nhìn thứ nhất (FPS), đèn pin giới hạn. | Góc nhìn tổng thể (Top-down) hoặc Camera an ninh. |
-| **Tốc độ** | Nhanh (Sprinting: 9.0m/s). | Chậm hơn nhưng có khả năng dịch chuyển. |
-| **Công cụ** | Đèn pin, Dash, Parkour. | Bẫy kẹp, Bẫy âm thanh, Khóa cửa. |
+
+
+ 
+ Tầm nhìn & Triết lý
+ |
+
+ 
+ Cơ chế Core Gameplay
+ |
+
+ 
+ Kiến trúc Technical
+ |
+
+ 
+ Đồng bộ Photon Fusion
+ |
+
+ 
+ Hệ thống Adaptive Difficulty
+ |
+
+ 
+ Lộ trình Roadmap
+ |
+
+ 
+ Hướng dẫn Triển khai
+ |
+
+ 
+ Cấu trúc Workspace
+ |
+
Vòng lặp Gameplay & Kiến trúc Hệ thống (Game Loop & System Architecture)
+---
+
+
Tầm nhìn Dự án (Project Vision)
+
+
+
+ 
+ + The "Zero-UI" Philosophy + + Triệt tiêu hoàn toàn các yếu tố HUD truyền thống. Người chơi phải quan sát nhịp thở, vết máu và môi trường để tự đánh giá trạng thái nhân vật. + |
+
+ 
+ + Acoustic Navigation + + Hệ thống Spatial Audio biến âm thanh thành "bản đồ thị giác thứ hai". Tận dụng HRTF để định vị chính xác đối phương qua các tiếng động siêu nhỏ. + |
+
+ 
+ + Tactical Photometry + + Ánh sáng là tài nguyên chiến thuật. Việc quản lý photon (đèn pin, nến, lửa) quyết định ranh giới giữa kẻ đi săn và con mồi. + |
+
+ Dự án đang trong giai đoạn Technical Alpha, tập trung tối ưu hóa hệ thống Perception.
+
Cơ chế Cốt lõi (Core Mechanics)
+
+> Kiến trúc gameplay của **BABA_YAGA** được xây dựng dựa trên nguyên lý **"Thông tin Bất xứng" (Information Asymmetry)**. Hai phe tham gia không chỉ khác biệt về công cụ, mà còn trải nghiệm trò chơi ở hai chiều không gian và logic hoàn toàn trái ngược nhau.
+
+
Hệ sinh thái Bất đối xứng (The Asymmetric Paradigm)
+
+
+
+
+ Thực thể Động (Kinetic Survivor)
+ |
+
+
+
+ Kiến trúc sư Bóng tối (Environment Architect)
+ |
+
+  Vai trò (Role)+ Chủ động điều hướng (Navigation), quản lý tài nguyên sinh tồn và tìm điểm Extraction Point. Phải di chuyển liên tục để tránh bị cô lập. + |
+
+  Vai trò (Role)+ Thiết lập hệ thống phòng ngự tĩnh, chặn luồng di chuyển (Choke points) và dồn ép tâm lý con mồi vào bẫy tử thần. + |
+
+  Tầm nhìn (Perception)+ Góc nhìn thứ nhất (Immersive FPS). Bị giới hạn hoàn toàn bởi bóng tối, chỉ thấy được những gì chùm sáng đèn pin quét qua. + |
+
+  Tầm nhìn (Perception)+ Góc nhìn Thượng đế (Top-down / Surveillance Cams). Quản lý bản đồ qua hệ thống Heatmap và Camera an ninh đa điểm. + |
+
+  Cơ động (Mobility)+ Tốc độ bứt tốc cao (Sprinting: 9.0m/s). Khả năng tương tác vật lý trực tiếp với môi trường (Vaulting, Sliding). + |
+
+  Cơ động (Mobility)+ Tốc độ vật lý thấp, nhưng bù đắp bằng khả năng Dịch chuyển Tức thời (Teleportation) qua các node mạng lưới bóng tối. + |
+
+  Khí tài (Arsenal)+ 
+ 
+ 
+ |
+
+  Khí tài (Arsenal)+ 
+ 
+ 
+ |
+
Vòng lặp Gameplay & Đồng bộ Hóa (Deterministic Game Loop)
+
+> Toàn bộ logic bên dưới được xử lý trong `FixedUpdateNetwork()` của Photon Fusion. Chúng tôi sử dụng kiến trúc **Server Reconciliation** kết hợp **Client Prediction** để đảm bảo Seeker di chuyển mượt mà (không delay), trong khi Trapper vẫn có quyền kiểm soát toàn vẹn trạng thái bản đồ (Server Authority).
+
+*(Lưu ý kỹ thuật: Sơ đồ dưới đây đã được cấu trúc lại thuộc tính HTML bên trong để đảm bảo khả năng render không bị lỗi trên các bộ phân tích Markdown của GitHub/Gitea)*
```mermaid
graph TD
- %% Định nghĩa Style cho các nhóm
- classDef initStyle fill:#e1f5fe,stroke:#01579b,stroke-width:2px,color:#01579b;
- classDef seekerStyle fill:#fff3e0,stroke:#e65100,stroke-width:2px,color:#e65100;
- classDef trapperStyle fill:#f3e5f5,stroke:#4a148c,stroke-width:2px,color:#4a148c;
- classDef netStyle fill:#eceff1,stroke:#263238,stroke-dasharray: 5 5,color:#263238;
- classDef winStyle fill:#e8f5e9,stroke:#1b5e20,stroke-width:3px,color:#1b5e20;
- classDef criticalStyle fill:#ffebee,stroke:#b71c1c,stroke-width:2px,color:#b71c1c;
+ %% Định nghĩa Style cho các nhóm (Dark Theme Optimized)
+ classDef initStyle fill:#1a2b3c,stroke:#33CCFF,stroke-width:2px,color:#E0E0E0;
+ classDef seekerStyle fill:#332200,stroke:#FFD700,stroke-width:2px,color:#FFD700;
+ classDef trapperStyle fill:#2b0000,stroke:#FF3333,stroke-width:2px,color:#FF3333;
+ classDef netStyle fill:#111111,stroke:#888888,stroke-dasharray: 5 5,color:#E0E0E0;
+ classDef winStyle fill:#003311,stroke:#00FF55,stroke-width:3px,color:#00FF55;
+ classDef criticalStyle fill:#4d0000,stroke:#FF0000,stroke-width:2px,color:#FF0000;
%% Phase 1: Initialization
subgraph Initialization ["1. KHỞI TẠO HỆ THỐNG (NET-SYNC)"]
- A["
Bắt đầu Trận đấu"] --> B{"
Matchmaking
Phân vai: Seeker vs Trapper"]
- C --> D["
Maze Generator
Baking NavMesh & Colliders"]
- E --> F["
Character Auto-Setup"]
- F --> G["
Spawn Players"]
+ A["
Bắt đầu Trận đấu"] --> B{" Matchmaking Phân vai: Seeker vs Trapper"]
+ C --> D[" Maze Generator Baking NavMesh & Colliders"]
+ E --> F[" Character Auto-Setup"]
+ F --> G[" Spawn Players"]
end
class Initialization,A,B,C,D,E,F,G initStyle;
@@ -80,33 +267,33 @@ graph TD
G --> Loop((TICK: FixedUpdateNetwork))
%% Seeker Branch
- subgraph Seeker_Logic ["
SEEKER (POV 1st)"]
- S1["
Input: WASD/Space"] --> S2[" State: Move/Dash"]
- S2 --> S3{"
Hành động?"}
- S3 -- "Sprinting" --> S4["
Noise Up"]
- S3 -- "Sneaking" --> S5["
Noise Down"]
- S3 -- "Flashlight" --> S6["
Lộ vị trí"]
+ subgraph Seeker_Logic ["
SEEKER (POV 1st)"]
+ S1["
Input: WASD/Space"] --> S2[" State: Move/Dash"]
+ S2 --> S3{"
Hành động?"}
+ S3 -- "Sprinting" --> S4["
Noise Up"]
+ S3 -- "Sneaking" --> S5["
Noise Down"]
+ S3 -- "Flashlight" --> S6["
Lộ vị trí"]
- S4 & S5 & S6 --> S_Check{"
Check Env"}
- S_Check -- "Dẫm bẫy" --> S_Trap["
Bị khống chế"]
+ S4 & S5 & S6 --> S_Check{"
Check Env"}
+ S_Check -- "Dẫm bẫy" --> S_Trap["
Bị khống chế"]
end
%% Trapper Branch
- subgraph Trapper_Logic ["
TRAPPER (STRATEGY)"]
- T1["
Mouse Input"] --> T2["
View: Heatmap/Cams"]
- T2 --> T3{"
Kỹ năng?"}
- T3 -- "Đặt bẫy" --> T4["
Sync Trap"]
- T3 -- "Scan" --> T5["
Ping Seeker"]
- T3 -- "Lock" --> T6["
Khóa cửa"]
+ subgraph Trapper_Logic ["
TRAPPER (STRATEGY)"]
+ T1["
Mouse Input"] --> T2["
View: Heatmap/Cams"]
+ T2 --> T3{"
Kỹ năng?"}
+ T3 -- "Đặt bẫy" --> T4["
Sync Trap"]
+ T3 -- "Scan" --> T5["
Ping Seeker"]
+ T3 -- "Lock" --> T6["
Khóa cửa"]
- T4 & T5 & T6 --> T_Check{" Theo dõi"}
+ T4 & T5 & T6 --> T_Check{" Theo dõi"}
end
%% Networking Layer
- subgraph Network_Sync ["
NETWORK SYNC"]
+ subgraph Network_Sync [" NETWORK SYNC LAYER"]
Loop --> NS1["⏩ Client Prediction"]
- NS1 --> NS2[" Server Reconciliation"]
- NS2 --> NS3["
State Sync"]
+ NS1 --> NS2[" Server Reconciliation"]
+ NS2 --> NS3[" State Sync"]
end
end
class Seeker_Logic,S1,S2,S3,S4,S5,S6,S_Check seekerStyle;
@@ -116,497 +303,927 @@ graph TD
%% Phase 3: Results
subgraph Result_Logic ["3. KẾT THÚC & THƯỞNG"]
- S_Check -- "Chạm Exit" --> Win_S["
SEEKER THẮNG"]
- T_Check -- "Bắt được Seeker" --> Win_T[" TRAPPER THẮNG"]
+ S_Check -- "Chạm Exit" --> Win_S["
SEEKER THẮNG"]
+ T_Check -- "Bắt được Seeker" --> Win_T[" TRAPPER THẮNG"]
Loop -- "Timer = 0" --> Win_T
- Win_S & Win_T --> Post_Match["
Thống kê Rank"]
- Post_Match --> Buff{"
Balance Check"}
- Buff -- "Thua cuộc" --> Buff_Apply["
Kích hoạt Comeback Buff"]
+ Win_S & Win_T --> Post_Match["
Thống kê Match"]
+ Post_Match --> Buff{" Hệ thống Adaptive"}
+ Buff -- "Thua liên tiếp" --> Buff_Apply["
Kích hoạt Comeback Buff"]
Buff_Apply --> A
end
class Win_S,Win_T winStyle;
class Result_Logic,Post_Match,Buff,Buff_Apply initStyle;
%% Interactions (Dashed Lines)
- S_Trap -.->|Cảnh báo| T_Check
- S4 -.->|Sóng âm| T2
- T4 -.->|Collision ẩn| S_Check
+ S_Trap -.->|Cảnh báo State| T_Check
+ S4 -.->|Phát xạ Sóng âm| T2
+ T4 -.->|Collision Vô hình| S_Check
NS3 --> Loop
-```
-
---
-## Kiến trúc Kỹ thuật (Technical Architecture)
+## 
Kiến trúc Kỹ thuật (Technical Architecture)
-### 1. Advanced Player & Camera State Machine
+> Hệ thống của **BABA_YAGA** được thiết kế theo chuẩn **Modular Architecture** (Kiến trúc Module), tách biệt hoàn toàn giữa logic xử lý vật lý (Kinematics), trạng thái mạng (Net-State) và phản hồi thị giác (Visual Feedbacks). Điều này đảm bảo hiệu năng cao (High Tickrate) ngay cả trong các môi trường mê cung phức tạp.
-Hệ thống điều khiển nhân vật không chỉ quản lý hành động mà còn điều phối **Camera Dynamics** để tăng cường cảm giác nhập vai và đồng bộ hóa hướng nhìn qua mạng.
+
1. Advanced Kinematic FSM & Camera Dynamics
+
+Hệ thống điều khiển nhân vật cốt lõi được xây dựng trên mô hình **Finite State Machine (FSM)** phân cấp. Không chỉ xử lý nội suy vật lý mượt mà, hệ thống còn tích hợp trực tiếp với **Procedural Camera Dynamics** (Head-bob, Dynamic FOV, Tilt) để tạo ra sự cộng hưởng về cảm giác nhập vai, đồng thời duy trì tính đồng bộ tuyệt đối qua lớp mạng (Networking Layer).
+
+*(Lưu ý: Sơ đồ trạng thái dưới đây đã được tối ưu hóa cho thuật toán dự đoán phía Client)*
```mermaid
stateDiagram-v2
direction TB
- state "
GROUND" as Ground {
+ state "
KINEMATIC GROUND" as Ground {
[*] --> Idle
state Idle {
- I_P: 
Vel < 0.1m/s
- I_C: 🌡️ Breathing (0.5Hz)
+ I_P: 
Vel < 0.1m/s
+ I_C: 
Breathing Cam (0.5Hz)
}
- Idle --> Moving : "Input.mag > 0.1"
+ Idle --> Moving : Input.mag > 0.1
state Moving {
- M_P: 
Speed 2-4m/s
- M_C: 
Head Bob (1.2Hz)
+ M_P: 
Speed 2-4m/s
+ M_C: 
Head Bob (1.2Hz)
}
- Moving --> Sneaking : "OnSneak (Hold)"
+ Moving --> Sneaking : Hold [Sneak]
state Sneaking {
- Sn_P: Noise -50%
- Sn_C: 
Lower Height
+ Sn_P: 
Acoustic Profile -50%
+ Sn_C: 
Collider Height ↓
}
- Moving --> Sprinting : "OnSprint (Hold)"
- state Sneaking --> Moving : "Release Sneak"
+ Moving --> Sprinting : Hold [Sprint]
+ Sneaking --> Moving : Release [Sneak]
+
state Sprinting {
- Sp_P: Speed > 6.5m/s
- Sp_C: 🌈 Dynamic FOV
+ Sp_P: Speed > 6.5m/s
+ Sp_C: 
Dynamic FOV Warp
}
- Sprinting --> Moving : "Stamina Empty"
+ Sprinting --> Moving : Stamina Depleted
}
- state "☁️ AIRBORNE" as Air {
+ state "
AIRBORNE DYNAMICS" as Air {
state Jump {
- J_P: 
AddForce Up
+ J_P: AddForce Up
}
state Falling {
- F_P: Gravity x 1.5
+ F_P: 
Gravity x1.5
}
state Landing {
- L_P: 📏 Impact Check
+ L_P: 
Impact Raycast
}
- Jump --> Falling : "Vel.y < 0"
- Falling --> Landing : "IsGrounded == true"
+ Jump --> Falling : Vel.y < 0
+ Falling --> Landing : KCC.IsGrounded == true
}
- state " ACTION" as Utility {
+ state "
UTILITY / ACTION" as Utility {
state Dashing {
- D_P: Burst 15m/s
+ D_P: 
Vector Burst (15m/s)
}
state Interacting {
- Int_P: 
Root Motion Lock
+ Int_P: 
Root Motion Lock
}
}
- state " NETWORK" as Net {
- state "Input Authority" as IA
- state "State Authority" as SA
- IA --> SA : "Send Input"
- SA --> IA : "Reconcile"
+ state "
NET-SYNC LAYER" as Net {
+ state "Input Authority (Client)" as IA
+ state "State Authority (Server)" as SA
+ IA --> SA : Send Input Tick
+ SA --> IA : Force Reconcile
}
- %% Transitions chính
- Ground --> Air : "IsGrounded == false"
- Air --> Ground : "OnLand Event"
- Ground --> Utility : "OnAbility"
- Utility --> Ground : "Complete"
+ %% Main Transitions
+ Ground --> Air : KCC.IsGrounded == false
+ Air --> Ground : OnLandEvent.Fire()
+ Ground --> Utility : InvokeAbility()
+ Utility --> Ground : Action Complete
- %% Notes
+ %% Sticky Notes for Technical Context
note left of Ground
- 
Sync: Velocity
- State: MoveState
+ 
Sync: KCC Velocity
+ 
State: Networked Enum
end note
note right of Net
- Photon Fusion
- FixedUpdateNetwork
+ 
Photon Fusion
+ 
Anti-Cheat Validated
end note
```
+
2. Tactical Environment Scanner & Interaction
-### 2. Environment Scanner & Interaction
-Hệ thống quét vật thể (`EnvironmentScanner.cs`) sử dụng **SphereCast** và **OverlapSphere** để phát hiện các đối tượng `IInteractable` trong phạm vi tương tác, đảm bảo tính chính xác ngay cả trong bóng tối.
-
-
----
-
-## Hệ thống Mê cung (Maze Generation)
-
-Trái tim của **BABA_YAGA** là hệ thống tạo mê cung đa thuật toán, mang lại sự đa dạng vô hạn.
-
-| Algorithm | Complexity | Description |
-| :--- | :--- | :--- |
-| **Prims** | O(E log V) | Tạo mê cung "dày", nhiều nhánh ngắn, lý tưởng cho việc đặt bẫy. |
-| **Wilsons** | O(N) | Thuật toán ngẫu nhiên hoàn hảo, không có thiên hướng cấu trúc nhất định. |
-| **Recursive** | O(N) | Tạo ra các hành lang dài và sâu, tăng áp lực cho Seeker. |
-| **Crawler** | O(N) | Tạo ra các không gian mở giống hang động hơn là mê cung truyền thống. |
-
-### Quy trình khởi tạo (Maze Generation Pipeline)
-
-```mermaid
-graph TD
- %% Định nghĩa Style
- classDef lossStyle fill:#ffebee,stroke:#c62828,stroke-width:2px,color:#c62828;
- classDef tier1Style fill:#fff8e1,stroke:#fbc02d,stroke-width:2px,color:#f57f17;
- classDef tier2Style fill:#fff3e0,stroke:#fb8c00,stroke-width:2px,color:#e65100;
- classDef tier3Style fill:#fbe9e7,stroke:#ff5722,stroke-width:2px,color:#bf360c;
- classDef systemStyle fill:#f5f5f5,stroke:#424242,stroke-width:2px,color:#424242;
- classDef winStyle fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px,color:#1b5e20;
-
- %% Quy trình chính
- Start(("
PLAYER LOSES ROUND")) --> Streak{{" Check Loss Streak"}}
-
- %% Phân tầng Buff
- subgraph Buff_Pools ["
HỆ THỐNG CÂN BẰNG ĐỘNG (COMEBACK POOLS)"]
- Streak -- "1 Trận" --> T1
- Streak -- "2 Trận" --> T2
- Streak -- "3+ Trận" --> T3
-
- T1["
Tier 1: Awakening Tier 2: Evolution Tier 3: Manifestation
Selection Mode"}}
-
- Selection -- "Manual" --> P1["Người chơi tự chọn 1 trong 3 Buff"]
- Selection -- "Auto" --> P2["Hệ thống chọn ngẫu nhiên"]
-
- P1 & P2 --> Apply[" Apply to Next Round Only
New Round Result?"}}
-
- Result -- " WIN" --> Reset["
Reset Streak
Increase Streak Fair Match"))
- Increment --> Start
-
- %% Gán Style
- class Start,Increment lossStyle;
- class T1,T1_Ex tier1Style;
- class T2,T2_Ex tier2Style;
- class T3,T3_Ex tier3Style;
- class Selection,P1,P2,Apply systemStyle;
- class Result,Reset,NewGame winStyle;
+Việc tương tác trong một môi trường bị giới hạn hoàn toàn về tầm nhìn đòi hỏi một hệ thống truy vấn không gian (Spatial Querying) cực kỳ chính xác. Chúng tôi từ chối sử dụng cơ chế Raycast điểm đơn thông thường.
+
+
+ |
+
+Hệ thống lõi:
+ |
+
Đồng bộ Mạng (Networking)
+## Kiến trúc Mạng (Advanced Netcode Architecture)
-Sử dụng **Photon Fusion (State Sync)** với cơ chế Client-Side Prediction để đảm bảo trải nghiệm không độ trễ.
+> Để đảm bảo tính công bằng trong một tựa game mang nặng yếu tố hành động lén lút và phản xạ ngàn cân treo sợi tóc, **BABA_YAGA** sử dụng **Photon Fusion (State Sync)** làm lõi đồng bộ. Hệ thống được tinh chỉnh để mô phỏng cảm giác "Độ trễ bằng 0" (Zero-Latency Feel) thông qua kiến trúc mạng tất định (Deterministic Network).
+
+
+ 
+ + Client-Side Prediction + + Mô phỏng trước các chuyển động của người chơi trên Local Client, loại bỏ hoàn toàn độ trễ Input Delay khi di chuyển hoặc lướt. + |
+
+ 
+ + Server Authority + + Máy chủ nắm quyền quyết định cuối cùng. Ngăn chặn triệt để các hành vi gian lận như Speedhack, Teleport hay thao túng Hitbox. + |
+
+ 
+ + Lag Compensation + + Rewind trạng thái Hitbox trên Server về đúng thời điểm Client thực hiện thao tác (Ping), đảm bảo tính chính xác cho các cú vồ/bẫy. + |
+
Vòng xoay Dữ liệu Mạng (Network Data Flow Pipeline)
+
+> Biểu đồ dưới đây mô tả luồng xử lý thông tin tại mỗi **Tick (Khung hình mạng)**. Việc phân tách rõ ràng giữa *Logical State* (trạng thái mạng) và *Visual Presentation* (hiển thị hình ảnh) giúp khung hình của game (FPS) không bị khóa vào Tickrate của Server.
+
+*(Lưu ý: Các trích xuất HTML trong sơ đồ đã được chuẩn hóa để tương thích hoàn toàn với bộ phân tích Markdown)*
-### Network Data Flow & Synchronization
```mermaid
sequenceDiagram
autonumber
- participant IR as Input
- participant CP as 🎀 Local Player
- participant NT as Fusion Net
- participant S as 
Server
- participant RP as 
Proxies
+ %% Khai báo các thực thể
+ participant IR as 
Input
+ participant CP as 
Local Client
+ participant NT as 
Fusion Net
+ participant S as 
Server Auth
+ participant RP as Proxies
%% --- GIAI ĐOẠN 1 ---
- Note over IR, CP: [PHASE 1] Thu thập Input
- IR->>CP: OnMove / OnJump / OnSprint
- CP->>CP: Pack NetworkInputData
+ Note over IR, CP: [PHASE 1] Data Sampling (Thu thập)
+ IR->>CP: Hành động (Move / Ability / Interact)
+ CP->>CP: Đóng gói NetworkInputStruct
%% --- GIAI ĐOẠN 2 ---
- Note over CP: [PHASE 2] Dự đoán (Prediction)
- CP->>CP: Run Client-Side Physics
- CP->>NT: 
Send Input (Tick N)
+ Note over CP: [PHASE 2] Client Prediction (Dự đoán)
+ CP->>CP: Thực thi Physics & Kinematics tức thì (Tick N)
+ CP->>NT: Transmit Input Payload (Gửi lên mạng)
%% --- GIAI ĐOẠN 3 ---
- Note over NT, S: [PHASE 3] Truyền tin mạng
- NT->>S: UDP Packet Delivery
- Note right of S: SERVER SIMULATION
- S->>S: Validate & Update State
- S-->>NT: 
Snapshot (Tick N)
+ Note over NT, S: [PHASE 3] Server Validation (Xác thực)
+ NT->>S: UDP Reliable Packet Delivery
+ Note right of S: SERVER TICK SIMULATION
+ S->>S: Validate Ruleset & Apply Physics State
+ S-->>NT: Broadcast Global State Snapshot (Tick N)
%% --- GIAI ĐOẠN 4 ---
- Note over NT, CP: [PHASE 4] Hồi đáp & Đồng bộ
- NT-->>CP: State Snapshot
- Note over CP: RECONCILIATION
- CP->>CP: Fix Position if Error > Threshold
+ Note over NT, CP: [PHASE 4] Reconciliation (Điều chỉnh bù trừ)
+ NT-->>CP: Nhận State Snapshot Feed
+ Note over CP: ERROR CORRECTION PROTOCOL
+ CP->>CP: Detect Desync -> Snap Transform -> Resimulate Ticks
%% --- GIAI ĐOẠN 5 ---
- Note over NT, RP: [PHASE 5] Proxy Update
- NT-->>RP: State Snapshot
- Note over RP: 
INTERPOLATION (Lerp)
+ Note over NT, RP: [PHASE 5] Proxy Update (Cập nhật thực thể bên thứ 3)
+ NT-->>RP: Nhận State Snapshot Feed
+ Note over RP: NETWORK INTERPOLATION
+ RP->>RP: Lerp Position/Rotation (Bù nội suy mượt mà)
%% --- GIAI ĐOẠN 6 ---
- Note over CP, RP: [PHASE 6] Hiển thị (Render)
- CP->>CP: Update Camera Shake/VFX
- RP->>RP: Smooth Mesh Movement
+ Note over CP, RP: [PHASE 6] Visual Render (Hiển thị)
+ CP->>CP: Trigger Camera Shake / Local VFX
+ RP->>RP: Cập nhật Animation Parameters & Mesh
+
+
+Hệ thống được thiết lập chạy ở 60 Ticks/Second, băng thông ước tính <10kb/s mỗi Client.
+
Kiến trúc Netcode (Deterministic Networking)
+
+
+ 
+ 
+|
+ Client-Side Prediction (Dự đoán cục bộ) + Người chơi nội bộ (Local Player) thực thi các lệnh di chuyển, lướt, rọi đèn pin ngay lập tức mà không cần đợi Server cho phép. Tạo cảm giác điều khiển mượt mà như game Offline. + |
+
+ Server Reconciliation (Thuật toán Đối chiếu) + Máy chủ vẫn nắm quyền tối thượng (Authority). Nếu Client dự đoán sai (do va chạm với bẫy hoặc bị kẹt), Server sẽ ép Client "Rollback" về trạng thái chuẩn trong tích tắc (Snap Correction). + |
+
Network Data Flow (Luồng Đồng bộ Hóa)
+
+> Sơ đồ biểu diễn vòng đời của một **Network Tick** từ khi người chơi nhấn phím đến khi hình ảnh được kết xuất (Render) trên màn hình của những người chơi khác.
+
+```mermaid
+sequenceDiagram
+ autonumber
+
+ %% Phân vùng không gian hệ thống (Sử dụng Box Grouping)
+ box rgba(51, 204, 255, 0.05) "⚡ LOCAL ENVIRONMENT (Client Auth)"
+ participant IR as 
Input
+ participant CP as Local Player
+ end
+
+ box rgba(255, 51, 51, 0.05) "👑 SERVER ENVIRONMENT (State Auth)"
+ participant NT as 
Network Layer
+ participant S as Server Tick
+ end
+
+ box rgba(255, 215, 0, 0.05) "👁️ REMOTE OBSERVERS"
+ participant RP as 
Proxies
+ end
+
+ %% --- GIAI ĐOẠN 1 ---
+ Note over IR, CP: [PHASE 1] DATA ACQUISITION
+ IR->>CP: OnMove / OnAbility (Raw Input)
+ CP->>CP: 
Pack NetworkInputStruct
+
+ %% --- GIAI ĐOẠN 2 ---
+ Note over CP: [PHASE 2] FORWARD PREDICTION
+ CP->>CP: 
Run Local Kinematics (Tick N)
+ CP->>NT: 
Transmit Input Payload
+
+ %% --- GIAI ĐOẠN 3 ---
+ rect rgba(255, 51, 51, 0.1)
+ Note over NT, S: [PHASE 3] SERVER VALIDATION (Simulation)
+ NT->>S: Deliver UDP Packet
+ S->>S: 
Validate Rules & Apply Physics
+ S-->>NT: 
Broadcast State Snapshot (Tick N)
+ end
+
+ %% --- GIAI ĐOẠN 4 ---
+ Note over NT, CP: [PHASE 4] RECONCILIATION PROTOCOL
+ NT-->>CP: State Snapshot (Global Truth)
+ CP->>CP: Check Desync (Threshold)
+ CP->>CP: 
Snap Pos & Resimulate if Error
+
+ %% --- GIAI ĐOẠN 5 ---
+ Note over NT, RP: [PHASE 5] PROXY INTERPOLATION
+ NT-->>RP: State Snapshot
+ RP->>RP: 
Lerp Position / Rotation Smoothly
+
+ %% --- GIAI ĐOẠN 6 ---
+ Note over CP, RP: [PHASE 6] VISUAL RENDERING
+ CP->>CP: 
Update Local VFX / Camera Shake
+ RP->>RP: 
Update Animator & Mesh Transforms
+
+
+Tất cả Logic Va chạm (Collision) và Phát hiện Âm thanh (Noise Detection) được phân tách hoàn toàn khỏi luồng Render đồ họa, ngăn chặn hiện tượng rách hình ảnh (Tearing) do lag mạng.
+ Hệ thống Comeback Đa tầng (Tiered Adaptive System)
+## 
Hệ thống Cân bằng Thích ứng (Tiered "Despair" Mechanics)
-Để đảm bảo mỗi trận đấu đều kịch tính đến giây cuối cùng, BABA_YAGA áp dụng hệ thống **"Despair Mechanics"**. Người chơi có chuỗi thua càng dài sẽ nhận được quyền năng từ mê cung càng lớn, tạo ra những khoảnh khắc lật kèo kinh điển.
+
+ Phân tầng Buff theo Chuỗi Thua (Tiered Progression)
+> Để duy trì trạng thái **"Căng thẳng tột độ" (High-Stakes)** đến những giây phút cuối cùng, kiến trúc của **BABA_YAGA** tích hợp một động cơ cân bằng ngầm mang tên **"Despair Mechanics"**. Khi một thực thể bị đẩy vào chuỗi thất bại liên tiếp, Mê cung sẽ bẻ cong các quy tắc vật lý và logic thông thường để ban cho họ những đặc quyền sinh tồn phi mã, tạo ra những khoảnh khắc lật kèo (Comeback) chấn động mạng lưới.
-| Chuỗi Thua | Phân tầng | Tên gọi | Quyền năng & Cơ chế |
-| :--- | :--- | :--- | :--- |
-| **1 Trận** | Tier 1 | *Awakening* | Chọn 1 Buff cơ bản (Tăng tốc +15% hoặc Mở rộng tầm nhìn +20%). |
-| **2 Trận** | Tier 2 | *Evolution* | Nhận 1 Buff chủ động (Kỹ năng nhấn nút) + 1 Buff bị động (Nâng cấp chỉ số). |
-| **3+ Trận** | Tier 3 | *Manifestation* | **Ultimate Skill:** Kỹ năng thay đổi luật chơi trong 30s. Mê cung sẽ hỗ trợ bạn trực tiếp. |
+ Phân tầng Bù trừ theo Chuỗi Thua (Progression Hierarchy)
+
+
+  +  + TIER 1: Awakening+Khởi động giao thức sinh tồn cơ bản. Lựa chọn 1 Buff thụ động (Nâng cấp chỉ số Base Stats như Tốc độ / Tầm nhìn). + |
+
+  +  + TIER 2: Evolution+Tiến hóa cơ sở hạ tầng. Nhận đồng thời 1 Kỹ năng Chủ động (Active Skill) và 1 Đặc quyền Thụ động (Passive Perk). + |
+
+  +  + TIER 3: Manifestation+Ghi đè hệ thống (Override Ruleset). Kích hoạt Ultimate Skill thay đổi hoàn toàn cục diện trận đấu trong thời gian ngắn. + |
+
Seeker: Ý chí Sinh tồn (Survival Evolution)
+### 
THE SEEKER: Thức Tỉnh Bản Năng (Survival Evolution)
-Khi Seeker liên tục thất bại, các giác quan của họ sẽ tiến hóa vượt bậc để chống lại bóng tối:
+Khi Seeker liên tục bị bóng tối nuốt chửng, hệ thần kinh của họ sẽ bị ép buộc tiến hóa vượt giới hạn để chống lại môi trường khắc nghiệt:
-* **Tier 1 - Sixth Sense (Linh cảm):** Seeker bắt đầu nghe thấy tiếng tim đập của chính mình nhanh hơn khi Trapper đang ở gần (bán kính 15m), giúp định vị mà không cần nhìn.
-* **Tier 2 - Shadow Step (Bước chân hư vô):** Di chuyển hoàn toàn không gây ra tiếng động (Noise Meter = 0) trong 20 giây đầu của trận đấu. Cho phép Seeker thiết lập vị trí an toàn sớm.
-* **Tier 2 - Trap Reflex (Phản xạ tột độ):** Seeker có 50% cơ hội tự động vô hiệu hóa bẫy kẹp đầu tiên dẫm phải. Nếu thành công, Seeker sẽ được tăng 50% tốc độ chạy trong 3s.
-* **Tier 3 - Ultimate: Chrono Dash:** Trong 15 giây, Seeker có thể thực hiện Dash không giới hạn (No Cooldown) và trở nên miễn nhiễm with mọi loại khống chế. Lúc này, Seeker là kẻ săn lùng lối thoát.
+
+ 
+ |
+
+ Acoustic Resonance (Cộng hưởng Hạ âm) + Kích hoạt khả năng cảm nhận tần số thấp. Seeker có thể nghe thấy nhịp tim đập dồn dập của chính mình khi Trapper tiến vào bán kính 15m, đóng vai trò như một radar sinh học mà không cần sử dụng thị giác. + |
+
+ 
+ |
+
+ Kinematic Void (Bước chân Hư vô) + Triệt tiêu hoàn toàn ma sát vật lý. Seeker không phát ra bất kỳ sóng âm nào (Noise Meter = 0) khi di chuyển trong 20 giây đầu tiên, cho phép thiết lập điểm mù chiến thuật (Blindspot) từ sớm. + |
+
+ 
+ |
+
+ Neural Overdrive (Phản xạ Tột độ) + Có 50% cơ hội ghi đè (Bypass) cơ chế kích hoạt của bẫy cơ học đầu tiên vô tình chạm phải. Nếu bypass thành công, hệ thống bơm Adrenaline sẽ kích hoạt, cộng dồn 50% vận tốc bứt tốc trong 3 giây. + |
+
+ 
+ |
+
+ Temporal Displacement (Phá vỡ Thời Không) + Trong 15 giây, thể lực (Stamina) bị khóa ở mức vô hạn. Seeker có thể Dash liên tục (Zero Cooldown) và đạt trạng thái I-Frame (Miễn nhiễm khống chế). Lúc này, luật chơi đảo chiều: Seeker là kẻ săn lùng lối thoát.
+ |
+
Trapper: Quyền năng Bóng tối (Dark Rituals)
+### 
THE TRAPPER: Hiến Tế Không Gian (Dark Rituals)
-Khi Trapper để xổng mất con mồi, mê cung sẽ hiến tế sự ổn định của nó để ban cho Trapper những quyền năng thao túng cực hạn:
-
-* **Tier 1 - Paranoia Echo (Tiếng vọng ảo giác):** Tự động tạo ra 3 nguồn âm thanh bước chân giả chạy xung quanh Seeker để gây nhiễu loạn khả năng định hướng bằng âm thanh của họ.
-* **Tier 2 - Global Blackout (Bóng tối bao trùm):** Kích hoạt khiến đèn pin của Seeker bị nhiễu (Flicker) hoặc tắt hoàn toàn trong 8 giây. Đây là thời điểm vàng để Trapper thu hẹp khoảng cách.
-* **Tier 2 - Ghosting (Dịch chuyển không gian):** Trapper nhận khả năng đi xuyên qua các cánh cửa đã bị khóa hoặc các bức tường mỏng (Destructible Walls) trong 15 giây.
-* **Tier 3 - Ultimate: Eye of the Abyss:** Hiển thị vị trí thực của Seeker xuyên tường (Wallhack) dưới dạng bóng đen trong 20 giây. Seeker không thể trốn chạy, chỉ có thể cầu nguyện.
+Khi Trapper để mất quyền kiểm soát, Mê cung sẽ tự động phân rã sự ổn định của nó, cấp cho Trapper quyền truy cập vào các giao thức thao túng môi trường cực hạn:
+
+ 
+ |
+
+ Aural Hallucination (Nhiễu loạn Nhận thức) + Phát xạ 3 luồng tín hiệu âm thanh ảo đa hướng xung quanh Seeker. Các tín hiệu này can thiệp trực tiếp vào hệ thống Spatial Audio, tạo ảo giác về tiếng bước chân dồn dập nhằm đánh sập khả năng định vị của con mồi. + |
+
+ 
+ |
+
+ Photon Suppression (Triệt tiêu Quang năng) + Hấp thụ toàn bộ ánh sáng trong khu vực. Đèn pin của Seeker sẽ bị ép vào trạng thái nhiễu loạn (Flicker) hoặc sập nguồn hoàn toàn trong 8 giây. Đây là khung cửa tử thần (Kill-window) hoàn hảo để thu hẹp khoảng cách. + |
+
+ 
+ |
+
+ Quantum Phase (Phi vật chất hóa) + Tạm thời vô hiệu hóa Layer Collision của Trapper. Cấp khả năng đi xuyên qua các cánh cửa đã bị khóa mã hoặc các cấu trúc tường mỏng (Destructible Walls) trong 15 giây, bỏ qua mọi rào cản vật lý. + |
+
+ 
+ |
+
+ Abyssal Omniscience (Nhãn quan Lưỡi Hái) + Đồng bộ hóa trực tiếp với mạng lưới lõi của mê cung. Render vị trí thời gian thực của Seeker xuyên qua mọi vật cản (Absolute Wallhack) dưới dạng bóng tối (Silhouette) trong 20 giây. Không có góc khuất, không có lối thoát. + |
+
Lộ trình Phát triển (Roadmap)
+## 
Lộ trình Triển khai (Development Roadmap)
+
+> Tiến trình xây dựng kiến trúc **BABA_YAGA**. Dự án được phát triển theo mô hình Agile, ưu tiên hoàn thiện độ ổn định của lõi Netcode (Networking) trước khi mở rộng các module Meta-game và Visuals.
+
+
+ 
+ + 
+ |
+
+ Phase 1: Architecture Foundation+
+
|
+ |||
+
+ 
+ +
+ |
+
+ Phase 2: Asymmetric Core Loop+
+
|
+ |||
+ 
+ |
+
+ Phase 3: Meta-Game & Polish+
+
|
+
Đội ngũ Phát triển & Phân chia Nhiệm vụ (The Team & WBS)
+## 
Bộ máy Kỹ thuật (Core Engineering Team & WBS)
-Dự án được thực hiện bởi nhóm 3 thành viên với các vai trò chuyên biệt, đảm bảo tính chuyên môn hóa cao trong quy trình sản xuất Game.
+> Dự án được phát triển và vận hành bởi một **Micro-Studio 3 thành viên**. Để đạt được chất lượng tiệm cận AAA-Indie trong một thời gian giới hạn, chúng tôi áp dụng mô hình chuyên môn hóa sâu (Deep Specialization) theo từng phân hệ kỹ thuật lõi.
-| Thành viên | Vai trò | Trách nhiệm chi tiết (Work Breakdown Structure) |
-| :--- | :--- | :--- |
-| **Scove** | **Trưởng nhóm / World Architect** | - Nghiên cứu & triển khai thuật toán Maze (Prims, Wilsons, Crawler).SYSTEM READINESS 29.0%
| Phase Breakdown
| |||||||||||||||||||
+  + SCOVE +  + 
+ |
+
+ Phân rã Công việc (Work Breakdown Structure)+
|
+
|
+ + DUY +  + 
+ |
+
+ Phân rã Công việc (Work Breakdown Structure)+
|
+
+  + TUẤN +  + 
+ |
+
+ Phân rã Công việc (Work Breakdown Structure)+
|
+
Tiêu chuẩn Kỹ thuật Nâng cao (Non-functional Requirements)
+## 
Giao thức Chất lượng (Strict Engineering Protocols)
-Mỗi thành viên phải tuân thủ nghiêm ngặt các tiêu chuẩn kỹ thuật sau để đảm bảo dự án đạt chất lượng AAA-Indie:
+> Bộ tiêu chuẩn **NFR (Non-functional Requirements)** bắt buộc. Mọi dòng code được Commit (Merge Request) đều phải vượt qua bài kiểm tra chéo dựa trên 4 trụ cột kỹ thuật dưới đây.
-### Networking & Synchronization (Duy)
-* **RTT Optimization:** Duy trì Round Trip Time < 150ms; tối ưu hóa kích thước gói tin bằng `[Networked]` và `Reliable RPCs`.
-* **State Authority:** Mọi logic Thắng/Thua và Trigger bẫy phải được xác thực hoàn toàn tại **Server** để ngăn chặn gian lận.
-* **Interpolation Smoothing:** Đảm bảo di chuyển của đối thủ (Remote Proxies) mượt mà ngay cả khi mất gói tin (Packet Loss).
+ World Generation & Performance (Scove)
-* **Algorithmic Complexity:** Thuật toán tạo mê cung phải đạt hiệu năng O(N) hoặc O(N log N) để tránh treo Editor/Runtime.
-* **Draw Call Batching:** Tối ưu hóa Mesh mê cung để đạt mức Draw Calls thấp nhất (Sử dụng Static Batching & GPU Instancing).
-* **NavMesh Runtime:** Tự động bake NavMesh sau khi Maze tạo xong để hỗ trợ AI và các tính năng hỗ trợ Trapper.
+
+
+
+
+ |
-###
+
+
+ |
+
+
+
+ |
+
+
+
+
+
+ |
+
Cấu trúc Thư mục (Workspace Architecture)
-Dự án được tổ chức theo tiêu chuẩn công nghiệp (Standard Industry Practices), tách biệt rõ ràng giữa logic Code, Assets và Configuration.
+> Cấu trúc không gian làm việc của **BABA_YAGA** tuân thủ nghiêm ngặt mô hình **Quy chuẩn Công nghiệp (Standard Industry Practices)**. Sự phân tách rạch ròi giữa Dữ liệu tĩnh (Assets), Lõi Logic (Core Scripts) và Cấu hình hệ thống (Configs) đảm bảo khả năng mở rộng (Scalability) và triệt tiêu Conflict khi làm việc nhóm.
-```text
-📦 BABA_YAGA
-├── 🌸 Assets/ (Trái tim của trò chơi)
-│ ├── 📜 Scripts/ (Phép thuật điều khiển logic)
-│ │ ├── 🏷️ Attributes/ # Tùy biến Inspector
-│ │ ├── 🎥 Camera Controller/
-│ │ ├── 🛠️ Debug/
-│ │ ├── 🌐 Fusion/
-│ │ │ └── 🚀 BasicSpawner.cs
-│ │ ├── 🏗️ GameSetup/
-│ │ │ ├── 🌀 Maze/ # Mê cung
-│ │ │ │ ├── 🐾 Crawler.cs
-│ │ │ │ ├── 🌳 Prims.cs
-│ │ │ │ ├── 🧵 Wilsons.cs
-│ │ │ │ └── 🗺️ Maze.cs
-│ │ │ └── 🧍 CharacterAutoSetup.cs
-│ │ ├── 鼠标 Interactables/
-│ │ │ ├── 🚪 DoorInteractable.cs
-│ │ │ ├── 💡 LampInteractable.cs
-│ │ │ └── 💎 BaseInteractable.cs
-│ │ ├── 📐 Interface/
-│ │ ├── 🏃♀️ Player Controller/
-│ │ │ ├── 🧠 PlayerStateMachine.cs
-│ │ │ ├── ⌨️ InputReader.cs
-│ │ │ └── 🎭 States/
-│ │ ├── ⚡ Optimization/
-│ │ ├── 🖥️ UI/
-│ │ └── 🎆 VFX/
-│ ├── 🧸 Prefabs/
-│ ├── 📖 document/
-│ ├── 🎬 Scenes/
-│ ├── 🎨 Materials/
-│ ├── 👸 Models/
-│ ├── 💃 Animation/
-│ ├── 🔌 Photon/
-│ ├── 🅰️ TextMesh Pro/
-│ └── ⚙️ Settings/
-├── 🛠️ ProjectSettings/
-│ ├── 🏷️ TagManager.asset
-│ ├── 🌍 DynamicsManager.asset
-│ └── 📡 MultiplayerManager.asset
-├── 📦 Packages/
-└── 📝 README.md # Creator (｡•̀ᴗ-)✧
+
**BABA_YAGA_PROJECT/**
+
+ 
**Assets/** — Trái tim của trò chơi
+
+ 
**Scripts/** — Phép thuật điều khiển logic
+
+ 
**Attributes/** (Tùy biến Inspector)
+
+ **Camera Controller/**
+
+ 
**Debug/**
+
+ 
**Fusion/**
+
+ 
`BasicSpawner.cs`
+
+ 
**GameSetup/**
+
+ 
**Maze/** (Thuật toán Mê cung)
+
+ `Maze.cs`
+
+ `Crawler.cs`
+
+ `Prims.cs`
+
+ `Wilsons.cs`
+
+ `CharacterAutoSetup.cs`
+
+ **Interactables/**
+
+ `BaseInteractable.cs`
+
+ `DoorInteractable.cs`
+
+ `LampInteractable.cs`
+
+ 
**Interface/**
+
+ **Optimization/**
+
+ **Player Controller/**
+
+ `PlayerStateMachine.cs`
+
+ `InputReader.cs`
+
+ 
**States/**
+
+ 
**UI/**
+
+ 
**VFX/**
+
+ 
**Prefabs/**
+
+ 
**document/**
+
+ 
**Scenes/**
+
+ 
**Materials/**
+
+ 
**Models/**
+
+ 
**Animation/**
+
+ 
**Photon/**
+
+ 
**TextMesh Pro/**
+
+ 
**Settings/**
+
+ 
**ProjectSettings/**
+
+ 
`TagManager.asset`
+
+ `DynamicsManager.asset`
+
+ `MultiplayerManager.asset`
+
+ 
**Packages/**
+
+ `README.md` — Creator (｡•̀ᴗ-)✧
+
+
Giao thức Triển khai (Deployment Protocol)
+
+> Hướng dẫn thiết lập môi trường phát triển và kết nối mạng lưới cho **BABA_YAGA**. Khuyến nghị sử dụng công cụ **ParrelSync** để tối ưu hóa quy trình kiểm thử Multiplayer (Mô phỏng Host/Client) ngay trên một Editor duy nhất.
+
+
+  + Engine Core + Unity 6000.3.10f1+ + |
+
+ + Architecture + Win 10/11 | macOS (M/Intel) + |
+
+  + Storage Budget + ~5.0 GB (Repo + Library) + |
+
1. Khởi tạo Không gian mạng (Repository Clone)
+
+```bash
+# Clone mã nguồn dự án từ kho lưu trữ chính thức
+git clone https://github.com/OnlyScove/BABA_YAGA.git
+
+ Mở Unity Hub ➝ Chọn Add ➝ Add project from disk.
+
+ Trỏ đường dẫn đến thư mục BABA_YAGA vừa clone. Lần chạy đầu tiên (Import Asset Pipeline & Library) có thể mất từ 3 - 5 phút.
+```
+
2. Khớp mã Máy chủ Photon (Fusion AppID Config)
+
+
+ |
+
+ Trò chơi yêu cầu kết nối đến cụm máy chủ Relay của Photon để xử lý State Sync. Bạn bắt buộc phải cung cấp một AppID hợp lệ: +
|
+
3. Khởi chạy Trình mô phỏng (Launch Simulation)
+
+ Mở Scene trung tâm tại: Assets/Scenes/Main Scene.unity.
+
+ Nhấp vào Smart Bootstrapper (Nằm trên thanh Menu Top-bar của Unity) để tự động hóa quy trình tiêm (Inject) cấu hình Network Runner.
+
+ Nhấn nút Play 
trong Editor.
+
+ Để test thực tế: Khuyến nghị Build ra file .exe độc lập, hoặc sử dụng hệ thống ParrelSync Clone Editor để chạy 2 Instances song song.
+
+
Trung tâm Tín hiệu (Community & Support)
+
+
+
+
+
+
+
+ Hướng dẫn Cài đặt & Khởi chạy (Installation & Setup)
-
-Để trải nghiệm **BABA_YAGA** một cách mượt mà nhất, vui lòng thực hiện theo các bước chi tiết dưới đây:
-
-### 1. Yêu cầu Hệ thống
-* **Unity Editor:** Phiên bản **6000.3.10f1 (Unity 6)** trở lên.
-* **Hệ điều hành:** Windows 10/11 hoặc macOS (M1/M2/Intel).
-* **Disk Space:** Tối thiểu 5GB trống để chứa Project và Library.
-
-### 2. Tải về & Mở dự án
-1. **Clone Repository:**
- ```bash
- git clone https://github.com/OnlyScove/BABA_YAGA.git
- ```
-2. Mở **Unity Hub**, chọn **Add** -> **Add project from disk**.
-3. Tìm đến thư mục vừa clone và nhấn **Open**. Chờ Unity Hub tải các Packages cần thiết (có thể mất vài phút).
-
-### 3. Cấu hình Photon Fusion (Bắt buộc)
-Trò chơi yêu cầu **AppID** hợp lệ để hoạt động qua mạng:
-1. Đăng nhập vào [Photon Engine Dashboard](https://dashboard.photonengine.com/).
-2. Tạo một ứng dụng mới với loại App là **Fusion**.
-3. Sao chép **App ID** vừa tạo.
-4. Trong Unity Editor, đi đến: `Photon` -> `Fusion` -> `Network Project Settings`.
-5. Dán App ID vào mục **App Id Fusion** (cho cả Realtime và Fusion).
-6. Đảm bảo **Network Mode** được đặt là `Client/Server` (để hỗ trợ State Authority).
-
-### 4. Khởi chạy Trò chơi
-1. Mở Scene chính tại: `Assets/Scenes/Main Scene.unity`.
-2. Sử dụng **Smart Bootstrapper** (nằm ở thanh Menu trên cùng) để tự động cấu hình Runner.
-3. Nhấn nút **Play** trong Unity Editor.
-4. Để test Multiplayer, bạn có thể build ra file `.exe` hoặc sử dụng công cụ **ParrelSync** (nếu đã cài) để chạy hai instance cùng lúc.
-
----
-
-## 
Support & Community
-
-
-
-
-
-
-
-
THE TRAPPER
+ 
Kinematic State Machine: Xử lý mượt mà chuỗi trạng thái nội suy (Idle, Move, Sprint, Airborne).
Net-Role Arbitration: Hệ thống phân quyền và lựa chọn vai trò mạng (Seeker vs Trapper).
Triển khai kiến trúc thuật toán Maze lõi (Prims, Wilsons, Crawler).
Xây dựng bộ máy Mesh Generation kiến tạo môi trường 3D tự động.
Giám sát tính Solvability (Đảm bảo Mê cung luôn có đường thoát khả thi).
Thiết kế toán học cho hệ thống Comeback Đa tầng (Despair Mechanics).
Code Review toàn cục & Quản lý vòng đời State Machine tổng.
Xây dựng & Quản lý hạ tầng Photon Fusion (Matchmaking, Session Relay).
Cấu trúc hóa 
Thiết lập logic phân vai mạng (Role Assignment) và Server Game State.
Lập trình hệ thống Noise Meter & Quản lý quang năng (Flashlight/Battery).
Xây dựng Logic bẫy Trapper: Snare (Khống chế), Alarm (Báo động), Decoy (Giả thanh).
Phát triển Camera Dynamics (FOV Kick, Screen Shake, Tilt, Motion Blur).
Tích hợp 3D Spatial Audio & Hiệu ứng thị giác (VFX) tương tác môi trường.
Thiết kế trải nghiệm HUD & Luồng UI/UX (Menu, State transitions).
Visuals & UI/UX (Tuấn)
-* **Rendering (Unity 6):** Tận dụng **URP (Universal Render Pipeline)** và Render Graph để tạo hiệu ứng bóng tối chất lượng cao.
-* **Asset Compression:** Texture sử dụng chuẩn nén ASTC/DXT5; Mesh polycount tối ưu cho môi trường di động và PC tầm trung.
-* **UX Consistency:** Tín hiệu phản hồi (VFX/SFX/Haptic) phải nhất quán để người chơi nhận biết ngay lập tức các sự kiện trong game.
+
+ 
World & Perf (Assigned to: Scove)
+ 
Mechanics (Assigned to: Tuấn)
+ 
Render & UX (Assigned to: Tuấn)
+ 
+
+
+
+
+
+
- 
- 
- 
- 
- 
-