Unreal 的外掛程式：安裝和設定外掛程式元件

本節說明將外掛程式新增至 Unreal Engine 專案的初始安裝任務。當您在 Unreal 編輯器中開啟專案時，即可使用外掛程式功能。

注意

您可以使用 Amazon GameLift 外掛程式搭配標準版本的 UE 編輯器，但在封裝遊戲伺服器建置時，需要使用來源建置版本。

開始之前

以下是使用 Unreal Engine 的 Amazon GameLift 外掛程式所需的內容：

• Unreal Engine 發行套件的 Amazon GameLift 外掛程式。【下載網站】。

• Microsoft Visual Studio 2019 或更新版本。

• Unreal Engine 編輯器的來源建置版本。您需要來源建置的版本來封裝多人遊戲的伺服器元件。如需更多詳細資訊，包括其他先決條件，請參閱 Unreal Engine 文件：

  • 在您需要 GitHub和 Epic Games 帳戶上存取 Unreal Engine 原始碼 GitHub 。

  • 從來源教學課程建置 Unreal Engine。

• 具有 C++ 遊戲程式碼的多人遊戲專案。如果您使用的是藍圖專案，請參閱 Unreal 文件，了解如何為您的專案產生 C++ 原始程式碼。

建置 Amazon GameLift C++ 伺服器 SDK

Unreal Engine 發行套件的 Amazon GameLift 外掛程式包含 SDK Unreal 的 C++ 伺服器的原始程式碼。您必須先擷取原始程式碼，並針對開發環境建置原始程式碼，才能搭配外掛程式使用。

注意

如果您要建置遊戲伺服器以在 Amazon Linux 2023 執行期環境中執行，您可以利用 Amazon GameLift Toolkit 儲存庫中提供的協助程式指令碼。使用此協助程式指令碼來產生SDK二進位檔和您需要與外掛程式搭配使用的SSL程式庫。當您在 Windows 或 Linux 上使用 Unreal Engine 5 進行開發時，可以使用指令碼。指令碼是 Docker 型解決方案。您可以在本機執行它，並安裝 git 和 docker，或可在 AWS CloudShell 中使用 執行指令碼 AWS Management Console。

進一步了解 Unreal Engine 5 的 Amazon GameLift 建置指令碼。

手動建置 Unreal SDK 的 C++ 伺服器

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 Editor，請完成下列任務。

將外掛程式新增至專案

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. 在 Content Browser 中尋找 Amazon GameLift 外掛程式資產。請確定您的檢視選項設定已選取顯示外掛程式內容選項。