笔记由 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 的区间里停留
全重力 18000.044 s ≈ 2.7 帧
减半 9000.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 帧)

⚠ 写这类测试有两个坑:

  1. 不要测浮点边界。 0.1 - 6 * (1/60) 在双精度里是 ±1e-17 量级,断言窗口"第 6 帧"谁都会挂。测第 5 帧(成立)和第 8 帧(不成立)就够了。
  2. 测试初始化会污染被测机制。 手工设 vy = -700 造上升状态时,如果忘了置 cutUsed = true,第一帧就触发"松手截断",速度变 -315,人根本升不到平台——测的就不是角修正了。

9. 移植到新项目的最小步骤

  1. 先把基础跳跃调到满意(重力、起跳初速、可变高度)。宽容机制是最后一步,不是第一步。
  2. 抽出两个倒计时字段 + 一个"尝试起跳"函数。
  3. 在 update 里排好顺序:记忆位 → 水平 → 起跳 → 截断 → 重力 → 移动 → 清速度 → 再起跳。
  4. 打开角修正(先在物理层写好,参数给 0 关着)。
  5. 最后加顶点悬停,一步只改一个参数,每步跑一次测试与关卡可达性。
  6. 每次加完都要重跑关卡可达性测试:这些机制会悄悄加强玩家的移动能力(本项目加了悬停后,边跑边跳位移从 123px 涨到 137px,某个 32px 空档的起跳窗口从 48px 变成 64px)。

10. 参数速查

参数CelesteJump(本项目)含义
Gravity9001800基础重力
MaxFall160720终端下落速度
JumpSpeed-105-560起跳初速
JumpGraceTime0.10.10土狼时间
VarJumpTime0.2(用松手截断代替)按住持续上升的时长
UpwardCornerCorrection44角修正上限(px)
HalfGravThreshold4060顶点区间的速度阈值
悬停倍率0.50.5顶点区间的重力倍率

注:Celeste 原生分辨率 320x180,本项目 1280x720(4 倍),所以速度与加速度的绝对值不可直接对比,要看比值。


11. 参考