1. 项目概述为什么选择 Fusion 2 来构建 2D 联机射击游戏如果你正在 Unity 里琢磨怎么做一个能让三五好友一起联机对战的 2D 射击游戏并且已经被网络同步、延迟补偿、状态权威这些概念搞得头大那 Fusion 2 这个方案绝对值得你花时间深入研究。我最初接触联机游戏开发时也试过 Unity 自带的 UNet已弃用、Mirror甚至自己用 Socket 撸底层过程相当痛苦。直到用上 Fusion尤其是它的 2.0 版本很多之前需要手动处理、极易出错的网络同步逻辑现在变得清晰可控。这个项目标题提到的“深度拆解”核心就是弄明白 Fusion 2 如何将复杂的网络游戏逻辑抽象成一套开发者相对友好、性能又足够强悍的框架。简单来说Fusion 是一个状态同步State Synchronization网络框架它和 Photon 那种流行的“房间服务器”模式有本质区别。Fusion 的核心是让所有客户端包括一个可选的专用服务器或其中一个客户端作为主机都运行完全相同的游戏逻辑并通过一个“权威”的源头来同步游戏世界的状态。对于 2D 射击游戏这种对实时性、命中判定要求极高的类型状态同步是更主流、更可靠的选择。Fusion 2 在此基础上引入了更灵活的网络对象NetworkObject、网络行为NetworkBehaviour和输入处理NetworkInput模型让开发者可以像写单机游戏一样思考然后通过添加网络属性[Networked]和调用远程过程调用RPC来“点亮”联机功能。这个教学项目的价值在于它不仅仅教你“怎么调 API 让角色动起来”而是深入到“为什么这么动才是对的”。比如如何处理不同玩家网络条件下的移动预测与回滚Prediction Rollback2D 射击游戏的子弹碰撞检测是客户端预测还是服务器权威验证房间管理和玩家状态同步该怎么设计才不乱这些才是做一个能玩的联机 Demo 和做一个真正稳定、公平的联机游戏之间的鸿沟。接下来我会结合 Fusion 2 的核心机制拆解实现一个 2D 多人射击游戏的关键环节并分享我在实操中踩过的坑和总结的技巧。2. 核心架构与 Fusion 2 基础概念解析在动手写代码之前必须吃透 Fusion 2 的几个核心概念这决定了你整个项目的代码组织方式和问题排查效率。很多人一上来就照着教程复制粘贴一旦出问题就完全懵了根本不知道从哪查起。2.1 网络运行模式Host, Server, Client这是 Fusion 的基石选错了模式后面全是坑。Host Mode (主机模式)这是开发和小型游戏最常用的模式。其中一个玩家同时运行“服务器”逻辑和“客户端”逻辑。这个玩家对游戏世界拥有绝对权威Authoritative其他玩家作为纯客户端Client连接进来。优点是简单不需要额外部署服务器缺点是主机玩家如果掉线或卡顿会影响所有人。在 2D 射击游戏中如果你做的是 P2P点对点联机或者小范围的友房对战Host 模式是首选。Server Mode (服务器模式)你需要一个独立的、不带渲染和输入处理的“专用服务器”Dedicated Server程序。所有客户端都连接到这个服务器。服务器是唯一权威客户端只负责渲染和发送输入。这是最公平、最稳定的模式适合竞技性强的游戏。但代价是你需要额外部署和维护服务器。Fusion 支持你从 Unity 编辑器里直接构建出这个“Headless”无头服务器程序。Client Mode (客户端模式)纯客户端只连接到一个 Host 或 Server。实操心得开发阶段强烈建议全程使用Host Mode进行测试。你可以在编辑器里以 Host 模式启动一个游戏实例然后通过“构建并运行”再启动一个或多个 Client 实例来连接它这样调试起来最方便。Fusion 的NetworkRunner组件提供了可视化的模式选择。2.2 网络对象与网络行为游戏实体的网络化在单机游戏里一个玩家角色就是一个GameObject挂一堆MonoBehaviour。在 Fusion 里你需要把它们升级成网络实体。NetworkObject这是 Fusion 中可被网络识别和同步的基本单位。你想让一个物体比如玩家、子弹、宝箱在网络间存在并同步就必须给它挂上NetworkObject组件。它相当于给这个 GameObject 发了一张“网络身份证”有一个唯一的NetworkId。NetworkBehaviour这是你的网络脚本基类。所有需要访问网络状态、进行网络调用的脚本都必须继承自NetworkBehaviour而不是MonoBehaviour。这是最容易犯错的地方之一。NetworkBehaviour提供了Runner当前网络运行器、Object所属网络对象等关键属性。[Networked]属性这是状态同步的魔法关键字。任何需要从权威端同步到所有客户端的数据比如玩家的位置Vector2、血量int、状态enum都必须在其声明前加上[Networked]标签。Fusion 底层会自动处理这些属性的差分压缩和同步。public class PlayerData : NetworkBehaviour { [Networked] public Vector2 NetworkPosition { get; set; } [Networked] public int NetworkHealth { get; set; } [Networked] public PlayerState NetworkState { get; set; } // 注意Networked 属性通常需要是属性Property并且读写权限要符合规范。 }重要提示[Networked]属性的赋值只在状态 Authority权威端生效然后自动同步。在客户端直接修改它是无效的。2.3 输入处理与预测回滚让操作跟手的关键2D 射击游戏手感的核心是“跟手”即玩家的操作移动、开枪要立刻在本地得到视觉反馈哪怕网络有延迟。Fusion 用一套精致的输入和预测回滚系统来解决这个问题。NetworkInput它封装了单个玩家一帧内的所有输入如移动方向、是否开火、是否跳跃。你需要定义一个结构体struct来承载这些输入数据。public struct PlayerInput : INetworkInput { public Vector2 MoveDirection; public NetworkButtons Buttons; // 用于处理离散的按钮状态如开火、跳跃 }GetInput()在NetworkBehaviour中你可以重写GetInput()方法来收集本地玩家的输入Fusion 会将其发送给权威端。预测Prediction每个客户端都会根据自己收集的输入提前模拟本地玩家角色的行为比如移动。这让你在本地看到的效果是零延迟的。回滚Rollback与重演Re-simulation当权威端Host/Server的“真实”状态经过网络延迟传回客户端时客户端会将自己的游戏状态“回滚”到那个过去的时间点然后用权威的输入数据重演一遍逻辑再快进到现在。如果预测正确玩家毫无感知如果预测错误比如你预测自己能走到某个位置但服务器判定你被墙卡住了你会看到角色位置被“纠正”一下。这个过程是 Fusion 自动管理的但对你的代码有严格要求所有游戏逻辑必须基于[Networked]数据和GetInput()的输入且必须是确定性的即在相同输入和初始状态下每次计算的结果必须完全相同。踩坑记录预测回滚最怕“副作用”。比如在FixedUpdateNetwork()Fusion 的逻辑更新循环里播放音效、生成粒子如果不加判断在回滚和重演时这些效果会被重复触发导致音效爆炸、画面混乱。一定要用if (Runner.IsForward)或HasStateAuthority等条件包裹非确定性的、可视/可听的逻辑。3. 2D 射击游戏核心模块实现拆解理解了基础我们就可以开始搭建游戏的核心模块了。我将按照一个典型的 2D 俯视角射击游戏的流程来拆解。3.1 玩家角色网络化移动与动画同步这是第一个挑战。我们要让一个 2D 精灵角色能在所有玩家的屏幕上平滑、同步地移动。实现步骤创建网络化玩家预制体创建一个 GameObject命名为NetworkPlayer。添加NetworkObject组件。这是必须的。添加NetworkTransform组件Fusion 内置。对于简单的、仅同步位置和旋转的物体直接用这个组件最高效。它会自动同步Transform。添加你的自定义脚本例如PlayerMovement继承自NetworkBehaviour。在PlayerMovement中实现权威移动逻辑public class PlayerMovement : NetworkBehaviour { [SerializeField] private float _moveSpeed 5f; private CharacterController _controller; // 假设使用2D Character Controller private Vector2 _moveInput; public override void Spawned() { // 只在本地客户端获取自己角色的Controller便于处理输入和本地预测 if (HasInputAuthority) { _controller GetComponentCharacterController(); } } public override void FixedUpdateNetwork() { // 1. 检查是否有可用的输入数据 if (GetInputPlayerInput(out var input)) { _moveInput input.MoveDirection; } // 2. 只有状态权威端Host/Server才执行真正的移动逻辑计算 if (HasStateAuthority) { Vector3 move new Vector3(_moveInput.x, _moveInput.y, 0) * _moveSpeed * Runner.DeltaTime; // 这里调用CharacterController的Move或者直接修改Transform.position // _controller.Move(move); transform.position move; } // 注意由于我们可能使用了NetworkTransform位置的最终同步会由它处理。 // 这里的移动计算是为了游戏逻辑如碰撞检测视觉位置同步交给NetworkTransform。 } }关键点解析HasInputAuthority判断当前对象是否是本地玩家控制的。用于处理本地输入收集、摄像机跟随等。HasStateAuthority判断当前实例是否拥有该对象的状态权威。只有权威端才能“决定”这个对象的最终状态如位置、血量。在 Host 模式下本地玩家对自己的角色有 State Authority。GetInputT()尝试获取当前帧的输入。这是预测回滚系统的一部分。动画同步动画状态如 idle, run, shoot也需要同步。通常我们会用一个[Networked]的枚举来同步状态然后在Render相关的回调如Update()或LateUpdate()中根据这个状态去播放对应的动画。[Networked] public PlayerAnimState NetworkAnimState { get; set; } private Animator _animator; public override void Render() { // Render 在每次视觉更新时调用适合处理动画、特效等表现层逻辑 // 根据 NetworkAnimState 更新 Animator 参数 _animator.SetInteger(State, (int)NetworkAnimState); }注意事项不要在FixedUpdateNetwork里直接调用Animator的方法因为FixedUpdateNetwork的调用频率与网络 Tick 率一致如 30Hz和视觉帧率如 60Hz可能不同且会因回滚被多次调用导致动画抽搐。Render是处理视觉反馈的安全区。3.2 射击、子弹生成与命中判定这是 2D 射击游戏的核心涉及对象生成、所有权和权威判定。实现步骤射击输入与 RPC 调用在GetInput()中收集开火按钮状态。当检测到开火按下时我们不能直接在客户端生成子弹因为子弹的生成和命中必须是权威的。我们需要通过RPC通知权威端。public override void FixedUpdateNetwork() { if (GetInputPlayerInput(out var input)) { if (input.Buttons.IsSet(PlayerButtons.Fire)) { // 只有输入权威端本地玩家才发起RPC请求避免重复调用 if (HasInputAuthority) { RPC_RequestFire(input.LookDirection); // LookDirection 可以是鼠标或摇杆方向 } } } } [Rpc(RpcSources.InputAuthority, RpcTargets.StateAuthority)] public void RPC_RequestFire(Vector2 direction) { // 这个函数只在 State AuthorityHost/Server上执行 // 在这里执行生成子弹、计算伤害等权威逻辑 SpawnBullet(direction); }权威生成子弹创建一个NetworkBullet预制体带有NetworkObject组件和BulletBehaviour脚本。在SpawnBullet方法中使用Runner.Spawn()来在网络中生成子弹。你需要决定子弹的Input Authority和State Authority。通常子弹的 State Authority 是生成它的服务器/Host而 Input Authority 可以是发射它的玩家用于可能的预测。private void SpawnBullet(Vector2 direction) { // 预设子弹预制体 var bulletPrefab ...; var firePos transform.position (Vector3)direction.normalized * 0.5f; // Runner.Spawn 是网络生成物体的唯一正确方式 var bulletObj Runner.Spawn(bulletPrefab, firePos, Quaternion.LookRotation(Vector3.forward, direction)); var bullet bulletObj.GetComponentBulletBehaviour(); bullet.Init(direction, Object.InputAuthority); // 传递发射者和方向 }子弹移动与碰撞检测在子弹的BulletBehaviour.FixedUpdateNetwork()中根据权威端计算的速度更新其[Networked]位置。碰撞检测必须由 State Authority 执行。在子弹的权威端使用物理检测如Physics2D.Raycast或OverlapCircle来检测是否击中目标。// 在 BulletBehaviour 中 public override void FixedUpdateNetwork() { if (HasStateAuthority) { // 权威端计算移动和碰撞 Vector2 move _direction * _speed * Runner.DeltaTime; // 假设用射线检测 var hit Physics2D.Raycast(transform.position, _direction, move.magnitude, _hitLayerMask); if (hit.collider ! null) { // 处理命中逻辑 var hitPlayer hit.collider.GetComponentNetworkPlayer(); if (hitPlayer ! null) { // 对命中玩家造成伤害这又是一个需要权威处理的逻辑 hitPlayer.RPC_TakeDamage(_damage, Object.InputAuthority); } // 子弹命中后销毁 Runner.Despawn(Object); } else { // 未命中更新位置 transform.position (Vector3)move; } } }核心技巧对于子弹这种高速小物体使用Raycast比依赖Collider的OnTriggerEnter更可靠因为网络 Tick 率可能跟不上子弹穿越碰撞体的速度导致“穿墙”或“打不中”。伤害处理与 RPC 链子弹命中后调用命中玩家的RPC_TakeDamage。这个 RPC 的源Source可以是子弹的 Input Authority即发射者目标Target是 State Authority服务器/Host。在RPC_TakeDamage中权威端扣除玩家血量并同步血量值。如果玩家死亡则触发死亡逻辑如播放动画、重生倒计时。3.3 玩家状态同步与游戏规则管理一个完整的游戏需要管理玩家的连接、离开、血量、分数、胜负条件等。玩家连接与生成创建一个GameManager脚本继承自NetworkBehaviour并挂载在一个有NetworkObject的 GameObject 上。这个 Manager 通常设置为DontDestroyOnLoad并在游戏开始时由 Host 生成。在GameManager中监听NetworkRunner的OnPlayerJoined和OnPlayerLeft事件。当新玩家加入时由权威的GameManager调用Runner.Spawn()生成对应的玩家角色并关联PlayerRef玩家的网络标识。玩家数据管理创建一个PlayerData类包含[Networked]的血量、分数、击杀/死亡数等属性。这个类可以挂载在玩家角色上或者通过NetworkBehaviour的[Networked]属性引用。所有修改这些数据的操作如扣血、加分都必须通过 RPC 或在 State Authority 端进行。游戏状态机使用一个[Networked]的枚举来同步整个游戏的全局状态例如GameState { Lobby, Playing, RoundEnd, GameOver }。GameManager根据这个状态来控制游戏流程在Lobby等待玩家准备在Playing时允许移动射击在RoundEnd时结算分数并重置场景。状态切换的触发器如所有玩家死亡、时间到必须在 State Authority 端判断。4. 性能优化与网络调试实战技巧当基础功能跑通后优化和调试就成了重中之重。一个卡顿、不同步的游戏体验是灾难性的。4.1 网络带宽与状态压缩优化Fusion 虽然强大但无节制地同步所有数据也会撑爆带宽。只同步必要数据仔细审视每一个[Networked]属性。一个玩家的颜色、皮肤ID可以用一个int同步而不是同步整个材质路径。使用合适的精度对于 2D 游戏位置Vector2的同步精度可以适当降低。Fusion 允许你为[Networked]属性设置压缩器Networked属性的OnChanged回调里可以处理但更底层的压缩需要自定义INetworkStruct或使用Float的Accuracy。利用Networked属性的OnChanged这个回调只在值真正发生变化时触发。你可以在这里执行一些逻辑比如血量变化时播放 UI 动画而不是每帧都去检查。对象池与Runner.Spawn/Despawn频繁生成销毁子弹、特效会带来性能开销和网络消息。实现一个简单的网络对象池复用非活跃的NetworkObject可以显著提升性能。4.2 延迟与预测回滚的调试预测回滚问题是联机游戏调试中最棘手的部分。开启 Fusion 的调试工具在NetworkRunner的Enable设置里打开Network Debug和Stats。这会在游戏画面显示当前的网络状态、RTT往返延迟、输入缓冲大小等。Debug Info面板能显示所有网络对象的状态权威和输入权威。模拟高延迟和丢包在 Unity 编辑器的 Play Mode 下可以通过修改NetworkProjectConfig或使用第三方工具如 Clumsy来模拟恶劣的网络环境。这是测试你游戏网络健壮性的必修课。观察“抖动”与“回弹”位置抖动如果其他玩家的角色在你屏幕上不停抖动可能是网络抖动Jitter严重或者位置同步频率不够。可以尝试调整NetworkTransform的插值Interpolation参数。角色回弹这是预测错误的典型表现。你的角色向前走突然被拉回一点。这说明你的本地预测和服务器权威状态不一致。检查你的移动逻辑是否完全确定性的是否有依赖Time.deltaTime应使用Runner.DeltaTime是否有物理引擎的非确定性因素使用Debug.Log与NetworkTick在关键逻辑处打印信息时附加上Runner.Tick当前的网络逻辑帧编号。这能帮你理清事件发生的顺序判断是发生在当前帧、预测帧还是回滚帧。if (HasStateAuthority) { Debug.Log($[Tick:{Runner.Tick}] Authority dealt damage.); }4.3 常见问题排查速查表下表汇总了开发 2D Fusion 游戏时最常遇到的问题和解决思路问题现象可能原因排查步骤与解决方案玩家角色生成失败1. 预制体缺少NetworkObject。2.Runner.Spawn的预制体引用未在NetworkProjectConfig的Registered Prefabs中注册。3. 生成位置无效如卡在墙里。1. 检查预制体根节点。2. 在 Fusion 的Network Project Config资产中检查列表。3. 打印生成位置确保其在可行走区域。输入无反应1. 脚本未继承NetworkBehaviour。2. 未正确重写GetInput或FixedUpdateNetwork。3.PlayerInput结构体定义错误或未实现INetworkInput。1. 检查脚本基类。2. 在GetInput中打印输入值确认是否收到。3. 检查结构体字段是否都是可序列化类型。[Networked]属性不同步1. 属性没有set访问器或不是public。2. 在非 State Authority 端尝试修改它。3. 值的变化频率低于网络 Tick 率且变化量小于压缩阈值。1. 确保属性为public并有get; set;。2. 牢记修改[Networked]属性是权威端的特权。3. 对于连续变化的值如位置使用NetworkTransform更省心。子弹穿墙或打不中1. 碰撞检测在非权威端进行。2. 使用Collider检测但子弹速度过快单帧穿越。3. 网络延迟导致客户端看到的敌人位置滞后。1. 确保碰撞检测代码在if (HasStateAuthority)块内。2. 改用Physics2D.Raycast或CapsuleCast并考虑子弹飞行距离。3. 对于高速射击游戏服务器需做延迟补偿Lag CompensationFusion 提供了HitboxManager等工具来辅助。动画或特效重复播放在FixedUpdateNetwork中触发了视觉或音频效果该函数在回滚时会重复执行。将视觉、音频逻辑移到Render方法中或用if (Runner.IsForward)条件包裹。游戏逻辑表现不一致使用了非确定性的函数或数据源如UnityEngine.Random.value、DateTime.Now。使用 Fusion 提供的确定性随机数生成器Runner.GetRandom()或使用基于Networked种子的随机。对于时间始终使用Runner.DeltaTime。5. 项目进阶与扩展思路当你的基础 2D 射击 Demo 稳定运行后可以考虑以下方向进行深化打造更完整的游戏体验。5.1 房间管理与匹配系统Fusion 提供了基础的Session和Player管理但一个完整的房间系统需要更多工作。自定义房间属性通过StartGameArgs的CustomProperties可以在创建房间时传递参数如地图名称、游戏模式、最大人数、是否公开等。大厅与房间列表你需要自己实现一个大厅 UI通过SessionList回调获取当前可加入的房间列表并展示其自定义属性。玩家准备状态在游戏管理器中维护一个[Networked]的字典或数组同步每个玩家的准备状态。只有所有玩家都准备后主机才能开始游戏。断线重连Fusion 支持玩家短时间断线后重连并恢复状态通过PlayerRef不变。你需要妥善处理玩家对象的重生和数据恢复逻辑。5.2 更复杂的游戏机制与状态同步技能系统技能冷却、效果持续时间等都需要用[Networked]的TickTimer来同步。TickTimer是 Fusion 提供的基于网络 Tick 的计时器能保证在所有客户端上同步到期。[Networked] public TickTimer SkillCooldownTimer { get; set; } // 创建计时器SkillCooldownTimer TickTimer.CreateFromSeconds(Runner, cooldownTime); // 检查是否到期if (SkillCooldownTimer.Expired(Runner)) { ... }地图交互物如可破坏的墙壁、移动的平台。这些物体的状态血量、位置也需要网络同步。可以为它们创建独立的NetworkBehaviour脚本。观战模式当玩家死亡后可以将其相机切换到其他存活玩家或自由视角。这需要灵活管理摄像机的归属和InputAuthority的切换。5.3 部署与构建考量构建 Dedicated Server从 Unity 编辑器菜单选择Fusion-Build-Server Build可以生成一个不带图形界面的服务器程序。你需要将其部署到云服务器如阿里云、腾讯云、AWS 的轻量应用服务器。客户端构建确保在构建客户端时NetworkProjectConfig中设置了正确的Default Server Address你的服务器 IP或启用了Enable Client Server Mode。中继服务器如果玩家之间 NAT 穿透困难可以考虑使用 Fusion Cloud 或自建中继服务器来辅助连接。从头实现一个基于 Fusion 2 的 2D 联机射击游戏是一个系统性工程它强迫你从“单机思维”转向“网络思维”。最大的收获不是学会了某个 API而是理解了状态同步、预测回滚、权威判定这些核心概念。在实际开发中最耗时间的往往不是功能实现而是调试那些微妙的、只在特定网络条件下出现的不同步问题。我的建议是从小处着手先让一个方块在网络间移动然后加上射击再处理命中逐步迭代。每完成一个功能就在模拟的糟糕网络环境下测试一下养成“网络意识”。Fusion 2 提供的工具链和可视化调试器已经非常友好善用它们能极大提升效率。最后别忘了游戏性本身流畅的网络体验是为了更好的游戏乐趣服务的。