1. 项目概述为什么Unity局域网联机是独立开发者的必修课如果你正在用Unity做游戏尤其是想做点能和朋友一起玩的那么局域网联机这个坎儿你迟早得迈过去。这玩意儿听起来挺“硬核”好像是大厂后端工程师才玩得转的东西但其实对于独立开发者和小团队来说实现一个稳定、可玩的局域网联机功能远没有想象中那么复杂。它不涉及复杂的云服务器租赁、公网IP映射或者高并发的压力测试核心就是让你在同一个Wi-Fi或者路由器下的几台设备能够互相发现、连接并同步游戏状态。我见过太多Demo做得很棒但一到“多人模式”就卡住的个人项目。要么是网络消息不同步你打你的我打我的要么是延迟高得离谱动作像幻灯片更常见的是连接过程极其不稳定时断时连。这些问题根源往往不在于代码写得有多烂而在于对Unity网络底层逻辑和局域网特性的理解不够透彻。今天我就把自己在几个上线项目中趟过的坑、总结的经验掰开揉碎了讲给你听。无论你是想做一款本地多人派对游戏还是为你的Roguelike游戏增加一个合作模式这篇文章都能给你一套从理论到实践、可直接“抄作业”的完整方案。2. 核心架构选型Mirror还是自研这是个问题在动手写第一行代码之前你必须做一个关键决策选择什么样的网络框架。这个选择决定了你后续至少80%的开发体验和最终效果。目前Unity社区的主流选择非常清晰但各有优劣。2.1 主流方案横向对比1. Unity官方弃子UNET (HLAPI/LLAPI)这是Unity早年推出的官方方案但现在Unity 2022 LTS及以后已被标记为弃用。虽然网上老教程很多但强烈不建议新项目使用。它的API设计较为陈旧社区支持几乎停滞未来兼容性是大问题。除非你在维护一个非常古老的项目否则请直接跳过。2. 社区首选Mirror NetworkingMirror是目前Unity社区最活跃、最受欢迎的第三方网络库没有之一。它最初是基于UNET HLAPI的一个分支但经过多年发展已经脱胎换骨修复了大量BUG增加了许多强大功能并且文档和社区支持都非常好。核心优势 高兼容性支持Unity各版本、API友好对UNET用户平滑过渡、功能丰富内置了房间管理、断线重连、网络发现等常用模块、性能经过大量项目验证。工作原理 Mirror采用权威服务器Authoritative Server架构。在局域网游戏中通常由其中一台玩家主机同时充当“服务器”和“客户端”Host模式。这台主机负责所有游戏逻辑的最终裁决比如伤害计算、物品刷新其他玩家作为纯客户端连接进来。这能有效防止外挂和状态不同步。适合人群 绝大多数独立开发者和中小团队。它能让你用最少的时间搭建一个稳定可靠的原型。3. 底层控制LiteNetLib或Netcode for GameObjects (NGO)如果你需要极致的性能和控制力或者你的游戏类型非常特殊比如需要大量UDP广播的实时竞技游戏可以考虑更底层的方案。LiteNetLib 一个轻量级、高效的C# UDP网络库。你需要自己实现序列化、反序列化、连接管理、可靠性保证等几乎所有功能自由度极高但开发成本也巨大。Unity Netcode for GameObjects (NGO) Unity新的官方多人游戏解决方案目前仍在积极开发中。它更侧重于与Unity编辑器深度集成和云部署Unity Netcode对于纯局域网游戏来说Mirror目前成熟度更高。我的选择与建议 对于90%的局域网联机需求直接选择Mirror。它能帮你避开无数底层坑把精力集中在游戏玩法本身。本文后续的实操也将基于Mirror展开。这就像你要组装一台电脑Mirror是给你提供了主板、CPU、内存一套搭配好的套餐而底层库是给你一堆晶体管和电路板让你自己焊。2.2 理解局域网联机的核心模型客户端-服务器C/S与主机模式即使使用Mirror你也必须理解其背后的网络模型。在局域网环境中我们通常采用一种特殊的C/S模型监听服务器模式Listen Server或主机模式Host。服务器Server 在局域网中服务器就是创建游戏的那台设备。它运行着完整的游戏逻辑是所有游戏状态的“权威”。它负责生成怪物、计算物理、验证玩家操作。客户端Client 其他加入游戏的设备。它们将玩家的输入按键、鼠标发送给服务器并从服务器接收最新的游戏世界状态其他玩家的位置、血量、场景变化等然后在本地进行渲染。主机Host 创建游戏的玩家他的设备同时运行着服务器程序和客户端程序。他既是裁判服务器又是运动员客户端。这种模型的好处是架构清晰状态唯一易于同步。坏处是主机玩家的设备性能会影响到所有玩家的体验且主机掉线则游戏结束。对于局域网合作游戏这通常是可接受的。3. 环境准备与Mirror基础配置理论说完了我们开始动手。第一步是把环境搭起来。3.1 导入Mirror并创建基础场景新建项目 创建一个新的Unity项目建议使用3D核心模板版本推荐2021 LTS或2022 LTS稳定性好。导入Mirror 最推荐的方式是通过Unity的Package Manager从Git URL添加。打开Window - Package Manager点击左上角“”号选择“Add package from git URL”输入https://github.com/MirrorNetworking/Mirror.git。等待导入完成。这种方式能确保你获得最新稳定版。创建网络管理器 Mirror的核心是一个叫做NetworkManager的组件。在Hierarchy中创建一个空物体命名为“NetworkManager”然后为其添加NetworkManager和KcpTransport或SimpleWebTransport组件。NetworkManager负责连接、玩家生成、场景切换等高层逻辑而Transport组件负责底层的数据传输。对于局域网KcpTransport基于UDP是性能最好的选择。配置NetworkManager将你的玩家预制体Player Prefab拖拽到NetworkManager组件中的Player Prefab槽位。这个预制体需要挂载NetworkIdentity组件。在Spawn Info列表里你可以注册其他需要在网络上同步生成的预制体比如怪物、子弹、宝箱等。3.2 制作你的第一个可同步玩家预制体玩家同步是联机游戏的核心。你需要创建一个代表玩家的游戏对象并让它能在所有客户端上出现且状态一致。创建玩家预制体 创建一个胶囊体Capsule或你的角色模型命名为“Player”。添加必要组件NetworkIdentity 这是Mirror识别一个对象是否为网络对象的标志。勾选Local Player Authority允许本地客户端控制这个对象的某些行为如移动输入。NetworkTransform 这是Mirror提供的用于同步位置、旋转和缩放的组件。直接添加上去大部分参数保持默认即可。它会自动将物体的Transform状态从服务器同步到所有客户端。编写玩家移动脚本 创建一个C#脚本例如PlayerMovement.cs。这里的关键是区分“本地玩家”和“远程玩家”。只有本地玩家才需要处理输入。using Mirror; using UnityEngine; public class PlayerMovement : NetworkBehaviour { public float moveSpeed 5f; private CharacterController controller; // 假设使用CharacterController void Start() { controller GetComponentCharacterController(); } void Update() { // 关键只有本地玩家自己控制的这个角色才执行输入和移动判断 if (!isLocalPlayer) { return; // 对于其他玩家控制的角色这个脚本不处理输入只接收网络同步的位置 } float horizontal Input.GetAxis(Horizontal); float vertical Input.GetAxis(Vertical); Vector3 move new Vector3(horizontal, 0, vertical).normalized; if (move.magnitude 0.1f) { controller.Move(move * moveSpeed * Time.deltaTime); } } }注意脚本继承自NetworkBehaviour而不是MonoBehaviour并且使用isLocalPlayer来判断控制权。[Client]属性可以确保该函数只在客户端调用。将脚本挂载到Player预制体上然后将整个Player对象拖入Project窗口生成一个预制体。最后将这个预制体赋值给之前NetworkManager的Player Prefab。4. 实现局域网发现与连接在互联网游戏中我们通过IP地址和端口直接连接。但在局域网中我们更希望有一个“游戏大厅”列表让玩家能自动发现并加入。Mirror提供了NetworkDiscovery组件来简化这个过程。4.1 配置与使用NetworkDiscovery添加组件 在之前的NetworkManager物体上再添加一个NetworkDiscovery组件。理解广播与响应NetworkDiscovery的工作原理很简单。当一台设备作为主机启动服务器时它会定时向局域网内广播一条消息“嗨我这里有个服务器端口是7777”广播。其他设备上的NetworkDiscovery组件会监听这些广播。当收到广播后它会向广播源发送一个请求“告诉我你的具体信息”响应然后收到包含服务器IP、端口、游戏名等信息的响应并将其添加到游戏列表里。创建UI 你需要创建一个简单的UI界面“启动主机(Host)”按钮 调用NetworkManager.singleton.StartHost()。这会同时启动服务器和客户端。“发现游戏”按钮 调用NetworkDiscovery.StartDiscovery()。一个列表如UI ContentText预制体来显示发现的服务器。编写发现逻辑脚本 创建一个UI管理脚本例如LobbyUI.cs。using Mirror; using UnityEngine; using UnityEngine.UI; using System.Collections.Generic; public class LobbyUI : MonoBehaviour { public NetworkDiscovery networkDiscovery; public Transform serverListContent; public GameObject serverEntryPrefab; private Dictionarystring, GameObject discoveredServers new Dictionarystring, GameObject(); // 当发现一个服务器时调用 public void OnDiscoveredServer(DiscoveryResponse response) { string serverKey response.EndPoint.Address.ToString(); // 用IP地址作为唯一标识 if (!discoveredServers.ContainsKey(serverKey)) { GameObject entry Instantiate(serverEntryPrefab, serverListContent); entry.GetComponentInChildrenText().text ${response.serverName} ({response.EndPoint.Address}); Button joinBtn entry.GetComponentInChildrenButton(); joinBtn.onClick.AddListener(() ConnectToServer(response.EndPoint.Address.ToString())); discoveredServers.Add(serverKey, entry); } } void ConnectToServer(string ipAddress) { // 停止发现避免干扰连接 networkDiscovery.StopDiscovery(); // 让NetworkManager连接到指定的IP地址Mirror默认端口7777 NetworkManager.singleton.networkAddress ipAddress; NetworkManager.singleton.StartClient(); } public void StartHostButton() { networkDiscovery.AdvertiseServer(); // 开始广播服务器 NetworkManager.singleton.StartHost(); } public void FindGamesButton() { discoveredServers.Clear(); // 清空服务器列表UI... networkDiscovery.StartDiscovery(); } }你需要将这个脚本挂载到你的UI Canvas上并将NetworkDiscovery组件和UI元素拖拽赋值。实操心得 局域网发现失败十有八九是防火墙的锅。在Windows上你需要在“Windows Defender 防火墙”中为你的Unity编辑器Unity.exe和游戏构建后的exe文件在“专用网络”和“公用网络”上分别添加入站规则允许UDP端口默认是7777和广播通信。这是新手最常踩的坑务必首先检查。4.2 处理网络地址与端口默认情况下Mirror的服务器监听所有网络接口0.0.0.0的7777端口。在大多数家庭局域网中这没有问题。但如果你在复杂的公司网络或开了多个虚拟机可能需要指定IP。你可以在NetworkManager的Network Address字段中设置服务器IP。对于主机通常留空或填“localhost”。对于客户端连接需要填写主机的局域网IP如192.168.1.100。端口可以在对应的Transport组件如KcpTransport中修改。确保所有玩家游戏中的端口设置一致。5. 游戏状态同步超越NetworkTransformNetworkTransform解决了基础的移动同步但一个真正的游戏有无数状态需要同步血量、弹药、技能冷却、开门状态、任务进度等等。Mirror提供了几种强大的同步机制。5.1 使用SyncVar同步简单变量[SyncVar]是同步单个变量最简单的方式。当服务器上这个变量的值改变时Mirror会自动将其同步给所有客户端。using Mirror; using UnityEngine; using UnityEngine.UI; public class PlayerHealth : NetworkBehaviour { [SyncVar(hook nameof(OnHealthChanged))] public int currentHealth 100; public int maxHealth 100; public Slider healthSlider; // UI血条 void Start() { if (healthSlider ! null) { healthSlider.maxValue maxHealth; healthSlider.value currentHealth; } } // 这个函数会在服务器上调用对玩家造成伤害 [Server] // 确保只有服务器能执行伤害计算 public void TakeDamage(int damage) { currentHealth - damage; if (currentHealth 0) { currentHealth 0; // 触发死亡逻辑例如 RpcDie(); } } // Hook方法当SyncVar的currentHealth在客户端发生变化时自动调用此函数 void OnHealthChanged(int oldHealth, int newHealth) { // 更新本地客户端的UI if (healthSlider ! null) { healthSlider.value newHealth; } // 也可以在这里播放受伤音效、屏幕特效等 Debug.Log($Health changed from {oldHealth} to {newHealth}); } }关键点[SyncVar]标记的变量其值的修改仅在服务器上生效才会被同步。在客户端修改是无效的。hook参数允许你指定一个函数当变量同步到客户端时自动调用该函数进行响应如更新UI、播放特效这是保持客户端表现与数据一致的关键。5.2 使用Command与ClientRpc进行主动通信[Command]和[ClientRpc]是双向通信的利器。[Command] 从客户端向服务器发送请求。函数名以Cmd开头。只有本地玩家对象isLocalPlayer为true发起的Command才会被发送到服务器执行。[ClientRpc] 从服务器向所有客户端或指定客户端发送指令。函数名以Rpc开头。用于通知客户端执行某些表现层的操作比如播放一段所有玩家都能看到的爆炸动画。public class PlayerShooting : NetworkBehaviour { public GameObject bulletPrefab; public Transform firePoint; void Update() { if (!isLocalPlayer) return; if (Input.GetButtonDown(Fire1)) { CmdFire(); // 客户端告诉服务器“我要开火了” } } [Command] void CmdFire() { // 以下逻辑在服务器上运行 // 1. 服务器进行射击判定是否有弹药是否冷却 // 2. 服务器生成子弹网络对象 GameObject bullet Instantiate(bulletPrefab, firePoint.position, firePoint.rotation); bullet.GetComponentRigidbody().velocity firePoint.forward * 50f; // 重要生成的对象必须通过NetworkServer.Spawn在网络上注册 NetworkServer.Spawn(bullet); // 3. 服务器命令所有客户端播放开火动画和音效 RpcOnFireEffect(); } [ClientRpc] void RpcOnFireEffect() { // 以下逻辑在所有客户端上运行包括主机客户端 // 播放枪口火焰粒子、音效等 GetComponentAudioSource().Play(); // 注意这里不需要判断isLocalPlayer因为所有客户端都要表现这个效果 } }重要原则所有核心游戏逻辑伤害计算、物品生成、胜负判定都必须在服务器Command中执行。客户端只负责发送输入请求和接收表现指令。这就是“权威服务器”架构它能从根本上杜绝大多数作弊行为。6. 高级议题与性能优化当你的游戏对象越来越多网络消息量会急剧上升。不加优化很快就会导致延迟飙升和卡顿。6.1 网络序列化优化默认情况下Mirror使用NetworkWriter/NetworkReader进行二进制序列化。对于复杂的自定义类或结构体你需要实现自定义序列化来减少数据量。using Mirror; using UnityEngine; public struct CustomPlayerState { public Vector3 position; public Quaternion rotation; public byte animationState; // 用byte代替int或string表示动画状态 public static CustomPlayerState Deserialize(NetworkReader reader) { return new CustomPlayerState { position reader.ReadVector3(), rotation reader.ReadQuaternion(), animationState reader.ReadByte() }; } public static void Serialize(NetworkWriter writer, CustomPlayerState state) { writer.WriteVector3(state.position); writer.WriteQuaternion(state.rotation); writer.WriteByte(state.animationState); } }然后在你的网络行为脚本中你可以直接读写这个结构体。通过精炼数据如用byte代替int用Vector2代替Vector3如果高度不变可以显著减少每帧同步的字节数。6.2 同步频率与优先级控制不是所有对象都需要每帧同步。NetworkTransform的同步间隔 在NetworkTransform组件上你可以设置syncInterval默认0.1秒。对于背景装饰物可以设置为1秒甚至更长对于主要玩家可以保持0.1秒或更低。自定义网络行为的同步 你可以在自己的NetworkBehaviour脚本中通过重写OnSerialize方法用于发送和OnDeserialize方法用于接收来手动控制同步的时机和内容实现更精细的控制。6.3 场景加载与玩家重生管理当玩家死亡后重生或者游戏切换关卡时需要妥善处理。玩家重生 不要在客户端直接Instantiate一个新的玩家预制体。正确的做法是在服务器端例如在PlayerHealth的死亡逻辑里销毁当前玩家对象NetworkServer.Destroy(gameObject)然后通过NetworkManager的玩家生成系统在指定的重生点重新生成一个新的玩家对象。这确保了所有客户端都能看到这个新玩家。场景同步NetworkManager有一个Offline Scene和Online Scene设置。当服务器加载一个新场景时使用NetworkManager.ServerChangeScene(“SceneName”)所有连接的客户端都会自动同步加载相同的场景。确保场景中所有需要持久存在的网络对象如NetworkIdentity都在服务器端生成。7. 调试、打包与实战问题排查开发过程中问题排查是关键。Mirror提供了不错的调试信息。7.1 利用日志与调试工具在NetworkManager组件中勾选Show Debug Messages可以在Console看到详细的网络事件日志连接、断开、消息发送等。在游戏运行时你可以打开“Network Scene”窗口Mirror菜单下可视化查看当前所有网络对象、连接状态和权限信息。善用Debug.Log并在关键的网络函数如CmdXXX,RpcXXX, Hook函数开始处打印信息带上isServer,isClient,isLocalPlayer等上下文能快速定位问题发生在哪一端。7.2 构建与分发构建设置 在File - Build Settings中添加你的主场景。为目标平台如Windows进行构建。分发包体 局域网联机需要每个玩家都运行相同的游戏版本。将构建好的exe文件以及对应的Data文件夹等打包分发给你的测试伙伴。运行测试主机 运行游戏点击“启动主机”。客户端 运行游戏点击“发现游戏”或直接在主机的局域网IP如192.168.1.100后加上端口号如:7777进行连接。如果使用发现功能确保所有设备在同一个网段且防火墙已放行。7.3 常见问题速查表问题现象可能原因排查步骤与解决方案客户端无法发现服务器1. 防火墙阻止UDP广播/通信。2. 网络不在同一子网。3.NetworkDiscovery组件未正确配置或启用。1.首要检查关闭防火墙或添加入站规则允许Unity编辑器/游戏exe的UDP端口。2. 确保所有电脑连接到同一个路由器/交换机。3. 检查主机是否调用了AdvertiseServer()客户端是否调用了StartDiscovery()。客户端能发现但连接失败1. 主机IP地址错误。2. 端口被占用或未开放。3. 游戏版本不一致。1. 让主机在命令行输入ipconfig查看本地IPIPv4地址客户端手动输入该IP尝试连接。2. 检查KcpTransport的端口设置确保未被其他程序占用。3. 确保所有人运行的是完全相同的游戏构建版本。玩家移动不同步1. 玩家预制体缺少NetworkTransform。2. 移动逻辑未放在Update中或未用isLocalPlayer判断。3.NetworkTransform的同步频率过低。1. 确认玩家预制体上有NetworkTransform组件。2. 检查移动脚本确保移动代码只在if (isLocalPlayer)块内执行。3. 适当降低NetworkTransform的syncInterval。只有主机能看到游戏物体变化1. 物体生成未使用NetworkServer.Spawn。2. 状态修改如[SyncVar]在客户端进行而非服务器。1.黄金法则所有需要在网络上存在的物体必须在服务器端用Instantiate生成后立即调用NetworkServer.Spawn(obj)。2. 检查修改[SyncVar]变量的代码是否被[Server]属性修饰或仅在服务器端执行。延迟Lag非常高1. 同步数据量过大。2. 同步频率过高。3. 主机性能瓶颈或网络拥堵。1. 优化序列化减少每个网络消息的大小。2. 提高非关键对象的syncInterval。3. 确保主机电脑性能足够并关闭其他占用网络的程序。最后一点个人体会 网络编程尤其是游戏网络是一个“三分编码七分调试”的活儿。第一次成功在局域网内看到另一个玩家角色动起来的时候那种成就感是无与伦比的。不要怕出问题上面那个问题表里的坑我几乎全踩过。最关键的是养成分层排查的习惯先确保物理连接防火墙、IP再检查逻辑连接Mirror组件、回调函数最后调试游戏状态同步Command/Rpc, SyncVar。当你把这些基础打牢后面再做更复杂的房间管理、状态同步、延迟补偿就有了坚实的立足点。