98 lines
5.1 KiB
Markdown
98 lines
5.1 KiB
Markdown
# 剑与声（RPG · Sword & Sound）
|
||
|
||
纯音频回合制武侠 RPG。你是盲剑客沈听澜——眼盲，耳即眼。
|
||
黑风寨掳走了你唯一的徒弟，追进迷雾林，把他们连根拔起。
|
||
|
||
## 玩法
|
||
|
||
- **探索**：节点式场景图（雾口村 → 林间小路 → 岔路口 → 溪流 → 猎人小屋 →
|
||
密林深处 → 黑风寨 → 聚义厅）。每个场景有环境音循环与语音描述，
|
||
在选项间切换、确认行动：前进 / 调查 / 商店 / 休息 / 对话 / 强攻或绕行。
|
||
- **战斗**：明雷回合制。选指令出手；敌方攻击前会响起**前摇音**
|
||
（野狼低吼、山贼拔刀、寨主双刀互击……）——在前摇内**双击格挡**，
|
||
减伤 70%。这是唯一的即时操作，绑双击规避单击延迟。
|
||
前摇时长按新手保护分档（见下"难度曲线"），标准档 1.0s。
|
||
- **首战教学**：第一场战斗（溪流教学狼）是四步强制教学——
|
||
认识指令（左右滑 2 次）→ 攻击命中 → 听前摇格挡（受击也算过）→ 防御演示，
|
||
每步 8s 无操作重复提示、16s 看门狗兜底推进；教学狼 ATK 2、前摇 1.8s、
|
||
玩家 HP 锁底 1 必不死。每场战斗开始还有回合提示音 `turn_player`，
|
||
胜利有号角 `victory`。
|
||
- **难度曲线**（按已完成战斗场数 `battlesWon`）：第 1-3 场敌方前摇 1.5s、
|
||
伤害 ×0.6；第 4-5 场 1.25s、×0.8；第 6 场起标准；Boss 恒标准。
|
||
- **逃跑**：Lv<3 普通战必成；Lv≥3 70% 成功，失败则敌方追加一个正常前摇回合
|
||
（可格挡）；Boss/剧情战"避无可避"。Lv<3 首次到寨门会听到 boss1_warn 劝退提示。
|
||
- **旁白跳过**：探索/剧情/状态语音播放中单击=跳过本句（链继续）；
|
||
战斗指令名与教学句不可跳。开局插播一次"单击可跳过旁白"。
|
||
- **成长**：战斗得经验金币 → 升级（maxHp/atk 提升）→ 商店换铁剑/皮甲 →
|
||
金疮药回血。战败从章首重生，等级金币装备保留。
|
||
- **Boss**：黑风寨主半血进二阶段（攻击提升、前摇变急促）。讨伐后章结算。
|
||
|
||
## 手势
|
||
|
||
### 探索态
|
||
|
||
| 手势 | 作用 |
|
||
|---|---|
|
||
| 左 / 右滑 | 切换选项（播选项名，循环） |
|
||
| 单击 | 确认执行当前选项（语音播放中单击=跳过本句） |
|
||
| 双击 | 重听当前场景描述 + 当前选项 |
|
||
| 上滑 | 角色状态（等级/血量/金币/装备，分档整句） |
|
||
| 下滑 | 菜单：继续旅程 / 保存并回大厅 / 重新听帮助 |
|
||
|
||
### 战斗态
|
||
|
||
| 手势 | 作用 |
|
||
|---|---|
|
||
| 左 / 右滑 | 切换指令：攻击 → 破空斩（耗内劲 3，双倍伤害）→ 防御（本回合受伤减半）→ 金疮药（回 40% HP） |
|
||
| 单击 | 执行当前指令 |
|
||
| **双击** | **格挡**：仅敌方前摇窗口（教学 1.8s / 保护 1.5s / 过渡 1.25s / 标准 1.0s，听风剑再 +0.3s）内有效，减伤 70%；窗口内其他手势震动报错 |
|
||
| 上滑 | 敌我血量档位 |
|
||
| 下滑 | 逃跑（Lv<3 必成；Lv≥3 70%，失败吃一个可格挡的前摇回合；Boss/剧情战"避无可避"） |
|
||
|
||
菜单操作（RPG 豁免，与探索同构）：左右滑切换 + 单击确认；上滑=帮助；下滑=关闭。
|
||
|
||
## 战斗数值
|
||
|
||
```
|
||
maxHp = 20 + 8×(lv-1) atk = 5 + 2×(lv-1) + 武器 def = 护甲
|
||
内劲 mp = 3 + lv（破空斩耗 3） 升级所需 exp = lv × 20
|
||
伤害 = max(1, round((攻-防) × 0.85~1.15)) × 难度系数（保护 0.6 / 过渡 0.8 / 标准 1.0，向下取整 min 1）
|
||
格挡 ×0.3 / 防御 ×0.5（不叠加）
|
||
难度档位按 stats.battlesWon 在每场战斗开始时取档：0-2 场保护 / 3-4 场过渡 / ≥5 标准 / Boss 恒标准
|
||
```
|
||
|
||
## 状态音乐（docs/design/10-feedback2-state-bgm.md §7）
|
||
|
||
BGM 层报状态 + sfx 层 amb 报场景：菜单 `bgm/menu` / 村庄 `bgm/village` /
|
||
探索 `bgm/explore`（volume 0.35 轻垫 + amb 环境音）/ 战斗 `bgm/battle`、
|
||
Boss `bgm/boss`（400ms 快切，amb 停）/ 胜利 → 战斗 BGM 淡出 1.5s →
|
||
explore 淡入 2s / 章结算 `bgm/ending`。
|
||
|
||
## 无头试玩测试
|
||
|
||
```bash
|
||
tools/node/bin/node web/rpg/test/playtest.mjs # 139 条断言，退出码 0=全过
|
||
```
|
||
|
||
mock 浏览器环境 + 虚拟时钟，覆盖 13 号文档 §6 全部关键路径与边界断言
|
||
（四步教学/看门狗/锁血/逃跑分档/格挡防御减伤/战败重生/跳过旁白/存档续玩）
|
||
+ 资产引用校验（game.js 引用的全部 id 双性别/双格式零缺失）。
|
||
|
||
## 存档
|
||
|
||
- 结构：`{schema, updatedAt, summary, chapter, scene, player, flags, chapters, stats}`
|
||
（见 docs/design/05-rpg-chapter1.md §6 精确定义）。
|
||
- 保存时机：场景切换、战斗结算、商店交易、菜单"保存并回大厅"。
|
||
- 本地 localStorage（`soundgame.progress.rpg`）+ 已登录时同步服务器
|
||
（`PUT /api/progress {game:'rpg'}`），大厅卡片显示 `summary`。
|
||
- 有存档进游戏时：单击=继续旅程，右滑=开始新旅程（保留 stats 累计）。
|
||
- 战败：章首（雾口村）重生，HP/MP 回满，等级/金币/装备/flags 保留，
|
||
本章非 Boss 遭遇重置。
|
||
|
||
## 运行
|
||
|
||
```bash
|
||
python3 -m http.server 8117 --directory /home/ubuntu/SoundGame/web
|
||
# 浏览器打开 http://localhost:8117/rpg/ ，务必戴耳机
|
||
```
|