1. 局域网联机测试基础准备
在UE5中实现局域网联机功能前，我们需要先搭建好开发环境。我推荐使用最新的UE5.3版本，这个版本对多人游戏网络同步做了不少优化。创建一个第三人称模板项目时，记得选择"C++"选项，这样我们既能用蓝图快速搭建功能，又能通过C++实现底层逻辑控制。
多人游戏开发最让人头疼的就是网络同步问题。我在实际项目中遇到过角色移动不同步的情况，后来发现是移动组件的网络复制设置没配好。建议一开始就检查CharacterMovementComponent的Replication属性，确保bReplicateMovement设置为true。另外，角色的Mesh组件也要勾选Replicates选项，否则其他玩家根本看不到你的角色模型。
测试环境搭建有个小技巧：我习惯在项目设置里把默认地图改成自己创建的空关卡，这样可以减少测试时的加载时间。在"项目设置→地图和模式"里，把Game Default Map和Editor Startup Map都设成新建的空白关卡。这个空白关卡我一般命名为"NetworkTestMap"，专门用来测试网络功能。
2. 蓝图网络事件实现
2.1 创建基础网络事件
在内容浏览器中右键创建新的蓝图类，选择继承自PlayerController的子类，命名为"BP_NetworkController"。这个控制器将负责处理所有网络相关的事件。打开蓝图后，我们先添加三个键盘事件：
- 数字键1：创建监听服务器
- 数字键2：作为客户端连接
- 数字键3：断开当前连接
实现创建服务器的逻辑时，我发现很多人会忽略ServerTravel和OpenLevel的区别。ServerTravel是服务器端切换关卡，会带着所有客户端一起切换；而OpenLevel是本地切换关卡。正确的做法是使用ServerTravel，并带上?listen参数，这样服务器才会开启监听端口。
// 在PlayerController中调用 GetWorld()->ServerTravel("/Game/Maps/Lobby?listen");2.2 处理连接事件
客户端连接功能需要特别注意IP地址的获取。我建议在蓝图中添加一个文本框组件，让玩家可以手动输入要连接的服务器IP。这样测试时就不需要每次修改蓝图重新编译了。
连接逻辑的实现有个坑要注意：直接调用ClientTravel连接服务器时，如果当前是独立运行的游戏实例，需要带上绝对路径。我通常会这样处理：
APlayerController* PC = GetPlayerController(); if(PC) { FString Command = FString::Printf(TEXT("open %s"), *ServerAddress); PC->ConsoleCommand(Command); }3. 局域网测试实战技巧
3.1 多实例测试方法
在开发初期，我习惯用编辑器自带的PIE(Play In Editor)功能测试多人游戏。在编辑器偏好设置里找到"Level Editor→Play"，把"Play Number of Clients"设为2。这样点击播放按钮时，会自动启动一个服务器窗口和一个客户端窗口。
测试时发现的一个常见问题是：客户端控制不了角色。这是因为PlayerController的Possess没有正确执行。解决方法是在GameMode蓝图中，确保DefaultPawnClass设置正确，并且在PostLogin事件中调用Possess：
void AMyGameMode::PostLogin(APlayerController* NewPlayer) { Super::PostLogin(NewPlayer); if(NewPlayer) { NewPlayer->Possess(DefaultPawn); } }3.2 跨设备测试要点
真正的局域网测试需要至少两台设备。我建议先用两台电脑连接同一个路由器进行测试。在打包项目前，记得在项目设置里启用"打包→打包游戏内容"，否则客户端可能加载不了地图。
测试时经常遇到的连接失败问题，90%都是防火墙导致的。我现在的做法是：
- 在Windows防火墙中为UE5编辑器添加入站规则
- 为打包后的游戏exe文件也添加规则
- 关闭所有第三方安全软件
如果还是连接不上，可以用命令行ping一下目标IP，确认网络是否通畅。另一个检查方法是使用netstat -ano命令查看端口监听情况。
4. 网络同步问题排查
4.1 常见同步问题
角色移动不同步是最常见的问题之一。除了前面提到的移动组件设置，还要检查Character蓝图中是否使用了网络预测(Network Prediction)。我建议在项目初期就开启这个功能：
UCharacterMovementComponent::SetNetworkPredictionEnabled(true);另一个头疼的问题是RPC调用失败。我总结了几点经验：
- 服务器调用的RPC函数必须标记为Server
- 客户端调用的必须标记为Client
- 多播(Multicast)函数要在服务器端调用
- RPC函数的参数类型要支持网络序列化
4.2 网络调试工具
UE5提供了强大的网络分析工具。在编辑器命令窗口输入"stat net"可以显示实时网络状态。我常用的调试命令还有：
- net.NetShowCorrections 1：显示网络修正
- p.NetShowPing 1：显示ping值
- net.DebugCapsule 1：显示碰撞胶囊体
对于更复杂的同步问题，我会使用Session Frontend工具。在编辑器菜单栏选择"窗口→开发者工具→Session Frontend"，可以查看详细的网络同步数据。
5. 性能优化建议
5.1 网络带宽优化
多人游戏最怕的就是网络带宽不足。UE5提供了网络优先级系统，我们可以为不同的Actor设置不同的NetPriority：
AActor::SetNetPriority(1.5f); // 数值越大优先级越高复制频率也需要优化。对于移动缓慢的物体，可以降低更新频率：
AActor::SetNetUpdateFrequency(5.0f); // 每秒更新5次5.2 客户端预测优化
为了减少网络延迟带来的卡顿，我们需要合理使用客户端预测。UE5的CharacterMovementComponent已经内置了预测功能，但需要正确配置：
UCharacterMovementComponent::SetPredictiveMovement(true); UCharacterMovementComponent::SetEnableNetworkReplication(true);对于自定义的移动逻辑，可以使用FNetworkPredictionData_Client类来实现预测。我建议参考UE5源码中的CharacterMovementComponent实现方式。
6. 打包与部署
6.1 打包注意事项
打包多人游戏项目时，有几个关键设置不能忽略：
- 在项目设置中启用"打包→包含Prerequisites"
- 设置正确的"Default Game.ini"配置
- 确保所有用到的地图都加入了"打包→地图列表"
我遇到过最棘手的问题是打包后客户端连接不上服务器，后来发现是因为没有把服务器专用的地图打包进去。解决方法是在"高级设置→打包→额外非烹饪资产"中添加服务器地图。
6.2 部署技巧
部署到多台测试机器时，我习惯使用批处理脚本自动复制文件。创建一个deploy.bat文件：
xcopy /E /Y "Build\Windows" "\\TargetPC\SharedFolder\Game"测试时建议使用有线网络连接，WiFi的延迟和丢包率会影响测试结果。如果必须用WiFi，可以在项目设置中调整网络缓冲参数：
UNetDriver::SetNetServerMaxTickRate(30); UNetDriver::SetNetServerMaxClientRate(10000);多人游戏开发是个需要耐心的工作，我建议每次只实现一个小功能就立即测试，这样可以快速定位问题。记住，网络同步问题越早发现越容易解决。
