Files

scove bd40c0733b Testing

2026-04-08 11:50:13 +07:00

9.8 KiB

Raw Blame History

🌑 HALLUCINATE: The Asymmetric Mind-Game

"Trong bóng tối của sự ảo giác, thị giác là công cụ mạnh mẽ nhất, nhưng sự tin tưởng lại là sai lầm chết người."

HALLUCINATE là một dự án game PvP không đối xứng (Asymmetric PvP) đỉnh cao, nơi người chơi bước vào một cuộc đấu trí căng thẳng trong mê cung bóng tối. Một người nắm giữ Ánh sáng (Seeker), người kia điều khiển Cạm bẫy (Trapper). Đây không chỉ là trò chơi trốn tìm, đây là cuộc chiến về tâm lý và khả năng đọc tình huống.

📑 Mục lục (Table of Contents)

Tầm nhìn Dự án (Project Vision)
Cơ chế Trò chơi (Core Mechanics)
Kiến trúc Kỹ thuật (Technical Architecture)
Hệ thống Mê cung (Maze Generation)
Đồng bộ Mạng (Networking)
Công cụ Phát triển (Developer Tools)
Lộ trình Phát triển (Roadmap)
Cấu trúc Thư mục (Folder Structure)
Hướng dẫn Cài đặt (Installation)

👁️ Tầm nhìn Dự án (Project Vision)

(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.
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)

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.

🔄 Vòng lặp Gameplay (Game Loop)

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))

🏗️ Kiến trúc Kỹ thuật (Technical Architecture)

1. Advanced Player State Machine

Hệ thống điều khiển nhân vật sử dụng mô hình Hierarchical State Machine kết hợp với Photon Fusion, cho phép xử lý các trạng thái phức tạp một cách mượt mà.

stateDiagram-v2
    [*] --> Idle
    Idle --> Moving: Movement Input
    Moving --> Running: Sprint Input
    Running --> Idle: Stop
    Moving --> Sneaking: Sneak Input
    
    state "Airborne Logic" as Airborne {
        Jump --> Falling
        Falling --> Grounded
    }
    
    Moving --> Jump: Jump Input
    Airborne --> Idle: Land
    
    Moving --> Dashing: Dash Input
    Dashing --> Moving: Complete
    
    Interact --> Idle: Action Key

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 HALLUCINATE 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)

graph LR
    A[Initialise Map] --> B{Algorithm Selector}
    B -- Prims --> C[Compute Spanning Tree]
    B -- Wilsons --> C
    B -- Crawler --> C
    C --> D[Environment Masking]
    D --> E[Spawn Objects: Doors/Lamps]
    E --> F[Inject Traps & Exit Strategy]

🌐 Đồng bộ Mạng (Networking)

Sử dụng Photon Fusion (State Sync) với cơ chế Client-Side Prediction để đảm bảo trải nghiệm không độ trễ cho Player di chuyển.

Network Flow Diagram

sequenceDiagram
    participant CP as Local Player (Input Authority)
    participant S as Server (State Authority)
    participant RP as Remote Proxy
    
    CP->>CP: Predict Movement (DeltaTime)
    CP->>S: Send NetworkInputData (Move, Rot, Sprint)
    S->>S: Validate & Execute FixedUpdateNetwork
    S-->>CP: Reconcile State (If Mispredicted)
    S-->>RP: Sync Networked Properties (Rot, State)

⚖️ Hệ thống Comeback (Comeback System)

Để đảm bảo tính cân bằng, người thua vòng trước sẽ nhận được các Adaptive Buffs:

Seeker Buffs:
- Flash Vision: Mở rộng 50% tầm nhìn đèn pin.
- Trap Sense: Hiển thị outline của bẫy trong bán kính 5m.
Trapper Buffs:
- Pulse Scan: Quét vị trí Seeker mỗi 15 giây.
- Ghost Trap: Bẫy không thể bị phát hiện bởi Trap Sense.

🛠️ Công cụ Phát triển (Developer Tools)

1. Character Auto-Setup

Công cụ CharacterAutoSetup.cs tự động cấu hình CharacterController dựa trên các chỉ số sinh học của Model (Bones):

Height: Đo từ chân đến đỉnh đầu + 12% bù trừ.
Radius: Tính dựa trên khoảng cách giữa hai xương vai (Shoulders).
Step Offset: Tự động set bằng 15% chiều cao nhân vật.

2. Smart Bootstrapper

Tự động chuyển scene và khởi tạo Network Runner khi nhấn Play trong Editor, giúp giảm thiểu thời gian setup khi test.

📂 Cấu trúc Thư mục (Folder Structure)

E:/Learning_Progress/Projects/HALLUCINATE/
├── Assets/
│   ├── Scripts/            # Toàn bộ logic game (C#)
│   │   ├── Player Controller/ # State Machine, Movement
│   │   ├── Fusion/         # Network Spawner, Data
│   │   ├── GameSetup/      # Maze, Character AutoSetup
│   │   └── Interactables/  # Bẫy, Cửa, Đèn
│   ├── Prefabs/            # Các đối tượng được dựng sẵn
│   ├── document/           # Tài liệu thiết kế & Ảnh (MỚI)
│   └── Scenes/             # Các màn chơi và Scene Main
├── ProjectSettings/        # Cấu hình dự án (Unity)
└── README.md               # Tài liệu này

🚀 Lộ trình Phát triển (Roadmap)

Phase 1: Foundation
- Player State Machine (Idle, Move, Run, Jump).
- Maze Generation (Multi-algorithm).
- Photon Fusion Integration.
Phase 2: Gameplay Core
- Role Selection (Seeker vs Trapper).
- Trap Placement System.
- Sound & Visual Detection (Noise Meter).
Phase 3: Polishing
- Lobby System & Matchmaking.
- Adaptive Buffs System.
- UI/UX Design (Minimalist Dashboard).

🤝 Hướng dẫn Cài đặt (Installation)

Clone Repository:

git clone https://github.com/OnlyScove/HALLUCINATE.git

Unity Version: Đảm bảo bạn sử dụng Unity 2022.3.x trở lên.
Photon Fusion:
- Truy cập Photon Dashboard.
- Tạo một AppID (Fusion).
- Paste AppID vào Photon/Fusion/Resources/PhotonAppSettings.
Run: Mở scene Main Scene và nhấn Play.

(Ghi chú: Các hình ảnh trong README này là placeholder. Tài liệu chi tiết hơn có thể xem tại thư mục /document)

9.8 KiB Raw Blame History