# 九霄渡劫 · 孤峰问道

一个纯前端、无构建步骤的 three.js 3D 动作小游戏：在无涯峰的孤巅撑起护体法罩，捱过九道形态各异的天雷，羽化飞升。

## 运行方式

- 用浏览器打开本目录的 `index.html` 即可。
- 若浏览器因跨域策略拦截 `file://` 下的 ES Module（Chrome / Edge 常见），请在当前目录起一个静态服务器再访问：

  ```bash
  python3 -m http.server 8000
  # 浏览器打开 http://localhost:8000/
  ```

- 依赖仅通过 importmap 从 `https://unpkg.com/three@0.170.0/` 加载 three.js 及其附加模块，无 npm、无构建、无外部图片/模型/音频。

## 玩法

- 你扮演散修「玄衡」，盘坐于无涯峰顶。九道天雷依次落下，撑过全部九道即可飞升。
- **肉身**血条归零即「身死道消」；**真元**用于运功与闪避，拾取天地间飘落的灵气可补充。
- 地面出现**预警圈**时，圈内即雷击范围。预警圈会收缩/脉动，顶部进度条也会显示劫云凝聚进度。
- 九道雷的形态：直劈、双雷、分叉、连环、追踪、雷网、雷蛟、雷雨、九霄合击，越往后伤害越高、节奏越快。

## 操作

| 按键 | 作用 |
| --- | --- |
| `W A S D` / 方向键 | 移动护体法罩 |
| `空格` | 踏罡闪避（短暂无敌，消耗少量真元） |
| `按住 Shift` | 抱元守一：运功抵挡，雷伤大幅降低，但持续消耗真元 |
| `M` | 静音 / 开声 |
| `R` | 结算后重来 |

结算界面会给出用时、承受雷伤、命中次数与评级；评级由剩余肉身、用时与受击次数综合得出。

## 九个雷劫

1. **落星** —— 一道直劈雷，熟悉走位与预警圈。
2. **照影** —— 连续两道错位落雷。
3. **裂枝** —— 主雷分叉，碎裂出三处附带落点。
4. **三叠** —— 四连追踪落点，逼迫持续移动。
5. **附骨** —— 预警圈会缓慢追着你走，最后锁定。
6. **天罗** —— 以你为圆心布下环形雷网，只留两处生门。
7. **雷蛟** —— 云中雷蛟盘空而下，范围极大，落地后还有余雷。
8. **千锋** —— 十二道雷雨连绵，空地随机落雷，灵气也会增多。
9. **九霄** —— 雷蛟、追踪、分叉、雷网同时压上，九霄神雷天倾。

## 视觉与特效亮点

- **程序化雷暴天空**：天穹着色器用多层 value noise + FBM 做翻滚乌云、电离纹理与雷光闪烁；飞升时着色器中的云层真正「破开」，露出金色天门。
- **程序化闪电**：中点位移生成分叉雷，`Line2` 多层叠加（核心 / 辉光 / 电离外层）配合 bloom；雷蛟拥有独立的龙首、角、须、眼与盘旋下扑动画。
- **纯代码造型**：孤峰、断柱、浮石、莲台、盘坐修士、护体法罩、符文法阵全部由几何体、Lathe/Shape、Canvas 程序化贴图拼成。
- **罩体着色器**：菲涅耳边缘光、六芒/环带纹理与运功时的蓄能变化。
- **粒子系统**：固定容量对象池，用于雷击火花、灵气拖尾、飞升金屑与撞击闪光；另有扩散雷环、光柱、焦痕。
- **飞升演出**：天门破云、金色光柱、升华光环、原创祥瑞「晖羽灵雀」群飞、镜头拉升、白闪与结算。
- **WebAudio 合成音效**：低频风啸与长音铺底、雷声（噪声 + 低通扫频 + 次声）、闪避风声、灵气清音、运功抵挡、飞升琶音；无任何音频文件。
- **性能与自适应**：粒子池复用、Canvas 贴图、限制 DPR；帧率过低时自动降低渲染分辨率；窗口缩放自适应。

## 文件结构

```
index.html      入口、importmap、HUD 与结算界面
style.css       国风界面样式
js/main.js      渲染器、bloom 合成、灯光、输入与主循环
js/game.js      状态机、伤害/真元、飞升与评级
js/waves.js     九道雷劫的节奏与落点编排
js/player.js    修士、莲台、护体法罩着色器、移动与闪避
js/sky.js       雷暴天空着色器、云海、云团、闪电照明
js/terrain.js   孤峰、石柱、符文法阵、浮石、尘埃
js/lightning.js 预警圈着色器、分叉雷生成、雷蛟
js/fx.js        粒子池、灵气、冲击波、焦痕、飞升与灵雀
js/audio.js     WebAudio 程序化音效
js/ui.js        HUD、横幅、结算与提示
js/utils.js     随机、缓动、程序化贴图与工具函数
```

## 已知不足

- 未做移动端触控控件，键盘体验为主（窄屏 HUD 已适配）。
- 浏览器通常不允许 `file://` 下加载本地 ES Module；直接双击 `index.html` 时页面会给出提示并禁用开始按钮，需要按上文起一个静态服务器。
- 闪电与雷蛟是「程序化近似」，不是基于物理的电流模拟；远景云层用 billboard 云团拼合，贴近细看会看出分层。
- 音效为实时合成，音色偏简单；不同声卡/浏览器的听感会有些差异。
- 极低端 GPU 上 bloom + 天穹 FBM 可能掉帧，会自动降一档分辨率，但仍不保证 60 帧。
- 评级阈值按当前数值手调，未经过大规模玩家平衡测试。

## 原创说明

角色「玄衡」、地名「无涯峰」、招式与雷劫名（落星、照影、裂枝、三叠、附骨、天罗、雷蛟、千锋、九霄）、祥瑞「晖羽灵雀」均为本作原创命名与原创外形；未使用任何现有游戏、动漫、影视的角色名、形象或商标。
