309 lines
15 KiB
Markdown
309 lines
15 KiB
Markdown
# 05a · 《剑与声》第一章施工稿（26 号对齐）
|
||
|
||
> **给开发者的实现要点摘要**
|
||
> 1. 场景图 JSON、遭遇战表、数值、存档字段、BGM/sfx 清单 **以本文为准**（与 05 号总设计冲突时，数据以本文、交互以 26 号+05 号 §0）。
|
||
> 2. 战斗仍是定时器驱动的 10 状态机。**格挡 = 前摇窗口内再单击**（或朝来招方向滑）。禁止要求新手双击。
|
||
> 3. 探索：左右滑切选项、单击确认、上滑状态。`doubleTapWindow: 0`。
|
||
> 4. 第一章 8 场景、5 场明雷、商店/宝箱/支线获取不变。
|
||
> 5. 语音仍只引用 [05-rpg-ch1-voice-ids.md](05-rpg-ch1-voice-ids.md) 表内 id；须停用「双击格挡」教学句或改录为「点一下挡住」（改词在实现时登记，本文不改 voice-ids 文件）。
|
||
|
||
---
|
||
|
||
## 0. 设计单（第一章范围）
|
||
|
||
一句话、三状态、手势、矩阵、失败表、首 3 分钟、台词类别、断点复述：**见 [05-rpg.md](05-rpg.md) §0**。本章等待点补：
|
||
|
||
| id | 场景 | 期待 | `_short` |
|
||
|---|---|---|---|
|
||
| `village_opt` | village | 左右/单击 | 「滑一下。」 |
|
||
| `path_go` | path | 前进 | 「单击。」 |
|
||
| `fork_pick` | fork | 左右选路 | 「左右滑。」 |
|
||
| `stream_teach` | stream | 教学战四步 | 见 11 号 |
|
||
| `gate_pick` | gate | 强攻/绕行 | 「左右滑。」 |
|
||
|
||
Floor：探索 `YOUR_TURN`（amb 常驻可作床）；战斗选指令 `YOUR_TURN`（`turn_player`）；前摇 `ACTION`；演出 `BUSY`/`SPEAKING`。
|
||
|
||
---
|
||
|
||
## 1. 第一章场景图（数据表，直接转 JSON）
|
||
|
||
```js
|
||
const CH1 = {
|
||
start: 'village',
|
||
scenes: {
|
||
village: { name: '雾口村', amb: 'amb_village', options: ['go_path', 'shop', 'rest', 'status'] },
|
||
path: { name: '林间小路', amb: 'amb_path', options: ['go_fork', 'investigate', 'back'] },
|
||
fork: { name: '岔路口', amb: 'amb_fork', options: ['go_chest', 'go_stream', 'back'] },
|
||
chest: { name: '枯树洞', amb: 'amb_chest', options: ['open_chest', 'back'] },
|
||
stream: { name: '溪流', amb: 'amb_stream', options: ['drink', 'go_hunter', 'back'],
|
||
encounter: 'enc_teach_wolf' },
|
||
hunter: { name: '猎人小屋', amb: 'amb_hunter', options: ['talk_hunter', 'go_deepwood', 'back'] },
|
||
deepwood: { name: '密林深处', amb: 'amb_deepwood', options: ['go_gate', 'back'],
|
||
encounter: 'enc_bandits' },
|
||
gate: { name: '黑风寨门前', amb: 'amb_gate', options: ['assault', 'sneak', 'back'] },
|
||
boss1: { name: '聚义厅', amb: 'amb_hall', options: [],
|
||
encounter: 'enc_boss1' },
|
||
},
|
||
};
|
||
```
|
||
|
||
选项语义（不变）：
|
||
|
||
| 选项 id | 播报语音 | 行为 |
|
||
|---|---|---|
|
||
| `go_*` | `opt_go_<场景>` | 切换场景（脚步 + 新场景 desc） |
|
||
| `back` | `opt_back` | 回上一场景 |
|
||
| `shop` | `opt_shop` | 商店子菜单 |
|
||
| `rest` | `opt_rest` | HP/MP 回满，`sys_rest`；仅 village |
|
||
| `status` | `opt_status` | 与上滑相同 |
|
||
| `investigate` | `opt_investigate` | 一次性 +15 金（`chest_path`） |
|
||
| `go_chest` | `opt_go_chest` | 岔路左 |
|
||
| `open_chest` | `opt_open_chest` | 金疮药×2（`chest_fork`） |
|
||
| `drink` | `opt_drink` | HP 回满 |
|
||
| `talk_hunter` | `opt_talk_hunter` | 药×1 + 九折 `shop_discount` |
|
||
| `assault` | `opt_assault` | `enc_elite` → 胜后 boss1 |
|
||
| `sneak` | `opt_sneak` | `enc_sneak` → 进 boss1 且 HP/MP 回满 |
|
||
|
||
---
|
||
|
||
## 2. 遭遇战表（不变）
|
||
|
||
| 遭遇 id | 敌人 | 触发 | 特殊 |
|
||
|---|---|---|---|
|
||
| `enc_teach_wolf` | 教学野狼 ×1 | stream 首次 | HP 锁底 1；四步教学（格挡=窗口单击） |
|
||
| `enc_wolf` | 野狼 ×1 | 教学后再入 50% | 可逃 |
|
||
| `enc_bandits` | 山贼 ×2 | deepwood 首次 | 不可逃；间不回血 |
|
||
| `enc_elite` | 寨丁头目 ×1 | assault | 不可逃 |
|
||
| `enc_sneak` | 山贼 + 毒蛛 | sneak | 不可逃；胜后回满 |
|
||
| `enc_boss1` | 黑风寨主 | boss1 | 不可逃；半血二阶段 |
|
||
|
||
---
|
||
|
||
## 3. 战斗状态机（格挡输入改写）
|
||
|
||
状态：`B_START → (回合循环) → VICTORY | DEFEAT | FLED`
|
||
|
||
| 状态 | 进入时副作用 | 出口转换 |
|
||
|---|---|---|
|
||
| `B_START` | `btl_start_<enemy>`；回合=1 | 第一章 → `PLAYER_SELECT`（蛊师类先攻除外） |
|
||
| `PLAYER_SELECT` | `sfx/turn_player`；Floor=`YOUR_TURN`；播当前指令名；左右滑循环 攻击→技能→防御→道具；单击执行；上滑战场状态；下滑逃跑 | 单击 → `PLAYER_EXECUTE`；下滑 → `FLEE_CHECK` |
|
||
| `PLAYER_EXECUTE` | 攻击=伤害公式；技能=atk×2 耗 mp3（不足 `btl_nomp` 留在 SELECT）；防御=halfDamage；道具=金疮药 40%maxHp（无药 `btl_noitem`）。内容音 = `silent-ok` | → `CHECK_ENEMY_DEAD` |
|
||
| `CHECK_ENEMY_DEAD` | 敌 HP≤0：`btl_enemy_die`；连战拉下一只回 `B_START`（不重置玩家） | 无下一只 → `VICTORY`；否则 `ENEMY_TELEGRAPH` |
|
||
| `ENEMY_TELEGRAPH` | Floor=`ACTION`。有声：`tel_<enemy>` 1.0s（保护档见 11 号）。无声：`danger` earcon（系统合成，必出声）。窗口内：**单击 = 格挡**；**朝来招方向滑 = 格挡**。成功：`sfx/parry`，标记 true。反向滑 / 上滑 / 下滑：`invalid`，留在窗口。连点 400ms 内第二下 `busy` | 窗口结束或已格挡 → `ENEMY_RESOLVE` |
|
||
| `ENEMY_RESOLVE` | `dmg×0.3` 格挡 / `×0.5` 防御 / 全值。受击 `hurt`+回执；格挡成功不播 hurt。降档才播 `st_hp_*` | HP≤0 → `DEFEAT`；否则 → `PLAYER_SELECT` |
|
||
| `FLEE_CHECK` | 见 11 号成功率 | `FLED` 或回 SELECT；失败则 `ENEMY_TELEGRAPH`（可格挡） |
|
||
| `VICTORY` | `btl_win` + 分档掉落 + 升级 | 探索态，写存档 |
|
||
| `DEFEAT` | `btl_lose` + 归因 → village 重生（等级金币装备 flags 保留，本章非 Boss 遭遇重置） | village，写存档 |
|
||
|
||
半血钩子：HP 首次 ≤50% 于结算前插播 `btl_half_<enemy>`。
|
||
|
||
来招方向约定（滑动格挡，不单独教学）：
|
||
|
||
| 敌人 | 声像 / 约定方向 |
|
||
|---|---|
|
||
| 野狼、教学狼 | 中央；滑动任意左右也认，或只认单击 |
|
||
| 山贼 / 头目 | 前摇脚步声像侧 |
|
||
| 毒蛛 | 高频，中央；认单击 |
|
||
| 无声 | 无方向；**只认单击**（滑=`invalid`+「点一下。」） |
|
||
|
||
---
|
||
|
||
## 4. 数值表（原样保留）
|
||
|
||
### 4.1 玩家
|
||
|
||
```
|
||
maxHp = 20 + 8*(lv-1)
|
||
atk = 5 + 2*(lv-1) + 武器atk
|
||
def = 护甲def
|
||
mp = 3 + lv
|
||
expToNext = lv * 20
|
||
dmg = max(1, round((atk攻 - def守) * (0.85~1.15)))
|
||
```
|
||
|
||
### 4.2 敌人
|
||
|
||
| 敌人 | 章 | HP | ATK | DEF | EXP | 金币 | 前摇 sfx | 前摇特征 | 半血句 |
|
||
|---|---|---|---|---|---|---|---|---|---|
|
||
| 教学野狼 | 1 | 6 | 3 | 0 | 5 | 0 | `tel_wolf` | 扑击低吼 | 无 |
|
||
| 野狼 | 1 | 10 | 4 | 0 | 8 | 5 | `tel_wolf` | 低吼 | 无 |
|
||
| 山贼 | 1 | 16 | 6 | 1 | 12 | 12 | `tel_bandit` | 脚步+拔刀 | `btl_half_bandit` |
|
||
| 毒蛛 | 1 | 12 | 7 | 0 | 12 | 8 | `tel_spider` | 高频肢节 | 无 |
|
||
| 寨丁头目 | 1 | 24 | 8 | 2 | 20 | 25 | `tel_elite` | 重甲 | `btl_half_elite` |
|
||
| **Boss 黑风寨主** | 1 | 45 | 10 | 2 | 50 | 100 | `tel_boss1` | 双刀两声 | 二阶段 ATK→12 |
|
||
| 沼泽鳄 | 2 | 30 | 11 | 2 | 22 | 18 | `tel_croc` | 水花+低吼 | 无 |
|
||
| 蛊师 | 2 | 22 | 12 | 1 | 26 | 30 | `tel_shaman` | 吟唱（先攻） | 有 |
|
||
| 剑傀 | 3 | 38 | 14 | 3 | 40 | 45 | `tel_puppet` | 机括 | 无 |
|
||
| 影卫 | 3 | 30 | 16 | 2 | 45 | 50 | 无（danger earcon） | 寂静 | 有 |
|
||
| **Boss 腐沼祭主** | 2 | 70 | 14 | 3 | 90 | 200 | `tel_boss2` | 哼鸣 | 二阶段 2 毒蛛 |
|
||
| **Boss 白无瞳** | 3 | 110 | 18 | 5 | 150 | 500 | 三阶段无声+earcon | 寂静 | 三次转换 |
|
||
|
||
经验校验原文成立：打完第一章约 lv3。
|
||
|
||
### 4.3 装备获取（不变）
|
||
|
||
| 物品 | 效果 | 获取 |
|
||
|---|---|---|
|
||
| 铁剑 | atk+3 | 商店 100（九折 90） |
|
||
| 皮甲 | def+2 | 商店 80（九折 72） |
|
||
| 金疮药 | 40% maxHp | 30 金；宝箱×2；猎人×1；上限 5 |
|
||
| 青钢剑 | atk+6 | 二章 300 |
|
||
| 铁鳞甲 | def+4 | 二章 250 |
|
||
| 听风剑 | atk+9，窗口 1.0→1.3s | 三章 600 |
|
||
|
||
### 4.4 商店
|
||
|
||
`shop_open` → 左右滑：铁剑/皮甲/金疮药/离开 → **单击购买**（不再双击）。钱不够 `shop_poor`；已购 `shop_owned`。成功 `sfx/coin` + 回执。写存档。
|
||
|
||
---
|
||
|
||
## 5. 探索态手势（施工口径）
|
||
|
||
- 左右滑=切选项（报名）=`silent-ok` 或 `ok`
|
||
- 单击=确认
|
||
- 上滑= `st_lv_*` → `st_hp_*` → `st_gold_*` → `st_weapon_*` → `st_armor_*`（可打断）
|
||
- 下滑=菜单（阶段 2）：继续 / 保存回大厅 / 返回；破坏性二次确认
|
||
- 双击新手当单击（不重听整段描述；描述可用单击跳句后的帮助短句）
|
||
|
||
血量档：>70% / 30–70% / <30% 原句 id 保留。
|
||
|
||
教学战逐步旁白（替旧「双击格挡」）：
|
||
|
||
| 步 | 意图 | 玩家 |
|
||
|---|---|---|
|
||
| T0 | 左右滑听指令名 | 滑 ≥2 |
|
||
| T1 | 攻击单击 | 出剑一次 |
|
||
| T2 | 前摇内**单击**格挡 | 成功或受击都通过 |
|
||
| T3 | 选防御单击 | 演示减伤 |
|
||
| T4 | 自由击杀 | 敌亡 |
|
||
|
||
完整参数见 [11-rpg-battle-rebalance.md](11-rpg-battle-rebalance.md)。
|
||
|
||
---
|
||
|
||
## 6. 存档 JSON（精确定义，保留）
|
||
|
||
`PUT /api/progress { game: 'rpg', data: ... }`：
|
||
|
||
```json
|
||
{
|
||
"schema": 1,
|
||
"updatedAt": "2026-08-29T12:00:00Z",
|
||
"summary": "第一章·溪流 · Lv3 · 金币120",
|
||
"chapter": 1,
|
||
"scene": "stream",
|
||
"player": {
|
||
"lv": 3, "exp": 45,
|
||
"hp": 28, "maxHp": 36, "mp": 6,
|
||
"gold": 120,
|
||
"weapon": "iron_sword",
|
||
"armor": "leather",
|
||
"potions": 2
|
||
},
|
||
"flags": {
|
||
"tutorial_battle_done": false,
|
||
"chest_path": false,
|
||
"chest_fork": false,
|
||
"hunter_quest": false,
|
||
"shop_discount": false,
|
||
"enc_bandits_done": false,
|
||
"enc_elite_done": false,
|
||
"enc_sneak_done": false,
|
||
"boss1_done": false
|
||
},
|
||
"chapters": { "1": "open", "2": "locked", "3": "locked" },
|
||
"stats": { "kills": 0, "deaths": 0, "parries": 0, "playSec": 0, "battlesWon": 0 }
|
||
}
|
||
```
|
||
|
||
| 字段 | 默认 | 说明 |
|
||
|---|---|---|
|
||
| `schema` | 1 | 不匹配可重开，stats 保留 |
|
||
| `summary` | `"新的旅程"` | `第X章·场景名 · LvN · 金币M` |
|
||
| `chapter`/`scene` | 1 / `village` | 落点 |
|
||
| `player.*` | lv1 exp0 hp20 maxHp20 mp4 gold50 weapon null armor null potions 1 | 开局 50 金 |
|
||
| `weapon`/`armor` | null | `iron_sword`/`steel_sword`/`wind_sword`；`leather`/`iron_scale` |
|
||
| `flags.*` | false | 一次性 |
|
||
| `chapters` | 见上 | locked/open/cleared |
|
||
| `stats.*` | 0 | 只增不减；`battlesWon` 供保护档 |
|
||
|
||
保存：场景切换、战斗结算、商店、菜单保存。localStorage `soundgame.progress.rpg` 与服务器双写。有档：`sys_continue_ask` 单击继续、右滑新游戏。
|
||
|
||
---
|
||
|
||
## 7. 资产需求清单（保留 prompt）
|
||
|
||
### 7.1 BGM（与 10 号对齐）
|
||
|
||
| id | 用途 | Mureka prompt 草稿 |
|
||
|---|---|---|
|
||
| `bgm/explore` | 探索宏观 | Atmospheric Chinese wuxia ambient, bamboo forest mist, sparse guzheng plucks over low drone, slow tempo 60 bpm, mysterious but calm, no vocals, seamless loop |
|
||
| `bgm/battle` | 普通战斗 | Tense wuxia battle music, driving taiko drums 100 bpm, sharp erhu stabs, urgent but not chaotic, no vocals, seamless loop |
|
||
| `bgm/boss` | Boss | Epic dark wuxia boss theme, heavy taiko 120 bpm, dissonant strings, dramatic tension, no vocals, seamless loop |
|
||
| `bgm/village` | 村庄 | Warm peaceful Chinese village ambiance music, soft dizi flute melody, gentle plucked strings, cozy 70 bpm, no vocals, seamless loop |
|
||
| `bgm/ending` | 章结算 | Melancholic wuxia emotional theme, solo erhu over soft pads, bittersweet, slow, no vocals, seamless loop |
|
||
|
||
amb_* 走 **sfx 层 loop**（addendum），`bgm=0` 时 amb 仍在。village 在 bgm=0 时用 `amb_village`。
|
||
|
||
### 7.2 SFX（35；SA3 = Stable Audio 3，SYN = 程序合成）
|
||
|
||
| 类别 | id | 方式 | prompt / 说明 |
|
||
|---|---|---|---|
|
||
| 敌方前摇 | `tel_wolf` | SA3 | wolf growl then lunge, short, dry, close mic |
|
||
| | `tel_bandit` | SA3 | footsteps on dirt then sword unsheathing shing, 1 second |
|
||
| | `tel_spider` | SA3 | insect legs skittering, high frequency chitin clicks, eerie, 1 second |
|
||
| | `tel_elite` | SA3 | heavy armor plates clanking, menacing, 1 second |
|
||
| | `tel_boss1` | SA3 | two metal blades striking each other twice, dramatic ring |
|
||
| | `tel_croc` | SA3 | water splash with low reptile growl |
|
||
| | `tel_shaman` | SA3 | low guttural chant humming, ritualistic, dark |
|
||
| | `tel_puppet` | SA3 | wooden mechanism clicks and winding gears |
|
||
| 战斗 | `atk_swing` | SA3 | sword whoosh through air, fast, clean |
|
||
| | `atk_hit` | SA3 | sword hitting flesh, dull impact, not gory |
|
||
| | `parry` | SA3 | metal parry clang, bright ring, short |
|
||
| | `skill_slash` | SA3 | powerful sword slash with air rip, dramatic |
|
||
| | `hurt` | SYN | 低频闷击（避免与 atk_hit 混淆） |
|
||
| | `enemy_die` | SA3 | body falling to ground with weapon clatter |
|
||
| | `potion` | SA3 | drinking liquid gulps, glass bottle |
|
||
| | `flee` | SYN | 渐远脚步 |
|
||
| | `turn_player` | SYN | 上行双音剑鸣，≤0.4s（11 号） |
|
||
| | `victory` | SA3 | triumphant short brass fanfare, 3 rising notes, wuxia style, under 1.5 seconds |
|
||
| 探索/系统 | `step` | SYN | 单步脚步 |
|
||
| | `coin` | SYN | 硬币叮当 |
|
||
| | `chest` | SA3 | old wooden chest creaking open |
|
||
| | `drink_water` | SA3 | scooping and drinking stream water |
|
||
| | `rest` | SA3 | settling down by campfire, fabric rustle |
|
||
| | `levelup` | SYN | 上行钟声琶音 |
|
||
| | `door_heavy` | SA3 | heavy wooden gate slowly opening, deep creak |
|
||
| | `ui_deny` | — | **不做**（回执走引擎） |
|
||
| 场景环境 | `amb_village` | SA3 | night village ambience, campfire crackle, distant chatter, crickets, loop |
|
||
| | `amb_path` | SA3 | forest path ambience, wind through leaves, birds distant, loop |
|
||
| | `amb_fork` | SA3 | forest crossroads ambience, wind split feel, crows, loop |
|
||
| | `amb_chest` | SA3 | hollow tree hole ambience, drips, muffled wind, loop |
|
||
| | `amb_stream` | SA3 | flowing stream over rocks, gentle water, loop |
|
||
| | `amb_hunter` | SA3 | wood cabin ambience, firewood crackle, knife sharpening occasionally, loop |
|
||
| | `amb_deepwood` | SA3 | deep forest ambience, insects, distant wolf howl, ominous, loop |
|
||
| | `amb_gate` | SA3 | bandit camp outside gate ambience, torches burning, rowdy distant voices, loop |
|
||
| | `amb_hall` | SA3 | large hall ambience, fire brazier, echoing space, tense, loop |
|
||
|
||
无声敌人（影卫 / 白无瞳三阶段）不占 sfx：窗口用引擎 `danger` earcon + 回执。amb 走 sfx 层 loop。计数仍约 35 件内容音 + 2 个战斗状态音。
|
||
|
||
---
|
||
|
||
## 8. 与台词表
|
||
|
||
开发只许引用 05-rpg-ch1-voice-ids.md。教学格挡句若仍写「双击」，运行时改播等价「点一下挡住」或停用旧 id 待重录——**不在本次改 voice-ids 文件**。
|
||
|
||
---
|
||
|
||
## 9. 废止（本章范围内）
|
||
|
||
| 废止 | 改为 |
|
||
|---|---|
|
||
| `ENEMY_TELEGRAPH` 双击格挡 | 单击；同向滑可选 |
|
||
| 探索双击重听 | 新手当单击；阶段 3 再重听当前描述 |
|
||
| 商店双击购买 | 单击购买 |
|
||
| 无声窗口仅震动 | danger earcon + 回执 |
|
||
| amb 与 explore BGM 抢同一层导致互删 | BGM 宏观 + amb 走 sfx loop（addendum） |
|
||
|
||
JSON、数值、获取节点、flags、summary 格式：**未改**。
|