简介基于Unity3D引擎实现的街机游戏‘捕鱼达人’项目面向希望学习Unity游戏开发的小白与进阶学习者。该选题非常适合作为毕业设计、课程设计、大作业或工程实训内容覆盖了从场景搭建、炮台发射、鱼群游动到捕获计分与UI交互的完整街机游戏核心流程。资源压缩包大小约226.9MB目前已有293人浏览学习适合用较短时间了解完整Unity工程项目的组织方式。学习该项目时开发者可以重点体会Unity中C#脚本的组件化设计、碰撞检测与物体管理、动画控制和界面数据刷新等技术点并在理解原有逻辑后自行扩展鱼种、炮台等级或奖励特效。对于初学者而言这是一份能串联Unity基础操作与完整游戏逻辑的实战素材对于有经验的开发者也可作为街机游戏玩法设计与代码结构设计的参考样例。整个项目围绕可玩性、即时反馈与休闲体验进行设计能帮助学习者在实践中提升游戏开发综合能力。1. 捕鱼达人为什么还值得你拆一遍Unity3D 街机项目的典型负载捕鱼达人这类街机游戏看起来只是鱼在游、炮在打、金币在涨真正动手做的时候才发现难点全在瞬时对象管理上同屏几十条鱼各自运动炮弹命中后要播放死亡动画、结算金币、刷新排行榜任何一步放在 Update 里裸奔都会让帧率曲线变成锯齿。更反直觉的是鱼的随机游动反而是最不值钱的部分真正的工程量在对象池、碰撞判定和数值倍率的联动设计上。这篇文章从一个可跑的 Unity3D 项目出发把捕鱼达人的对象生命周期、炮台命中链路、协程与状态机的分工讲透适合做毕设、课程设计或 Unity 2D 游戏入门项目的人照着复现也能帮已经写过 demo 的人梳理清楚工程结构。2. 鱼群生成与对象池先从 Unity3D 的场景管理说起2.1 为什么捕鱼类游戏首先要解决对象生命周期问题捕鱼达人同屏鱼的数量不是静态的。以常见的街机档位为例普通关卡同屏鱼在 2040 条之间如果每隔 0.6 秒生成一条新鱼每条鱼平均存活 812 秒那么一个 120 秒的对局里实例化操作会执行上百次。Instantiate和Destroy在 Unity3D 里不只是创建和销毁 GameObject还会触发 Awake、OnEnable、OnDisable 等生命周期回调频繁调用会带来明显的 GC 压力Android 低端机上尤为明显。这里要先统一认识对象池的目标不是少创建 GameObject而是复用已经创建好的 GameObject。鱼池、子弹池、金币池各自维护自己的队列取出时重置状态回收时隐藏并排队。对捕鱼达人这个项目鱼和子弹的生命周期都很短、单帧内切换频繁是对象池最典型的适用场景。2.2 预设体组织与鱼群分类项目里鱼的类型按分值阶梯设计通常分成 46 个档位每档对应不同的血量、速度和金币产出。预设体建议按Fish_Level01到Fish_Level06命名方便代码里按索引映射。下面是项目里常用的一张配置表做课程设计时可以直接抄。鱼类型分值血量游泳速度生成权重预设体命名小黄鱼112.530Fish_Level01小丑鱼322.025Fish_Level02蝴蝶鱼631.820Fish_Level03河豚1051.515Fish_Level04灯笼鱼2581.28Fish_Level05金鲨100200.82Fish_Level06生成权重的意义是让低分鱼高频出现、高分鱼低频出现配合倍率档位形成以小博大的正反馈。注意血量不直接等于炮弹命中次数它要乘以当前倍率档位再参与伤害计算这部分到第 3 章细说。2.3 对象池核心实现一个能直接用起来的 PoolManager项目里的对象池不搞泛型抽象直接以GameObject为维度写简单直接也更容易让初学者理解。核心代码public class ObjectPool : MonoBehaviour { public GameObject prefab; // 池子里管理的预设体 public int preloadCount 30; // 预热数量提前实例化 private QueueGameObject pool new QueueGameObject(); void Awake() { for (int i 0; i preloadCount; i) { GameObject go Instantiate(prefab); go.SetActive(false); // 默认隐藏进入等待队列 pool.Enqueue(go); } } public GameObject Get(Vector3 pos, Quaternion rot) { GameObject go pool.Count 0 ? pool.Dequeue() : Instantiate(prefab); go.transform.SetPositionAndRotation(pos, rot); go.SetActive(true); // 激活前已经把位置和角度设置好 return go; } public void Return(GameObject go) { go.SetActive(false); // 先隐藏再丢回队列 pool.Enqueue(go); } }这段代码有四个关键点。第一Awake阶段做预热避免游戏开打后第一帧因为实例化卡顿第二Dequeue之后如果池子为空直接Instantiate做兜底保证极端情况下游戏不崩第三SetPositionAndRotation在SetActive(true)之前调用防止对象在旧位置被渲染一帧第四Return方法必须是幂等的也就是说重复回收同一个对象不会报错调用方可以放心在协程里连续回收。真正在项目里使用时我一般会把池子挂在空物体上然后给每个池子指定不同的 prefab。鱼池、子弹池、金币池各挂一个ObjectPool组件暴露在 Inspector 里指定预设体和预热数量这样策划调参数不需要进代码。2.4 生成器与出界回收机制鱼不能只在固定点生成否则玩家摸清规律后游戏就失去随机性了。捕鱼达人的标准做法是地图四周边界都可能刷鱼但鱼要从屏幕外游进来。生成位置在屏幕外 12 个鱼身宽度处游动路径则指向屏幕内某个目标点。public class FishSpawner : MonoBehaviour { public ObjectPool[] fishPools; // 对应不同档位的鱼池 public float spawnInterval 0.6f; // 生成间隔 public Camera gameCamera; IEnumerator SpawnLoop() { while (true) { int levelIndex Random.Range(0, fishPools.Length); ObjectPool pool fishPools[levelIndex]; GameObject fishGO pool.Get(GetSpawnPos(), Quaternion.identity); Fish fish fishGO.GetComponentFish(); fish.Init(GetInsideTarget(), RandomSpeed(levelIndex)); yield return new WaitForSeconds(spawnInterval); } } private Vector2 GetSpawnPos() { // 在屏幕外生成x/y 方向随机选一条边 bool fromX Random.Range(0, 2) 0; float edge Random.Range(0f, 1f) 0.5f ? -0.5f : 1.5f; Vector2 viewportPos fromX ? new Vector2(edge, Random.Range(0f, 1f)) : new Vector2(Random.Range(0f, 1f), edge); return gameCamera.ViewportToWorldPoint(viewportPos); } }玩家视角里鱼是从边上游进来的这就是ViewportToWorldPoint配合edge在 −0.5 到 1.5 之间取值的效果。鱼游出屏幕另一侧后需要由 Fish 自身检测是否出界并回收到池子。常见做法是在Fish.Update里把世界坐标转成视口坐标x 和 y 同时小于 −0.2 或大于 1.2 就触发回收回收前把鱼身上挂的定时器、缓动协程全部停掉。提示回收之前一定要 StopAllCoroutines否则协程会引用已被隐藏的 GameObject产生空引用报错。3. 炮台火力链射线检测、倍率与命中结算3.1 炮台瞄准从屏幕坐标到炮口角度捕鱼达人里炮台固定在屏幕底部中间或者左下角玩家点按屏幕任意位置炮台炮口要平滑转向那个方向。这个逻辑本质上是屏幕坐标 → 世界坐标 → 方向向量 → 四元数插值。public class CannonAim : MonoBehaviour { public Camera gameCamera; public float rotateSpeed 10f; void Update() { Vector3 mouseWorld gameCamera.ScreenToWorldPoint( new Vector3(Input.mousePosition.x, Input.mousePosition.y, 10f)); Vector2 dir mouseWorld - transform.position; float angle Mathf.Atan2(dir.y, dir.x) * Mathf.Rad2Deg; Quaternion targetRot Quaternion.Euler(0, 0, angle); transform.rotation Quaternion.Slerp( transform.rotation, targetRot, rotateSpeed * Time.deltaTime); } }ScreenToWorldPoint的第三个参数是距离摄像机的深度值这里填 10f 是因为游戏场景一般用正交摄像机深度值不影响 2D 平面的坐标结果但不填会得到 (0,0,0)方向向量就完全错掉。Quaternion.Slerp的作用是让炮口转动带阻尼感不是瞬间跳过去街机玩家对这种手感非常敏感。3.2 发射与命中判定射线检测和物理碰撞的分工发射子弹后存在两条判定路径。一是子弹作为物理对象带Rigidbody2D和CircleCollider2D靠碰撞事件检测命中的鱼二是发射瞬间用射线检测鼠标指向的目标鱼子弹只是视觉表现。项目里建议采用射线检测做核心判定原因有两点捕鱼达人里子弹飞行速度很快靠物理碰撞很容易出现子弹穿过鱼但没触发 OnTriggerEnter2D的丢帧问题射线判定则完全依赖发射瞬间的鼠标坐标稳定且可控。public class CannonFire : MonoBehaviour { public ObjectPool bulletPool; public LayerMask fishLayer; public float fireCoolDown 0.25f; public void Fire(float multiplier) { Vector2 aimDir transform.right; // 炮口当前指向 // 射线检测鼠标点中的鱼优先返回最近的 RaycastHit2D hit Physics2D.Raycast( transform.position, aimDir, 30f, fishLayer); GameObject bulletGO bulletPool.Get(transform.position, transform.rotation); Bullet bullet bulletGO.GetComponentBullet(); bullet.SetMultiplier(multiplier); if (hit.collider ! null) { Fish target hit.collider.GetComponentFish(); bullet.SetTarget(target); } else { bullet.SetDirection(aimDir); } } }这里SetTarget和SetDirection是两种子弹行为的抽象。有目标时子弹做追踪没有目标时子弹沿直线飞出并在到达最大射程时回收。fishLayer是专门的碰撞层鱼、炮台、UI 分属不同层射线只检测鱼层避免和场景里的碰撞体互相干扰。碰撞体建议用CircleCollider2D并且 radius 比鱼身实际尺寸小 0.10.2给玩家我明明打中了的容错空间。3.3 倍率与分值结算倍率是捕鱼达人经济系统的核心。当前倍率决定两件事单发子弹消耗的金币数以及命中后获得金币的系数。项目里常用一张配置表串联整个火力链路。倍率档单发消耗伤害系数命中 1 分鱼所得命中 100 分鱼所得1x1111002x2222005x55550010x1010101000注意一个细节命中所得还要乘一个难度系数不同关卡会从 0.8 到 1.2 浮动。这样做的目的是控制单局金币产出总量避免玩家在某一关刷金币刷到数值失衡。3.4 死亡链路的事件解耦一条鱼被子弹命中到结算完成中间要经过扣血、播放死亡动画、掉金币、更新左上角金币数量、刷新连击数。直接把这些逻辑都写在 Fish 类里Fish 就得持有 GameManager、UIController、ScoreManager 的引用类与类之间耦合严重。项目里用 C# 事件把鱼死了这件事广播出去谁关心谁订阅。public class Fish : MonoBehaviour { public event System.ActionFish OnFishDied; public int scoreValue 1; private int currentHp; public void TakeDamage(int damage) { currentHp - damage; if (currentHp 0) { OnFishDied?.Invoke(this); // 广播死亡事件 DieAnimation(); } } private void DieAnimation() { // 播放死亡动画动画事件或协程结束后回收到对象池 StartCoroutine(PlayDeathThenRecycle()); } }GameManager 在生成鱼时订阅OnFishDied在回调里做加分、掉金币播放、检查是否触发特殊奖励。这样 Fish 类完全不知道金币和分数怎么算后续扩展新玩法只需要在订阅方增加逻辑。TakeDamage里的伤害参数由倍数、子弹基础伤害、鱼的防御系数共同决定防御系数可以在 Inspector 里单独暴露给策划调。3.5 常见坑子弹飞行速度与命中判定脱节如果采用追踪子弹一个很容易踩的坑是子弹飞行速度太快每帧移动距离超过鱼碰撞体的直径导致视觉上子弹穿透鱼的身体却没有触发任何回调。射线检测方案没有这个问题因为命中在发射瞬间已经确定子弹只是播放飞行和炸裂的表现。另一个坑是Physics2D.Raycast的起点不能放在炮台中心要放在炮口子物体上否则炮身模型会挡掉射线表现为明明瞄准了鱼却打空。4. 游戏状态控制协程与状态机在捕鱼达人里的分工4.1 用协程描述鱼群的运动时间轴鱼的移动不是简单的直线从 A 到 B。正常的街机捕鱼里鱼会做折线游动、变速游动、偶尔顺时针绕圈逃逸状态还要加速跑向屏幕外。用Update维护一个状态标志位再逐帧判断逻辑会越写越乱。协程更适合描述这种按时间轴逐步执行的行为。public class FishSwim : MonoBehaviour { public float speed 2f; private QueueVector2 pathPoints new QueueVector2(); private int pointIndex; public void InitPath(Vector2[] points) { pathPoints.Clear(); foreach (var p in points) pathPoints.Enqueue(p); pointIndex 0; StartCoroutine(SwimAlongPath()); } IEnumerator SwimAlongPath() { while (pathPoints.Count 0) { Vector2 target pathPoints.Dequeue(); while (Vector2.Distance(transform.position, target) 0.05f) { transform.position Vector2.MoveTowards( transform.position, target, speed * Time.deltaTime); yield return null; // 每帧暂停让出主线程 } } StartCoroutine(RecycleAfterOutOfScreen()); } }yield return null表示下一帧继续执行这让整条路径的遍历代码看起来是顺序的但实际每一段都在不同的帧执行。相比用Update里的 switch 判断当前在走哪一段协程方案维护成本低很多路径加长时只需要往队列里 Enqueue 新点循环自动处理。4.2 用状态机管理整局流程鱼个体适合协程但整局游戏的宏观流程——待机、发射、等待结算、派发奖励——适合用状态机。原因在于这些状态之间是互斥且有序的不会在发射子弹的同时弹出结算面板。public enum BattlePhase { Idle, // 待机等待玩家输入 Firing, // 子弹飞行中 Catching, // 命中判定完成播放奖励动画 Settling // 结算金币刷新 UI } public class BattleManager : MonoBehaviour { public BattlePhase phase BattlePhase.Idle; void Update() { switch (phase) { case BattlePhase.Idle: if (Input.GetMouseButtonDown(0)) { phase BattlePhase.Firing; cannon.Fire(currentMultiplier); } break; case BattlePhase.Firing: // 等待子弹飞行动画结束由 Bullet 回调 OnHitComplete break; case BattlePhase.Catching: // 结算金币、检查大四喜等特殊奖励 break; } } }cannon.Fire内部通过事件触发OnBulletComplete外部监听这个事件把phase从Firing切回Idle。这个切回动作不要写在Firing分支里轮询而是写成事件回调这样Firing状态内部不需要每帧做判断。4.3 协程与状态机的边界对比维度协程状态机适合描述顺序执行的时间轴行为互斥状态的转移代码可读性线性逻辑阅读顺状态多了以后分支难维护性能开销每个协程有迭代器开销无额外开销适合场景鱼的路径、动画序列整局流程、AI 决策在实际项目中捕鱼达人的 AI 决策也常用状态机鱼群从小鱼群切换到受惊逃逸再到落单游荡本质上就是Patrol、Escape、Dead三个互斥状态的切换。也可以把逃逸逻辑用协程实现但状态的入口和出口必须由状态机控制否则会出现在逃逸状态里还能被鱼群重新拉回去的 bug。4.4 把两条链路接进同一个实战流程完整的一局流程可以这样串起来BattleManager的状态机在Idle时接受输入调CannonFire.Fire状态切到FiringFish.TakeDamage内部扣血并在生命归零时触发OnFishDied事件BattleManager订阅该事件后在Catching状态下结算金币、更新 UI鱼的死亡动画由协程控制播放完后回收到对象池。这个链路的妙处在于状态机负责什么时候能做什么协程负责某个动作内部怎么一步步做完两者各管一摊互不越权。5. 参数调优与真机验证从帧率曲线到对象池容量决策5.1 对象池容量怎么算才不浪费预热数量不是拍脑袋定的。有一个经验公式预热量 同屏最大对象数 × 单个对象平均存活秒数 ÷ 平均生成间隔。以鱼为例同屏目标 30 条、平均存活 10 秒、生成间隔 0.6 秒算出来的结果是30 × 10 ÷ 0.6 500显然过多。实际不需要500因为鱼池按档位拆分后低档位池承担 80% 的生成压力高档位池虽然有四分之一的鱼同屏但生成频率低。项目里合理的分配是Level01 池预热 40、Level02 池预热 25、Level03 池预热 15、Level04 池预热 10、Level05 池预热 6、Level06 池预热 2总预热量不到 100。预热不是越多越好每多一个Instantiate都会拉长启动加载时间容量设置刚好覆盖高峰期 10% 余量即可。5.2 帧率与 GC 的验证路径验证性能不要只看 Game 视图的帧率要用 Unity Profiler 抓真实数据。在 Profiler 的 CPU 模块里打开GC Allocation列跑一段 120 秒的完整对局观察GC.Alloc的峰值和频率。如果发现每秒都有较大的GC.Alloc优先排查是否在 Update 里创建了字符串、Lambda 表达式或foreach迭代器捕鱼达人项目里最常见的 GC 来源是金币飘字每结算一次就 New 一个字符串拼接改成StringBuilder复用能显著降低分配量。再看Rendering模块的Draw Call同屏鱼多时如果每帧Draw Call超过 60在移动端需要检查 Sprite 图集是否合并、是否开了动静分离。5.3 真机调试时的参数核查表检查项观察方式达标参考帧率Profiler / FPS 计数器中端机不低于 50fpsGC AllocCPU 模块 GC 列峰值不超过 8KBDraw CallRendering 模块不超过 60对象池命中率自定义 Debug.Log池外 Instantiate 次数为 0内存占用Memory ProfilerAndroid 不超过 400MB对象池命中率排查建议在ObjectPool.Get里加一个计数器池为空时自增poolMissCount每 30 秒输出一次。如果 miss 次数持续增长说明某个池子的预热数量不够直接增大对应池的preloadCount就好其他代码完全不用动。5.4 一个容易被忽略的渲染排序坑鱼、子弹、金币的 Sprite 都挂在不同的预设体上但归池复用后SortingOrder可能残留上一次被分配时的值。比如一条河豚被回收前SortingOrder是 10下次被取出时鱼池里刚好还有一条排序为 5 的鱼就会出现新生成的鱼被旧鱼遮挡的视觉穿透问题。处理方式是在Fish.Init里显式重置SpriteRenderer.sortingOrder按照低分鱼在前、高分鱼在后的规则重新赋值这样既解决遮挡问题还让高分鱼永远显示在低分鱼上方玩家一眼能看出该打哪条。同一层级的 Sprite 尽量塞进同一张图集配合 Unity 的 Sprite Atlas 减小Draw Call。本文还有配套的精品资源点击获取