适用于 Unreal 的插件:安装和设置插件组件
本节介绍将插件添加到 Unreal Engine 项目的初始安装任务。当在 Unreal 编辑器中打开项目时,插件功能就可用。
注意
您可以将 Amazon GameLift 插件与标准版本的 UE 编辑器一起使用,但是在打包游戏服务器构建时,需要使用源代码构建的版本。
开始之前
以下是使用适用于 Unreal Engine 的 Amazon GameLift 插件所需的内容:
-
适用于 Unreal Engine 的 Amazon GameLift 插件发布包。[下载网站]
。 -
Microsoft Visual Studio 2019 或更高版本。
-
Unreal Engine 编辑器的源代码构建版本。需要一个源代码构建版本来打包多人游戏的服务器组件。如需更多详细信息,包括其他先决条件,请参阅 Unreal Engine 文档:
-
在 GitHub 上访问 Unreal Engine 源代码
您将需要 GitHub 和 Epic Games 账户。
-
-
一个包含 C++ 游戏代码的多人游戏项目。如果您正在处理蓝图项目,请参阅 Unreal 文档,了解如何为项目生成 C++ 源代码。
构建 Amazon GameLift C++ 服务器 SDK
适用于 Unreal Engine 的 Amazon GameLift 插件发布包包含适用于 Unreal 的 C++ 服务器 SDK 源代码。在将其与插件一起使用之前,您需要提取源代码并针对您的开发环境构建它。
注意
如果您要构建在 Amazon Linux 2023 运行时环境中运行的游戏服务器,则可以利用作为 Amazon GameLift Toolkit 存储库一部分提供的帮助程序脚本。使用该帮助程序脚本可生成使用插件所需的 SDK 二进制文件和 SSL 库。在 Windows 或 Linux 上使用 Unreal Engine 5 进行开发时,可以使用该脚本。该脚本是一个基于 Docker 的解决方案。您可以在安装了 git 和 docker 的情况下在本地运行它,也可以使用 AWS Management Console中的 AWS CloudShell 运行它。
手动构建适用于 Unreal 的 C++ 服务器 SDK
-
解压缩适用于 Unreal Engine 的 Amazon GameLift 插件发布包以提取两个 zip 文件:
amazon-gamelift-plugin-unreal-<>-sdk-<>.zip
GameLift-Cpp-ServerSDK-<>.zip.
解压缩这些文件。
-
打开
GameLift-Cpp-ServerSDK-<>
文件夹,然后针对您的平台(Linux 或 Microsoft Windows)完成以下指令。
Linux
-
运行以下命令:
mkdir out cd out cmake -DBUILD_FOR_UNREAL=1 .. make
这些命令将生成
/lib/aws-cpp-sdk-gamelift-server.so
文件。 将
/lib/aws-cpp-sdk-gamelift-server.so
复制到amazon-gamelift-plugin-unreal/GameLiftPlugin/Source/GameliftServer/ThirdParty/GameLiftServerSDK/Linux/x86_64-unknown-linux-gnu/
目录。
Microsoft Windows
运行以下命令:
mkdir out cd out cmake -G "Visual Studio 17 2022" -DBUILD_FOR_UNREAL=1 .. msbuild ALL_BUILD.vcxproj /p:Configuration=Release
这些命令将生成以下二进制文件。
prefix\bin\aws-cpp-sdk-gamelift-server.dll
prefix\lib\aws-cpp-sdk-gamelift-server.lib
将这些文件复制到
amazon-gamelift-plugin-unreal\GameLiftPlugin\Source\GameliftServer\ThirdParty\GameLiftServerSDK\Win64\
目录。
将插件添加到游戏项目。
在游戏项目打开的情况下在 Unreal 编辑器中完成以下任务。
将插件添加到项目
安装插件文件。
找到您的游戏项目根文件夹,例如
... > Unreal Projects/[project-name]/
。查找Plugins
文件夹。如果该文件夹不存在,则创建它。解压缩插件发布包(
amazon-gamelift-plugin-unreal-<>-sdk-<>.zip
)。打开amazon-gamelift-plugin-unreal
文件夹并查找GameLiftPlugin
文件夹。将此文件夹复制到步骤 1 中的文件夹Plugins
。
-
将插件添加到
.uproject
文件。-
在您的游戏项目根文件夹中,打开
.uproject
文件。 -
更新文件以将“GameLiftPlugin”和“WebBrowserWidget”添加到
Plugins
部分并启用它们。以下代码显示了名为“MyGame”的游戏的更新后的.uproject
文件。
UnrealProjects > MyGame > MyGame.uproject { ... "Plugins": [ { "Name": "ModelingToolsEditorMode", "Enabled": true, "TargetAllowList": [ "Editor" ] }, { "Name": "GameLiftPlugin", "Enabled": true }, { "Name": "WebBrowserWidget", "Enabled": true } ] }
-
-
更改项目的 UE 编辑器版本。
如果您为一个编辑器版本创建了项目,但现在想要更改为另一个版本(例如源代码构建版本),则需要更新该项目。
在游戏项目根文件夹中,选择
.uproject
文件并选择切换 Unreal Engine 版本。选择新的编辑器版本。 使用您的更新重新构建项目解决方案。
在项目根文件夹中,查找解决方案(
*.sln
)文件。如果不存在任何文件,请选择.uproject
文件并选择生成 Visual Studio 项目文件选项。打开解决方案文件并构建或重建项目。
确认该插件已在 UE 编辑器中启用。
注意
如果已经打开了编辑器,则可能需要在编辑器识别新插件之前重新启动编辑器。
在选择的 UE 编辑器中打开项目。
在主编辑器工具栏中查看新的 Amazon GameLift 菜单按钮 [需要图片]。
在内容浏览器中查找 Amazon GameLift 插件资产。确保在您的查看选项设置中,已选中显示插件内容选项。