模组管理

模组支持是 WukongMP 的核心功能，允许你通过自定义内容扩展服务器的功能。

客户端模组

WukongMP 支持对连接到服务器的客户端进行自动模组同步。客户端连接时，服务器会检查客户端是否安装了所需的模组。如果没有，ReadyM Launcher 将下载并安装缺失的模组，才能加入游戏。

要将模组添加到服务器，只需将模组文件夹放在 mods/ 目录中。

模组文件夹的预期结构如下。如果你使用我们的官方模组模板，里面有一个MakeModFolder.ps1脚本，它将相应地打包模组。

示例 mod 文件夹布局

mods/
└──MyModFolder/         # mod 的根目录，可以任意命名
    ├── MyMod.dll       # mod 的主程序集
    ├── manifest.json   # mod 清单文件
    └── other_files...  # mod 所需的其他文件（可选）

连接到服务器时，客户端将自动从 mods/ 目录下载并安装任何缺失的模组，确保无缝的多人游戏体验。

安全公告

WukongMP SDK 和服务器的抢先体验版本不包含任何针对模组的沙箱或安全机制。

仅使用来自可信来源的模组，因为它们可能在客户端执行任意代码。

请勿在服务器上运行不可信的模组，尤其是在服务器对公众可访问时。

.pak 文件

WukongMP 的模组可以包含用于游戏资源的 .pak 文件，这些文件将被游戏自动加载。

要在你的模组中包含一个 .pak 文件，只需将它放在模组文件夹中的任意位置即可。只要模组中存在有效的 manifest.json 文件，服务器就会将其识别为模组并分发给客户端，游戏在加载模组时会加载 .pak 文件。

特别是，这使你能够创建仅包含自定义资源且不包含任何代码的模组，这对于简单的内容模组非常有用。

一个包含 .pak 文件的示例模组结构如下：

Example mod folder layout with .pak file

mods/
└──MyModFolder/           # mod 的根目录，可以任意命名
    ├── manifest.json     # mod 清单文件
    ├── custom_assets.pak # 自定义资源包
    └── other_files...    # mod 所需的其他文件（可选）

服务器端模组

正在进行中

此功能正在开发中，将在未来的 SDK 版本中提供。