入门#

以下说明将指导您安装和配置 Multiplay 游戏服务器 SDK 插件。在为您的项目安装和配置了 Multiplay 游戏服务器 SDK 后，您可以使用 C++ 或 蓝图 集成。

了解需求#

适用于虚幻引擎的 Multiplay 游戏服务器 SDK 插件支持虚幻引擎版本 4.27 到 5.3。

从源代码构建引擎#

虚幻引擎要求您使用源代码构建来设置专用服务器。请参考 设置专用服务器（虚幻引擎）。

执行以下步骤以从源代码构建虚幻引擎

1. 创建 Epic Games 账户。
2. 创建 GitHub 账户。
3. 将您的 Epic Games 账户链接到 GitHub 账户。
4. 使用 Git 克隆 虚幻引擎源代码。
5. 检出与上述引擎版本之一相对应的分支（例如，4.27）。
6. 按照您检出的引擎版本 README.md 文件中的“入门”说明进行操作。

此时，您应该拥有一个虚幻引擎二进制文件。

下载游戏服务器托管（Multiplay）SDK#

从虚幻引擎市场网站#

1. 登录 虚幻引擎市场。
2. 访问 适用于虚幻引擎的 Unity 游戏服务 SDK 市场页面。
3. 选择在启动器中打开。
4. 跳至 从 Epic Games 启动器 中的步骤 4

从 Epic Games 启动器#

1. 登录您的 Epic Games 启动器。
2. 在您的 Epic Games 启动器中搜索Unity 游戏服务 SDK for Unreal Engine。
3. 访问适用于虚幻引擎的 Unity 游戏服务 SDK 页面，然后选择免费。
4. 在您的 Epic Games 启动器中选择安装到引擎。
5. 打开一个新项目或现有项目。
6. 导航到“插件”窗口，然后选中 Unity 游戏服务 SDK for Unreal Engine 旁边的复选框。
7. 重启虚幻引擎
8. 通过以下操作访问您的市场文件夹

• 如果您使用的是 Windows，则默认路径为：C:\Program Files\Epic Games\UE_5.3\Engine\Plugins\Marketplace。MacOS 和 Linux 也有类似的路径。
• 将UnityGamingServicesSDK文件夹复制到您的项目Plugins文件夹中。如果它尚不存在，请在项目的根目录中创建它。

构建包含 SDK 的项目#

1. 右键单击（macOS：Ctrl+单击）.uproject文件，然后选择生成 Visual Studio 项目文件。
2. 等待生成完成。
3. 使用 Visual Studio 打开.sln文件。
4. 在.build.cs文件（MultiplayGameServerSDK）中添加模块作为依赖项。
5. 添加一个新的.target.cs文件，其中包含服务器目标配置。

请参考 构建插件（虚幻引擎）

配置 Multiplay 游戏服务器 SDK#

Multiplay 从有关游戏服务器实例的信息（如 IP 地址、端口号和服务器 ID）生成server.json文件。它还包含来自活动构建配置的任何配置变量。

Multiplay 游戏服务器 SDK 使用server.json文件访问服务器查询端口变量（$$query_port$$）和服务器 ID 变量（$$serverid$$）。

要在 Unity 云控制面板 中配置server.json文件，请访问游戏服务器托管（Multiplay），然后选择构建配置。

您必须在server.json文件中至少包含queryPort和serverID，以用于您的项目。请参考以下server.json文件示例。

{
  "queryPort": "$$query_port$$",
  "serverID": "$$serverid$$"
}

下一步是什么？#

继续进行以下任一集成

• 蓝图集成
• C++ 集成