Unturned 服务器故障排除
本指南介绍 Legion Hosting 上 Unturned 专用服务器的常见问题及解决方法。有关初始服务器设置，请参阅 Unturned 服务器设置指南。
服务器未出现在服务器浏览器中
如果您的服务器正在运行但未出现在 Unturned 或 Steam 服务器浏览器中：
- 需要 GSLT：没有有效的 Game Server Login Token，您的服务器可能不会公开出现在服务器列表中。请从 Steam Game Server Account Management 页面使用 App ID 304930 生成一个，然后将其粘贴到 GPanel Startup 选项卡中的 GSLT 字段。完整说明请参阅服务器设置指南。
- 启动后等待 5-10 分钟 — Steam 需要时间索引新服务器。
- 在 GPanel 中确认服务器正在运行（绿色状态指示灯）。
- 尝试使用 IP 和端口直接连接，以验证服务器是否可达。请参阅如何查找您的服务器 IP 和端口。
- 确保游戏端口和查询端口（游戏端口 + 1）与 GPanel Network 选项卡中分配的端口一致。
无法连接 / 连接超时
如果您收到连接超时或无法加入服务器：
- 确认服务器正在运行，并在 GPanel 中显示绿色状态。
- 验证您使用的 IP 地址和端口是否正确 — 请查看如何查找您的服务器 IP 和端口。
- 检查
Commands.dat中的Port值是否与 GPanel Network 选项卡中分配给服务器的端口一致。不匹配将导致无法连接。 - 如果您在
Commands.dat中设置了Password，请确保连接时输入的密码正确。 - 尝试从 GPanel 重启服务器。
- 如果问题仍然存在，请在 GPanel 中查看服务器控制台日志以获取错误信息。
创意工坊模组未下载
如果重启后创意工坊模组未加载：
- 打开
Servers/default/WorkshopDownloadConfig.json并验证其为有效的 JSON。常见错误包括 ID 之间缺少逗号、最后一个 ID 后有多余逗号、或括号不匹配。 - 确认创意工坊物品 ID 是正确的整数（不是带引号的字符串）。
- 在 GPanel 中查看服务器控制台日志，检查启动期间是否有 Steam API 或下载错误。
- 某些创意工坊物品可能已被作者限制或删除 — 请验证它们在 Steam 创意工坊中是否仍然公开可用。
- 有依赖项的创意工坊物品可能需要在配置中添加额外的 ID。请查看模组的创意工坊页面了解所需物品。
更多详情请参阅模组和插件安装指南。
Rocket 插件未加载
如果 RocketMod 或 LDM 插件安装后无法工作：
- 确认
.dll文件直接放置在Rocket/Plugins/中 — 不要放在子文件夹或 ZIP 压缩包内。 - 重启服务器后，在 GPanel 控制台日志中检查插件加载错误。错误消息通常会指出版本不兼容或缺少依赖项。
- 确保插件版本与您的 Unturned 和 RocketMod/LDM 版本兼容。
- 某些插件需要其他 DLL 依赖项，也必须放置在
Rocket/Plugins/文件夹中。 - 如果插件之前可以正常工作，但在 Unturned 更新后停止工作，请向作者查找更新版本的插件。
有关插件安装的详细信息，请参阅模组和插件安装指南。
服务器启动时崩溃
如果服务器在启动后立即停止或崩溃：
- 查看控制台日志 — 在 GPanel 中查看，日志末尾附近的错误消息将指出问题所在。
- 无效的 Commands.dat：格式错误或损坏的
Commands.dat可能会阻止启动。要重置，请通过 GPanel 文件管理器删除Servers/default/Commands.dat并重启服务器。它将以默认设置重新生成。 - 有问题的创意工坊模组：不兼容或损坏的创意工坊模组可能导致崩溃。从
WorkshopDownloadConfig.json中删除所有创意工坊 ID，确认服务器能正常启动，然后逐一添加 ID 以确定有问题的模组。 - 损坏的插件：有问题的 Rocket 插件也可能导致服务器崩溃。从
Rocket/Plugins/中删除所有.dll文件，验证服务器能否启动，然后逐一重新添加插件。 - 如果服务器崩溃且没有明显错误，请尝试从 GPanel 的 Settings 选项卡（重新安装服务器选项）重新安装服务器文件。
玩家被意外踢出
如果玩家在没有任何解释的情况下被断开连接或踢出：
- 查看服务器控制台日志以获取踢出原因 — 常见原因包括 BattlEye 反作弊违规或超时错误。
- 如果使用创意工坊模组，请确保所有玩家都订阅了相同的创意工坊物品。缺少内容可能会导致不同步踢出。
- 服务器资源使用过高（内存或 CPU）可能导致玩家超时。在 GPanel 中监控资源使用情况，并考虑减少
MaxPlayers或移除占用资源较多的模组。 - 如果某个特定玩家反复被踢出，他们的游戏文件可能已损坏 — 建议他们通过 Steam 验证游戏文件（右键点击 Unturned > Properties > Local Files > Verify）。
地图未加载 / 地图错误
如果服务器启动但加载了错误的地图或无法加载创意工坊地图：
- 验证
Commands.dat中的Map值是否与准确的内部名称匹配（例如PEI、Washington、Russia）。名称区分大小写。 - 对于创意工坊地图，创意工坊 ID 必须在
WorkshopDownloadConfig.json中，且Map值必须与下载的文件夹名称匹配，而不是创意工坊的显示名称。 - 在启动期间查看服务器控制台日志，检查地图加载错误或下载失败。
相关文章
- Unturned 服务器设置指南 — 初始配置、GSLT、地图和连接方法。
- Unturned 管理员设置 — 权限、管理员列表和游戏内管理员命令。
- Unturned 模组和插件安装 — 创意工坊模组和 RocketMod/LDM 插件。
- 如何查找您的服务器 IP 和端口
- 如何通过 SFTP 上传文件
需要帮助？
如果尝试以上解决方案后仍然遇到问题，我们的支持团队随时为您提供帮助。
提交支持工单