如何为 Project Zomboid 服务器添加模组

Project Zomboid 服务器模组的工作方式：Workshop ID 与 Mod ID

• Workshop ID——模组 Steam Workshop 地址末尾的数字，例如 2169435993。它告诉服务器要下载什么。
• Mod ID——模组在游戏内使用的名称，写在 Workshop 页面上（通常在底部附近，标为 Mod ID:）以及模组的 mod.info 文件中。它告诉服务器要加载什么。

一个 Workshop 项目可以包含多个模组，每个都有自己的 Mod ID。只添加你需要的 Mod ID——页面通常会说明该选哪一个。

在 servertest.ini 中添加模组

服务器设置文件是 Zomboid/Server/servertest.ini（以你的服务器命名）。先停止服务器，然后填写两行：

WorkshopItems=2169435993;2392709985
Mods=ModA;ModB

• WorkshopItems——Workshop ID，用分号分隔，不留空格。
• Mods——这些项目中的 Mod ID，同样用分号分隔。

启动服务器。它会下载 Workshop 项目并加载模组，玩家连接时会自动获取。

Build 42 还是 Build 41：模组有哪些变化

Build 42 是当前的稳定版本（42.21）；Build 41 仍作为旧版分支提供，适用于较老的模组列表。

• 模组只针对其中一个版本制作。Build 42 模组的文件放在 common 或 42 文件夹中；Build 41 模组则没有。有些 Workshop 项目两者都包含。不适用于服务器版本的模组会被跳过。
• 反斜杠。Build 42 显示的 Mod ID 前面带反斜杠，如 \ModA。在 Build 42 服务器上，写不写都可以——服务器会自动去掉。在 Build 41 服务器上千万不要加：在那里它会成为名称的一部分，导致找不到模组。
• 添加模组前查看 Workshop 页面，确认它支持哪个版本，并让整个列表保持在同一版本。

地图模组与加载顺序

地图需要第三行。除了 Workshop ID 和 Mod ID，还要把地图的文件夹名称加入 Map=，并保留列表中的基础地图：

Map=MyMapFolder;Muldraugh, KY

地图的 Workshop 页面会给出文件夹名称以及它在列表中应处的位置——请照做，尤其是在组合多张地图时。

加载顺序遵循 Mods= 中的顺序。如果某个模组依赖另一个模组，服务器会自动先加载该依赖——但前提是它已安装，所以它的 Workshop ID 也必须写在 WorkshopItems 中。缺少依赖的模组会被跳过。

保持模组更新

Workshop 模组更新后，玩家会下载新版本，但服务器在重启前仍使用旧版本——版本不再一致的玩家可能会无法加入。

• 重启即可更新。每次启动时，服务器都会下载缺失或过期的 Workshop 项目。
• 无需重启的检查：管理员命令 checkModsNeedUpdate 会向 Steam 查询你的项目是否有变动，并将结果写入聊天和日志。它只负责报告，不会更新任何内容。
• 报告有更新时，提醒玩家并重启，最好按计划进行。

模组无法加载时

• ID 填错了行——Workshop ID（数字）属于 WorkshopItems，Mod ID 属于 Mods。
• 任一列表中有空格或缺少分号。
• 模组适用于另一个版本——查看 Workshop 页面；在 Build 41 上去掉所有反斜杠。
• 缺少依赖——同时添加所依赖模组的 Workshop ID 和 Mod ID。
• 查看日志——服务器会记录加载了哪些模组、跳过了哪些以及原因。

在 HytHost Project Zomboid 服务器上使用模组

1. 在 Startup 选项卡中填写 ID。其中有一个 Workshop 项目字段和一个 Mods 字段。面板会在每次启动时把它们写入 servertest.ini，所以请在这里添加模组——直接写入文件的模组会在下次启动时被替换。
2. 地图是例外：用文件管理器编辑 servertest.ini 中的 Map= 行。
3. 在面板中重启。服务器会在启动时下载模组，游戏本身也会在每次启动前更新。
4. 下单时选择版本：Build 42 或 Build 41 旧版分支。之后切换需要重新安装，请先备份。

其余服务器设置请参阅 Project Zomboid 服务器设置，套餐详见 Project Zomboid 主机。