如果你在视频网站刷过《泰坦陨落 2》Titanfall 2社区里常写成 TTF2的关卡演示大概率见过类似弹幕“我也要跳吗”这句调侃表面是替屏幕前的玩家问角色背后却藏着动作游戏开发里一个非常核心的问题跳跃这个最基础的操作怎样设计才能让玩家觉得“该跳就跳”而不是在关键时刻愣住。我写这篇文章不是做游戏攻略也不打算考据 TTF2 的官方数值。我想从一个更工程化的角度切入如何在 Unity 中实现一套手感可靠的跳跃控制器。会讲到跳跃缓冲、土狼时间、可变跳跃高度、地面检测以及从普通跳跃扩展到墙跑这类跑酷能力的思路。就算你最终要做的不是射击游戏这套思路也适用于平台跳跃、ARPG、第三人称动作项目甚至 2D 横版跳跃。读完之后你能得到下面几件事理解一个“能用的跳跃”到底由哪些机制组成。拿到一份可以放进 Unity 项目里运行的PlayerJumpController完整代码。学会用调试日志和测试步骤量化“手感”。知道跳跃系统最常见的坑以及怎么定位排查。1. 为什么“我也要跳吗”能引出一个技术话题1.1 玩家的困惑是设计者的事件报告当一个玩家在屏幕前问出“我也要跳吗”通常意味着三件事同时发生了当前场景给玩家的语义不是“操作挑战”而是“剧情演出”角色的动作提示不够明确玩家不确定自己是否拥有控制权但玩家仍然信任这套系统愿意停下来等一下反馈。从工程师视角看这正是跳跃状态机要处理的边界情况。很多新手做跳跃只想着“按下空格就跳一下”结果遇到这种混合了演出、镜头、输入的场景角色要么不跳要么跳得又飘又僵。TTF2 之所以能在高台、墙壁、空中连续切换时保持流畅恰恰说明它不是在做一个孤立的“跳跃”而是围绕跳跃搭了一套完整的状态机与输入缓冲系统。1.2 跳跃系统为什么值得单独写一套代码跳跃不是一个按钮而是一套链路输入采样 → 输入缓冲 → 地面检测 → 状态判断 → 速度计算 → 角色移动 → 动画同步任何一个环节出问题玩家都能在几十毫秒内感知到。比如在地面边缘按下跳跃结果角色先掉下去再跳这就是没有土狼时间快落地时提前按了跳跃结果角色落地后才出跳这就是没有跳跃缓冲按住跳跃键和轻点跳跃键的最高点一样高这就是没有可变跳跃高度。这三点加上重力系数的调教几乎决定了一个跳跃系统“有没有手感”。TTF2 的移动系统之所以被反复提起不是因为某个参数神秘而是因为它在这些基础机制之上叠加了二段跳、墙跑、滑铲等扩展能力并且每种能力之间的过渡是可预期的。2. 跳跃系统的核心概念与设计原则2.1 跳跃的本质是一次“向上的速度叠加”大部分 3D 引擎里跳跃并不是“给角色一个向上的位移”而是给角色一个向上的初速度然后让重力在每一帧修改这个速度。物理公式很简单跳跃初速度 sqrt(2 * 重力加速度绝对值 * 目标跳跃高度)例如你想让角色跳到 1.5 米高重力是 -18那么初速度大概是v sqrt(2 * 18 * 1.5) ≈ 7.35 m/s这个公式的意义在于你不需要直接猜“跳跃速度填多少”而是先确定“角色要跳多高”再反推速度。调整手感时会清晰很多。2.2 跳跃缓冲、土狼时间、可变跳跃高度这三个机制是跳跃手感的核心。机制解决什么问题直观效果跳跃缓冲玩家在落地前一点点按下跳跃但角色还没落地落地瞬间能立刻接跳不需要玩家精确卡帧土狼时间玩家刚走出平台边缘物理上已经离开地面离开边缘后一小段时间内仍允许起跳避免“明明在地边却跳不出来”可变跳跃高度玩家轻点跳跃和长按跳跃的高度一样轻点会明显更矮长按能跳满给玩家更多操控空间很多开发者在实现时容易把前两个混淆。跳跃缓冲是“输入提前于落地”土狼时间是“输入滞后于离开地面”。两者可以同时存在也可以分开关闭但在动作游戏里一般建议同时开启。2.3 从单次跳跃到 TTF2 式跑酷TTF2 式移动看起来很“自由”但拆开看仍然是有限状态机地面静止 → 奔跑 → 跳跃 → 空中转向 → 墙跑 → 离开墙面 → 落地你可以把“跳跃”理解成一个状态入口之后在空中可以进入二段跳、墙跑、滑铲等子状态。每个子状态都在复用跳跃系统的两个底层能力速度叠加和重力处理。所以先把普通跳跃做好再谈扩展墙跑才是正确的开发顺序。3. 环境准备与最小场景搭建3.1 开发环境说明本文示例基于 Unity 3D 项目。角色控制器使用CharacterController输入使用旧版Input Manager的Jump轴。新版 Input System 项目也可以运行但需要在 Project Settings 中把 Active Input Handling 设置为Both或者把代码里的输入部分替换成新输入系统的事件回调。具体 Unity 版本不写死。2022 LTS 或更新的长期支持版都可以。如果你的项目用的是 Unity 6核心 API 也兼容。3.2 场景与层级结构最小测试场景只需要三部分场景 ├── Directional Light ├── Plane地面Layer 设为 Ground └── Player空物体或 Capsule ├── CharacterController 组件 └── PlayerJumpController 脚本操作步骤新建 3D 项目。在场景中添加 Plane把 Y 轴设置为 0并给它一个GroundLayer。添加 Capsule位置设置为(0, 1, 0)。删除 Capsule 自带的CapsuleCollider因为CharacterController本身就是碰撞体。给 Capsule 挂上CharacterController组件保持默认参数即可Height2Radius0.5Center(0,0,0)。创建 Ground Layer并把 Plane 设置到这个 Layer。新建PlayerJumpController.cs脚本挂到 Capsule 上。3.3 输入映射旧版 Input Manager 里已经默认把Jump绑定到空格键。如果你希望改成其他按键可以打开Edit Project Settings Input Manager找到Jump轴修改Positive Button。如果项目启用了新版 Input System可以在.inputactions文件里配置一个 Jump 动作。示意配置如下{ name: GameControls, maps: [ { name: Gameplay, id: f8d9c2b0-0000-4000-8000-000000000001, actions: [ { name: Jump, type: Button, expectedControlType: Button } ], bindings: [ { name: Space, path: Keyboard/space, action: Jump, id: a1b2c3d4-0000-4000-8000-000000000002 } ] } ] }字段结构会随 Input System 包版本略有差异关键是把Jump绑定到空格键。下面代码为了聚焦跳跃逻辑统一使用旧版Input.GetButtonDown(Jump)。4. 完整实现带跳跃缓冲和土狼时间的角色控制器4.1 PlayerJumpController 代码// 文件路径Assets/Scripts/Player/PlayerJumpController.cs using UnityEngine; [RequireComponent(typeof(CharacterController))] public class PlayerJumpController : MonoBehaviour { [Header(移动参数)] [SerializeField] private float moveSpeed 5f; [SerializeField] private float rotationSpeed 10f; [SerializeField] private float gravity -18f; [Header(地面检测)] [SerializeField] private float groundCheckDistance 0.12f; [SerializeField] private LayerMask groundLayer; [Header(跳跃参数)] [SerializeField] private float jumpHeight 1.5f; [SerializeField] private float jumpBufferTime 0.15f; [SerializeField] private float coyoteTime 0.1f; [SerializeField] private float jumpCutMultiplier 0.4f; [SerializeField] private float fallMultiplier 1.6f; private CharacterController controller; private Vector3 horizontalVelocity; private float verticalVelocity; private float lastJumpPressedTime -100f; private float lastGroundedTime -100f; private bool grounded; public bool IsGrounded grounded; public float VerticalVelocity verticalVelocity; public Vector3 HorizontalVelocity horizontalVelocity; private void Awake() { controller GetComponentCharacterController(); } private void Update() { if (Time.timeScale 0f) return; float horizontal Input.GetAxisRaw(Horizontal); float vertical Input.GetAxisRaw(Vertical); bool jumpPressed Input.GetButtonDown(Jump); bool jumpReleased Input.GetButtonUp(Jump); UpdateGroundState(); UpdateVerticalVelocity(jumpPressed, jumpReleased); Vector3 moveDir (transform.right * horizontal transform.forward * vertical).normalized; horizontalVelocity moveDir * moveSpeed; Vector3 velocity horizontalVelocity Vector3.up * verticalVelocity; controller.Move(velocity * Time.deltaTime); } private void UpdateGroundState() { // 用 SphereCast 重建地面状态比 controller.isGrounded 更可控 Vector3 bottom transform.position controller.center - Vector3.up * (controller.height * 0.5f); Vector3 origin bottom Vector3.up * controller.radius; grounded Physics.SphereCast( origin, controller.radius, Vector3.down, out _, groundCheckDistance, groundLayer, QueryTriggerInteraction.Ignore ); if (grounded) { lastGroundedTime Time.time; if (verticalVelocity 0f) { verticalVelocity -2f; } } } private void UpdateVerticalVelocity(bool jumpPressed, bool jumpReleased) { if (jumpPressed) { lastJumpPressedTime Time.time; } bool hasBufferedJump Time.time - lastJumpPressedTime jumpBufferTime; bool withinCoyoteTime Time.time - lastGroundedTime coyoteTime; // 先做重力积分 float gravityThisFrame gravity; if (verticalVelocity 0f) { gravityThisFrame * fallMultiplier; } verticalVelocity gravityThisFrame * Time.deltaTime; // 再处理跳跃 if (hasBufferedJump withinCoyoteTime) { float jumpVelocity Mathf.Sqrt(2f * Mathf.Abs(gravity) * jumpHeight); verticalVelocity jumpVelocity; lastJumpPressedTime -100f; lastGroundedTime -100f; } // 松开跳跃键后提前截断跳跃高度 if (jumpReleased verticalVelocity 0f) { verticalVelocity * jumpCutMultiplier; } } }4.2 代码逻辑说明这份代码有几个关键选择使用Physics.SphereCast而不是CharacterController.isGrounded。因为CharacterController的isGrounded依赖内部物理状态在快速跑动和边缘下落时容易出现“地面状态延迟”。自己用球体向下扫描可以为跳跃缓冲和土狼时间提供准确的时间起点。用Time.time记录输入时刻。跳跃缓冲的本质是“输入发生时先记下时间等条件满足时再判断”所以输入和落地要分开记录。重力公式用高度反推初速度。这样调整jumpHeight时看到的实际跳跃高度更符合直觉。fallMultiplier让角色下落更快。这不是物理必需而是手感需要。下落比上升快动作会更利落也是动作游戏常见做法。jumpCutMultiplier实现轻点跳跃。当玩家在上升过程中松手直接削减垂直速度角色会在更低的高度开始下落。5. 扩展把普通跳跃升级成 TTF2 式跑酷移动5.1 用状态机管理移动能力单纯一个跳跃脚本很难支撑墙跑、二段跳、滑铲这类组合操作。更好的做法是给角色定义一个移动状态。// 文件路径Assets/Scripts/Player/MoveState.cs public enum MoveState { Grounded, Jumping, Airborne, WallRunning, Sliding, Mantling }然后在一个统一的MovementStateMachine里管理状态切换。比如Grounded 跳跃输入 土狼时间内 → Jumping Jumping 碰墙 空中 → WallRunning WallRunning 无墙 垂直速度为负 → Airborne Airborne 落地检测 → Grounded这样写的好处是每个能力只关心自己的进入条件和退出条件。跳跃脚本不再需要关心“现在是不是在墙跑”它只需要在Grounded或Airborne状态里做正确的事。5.2 墙跑核心逻辑示例很多人以为墙跑就是“碰到墙自动贴上去”其实墙跑的本质是在空中且靠近墙面时把重力的作用方向重映射到墙面平面上让角色沿墙滑动。下面是一段演示墙跑思路的简化代码不能直接覆盖你的完整移动系统但能说明核心逻辑// 文件路径Assets/Scripts/Player/WallRunController.cs using UnityEngine; [RequireComponent(typeof(CharacterController))] public class WallRunController : MonoBehaviour { [SerializeField] private float wallCheckDistance 1.2f; [SerializeField] private float wallRunSpeed 6f; [SerializeField] private float slideDownSpeed 0.5f; [SerializeField] private LayerMask wallLayer; private CharacterController controller; private PlayerJumpController player; private Vector3 wallVelocity; public bool IsWallRunning { get; private set; } public Vector3 WallNormal { get; private set; } private void Awake() { controller GetComponentCharacterController(); player GetComponentPlayerJumpController(); } private void Update() { float horizontal Input.GetAxisRaw(Horizontal); float vertical Input.GetAxisRaw(Vertical); Vector3 inputDir (transform.right * horizontal transform.forward * vertical).normalized; bool airborne !player.IsGrounded; if (airborne Physics.Raycast(transform.position, transform.right, out RaycastHit hit, wallCheckDistance, wallLayer)) { WallNormal hit.normal; IsWallRunning true; // 沿墙面方向移动而不是直接朝墙里顶 Vector3 wallForward Vector3.Cross(WallNormal, Vector3.up).normalized; Vector3 moveOnWall Vector3.ProjectOnPlane(inputDir, WallNormal).normalized; wallVelocity moveOnWall * wallRunSpeed Vector3.down * slideDownSpeed; controller.Move(wallVelocity * Time.deltaTime); } else { IsWallRunning false; WallNormal Vector3.zero; } } }这份代码的核心是Vector3.ProjectOnPlane。它把玩家的移动输入投影到墙面平面上避免角色往墙里挤。墙跑时仍然有一个向下的小速度所以角色会沿着墙慢慢滑落也方便玩家控制“什么时候离开墙面”。5.3 为什么墙跑能改变跳跃手感普通跳跃的手感来自“起跳-上升-下落”三个阶段的节奏控制。墙跑本质上是在空中增加了一个“中间态”玩家不再只能被动地等落地而是可以主动选择什么时候脱离墙面、朝哪个方向继续飞。从代码角度墙跑对跳跃系统的最大影响是空中速度不再只由重力决定还要叠加墙面方向的速度。这会让状态机的切换条件变复杂所以建议先跑通普通跳跃再引入墙跑。否则你可能同时面对“跳不起来”“墙跑粘住”“落地抖动”三个问题很难定位。6. 运行验证与手感量化6.1 运行步骤打开刚才搭好的场景。点击 Play。按 W/A/S/D 移动角色。按空格键跳跃。在落点前约 0.1 秒按下空格观察是否还能起跳。从平台边缘走出去离开地面后大约 0.1 秒内按空格观察是否还能起跳。按住空格起跳然后在上升途中松开空格观察是否比满跳矮。每一步都需要记录现象。判断标准不用太复杂角色每一帧的反馈都应该和玩家预期一致。如果出现“按了没反应”或“跳得太飘”再进入参数调试。6.2 用调试脚本观察状态手感问题光靠眼睛看不够最好给角色加一个调试脚本打印关键状态。// 文件路径Assets/Scripts/Debug/JumpDebugger.cs using UnityEngine; public class JumpDebugger : MonoBehaviour { [SerializeField] private PlayerJumpController player; private void Awake() { if (player null) player FindObjectOfTypePlayerJumpController(); } private void Update() { if (Input.GetButtonDown(Jump)) Debug.Log($[JumpDebugger] jump pressed, time{Time.time:F3}); if (Input.GetButtonUp(Jump)) Debug.Log($[JumpDebugger] jump released, time{Time.time:F3}); if (Time.frameCount % 60 0) Debug.Log($[JumpDebugger] grounded{player.IsGrounded}, ver{player.VerticalVelocity:F2}); } }正式项目里不推荐在每帧FindObjectOfType但调试脚本无所谓。日志主要用来回答三个问题跳跃输入是否真的被代码收到了起跳那一帧grounded是不是 true松开跳跃键时VerticalVelocity是否立即被削减如果日志显示输入收到但角色没跳优先查地面检测和 Layer 设置。如果日志显示跳跃事件没触发优先查输入映射。6.3 判断标准检查项预期现象失败时的常见原因跳跃高度角色最高点接近jumpHeight设定值重力积分顺序错误或fallMultiplier过大跳跃缓冲落地前 0.1 秒按空格落地瞬间仍能起跳jumpBufferTime太短或输入时间被覆盖土狼时间走出平台边缘后 0.1 秒内按空格仍能起跳lastGroundedTime在离开地面时没被保留可变跳跃高度快速点按空格比长按空格跳得矮jumpReleased分支没生效落地状态grounded在地面时稳定为 truePhysics.SphereCast起始位置与碰撞体底部不匹配实际调参时不要一次只改一个值。建议准备一份参数预设表每次只改跳跃高度记录手感再只改缓冲时间记录手感。改完几轮后统一对比比凭感觉乱调效率更高。7. 常见问题与排查思路问题现象可能原因排查方式解决方案按空格完全没反应输入映射未配置或脚本未挂载查看 Console 是否有报错检查 Input Manager 中 Jump 轴重新绑定空格键或确认角色身上有 PlayerJumpController落地后立刻再跳无效CharacterController.isGrounded有帧延迟打印 grounded 状态观察落地帧数改用Physics.SphereCast自建地面检测跳跃高度忽高忽低地面检测和跳跃判定不在同一帧观察Time.time与 grounded 输出统一使用Time.time记录输入时刻轻点跳跃也跳得老高没有实现可变跳跃高度检查GetButtonUp分支是否进入在上升阶段乘以jumpCutMultiplier角色下落太慢手感很飘fallMultiplier太小或无效打印VerticalVelocity下落阶段数值提高fallMultiplier通常 1.4 到 2.0 之间根据项目手感调整走出平台边缘不能跳土狼时间没生效检查lastGroundedTime是否在离开地面时被重置确保lastGroundedTime Time.time只在 grounded 时更新墙跑时贴住墙面无法离开没有退出墙跑的条件检查墙跑循环里的else分支增加墙上速度衰减、持续时间上限或输入方向约束动画看起来像滑冰动画状态机和移动速度参数不同步打印 Animator 参数与移动速度把HorizontalVelocity.magnitude映射到 Animator 的移动速度参数排查顺序建议是先看输入再看地面检测再看速度计算最后看动画。80% 的“跳跃手感怪”问题都出在前两步。8. 最佳实践与工程建议8.1 代码组织把输入、状态、能力分开不要把所有逻辑塞进一个Update。至少分成三层输入层读取按键事件只负责把“是否按下”传给状态层。状态层根据当前状态和输入决定能不能跳跃、能不能墙跑。执行层计算速度、调用CharacterController.Move。这样做的最大收益是后续加二段跳、滑铲、冲刺时不需要重写跳跃代码只需要在状态机里新增能力和过渡条件。8.2 参数管理用脚本对象保存预设跳跃参数很敏感策划同事可能每天都要改。不要把它们埋在 MonoBehaviour 里建议用 ScriptableObject 做参数组预设。// 文件路径Assets/Scripts/Settings/JumpSettings.cs using UnityEngine; [CreateAssetMenu(fileName JumpSettings, menuName Movement/Jump Settings)] public class JumpSettings : ScriptableObject { public float jumpHeight 1.5f; public float jumpBufferTime 0.15f; public float coyoteTime 0.1f; public float jumpCutMultiplier 0.4f; public float fallMultiplier 1.6f; }然后在角色控制器里引用同一个跳跃参数对象。这样不同角色可以共用一套预设也可以各自覆盖便于回归对比。8.3 自动化测试与版本控制跳跃系统适合写 PlayMode 测试。Unity Test Runner 的 PlayMode 测试里可以模拟输入事件验证“跳跃缓冲是否生效”。虽然这比普通单元测试麻烦但值得对jumpBufferTime和coyoteTime做覆盖。每次调整参数之前在 Git 里要么保存一个旧参数快照要么给脚本对象做备份。手感调试很容易陷入“改两小时最后觉得第一版最好”的情况能回滚会省很多时间。8.4 性能与安全地面检测使用Physics.SphereCast时一定要限制 LayerMask。一个项目里可能有地形、玩家、NPC、特效碰撞体。如果地面检测碰到所有碰撞体角色可能站在敌人头顶上也能起跳或者在通过触发器时错误判定地面。生产环境改动前记住三条备份场景和代码用最小场景验证新物理参数保持小步提交每个可运行的中间状态都留一个存档位置。9. 总结跳跃问题的答案回到开头那个问题“我也要跳吗”在 TTF2 的场景里玩家会有这种疑问往往是剧情演出与操作提示重叠的时刻。但从技术角度看真正重要的不是“玩家该不该跳”而是“当玩家终于决定跳的时候系统能不能给出稳定、自然、符合预期的反馈”。跳跃系统不是一堆魔法参数而是一条完整链路输入有缓冲离开地面有宽容时间轻重按有区分落地状态用可靠检测重建动画状态和物理速度保持一致。把这条链路跑通之后你会明显感觉到角色不再是“撞到跳跃键才动”而是“玩家想让它动它就动”。建议下一步先做两件事在本文示例基础上加一个二段跳在空中且没有跳跃状态时允许再跳一次。把地面检测从Physics.SphereCast扩展成“地面法线”检测为斜坡跳跃做准备。二段跳会让你更清楚“状态机”的必要性斜坡检测则能暴露地面判定精度问题。做完这两个扩展你对动作游戏中跳跃系统的理解会比单纯抄一个控制器深入得多。