268 lines
9.0 KiB
Markdown
268 lines
9.0 KiB
Markdown
# 05 · 移动系统规范
|
||
|
||
> **所属文档集** [← 返回索引](./README.md)
|
||
> **摘要**：玩家移动的物理模型、跳跃机制、冲刺、墙壁力学与手感参数。
|
||
|
||
---
|
||
|
||
## 目录
|
||
|
||
1. [移动设计目标](#1-移动设计目标)
|
||
2. [地面移动](#2-地面移动)
|
||
3. [跳跃模型](#3-跳跃模型)
|
||
4. [冲刺系统](#4-冲刺系统)
|
||
5. [墙壁力学](#5-墙壁力学)
|
||
6. [空中冲刺（Aerial Dash）](#6-空中冲刺aerial-dash)
|
||
7. [下冲（Plunge）](#7-下冲plunge)
|
||
8. [地面与碰撞检测](#8-地面与碰撞检测)
|
||
9. [移动配置参数](#9-移动配置参数)
|
||
|
||
---
|
||
|
||
## 1. 移动设计目标
|
||
|
||
| 目标 | 实现方式 |
|
||
|------|---------|
|
||
| **精确可控** | 即时响应方向输入，没有"滑动"惯性 |
|
||
| **灵活多样** | 多种移动选项（跳跃、冲刺、墙跳、空中冲刺）|
|
||
| **手感沉重** | 快速下落（fall multiplier），跳跃顶点缓降 |
|
||
| **容错空间** | 土狼时间、跳跃缓冲降低输入失误惩罚 |
|
||
| **进阶可深** | 空中冲刺+墙跳的组合技深度 |
|
||
|
||
---
|
||
|
||
## 2. 地面移动
|
||
|
||
### 2.1 水平移动
|
||
|
||
| 状态 | 速度 | 说明 |
|
||
|------|------|------|
|
||
| 行走（轻推摇杆）| `walkSpeed` | 6 units/s |
|
||
| 奔跑（全推摇杆）| `runSpeed` | 9 units/s |
|
||
|
||
- 水平速度**即时响应**输入，无加速/减速惯性
|
||
- 松开输入时立即停止（不滑行）
|
||
|
||
> **设计决策**：不使用加速/减速曲线
|
||
> **原因**：类银河恶魔城强调精确跳台，惯性会使平台跳跃难以预判落点
|
||
|
||
### 2.2 朝向
|
||
|
||
- 朝向随水平输入即时翻转
|
||
- 攻击/技能状态中锁定朝向（不随输入改变）
|
||
|
||
---
|
||
|
||
## 3. 跳跃模型
|
||
|
||
### 3.1 跳跃类型
|
||
|
||
| 类型 | 触发条件 | 初速度 | 备注 |
|
||
|------|---------|--------|------|
|
||
| 地面跳跃 | 地面 + 跳跃键 | `jumpForce` | 标准跳跃 |
|
||
| 土狼跳 | 离地后 `coyoteTime` 内 + 跳跃键 | `jumpForce` | 视为地面跳跃 |
|
||
| 双跳 | 空中 + 跳跃键 + `DoubleJump` 已解锁 + 未使用过 | `doubleJumpForce` | 每次落地重置 |
|
||
| 墙跳（背墙）| 贴墙 + 跳跃键 | 水平: `wallJumpAwayHForce`，垂直: `wallJumpVerticalForce` | 背离墙壁方向 |
|
||
| 墙跳（对墙）| 贴墙 + 朝墙方向 + 跳跃键 | 水平: `wallJumpTowardHForce`，垂直: `wallJumpVerticalForce` | 朝墙壁方向 |
|
||
|
||
### 3.2 可变跳跃高度
|
||
|
||
松开跳跃键时，若玩家垂直速度仍向上，截断为原值的 50%。
|
||
→ 长按获得完整跳跃高度；短按获得约一半高度。
|
||
|
||
### 3.3 重力模型
|
||
|
||
使用**非对称重力**以获得"果断"手感：
|
||
|
||
| 阶段 | 重力倍率 |
|
||
|------|---------|
|
||
| 上升阶段 | ×1.0（基础重力）|
|
||
| 下落阶段 | ×`fallMultiplier`（默认 2.5）|
|
||
| 短跳（松键后上升）| ×`lowJumpMultiplier`（默认 2.0）|
|
||
| 跳跃顶点（速度接近 0）| 短暂降低至 ×0.6（缓降感）|
|
||
|
||
### 3.4 跳跃缓冲（Jump Buffer）
|
||
|
||
在落地前 `jumpBufferDuration`（默认 0.15s）内按下跳跃键，落地后立即触发跳跃。
|
||
→ 消除玩家"刚好落地后跳跃失败"的挫败感。
|
||
|
||
---
|
||
|
||
## 4. 冲刺系统
|
||
|
||
### 4.1 地面冲刺
|
||
|
||
| 参数 | 值 | 说明 |
|
||
|------|-----|------|
|
||
| 方向 | 当前朝向（水平，不可向上/下）| 地面冲刺只能水平 |
|
||
| 速度 | `dashSpeed` (18 units/s) | 远高于跑步速度 |
|
||
| 时长 | `dashDuration` (0.18s) | 固定时长 |
|
||
| 冷却 | `dashCooldown` (0.5s) | 冷却期间不可再冲刺 |
|
||
| 无敌帧 | 冲刺全程 | 不受任何伤害 |
|
||
| 穿透 | 可穿过敌人 | 不被敌人阻挡 |
|
||
|
||
### 4.2 冲刺取消
|
||
|
||
冲刺中不可被低优先级状态打断。但以下情况可中断：
|
||
- 受到 `Unblockable` 攻击（仅此一项，普通攻击在冲刺无敌期间被忽略）
|
||
|
||
---
|
||
|
||
## 5. 墙壁力学
|
||
|
||
### 5.1 墙抓（WallGrab）
|
||
|
||
> **默认解锁**，不需要能力门
|
||
|
||
当玩家在空中贴近可抓取的墙壁并输入朝墙方向时，进入 WallGrabState：
|
||
|
||
| 行为 | 说明 |
|
||
|------|------|
|
||
| 悬挂 | 玩家停止下落，附着在墙上 |
|
||
| 高度记忆 | 记录抓墙时的 Y 坐标（`wallGrabAnchorY`）|
|
||
| 超出记忆值 | 玩家可向上爬（无上限）|
|
||
| 低于记忆值 | 按 `wallGrabSlideSpeed` 缓慢下滑（不快速下落）|
|
||
| 持续时间 | 无时间限制（可一直抓）|
|
||
|
||
### 5.2 墙跳类型
|
||
|
||
| 类型 | 触发 | 水平冲力 | 垂直冲力 |
|
||
|------|------|---------|---------|
|
||
| **背墙跳** | 跳跃键（无方向或反向）| `wallJumpAwayHForce` (10) | `wallJumpVerticalForce` (15) |
|
||
| **对墙跳** | 朝墙方向 + 跳跃键 | `wallJumpTowardHForce` (3) | `wallJumpVerticalForce` (15) |
|
||
|
||
背墙跳弹离效果强，用于快速脱离；对墙跳爬升效果强，用于沿墙向上攀爬。
|
||
|
||
> **设计决策**：两种墙跳共用垂直分量
|
||
> **原因**：统一手感基准，区别仅在水平表现
|
||
|
||
### 5.3 墙跳后的输入锁定
|
||
|
||
背墙跳后：
|
||
- 水平方向输入锁定 0.1s（防止玩家立即贴回同一面墙）
|
||
|
||
---
|
||
|
||
## 6. 空中冲刺（Aerial Dash）
|
||
|
||
> **需要解锁** `AerialDash` 能力
|
||
|
||
### 6.1 基本规则
|
||
|
||
| 参数 | 值 | 说明 |
|
||
|------|-----|------|
|
||
| 方向 | 8 方向（摇杆方向量化）| 与地面冲刺最大区别 |
|
||
| 速度 | `aerialDashSpeed` (15 units/s) | 略低于地面冲刺 |
|
||
| 时长 | `aerialDashDuration` (0.20s) | |
|
||
| 无敌帧 | 冲刺全程 | 同地面冲刺 |
|
||
| 充能次数 | 默认 1 次（护符可升至 2 次）| 每次空中各自独立 |
|
||
|
||
### 6.2 充能重置条件
|
||
|
||
| 触发条件 | 说明 |
|
||
|---------|------|
|
||
| 落地 | 触地瞬间恢复 |
|
||
| 墙跳成功 | 墙跳给予新的空中冲刺机会 |
|
||
| **近战攻击命中** | 命中敌人即恢复（鼓励进攻性空中移动）|
|
||
| **弹反成功** | 弹反视为命中，给予恢复 |
|
||
|
||
> **设计决策**：命中恢复充能
|
||
> **原因**：这是《丝之歌》核心机制，使得玩家可以通过激进攻击保持永续空中移动。
|
||
> **体验目标**：顶级玩家应该能通过攻击和弹反的组合在空中无限机动。
|
||
|
||
### 6.3 方向量化规则
|
||
|
||
摇杆输入方向量化为 8 个标准方向（45° 间隔）：
|
||
- 上/下/左/右（4 个主方向）
|
||
- 左上/右上/左下/右下（4 个斜方向）
|
||
- 若无输入，默认朝当前朝向水平冲刺
|
||
|
||
---
|
||
|
||
## 7. 下冲（Plunge）
|
||
|
||
> **无需解锁**，基础能力
|
||
|
||
### 7.1 触发条件
|
||
|
||
```
|
||
空中 + 向下方向输入 + 冲刺键
|
||
（优先级高于普通空中冲刺）
|
||
```
|
||
|
||
### 7.2 行为规范
|
||
|
||
| 阶段 | 说明 |
|
||
|------|------|
|
||
| 激活 | 取消垂直速度，施加极大向下速度（`plungeSpeed` = 28 units/s）|
|
||
| 下冲中 | 全程无敌帧；保留少量水平速度（原值 ×0.2）|
|
||
| 落地 | 触发冲击波 AoE，范围内敌人受伤 + 强硬直 |
|
||
| 落地后 | 轻微弹起（`verticalBounce` = 4 units/s）→ 回 IdleState |
|
||
| 充能消耗 | 消耗 1 次空中冲刺充能（与 AerialDash 共享）|
|
||
|
||
### 7.3 冲击波参数
|
||
|
||
| 参数 | 值 |
|
||
|------|-----|
|
||
| 冲击波半径 | 2.0 units |
|
||
| 冲击伤害 | 基础攻击 ×2.0 |
|
||
| 硬直时长 | 0.8s |
|
||
| 是否可弹反 | 否 |
|
||
|
||
---
|
||
|
||
## 8. 地面与碰撞检测
|
||
|
||
### 8.1 地面检测
|
||
|
||
- 在角色脚部发起**小矩形区域检测**，检测 Ground 层
|
||
- 每帧更新，检测结果对外暴露为只读属性 `isGrounded`
|
||
- **单向平台**（OneWayPlatform）：
|
||
- 从下方跳跃时穿过（检测忽略该层）
|
||
- 站在上方时视为地面
|
||
- 向下 + 跳跃键：临时忽略单向平台层，允许下穿
|
||
|
||
### 8.2 土狼时间（Coyote Time）
|
||
|
||
离开地面后（如走出平台边缘）的 `coyoteTime`（默认 0.12s）内仍视为"在地面"：
|
||
- 这段时间内可触发地面跳跃
|
||
- 只对自然离地有效（跳跃后不产生土狼时间）
|
||
|
||
### 8.3 墙壁检测
|
||
|
||
- 在角色左右两侧各发出一条水平射线
|
||
- 检测 Wall 层
|
||
- 结果：`isWallLeft` / `isWallRight`
|
||
- 区分"可抓墙"和"不可抓墙"（通过墙壁属性标记）
|
||
|
||
---
|
||
|
||
## 9. 移动配置参数
|
||
|
||
| 参数 | 推荐值 | 说明 |
|
||
|------|--------|------|
|
||
| `walkSpeed` | 6.0 | 地面行走速度（units/s）|
|
||
| `runSpeed` | 9.0 | 地面奔跑速度（units/s）|
|
||
| `jumpForce` | 16.0 | 跳跃初始垂直速度 |
|
||
| `doubleJumpForce` | 14.0 | 双跳初始垂直速度 |
|
||
| `wallJumpAwayHForce` | 10.0 | 背墙跳水平分量 |
|
||
| `wallJumpTowardHForce` | 3.0 | 对墙跳水平分量 |
|
||
| `wallJumpVerticalForce` | 15.0 | 墙跳垂直分量 |
|
||
| `wallJumpInputLockDuration` | 0.1s | 背墙跳后水平输入锁定时长 |
|
||
| `wallGrabSlideSpeed` | 2.0 | 抓墙下滑速度（低于记忆高度时）|
|
||
| `dashSpeed` | 18.0 | 地面冲刺速度 |
|
||
| `dashDuration` | 0.18s | 地面冲刺时长 |
|
||
| `dashCooldown` | 0.5s | 冲刺冷却时间 |
|
||
| `aerialDashSpeed` | 15.0 | 空中冲刺速度 |
|
||
| `aerialDashDuration` | 0.20s | 空中冲刺时长 |
|
||
| `plungeSpeed` | 28.0 | 下冲速度 |
|
||
| `plungeImpactRadius` | 2.0 | 下冲冲击波半径 |
|
||
| `plungeBounceForce` | 4.0 | 落地后弹起速度 |
|
||
| `fallMultiplier` | 2.5 | 下落额外重力倍率 |
|
||
| `lowJumpMultiplier` | 2.0 | 短跳额外重力倍率 |
|
||
| `apexGravityScale` | 0.6 | 跳跃顶点重力缩减倍率 |
|
||
| `coyoteTimeDuration` | 0.12s | 土狼时间窗口 |
|
||
| `jumpBufferDuration` | 0.15s | 跳跃预输入缓冲窗口 |
|
||
| `groundCheckSize` | (0.8, 0.05) | 地面检测矩形尺寸 |
|
||
| `wallCheckDistance` | 0.1 | 墙壁检测射线长度 |
|