# CẨM NANG: HỆ THỐNG ĐỊA HÌNH, SƯƠNG MÙ CHIẾN TRANH & MÊ CUNG CHỐNG BOT

Hệ thống bản đồ trong **FreeExile** được thiết kế theo phong cách **Cổ Võ Hoang Dã & Hắc Ám Lưu Đày (Grimdark Savage Primal Exile ARPG)**, kế thừa tinh thần tự do khám phá và sự tàn khốc của Path of Exile 2.

---

## 1. NGUYÊN TẮC THIẾT KẾ ĐỊA HÌNH
- **Không Rập Khuôn, Không Tiên Hiệp**: Tuyệt đối không có các cảnh quan tiên cảnh lộng lẫy, cung đình bồng lai hay linh tuyền tu tiên. Toàn bộ là bùn lầy tanh tưởi, rễ cây độc, xác tàu đắm, vách đá dựng đứng chất đống di cốt của những kẻ lưu đày.
- **5 Biome Hoang Dã Nguyên Bản**:
  1. **Bãi Tha Ma Ngập Mặn (`SAVAGE_MANGROVE_SWAMP`)**: Nước bùn lầy lội, rễ cây đước giăng bẫy gai xé thịt, làm chậm $60\%$ tốc độ chạy.
  2. **Rừng Gai Huyết Tộc (`CRIMSON_BLOOD_FOREST`)**: Rừng gai đỏ thẫm mọc trên xác thú hiến tế, cọc xương và cạm bẫy chông gai ngầm.
  3. **Hẻm Núi Xương Trắng (`BLEACHED_BONE_CANYON`)**: Hẻm đá cheo leo, gió rít buốt tủy, đá vụn lở bất thình lình.
  4. **Mỏ Quặng Lưu Đày (`OUTCAST_MINE_SHAFTS`)**: Hầm mỏ tối tăm với các rào chắn gỗ sập, xe goòng rỉ sét và bẫy nổ khí metan.
  5. **Phế Tích Ma Thần (`CORRUPTED_FIEND_RUINS`)**: Tàn tích đền thờ man tộc tà ác ngập tràn cột đá vỡ vụn và ngõ cụt phục kích.

---

## 2. CƠ CHẾ SƯƠNG MÙ CHIẾN TRANH (WAR-FOG) & CHỐNG HACK
- **Ba Trạng Thái Tầm Nhìn**:
  - **Chưa Khám Phá (`UNEXPLORED` - 0)**: Màn đêm đen kịt. Server **KHÔNG BAO GIỜ** gửi vị trí quái vật, rương báu hay boss nằm trong vùng này. Mọi phần mềm hack đọc bộ nhớ máy (Memory Reading / Maphack) đều hoàn toàn vô dụng.
  - **Đã Đi Qua Nhưng Mất Tầm Nhìn (`EXPLORED_FOGGED` - 1)**: Người chơi chỉ nhìn thấy địa hình tĩnh (vách đá, tường rào, vũng nước) ở trạng thái mờ xám. Mọi quái vật di động, đòn đánh và người chơi khác trong vùng này đều bị ẩn đi.
  - **Đang Nhìn Thấy Trực Tiếp (`VISIBLE` - 2)**: Nằm trong tầm mắt Line-of-Sight ($7 - 12\text{ ô}$). Hiển thị đầy đủ hoạt ảnh quái vật, cạm bẫy và hiệu ứng chiêu thức thời gian thực.
- **Tầm Nhìn Bị Chặn Bởi Địa Hình**: Vách đá, tường đá và rào chắn gỗ bện xương sẽ chặn đứng tia nhìn (Line-of-Sight), người chơi không thể nhìn xuyên tường.

---

## 3. CƠ CHẾ VẬT CẢN BIẾN ĐỘNG CHỐNG BOT / SCRIPT
- **Triệt Tiêu Đường Đi Thẳng Tắp (Anti-Linear Sinuosity $\ge 1.25$)**:
  - Hành lang không bao giờ thẳng một mạch. Các đống sỏi vụn (`CRUMBLED_DEBRIS`) và cọc xương (`BONE_CLUSTER`) được xếp so le hai bên tường, ép người chơi và quái vật phải di chuyển theo đường cong chữ S hoặc ziczac.
  - Bot script sử dụng công thức chạy thẳng vector $(\Delta x, \Delta y)$ sẽ ngay lập tức bị kẹt vào chướng ngại vật.
- **Rào Cản Phá Hủy Được (Destructible Barricades)**:
  - Bố trí tại các cửa phòng và nút thắt giao lộ hiểm trở.
  - Rào chắn sở hữu $80 - 150\text{ Máu (HP)}$. Người chơi cần tung chiêu chém vỡ rào chắn thì lối đi mới mở ra. Bot auto-click-to-move sẽ bị chặn đứng tại nút thắt này.
- **Vũng Bùn Lầy Làm Chậm (Mud Quagmires)**:
  - Tăng gấp đôi chi phí di chuyển (tốc độ giảm $50 - 60\%$). Người chơi linh hoạt sử dụng thân pháp **Huyễn Ảnh Bộ (i-frame)** để lướt qua, trong khi bot chạy bộ thẳng sẽ mất nhịp tick và bị hệ thống Server Authoritative Movement phát hiện.
- **Nhánh Rẽ Ngõ Cụt Giả (Deceptive Dead-Ends)**:
  - Sinh ngẫu nhiên từ 3 đến 6 nhánh ngõ cụt dẫn vào bẫy phục kích quái vật. Bot không có dữ liệu bản đồ trước sẽ bị lạc đường và bị quái vật bao vây hạ gục.

---

## 4. HƯỚNG DẪN TRẢI NGHIỆM TRÊN WEBAPP SIMULATOR
1. Mở giao diện WebApp [`client/webapp/index.html`](file:///c:/Projects/FreeExile/client/webapp/index.html).
2. Nhấn phím nóng **`W`** trên bàn phím hoặc chạm vào nút **`👁️ Sương Mù & Mê Cung Chống Bot`** trên thanh HUD.
3. Trong bảng điều khiển:
   - **Canvas Map**: Quan sát người chơi (chấm xanh lục), Boss (chấm tím), vùng sương mù sáng xung quanh người chơi và vùng tối mờ xám đã đi qua.
   - **Bấm "Di Chuyển Người Chơi"**: Mô phỏng từng bước chạy của người chơi dọc theo đường ziczac, sương mù mở rộng thời gian thực.
   - **Bấm "Tấn Công Phá Hủy Rào Cản"**: Tung chưởng chém vỡ rào chắn gỗ xương chặn đường.
   - **Bấm "Sinh Map Mới (New Seed)"**: Tự động sinh ra một mê cung hoàn toàn mới với Biome và cạm bẫy ngẫu nhiên.