1. 项目概述为什么选择 Netcode for GameObject如果你正在 Unity 里折腾多人游戏大概率听说过 UNet也大概率被它折磨过。UNet 作为 Unity 早期的网络方案虽然提供了基础框架但其复杂的 HLAPI/LLAPI 分层、繁琐的序列化配置以及官方已明确宣布弃用Deprecated的状态让很多开发者在项目中途就望而却步。Netcode for GameObject简称 NGO的出现正是 Unity 为了填补 UNet 退役后留下的空白并提供一个更现代化、更易用的官方多人游戏解决方案。简单来说NGO 1.0.0 是一个基于 GameObject 和 MonoBehaviour 的、高级别的网络抽象层。它不像底层传输层那样需要你手动处理数据包、连接状态和序列化而是让你用熟悉的 Unity 开发模式——挂脚本、调方法、改属性——来实现网络同步。它的核心目标是让开发者能更专注于游戏逻辑本身而不是复杂的网络通信细节。对于刚接触多人游戏开发的你或者是从 UNet 迁移过来的老手NGO 的学习曲线要平缓得多。这次实战入门的第一篇我们的目标非常明确不搞复杂的理论直接动手搭建一个最基础的、可运行的多人同步场景。你会看到两个立方体一个由你控制另一个由你的朋友或另一个客户端实例控制你们能实时看到对方在场景中的移动。通过这个最小化的“Hello World”项目你能直观地理解 NGO 的核心工作流程网络管理器、网络对象、网络变量和远程过程调用。这不仅是入门的第一步也是后续所有复杂功能如玩家状态同步、武器射击、场景物体生成的基石。2. 环境准备与项目初始化2.1 Unity 版本与包管理器NGO 1.0.0 是一个通过 Unity 包管理器Package Manager安装的官方包这意味着它对 Unity 版本有一定要求。根据官方文档它支持 Unity 2020.3 LTS 及更高版本。我强烈建议你使用 2021.3 LTS 或 2022.3 LTS 这些长期支持版本它们在稳定性和兼容性上更有保障。打开 Unity Hub创建一个新的 3D 核心模板项目给它起个名字比如 “NGO_BasicDemo”。项目创建好后第一件事就是导入 NGO 包。点击菜单栏Window Package Manager在窗口左上角的包来源下拉菜单中选择 “Unity Registry”。然后在搜索框中输入 “Netcode”。你应该能看到一个名为 “Netcode for GameObjects” 的包确保版本是 1.0.0 或更高点击右下角的 “Install” 按钮。安装过程会自动处理所有依赖包括必需的 “Unity Transport” 包这是一个基于 UDP 的高性能网络传输层NGO 用它来处理底层的网络通信。注意安装后你可能会在控制台看到一些关于 “Multiplayer Tools” 或 “Burst” 的提示信息这通常是正常的依赖解析或编译过程只要没有报错红色错误信息就可以继续。2.2 初始场景设置安装完包我们开始搭建场景。在 Hierarchy 窗口右键创建一个空的 GameObject重命名为 “NetworkManager”。这个对象将是我们整个网络系统的中枢。接着在场景中创建一个 Plane平面作为地面调整一下位置和缩放让它足够大。再创建一个 Directional Light平行光保证基础照明。一个干净、简单的初始场景有助于我们排除无关的视觉干扰专注于网络逻辑。3. 核心组件配置NetworkManager 与 NetworkObject3.1 配置 NetworkManager 组件选中我们刚才创建的 “NetworkManager” 游戏对象在 Inspector 窗口中点击 “Add Component” 按钮搜索并添加NetworkManager组件。这是 NGO 的入口点和总控制器。添加后你会看到组件上有几个关键的字段需要配置。首先是最重要的Network Transport。点击这个字段旁边的圆形选择按钮会弹出一个菜单。在这里选择UnityTransport。这就是我们刚才安装的底层传输协议。UnityTransport提供了对可靠/不可靠传输、连接管理等的封装NGO 通过它与网络进行通信。使用默认配置即可对于本地测试和简单的互联网连接它已经足够。接下来是Player Prefab。这个字段定义了当玩家加入游戏时服务器将为该玩家生成哪个预制体作为其代表的游戏对象。我们现在还没有创建玩家预制体可以先留空稍后再回来设置。3.2 创建并配置玩家预制体与 NetworkObject在 Project 窗口中右键创建一个新的文件夹命名为 “Prefabs”。然后在 Hierarchy 中创建一个 Cube立方体重命名为 “PlayerCube”调整其位置到地面之上例如 Y0.5。这个立方体将代表我们的玩家。现在我们需要让这个立方体具备网络身份。选中 “PlayerCube”在 Inspector 中点击 “Add Component”搜索并添加NetworkObject组件。这是 NGO 的基石组件。任何需要在网络上同步、生成或销毁的游戏对象都必须挂载NetworkObject。它赋予了这个 GameObject 一个全局唯一的网络标识NetworkId。有了网络身份我们还需要一个脚本来控制它的移动和同步。在 Project 窗口的 “Prefabs” 文件夹里右键Create C# Script命名为 “PlayerController”。将这个脚本拖拽到 Hierarchy 中的 “PlayerCube” 对象上。然后将整个 “PlayerCube” 从 Hierarchy 窗口拖拽到 Project 窗口的 “Prefabs” 文件夹中以创建一个预制体。创建成功后Hierarchy 中的对象名称会变成蓝色。最后删除 Hierarchy 中原始的 “PlayerCube” 对象因为我们之后将通过网络动态生成它。现在回到 “NetworkManager” 对象。在 Inspector 中找到NetworkManager组件的Player Prefab字段将我们刚刚创建的 “PlayerCube” 预制体从 Project 窗口拖拽赋值给它。这一步至关重要它告诉网络管理器“当有新玩家连接时请实例化这个预制体作为他的化身。”4. 编写首个网络脚本PlayerController双击打开我们创建的 “PlayerController.cs” 脚本。我们将编写一个既能在本地控制玩家移动又能通过网络同步位置的基础脚本。using Unity.Netcode; using UnityEngine; public class PlayerController : NetworkBehaviour { public float moveSpeed 5f; private void Update() { // 关键点只有本地玩家控制的角色才执行输入检测和移动逻辑 if (!IsOwner) return; float horizontal Input.GetAxis(Horizontal); float vertical Input.GetAxis(Vertical); Vector3 movement new Vector3(horizontal, 0, vertical) * moveSpeed * Time.deltaTime; transform.Translate(movement); } }让我解释一下这段代码的核心继承自NetworkBehaviour这是所有网络脚本的基类它提供了NetworkObject、IsOwner、IsServer等关键网络属性。普通的MonoBehaviour无法直接使用这些网络功能。IsOwner属性这是 NGO 中一个极其重要的概念。它用于判断当前运行此脚本的游戏对象实例是否属于本地客户端即由本机控制的玩家。if (!IsOwner) return;这行代码是多人游戏客户端的黄金法则只处理自己角色的输入和逻辑。其他玩家的角色移动由他们自己的客户端计算并通过网络同步过来你的客户端只负责渲染他们的位置。移动逻辑我们使用经典的Input.GetAxis获取输入Transform.Translate进行移动。注意这里的移动计算是在每个客户端的Update中独立进行的。目前这个移动只发生在本地其他玩家还看不到。5. 实现基础位置同步NetworkTransform现在我们的玩家可以移动了但只有自己能看到。如何让其他客户端也看到这个移动呢我们需要同步Transform组件。在 NGO 中最便捷的方式是使用内置的NetworkTransform组件。回到 Unity 编辑器在 Project 窗口中选中 “PlayerCube” 预制体。在 Inspector 中点击 “Add Component”搜索并添加NetworkTransform组件。这个组件会自动帮你同步游戏对象的位置Position、旋转Rotation和缩放Scale。添加后保持其默认参数即可。NetworkTransform会以一定的频率可配置将Transform的状态从拥有者Owner客户端发送到服务器再由服务器转发给所有其他客户端。实操心得NetworkTransform是快速原型开发的利器但对于高速移动或需要极高精度的对象如竞技游戏的子弹你可能需要更精细的控制比如只同步位置和旋转使用插值Interpolation和外推Extrapolation甚至自己通过NetworkVariable同步Rigidbody的状态。但对于我们当前的入门demo它完全够用。6. 运行与测试启动主机与客户端所有组件配置完毕现在是见证成果的时刻。NGO 提供了几种运行模式我们首先测试最常用的 “Host” 模式。6.1 使用内置的 NetworkManager HUD为了方便测试NGO 提供了一个简单的 UI 工具。选中场景中的 “NetworkManager” 对象在 Inspector 中点击 “Add Component”搜索并添加NetworkManagerHUD组件。这个组件会在游戏运行时在屏幕左上角显示几个按钮“Host”作为主机同时运行服务器和客户端、“Server”仅运行服务器、“Client”仅运行客户端、“Shutdown”关闭。保存你的场景例如命名为 “SampleScene”然后点击 Unity 编辑器上方的播放按钮。在 Game 视图中你应该能看到左上角出现了这几个按钮。点击 “Host”Unity 会启动一个主机。你会看到场景中生成了一个 “PlayerCube” 实例这就是主机玩家。你可以用 WASD 键控制它移动。启动客户端保持主机运行我们需要再启动一个游戏实例来模拟另一个玩家。在 Unity 编辑器中点击菜单栏File Build and Run或者File Build Settings添加当前场景后点击 “Build And Run”。将构建出的可执行文件放在一个方便的位置并运行它。在客户端中连接在运行起来的独立客户端窗口中同样点击左上角的 “Client” 按钮。它会尝试连接到本地主机默认地址 127.0.0.1。连接成功后在主机的游戏窗口中你会看到出现了第二个立方体。在客户端的游戏窗口中你也会看到两个立方体一个是你自己可能无法控制因为我们还没处理客户端玩家生成另一个是主机玩家。你会发现一个问题在客户端里你无法控制任何立方体。这是因为我们还没有告诉客户端哪个立方体是属于它的。我们需要稍微修改一下逻辑。6.2 完善玩家生成与归属感问题在于当客户端连接时服务器主机确实实例化了 PlayerCube 预制体但客户端的PlayerController脚本中的IsOwner对于这个新生成的物体是false因为服务器是它的生成者Spawner默认拥有权Ownership在服务器。我们需要在玩家预制体生成时将其拥有权转移给对应的客户端。修改PlayerController.cs脚本using Unity.Netcode; using UnityEngine; public class PlayerController : NetworkBehaviour { public float moveSpeed 5f; public override void OnNetworkSpawn() { base.OnNetworkSpawn(); // 可选如果是本地玩家可以做一些初始化比如改变颜色 if (IsOwner) { GetComponentMeshRenderer().material.color Color.blue; } else { // 其他玩家的颜色 GetComponentMeshRenderer().material.color Color.red; } } private void Update() { if (!IsOwner) return; float horizontal Input.GetAxis(Horizontal); float vertical Input.GetAxis(Vertical); Vector3 movement new Vector3(horizontal, 0, vertical) * moveSpeed * Time.deltaTime; transform.Translate(movement); } }我们重写了OnNetworkSpawn()方法。这个方法在网络对象被生成Spawn到网络上时在所有客户端上被调用。在这里我们根据IsOwner来设置不同颜色方便区分本地玩家和远程玩家。本地玩家是蓝色其他玩家是红色。现在重新运行测试你可能需要重新构建客户端。当你以客户端身份加入后你应该能看到一个蓝色的立方体你自己并且可以用键盘控制它移动。同时在主机窗口里你会看到一个红色的立方体客户端玩家在移动而你自己控制的蓝色立方体也在移动。恭喜你已经实现了一个最基本的、可互动的多人同步场景。7. 深入理解场景网络对象Scene Network Object在上面的测试中我们通过Player Prefab动态生成了玩家对象。但还有一种网络对象它们一开始就存在于场景中而不是运行时动态生成。这就是“场景网络对象”。这在 Unity 手册的“场景游戏对象”部分有提及。例如你可能有一个宝箱、一扇门或一个计分板它们从游戏开始就固定在场景里并且所有玩家都需要和它交互。对于这类对象你同样需要给它添加NetworkObject组件。但关键区别在于你不需要将它注册到NetworkManager的预制体列表里。它的工作流程是你在场景中放置一个带有NetworkObject的游戏对象比如一个宝箱。当场景加载时NGO 会自动发现这些场景中的NetworkObject并为它们分配网络 ID。所有客户端加载场景后这些对象会自动存在并处于同步就绪状态。注意事项场景网络对象在场景加载时在所有客户端上都会被禁用Disable然后由NetworkManager统一启用并同步状态。这意味着你不能假设它们在Start()或Awake()时就处于活动状态。与网络相关的初始化代码最好放在OnNetworkSpawn()方法中。我们来实践一下。在场景中创建一个 Sphere球体重命名为 “SharedGoal”。给它添加NetworkObject组件。再创建一个 C# 脚本 “GoalTrigger”也挂上去。这个脚本的功能是当任何玩家碰到球体时在服务器上记录日志。using Unity.Netcode; using UnityEngine; public class GoalTrigger : NetworkBehaviour { private void OnTriggerEnter(Collider other) { // 只有服务器才有权威处理游戏规则逻辑如得分、触发事件 if (!IsServer) return; // 检查碰撞对象是否是玩家 if (other.gameObject.TryGetComponentNetworkObject(out var playerNetObj)) { Debug.Log($Server: Player {playerNetObj.NetworkObjectId} reached the goal!); // 这里可以触发得分、播放效果等这些逻辑需要通过RPC或NetworkVariable同步给所有客户端 } } }注意if (!IsServer) return;这行代码。这是另一个黄金法则关键的游戏状态改变和规则判定应由服务器执行。这样可以防止客户端作弊。例如判断玩家是否到达终点、是否击中目标都应在服务器端进行验证。保存脚本运行游戏Host模式。现在控制你的玩家角色去碰撞那个球体。查看主机构建的游戏窗口或编辑器播放模式的 Console你应该能看到 “Server: Player X reached the goal!” 的日志信息。而客户端窗口则不会有这个日志因为触发判断逻辑只在服务器端执行。8. 常见问题与排查技巧实录在搭建这个基础场景的过程中你可能会遇到一些典型问题。这里我记录了几个最常见的坑和解决方法。8.1 问题点击 Host/Client 按钮后没有任何反应或者连接失败。排查思路检查 Network Transport确保NetworkManager上的Network Transport已设置为UnityTransport。如果这里是空的网络将无法启动。检查防火墙特别是当你在两台物理机器上测试时确保防火墙没有阻止 Unity 应用的网络通信。在本地同一台机器上运行多个实例通常没问题。检查地址和端口UnityTransport默认使用本地回环地址127.0.0.1和端口 7777。如果你要连接另一台机器需要在代码或配置中修改连接地址。NetworkManagerHUD的 “Client” 按钮默认连接127.0.0.1。查看日志在 Unity 编辑器中打开Window Analysis Network Profiler。启动 Host 或 Client 后这里会显示连接事件、RPC调用、对象生成等详细信息是排查网络问题的首要工具。8.2 问题客户端加入后看不到其他玩家或者玩家颜色没有按预期改变。排查思路确认预制体引用反复检查NetworkManager的Player Prefab字段是否正确引用了我们制作好的 “PlayerCube” 预制体。这是新手最容易出错的地方。检查 NetworkObject确保 “PlayerCube” 预制体根节点上确实有NetworkObject组件。没有它游戏对象根本无法在网络上存在。验证生成逻辑在PlayerController的OnNetworkSpawn方法中打上 Debug.Log检查它是否被调用以及IsOwner的值是否符合预期。网络变量的延迟我们目前用颜色区分玩家这个操作在OnNetworkSpawn中瞬间完成。但如果你的同步逻辑依赖于NetworkVariable我们下一篇会讲请注意它的值从服务器同步到客户端会有至少一个网络帧的延迟。初始状态可能不是立即可见的。8.3 问题移动感觉卡顿或不流畅。排查思路NetworkTransform 插值选中玩家预制体上的NetworkTransform组件查看其Interpolate设置。默认是开启的它会对接收到的网络位置进行平滑插值避免跳跃。如果感觉移动“拖影”可以尝试调整Interpolation Time插值时间。如果感觉响应慢可以检查NetworkTransform的NetworkTick相关设置提高同步频率但会增加带宽。权威性问题在我们的简单移动脚本中移动是客户端权威的客户端计算位置通过NetworkTransform同步。这在延迟低的情况下没问题但高延迟或丢包时其他玩家看到的移动会不连贯。对于需要公平竞技的游戏通常采用服务器权威移动客户端发送输入给服务器服务器计算移动并同步结果。这更复杂但能防止作弊和提供更一致的体验。性能瓶颈在 Profiler 中查看是否是因为帧率过低导致的卡顿而非网络问题。8.4 问题构建Build后运行客户端无法连接到编辑器运行的主机。排查思路连接地址构建出的客户端其NetworkManagerHUD默认仍连接127.0.0.1。如果主机编辑器和客户端构建版在同一台机器这没问题。但如果客户端在另一台机器你需要修改客户端连接的 IP 地址为主机的局域网 IP如 192.168.1.xxx。修改连接地址你可以写一个简单的 UI 输入框来覆盖默认地址。或者在代码中初始化NetworkManager时进行配置// 在客户端连接前调用 NetworkManager.Singleton.GetComponentUnityTransport().SetConnectionData(“192.168.1.100”, 7777);编辑器主机设置确保编辑器运行的主机没有处于特殊模式如播放模式暂停。有时防火墙会为编辑器应用和构建的应用设置不同规则。通过这个最小化可用的多人同步场景你已经迈出了使用 Unity Netcode for GameObject 最关键的第一步。你理解了NetworkManager、NetworkObject、NetworkBehaviour、IsOwner、IsServer这些核心概念并实践了动态生成玩家和场景网络对象。在下一篇中我们将深入NetworkVariable和ClientRpc/ServerRpc实现更复杂的游戏状态同步和交互逻辑比如同步玩家的生命值以及让所有玩家都能看到的爆炸效果。记住多人游戏开发的核心思想永远是状态在服务器权威验证变化通过网络可靠同步客户端只负责表现和输入采集。