适用于 Unreal 的插件:安装和设置插件组件 - Amazon GameLift

适用于 Unreal 的插件:安装和设置插件组件

本节介绍将插件添加到 Unreal Engine 项目的初始安装任务。当在 Unreal 编辑器中打开项目时,插件功能就可用。

注意

您可以将 Amazon GameLift 插件与标准版本的 UE 编辑器一起使用,但是在打包游戏服务器构建时,需要使用源代码构建的版本。

开始之前

以下是使用适用于 Unreal Engine 的 Amazon GameLift 插件所需的内容:

  • 适用于 Unreal Engine 的 Amazon GameLift 插件发布包。[下载网站]

  • Microsoft Visual Studio 2019 或更高版本。

  • Unreal Engine 编辑器的源代码构建版本。需要一个源代码构建版本来打包多人游戏的服务器组件。如需更多详细信息,包括其他先决条件,请参阅 Unreal Engine 文档:

  • 一个包含 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 Engine 5 的 Amazon GameLift 构建脚本的更多信息。

手动构建适用于 Unreal 的 C++ 服务器 SDK
  1. 解压缩适用于 Unreal Engine 的 Amazon GameLift 插件发布包以提取两个 zip 文件:

    • amazon-gamelift-plugin-unreal-<>-sdk-<>.zip

    • GameLift-Cpp-ServerSDK-<>.zip.

    解压缩这些文件。

  2. 打开 GameLift-Cpp-ServerSDK-<> 文件夹,然后针对您的平台(Linux 或 Microsoft Windows)完成以下指令。

Linux

  1. 运行以下命令:

    mkdir out cd out cmake -DBUILD_FOR_UNREAL=1 .. make

    这些命令将生成 /lib/aws-cpp-sdk-gamelift-server.so 文件。

  2. /lib/aws-cpp-sdk-gamelift-server.so 复制到 amazon-gamelift-plugin-unreal/GameLiftPlugin/Source/GameliftServer/ThirdParty/GameLiftServerSDK/Linux/x86_64-unknown-linux-gnu/ 目录。

Microsoft Windows

  1. 运行以下命令:

    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

  2. 将这些文件复制到 amazon-gamelift-plugin-unreal\GameLiftPlugin\Source\GameliftServer\ThirdParty\GameLiftServerSDK\Win64\ 目录。

将插件添加到游戏项目。

在游戏项目打开的情况下在 Unreal 编辑器中完成以下任务。

将插件添加到项目
  1. 安装插件文件。

    1. 找到您的游戏项目根文件夹,例如 ... > Unreal Projects/[project-name]/。查找 Plugins 文件夹。如果该文件夹不存在,则创建它。

    2. 解压缩插件发布包(amazon-gamelift-plugin-unreal-<>-sdk-<>.zip)。打开 amazon-gamelift-plugin-unreal 文件夹并查找 GameLiftPlugin 文件夹。将此文件夹复制到步骤 1 中的文件夹 Plugins

  2. 将插件添加到 .uproject 文件。

    1. 在您的游戏项目根文件夹中,打开 .uproject 文件。

    2. 更新文件以将“GameLiftPlugin”和“WebBrowserWidget”添加到 Plugins 部分并启用它们。以下代码显示了名为“MyGame”的游戏的更新后的 .uproject 文件。

    UnrealProjects > MyGame > MyGame.uproject { ... "Plugins": [ { "Name": "ModelingToolsEditorMode", "Enabled": true, "TargetAllowList": [ "Editor" ] }, { "Name": "GameLiftPlugin", "Enabled": true }, { "Name": "WebBrowserWidget", "Enabled": true } ] }
  3. 更改项目的 UE 编辑器版本。

    如果您为一个编辑器版本创建了项目,但现在想要更改为另一个版本(例如源代码构建版本),则需要更新该项目。

    在游戏项目根文件夹中,选择 .uproject 文件并选择切换 Unreal Engine 版本。选择新的编辑器版本。

  4. 使用您的更新重新构建项目解决方案。

    1. 在项目根文件夹中,查找解决方案(*.sln)文件。如果不存在任何文件,请选择 .uproject 文件并选择生成 Visual Studio 项目文件选项。

    2. 打开解决方案文件并构建或重建项目。

  5. 确认该插件已在 UE 编辑器中启用。

    注意

    如果已经打开了编辑器,则可能需要在编辑器识别新插件之前重新启动编辑器。

    1. 在选择的 UE 编辑器中打开项目。

    2. 在主编辑器工具栏中查看新的 Amazon GameLift 菜单按钮 [需要图片]。

    3. 内容浏览器中查找 Amazon GameLift 插件资产。确保在您的查看选项设置中,已选中显示插件内容选项。