# 技术指南：地形生成、战争迷雾与防脚本迷宫
# FREEEXILE 项目：2.5D 硬核蛮荒流放 ARPG

**FreeExile** 的地图生成机制继承 Path of Exile 2 的残酷写实探索精髓：以腐朽泥沼、剧毒根系与白骨荒原为基调，严格实施服务端权威探索管线。

---

## 1. 地形设计原则

- **摒弃修仙虚浮，回归蛮荒血性**：无任何悬空仙宫与琉璃琼楼，全图由恶臭淤泥、毒根、海难残骸与堆积如山的流放者骸骨构成。
- **五大原始蛮荒生态 (5 Savage Biomes)**：
  1. **残骨红树沼泽 (`SAVAGE_MANGROVE_SWAMP`)**：恶臭泥泞，盘根错节的倒刺根系阻滞移动，移动速度惩罚 $60\%$。
  2. **赤血棘林 (`CRIMSON_BLOOD_FOREST`)**：在兽骨与血祭残骸上滋生的血色荆棘林，潜藏刺骨陷阱。
  3. **白骨大峡谷 (`BLEACHED_BONE_CANYON`)**：绝壁深谷，刺骨寒风呼啸，落石险象环生。
  4. **流放矿道 (`OUTCAST_MINE_SHAFTS`)**：阴暗木桩巷道、废弃锈铁矿车与沼气爆燃暗坑。
  5. **魔神祭祀遗迹 (`CORRUPTED_FIEND_RUINS`)**：残破蛮荒巨石柱群与充满伏击伪装的死胡同。

---

## 2. 战争迷雾机制 (WAR-FOG) 与反全图透视 (ANTI-MAPHACK)

- **三大视野状态**：
  - **未探索 (`UNEXPLORED` - 0)**：纯黑深渊。服务端**绝不向客户端下发**该区域内的怪物坐标、宝箱状态或首领元数据，内存读取外挂彻底失效。
  - **已探索但脱离视野 (`EXPLORED_FOGGED` - 1)**：仅渲染静态地形轮廓（石壁、死角、干燥地面）。所有移动怪物、技能弹道与 peer 玩家实体一律剔除隐藏。
  - **直视视野内 (`VISIBLE` - 2)**：处于动态视线射线 Line-of-Sight ($7 - 12\text{ 格}$) 范围内，完整渲染动态实体、陷阱与粒子特效。
- **地形射线遮挡**：悬崖、石墙与骨栅栏投射视线遮挡射线，杜绝穿墙透视。

---

## 3. 防脚本与防挂机程序化阻断机制

- **反线性曲折度算法 (Anti-Linear Sinuosity $\ge 1.25$)**：
  - 走廊绝不呈现直达通道，两侧交错堆叠碎石堆 (`CRUMBLED_DEBRIS`) 与骨刺堆 (`BONE_CLUSTER`)，强迫呈 S 型曲折走位。
  - 简单直线插值脚本 $(\Delta x, \Delta y)$ 会立即卡死在几何障碍边缘。
- **可破坏骨栅栏阻断 (Destructible Barricades)**：
  - 狭窄要道设立 $80 - 150\text{ HP}$ 骨质路障。
  - 玩家必须主动释放普通攻击或战技击碎栅栏方可通过，挂机点击移动脚本在此被直接阻断。
- **泥泞阻滞深坑 (Mud Quagmires)**：
  - 移速减半。玩家可施展**蛇影步 / 幻影步 (i-frame)** 瞬穿，纯直线奔跑机器人将丢失同步 tick 并被服务端移速审计捕获。
  - **欺骗性死胡同 (Deceptive Dead-Ends)**：随机生成 3 至 6 处陷阱死胡同，诱捕缺乏真实感知能力的寻路脚本。

---

## 4. WEBAPP 模拟器体验指南

1. 打开 WebApp 客户端 [`client/webapp/index.html`](file:///c:/Projects/FreeExile/client/webapp/index.html)。
2. 按下快捷键 **`W`** 或点击 HUD 栏上的 **`👁️ 迷雾与迷宫`** 按钮。
3. 在诊断面板中：
   - **Canvas 视口**：观察角色（绿点）、Boss（紫点）、周身实时照亮区域与外围迷雾。
   - **单步移动**：模拟角色在曲折路径中的行进，观察迷雾动态实时解算。
   - **破除路障**：释放技能攻击击碎挡路骨栅栏。
   - **生成新种 (New Seed)**：一键重新演算生成全新的生态群落与障碍迷宫。