本指南涵盖 Hogwarp 服务器的管理、插件支持、更新和故障排除。Hogwarp 是 Hogwarts Legacy 的多人游戏模组。有关初始设置、API 密钥配置和连接说明，请参阅 Hogwarp 服务器设置指南。
1. 服务器管理
Hogwarp 服务器管理主要通过 config.json 文件和 GPanel 控制台完成。服务器通过 Wine（Linux 上的 Windows 兼容层）运行。
GPanel 控制台
使用 GPanel Console 标签页监控服务器活动并查看连接日志。服务器会将玩家加入/离开事件和任何错误输出到控制台。
2. 插件支持
Hogwarp 支持服务器端插件。将插件文件放置在：
plugins/通过 SFTP 上传插件并重启服务器。查看 Hogwarp Discord 了解可用插件和兼容性信息。
注意： 插件可用性取决于 Hogwarp 版本。请查看 Hogwarp Discord 获取最新的插件目录。
3. 服务器设置
直接编辑 config.json 进行高级配置。在进行更改之前请停止服务器。
| 设置 | 描述 |
|---|---|
ApiKey | 您的 Hogwarp API 密钥（必需）。 |
Name | 多人游戏列表中的服务器名称。 |
Port | 服务器端口（由 GPanel 管理）。 |
Description | 多人游戏列表中的服务器描述。 |
MaxPlayer | 最大玩家数（受 Patreon 等级限制）。 |
IconUrl | 您的服务器图标图片 URL。 |
4. 更新服务器
Hogwarp 更新频繁。更新方法：
- 停止服务器。
- 查看 Hogwarp Discord 获取最新的服务器文件。
- 下载新的服务器文件并通过 SFTP 上传，替换现有文件。
- 请先备份您的
config.json和plugins/目录。 - 启动服务器。
版本匹配至关重要。 服务器版本必须与客户端模组版本匹配。更新服务器后，请确保所有玩家也更新其客户端模组。
5. 故障排除
服务器无法启动
- "API Key" 错误： 确保
API_KEY已设置为从 presence.hogwarp.com 获取的有效密钥，而非默认的CHANGEME。 - Wine 错误： 服务器在 Wine 下运行。检查 GPanel 控制台中的 Wine 相关错误。这些问题通常可以通过重新安装服务器解决。
- 文件缺失： 如果
HogWarpServer.exe缺失，请从 GPanel 设置中重新安装服务器。
玩家无法连接
- 验证控制台中是否显示
Server started on port。 - 确保 API 密钥有效且处于激活状态。
- 检查所有玩家是否安装了正确版本的 Hogwarp 客户端模组。
- 如果 API 密钥有效，服务器应自动出现在 Hogwarp 多人游戏列表中。
服务器未出现在列表中
- 再次检查您的 API 密钥是否正确且处于激活状态。
- 验证服务器是否已完全启动（检查控制台中的启动消息）。
- Hogwarp 主服务器可能暂时宕机 -- 请查看 Hogwarp Discord 了解状态更新。
相关文章
需要帮助？
如果您遇到本指南未涵盖的 Hogwarp 服务器问题，请 提交支持工单，并附上您的服务器 IP、问题描述以及 GPanel 控制台中的相关错误信息。
