Barotrauma 故障排除指南
本指南介绍在 Legion Hosting 上运行 Barotrauma 专用服务器时可能遇到的常见问题及分步解决方案。有关初始服务器设置，请参阅 Barotrauma 专用服务器设置指南。
目录
潜艇未加载 / 服务器启动卡住
症状：服务器启动了但玩家无法加入，或者服务器日志显示找不到潜艇的错误。
解决方案
- 检查名称是否完全正确：
serversettings.xml中的Submarine属性必须与文件名（不含.sub扩展名）完全匹配，包括大小写。例如，Humpback是正确的，但humpback是不正确的。 - 验证文件是否存在：通过 SFTP 或 GPanel 文件管理器连接到服务器，确认
.sub文件存在于Submarines/目录中。 - 创意工坊潜艇？如果潜艇来自创意工坊模组，必须将其安装在
LocalMods/中并在服务器设置中注册后才能使用。请参阅模组安装指南。 - 使用默认潜艇测试：切换到内置潜艇（如
Humpback）以确认服务器能正常启动。如果可以，则问题出在自定义潜艇文件上。
模组冲突和崩溃
症状：服务器启动时崩溃、玩家加入时断开连接，或控制台显示引用特定内容 ID 的错误。
解决方案
- 隔离问题模组：禁用所有最近添加的模组并重启服务器。如果运行稳定，则逐一重新启用模组，每次都重启，以找到冲突。
- 版本不匹配：确保服务器上的所有模组文件与客户端机器上安装的版本一致。如有不确定，请重新下载并重新上传模组。更新流程请参阅模组安装指南。
- 仅客户端模组：某些创意工坊模组仅限客户端，不应安装在服务器上。请查看模组的创意工坊描述页面了解此信息。
- 查看服务器日志：在 GPanel 中打开控制台，查找
[ERROR]或Exception行。这些通常会引用导致崩溃的特定模组或内容文件。
提示：如果您运行了许多模组且无法确定冲突，请尝试二分查找法：每次禁用一半的模组，而不是逐一禁用。这样可以更快地缩小问题范围。
服务器未出现在浏览器中
症状：您的服务器正在运行但未出现在游戏内服务器浏览器中。
解决方案
- 等待几分钟：Steam 服务器浏览器可能需要几分钟才能列出新启动的服务器。先尝试直接连接以确认服务器可达。
- 验证服务器已完全启动：打开 GPanel 并确认服务器显示为正在运行且控制台中没有错误。
- 检查查询端口：
serversettings.xml中的QueryPort值必须与分配给您服务的查询端口一致。请查看 GPanel 中的 Network 选项卡获取正确的端口分配。 - 通过直接连接确认：尝试使用服务器 IP 和主端口直接连接（查看 GPanel Network 选项卡获取分配的端口），以排除浏览器特定的问题。
连接超时 / 无法直接连接
症状：尝试通过直接连接加入时出现超时或"连接失败"错误。
解决方案
- 验证您的 IP 和端口：查看 GPanel 中的 Network 选项卡获取服务器的 IP 地址和端口。请参阅如何查找您的服务器 IP 和端口。
- 使用正确的端口：连接到主游戏端口，而不是查询端口。主端口是 GPanel 中列出的主要端口。
- 确认服务器正在运行：检查 GPanel 确保服务器没有崩溃或停止。
- 检查您的 serversettings.xml：确保
serversettings.xml中的Port值与 GPanel 中分配的端口一致。如果不一致，服务器将绑定到错误的端口。 - 您这边的防火墙：在极少数情况下，您的本地网络或 ISP 可能会阻止非标准端口上的出站 UDP 流量。尝试从不同的网络连接或使用 VPN 进行测试。
重启后找不到战役存档
症状：重启服务器后，战役消失了，玩家必须开始新的战役。
解决方案
- 验证存档文件是否存在：通过 SFTP 连接并检查
Saves/Multiplayer/中是否仍然存在战役文件夹。 - 检查迁移问题：如果您最近迁移了服务器或从备份恢复，请确保存档文件夹已上传到 Barotrauma 服务器目录中的正确路径。
- 非正常关机：如果服务器被强制终止（而不是通过 GPanel 正常停止），最终的存档状态可能未被写入。请始终使用 GPanel 中的 Stop 按钮，而不是强制终止进程。
- 从备份恢复：如果您之前备份了战役，请停止服务器，通过 SFTP 将备份文件夹上传到
Saves/Multiplayer/，然后启动服务器。详细的备份/恢复说明请参阅主设置指南。
服务器延迟和性能问题
症状：玩家遇到橡皮筋效应、输入延迟，或者服务器在游戏过程中变得无响应。
解决方案
- 减少玩家数量：如果您的服务器方案没有足够的资源来支持当前玩家数量，请降低
serversettings.xml中的MaxPlayers值。 - 减少模组数量：某些模组，特别是那些添加大量新生物或复杂系统的模组，会显著增加服务器资源使用。请移除非必要的模组。
- 检查服务器资源：在 GPanel 中监控 CPU 和内存使用情况。如果持续接近上限，请考虑升级您的服务器方案。
- 重启服务器：长时间运行的会话可能会累积内存使用。在游戏会话之间定期重启可以帮助维持性能。
相关文章
仍然遇到问题？请在 legionhosting.net/submitticket.php 提交支持工单，并附上您的服务器名称、GPanel 控制台中的错误信息以及您已尝试的步骤。
