简介这是基于Unity 2021.1及以上版本的超级冰火人风格双人合作益智迷宫游戏完整项目源码面向Unity游戏开发者、独立制作人和解谜游戏爱好者。项目内置三十张地图设有红男孩与水女孩双角色控制包含火钻石与冰钻石收集、多种关卡机关杠杆、镜子、光束、电梯、风力机、滑轮系统和完整配乐可直接运行体验也适合作为学习Unity游戏逻辑、关卡设计及换皮开发的实战范本。压缩包共两千个文件大小约五十二兆字节涵盖C#脚本、Unity场景、预制体、材质、动画、着色器等核心资源同时集成AdMob、Facebook Audience Network、AppLovin等多平台广告SDK便于快速接入商业化功能。项目结构清晰支持轻松添加更多关卡与换皮并附带相关文档与持续更新能够帮助研究者理解真实项目中的目录组织与模块划分。目前已有两百零七人学习下载是理解商业级Unity项目架构、双人合作解谜设计与广告变现流程的优质示例。1. 先拆开“超级冰火人”这包 Unity 源码再看代码冰火人这个品类核心从来不是建模或手感而是“两个角色共享一个场景、互相补位才能过关”。标题里的 Red boy And Blue girl 就是这套机制的缩写红色角色走火区蓝色角色走水区岩浆、水潭、酸液、压力板和门按迷宫式路线排布。拿到源码时先别急着点 Play先问三个问题角色由哪个脚本控制、机关由什么触发、死亡之后回到哪里。这三个问题对应 PlayerController、Trigger 系统和 GameManager 三条主线后续就按这个顺序解开一包 C# 源码的实际组成。适合理性思考的 Unity 入门者也适合找现成方案改造的原型开发者。2. 打开 Unity 工程之前版本、目录与入口脚本拿到压缩包第一件事是解压。路径不要带中文Assets 文件夹下每个资源都对应一个 .meta 文件里面的 GUID 是场景引用资源的凭证。随意删除 meta 文件或让多个工程副本混用轻则丢失预制体引用重则场景里的脚本全部脱离Unity 会显示成 “Missing (Mono Script)”。稳妥做法是把解压后的文件夹直接放到短路径下再用 Unity Hub 打开。2.1 用 Unity Hub 选择对应版本打开工程源码一般不带 Libraries 目录Unity Hub 打开工程时会自动生成。常见做法是尽量用与原工程一致的编辑器版本版本跨度太大时 Unity 会弹升级对话框。如果 Unity 提示工程由更高版本编辑器创建优先选择已有版本打开而不是立刻下载新版这样可以先分析代码和场景减少版本升级带来的干扰。打开步骤打开 Unity Hub点击“打开”按钮选择解压后的工程根目录即包含 Assets 文件夹的那一层如果提示版本不一致选择已有的相近版本先不勾选升级到最新渲染管线首次打开后等待 Library 构建完成在 Console 面板查看红色报错有报错先记录再点 PlayConsole 里常见的 Missing Script 提示大多数是脚本文件被移动或重命名导致引用断掉。层级面板中出现 “Missing (Mono Script)” 的节点不要马上删除先摘录它挂载的缺失脚本名再在 Scripts 目录里搜索找回。2.2 源码目录的三层阅读法这类项目在 Assets 下一般按场景、预制体、脚本、数据分目录命名方式可能不同但职责基本一致子目录作用建议关注点Scenes存放游戏关卡入口场景是哪个有几个关卡场景Prefabs存放角色、机关、粒子等可复用单位预制体之间是否存在 Missing 引用Scripts存放 C# 逻辑脚本是否按功能分目录入口脚本是什么Data 或 Config存放关卡配置和存档模板数据字段是否与场景对象一一对应我一般会先扫一遍 Scripts 文件夹的文件数量超过二十个还没有子目录的就要花更多时间在全局搜索上。入口脚本通常叫 GameManager负责全局状态、暂停和重置。先看它怎么引用红蓝两人能快速判断整个架构是“脚本直接拖引用”还是“运行时动态查找”。using UnityEngine; public class GameManager : MonoBehaviour { // 单例引用其他脚本通过 GameManager.Instance 访问 public static GameManager Instance { get; private set; } [Header(角色引用)] public Transform redBoy; // 红人 public Transform blueGirl; // 蓝人 [Header(当前状态)] public bool gameOver false; private void Awake() { // 场景里只保留一个 GameManager重复时销毁后创建的 if (Instance ! null Instance ! this) { Destroy(gameObject); return; } Instance this; } public void ResetLevel() { // 角色死亡或卡关后重载当前场景 UnityEngine.SceneManagement.SceneManager.LoadScene( UnityEngine.SceneManagement.SceneManager.GetActiveScene().name); } }这段代码是教科书式的单例Awake 里赋值并去重比 Start 更早执行保证其他脚本在 Start 阶段调用 GameManager.Instance 时不会拿到空引用。ResetLevel 直接重载场景简单但足够可靠。如果场景里被误放了两个 GameManager去重分支会保留先创建的避免重复初始化。2.3 从场景组织反推玩法流程打开 Scenes 里第一个关卡场景后检查 Hierarchy 面板的顶层节点。结构清晰的工程一般会有几个固定层环境地形、机关层、角色层、UI 层。地形整块挂在同一个父节点下机关层里每个压力板对应一个门对象角色层只放红人和蓝人两个玩家。如果层级面板里看不到隔离说明作者把对象平铺了。这时可以直接在 Hierarchy 搜索框按组件名过滤输入 Collider2D 或 SpriteRenderer 快速圈定对象范围。也可以用 Project 面板右键查找引用来定位某个脚本挂在哪些预制体上这对后续改机关逻辑很有帮助。3. 双角色协作的核心机制移动、机关触发与死亡重置冰火人的游玩体验完全建立在红蓝分工上源码里最值得抄的部分是双角色控制与机关联动。这一章拆开讲移动、平台、踩踏板、死亡重置四块每一块都有对应的 C# 组件。3.1 红蓝两个角色的 PlayerController 该怎么写双角色益智游戏有两种控制方案红人 WASD、蓝人方向键的并行控制以及单键切换当前操作对象。迷宫关强调同时配合源码里常见做法是并行控制两个玩家在同一场景中各自行动。using UnityEngine; public class PlayerController : MonoBehaviour { [Header(移动参数)] public float moveSpeed 5f; // 水平移动速度 public float jumpForce 8f; // 跳跃初速度 public KeyCode leftKey KeyCode.A; public KeyCode rightKey KeyCode.D; public KeyCode jumpKey KeyCode.W; private Rigidbody2D rb; private bool onGround; // 是否踩在地面上 private void Start() { rb GetComponentRigidbody2D(); } private void Update() { // 每帧读取按键并合成水平输入 float move 0f; if (Input.GetKey(leftKey)) move - 1f; if (Input.GetKey(rightKey)) move 1f; // 起跳时给刚体一个竖直方向的速度 if (Input.GetKeyDown(jumpKey) onGround) { rb.velocity new Vector2(rb.velocity.x, jumpForce); onGround false; } // 水平位移交给刚体避免直接改 transform 造成穿透 Vector2 target rb.position new Vector2(move * moveSpeed * Time.deltaTime, 0f); rb.MovePosition(target); } private void OnCollisionEnter2D(Collision2D collision) { // 碰到地面或移动平台都视为落地 if (collision.gameObject.CompareTag(Ground)) { onGround true; } } }关键参数表参数默认值说明moveSpeed5水平速度数值大时注意贴墙抖动jumpForce8跳跃初速度二段跳需求下可叠加GravityScale3在 Rigidbody2D 上调下落要快但起跳不能太飘rb.mass1双角色相撞时质量差不能过大Update 读输入、MovePosition 写位移是 2D 平台游戏的常见写法。和直接改 transform.position 相比MovePosition 走刚体物理角色能推开其他物体也不会穿进静态碰撞体。代码里用 GetKey 而不是 GetAxis是避免 Input Manager 里轴输入自带的灵敏度曲线带来延迟感。迷宫关卡多窄道跳跃瞬间响应比平滑更重要。3.2 移动平台、单向碰撞和角色粘连问题迷宫关卡高频出现的机关是移动平台。平台由脚本或 Animator 驱动角色站上去时如果不让角色跟随平台平台移动时角色就会原地不动甚至掉落。using UnityEngine; public class MovingPlatform : MonoBehaviour { public Transform pointA; // 移动起点 public Transform pointB; // 移动终点 public float speed 2f; private void Update() { // 用 PingPong 在两段路径间往返t 一直在 0 到 1 之间 float t Mathf.PingPong(Time.time * speed, 1f); transform.position Vector3.Lerp(pointA.position, pointB.position, t); } private void OnTriggerEnter2D(Collider2D other) { // 角色进入平台触发区后跟随移动 if (other.CompareTag(Player)) { other.transform.SetParent(transform); } } private void OnTriggerExit2D(Collider2D other) { // 离开平台后解除父子关系 if (other.CompareTag(Player)) { other.transform.SetParent(null); } } }3.2.1 SetParent 的坑与替代方案SetParent 临时改变父子关系会让角色在平台移动中累积浮点数误差离开平台时容易抖动一下。平台在高速运动时更稳的做法是用平台速度给角色叠加或在 OnTriggerStay2D 里用平台的速度平移角色。源码里如果看到 OnCollisionStay2D 里反复 SetParent可以留意是否有误差补偿。另一常见问题是角色和平台边缘粘连。静态平台 Collider 默认带摩擦角色跳上边缘会粘住。常见做法是在平台物体上挂 PlatformEffector2D打开 Use One Way并将 Surface Arc 设为 180 度附近这样角色从下方可以通过、从上方站住同时减少边缘摩擦力带来的顿手感。3.3 压力板触发门与死亡重置逻辑压力板属于“脚踏触发”式机关踩下后开门离开后门关闭是基础版。需要注意 Trigger 体积足够大过小会导致角色快速走过时没有触发判定。using UnityEngine; public class PressurePad : MonoBehaviour { public GameObject targetDoor; // 要移动的门体 public float openHeight 2f; // 门打开的抬高距离 public bool requireSpecificRole; // 是否区分红蓝角色 private Vector3 originalPos; private int pressCount 0; // 板上的角色数量双人同踩也能正确处理 private void Start() { originalPos targetDoor.transform.position; } private void OnTriggerEnter2D(Collider2D other) { // 进入压力板的角色都计入引用计数 if (!requireSpecificRole || other.CompareTag(Red) || other.CompareTag(Blue)) { pressCount; } } private void OnTriggerExit2D(Collider2D other) { // 离开一个减一保证至少有一个角色踩着时门不关 if (!requireSpecificRole || other.CompareTag(Red) || other.CompareTag(Blue)) { pressCount Mathf.Max(0, pressCount - 1); } } private void Update() { // 只要计数大于 0 门就保持打开用 Lerp 平滑过渡 bool isPressed pressCount 0; Vector3 target isPressed ? originalPos Vector3.up * openHeight : originalPos; targetDoor.transform.position Vector3.Lerp( targetDoor.transform.position, target, Time.deltaTime * 3f); } }pressCount 引用计数是双人机关的关键点。如果用简单的 enter 设为 true、exit 设为 false红人踩住门开着蓝人再走时门会先关一下再开视觉上就是抖动。计数版本只在第一个人进入时加一、最后一个人离开时减到零门的状态稳定。死亡重置在冰火人里通常借助熔岩或酸液上的不可见 BoxCollider2D 实现挂一个 KillZone 脚本using UnityEngine; public class KillZone : MonoBehaviour { public Transform respawnPoint; // 存档点放场景空物体 private void OnTriggerEnter2D(Collider2D other) { // 熔岩、酸液、虚空统一用这个组件处理 if (other.CompareTag(Player)) { other.transform.position respawnPoint.position; // 重置速度避免落到存档点后继续滑行 Rigidbody2D rb other.GetComponentRigidbody2D(); if (rb ! null) { rb.velocity Vector2.zero; } } } }两个角色可以共用一套 KillZone但 respawnPoint 要分开设置红人回红人存档点、蓝人回蓝人存档点。迷宫关卡一般靠这种设计控制玩家的错误路线掉进酸液后被迫返回上一个分支路口。4. 迷宫关卡的数据驱动与进度存档从 Scene 到 PlayerPrefs双角色迷宫的关卡设计多由开发者直接在场景里手工摆放代码层面真正做数据驱动的部分是关卡解锁表和进度存档。迷宫多关卡时靠硬编码写死每一关的按钮和状态会很难维护常见做法是配置在 ScriptableObject 或轻量 JSON 里。4.1 用 ScriptableObject 或 JSON 做关卡配置小关卡的属性包括关卡 ID、场景名、是否锁定、解锁条件。用 ScriptableObject 能直接在编辑器里创建资源字段改变时立即保存不需要改代码。using UnityEngine; using System.Collections.Generic; // 在 Project 面板右键 - Create - Game - LevelConfig 创建关卡配置 [CreateAssetMenu(fileName LevelConfig, menuName Game/LevelConfig)] public class LevelConfig : ScriptableObject { public string levelId; // 例如 level_1_3 public string sceneName; // 对应的 Unity 场景名 public bool isLocked; // 初始锁定状态 public int requiredStars; // 解锁所需星星数 public Liststring tags; // 关卡标签例如 冰 火 }将配置做成资源后选择关卡界面遍历所有 LevelConfig 实例即可。新增一个关卡时新建一份配置资源和场景UI 脚本不需要改动。迷宫类项目新增关卡频率高数据驱动比硬编码按钮列表省事得多。4.2 用 PlayerPrefs 保存解锁进度与 C# 字符串解析存档用 PlayerPrefs 是成本最低的方案适合小游戏。需要注意 PlayerPrefs 只适合存短字符串和数字把整张地图序列化成大 JSON 塞进去会有写入风险。using UnityEngine; public class SaveManager : MonoBehaviour { // 解锁前缀 关卡 ID 作为键 private const string LevelPrefix level_unlock_; public void UnlockLevel(string levelId) { // 单关单独存一个 int避免整表覆盖 PlayerPrefs.SetInt(LevelPrefix levelId, 1); PlayerPrefs.Save(); } public bool IsLevelUnlocked(string levelId) { // 默认值 0 表示未解锁 return PlayerPrefs.GetInt(LevelPrefix levelId, 0) 1; } public int ParseLevelNumber(string levelId) { // level_1_3 按 _ 拆成三段取最后一段解析成数字 string[] parts levelId.Split(_); int number 0; if (parts.Length 0) { int.TryParse(parts[parts.Length - 1], out number); } return number; } }Split 和 int.TryParse 是 C# 字符串处理里最常用的组合存档、配置读取、数据解析都绕不开它们。建议用 TryParse 而不是直接 int.Parse因为配置手写出错时TryParse 会返回 false不影响主流程继续跑。注意 PlayerPrefs.Save() 在桌面平台会立即写盘移动端可能延迟到应用切后台才落盘排查进度丢失问题时优先确认它是否被调用过。4.3 扩大机关按钮点击范围与温度条刷新的性能问题迷宫里有按钮机关或 UI 操作按钮时会遇到“看着很大点了没反应”的问题。先说结论UGUI 默认的 Image 只要勾选了 Raycast Target透明区域也会拦截点击。点了没反应通常不是透明问题而是事件被其他全屏 Image 挡住或按钮本身没勾 Raycast Target。做法适用场景注意点放大 Image 的 RectTransform方形按钮按钮文字居中不跟随需要单独调整按钮下垫大底图任意按钮底图不能盖住按钮文字和图标alphaHitTestMinimumThreshold不规则按钮只过滤透明像素不扩大热区放大热区的正解是垫底图在按钮节点下新建一个 Image 作为子物体勾选 Raycast TargetRectTransform 拉得比按钮大一圈用 SetAsFirstSibling 放到最底层。给不规则按钮做精细点击判定才需要设置 alpha 阈值using UnityEngine; using UnityEngine.UI; public class ButtonHitArea : MonoBehaviour { public Image targetImage; // 按钮上的 Image private void Start() { // 只让不透明像素参与点击判定透明区域点击穿透 targetImage.alphaHitTestMinimumThreshold 0.1f; } }温度条这类 UI 刷新也要注意。冰火人里角色进入火焰区温度上升、进水池下降如果每帧在 Update 里读数值再赋给 Slider场景物体多时会有无谓开销。常见做法是让状态系统在数值变化时抛事件UI 只负责订阅using UnityEngine; using UnityEngine.UI; public class TemperatureBar : MonoBehaviour { public Slider slider; // 温度条滑动条 private void OnEnable() { // 订阅事件数值变化时才刷新 UI PlayerEnergy.OnEnergyChanged UpdateBar; } private void OnDisable() { // 退订事件防止失效对象继续接收消息 PlayerEnergy.OnEnergyChanged - UpdateBar; } private void UpdateBar(float currentEnergy) { slider.value currentEnergy; } }事件订阅相比 Update 轮询省掉了每帧读取和比较的开销对频繁切换状态的机关界面更友好。5. 验收与发布读源码时的 3 个检查项与 WebGL 存档兜底标题里写了“最新”两个字拿到源码第一批要做的是验收流程确认它确实能独立构建。以下是我处理这类源码项目常用的 3 个检查项。5.1 检查场景引用、Tag 和构建列表第一个检查项是场景中缺失脚本。打开场景后在 Hierarchy 中点击任意 GameObject检查 Inspector 是否出现 “Missing (Mono Script)”。出现时需要找到对应脚本重新拖挂或者删掉节点重建。第二个检查项是 Tag 和 Layer。控制脚本里用了 CompareTag(Ground)如果 Ground 这个 Tag 不存在运行时会抛异常。对照 Tag Manager 确认 Ground、Red、Blue 三个 Tag 都被定义。第三个检查项是 Build Settings 里的场景列表。很多人只点 Play 忽略构建发布时才发现 Scenes In Build 是空的。把入口场景拖进列表其余关卡场景按解锁顺序排列即可。5.2 WebGL 发布时的 PlayerPrefs 与 IDBFS 写入失败迷宫游戏常用于网页端分发Unity 发布 WebGL 时存档机制会变成浏览器 IndexedDB 上的 IDBFS 写入。隐私模式、存储配额超限、同一域名下有旧工程的数据残留都可能导致写入失败Unity 发布 WebGL 使用 idbfs 写入失败是这类项目的典型报错。处理顺序一般这样走先用 Chrome 打开站点按 F12 进入开发者工具切到 Application 面板在 Storage 分区可以看到配额占用展开 IndexedDB 并找到对应域名清理残留库。然后退出隐私模式用普通窗口重试。最后检查 Player Settings 里的压缩格式和数据缓存设置。如果进度数据不关键可以做内存降级捕获存档异常后本次会话继续玩不中断游戏。PlayerPrefs 在桌面和移动端表现稳定WebGL 下则受浏览器配额限制频繁写入大字段时考虑换成 localStorage 或跳过硬编码的 IDBFS 封装避免目录残留问题。5.3 用带对象引用的 Debug.Log 验证双角色切换最后一个实用技巧排查双角色切换逻辑时在切换方法里输出带场景对象引用的日志。private void SwitchActivePlayer(PlayerController nextPlayer) { // 日志带上对象引用点击 Console 消息可直接定位场景对象 Debug.Log($[PlayerSwitcher] 切换前角色: {currentPlayer.name}, currentPlayer); currentPlayer.enabled false; currentPlayer nextPlayer; currentPlayer.enabled true; Debug.Log($[PlayerSwitcher] 切换后角色: {currentPlayer.name}, currentPlayer); }Debug.Log 的第二个参数是 UnityEngine.Object 类型传场景对象进去后Console 会保存上下文。点击日志消息Scene 视图会自动高亮并定位到该对象。排查陌生源码时这样比在代码里盲猜快得多还能同时看到两个角色是否都进入了正确的 switch 状态。本文还有配套的精品资源点击获取