笔记由 ai 生成。
宽容机制是替玩家补掉"意图"与"机器判定"之间那道缝隙的一组技术。它不给你新能力,只把"你明明按对了、游戏却没接住"的情况消掉。
这篇笔记整理四个最关键的机制——土狼时间、跳跃缓冲、角修正、顶点悬停——以及它们在 Jump 项目里的具体实现与实测数字。
1. 为什么需要它
玩家脑子里发生的和代码里发生的,是两件不同的事:
| 玩家以为 | 代码实际看到 |
|---|---|
| “我还在平台上,我按了跳” | 脚底已经悬空 2 帧,onGround == false,按键被丢弃 |
| “我落地前按了跳” | 按下那一刻还在空中,落地时没有新的"按下"边沿 |
| “我从边角旁边擦过去了” | AABB 重叠了 4px,判定撞顶,速度清零 |
| “我在顶点还能调整一下” | 顶点只持续 2~3 帧,人还没反应就下坠了 |
这四种抱怨的共性:玩家没有做错任何事,是判定的粒度比人的感知更细。 宽容机制就是把判定的粒度放宽到"和人的感知一致",而不是把游戏改简单。
Celeste 主创 Maddy Thorson 在 Celeste & Forgiveness 里的总结:
“All are centered around widening timing or positioning windows, so that everything is fudged a tiny bit in the player’s favor.” (全都是在放宽时机与位置的窗口,让一切都朝玩家有利的方向微调一点点。)
关键点在于"a tiny bit":窗口的长度本身就是难度旋钮,往两头都能坏事。
2. 四个机制总览
| 机制 | 补偿的误差 | 本质 | 典型量级 |
|---|---|---|---|
| 土狼时间 coyote time | 时间:离开地面那一瞬 | 一个倒计时记忆位 | 0.1 s |
| 跳跃缓冲 jump buffer | 时间:还没落地那一瞬 | 一个倒计时记忆位 | 0.1 s |
| 角修正 corner correction | 空间:差 1~4 px 的擦边 | 一次"横推后重试" | 4 px |
| 顶点悬停 apex hang | 反应:顶点只持续两三帧 | 一段区间内重力乘 0.5 | ±40~60 px/s |
按"补什么"分类只有两种:前两个补时间,第三个补空间,第四个补给玩家的反应时间。
3. 土狼时间(coyote time)
名字
来自《BB鸟与歪心狼》:歪心狼跑出悬崖之后,还能在空中跑两步,低头一看才掉下去。
现象
离开边缘
│
▼
─────────┼───────────────────────────────────► 时间
│◄──── 0.1s ────►│
还能起跳 │ 之后按跳 = 没反应
▼
真正掉下去
玩家在边缘起跳时,眼睛看到"还在平台上",手已经在过去了——通常差两三帧。纯物理判定会把这三次输入全部丢掉。
实现
-- 站在地上时把计时器填满;离地后只递减,不再回填
if p.onGround then
p.coyoteTimer = const.COYOTE_TIME
else
p.coyoteTimer = math.max(0, p.coyoteTimer - dt)
end
-- 起跳条件从 onGround 放宽成"在地面上 或 还在窗口里"
if input.jumpPressed and (p.onGround or p.coyoteTimer > 0) then
jump()
p.coyoteTimer = 0 -- ⚠ 必须清零
end
坑
- 不清零 = 白送二段跳。 跳完之后窗口如果还在,空中再按一次又能跳。
- 顺序不能反。 先递减再判断;先重置再递减会在"站着的那一帧"白扣一帧,窗口悄悄变短一帧。
- 这是时间单位,不是距离单位。 0.1 s 在
MAX_RUN = 200时值 20px(0.6 格);跑到 400 就值 40px(1.2 格)。改移动速度必须重看这个数。
本项目
COYOTE_TIME = 0.10(6 帧,满速时 20 px)。
4. 跳跃缓冲(jump buffer)
现象
土狼时间的镜像。土狼管"离开得太晚",缓冲管"落地得太早":
落地前一瞬按下跳
│
▼
──────┼──────────┼────────────────────────► 时间
│ │
│◄─ 0.1s ─►│
记住这次按键 落地那一帧自动起跳
玩家想连跳,节奏天然会比落地早半拍。按下时 onGround == false,这一下被丢弃;落地后又没有新的"按下边沿",人就傻站着。玩家感受是"卡了一下"。
实现
if input.jumpPressed then
p.bufferTimer = const.JUMP_BUFFER
else
p.bufferTimer = math.max(0, p.bufferTimer - dt)
end
-- 起跳条件:缓冲里压着一次按跳,且此刻能起跳
-- (土狼窗口和缓冲窗口在这里合流成同一个判断)
一帧里要检查两次
这是最容易漏的细节。如果只在移动前检查:
第 N 帧 :按键还在缓冲里,但 onGround 仍是 false → 不起跳
第 N 帧末 :物理更新,脚落地
第 N+1 帧 :onGround 变 true,缓冲兑现 → 起跳
晚了一帧。16ms 人眼说不清,但手上的感觉是"落地黏了一下"。正确做法是移动之后再检查一次:
update():
1. 记忆位递减 / 重置
2. 水平加速
3. 尝试起跳 ← 正常起跳
4. 松手截断
5. 重力
6. 移动 + 碰撞
7. 按碰撞结果清速度 ← 落地速度清零
8. 再尝试起跳 ← 这一帧刚落地,立刻兑现缓冲
第 8 步必须在第 7 步之后:先清掉落地速度,再被起跳改写。顺序反了会被第 7 步抹掉。
坑
- 不消费缓冲 = 蹦床。 按住不放会一路连跳。
- 缓冲要和"能不能跳"解耦。 缓冲只记"玩家想跳",能不能兑现由当帧的地面状态决定。把两者混在一个布尔里,就会出现"空中按了跳,落地后整个人弹起来"的误触发(其实是缓冲过期没清)。
本项目
JUMP_BUFFER = 0.10(6 帧)。
5. 角修正(corner correction)
现象
没有修正 有修正
┌────────────────────┐ ┌────────────────────┐
│ 平台 │ │ 平台 │
└────────────────────┘ └────────────────────┘
▓▓ ▓▓ →→ (横推 4px)
▓▓ ← 撞头,vy 归零 ▓▓ ← 擦过去,继续上升
跳跃时头只蹭到平台边缘 2~4px,判定就是"撞顶":竖直速度清零、人掉下去。但玩家看到的是"我擦过去了"。这是主观与客观差得最远的一种情况——因为视觉上那 4px 根本不存在。
实现
碰撞解算时,如果上升被挡住了:
for k = 1 .. MAX_PUSH: -- 最多横推 N 像素
for each 方向 in {偏好方向, 相反方向}:
tx = x + k * 方向
if 目标位置(tx, 原本要去的 y) 是空的
and 从 x 到 tx 的横向路径也是空的:
接受修正:x = tx, y = 原本要去的 y,取消"撞顶"
return
-- 全部失败 → 老老实实撞头
两个条件缺一不可。只判目标位置的话,横推 4px 会直接穿过一堵 1px 厚的薄墙。
坑
- 推太多,世界就不可信。 挪 20px 玩家会看见角色从墙里穿出去。4px 是"肉眼不追究"的量级。
- 横推路径要扫掠,不是只看终点。 见上。
- 偏好方向要跟输入走。 往右冲时优先往右让,符合直觉;没有输入时用速度方向兜底。全往一个方向推,会出现"往右跑却总被往左推开"的怪异感。
- 不能把它当"自动上台阶"。 角修正只管头顶擦边;脚下的小台阶是另一个机制(step-up),别混。
本项目
CORNER_PUSH = 4,实现在 src/physics.lua 的 move() 里(corridorFree + freeAt)。断言:
- 擦边 4px → 被推开后继续上升,且横移量正好 4px(没有穿进平台)
- 擦边 11px → 超出能力,老老实实撞头
6. 顶点悬停(apex hang / hang time)
现象
抛物线的顶点看起来"最慢",其实是方向变化最快的地方。玩家的全部决策——往左还是往右、踩哪个平台、要不要松手——都挤在这两三帧里。
g (重力)
1800 ┤────────┐ ┌────────
│ │ │
900 ┤ └──────────────┘
└────────────────────────────────► t
上升段 顶点区间 下落段
实现
if 按住跳跃键 and |vy| < 阈值:
g = GRAVITY * 0.5
else:
g = GRAVITY
就能把"穿过零点"的时间拉长一倍(下表用 Celeste 的数值:阈值 40、重力 900):
| 重力 | 在速度 ±40 的区间里停留 |
|---|---|
| 全重力 1800 | 0.044 s ≈ 2.7 帧 |
| 减半 900 | 0.089 s ≈ 5.3 帧 |
为什么几乎不改变跳跃高度
减半区多给的高度是 band² / (4g)。band 取 60、g 取 1800 时只有 0.5 px。
这一点很重要:顶点悬停改的是时间的分布,不是能力的上限。 已经按跳跃高度设计好的关卡,不会被它推翻。
坑
- 榜在"按住跳跃键"上。 松手的人要的是干脆坠落;而且这样"按住 = 更多控制权"才成为一条玩家能自己学会的规则。Celeste 就是这么做的。
- 下落段不要减半(或者说:不要在全速下落时减半)。落地会失去重量感,像落在棉花上。
- 判断要用这一帧的初速,不是加大重力之后的值。 否则跨越零点的那一帧会多算一帧,效果随帧率抖动。
- 过头就"飘"。 评论里最伤人的词就是 floaty —— 角色像在无视重力。宁可少一点。
本项目
APEX_BAND = 60、APEX_GRAVITY_MULT = 0.5,只在 jumpHeld 时生效。实测满跳滞空从 0.62 s 拉到 0.68 s(41 帧),顶点区间停留 8 帧。
7. 它们必须一起上
四个机制不是四选一,是互相补位:
| 组合 | 玩家体感 |
|---|---|
| 只有土狼 | 边缘能救回来,但连跳还是卡(落地前按的那下仍被吃掉) |
| 只有缓冲 | 落地顺了,但跑出平台边缘还是"按了不跳" |
| 土狼 + 缓冲 | 连续跳跃才真正成立,玩家敢用节奏跳 |
| 再加角修正 | “我明明跳得够"变成真的过得去 |
| 再加顶点悬停 | 顶点有反应时间,落点调整从"猜"变成"操作” |
反过来,窗口太长就是灾难:
| 参数 | 太短 | 太长 |
|---|---|---|
| 土狼时间 | 边缘永远坑人 | 角色像粘在空气里,明明掉下去半格还能跳,视觉不可信 |
| 跳跃缓冲 | 连跳要卡一帧 | 还没想跳就自己起飞;空中误触发时像 bug |
| 角修正 | 擦边就撞头 | 看见角色从墙里穿过去 |
| 顶点悬停 | 顶点没有操作时间 | 月球感,落地没重量 |
经验区间:土狼 / 缓冲 0.08 ~ 0.12 s,角修正 3 ~ 5 px,悬停阈值 40 ~ 60 px/s。
8. 怎么验证(不用开窗口)
这四个机制全都"看不见",错了也照样能跑。所以必须能在终端里用固定 dt 一帧一帧推进来断言——这也是把它们放进纯逻辑模块(零 love.*)的理由。
断言清单(对应 tests/forgiveness_smoke.lua):
土狼时间
- 离地第 1 / 3 / 5 帧按跳 → 起跳
- 离地第 8 帧按跳 → 跳不动
- 土狼跳只兑现一次,空中第二次按跳不会二段跳
跳跃缓冲
- 落地前 1 / 3 帧按跳 → 落地那一帧就起跳
- 落地前 12 帧按跳 → 已过期,落地站着不动
- 兑现后立刻清零,按住不放也只跳一次
角修正
- 擦边 4px → 推开后继续上升,横移量正好 4px
- 擦边 11px → 撞头
- 离开边角很远 → 不受影响
顶点悬停
- 顶点附近按住跳 → 一帧的 Δvy 正好是
GRAVITY * 0.5 * dt - 顶点附近松手 → 全重力
- 远离顶点 → 全重力
- 满跳在顶点区间停留 ≥ 7 帧(无悬停只有 4 帧)
⚠ 写这类测试有两个坑:
- 不要测浮点边界。
0.1 - 6 * (1/60)在双精度里是 ±1e-17 量级,断言窗口"第 6 帧"谁都会挂。测第 5 帧(成立)和第 8 帧(不成立)就够了。 - 测试初始化会污染被测机制。 手工设
vy = -700造上升状态时,如果忘了置cutUsed = true,第一帧就触发"松手截断",速度变 -315,人根本升不到平台——测的就不是角修正了。
9. 移植到新项目的最小步骤
- 先把基础跳跃调到满意(重力、起跳初速、可变高度)。宽容机制是最后一步,不是第一步。
- 抽出两个倒计时字段 + 一个"尝试起跳"函数。
- 在 update 里排好顺序:记忆位 → 水平 → 起跳 → 截断 → 重力 → 移动 → 清速度 → 再起跳。
- 打开角修正(先在物理层写好,参数给 0 关着)。
- 最后加顶点悬停,一步只改一个参数,每步跑一次测试与关卡可达性。
- 每次加完都要重跑关卡可达性测试:这些机制会悄悄加强玩家的移动能力(本项目加了悬停后,边跑边跳位移从 123px 涨到 137px,某个 32px 空档的起跳窗口从 48px 变成 64px)。
10. 参数速查
| 参数 | Celeste | Jump(本项目) | 含义 |
|---|---|---|---|
| Gravity | 900 | 1800 | 基础重力 |
| MaxFall | 160 | 720 | 终端下落速度 |
| JumpSpeed | -105 | -560 | 起跳初速 |
| JumpGraceTime | 0.1 | 0.10 | 土狼时间 |
| VarJumpTime | 0.2 | (用松手截断代替) | 按住持续上升的时长 |
| UpwardCornerCorrection | 4 | 4 | 角修正上限(px) |
| HalfGravThreshold | 40 | 60 | 顶点区间的速度阈值 |
| 悬停倍率 | 0.5 | 0.5 | 顶点区间的重力倍率 |
注:Celeste 原生分辨率 320x180,本项目 1280x720(4 倍),所以速度与加速度的绝对值不可直接对比,要看比值。
11. 参考
- Maddy Thorson, Celeste & Forgiveness — https://www.mattmakesgames.com/articles/celeste_and_forgiveness/index.html
- Celeste 源码
Player.cs的常量表(JumpGraceTime/VarJumpTime/UpwardCornerCorrection/HalfGravThreshold) - GameDesign.gg, Hang Time — https://gamedesign.gg/glossary/hang-time
- 本项目实现:
src/player.lua(土狼 / 缓冲 / 悬停)、src/physics.lua(角修正)、tests/forgiveness_smoke.lua(全部断言)