1. 项目概述一份免费的Unity2D拼图游戏源码意味着什么最近在整理自己的资源库翻出来一份几年前写的Unity2D拼图游戏源码当时是为了带新人熟悉Unity工作流和C#脚本逻辑而做的教学项目。看到网上很多朋友在找类似的免费资源索性就把它整理出来并配上详细的解析。这份源码麻雀虽小五脏俱全它不是一个简单的“玩具”而是一个包含了核心游戏循环、UI交互、数据管理和扩展接口的完整项目框架。无论你是刚接触Unity的初学者想通过一个具体案例上手还是有一定经验的开发者想快速搭建一个拼图游戏的雏形进行二次开发这份源码都能提供一个非常扎实的起点。很多人觉得“拼图游戏”太简单没什么技术含量。但恰恰是这种看似简单的项目最能考验一个开发者对基础模块的封装能力、对状态管理的理解以及对用户体验细节的把握。在这份源码里你会看到如何优雅地处理图片的切割与打乱、如何实现拖拽与吸附的流畅交互、如何设计一个可配置的游戏管理器来掌控全局以及如何记录游戏进度和计时。这些模块化的设计思路是制作任何类型游戏都通用的“内功”。接下来我就带你深入这份源码看看每一个部分是怎么运作的以及在实际开发中需要注意哪些“坑”。2. 源码整体架构与核心模块拆解拿到一份源码最忌讳的就是一头扎进代码细节里。我们先从上帝视角看看这个项目的整体文件夹结构和各个模块是如何协同工作的。一个结构清晰的Unity项目能极大提升后续的阅读、修改和维护效率。2.1 项目目录结构解析典型的Unity2D拼图游戏项目其Assets目录通常会包含以下几个核心文件夹Scripts: 这是代码的核心。里面会按功能进一步细分比如Managers管理器、Gameplay游戏逻辑、UI界面控制等。Sprites: 存放所有游戏用到的2D精灵图片包括完整的原图、切割后的小图块以及UI按钮图标等。Prefabs: 预制体文件夹。拼图游戏的核心预制体就是“图块”Tile我们会将图块做成预制体方便在运行时动态生成。Scenes: 场景文件。至少会有一个主游戏场景MainGame可能还会有开始菜单Menu、关卡选择LevelSelect等。Audio: 音效和背景音乐资源。Resources或StreamingAssets: 如果需要从外部动态加载拼图图片可能会用到这些文件夹。在这份源码中其结构基本遵循了这个范式。Scripts文件夹是我们要重点剖析的对象它定义了整个游戏的运行逻辑。2.2 核心脚本职责划分脚本之间职责清晰、耦合度低是评价一份源码质量的重要标准。这个拼图项目主要包含以下几个核心脚本GameManager(游戏管理器): 单例模式。它是游戏的大脑负责全局状态管理例如游戏开始、暂停、结束的判断计时器的启动与停止胜负条件的校验以及作为其他模块之间的通信枢纽。PuzzleManager或BoardManager(拼图板管理器): 负责拼图游戏最核心的逻辑。包括根据选定的图片和行列数动态生成拼图网格将原图切割成多个图块打乱图块的初始顺序以及判断当前拼图是否完成。Tile(图块脚本): 挂载在每个拼图块预制体上。它负责处理单个图块的交互逻辑最主要的就是鼠标或触摸的拖拽Drag和释放Drop事件。当图块被释放时它需要与PuzzleManager通信尝试与目标位置通常是空位交换。UIManager(界面管理器): 控制所有UI元素的显示、隐藏和更新。例如显示计时、步数、完成百分比控制开始、暂停、重置按钮的响应弹出游戏完成后的胜利界面。DataManager(数据管理器): 可选但推荐。负责玩家数据的持久化例如保存每个关卡的最佳完成时间、最少步数或者游戏的解锁进度。通常使用PlayerPrefs进行简单存储对于复杂数据可以考虑JSON或ScriptableObject。这种“管理器组件”的模式在Unity中非常普遍。GameManager作为总指挥PuzzleManager负责业务核心Tile作为可交互的个体UIManager负责呈现各司其职修改和调试起来都会非常方便。注意在实际阅读源码时你可能会发现有些开发者喜欢把PuzzleManager的功能合并到GameManager中。对于小项目这无可厚非但随着功能增加比如加入多关卡、道具系统代码会变得臃肿且难以维护。因此即使在这个“小”项目中看到分层的设计也值得你学习和借鉴。3. 核心玩法实现细节深度剖析理解了架构我们深入到最有趣的“拼图”本身。这一部分将拆解图片切割、图块交互、完成判定这三个核心环节的具体实现和其中的技术选型考量。3.1 图片动态切割与图块生成拼图游戏的第一步是把一张完整的图片变成N个乱序的小图块。这里有两种主流实现方式方案A运行时动态切割这是本源码采用的主要方式灵活性最高。在PuzzleManager的Start()或一个初始化方法中我们会进行以下操作加载原图通过Resources.LoadSprite或从UI上赋值一个Sprite变量获取原图。计算图块尺寸根据设定的行数(rows)和列数(cols)用原图的宽度除以列数高度除以行数得到每个小图块的宽高。循环创建图块使用嵌套的for循环遍历每一行每一列。在循环体内使用new Rect(x, y, tileWidth, tileHeight)创建一个矩形区域定义要切割的图片部分。调用Sprite.Create(sourceTexture, rect, pivot)来创建一个新的精灵。这里的pivot轴心点通常设为(0.5f, 0.5f)即中心点方便后续定位和旋转。实例化Tile预制体将上一步创建的精灵赋值给它的SpriteRenderer组件。为这个图块对象设置一个逻辑坐标(row, col)代表它正确的位置。同时设置它当前所在的物理位置可能是打乱后的位置。方案B预切割图集对于一些性能要求苛刻或风格固定的项目可能会选择在美术阶段就预先切割好图片导入Unity后直接使用。这种方式省去了运行时的切割计算但失去了动态更换拼图图片的灵活性。为什么选择动态切割对于一份旨在教学和快速原型的源码来说动态切割的优势明显一份代码无限图片。你只需要替换Resources文件夹里的图片甚至允许玩家从相册选择图片就能立刻生成一个新的拼图极大地提升了项目的可玩性和扩展性。虽然每次启动有一点点性能开销但对于拼图这种轻量级游戏而言完全在可接受范围内。3.2 拖拽、吸附与交换逻辑这是玩家直接感知到的交互核心体验是否流畅全看这里。Tile脚本是实现这一功能的主力。拖拽实现 通常是在Tile脚本中实现OnMouseDown、OnMouseDrag、OnMouseUp这一系列事件对于移动端则需要使用IPointerDownHandler等UI事件接口。在OnMouseDown时记录被点击的图块。在OnMouseDrag时最常见且体验较好的做法是让图块跟随鼠标移动但将其z坐标稍微调前并暂时关闭它的碰撞体以避免拖动过程中与其他图块发生不必要的交互。代码上就是每帧更新图块的transform.position为鼠标的世界坐标。吸附与交换逻辑 这是算法的精髓所在。我们不会让玩家像玩华容道一样把图块精确地挪到一个小格子里那样体验太差。通常采用“邻近交换”规则只有当拖动的图块被释放时判断其当前位置与那个唯一的“空位”或目标位是否相邻上下左右。如果相邻则执行交换动画如果不相邻则让图块平滑地回到拖动前的位置。在PuzzleManager中我们需要维护一个二维数组tileGrid[,]来记录每个网格位置当前存放的是哪个Tile对象空位则为null。当Tile被释放时Tile脚本将自己的实例和释放时的位置信息发送给PuzzleManager。PuzzleManager根据释放位置换算成最近的网格坐标。检查这个目标网格是否是空位并且是否与图块原来的网格位置相邻通过计算行差和列差的绝对值之和是否为1来判断。如果条件满足则执行交换更新tileGrid数组中的数据并启动一个协程Coroutine来让两个图块或图块与空位平滑地移动到对方的位置使用Vector3.Lerp。交换完成后立即调用CheckForCompletion()方法检查拼图是否完成。实操心得在实现拖动时我强烈建议将“跟随鼠标移动”的计算放在LateUpdate中或者使用Update但确保计算顺序。这样可以避免因为其他脚本的Update修改了位置而出现抖动。另外交换动画的时间如0.2秒不宜过长或过短0.2-0.3秒是一个比较舒适的区间既能看清移动过程又不会让玩家觉得拖沓。3.3 游戏完成判定算法如何判断一堆乱序的图块已经被拼成了原图最直观的方法就是遍历所有图块检查每个图块当前所在的物理位置是否等于它记录的逻辑正确位置。在PuzzleManager的CheckForCompletion()方法中遍历tileGrid数组中的每一个元素即每一个网格位置。对于非空的位置获取该位置上的Tile组件。读取该Tile上记录的correctRow和correctCol正确行列坐标。将correctRow、correctCol与当前遍历的网格索引i,j进行比较。如果所有图块都满足tile.correctRow i tile.correctCol j则判定拼图完成。这里有一个关键优化点我们不需要在每次交换后都遍历整个棋盘。可以在PuzzleManager中设置一个计数器correctTilesCount。初始化时所有图块都不在正确位置计数器为0。每当一次交换使得一个图块移动到了它的正确位置计数器就加1如果一个原本在正确位置的图块被移开了计数器就减1。这样完成判定的条件就简化为判断correctTilesCount是否等于总图块数。这比全盘遍历要高效得多尤其是在拼图块数很多的时候。关于“空位”的处理 在经典的滑动拼图中会有一个空位。在我们的实现中可以创建一个“空白图块”预制体它拥有一个透明的精灵和碰撞体参与所有的交换逻辑。也可以不创建实体只在tileGrid数组中用null表示空位在交互判断时特殊处理。两种方式各有优劣实体化空位会让交换逻辑更统一所有格子都有对象而使用null则更节省资源。源码中通常采用后者因为它更简洁。4. 关键脚本代码解读与编写技巧光说不练假把式我们来看一些核心代码片段并解释其背后的设计意图和编写技巧。请注意以下代码是示意性的融合了最佳实践可能与原始源码不完全相同但逻辑相通。4.1 PuzzleManager拼图世界的构建者PuzzleManager的CreatePuzzleBoard方法是整个游戏的起点。public class PuzzleManager : MonoBehaviour { public Sprite sourceImage; // 原始拼图图片 public GameObject tilePrefab; // 图块预制体 public int rows 3; public int cols 3; public float spacing 0.1f; // 图块之间的间隙 private Tile[,] tileGrid; // 逻辑网格 private ListVector2Int shufflePositions new ListVector2Int(); // 用于打乱的位置列表 private int correctTilesCount 0; void Start() { GeneratePuzzle(); ShuffleTiles(); } void GeneratePuzzle() { tileGrid new Tile[rows, cols]; Texture2D sourceTexture sourceImage.texture; float tileWidth sourceTexture.width / (float)cols; float tileHeight sourceTexture.height / (float)rows; // 创建棋盘背景可选用于显示完整图片的淡影 // ... // 循环创建每一个图块 for (int r 0; r rows; r) { for (int c 0; c cols; c) { // 计算该图块在原始图片上的UV矩形 Rect rect new Rect(c * tileWidth, (rows - 1 - r) * tileHeight, tileWidth, tileHeight); // 注意纹理坐标原点在左下角而我们的网格从左上角开始创建所以用(rows-1-r)进行Y轴翻转 Sprite newSprite Sprite.Create(sourceTexture, rect, new Vector2(0.5f, 0.5f)); // 实例化图块 GameObject tileObj Instantiate(tilePrefab, this.transform); Tile tileScript tileObj.GetComponentTile(); tileScript.Initialize(this, newSprite, r, c); // 初始化传入管理器引用、精灵和正确坐标 // 计算图块在游戏世界中的初始位置按正确顺序排列 Vector3 tilePos CalculateWorldPosition(r, c); tileObj.transform.localPosition tilePos; // 将图块存入逻辑网格 tileGrid[r, c] tileScript; // 同时记录这个“正确”位置用于后续打乱 shufflePositions.Add(new Vector2Int(r, c)); } } // 创建后移除最后一个图块作为初始空位假设是右下角 CreateInitialEmptySlot(rows - 1, cols - 1); } Vector3 CalculateWorldPosition(int row, int col) { // 根据行列、图块尺寸和间隙计算世界坐标 // 假设图块预制体本身的Scale就是1单位对应1像素 float posX col * (1 spacing); float posY -row * (1 spacing); // Y轴向下为负符合2D惯例 return new Vector3(posX, posY, 0); } void CreateInitialEmptySlot(int emptyRow, int emptyCol) { if (tileGrid[emptyRow, emptyCol] ! null) { Destroy(tileGrid[emptyRow, emptyCol].gameObject); tileGrid[emptyRow, emptyCol] null; // 从打乱位置列表中移除这个位置因为它现在是空位 shufflePositions.Remove(new Vector2Int(emptyRow, emptyCol)); } } }代码解读与技巧rows - 1 - r这是一个关键细节。因为Unity中纹理坐标UV的原点(0,0)在左下角而我们在逻辑上通常习惯从左上角开始第0行。所以用(rows - 1 - r)来进行Y轴翻转确保切割出的第一块精灵对应原图的左上角。Initialize方法将PuzzleManager的引用传递给每个Tile这是双向通信的基础。Tile需要调用管理器的方法来尝试交换。shufflePositions列表它记录了所有非空网格的位置专门用于后续的打乱算法避免对空位进行无效操作。创建空位在生成所有正确图块后主动销毁其中一个通常是右下角来创建初始空位。这是一种清晰的初始化方式。4.2 Tile灵敏的交互单元Tile脚本负责响应玩家的输入。public class Tile : MonoBehaviour { private PuzzleManager puzzleManager; private int correctRow, correctCol; private int currentRow, currentCol; private bool isDragging false; private Vector3 dragOffset; private Collider2D myCollider; public void Initialize(PuzzleManager manager, Sprite sprite, int row, int col) { puzzleManager manager; correctRow row; correctCol col; currentRow row; // 初始时当前位置就是正确位置 currentCol col; GetComponentSpriteRenderer().sprite sprite; myCollider GetComponentCollider2D(); } // 鼠标按下开始拖动 private void OnMouseDown() { if (puzzleManager.IsGameActive) // 游戏管理器控制游戏是否可交互 { isDragging true; myCollider.enabled false; // 关闭碰撞体防止拖动时阻挡射线检测 Vector3 mouseWorldPos Camera.main.ScreenToWorldPoint(Input.mousePosition); mouseWorldPos.z 0; dragOffset transform.position - mouseWorldPos; } } // 鼠标拖动中 private void OnMouseDrag() { if (isDragging) { Vector3 mouseWorldPos Camera.main.ScreenToWorldPoint(Input.mousePosition); mouseWorldPos.z 0; transform.position mouseWorldPos dragOffset; } } // 鼠标释放 private void OnMouseUp() { if (isDragging) { isDragging false; myCollider.enabled true; // 重新启用碰撞体 // 通知管理器尝试将此图块移动到鼠标释放的位置 puzzleManager.AttemptMoveTile(this, transform.position); } } // 由PuzzleManager调用移动图块到指定网格位置 public void MoveToPosition(int targetRow, int targetCol, float duration) { currentRow targetRow; currentCol targetCol; Vector3 targetPos puzzleManager.CalculateWorldPosition(targetRow, targetCol); StartCoroutine(SmoothMove(targetPos, duration)); } private IEnumerator SmoothMove(Vector3 target, float duration) { Vector3 startPos transform.position; float elapsed 0f; while (elapsed duration) { transform.position Vector3.Lerp(startPos, target, elapsed / duration); elapsed Time.deltaTime; yield return null; // 等待下一帧 } transform.position target; // 确保最终位置精确 // 移动完成后可以通知管理器检查游戏是否完成 puzzleManager.OnTileMoved(); } }代码解读与技巧dragOffset计算鼠标点击点与图块中心点的偏移量。如果不计算这个偏移图块中心会瞬间“跳”到鼠标位置体验很突兀。加上偏移后拖动时能保持鼠标与图块的相对位置不变。开关碰撞体在开始拖动时关闭碰撞体myCollider.enabled false是至关重要的一步。如果不关闭当你拖动一个图块经过另一个图块时可能会因为碰撞体的阻挡而无法顺畅移动或者触发不必要的物理事件。协程移动SmoothMove协程提供了平滑的移动动画。使用Vector3.Lerp进行线性插值是最简单的方式。对于更复杂的动画曲线如先快后慢可以使用AnimationCurve或第三方插件如DOTween。4.3 PuzzleManager处理移动与完成判定接着看PuzzleManager如何处理Tile发来的移动请求和完成判定。public class PuzzleManager : MonoBehaviour { // ... 其他变量 ... public void AttemptMoveTile(Tile tile, Vector3 releaseWorldPos) { // 1. 将释放的世界坐标转换为网格坐标 Vector2Int targetGridPos WorldToGridPosition(releaseWorldPos); // 2. 检查目标位置是否在网格范围内且是空位 if (!IsPositionInGrid(targetGridPos) || tileGrid[targetGridPos.x, targetGridPos.y] ! null) { // 如果目标位置无效有图块或出界让图块回到原位置 tile.MoveToPosition(tile.CurrentRow, tile.CurrentCol, 0.15f); return; } // 3. 检查目标位置是否与图块当前位置相邻曼哈顿距离为1 Vector2Int currentGridPos new Vector2Int(tile.CurrentRow, tile.CurrentCol); if (GetManhattanDistance(currentGridPos, targetGridPos) ! 1) { tile.MoveToPosition(tile.CurrentRow, tile.CurrentCol, 0.15f); return; } // 4. 执行交换将图块移动到空位 // 更新逻辑网格 tileGrid[currentGridPos.x, currentGridPos.y] null; // 原位置变空 tileGrid[targetGridPos.x, targetGridPos.y] tile; // 新位置放上图块 // 5. 移动图块带动画 tile.MoveToPosition(targetGridPos.x, targetGridPos.y, 0.2f); // 6. 更新完成计数器优化判定 UpdateCorrectCountAfterMove(tile, currentGridPos, targetGridPos); } private int GetManhattanDistance(Vector2Int a, Vector2Int b) { return Mathf.Abs(a.x - b.x) Mathf.Abs(a.y - b.y); } private void UpdateCorrectCountAfterMove(Tile tile, Vector2Int from, Vector2Int to) { bool wasCorrect (from.x tile.CorrectRow from.y tile.CorrectCol); bool isCorrectNow (to.x tile.CorrectRow to.y tile.CorrectCol); if (wasCorrect !isCorrectNow) { correctTilesCount--; } else if (!wasCorrect isCorrectNow) { correctTilesCount; } // 每次移动后都检查是否完成 CheckForCompletion(); } public void CheckForCompletion() { if (correctTilesCount (rows * cols - 1)) // 总格子数减空位数 { Debug.Log(拼图完成); // 通知GameManager游戏胜利停止计时显示胜利UI等 GameManager.Instance.OnPuzzleCompleted(); } } }代码解读与技巧WorldToGridPosition这是一个关键函数需要将鼠标释放的世界坐标反向计算出行列索引。这通常涉及对棋盘原点、图块尺寸和间距的逆运算。实现时要特别注意边界处理避免索引越界。曼哈顿距离GetManhattanDistance用于判断是否相邻。对于网格移动曼哈顿距离为1意味着两个格子是上下或左右相邻的关系。这是滑动拼图的标准规则。优化计数器UpdateCorrectCountAfterMove函数展示了之前提到的优化思路。我们只关心被移动的这一个图块的状态变化而不是遍历全部。这极大地提升了性能。胜利条件correctTilesCount (rows * cols - 1)。因为有一个空位所以所有非空图块都归位即胜利。如果实现的是无空位的交换式拼图则条件应为correctTilesCount (rows * cols)。5. 功能扩展与性能优化实战指南一个基础的拼图游戏运行起来后我们通常会考虑如何让它更好玩、更专业。这里提供几个常见的扩展方向和优化点。5.1 必备的扩展功能实现多关卡与难度系统实现创建一个LevelData的ScriptableObject资产里面定义关卡ID、对应的图片、行数、列数。在GameManager或一个单独的LevelManager中管理一个关卡列表。流程游戏主菜单选择关卡 - 加载对应LevelData- 传递给PuzzleManager生成拼图 - 开始游戏。数据持久化使用PlayerPrefs或JSON文件保存每个关卡的解锁状态、最佳完成时间、最少步数。提示与预览功能提示高亮显示一个可以移动到空位的图块或者直接显示其正确位置的半透明轮廓。这可以通过在PuzzleManager中计算空位周围可移动的图块来实现。原图预览在游戏界面角落显示一个完整的、缩小版的原图或者提供一个按钮按下时临时显示全图蒙版。这能显著降低游戏难度提升用户体验。步数、计时与评分系统步数在PuzzleManager的AttemptMoveTile中每次有效的移动即执行了交换后步数计数器加1。计时在GameManager中用一个float变量累计游戏时间在Update中增加Time.deltaTime。游戏完成时停止计时。评分可以根据完成时间和步数综合计算一个星级评分。例如时间越短、步数越少星级越高。音效与粒子反馈音效为图块拖动开始、放置、错误放置、拼图完成等事件添加对应的音效。使用Unity的AudioSource组件或更高级的音频管理器如FMOD、Wwise的简单集成。粒子在图块正确归位或游戏完成时播放庆祝性的粒子效果能极大增强游戏的正反馈。5.2 性能优化与常见问题排查即使是一个2D小游戏不注意性能也会在低端设备上出现问题。对象池优化图块创建问题每次开始新游戏或新关卡时都Instantiate和Destroy大量图块会产生GC垃圾回收压力可能导致瞬间卡顿。解决方案实现一个简单的对象池。游戏初始化时一次性生成最大可能需要的图块数量如5x525个并禁用它们。需要时从池中取出启用不需要时放回池中禁用。这样可以避免运行时频繁的内存分配与释放。输入冲突与UI穿透问题当UI按钮覆盖在拼图区域上时点击按钮可能会同时触发图块的拖拽事件。解决方案Unity的EventSystem会处理输入事件的传递。确保你的UI按钮使用了Graphic Raycaster而图块使用的是物理射线检测Physics2D.Raycast。通常EventSystem会优先处理UI事件。更可靠的方法是在Tile的OnMouseDown中检查EventSystem.current.IsPointerOverGameObject()如果返回true说明点击在了UI上则不应开始拖拽。图块“粘手”或拖动不跟手问题拖动图块时感觉延迟或者松开鼠标后图块还“粘”在鼠标上。排查帧率问题确保游戏运行帧率稳定。在Update或OnMouseDrag中进行连续的位置更新帧率低下会导致移动不连贯。坐标转换错误检查ScreenToWorldPoint转换是否正确。特别是摄像机的Projection模式正交Orthographic和Z坐标的处理。确保转换后的世界坐标Z值与图块一致通常为0。碰撞体干扰确认在拖动开始时就关闭了图块自身的碰撞体如前文代码所示。移动端触摸适配问题在手机或平板上触摸操作不灵敏多点触控可能引发混乱。适配将OnMouseDown等系列事件替换为Unity的Event Trigger组件或实现IPointerDownHandler,IDragHandler,IEndDragHandler接口。这些接口是Unity UI系统的一部分对触摸的支持更好。需要为图块添加Canvas和Graphic Raycaster组件或使用Physics2D Raycaster并将其设置为World Space渲染模式。内存管理与资源释放问题动态切割Sprite时如果没有正确管理可能导致内存泄漏。最佳实践当切换关卡或退出游戏时确保销毁动态创建的Sprite对象Destroy(sprite)。对于从Resources加载的原始纹理Unity通常会自动管理但动态创建的精灵需要手动处理。这份免费的Unity2D拼图游戏源码就像一套精心设计的乐高积木。它提供了所有基础零件和搭建说明书。你的任务不仅仅是照着说明书拼出一个模型更是要理解每个零件的用途然后发挥创意用它们搭建出城堡、飞船或者任何你想要的东西。从理解管理器模式到掌握协程动画再到优化性能和处理输入这个项目所涵盖的知识点足以让你迈出从Unity学习者到实践者的坚实一步。 
长河君 · 2026/8/5 22:04:48 · 阅读 1.2k Unity2D拼图游戏源码解析：从架构设计到核心算法实现
1. 项目概述一份免费的Unity2D拼图游戏源码意味着什么最近在整理自己的资源库翻出来一份几年前写的Unity2D拼图游戏源码当时是为了带新人熟悉Unity工作流和C#脚本逻辑而做的教学项目。看到网上很多朋友在找类似的免费资源索性就把它整理出来并配上详细的解析。这份源码麻雀虽小五脏俱全它不是一个简单的“玩具”而是一个包含了核心游戏循环、UI交互、数据管理和扩展接口的完整项目框架。无论你是刚接触Unity的初学者想通过一个具体案例上手还是有一定经验的开发者想快速搭建一个拼图游戏的雏形进行二次开发这份源码都能提供一个非常扎实的起点。很多人觉得“拼图游戏”太简单没什么技术含量。但恰恰是这种看似简单的项目最能考验一个开发者对基础模块的封装能力、对状态管理的理解以及对用户体验细节的把握。在这份源码里你会看到如何优雅地处理图片的切割与打乱、如何实现拖拽与吸附的流畅交互、如何设计一个可配置的游戏管理器来掌控全局以及如何记录游戏进度和计时。这些模块化的设计思路是制作任何类型游戏都通用的“内功”。接下来我就带你深入这份源码看看每一个部分是怎么运作的以及在实际开发中需要注意哪些“坑”。2. 源码整体架构与核心模块拆解拿到一份源码最忌讳的就是一头扎进代码细节里。我们先从上帝视角看看这个项目的整体文件夹结构和各个模块是如何协同工作的。一个结构清晰的Unity项目能极大提升后续的阅读、修改和维护效率。2.1 项目目录结构解析典型的Unity2D拼图游戏项目其Assets目录通常会包含以下几个核心文件夹Scripts: 这是代码的核心。里面会按功能进一步细分比如Managers管理器、Gameplay游戏逻辑、UI界面控制等。Sprites: 存放所有游戏用到的2D精灵图片包括完整的原图、切割后的小图块以及UI按钮图标等。Prefabs: 预制体文件夹。拼图游戏的核心预制体就是“图块”Tile我们会将图块做成预制体方便在运行时动态生成。Scenes: 场景文件。至少会有一个主游戏场景MainGame可能还会有开始菜单Menu、关卡选择LevelSelect等。Audio: 音效和背景音乐资源。Resources或StreamingAssets: 如果需要从外部动态加载拼图图片可能会用到这些文件夹。在这份源码中其结构基本遵循了这个范式。Scripts文件夹是我们要重点剖析的对象它定义了整个游戏的运行逻辑。2.2 核心脚本职责划分脚本之间职责清晰、耦合度低是评价一份源码质量的重要标准。这个拼图项目主要包含以下几个核心脚本GameManager(游戏管理器): 单例模式。它是游戏的大脑负责全局状态管理例如游戏开始、暂停、结束的判断计时器的启动与停止胜负条件的校验以及作为其他模块之间的通信枢纽。PuzzleManager或BoardManager(拼图板管理器): 负责拼图游戏最核心的逻辑。包括根据选定的图片和行列数动态生成拼图网格将原图切割成多个图块打乱图块的初始顺序以及判断当前拼图是否完成。Tile(图块脚本): 挂载在每个拼图块预制体上。它负责处理单个图块的交互逻辑最主要的就是鼠标或触摸的拖拽Drag和释放Drop事件。当图块被释放时它需要与PuzzleManager通信尝试与目标位置通常是空位交换。UIManager(界面管理器): 控制所有UI元素的显示、隐藏和更新。例如显示计时、步数、完成百分比控制开始、暂停、重置按钮的响应弹出游戏完成后的胜利界面。DataManager(数据管理器): 可选但推荐。负责玩家数据的持久化例如保存每个关卡的最佳完成时间、最少步数或者游戏的解锁进度。通常使用PlayerPrefs进行简单存储对于复杂数据可以考虑JSON或ScriptableObject。这种“管理器组件”的模式在Unity中非常普遍。GameManager作为总指挥PuzzleManager负责业务核心Tile作为可交互的个体UIManager负责呈现各司其职修改和调试起来都会非常方便。注意在实际阅读源码时你可能会发现有些开发者喜欢把PuzzleManager的功能合并到GameManager中。对于小项目这无可厚非但随着功能增加比如加入多关卡、道具系统代码会变得臃肿且难以维护。因此即使在这个“小”项目中看到分层的设计也值得你学习和借鉴。3. 核心玩法实现细节深度剖析理解了架构我们深入到最有趣的“拼图”本身。这一部分将拆解图片切割、图块交互、完成判定这三个核心环节的具体实现和其中的技术选型考量。3.1 图片动态切割与图块生成拼图游戏的第一步是把一张完整的图片变成N个乱序的小图块。这里有两种主流实现方式方案A运行时动态切割这是本源码采用的主要方式灵活性最高。在PuzzleManager的Start()或一个初始化方法中我们会进行以下操作加载原图通过Resources.LoadSprite或从UI上赋值一个Sprite变量获取原图。计算图块尺寸根据设定的行数(rows)和列数(cols)用原图的宽度除以列数高度除以行数得到每个小图块的宽高。循环创建图块使用嵌套的for循环遍历每一行每一列。在循环体内使用new Rect(x, y, tileWidth, tileHeight)创建一个矩形区域定义要切割的图片部分。调用Sprite.Create(sourceTexture, rect, pivot)来创建一个新的精灵。这里的pivot轴心点通常设为(0.5f, 0.5f)即中心点方便后续定位和旋转。实例化Tile预制体将上一步创建的精灵赋值给它的SpriteRenderer组件。为这个图块对象设置一个逻辑坐标(row, col)代表它正确的位置。同时设置它当前所在的物理位置可能是打乱后的位置。方案B预切割图集对于一些性能要求苛刻或风格固定的项目可能会选择在美术阶段就预先切割好图片导入Unity后直接使用。这种方式省去了运行时的切割计算但失去了动态更换拼图图片的灵活性。为什么选择动态切割对于一份旨在教学和快速原型的源码来说动态切割的优势明显一份代码无限图片。你只需要替换Resources文件夹里的图片甚至允许玩家从相册选择图片就能立刻生成一个新的拼图极大地提升了项目的可玩性和扩展性。虽然每次启动有一点点性能开销但对于拼图这种轻量级游戏而言完全在可接受范围内。3.2 拖拽、吸附与交换逻辑这是玩家直接感知到的交互核心体验是否流畅全看这里。Tile脚本是实现这一功能的主力。拖拽实现 通常是在Tile脚本中实现OnMouseDown、OnMouseDrag、OnMouseUp这一系列事件对于移动端则需要使用IPointerDownHandler等UI事件接口。在OnMouseDown时记录被点击的图块。在OnMouseDrag时最常见且体验较好的做法是让图块跟随鼠标移动但将其z坐标稍微调前并暂时关闭它的碰撞体以避免拖动过程中与其他图块发生不必要的交互。代码上就是每帧更新图块的transform.position为鼠标的世界坐标。吸附与交换逻辑 这是算法的精髓所在。我们不会让玩家像玩华容道一样把图块精确地挪到一个小格子里那样体验太差。通常采用“邻近交换”规则只有当拖动的图块被释放时判断其当前位置与那个唯一的“空位”或目标位是否相邻上下左右。如果相邻则执行交换动画如果不相邻则让图块平滑地回到拖动前的位置。在PuzzleManager中我们需要维护一个二维数组tileGrid[,]来记录每个网格位置当前存放的是哪个Tile对象空位则为null。当Tile被释放时Tile脚本将自己的实例和释放时的位置信息发送给PuzzleManager。PuzzleManager根据释放位置换算成最近的网格坐标。检查这个目标网格是否是空位并且是否与图块原来的网格位置相邻通过计算行差和列差的绝对值之和是否为1来判断。如果条件满足则执行交换更新tileGrid数组中的数据并启动一个协程Coroutine来让两个图块或图块与空位平滑地移动到对方的位置使用Vector3.Lerp。交换完成后立即调用CheckForCompletion()方法检查拼图是否完成。实操心得在实现拖动时我强烈建议将“跟随鼠标移动”的计算放在LateUpdate中或者使用Update但确保计算顺序。这样可以避免因为其他脚本的Update修改了位置而出现抖动。另外交换动画的时间如0.2秒不宜过长或过短0.2-0.3秒是一个比较舒适的区间既能看清移动过程又不会让玩家觉得拖沓。3.3 游戏完成判定算法如何判断一堆乱序的图块已经被拼成了原图最直观的方法就是遍历所有图块检查每个图块当前所在的物理位置是否等于它记录的逻辑正确位置。在PuzzleManager的CheckForCompletion()方法中遍历tileGrid数组中的每一个元素即每一个网格位置。对于非空的位置获取该位置上的Tile组件。读取该Tile上记录的correctRow和correctCol正确行列坐标。将correctRow、correctCol与当前遍历的网格索引i,j进行比较。如果所有图块都满足tile.correctRow i tile.correctCol j则判定拼图完成。这里有一个关键优化点我们不需要在每次交换后都遍历整个棋盘。可以在PuzzleManager中设置一个计数器correctTilesCount。初始化时所有图块都不在正确位置计数器为0。每当一次交换使得一个图块移动到了它的正确位置计数器就加1如果一个原本在正确位置的图块被移开了计数器就减1。这样完成判定的条件就简化为判断correctTilesCount是否等于总图块数。这比全盘遍历要高效得多尤其是在拼图块数很多的时候。关于“空位”的处理 在经典的滑动拼图中会有一个空位。在我们的实现中可以创建一个“空白图块”预制体它拥有一个透明的精灵和碰撞体参与所有的交换逻辑。也可以不创建实体只在tileGrid数组中用null表示空位在交互判断时特殊处理。两种方式各有优劣实体化空位会让交换逻辑更统一所有格子都有对象而使用null则更节省资源。源码中通常采用后者因为它更简洁。4. 关键脚本代码解读与编写技巧光说不练假把式我们来看一些核心代码片段并解释其背后的设计意图和编写技巧。请注意以下代码是示意性的融合了最佳实践可能与原始源码不完全相同但逻辑相通。4.1 PuzzleManager拼图世界的构建者PuzzleManager的CreatePuzzleBoard方法是整个游戏的起点。public class PuzzleManager : MonoBehaviour { public Sprite sourceImage; // 原始拼图图片 public GameObject tilePrefab; // 图块预制体 public int rows 3; public int cols 3; public float spacing 0.1f; // 图块之间的间隙 private Tile[,] tileGrid; // 逻辑网格 private ListVector2Int shufflePositions new ListVector2Int(); // 用于打乱的位置列表 private int correctTilesCount 0; void Start() { GeneratePuzzle(); ShuffleTiles(); } void GeneratePuzzle() { tileGrid new Tile[rows, cols]; Texture2D sourceTexture sourceImage.texture; float tileWidth sourceTexture.width / (float)cols; float tileHeight sourceTexture.height / (float)rows; // 创建棋盘背景可选用于显示完整图片的淡影 // ... // 循环创建每一个图块 for (int r 0; r rows; r) { for (int c 0; c cols; c) { // 计算该图块在原始图片上的UV矩形 Rect rect new Rect(c * tileWidth, (rows - 1 - r) * tileHeight, tileWidth, tileHeight); // 注意纹理坐标原点在左下角而我们的网格从左上角开始创建所以用(rows-1-r)进行Y轴翻转 Sprite newSprite Sprite.Create(sourceTexture, rect, new Vector2(0.5f, 0.5f)); // 实例化图块 GameObject tileObj Instantiate(tilePrefab, this.transform); Tile tileScript tileObj.GetComponentTile(); tileScript.Initialize(this, newSprite, r, c); // 初始化传入管理器引用、精灵和正确坐标 // 计算图块在游戏世界中的初始位置按正确顺序排列 Vector3 tilePos CalculateWorldPosition(r, c); tileObj.transform.localPosition tilePos; // 将图块存入逻辑网格 tileGrid[r, c] tileScript; // 同时记录这个“正确”位置用于后续打乱 shufflePositions.Add(new Vector2Int(r, c)); } } // 创建后移除最后一个图块作为初始空位假设是右下角 CreateInitialEmptySlot(rows - 1, cols - 1); } Vector3 CalculateWorldPosition(int row, int col) { // 根据行列、图块尺寸和间隙计算世界坐标 // 假设图块预制体本身的Scale就是1单位对应1像素 float posX col * (1 spacing); float posY -row * (1 spacing); // Y轴向下为负符合2D惯例 return new Vector3(posX, posY, 0); } void CreateInitialEmptySlot(int emptyRow, int emptyCol) { if (tileGrid[emptyRow, emptyCol] ! null) { Destroy(tileGrid[emptyRow, emptyCol].gameObject); tileGrid[emptyRow, emptyCol] null; // 从打乱位置列表中移除这个位置因为它现在是空位 shufflePositions.Remove(new Vector2Int(emptyRow, emptyCol)); } } }代码解读与技巧rows - 1 - r这是一个关键细节。因为Unity中纹理坐标UV的原点(0,0)在左下角而我们在逻辑上通常习惯从左上角开始第0行。所以用(rows - 1 - r)来进行Y轴翻转确保切割出的第一块精灵对应原图的左上角。Initialize方法将PuzzleManager的引用传递给每个Tile这是双向通信的基础。Tile需要调用管理器的方法来尝试交换。shufflePositions列表它记录了所有非空网格的位置专门用于后续的打乱算法避免对空位进行无效操作。创建空位在生成所有正确图块后主动销毁其中一个通常是右下角来创建初始空位。这是一种清晰的初始化方式。4.2 Tile灵敏的交互单元Tile脚本负责响应玩家的输入。public class Tile : MonoBehaviour { private PuzzleManager puzzleManager; private int correctRow, correctCol; private int currentRow, currentCol; private bool isDragging false; private Vector3 dragOffset; private Collider2D myCollider; public void Initialize(PuzzleManager manager, Sprite sprite, int row, int col) { puzzleManager manager; correctRow row; correctCol col; currentRow row; // 初始时当前位置就是正确位置 currentCol col; GetComponentSpriteRenderer().sprite sprite; myCollider GetComponentCollider2D(); } // 鼠标按下开始拖动 private void OnMouseDown() { if (puzzleManager.IsGameActive) // 游戏管理器控制游戏是否可交互 { isDragging true; myCollider.enabled false; // 关闭碰撞体防止拖动时阻挡射线检测 Vector3 mouseWorldPos Camera.main.ScreenToWorldPoint(Input.mousePosition); mouseWorldPos.z 0; dragOffset transform.position - mouseWorldPos; } } // 鼠标拖动中 private void OnMouseDrag() { if (isDragging) { Vector3 mouseWorldPos Camera.main.ScreenToWorldPoint(Input.mousePosition); mouseWorldPos.z 0; transform.position mouseWorldPos dragOffset; } } // 鼠标释放 private void OnMouseUp() { if (isDragging) { isDragging false; myCollider.enabled true; // 重新启用碰撞体 // 通知管理器尝试将此图块移动到鼠标释放的位置 puzzleManager.AttemptMoveTile(this, transform.position); } } // 由PuzzleManager调用移动图块到指定网格位置 public void MoveToPosition(int targetRow, int targetCol, float duration) { currentRow targetRow; currentCol targetCol; Vector3 targetPos puzzleManager.CalculateWorldPosition(targetRow, targetCol); StartCoroutine(SmoothMove(targetPos, duration)); } private IEnumerator SmoothMove(Vector3 target, float duration) { Vector3 startPos transform.position; float elapsed 0f; while (elapsed duration) { transform.position Vector3.Lerp(startPos, target, elapsed / duration); elapsed Time.deltaTime; yield return null; // 等待下一帧 } transform.position target; // 确保最终位置精确 // 移动完成后可以通知管理器检查游戏是否完成 puzzleManager.OnTileMoved(); } }代码解读与技巧dragOffset计算鼠标点击点与图块中心点的偏移量。如果不计算这个偏移图块中心会瞬间“跳”到鼠标位置体验很突兀。加上偏移后拖动时能保持鼠标与图块的相对位置不变。开关碰撞体在开始拖动时关闭碰撞体myCollider.enabled false是至关重要的一步。如果不关闭当你拖动一个图块经过另一个图块时可能会因为碰撞体的阻挡而无法顺畅移动或者触发不必要的物理事件。协程移动SmoothMove协程提供了平滑的移动动画。使用Vector3.Lerp进行线性插值是最简单的方式。对于更复杂的动画曲线如先快后慢可以使用AnimationCurve或第三方插件如DOTween。4.3 PuzzleManager处理移动与完成判定接着看PuzzleManager如何处理Tile发来的移动请求和完成判定。public class PuzzleManager : MonoBehaviour { // ... 其他变量 ... public void AttemptMoveTile(Tile tile, Vector3 releaseWorldPos) { // 1. 将释放的世界坐标转换为网格坐标 Vector2Int targetGridPos WorldToGridPosition(releaseWorldPos); // 2. 检查目标位置是否在网格范围内且是空位 if (!IsPositionInGrid(targetGridPos) || tileGrid[targetGridPos.x, targetGridPos.y] ! null) { // 如果目标位置无效有图块或出界让图块回到原位置 tile.MoveToPosition(tile.CurrentRow, tile.CurrentCol, 0.15f); return; } // 3. 检查目标位置是否与图块当前位置相邻曼哈顿距离为1 Vector2Int currentGridPos new Vector2Int(tile.CurrentRow, tile.CurrentCol); if (GetManhattanDistance(currentGridPos, targetGridPos) ! 1) { tile.MoveToPosition(tile.CurrentRow, tile.CurrentCol, 0.15f); return; } // 4. 执行交换将图块移动到空位 // 更新逻辑网格 tileGrid[currentGridPos.x, currentGridPos.y] null; // 原位置变空 tileGrid[targetGridPos.x, targetGridPos.y] tile; // 新位置放上图块 // 5. 移动图块带动画 tile.MoveToPosition(targetGridPos.x, targetGridPos.y, 0.2f); // 6. 更新完成计数器优化判定 UpdateCorrectCountAfterMove(tile, currentGridPos, targetGridPos); } private int GetManhattanDistance(Vector2Int a, Vector2Int b) { return Mathf.Abs(a.x - b.x) Mathf.Abs(a.y - b.y); } private void UpdateCorrectCountAfterMove(Tile tile, Vector2Int from, Vector2Int to) { bool wasCorrect (from.x tile.CorrectRow from.y tile.CorrectCol); bool isCorrectNow (to.x tile.CorrectRow to.y tile.CorrectCol); if (wasCorrect !isCorrectNow) { correctTilesCount--; } else if (!wasCorrect isCorrectNow) { correctTilesCount; } // 每次移动后都检查是否完成 CheckForCompletion(); } public void CheckForCompletion() { if (correctTilesCount (rows * cols - 1)) // 总格子数减空位数 { Debug.Log(拼图完成); // 通知GameManager游戏胜利停止计时显示胜利UI等 GameManager.Instance.OnPuzzleCompleted(); } } }代码解读与技巧WorldToGridPosition这是一个关键函数需要将鼠标释放的世界坐标反向计算出行列索引。这通常涉及对棋盘原点、图块尺寸和间距的逆运算。实现时要特别注意边界处理避免索引越界。曼哈顿距离GetManhattanDistance用于判断是否相邻。对于网格移动曼哈顿距离为1意味着两个格子是上下或左右相邻的关系。这是滑动拼图的标准规则。优化计数器UpdateCorrectCountAfterMove函数展示了之前提到的优化思路。我们只关心被移动的这一个图块的状态变化而不是遍历全部。这极大地提升了性能。胜利条件correctTilesCount (rows * cols - 1)。因为有一个空位所以所有非空图块都归位即胜利。如果实现的是无空位的交换式拼图则条件应为correctTilesCount (rows * cols)。5. 功能扩展与性能优化实战指南一个基础的拼图游戏运行起来后我们通常会考虑如何让它更好玩、更专业。这里提供几个常见的扩展方向和优化点。5.1 必备的扩展功能实现多关卡与难度系统实现创建一个LevelData的ScriptableObject资产里面定义关卡ID、对应的图片、行数、列数。在GameManager或一个单独的LevelManager中管理一个关卡列表。流程游戏主菜单选择关卡 - 加载对应LevelData- 传递给PuzzleManager生成拼图 - 开始游戏。数据持久化使用PlayerPrefs或JSON文件保存每个关卡的解锁状态、最佳完成时间、最少步数。提示与预览功能提示高亮显示一个可以移动到空位的图块或者直接显示其正确位置的半透明轮廓。这可以通过在PuzzleManager中计算空位周围可移动的图块来实现。原图预览在游戏界面角落显示一个完整的、缩小版的原图或者提供一个按钮按下时临时显示全图蒙版。这能显著降低游戏难度提升用户体验。步数、计时与评分系统步数在PuzzleManager的AttemptMoveTile中每次有效的移动即执行了交换后步数计数器加1。计时在GameManager中用一个float变量累计游戏时间在Update中增加Time.deltaTime。游戏完成时停止计时。评分可以根据完成时间和步数综合计算一个星级评分。例如时间越短、步数越少星级越高。音效与粒子反馈音效为图块拖动开始、放置、错误放置、拼图完成等事件添加对应的音效。使用Unity的AudioSource组件或更高级的音频管理器如FMOD、Wwise的简单集成。粒子在图块正确归位或游戏完成时播放庆祝性的粒子效果能极大增强游戏的正反馈。5.2 性能优化与常见问题排查即使是一个2D小游戏不注意性能也会在低端设备上出现问题。对象池优化图块创建问题每次开始新游戏或新关卡时都Instantiate和Destroy大量图块会产生GC垃圾回收压力可能导致瞬间卡顿。解决方案实现一个简单的对象池。游戏初始化时一次性生成最大可能需要的图块数量如5x525个并禁用它们。需要时从池中取出启用不需要时放回池中禁用。这样可以避免运行时频繁的内存分配与释放。输入冲突与UI穿透问题当UI按钮覆盖在拼图区域上时点击按钮可能会同时触发图块的拖拽事件。解决方案Unity的EventSystem会处理输入事件的传递。确保你的UI按钮使用了Graphic Raycaster而图块使用的是物理射线检测Physics2D.Raycast。通常EventSystem会优先处理UI事件。更可靠的方法是在Tile的OnMouseDown中检查EventSystem.current.IsPointerOverGameObject()如果返回true说明点击在了UI上则不应开始拖拽。图块“粘手”或拖动不跟手问题拖动图块时感觉延迟或者松开鼠标后图块还“粘”在鼠标上。排查帧率问题确保游戏运行帧率稳定。在Update或OnMouseDrag中进行连续的位置更新帧率低下会导致移动不连贯。坐标转换错误检查ScreenToWorldPoint转换是否正确。特别是摄像机的Projection模式正交Orthographic和Z坐标的处理。确保转换后的世界坐标Z值与图块一致通常为0。碰撞体干扰确认在拖动开始时就关闭了图块自身的碰撞体如前文代码所示。移动端触摸适配问题在手机或平板上触摸操作不灵敏多点触控可能引发混乱。适配将OnMouseDown等系列事件替换为Unity的Event Trigger组件或实现IPointerDownHandler,IDragHandler,IEndDragHandler接口。这些接口是Unity UI系统的一部分对触摸的支持更好。需要为图块添加Canvas和Graphic Raycaster组件或使用Physics2D Raycaster并将其设置为World Space渲染模式。内存管理与资源释放问题动态切割Sprite时如果没有正确管理可能导致内存泄漏。最佳实践当切换关卡或退出游戏时确保销毁动态创建的Sprite对象Destroy(sprite)。对于从Resources加载的原始纹理Unity通常会自动管理但动态创建的精灵需要手动处理。这份免费的Unity2D拼图游戏源码就像一套精心设计的乐高积木。它提供了所有基础零件和搭建说明书。你的任务不仅仅是照着说明书拼出一个模型更是要理解每个零件的用途然后发挥创意用它们搭建出城堡、飞船或者任何你想要的东西。从理解管理器模式到掌握协程动画再到优化性能和处理输入这个项目所涵盖的知识点足以让你迈出从Unity学习者到实践者的坚实一步。