简介：这是一份面向Unity初学者与课程设计学生的期末跑酷游戏完整工程，适合需要提交大作业、练习2D横版玩法或参考角色控制逻辑的开发者。项目实现角色上下左右移动、J键发射子弹、K键跳跃，并限定只有站在跳板上才能起跳；玩家可拾取能量包累计分数，一旦从白色跳板掉落便失去跳跃能力并判定游戏结束，同时配有音效反馈，整体玩法闭环完整。压缩包共9119个文件，约304MB，包含829个meta、480个bin、372个dll、296个asset、275个png、44个mp3、42个anim、38个controller及9个cs脚本等，覆盖场景资源、动画控制器、音频素材与依赖库，目录结构保留完整工程形态。目前已有760人学习下载，可直接在Unity中打开运行，便于对照脚本理解跳跃判定、子弹发射与分数统计的实现思路，也可在此基础上替换美术与音效，快速改造成自己的期末作品。
1. 从零拆解一个跑酷Demo：J键射击、K键跳跃、跳板限制与能量包计分怎么串起来
很多人做期末作业时，第一反应是去搜一个完整项目改改交差，结果打开工程发现脚本挂得乱七八糟，改一个键位就崩三个功能。其实这类跑酷Demo的核心逻辑并不复杂：玩家沿赛道自动前进，按K跳跃，按J发射子弹，只有站在跳板上才能起跳，吃到能量包加分，全程配好音效。听起来像五件事，拆开看就是三套系统——输入与移动、碰撞与状态判定、计分与反馈。适合刚学完Unity基础、要交期末作业但不知道从哪下手的人，也适合想快速搭一个可玩原型验证手感的开发者。下面按实际搭建顺序讲，每一步都能直接抄。
2. 角色控制与双键输入：CharacterController和Rigidbody到底选哪个
2.1 跑酷移动的两种实现路线与选型理由
跑酷游戏的角色移动，常见做法有两种：用CharacterController组件手动写位移，或者用Rigidbody交给物理引擎。这两条路在期末作业场景下差别很大。
CharacterController的好处是控制精确，不受物理引擎的摩擦力、重力抖动影响，跳跃高度可以完全由代码决定，不会出现“明明设了跳跃力但角色越跳越低”的玄学问题。缺点是它不自动处理碰撞反弹，子弹打中障碍物需要自己写检测。Rigidbody的好处是物理交互自然，子弹碰撞、能量包触发都能直接用OnCollisionEnter和OnTriggerEnter，缺点是角色移动容易出现微小滑动，跳跃落地时可能因为物理材质弹一下。
我一般会这样选：如果赛道是固定的直线或简单弯道，角色用CharacterController，子弹和能量包用触发器检测；如果赛道有斜坡、弹簧、可推动的箱子，角色用Rigidbody更省事。期末作业通常赛道不复杂，推荐CharacterController方案，代码可控，调试成本低。
选好之后，场景里建一个胶囊体当玩家，挂上CharacterController，再建一个空物体当“子弹生成点”，放在角色前方偏上的位置。赛道用Cube拉长拼接，跳板用不同颜色的Cube标记，能量包用Sphere加触发器。
2.2 用K键跳跃和J键射击的最小代码
先写输入处理。Unity的旧输入系统用Input.GetKeyDown就够了，不需要额外配置。新建脚本PlayerController.cs：
using UnityEngine; public class PlayerController : MonoBehaviour { public float forwardSpeed = 8f; // 自动前进速度 public float jumpHeight = 2.5f; // 跳跃高度（米） public float gravity = -20f; // 自定义重力，比默认-9.81更跟手 public GameObject bulletPrefab; // 子弹预制体 public Transform firePoint; // 子弹生成位置 public float fireCooldown = 0.25f; // 射击冷却，防止一帧多发 private CharacterController controller; private Vector3 velocity; private float lastFireTime = 0f; private bool isOnJumpPad = false; // 是否站在跳板上 void Start() { controller = GetComponent<CharacterController>(); } void Update() { // 自动前进，Z轴正方向 Vector3 move = Vector3.forward * forwardSpeed; // K键跳跃，且必须在跳板上 if (Input.GetKeyDown(KeyCode.K) && controller.isGrounded && isOnJumpPad) { velocity.y = Mathf.Sqrt(jumpHeight * -2f * gravity); } // J键射击，带冷却 if (Input.GetKeyDown(KeyCode.J) && Time.time - lastFireTime > fireCooldown) { Instantiate(bulletPrefab, firePoint.position, firePoint.rotation); lastFireTime = Time.time; } // 重力累积 velocity.y += gravity * Time.deltaTime; controller.Move((move + velocity) * Time.deltaTime); } // 跳板触发器会调用这个方法来标记状态 public void SetOnJumpPad(bool state) { isOnJumpPad = state; } }这段代码的逻辑说明：forwardSpeed控制角色每秒前进多少米，跑酷游戏一般设在6到10之间，太低没速度感，太高来不及反应。jumpHeight用米做单位，通过物理公式v = sqrt(2 * g * h)反推初速度，这样设2.5米就是实打实跳2.5米高。gravity设成-20而不是默认的-9.81，是因为跑酷游戏需要更快的下落手感，落地不拖沓。fireCooldown防止玩家按住J键时每帧生成子弹，0.25秒一发比较合适。
isOnJumpPad这个布尔值是关键。它默认false，只有跳板的触发器脚本把它设为true时，K键才会生效。这样“只有在跳板上才可以跳跃”的规则就落地了。
2.3 跳板触发器与状态标记的绑定
跳板本身是一个带BoxCollider的Cube，勾选Is Trigger。新建脚本JumpPad.cs：
using UnityEngine; public class JumpPad : MonoBehaviour { private void OnTriggerEnter(Collider other) { // 检测进入的是不是玩家 PlayerController player = other.GetComponent<PlayerController>(); if (player != null) { player.SetOnJumpPad(true); } } private void OnTriggerExit(Collider other) { PlayerController player = other.GetComponent<PlayerController>(); if (player != null) { player.SetOnJumpPad(false); } } }逻辑说明：OnTriggerEnter在玩家进入跳板范围时触发，把isOnJumpPad设为true；OnTriggerExit在离开时设回false。这里有个容易翻车的点——如果跳板触发器的高度太矮，玩家可能还没按K就已经滑出去了，导致“明明站在跳板上却跳不起来”。建议跳板触发器的Y轴厚度至少0.5米，并且比视觉模型稍微大一圈。
参数方面，跳板的BoxCollider尺寸建议设为(2, 0.5, 2)，覆盖玩家可能站立的区域。如果赛道宽度是3米，跳板宽度2米刚好留出边缘容错。
3. 子弹、能量包与计分：碰撞检测和UI更新的完整链路
3.1 子弹预制体的碰撞与自动销毁
子弹的逻辑很简单：向前飞，碰到东西就消失，如果是敌人就加分或触发效果。新建Bullet.cs：
using UnityEngine; public class Bullet : MonoBehaviour { public float speed = 20f; // 子弹飞行速度 public float lifeTime = 2f; // 超时自动销毁，防止内存泄漏 void Start() { Destroy(gameObject, lifeTime); } void Update() { transform.Translate(Vector3.forward * speed * Time.deltaTime); } private void OnTriggerEnter(Collider other) { // 碰到敌人或障碍物就销毁自己 if (other.CompareTag("Enemy") || other.CompareTag("Obstacle")) { Destroy(gameObject); } } }逻辑说明：speed设20，比角色前进速度快很多，保证子弹能打到前方目标。lifeTime设2秒，子弹飞出去2秒后自动销毁，避免场景里堆积大量看不见的子弹拖慢帧率。OnTriggerEnter检测标签为Enemy或Obstacle的物体，碰到就销毁。注意子弹预制体需要挂Rigidbody（勾选Is Kinematic）和SphereCollider（勾选Is Trigger），否则触发器不生效。
子弹预制体的制作步骤：在场景里建一个Sphere，缩放成(0.2, 0.2, 0.2)，挂上Bullet.cs，加Rigidbody组件并把Is Kinematic打勾，加SphereCollider并把Is Trigger打勾，拖到Project窗口变成预制体，然后从场景里删掉。最后把预制体拖到玩家脚本的bulletPrefab字段上。
3.2 能量包计分与UI实时刷新
能量包是一个带触发器的Sphere，玩家碰到就加分并销毁自己。新建EnergyPack.cs：
using UnityEngine; public class EnergyPack : MonoBehaviour { public int scoreValue = 10; // 每个能量包的分值 private void OnTriggerEnter(Collider other) { if (other.CompareTag("Player")) { // 通知计分管理器加分 ScoreManager.Instance.AddScore(scoreValue); Destroy(gameObject); } } }逻辑说明：scoreValue默认10分，可以根据能量包稀有程度调整，比如普通包10分、金色包50分。OnTriggerEnter检测玩家标签，调用ScoreManager的单例方法加分，然后销毁自己。这里用单例是为了避免每个能量包都去FindObject找UI文本，性能更好。
计分管理器ScoreManager.cs：
using UnityEngine; using UnityEngine.UI; public class ScoreManager : MonoBehaviour { public static ScoreManager Instance; // 单例 public Text scoreText; // UI文本引用 private int currentScore = 0; void Awake() { Instance = this; } public void AddScore(int amount) { currentScore += amount; scoreText.text = "分数: " + currentScore; } }逻辑说明：Awake里把Instance设为自己，保证全局只有一个计分管理器。AddScore累加分数并刷新UI文本。UI用Unity内置的Text组件（旧版）或TextMeshPro都可以，期末作业用内置Text更省事，不需要额外导入包。把ScoreManager挂在一个空物体上，把UI Text拖到scoreText字段。
能量包的碰撞设置和子弹类似：挂SphereCollider并勾选Is Trigger，标签设为EnergyPack（可选），玩家标签设为Player。注意玩家的胶囊体默认标签是Untagged，要手动改成Player，否则触发器检测不到。
3.3 音效接入：AudioSource和AudioClip的最简配置
音效分三种：跳跃音效、射击音效、吃能量包音效。最简做法是在玩家身上挂一个AudioSource，在对应代码位置调用PlayOneShot。
修改PlayerController.cs，加两个字段和两行调用：
public AudioClip jumpClip; // 跳跃音效 public AudioClip fireClip; // 射击音效 private AudioSource audioSource; void Start() { controller = GetComponent<CharacterController>(); audioSource = GetComponent<AudioSource>(); } // 在跳跃代码块里加： audioSource.PlayOneShot(jumpClip); // 在射击代码块里加： audioSource.PlayOneShot(fireClip);能量包音效则在EnergyPack.cs里处理，但能量包自己被销毁了，声音会断。常见做法是把音效播放交给ScoreManager或者一个专门的AudioManager。简单起见，在ScoreManager里加一个AudioSource和AudioClip，AddScore时播放：
public AudioClip scoreClip; private AudioSource audioSource; void Awake() { Instance = this; audioSource = GetComponent<AudioSource>(); } public void AddScore(int amount) { currentScore += amount; scoreText.text = "分数: " + currentScore; audioSource.PlayOneShot(scoreClip); }参数说明：PlayOneShot适合短音效，不会打断正在播放的其他声音。音量在AudioSource的Volume字段调，建议设0.5到0.8，太大会盖过背景音乐。音效文件格式用wav或mp3都行，导入后把Load Type设为Decompress On Load，短音效这样加载最快。
4. 避坑与排查：跑酷Demo最常见的五个翻车现场
4.1 按K跳不起来，但角色确实站在跳板上
现象：玩家明明在跳板范围内，按K没反应。原因通常是跳板的触发器没有正确标记玩家，或者isOnJumpPad被其他触发器意外重置。排查步骤：先在JumpPad.cs的OnTriggerEnter里加Debug.Log("进入跳板")，运行看控制台有没有输出。如果没有，检查玩家标签是不是Player，跳板的Is Trigger有没有勾选。如果有输出但跳跃仍无效，检查玩家身上是不是挂了多个碰撞体，导致OnTriggerExit被提前触发。解决：确保玩家只有一个CharacterController，跳板触发器厚度至少0.5米。
4.2 子弹打出去不消失，场景越来越卡
现象：射击几十次后帧率明显下降。原因是子弹没有碰撞检测或没有超时销毁。排查：选中子弹预制体，确认挂了Rigidbody且Is Kinematic打勾，挂了Collider且Is Trigger打勾。如果都正常，检查子弹的标签和障碍物标签是否匹配。解决：Bullet.cs里的lifeTime一定要设，建议1.5到2秒。另外子弹速度不要超过30，太快可能穿过薄碰撞体，物理引擎来不及检测。
4.3 能量包吃了不加分，UI文本也不变
现象：玩家穿过能量包，能量包消失了但分数没动。原因通常是ScoreManager.Instance为空，或者UI Text没有正确赋值。排查：在AddScore方法第一行加Debug.Log("加分: " + amount)，看有没有输出。如果有输出但UI不变，检查scoreText字段是不是空的。如果连输出都没有，检查玩家的标签是不是Player，能量包的Is Trigger有没有勾选。解决：把ScoreManager挂到一个空物体上，确保场景里只有一个。UI Text拖拽赋值后，运行前再确认一次引用没丢。
4.4 音效播放一次就再也不响了
现象：第一次跳跃有声音，后面跳跃都没声音。原因是AudioSource被禁用或者PlayOneShot被其他逻辑打断。排查：检查AudioSource的Play On Awake有没有勾选，如果勾了且没有AudioClip，可能会静音。解决：把Play On Awake取消勾选，所有音效都用PlayOneShot手动触发。另外确认AudioListener在场景里只有一个，通常在Main Camera上，多一个会报错。
4.5 角色自动前进时穿墙或掉出赛道
现象：角色跑着跑着穿过障碍物掉下去了。原因是CharacterController的Move方法不处理碰撞反弹，如果速度太快或障碍物太薄，会直接穿过去。排查：把forwardSpeed临时降到2，看是否还穿墙。如果降速后正常，说明是速度问题。解决：障碍物碰撞体厚度至少0.5米，forwardSpeed不超过12。另外在赛道两侧加隐形墙，用空物体加BoxCollider就行，防止角色跑偏掉下去。
5. 进阶技巧：用对象池优化子弹生成和音效复用
期末作业跑通之后，如果想让手感更接近商业游戏，有两个方向可以深挖：子弹对象池和音效复用。
子弹对象池的思路是：不再每次射击都Instantiate和Destroy，而是预先创建20个子弹，全部设为非激活状态。射击时从池里取一个激活，碰到东西后不销毁，而是设回非激活状态等待下次使用。这样做的好处是避免频繁的内存分配和垃圾回收，射击手感更稳定。实现上新建BulletPool.cs：
using System.Collections.Generic; using UnityEngine; public class BulletPool : MonoBehaviour { public static BulletPool Instance; public GameObject bulletPrefab; public int poolSize = 20; private Queue<GameObject> pool = new Queue<GameObject>(); void Awake() { Instance = this; for (int i = 0; i < poolSize; i++) { GameObject bullet = Instantiate(bulletPrefab); bullet.SetActive(false); pool.Enqueue(bullet); } } public GameObject GetBullet() { if (pool.Count > 0) { GameObject bullet = pool.Dequeue(); bullet.SetActive(true); return bullet; } // 池空了就新建一个，保证射击不中断 return Instantiate(bulletPrefab); } public void ReturnBullet(GameObject bullet) { bullet.SetActive(false); pool.Enqueue(bullet); } }逻辑说明：Awake里预创建20个子弹，全部设为非激活并放入队列。GetBullet从队列取出一个激活返回，池空时兜底新建。ReturnBullet把子弹设回非激活并放回队列。Bullet.cs里的Destroy要改成BulletPool.Instance.ReturnBullet(gameObject)，超时逻辑也要相应调整，不能直接销毁。
音效复用则是把AudioSource集中管理。如果每个能量包都挂AudioSource，场景里会有几十个音频源，性能开销大。做法是在ScoreManager或专门的AudioManager上挂一个AudioSource，所有音效都通过它播放。PlayOneShot支持同时播放多个音效，不会互相打断。参数上，AudioSource的Spatial Blend设为0（2D音效），Volume设0.7，Priority设128默认即可。
验证方法：在Profiler窗口看GC Alloc，如果每次射击都有几百字节的分配，说明对象池没生效。优化后应该接近0。音效方面，在Scene视图里看AudioSource图标数量，集中管理后应该只有1到2个。
我自己踩过的坑是：对象池的子弹回收时忘了重置位置和旋转，导致下一发子弹从上一发的位置飞出去。血泪经验是ReturnBullet里一定要把transform.position和transform.rotation重置，或者GetBullet时重新赋值。这个坑不写出来，很多人要调半天才发现子弹“漂移”了。希望帮到你。
本文还有配套的精品资源，点击获取
