简介这是面向Unity学习者的期末跑酷游戏完整工程包适合需要完成课程设计或练习2D游戏开发的学生参考。压缩包共9119个文件以asset、prefab、anim、controller、cs等Unity工程文件为主配合mp3、wav音效素材、png图片素材及dll运行库等整体大小约304MB文件类型齐全可直接在Unity中打开查看项目结构与逻辑实现。角色支持上下左右移动按J键发射子弹、K键跳跃但只有在跳板上才能起跳落入白色跳板区域后无法跳跃会导致游戏结束场景中还设有能量包吃掉后可统计分数操作简单但机制规则明确并包含完整音效反馈。该资源已有760人学习下载适合作为期末作业参考便于理解跑酷玩法、跳跃判定、计分系统与音效触发在Unity中的具体实现方式。1. 期末跑酷项目最容易被低估的一关把“规则”变成物理逻辑期末拿到一个Unity跑酷选题要求不多J发射子弹、K跳跃、只有在跳板上才可以跳跃、吃能量包统计分数、有音效。看着像是十分钟就能拼完的小demo实际大多数人的第一次演示都会翻车要么在跳板上按K没反应要么子弹穿透目标要么分数加了但UI纹丝不动。这个项目真正难的点不在跑酷而在“规则怎么落地”跳跃限制靠触发器还是碰撞器、子弹用不用对象池、计分和UI怎么绑定。这篇内容就是按这条线拆开从最小场景搭到答辩前的手感调参照着走能复现踩过的坑也会单独列出来。2. 用Rigidbody搭出最小可跑场景先把角色跑起来再加跳板限制2.1 场景物件与组件清单搭建阶段不用急着写复杂脚本先把场景里的物件和组件关系理清。这个项目的对象不多按下面这张表摆好后面所有逻辑都挂在对应组件上。物件组件关键设置作用地面 PlaneMesh ColliderScale 放大到 10x1x10提供物理平面角色 CubeRigidbody Box ColliderUse Gravity 开启冻结 Rotation X/Z玩家控制的物理体跳板 CubeBox Collider勾选 Is Trigger放在跑道路线上判定可跳跃区域能量包 SphereSphere Collider勾选 Is Trigger带旋转和加分脚本统计分数的目标敌人 CubeBox Collider独立颜色标记 Enemy 层子弹射击目标目标点 CubeBox Collider放在跑道终点标记结束位置这里最容易被忽略的是Rigidbody的Constraints设置。跑酷角色不需要翻倒但如果不冻结Rotation X/Z角色撞到障碍物边缘就会像保龄球一样滚出去看起来非常不专业。做法是在Inspector里选择Freeze Rotation X和ZPosition Z也可以冻结让角色只能沿着跑道前进减少物理扰动。2.2 最简单的自动向前移动脚本常见做法是用Rigidbody驱动移动而不是用Transform。Translate直接改坐标会让碰撞失效速度一快子弹和角色就会穿模。我给角色挂一个Runner脚本让它自动沿Z轴前进using UnityEngine; public class Runner : MonoBehaviour { public float speed 5f; // 前进速度答辩前按手感调 private Rigidbody rb; void Start() { rb GetComponentRigidbody(); rb.constraints RigidbodyConstraints.FreezeRotationX | RigidbodyConstraints.FreezeRotationZ | RigidbodyConstraints.FreezePositionZ; } void FixedUpdate() { // 只保留Z轴速度角色不会因为碰撞而停下来 Vector3 velocity rb.velocity; velocity.z speed; rb.velocity velocity; } }逻辑说明FixedUpdate在物理帧里执行专门用来处理Rigidbody运动和物理碰撞。每帧把z方向速度强制设回speed防止跳板和敌人碰撞把速度带偏。冻结PositionZ可能看起来和赋值z速度矛盾但这里没有横向移动需求x和y仍然靠物理模拟z只是被脚本锁定。参数说明speed建议在4到6之间。小于4跑起来像散步大于6跳跃落点控制不住对手残党不友好。这个脚本只解决自动前进跳跃和子弹逻辑放在后面的独立脚本里避免一个类里塞太多职责。2.3 跳板检测为什么用触发器而不是碰撞器“只有在跳板上才可以跳跃”是这个项目最关键的一条规则。错误的做法是把跳板做成普通Collider让角色跳到立方体顶面上。初中物理课告诉我们角色跳上去后Collider会互相挤压物理引擎会产生弹跳和滑块效果角色会不停抖动。正确做法是把跳板设为Is Trigger表示它是一个区域而不是实体墙。角色经过时触发事件脚本里维护一个canJump布尔值using UnityEngine; public class JumpPadDetector : MonoBehaviour { private bool canJump; public bool CanJump { get { return canJump; } } void OnTriggerEnter(Collider other) { if (other.CompareTag(Player)) { canJump true; } } void OnTriggerExit(Collider other) { if (other.CompareTag(Player)) { canJump false; } } }逻辑说明OnTriggerEnter进入跳板区域时置trueOnTriggerExit离开时置false。这里有一个细节触发器会在物理帧里多次触发Enter/Exit但这是幂等的不会出问题。麻烦的是如果角色站在两个相邻跳板之间Exit和Enter可能交错出现短暂的false窗口。解决办法是在项目里把跳板间距拉开一点至少留出角色直径的距离。参数说明跳板触发器尺寸不要做得比跳板模型还大。新手习惯把Box Collider拉大一点防止漏检结果角色站在跳板半米外就能起跳看起来非常假。把Collider尺寸调成和跳板模型一致宁可漏一点不要宽一点。3. J发射子弹与K跳跃的输入处理按键冲突、对象池和碰撞检测3.1 为什么Update里写的输入会“失灵”标题里两个操作是J发射子弹、K跳跃很多新手会写成一个if else链void Update() { if (Input.GetKeyDown(KeyCode.J)) { Shoot(); } else if (Input.GetKeyDown(KeyCode.K) canJump) { Jump(); } }这段代码在理论上没错但实际演示时你会发现如果你同时按下J和K只有J生效。因为else if在第一个条件满足后直接跳过第二个判断。你可能觉得同时按的概率很低但紧张答辩时手指一抖就按出来了。更稳妥的写法是拆成两个独立的ifvoid Update() { if (Input.GetKeyDown(KeyCode.J)) { Shoot(); } if (Input.GetKeyDown(KeyCode.K) canJump) { Jump(); } }逻辑说明两个if互不干扰同一帧按两个键两个操作都会执行。这里还要提一个点Input.GetKeyDown检测的是“按下”的那一帧不是“按住”。K跳跃应该用GetKeyDown否则按住K会不停起跳J如果只想要单发也用GetKeyDown想要连续射击则改用GetKey加冷却时间。参数说明Input.GetKey(KeyCode.J)会在按住期间每帧返回true适合做扫射Input.GetKeyDown只在按下瞬间返回一次true适合做单发和跳跃。这个选择直接决定手感和游戏类型别混用。3.2 起跳逻辑先清空Y速度再施力Jump函数的实现也有坑。如果角色落地后Rigidbody的y速度还残留一点负值直接AddForce向上会产生速度叠加跳跃高度忽高忽低。标准做法是先把y速度清零void Jump() { if (!canJump) return; // 清空下落速度保证每次跳跃高度一致 Vector3 velocity rb.velocity; velocity.y 0f; rb.velocity velocity; rb.AddForce(Vector3.up * jumpForce, ForceMode.Impulse); canJump false; // 起跳后立刻消耗跳板状态防止空中二段跳 }逻辑说明跳板只负责给一次起跳资格所以起跳瞬间把canJump置false。如果不置角色在跳板上方滞空时还能再按K起跳等于实现了二段跳违背题目要求。参数说明jumpForce在5到7之间比较合适具体和重力相关。默认Physics.gravity的y是-9.81角色Cube边长1米jumpForce取6时跳跃高度大约0.8到1.2米。太大的话角色会飞出跳板区域太小吃不到高台上的能量包。3.3 子弹对象池为什么不用Instantiate和Destroy题目只要求发射子弹很多人会直接在Shoot里Instantiate一个子弹预制体命中后Destroy。这个做法在期末作品里能跑但存在一个隐患反复创建销毁会让Unity的GC频繁触发演示一段时间后会明显卡顿。Unity游戏优化里最常见的一条就是减少运行时对象分配所以这里用对象池using System.Collections.Generic; using UnityEngine; public class BulletPool : MonoBehaviour { public GameObject bulletPrefab; public int poolSize 10; private QueueGameObject pool new QueueGameObject(); void Start() { for (int i 0; i poolSize; i) { GameObject bullet Instantiate(bulletPrefab); bullet.SetActive(false); pool.Enqueue(bullet); } } public GameObject Get() { if (pool.Count 0) { GameObject bullet Instantiate(bulletPrefab); bullet.SetActive(false); return bullet; } GameObject b pool.Dequeue(); b.SetActive(true); return b; } public void Return(GameObject bullet) { bullet.SetActive(false); pool.Enqueue(bullet); } }逻辑说明Start里预先创建10发子弹放进队列发射时从队首取出激活命中或超时后失活放回队尾。这样整个演示过程只有10个子弹对象不会产生新的内存分配。参数说明poolSize取10够用。如果玩家手速很快每秒打5发10发子弹最多2秒就会打空超出后Get会临时再创建一发作为缓冲不会出问题。不要为了省内存把poolSize设成1子弹回收到再发射会有空窗期看起来像卡壳。子弹本身的碰撞逻辑也要配合池化不能用Destroy而是把自身还给池子public class Bullet : MonoBehaviour { public float lifeTime 2f; private float timer; private BulletPool pool; public void SetPool(BulletPool bulletPool) { pool bulletPool; } void OnEnable() { timer lifeTime; } void Update() { timer - Time.deltaTime; if (timer 0f) { pool.Return(gameObject); } } void OnTriggerEnter(Collider other) { if (other.CompareTag(Enemy)) { pool.Return(gameObject); } } }注意OnTriggerEnter里不要用Destroy否则对象池会越用越少。粒子特效和音效播放都要放在这之前因为它们需要时间表现还没播完就被回收会显得很突兀。3.4 用LayerMask区分射击目标而不是靠Tag场景里既有敌人、能量包也有跳板。如果子弹和所有Trigger都发生碰撞就会误伤害能量包。最常见的做法是判断Tag但Tag在碰撞回调里要遍历字符串效率低且容易写错。更工程化的做法是用LayerMask过滤。先在Inspector里创建Enemy层把敌人丢进该层然后这样写// 只检测Enemy层子弹不会打中能量包和跳板 int enemyMask LayerMask.GetMask(Enemy); void DetectEnemy() { RaycastHit hit; if (Physics.Raycast(transform.position, transform.forward, out hit, 20f, enemyMask)) { // 命中敌人回收子弹并播放音效 } }这里要特别说明LayerMask和RenderingLayerMask的区别。LayerMask是物理碰撞层决定某个物体和谁发生碰撞检测RenderingLayerMask是渲染层控制灯光照射和渲染顺序。跑酷项目里子弹过滤目标用的是LayerMask新手在Inspector里找不到对应选项时别改错地方。4. 能量包计分与UI绑定从OnTriggerEnter到分数刷新的完整链路4.1 分数管理用单例把统计逻辑收拢项目要求“可以吃能量包统计分数”分数是一个全局状态。新手常见的做法是把分数变量挂在玩家身上能量包脚本通过FindObjectOfType去拿玩家身上的分数这样跨对象找引用容易出错。小项目最直接的做法是写一个ScoreManager单例using TMPro; using UnityEngine; public class ScoreManager : MonoBehaviour { public static ScoreManager Instance; public TextMeshProUGUI scoreText; private int score; void Awake() { // 单例赋值保证场景里只有一个计分器 Instance this; } public void AddScore(int value) { score value; scoreText.text 分数: score; } public void ResetScore() { score 0; scoreText.text 分数: 0; } }逻辑说明Awake比Start先执行其他脚本在Start里调用AddScore时Instance已经存在。所有加分操作都走AddScore这一个入口不要直接在能量包脚本里改score字段。这样以后要加“击中敌人加分”或者“到达终点加分”都在同一处收口。参数说明TextMeshProUGUI是TextMeshPro的UI组件。如果你用老的Text命名空间是UnityEngine.UI字段类型改成Text代码略有差异。TMP是新版Unity主推的方案字体清晰度高演示效果更好。4.2 能量包的拾取、旋转和消失反馈能量包作为Trigger角色碰到后触发加分。这个脚本要注意两个点一是防止重复触发二是拾取后的消失动画不能影响分数统计。下面是一份带淡出效果的实现using System.Collections; using UnityEngine; public class EnergyPack : MonoBehaviour { public int scoreValue 10; public float rotateSpeed 120f; void Update() { // 能量包绕自身Y轴旋转让人一眼认出这是可拾取物 transform.Rotate(Vector3.up, rotateSpeed * Time.deltaTime, Space.World); } void OnTriggerEnter(Collider other) { if (other.CompareTag(Player)) { ScoreManager.Instance.AddScore(scoreValue); StartCoroutine(PickupAndFade()); } } IEnumerator PickupAndFade() { // 先关闭Collider防止淡出过程中再次触发加分 GetComponentCollider().enabled false; Renderer renderer GetComponentRenderer(); Color color renderer.material.color; // 逐渐消失的视觉效果脚本控制alpha从1降到0 for (float t 0f; t 1f; t Time.deltaTime) { color.a Mathf.Lerp(1f, 0f, t); renderer.material.color color; yield return null; } Destroy(gameObject); } }这里有一个隐藏坑Unity默认的Standard材质shader不支持透明alpha变化。你会发现写了淡出代码物体完全不透明。解决方法是把能量包的材质shader改成Legacy Shaders/Transparent/Diffuse或者使用URP的Lit里勾选Surface Type为Transparent。这也是为什么很多Unity教程在能量包上直接用“缩小消失”而不是变透明因为透明材质在URP下配置更繁琐。如果你不想折腾shader最简单的反馈是把能量包缩放到0transform.localScale Vector3.zero;这个是真实可用的替代方案。期末项目追求效果稳定而不是炫技缩小消失反而更保险。4.3 UI刷新时机别在Update里刷Text分数UI的更新是最容易写出性能问题的位置。有些人为了“实时同步”在Update里不断把score变量赋值给scoreText.textvoid Update() { scoreText.text score.ToString(); }这个写法在期末项目里确实能跑但每帧重建字符串会产生一些不必要的分配。而且这个操作和计分逻辑没有关系它只是让UI看起来“随时最新”。正确的做法是只在AddScore调用时一次性更新这也正是第4.1节代码里的写法。参数说明TMP的SetText比直接赋text属性更高效写成scoreText.SetText(分数: {0}, score)可以减少字符串分配。这个API在Unity 2019之后完全可用老版本可能不支持如果装了TMP都有这个方法。还有一个细节如果场景里还有其他UI比如“游戏结束”面板要让ScoreManager暴露Score属性方便读取而不是把scoreText到处传。代码可以加一个只读属性public int Score { get { return score; } }这样结束画面或者展示统计时都能读到最终分数不会因为显示需求破坏封装。4.4 计分联调顺序从零开始联调时不要先写UI。我的习惯是两步走第一步在控制台打印Debug.Log(Score: score)确认吃能量包后分数确实增加第二步再把scoreText绑定上看UI有没有同步。如果直接一步到位分数没增加时你分不清是Trigger没触发还是UI没刷新。联调时的检查点有三个能量包和玩家是否都加了Collider是否有一方开了IsTrigger玩家Tag是否设置为Player脚本里的CompareTag字符串大小写是否完全一致ScoreManager是否只有一个实例场景中重复挂载会导致Awake里Instance被覆盖5. 跑酷项目高频问题排查跳板、子弹穿透、音效与摄像机避坑清单5.1 K跳跃偶尔失灵跳板Trigger和输入冲突现象角色明明站在跳板上按K却没有反应或者十次里有两次跳不起来。原因通常是两个问题叠加。一是跳跃判断用了else if链同一帧按J和K时只执行了射击二是跳板Trigger只在OnTriggerEnter时置true物理引擎处理触发事件有延迟角色刚踩上跳板的那一两帧canJump还是false。解决把J和K拆成两个独立的if起跳时消耗canJump。另外跳板的IsTrigger必须勾选且确保玩家身上有Rigidbody。没有Rigidbody的物体不会产生Trigger事件这是一个很常见的配置遗漏。5.2 子弹穿透与误伤Collision Detection和LayerMask现象子弹从敌人中间穿过去或者打中能量包把能量包打没了。原因子弹速度15到20时单帧位移可能超过敌人的厚度默认的Discrete碰撞检测会漏判。能量包被打中则说明子弹没有按Layer过滤。解决子弹Rigidbody的Collision Detection改为Continuous Dynamic滚动摩擦和弹力设为0。碰撞过滤统一用LayerMask敌人放Enemy层子弹射接受限的层。注意这里不能用RenderingLayerMask混淆物理碰撞选的是LayerMask那一栏。5.3 音效重叠炸耳朵AudioSource的PlayOneShot技巧现象连按K跳跃音效叠成一片听起来像噪音或者吃了好几个能量包声音完全糊住。原因如果只有一个AudioSource每按一次K就调用Play同一个AudioSource会打断上一次没播完的声音。连续触发时播放频率高音效就会重叠。Unity的AudioSource底层走native audio通道同一个Source同时只处理一个Clip的播放。解决跳跃、射击、吃能量包分别挂独立的AudioSource每个AudioSource只管自己的音效。播放时统一用PlayOneShot而不是Playpublic AudioSource jumpAudio; void Jump() { // PlayOneShot不会反复打断同一个Source的播放适合短音效 jumpAudio.PlayOneShot(jumpClip, 0.6f); }参数说明PlayOneShot有两个参数第一个是AudioClip第二个是音量系数0.6比较适中。如果音效本身已经很大系数可以降到0.3。还要检查场景里是否只有一台摄像机带AudioListener如果有第二台也挂了AudioListener声音会变成双份甚至出现回声效果。5.4 摄像机跟随为什么用LateUpdate而不是Update现象角色跑动时摄像机一卡一卡跳起时摄像机镜头剧烈晃动。原因摄像机跟随写在了Update里而角色移动在FixedUpdate里。Update和FixedUpdate的调用频率不同导致相机在物理结果应用前先采样了旧位置看起来就是崎岖跳动。解决用LateUpdate它会等所有Update和FixedUpdate跑完后再执行拿到的是角色的最终位置。摄像机跟随脚本给一个标准写法using UnityEngine; public class CameraFollow : MonoBehaviour { public Transform target; public Vector3 offset new Vector3(0f, 4f, -8f); public float smoothTime 0.2f; private Vector3 velocity; void LateUpdate() { // 目标位置是角色当前位置加固定偏移 Vector3 targetPos target.position offset; // SmoothDamp让相机有惯性不跟手但看着稳 Vector3 smoothedPos Vector3.SmoothDamp( transform.position, targetPos, ref velocity, smoothTime); transform.position smoothedPos; transform.LookAt(target); } }逻辑说明LateUpdate固定处理相机逻辑SmoothDamp对位置变化做平滑缓冲smoothTime越大相机越慢越稳。这个脚本的效果比直接把相机拖到Player子节点下好因为角色跳起时相机不会被拖着上下颠簸视觉上更接近跑酷游戏。参数说明offset的y取4z取-8相机以一个略高的俯视角度跟着角色。smoothTime取0.2到0.3之间太大会让人觉得角色跑出屏幕太小会显得生硬。5.5 帧率不稳对象池和GC的入门排查现象演示到两分钟时开始一卡一卡操作延迟明显。原因最可能的GC来源是子弹反复Instantiate和Destroy以及UI每帧更新Text。如果还加了粒子特效每帧生成的新粒子也会造成压力。解决子弹全部走对象池UI只在AddScore时刷新。如果用了能量包的Destroy也没关系数量有限。再检查一次Quality Settings里的Shadow设置跑酷这种室外场景阴影质量调中档即可不用开最高演示机一般是集显笔记本。6. 演示前的手感验证与参数定型把期末作品调到能上手6.1 手感参数速查表答辩前一晚不要大改代码只调下面这几个参数。把参考值记下来改一个测一个参数推荐范围调整手感speed4 - 6影响跑速与跳跃落点距离jumpForce5 - 7影响跳跃高度和滞空时间bulletSpeed15 - 25超过25容易穿模rotateSpeed90 - 150能量包转速太高会晕smoothTime0.2 - 0.3摄像机阻尼越大越钝音效音量0.3 - 0.6防止答辩现场炸耳朵6.2 两条跑通验证的基准线我自己的习惯是演示前固定做三个动作站在跳板边缘跳一次在跳板外按十次K确认不会跳对着敌人连发十发子弹看穿透率从跑道头跑到尾吃五个能量包确认分数从0加到50。任何一项失败都不演示先回到对应章节排查。其中子弹穿透的验证最容易造假连续射击时眼睛看不出每一发是否命中。建议在敌人身上挂一个Debug脚本命中时在Console打日志数日志条数和发射数是否一致。这个方法比肉眼看碰撞盒可靠得多。6.3 两行代码的扩展思路如果做完以上功能还有余力最常见也最稳妥的加分项目是加一个“左右换道”的横向输入。把Runner里冻结的PositionX解开在FixedUpdate里读Input.GetAxisRaw(Horizontal)把x轴速度设为转向速度。这个改动不影响跳跃和射击逻辑风险最小。再加一个到达终点时用ScoreManager.Score显示结算面板整个演示流程就完整了。我做这个项目时最大的教训是把得分刷新放在Update里演示到最后期确实开始卡顿。后来改成只在吃能量包的瞬间更新Text才彻底解决。答辩最怕的不是不会写而是走进教室发现角色跳不起来。每跑通一次这五条至少在台上能保证输入不吞、跳板判得准、声音不叠、画面不抖、分数对得上。希望帮到你。本文还有配套的精品资源点击获取