2D 平台跳跃手感指南

它解决的是什么

2D 平台跳跃的成败几乎都落在单次跳跃的瞬间手感上：玩家在数以千计的重复中判断这次起跳是公平的，还是被游戏「吞掉」了输入。症状很具体——起跳发飘、落地迟钝、刚离开边缘就再也跳不起来、在瓦片接缝上蹭墙、高速下坠穿透地板、镜头一抖就让人犯晕。

共同点是：控制器收紧之前，填再多内容都是浪费。核心循环是：观察间隙或危险 → 决定起跳或移动 → 安全落地（或死亡）→ 抵达下一个检查点或目标。

技能如何工作

这是一个组合式（compositional）技能：不重讲物理和瓦片地图，而是把引擎移动技能、瓦片地图技能与设计技能接成一局能跑的游戏。

必须齐备的七个系统：

1. 跑/跳控制器：横向加速减速、重力、起跳，以及下文的手感辅助
2. 实心 + 单向碰撞：地面、墙体、可穿越平台
3. 关卡几何：瓦片地图或手工摆放的碰撞体
4. 危险与死亡/重生：尖刺、深坑、敌人，重置到上一个检查点
5. 检查点 / 关卡目标：进度标记与胜利条件（旗帜、门、出口）
6. 镜头：带死区与前视跟随玩家，并夹在关卡边界内
7. Juice：落地尘土、挤压拉伸、命中顿帧、音效——成本低、回报高

手感旋钮按结果调，而不是按原始数值猜：最大跳跃高度以格为单位（3–4 格）、到达顶点时间 0.30–0.40 s、下落重力为上升重力的 1.5–2.0 倍、coyote time 0.08–0.12 s、跳跃缓冲 0.10–0.15 s、松手时削减向上速度 0.4–0.5 倍实现点按短跳 / 长按满跳、顶点短暂滞空改善空中操控、地面加速 0.05–0.1 s 内到顶速、拐角修正最多约 4 px。重力与起跳速度应从这些手感值反推，见 Pattern 1。

三个关键模式：由高度与时间反推跳跃物理，而不是套魔法数字；土狼时间 + 跳跃缓冲 + 变高跳的手感核心三件套；单向平台从上方实心、下方穿过，按住下 + 跳时短暂禁用该碰撞体让玩家落下，不要自己重写碰撞数学。

边界与坑

不适用的场景：没有重力的俯视角移动，直接用引擎移动技能；3D 第一人称 traversal 用 fps-shooter；网格/回合制移动用 roguelike；要原始运动学刚体 API 时用 godot-2d-movement 或对应引擎的控制器技能。

常见失败模式：位移未乘 dt 导致速度随帧率变化（所有速度积分与计时器都要用 dt）；对称重力造成发飘，下落重力要比上升重；没有输入缓冲，按键「没反应」；没有土狼时间，「掉下去就跳不起来」；逐瓦片碰撞体导致蹭墙，改用单个 capsule/box 碰撞体并加拐角修正；高速穿透地板，开连续碰撞或用更小的固定步长；镜头不做平滑与死区会引发眩晕；一上来就组合多个机制会形成难度墙，每个区域先教一个机制。

跳跃数学推导、完整手感调校表、拐角修正、移动与单向平台、镜头跟随，见 references/feel-tuning.md。