开始使用

Install and configure the Multiplay Hosting SDK for Unreal Engine.

阅读时间3 分钟

最后更新于 4 天前

以下说明会介绍如何安装和配置 Multiplay Game Server SDK 插件。为您的项目安装和配置 Multiplay Game Server SDK 后，您可以使用 C++ 或 Blueprint 集成。

要求需知

适用于 Unreal Engine 的 Multiplay Game Server SDK 插件支持 Unreal Engine 版本 4.27 到 5.3。

利用源版本构建引擎

Unreal Engine 要求您使用源版本来设置专用服务器。请参阅设置专用服务器 (Unreal Engine)。执行以下操作，以利用源版本构建 Unreal Engine ：

创建 Epic Games 帐户。
创建 GitHub 帐户。
将您的 Epic Games 帐户与 GitHub 帐户关联。
使用 Git 克隆 Unreal Engine 源代码。
请参阅与上述引擎版本之一（如 4.27）对应的分支。
根据您所查看的引擎版本的
```
README.md
```
文件中的开始运行说明进行操作。

此时，您应该有一个 Unreal Engine 二进制文件。

下载 Multiplay Hosting SDK

通过 Unreal Engine Marketplace

登录 Unreal Engine Marketplace。
访问 Unity Gaming Services SDK for Unreal Engine Marketplace 页面。
Unity Gaming Services SDK for Unreal Engine Marketplace 页面
选择 Open in Launcher（在启动器中打开）。
跳至[通过 Epic Games Launcher](./get-started.mdx#from-the-epic-games-launcher) 中的步骤 4。

通过 Epic Games Launcher

登录您的 Epic Games Launcher。
在您的 Epic Games Launcher 中搜索
```
Unity Gaming Services SDK for Unreal Engine
```
。
搜索 Unity Gaming Services SDK for Unreal Engine
访问 Unity Gaming Services SDK for Unreal Engine 页面，然后选择 Free（免费）。
Unity Gaming Services SDK for Unreal Engine Launcher 页面
在 Epic Games Launcher 中选择 Install to Engine（安装到引擎）。
Unity Gaming Services SDK for Unreal Engine 安装按钮
打开一个新项目或现有项目。
导航到
```
Plugins
```
（插件）窗口并选中 Unity Gaming Services SDK for Unreal Engine 旁边的复选框。
Unity Gaming Services SDK for Unreal Engine 插件窗口
重新启动 Unreal Engine。
通过执行以下操作来访问您的 Marketplace 文件夹：

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

构建包括 SDK 的项目

右键单击（macOS：Ctrl+单击）
```
.uproject
```
文件，然后选择 Generate Visual Studio project files（生成 Visual Studio 项目文件）。
等待生成过程完成。
使用 Visual Studio 打开
```
.sln
```
文件。
在
```
.build.cs
```
文件 (
```
MultiplayGameServerSDK
```
) 中将该模块添加为依赖项。
添加一个包含服务器目标配置的新
```
.target.cs
```
文件。

请参阅构建插件 (Unreal Engine)

配置 Multiplay Game Server SDK

Multiplay 会根据游戏服务器实例（如 IP 地址、端口编号和服务器 ID）的相关信息生成

server.json

文件，其中还包含活跃版本配置中的任何配置变量。 Multiplay Game Server SDK 使用

server.json

文件访问服务器查询端口变量 (

$$query_port$$

) 和服务器 ID 变量 (

$$serverid$$

)。要在 Unity Cloud 后台中配置

server.json

文件，请访问 Multiplay Hosting，然后选择 Build Configurations（版本配置）。在您项目的

server.json

文件中，您至少要包含

queryPort

和

serverID

。请参阅以下

server.json

文件示例。


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

注意

请参阅

server.json

文档。

下一步

继续进行以下集成之一：

文档

引擎

服务

增长

工业

支持

Multiplay Hosting for the Unreal Engine

Multiplay Hosting overview