From b22e952dd9f91f71009df487825e8d8e587d4609 Mon Sep 17 00:00:00 2001
From: scove <Trannguyenp303@gmail.com>
Date: Wed, 8 Apr 2026 11:56:05 +0700
Subject: [PATCH] Update README

---
 README.md | 82 +++++++++++++++++++++++++++++++++++++++++++------------
 1 file changed, 65 insertions(+), 17 deletions(-)

diff --git a/README.md b/README.md
index 6414987a..b29ce3a0 100644
--- a/README.md
+++ b/README.md
@@ -26,7 +26,7 @@
 ## 👁️ Tầm nhìn Dự án (Project Vision)
 
 ![Game Concept Art](https://scove-vault.duckdns.org/files/api/preview/big/ScoveThing/New%20Picture/modeus_1.jpg?inline=true&key=1775622184946)
-*(Placeholder: Visualizing the dark atmosphere and light contrast)*
+
 
 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.
@@ -46,25 +46,73 @@ Dự án hướng tới việc tạo ra một trải nghiệm **"High-Stakes Hid
 | **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. |
 
-### 🔄 Vòng lặp Gameplay (Game Loop)
+### 🔄 Vòng lặp Gameplay & Kiến trúc Hệ thống (Game Loop & System Architecture)
 
 ```mermaid
 graph TD
-    A[Bắt đầu Trận đấu] --> B{Phân vai ngẫu nhiên}
-    B -- Seeker --> C[Tìm lối thoát Exit]
-    B -- Trapper --> D[Đặt bẫy & Chặn đường]
-    
-    C --> E{Di chuyển}
-    E -- Chạy nhanh --> F[Tạo tiếng động lớn]
-    E -- Đi chậm --> G[Ẩn nấp trong bóng tối]
-    
-    F --> H[Lộ vị trí cho Trapper]
-    D --> I[Bẫy kích hoạt]
-    I --> J[Seeker bị khống chế/Lộ diện]
-    
-    J --> K{Kết quả}
-    C -- Thoát thành công --> L((SEEKER THẮNG))
-    K -- Hết giờ/Bị bắt --> M((TRAPPER THẮNG))
+    %% Phase 1: Initialization & Synchronization
+    subgraph Initialization ["1. GIAI ĐOẠN KHỞI TẠO (NET-SYNC)"]
+        A[Bắt đầu Trận đấu] --> B{Photon Fusion Matchmaking}
+        B --> C[Phân vai ngẫu nhiên: Seeker vs Trapper]
+        C --> D[Maze Generator: Chạy đa thuật toán Prims/Wilsons]
+        D --> E[Baking NavMesh & Static Colliders]
+        E --> F[Character Auto-Setup: Sync Physical Bounds]
+        F --> G[Spawn Players tại vị trí đối nghịch]
+    end
+
+    %% Phase 2: Core Loop (The Heart of the Game)
+    subgraph Active_Round ["2. VÒNG LẶP CHIẾN ĐẤU (CORE LOOP)"]
+        G --> Loop((TICK: FixedUpdateNetwork))
+        
+        %% Seeker Branch
+        subgraph Seeker_Logic ["SEEKER (POV 1st)"]
+            S1[Input: WASD / Space / Shift] --> S2[State Machine: Move/Run/Jump/Dash]
+            S2 --> S3{Hành động?}
+            S3 -- "Sprinting" --> S4[Phát ra tiếng động lớn - Noise Meter Up]
+            S3 -- "Sneaking" --> S5[Ẩn nấp - Noise Meter Down]
+            S3 -- "Flashlight" --> S6[Nhìn rõ đường - Tốn Pin - Lộ vị trí]
+            
+            S4 & S5 & S6 --> S_Check{Check Environment}
+            S_Check -- "Dẫm bẫy" --> S_Trap[Khống chế/Lộ diện]
+            S_Check -- "Gặp cửa/đèn" --> S_Interact[Interact Logic]
+        end
+
+        %% Trapper Branch
+        subgraph Trapper_Logic ["TRAPPER (STRATEGY VIEW)"]
+            T1[Input: Mouse / Hotkeys] --> T2[View: Map Sơ đồ nhiệt / Camera]
+            T2 --> T3{Hành động?}
+            T3 -- "Đặt bẫy" --> T4[Trừ tài nguyên Bẫy - Sync mạng]
+            T3 -- "Pulse Scan" --> T5[Ping vị trí Seeker tạm thời]
+            T3 -- "Lock Door" --> T6[Khóa đường đi Seeker]
+            
+            T4 & T5 & T6 --> T_Check{Theo dõi Seeker}
+        end
+
+        %% Networking Layer
+        subgraph Network_Sync ["NETWORK SYNC (PHOTON FUSION)"]
+            Loop --> NS1[Client-Side Prediction]
+            NS1 --> NS2[Server Reconciliation]
+            NS2 --> NS3[State Sync: Networked Properties]
+        end
+    end
+
+    %% Phase 3: Condition & Results
+    subgraph Result_Logic ["3. ĐIỀU KIỆN THẮNG & COMEBACK"]
+        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[Cập nhật Rank / Thống kê]
+        Post_Match --> Buff{Check Chuỗi Thắng/Thua}
+        Buff -- "Người thua" --> Buff_Apply[Kích hoạt Comeback Buffs cho Round sau]
+        Buff_Apply --> A
+    end
+
+    %% Connections
+    S_Trap -.-> T_Check : "Phát tín hiệu cảnh báo"
+    S4 -.-> T2 : "Hiển thị sóng âm trên Map"
+    T4 -.-> S_Check : "Tạo Collision ẩn"
+    NS3 --> Loop
 ```
 
 ---