本指南介绍如何通过 GPanel 在 Project Zomboid 服务器的 Build 41 (B41) 和 Build 42 (B42) 之间进行切换。内容涵盖存档兼容性、备份世界以及自行执行切换操作。
切换前：了解存档兼容性问题
Project Zomboid 将所有世界和玩家数据存储在与创建时所用版本绑定的存档文件夹中。两个版本对地图区块、物品定义和玩家角色数据使用不同的格式。
| 版本 | Steam Beta 分支 | 能否使用 B41 存档？ | 能否使用 B42 存档？ |
|---|---|---|---|
| Build 41 (B41) | （留空） | 是 | 否 |
| Build 42 (B42) | unstable |
否 | 是 |
Beta 分支在 GPanel 服务器的 Startup 选项卡中设置。
切换完成后，您的服务器将在新版本上全新启动。之前版本的现有世界仍会保留在存档文件夹中，但服务器不会加载它。它不会被自动删除——只是不会被使用。您必须更改服务器名称或删除现有存档数据，然后才能在新版本上启动。
步骤 1 — 备份您当前的世界
在切换版本之前，请下载当前存档的副本。即使您不打算回到旧版本，备份也能防止意外数据丢失，并在情况发生变化时提供可恢复的内容。
选项 A：通过 GPanel 备份
- 登录 GPanel 并选择您的 Project Zomboid 服务器。
- 使用 Console 选项卡上的 Stop 按钮停止服务器，等待状态显示为 Offline。
- 在 GPanel 中导航到 Backups 选项卡。
- 点击 Create Backup 并等待完成。备份将显示在下方列表中。
- 备份列出后，点击下载图标将其保存到本地。
选项 B：通过 SFTP 下载存档文件夹
如果您只想下载世界存档数据而非完整的服务器备份，可以通过 SFTP 连接到服务器并手动下载存档文件夹。
- 在 GPanel 中，前往 SFTP 选项卡，记下您的 SFTP 主机名、端口、用户名和密码。
- 打开 SFTP 客户端（如 FileZilla），使用这些凭据连接。
- 导航到世界存档目录：
/home/container/.cache/saves/multiplayer/<YourWorldName>/ - 将整个
<YourWorldName>文件夹下载到本地计算机。
步骤 2 — 在 GPanel 中切换版本
通过服务器的启动选项即可在 B41 和 B42 之间切换，无需提交支持工单。
- 登录 GPanel 并选择您的 Project Zomboid 服务器。
- 确保服务器已停止。
- 前往 Startup 选项卡。
- 找到 Beta Branch 字段：
- 要切换到 B41：将 Beta Branch 字段留空（清空）。
- 要切换到 B42：在 Beta Branch 字段中输入
unstable。
- 在 Startup 选项卡中将 Server Name 更改为与当前名称不同的新名称。这可以防止新版本尝试加载不兼容的存档数据。
- 前往 Settings 选项卡，点击 Reinstall Server。这将下载所选版本的正确游戏文件。
- 启动服务器。它将在新服务器名称下生成一个全新的世界。
.cache/ 文件夹以外的所有文件，然后重新安装。.cache/ 文件夹包含您的服务器配置，因此这样做可以在确保新版本游戏安装干净的同时保留您的设置。仅在不想更改服务器名称时使用此方法——注意，旧服务器名称下的存档数据需要从 .cache/saves/multiplayer/ 手动删除。
切换后的模组兼容性
模组在不同版本之间不兼容。为 B41 编写的模组无法在 B42 上运行，反之亦然。切换后，您需要检查并更换整个模组列表。
- 从 B41 切换到 B42： 大多数热门的 B41 模组已更新或被 B42 版本替代。请在 Steam Workshop 中查找您之前使用的模组的 B42 专用版本。请注意，
WorkshopItems格式在 B42 中也有变化——请参阅模组安装指南了解正确的 B42 格式。 - 从 B42 切换到 B41： B42 模组无法在 B41 上加载。您必须找到并安装您想使用的模组的原始 B41 版本。请在 Steam Workshop 中查找维护了独立 B41 分支的模组作者。
常见问题
我可以同时保留 B41 世界和 B42 世界吗？
不能在同一服务器上同时运行——单个服务器实例一次只能运行一个版本。但是，切换到 B42 后，您的 B41 存档文件仍保留在磁盘上。如果将来切换回 B41 并恢复原始服务器名称，旧存档可以重新加载。您之前的存档数据存储在 .cache/saves/multiplayer/ 中，在版本切换期间不会被自动删除。
切换回 B41 需要额外费用吗？
不需要。版本切换完全通过 GPanel 完成，无需额外收费。在 Legion Hosting，Project Zomboid B41 和 B42 服务器的价格相同。
切换后我的玩家收到版本不匹配错误
这意味着服务器和玩家的游戏客户端处于不同的版本。玩家需要将其 Steam beta 分支与服务器的版本匹配：
- 在 Steam 中，右键点击 Project Zomboid 并选择 Properties。
- 点击 Betas 选项卡。
- 从下拉菜单中选择 None——这将使用当前默认版本 (B41)。
- 如果服务器运行的是 B42，请选择 unstable。
- 等待 Steam 更新游戏，然后启动并连接。
仍需帮助？
如果您在切换过程中遇到问题，请提交支持工单，我们将为您提供帮助。
