1. 项目概述为什么选择FishNet如果你正在Unity里折腾多人游戏大概率已经听过Netcode for GameObjects、Mirror甚至Photon这些名字。但最近社区里冒出一个新星——FishNet它正以极高的性能和灵活性吸引着越来越多开发者的目光。我自己在几个中小型项目里深度使用过FishNet从快速原型到上线部署它给我的感觉是“既给了你足够的‘方向盘’又没把‘引擎盖’焊死”。简单来说FishNet是一个开源的、面向Unity的高性能网络解决方案。它不像某些托管服务那样“黑盒”也不像一些基础框架那样需要你从零造轮子。它的设计哲学很明确提供一套强大、可预测且高度可扩展的底层网络架构同时把游戏逻辑的控制权完全交还给你。这意味着你可以精细控制网络消息、序列化、对象生成与同步的每一个环节这对于追求极致性能或特殊玩法的项目来说是至关重要的。为什么在众多选择中FishNet值得你花时间学习首先它的性能开销极低。在内部测试中相同数据量下FishNet的带宽占用和CPU消耗常常优于一些主流方案这对于移动端或支持大量玩家的游戏是关键优势。其次它的代码完全开源且文档正在快速完善遇到问题你可以直接阅读源码甚至提交PR这种透明度和社区参与感是闭源SDK无法比拟的。最后它支持多种网络拓扑客户端-服务器、点对点等并且对预测、插值、延迟补偿等高级网络特性有原生且清晰的支持让你在实现平滑的多人体验时有坚实的理论框架和工具支撑。本指南的目标就是帮你绕过我当初摸索时踩过的那些坑快速在Unity中搭建起一个可运行、可扩展的FishNet多人游戏基础框架。我们会从零开始涵盖从环境配置、核心概念理解到实现一个简单的玩家同步示例的全过程。无论你是想做一个简单的同屏合作游戏还是一个需要复杂状态同步的竞技项目这里的内容都能为你打下坚实的基础。2. 核心概念与架构拆解在动手写代码之前理解FishNet的几个核心设计理念至关重要。这能帮助你在后续开发中做出正确的设计决策而不是被奇怪的Bug牵着鼻子走。2.1 网络管理器你的指挥中心在FishNet中NetworkManager是绝对的单一实例核心。它不像某些框架那样可以随意挂载多个一个场景中只能有一个激活的NetworkManager。它负责管理整个网络生命周期的所有事情启动和停止服务器/客户端、处理连接、注册预制体、管理场景加载等。为什么这样设计这强制保证了网络状态的一致性。想象一下如果有多个管理器它们可能会争相处理同一个连接事件或者预制体注册列表不一致那将是一场灾难。FishNet通过单例模式确保了所有网络操作都有一个统一的入口和出口简化了架构也避免了竞态条件。它的核心组件包括Transport传输层NetworkManager需要绑定一个传输组件比如FishNet自带的FishyTransport或者你可以集成第三方如LiteNetLib、ENet。这是网络数据进出游戏的物理通道。SceneManager场景管理器负责网络场景的加载与同步。当服务器加载一个新场景时它可以自动通知所有客户端也加载相同的场景。SpawnManager生成管理器管理所有在网络中动态生成的NetworkObject网络对象的生命周期。服务器生成一个对象它会自动在相关客户端上生成。ConnectionManager连接管理器处理客户端连接、断开以及连接状态的变化。注意不要尝试自己手动实例化NetworkManager。最佳实践是在你的初始场景中预先放置一个配置好的NetworkManager预制体或者通过代码在运行时初始化它。FishNet提供了InstanceFinder类来全局访问这个单例例如InstanceFinder.NetworkManager。2.2 NetworkObject与NetworkBehaviour游戏的骨骼与肌肉这是FishNet中最重要的两个类理解了它们就理解了FishNet如何同步游戏状态。NetworkObject可以将其理解为网络实体的“身份证”或“容器”。任何需要在网络上同步存在的GameObject都必须挂载NetworkObject组件。它包含了该对象在网络中的唯一标识NetworkId、所有权信息等元数据。一个NetworkObject可以包含多个NetworkBehaviour脚本。NetworkBehaviour继承自MonoBehaviour是你的游戏逻辑脚本应该继承的基类。只有挂载在NetworkObject下的NetworkBehaviour脚本才能使用FishNet的网络功能。它提供了一系列生命周期回调如OnStartServer,OnStartClient和核心方法RPCRemote Procedure Call远程过程调用。允许服务器或客户端调用另一个机器上的方法。这是执行游戏操作如开枪、使用技能的主要方式。Observers同步变量。通过[Observers]属性标记的字段当其值在服务器上发生变化时会自动同步到所有或指定的客户端。这是同步血量、位置、状态等数据的主要方式。SyncType更底层的同步类型用于自定义复杂的同步逻辑比如集合、字典或自定义结构体的增量同步。关键设计模式服务器权威Server-AuthoritativeFishNet强烈鼓励并简化了服务器权威模式的实现。这意味着游戏的核心逻辑和最终裁决权在服务器。例如玩家移动的输入由客户端发送给服务器通过RPC服务器计算验证后的位置再通过同步变量或RPC分发结果给所有客户端。这能有效防止外挂客户端篡改关键游戏数据如无敌、秒杀。在FishNet中你可以很方便地通过IsServer,IsClient,IsOwner等属性在NetworkBehaviour中判断当前代码的执行环境从而编写正确的逻辑。2.3 同步机制RPC与Observers的抉择这是实际编码中最常做的选择用什么方式把数据或事件告诉其他机器使用RPC的场景触发离散事件玩家按下开枪键、打开一扇门、发送一条聊天消息。需要定向通信只发送给特定玩家如伤害数字显示或除发送者外的所有人。客户端发起服务器验证并执行典型的操作流程。客户端发送“尝试攻击”RPC给服务器服务器验证后执行攻击逻辑再广播结果。使用Observers同步变量的场景持续的状态同步玩家的当前位置结合NetworkTransform组件、当前血量、能量值、队伍标识等。需要平滑插值的数据对于位置、旋转等FishNet可以基于同步的数据包在客户端进行插值运算使得运动看起来更平滑即使网络有波动。服务器驱动的状态更新游戏倒计时、全局游戏状态如“比赛进行中”。一个常见的误区是过度使用RPC。比如每一帧都用RPC同步玩家位置。这会瞬间产生巨大的网络流量。正确的做法是对于连续状态使用同步变量对于离散事件使用RPC。FishNet的NetworkTransform组件内部就是利用高效的同步协议来处理位置旋转的比自己用RPC实现要高效和稳定得多。3. 环境搭建与第一个网络场景理论说得再多不如动手跑通一个“Hello World”。让我们一步步搭建起最基本的FishNet多人测试环境。3.1 安装与初始配置安装FishNet最推荐的方式是通过Unity的Package Manager使用Git URL安装。打开Package Manager点击“”号选择“Add package from git URL”输入https://github.com/FirstGearGames/FishNet.git?path/Assets/FishNet。这能确保你获得最新的稳定版本。你也可以从Asset Store下载或克隆GitHub仓库。创建NetworkManager在场景中创建一个空GameObject命名为“NetworkManager”。为其添加NetworkManager组件。你会发现它自动添加了几个必需的子组件如TransportManager,SceneManager等。配置传输层在NetworkManager的Inspector中找到Transport字段。默认可能已经是FishyTransport。保持默认即可它适用于大多数开发场景。对于生产环境你可能需要根据平台如WebGL选择其他传输方式。创建玩家预制体创建一个胶囊体Capsule作为玩家模型将其保存为预制体命名为“PlayerPrefab”。给这个预制体添加NetworkObject组件。这是关键一步。创建一个新的C#脚本PlayerController继承自NetworkBehaviour而不是MonoBehaviour并将其也挂载到预制体上。3.2 编写第一个网络脚本玩家生成与移动现在我们来编写PlayerController脚本实现玩家在连接时被生成并允许本地玩家控制移动。using FishNet.Object; using UnityEngine; public class PlayerController : NetworkBehaviour { [SerializeField] private float moveSpeed 5f; private CharacterController _characterController; public override void OnStartServer() { base.OnStartServer(); // 服务器端初始化逻辑例如初始化玩家数据 Debug.Log(玩家对象在服务器上已启动。); } public override void OnStartClient() { base.OnStartClient(); _characterController GetComponentCharacterController(); if (!IsOwner) { // 如果不是本地控制的玩家禁用输入控制脚本或摄像头 // 例如GetComponentPlayerInput().enabled false; // 通常会把控制权相关的组件直接禁用 enabled false; // 直接禁用这个脚本本身 return; } // 是本地玩家设置摄像头跟随等 Debug.Log(本地玩家客户端已就绪。); Camera.main.transform.SetParent(transform); Camera.main.transform.localPosition new Vector3(0, 2, -5); } private void Update() { if (!IsOwner) return; // 关键只有对象的所有者才处理输入 float horizontal Input.GetAxis(Horizontal); float vertical Input.GetAxis(Vertical); Vector3 move new Vector3(horizontal, 0, vertical) * moveSpeed * Time.deltaTime; _characterController.Move(move); } }代码解析与注意事项OnStartServer当这个网络对象在服务器端被初始化时调用。这里适合做服务器端的权威初始化比如从数据库读取玩家等级、装备。OnStartClient当这个网络对象在任何客户端包括主机被生成时调用。我们在这里获取CharacterController组件并进行关键的所有权判断。IsOwner这是一个极其重要的属性。它标识了当前运行的客户端是否拥有这个网络对象的所有权。对于玩家角色通常生成它的客户端就是其所有者。只有所有者才应该处理输入以避免多个客户端同时控制一个角色。非所有者的对象我们通常禁用其控制脚本只进行视觉表现。在Update中我们首先检查IsOwner确保只有本地玩家才能响应键盘输入并移动。这个移动目前是纯客户端的服务器并不知道其他玩家也看不到。我们下一步就要同步它。3.3 配置生成器与启动游戏注册预制体回到场景中的NetworkManager对象。在Inspector中找到Spawnable Prefabs列表通常在NetworkManager组件下方或SpawnManager组件里。将我们制作好的“PlayerPrefab”拖入这个列表。这告诉FishNet“这个预制体是允许在网络上动态生成的”。设置默认玩家预制体在NetworkManager或ConnectionManager组件中找到Player Prefab字段将“PlayerPrefab”赋值给它。这表示当有新客户端连接时服务器会自动使用这个预制体为该客户端生成一个玩家对象。创建简单的UI在场景中创建一个UI Canvas添加两个按钮“Start Server”启动服务器和“Start Client”启动客户端。再添加一个输入框用于输入连接地址默认localhost。编写启动脚本创建一个普通的MonoBehaviour脚本NetworkHUD挂载到Canvas上用于按钮点击事件。using FishNet; using FishNet.Managing; using UnityEngine; using UnityEngine.UI; public class NetworkHUD : MonoBehaviour { [SerializeField] private InputField addressInput; private NetworkManager _networkManager; void Start() { _networkManager InstanceFinder.NetworkManager; if (addressInput ! null) addressInput.text localhost; } // 按钮调用的方法 public void OnClickStartServer() { if (!_networkManager.ServerManager.Started) _networkManager.ServerManager.StartConnection(); } public void OnClickStartClient() { if (!_networkManager.ClientManager.Started) _networkManager.ClientManager.StartConnection(addressInput.text, 7777); // 默认端口7777 } public void OnClickStop() { _networkManager.ServerManager.StopConnection(true); _networkManager.ClientManager.StopConnection(); } }现在运行游戏。点击“Start Server”按钮你将启动一个服务器。然后点击“Start Client”按钮可以多点几次模拟多个客户端每个客户端连接后服务器都会为其生成一个玩家预制体。由于我们之前的移动脚本还未同步你只能看到自己控制的角色在动其他客户端连接的角色是静止的。别急我们马上解决同步问题。4. 实现基础同步让所有玩家动起来目前我们的移动是纯客户端的这显然不行。我们需要采用服务器权威的方式客户端将输入发送给服务器服务器计算移动并同步结果。4.1 改造移动逻辑使用RPC传递输入我们将修改PlayerController脚本引入RPC。using FishNet.Object; using UnityEngine; public class PlayerController : NetworkBehaviour { [SerializeField] private float moveSpeed 5f; private CharacterController _characterController; private Vector3 _serverPosition; // 用于在服务器端存储位置 public override void OnStartServer() { base.OnStartServer(); _characterController GetComponentCharacterController(); _serverPosition transform.position; } public override void OnStartClient() { base.OnStartClient(); _characterController GetComponentCharacterController(); if (!IsOwner) { enabled false; // 非所有者不执行Update return; } // 所有者设置摄像头 // ... 摄像头代码同上 ... } private void Update() { if (!IsOwner) return; float horizontal Input.GetAxis(Horizontal); float vertical Input.GetAxis(Vertical); if (horizontal ! 0f || vertical ! 0f) { // 客户端预测立即在本地移动提供即时反馈 Vector3 move new Vector3(horizontal, 0, vertical) * moveSpeed * Time.deltaTime; _characterController.Move(move); // 将输入发送给服务器进行权威验证和同步 SendMoveInputToServer(horizontal, vertical); } } // 这是一个发送给服务器的RPC [ServerRpc] private void SendMoveInputToServer(float horizontal, float vertical) { // 这个方法只在服务器上运行 Vector3 move new Vector3(horizontal, 0, vertical) * moveSpeed * Time.deltaTime; _characterController.Move(move); _serverPosition transform.position; // 更新服务器权威位置 // 将权威位置同步给所有客户端 UpdateClientPosition(_serverPosition); } // 这是一个由服务器广播给所有客户端的RPC [ObserversRpc] private void UpdateClientPosition(Vector3 newPosition) { if (IsOwner) return; // 如果是所有者我们已经预测移动了可以忽略或进行调和 // 对于非所有者客户端直接设置位置这里简单处理理想情况应插值 transform.position newPosition; } }这个方案的问题上面的代码虽然实现了同步但非常粗糙存在明显问题网络抖动直接设置transform.position会导致其他玩家角色“瞬移”。客户端预测与服务器回退所有者客户端预测移动后如果服务器计算的位置与客户端预测的不同比如撞墙了客户端会被“拉回”产生不愉快的体验。带宽浪费每一帧有输入都发送RPC流量很大。4.2 使用NetworkTransform实现平滑同步对于移动同步FishNet提供了更优的解决方案——NetworkTransform组件。它专门处理游戏对象的变换位置、旋转、缩放同步并内置了插值和预测逻辑。移除我们粗糙的同步代码删除SendMoveInputToServer和UpdateClientPosition方法以及相关的字段。修改移动逻辑Update函数中的移动代码只保留客户端预测部分不再调用RPC。添加并配置NetworkTransform组件在“PlayerPrefab”上添加NetworkTransform组件。关键配置参数Synchronize Position/Rotation/Scale勾选需要同步的项。Synchronize Mode选择Server To Clients服务器同步到客户端。这是服务器权威模式。Interpolation设置为Interpolate。这会使客户端根据收到的网络数据包对物体的运动进行平滑插值消除瞬移感。Extrapolation可以尝试开启它会在数据包间隔期间预测运动适合运动规律的对象。Client Authoritative不要勾选除非你明确需要客户端权威移动如某些休闲游戏。我们保持服务器权威。重构PlayerController现在我们的脚本只负责收集输入和在服务器上进行权威移动。移动同步完全交给NetworkTransform。using FishNet.Object; using UnityEngine; public class PlayerController : NetworkBehaviour { [SerializeField] private float moveSpeed 5f; private CharacterController _characterController; private Vector2 _inputVector; public override void OnStartServer() { base.OnStartServer(); _characterController GetComponentCharacterController(); } public override void OnStartClient() { base.OnStartClient(); _characterController GetComponentCharacterController(); if (!IsOwner) { // 非所有者禁用此脚本因为移动由服务器同步本地不需要处理输入 enabled false; return; } // 所有者设置摄像头... } private void Update() { // 只有所有者收集输入 if (!IsOwner) return; _inputVector.x Input.GetAxis(Horizontal); _inputVector.y Input.GetAxis(Vertical); } // 使用FixedUpdate进行物理或网络相关的更新更合适 private void FixedUpdate() { // 在服务器端进行权威移动计算 if (IsServer) { MoveCharacterAuthoritative(); } // 客户端预测如果是所有者也在本地立即移动可选提供即时反馈 // 注意这可能导致预测错误需要更复杂的调和系统此处为简化示例 else if (IsOwner) { MoveCharacterLocal(); } } private void MoveCharacterAuthoritative() { if (_characterController null) return; Vector3 move new Vector3(_inputVector.x, 0, _inputVector.y) * moveSpeed * Time.fixedDeltaTime; _characterController.Move(move); // NetworkTransform会自动检测transform变化并同步 } private void MoveCharacterLocal() { // 简单的客户端预测实际项目需要更复杂的处理如缓存输入、服务器调和 Vector3 move new Vector3(_inputVector.x, 0, _inputVector.y) * moveSpeed * Time.fixedDeltaTime; _characterController.Move(move); } // 重要需要将客户端的输入同步到服务器 [ServerRpc] private void SendInputToServerRpc(Vector2 input) { _inputVector input; } }这里引入了一个新问题_inputVector在客户端和服务器端是独立的。我们需要将客户端的输入定期发送给服务器。可以在Update中检测输入变化然后通过RPC发送。// 在PlayerController类中添加 private Vector2 _lastSentInput; private const float SEND_INTERVAL 0.1f; // 每0.1秒发送一次减少RPC调用 private float _timer; private void Update() { if (!IsOwner) return; _inputVector.x Input.GetAxis(Horizontal); _inputVector.y Input.GetAxis(Vertical); _timer Time.deltaTime; if (_timer SEND_INTERVAL || _inputVector ! _lastSentInput) { SendInputToServerRpc(_inputVector); _lastSentInput _inputVector; _timer 0f; } }现在我们有了一个更健壮的方案客户端定期将输入向量发送给服务器SendInputToServerRpc。服务器在FixedUpdate中根据收到的输入进行权威移动计算MoveCharacterAuthoritative。NetworkTransform组件自动将服务器上CharacterController移动导致的transform变化平滑地同步给所有客户端。客户端所有者可以进行本地预测移动MoveCharacterLocal以获得即时反馈但由于NetworkTransform的同步如果预测错误会被逐渐纠正结合插值视觉上相对平滑。实操心得对于刚接触FishNet的开发者我建议先完全信任NetworkTransform不要做客户端预测。即只在服务器端移动角色客户端只观看同步结果。这样可以先建立一个稳定、无差错的基线。等完全理解数据流和同步时机后再逐步引入客户端预测、输入缓冲、状态调和等高级特性。贪多嚼不烂分阶段实现更稳妥。5. 高级特性与性能优化入门当你的基础同步跑通后可能会遇到延迟、卡顿或带宽问题。这时就需要了解FishNet提供的一些高级工具和优化策略。5.1 网络可视性与权限管理不是所有对象都需要对所有玩家可见。FishNet提供了精细的观察者控制。NetworkObject.Observers你可以手动管理一个网络对象对哪些连接客户端可见。例如在大型地图中只让玩家看到其视野范围内的其他玩家和物体。NetworkObject.SetOwner可以动态改变一个网络对象的所有者。这在玩家交换物品、控制权转移时非常有用。NetworkBehaviour的OnSpawnServer和OnDespawnServer在这些回调中你可以根据游戏逻辑如玩家进入某个区域来调用NetworkObject.GiveOwnership或管理观察者列表。5.2 使用SyncVar与自定义序列化对于非变换类的状态同步[Observers]属性常被称为SyncVar是利器。public class PlayerStats : NetworkBehaviour { [Observers] private int _health 100; [Observers(OnChange nameof(OnTeamChanged))] private Team _team; private void OnTeamChanged(Team oldTeam, Team newTeam, bool asServer) { if (!asServer) { // 客户端收到队伍变化更新UI颜色等 GetComponentRenderer().material.color newTeam.Color; } } [Server] public void TakeDamage(int damage) { if (!IsServer) return; // 安全校验 _health - damage; if (_health 0) Die(); } }[Observers]标记的字段会在服务端改变时自动同步到客户端。OnChange回调允许你在值变化时执行自定义逻辑。[Server]属性标记的方法只能在服务器端调用是一种便捷的权限限制方式。对于复杂的数据结构如自定义类、列表你需要实现ISerializable接口或使用FishNet提供的Writer/Reader进行自定义序列化以控制网络包的大小和格式。5.3 带宽优化与预测平滑同步频率NetworkTransform和NetworkAnimator组件都有同步间隔设置。不要盲目使用最高频率如每帧同步。对于移动缓慢的物体降低同步频率如0.1秒一次可以大幅节省带宽。距离剔除结合NetworkObject的观察者系统实现基于距离的同步。远处的玩家或物体可以以更低的频率同步或者完全不同步其动画细节。客户端预测与调和对于需要快速响应的操作如射击游戏移动纯服务器同步的延迟是无法接受的。你需要实现完整的客户端预测缓存输入客户端在发送输入给服务器的同时在本地缓存输入序列。服务器权威状态服务器处理输入计算权威游戏状态并定期将状态包含帧号或时间戳广播给客户端。客户端调和客户端收到服务器的权威状态后与本地预测的状态进行对比。如果存在差异需要进行“调和”——通常是将客户端状态回退到服务器状态然后从那个时间点开始用缓存的输入重新模拟回滚与重演。FishNet的底层提供了时间管理和快照插值的基础但完整的预测调和系统需要你自己根据游戏类型来实现这是多人游戏开发中最复杂的部分之一。6. 常见问题与调试技巧在开发过程中你肯定会遇到各种网络问题。以下是一些常见坑点和排查方法。6.1 连接与生成问题问题现象可能原因排查步骤客户端无法连接服务器1. 防火墙/端口未开放2. 服务器未启动3. 传输配置不一致4. 地址/端口错误1. 检查控制台有无错误日志。2. 确认服务器ServerManager.Started为true。3. 对比服务器和客户端的传输协议和端口。4. 尝试在本地用127.0.0.1或localhost连接。玩家预制体没有生成1. 预制体未注册到Spawnable Prefabs2. 预制体上缺少NetworkObject组件3.Player Prefab字段未设置或设置错误1. 在NetworkManager的检视面板确认预制体已加入列表。2. 检查预制体根节点是否有NetworkObject。3. 确认Player Prefab引用正确。非所有者客户端也能控制角色NetworkBehaviour脚本中未检查IsOwner在Update或处理输入的方法开头务必添加if (!IsOwner) return;。6.2 同步与延迟问题问题现象可能原因排查步骤其他玩家移动卡顿、瞬移1. 网络延迟高、丢包2.NetworkTransform插值未开启或设置不当3. 同步频率过高导致带宽不足1. 使用NetworkTransform的插值(Interpolation)和推测(Extrapolation)。2. 适当增加同步间隔(Synchronize Interval)。3. 在编辑器中使用网络模拟工具如FishNet的TransportManager可配置延迟和丢包测试。客户端操作有延迟感1. 纯粹的服务器权威模式必然有至少一个RTT的延迟2. 未实现客户端预测1. 这是正常现象。对于需要快速响应的游戏必须实现客户端预测。2. 测量你的RTT往返时间优化服务器位置和代码逻辑。变量不同步1. 字段未用[Observers]标记2. 值在客户端被修改应只在服务器改3. 自定义类型未正确序列化1. 确认字段有[Observers]属性。2. 确保修改该字段的逻辑只在服务器端运行用if (IsServer)包裹。3. 对于自定义类实现序列化接口。6.3 调试工具与日志FishNet日志在NetworkManager的Logging设置中可以调整日志级别。开发时设置为Full或Common能输出大量连接、RPC调用、同步事件的信息对定位问题极有帮助。发布时记得改为Warning或Error。网络统计FishNet提供了运行时网络统计信息可以在游戏运行时查看带宽使用、RPC调用次数、对象数量等。通过代码访问InstanceFinder.TransportManager.Transport.GetStatistics()或使用社区提供的调试UI。Unity Profiler使用Unity Profiler的Network模块可以深入分析每个网络操作的具体耗时和内存分配找到性能瓶颈。构建独立测试总是构建出独立的可执行文件一个服务器多个客户端进行测试而不是只在Unity编辑器的Play Mode下测试。编辑器的网络环境过于理想很多问题暴露不出来。最后一点个人体会多人游戏开发是一个“测”出来的工程。不要指望一次写对所有的网络逻辑。建立一个快速的测试流程构建、启动、连接、操作、观察日志。学会使用网络模拟工具主动制造糟糕的网络环境高延迟、高丢包你的游戏在这些极端情况下的表现决定了它的上线口碑。FishNet给了你一套强大且透明的工具但最终网络的健壮性和流畅度取决于你对这些工具的理解和精心设计。从这个小指南开始先让角色动起来再慢慢打磨细节你会逐渐体会到构建一个线上世界的乐趣与挑战。