Unreal 用プラグイン: プラグインコンポーネントをインストールして設定します

このセクションでは、Unreal Engine プロジェクトにプラグインを追加する初期インストールタスクについて説明します。プラグイン機能は、Unreal Editor でプロジェクトを開いている場合に使用できます。

注記

Amazon GameLift プラグインは UE エディタの標準バージョンで使用できますが、ゲームサーバービルドをパッケージ化する場合はソースビルドバージョンを使用する必要があります。

開始する前に

Unreal Engine 用 Amazon GameLift プラグインを使用するために必要なものは次のとおりです。

• Unreal Engine リリースパッケージ用 Amazon GameLift プラグイン Unreal バージョンのサポートについては、各パッケージの readme を確認してください。[ダウンロードサイト]。

• Microsoft Visual Studio 2019 以降。

• Unreal Engine エディタのソースビルドバージョン。マルチプレイヤーゲームのサーバーコンポーネントをパッケージ化するには、ソースビルドバージョンが必要です。その他の前提条件を含む詳細については、Unreal Engine のドキュメントを参照してください。

  • GitHub で Unreal Engine のソースコードにアクセス GitHub と Epic Games アカウントが必要です。

  • 「ソースからの Unreal Engine の構築」チュートリアル。

• C++ ゲームコードを使ったマルチプレイヤーゲームプロジェクト。ブループリントプロジェクトで作業している場合は、プロジェクトの C++ ソースコードを生成する方法に関する Unreal のドキュメントを参照してください。

Amazon GameLift C++ サーバー SDK を構築する

Unreal Engine 用 Amazon GameLift プラグインのリリースパッケージには、C++ サーバー SDK for Unreal のソースコードが含まれています。プラグインで使用する前に、ソースコードを抽出し、開発環境で構築する必要があります。

注記

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 ビルドスクリプについて説明します。

C++ サーバー SDK for Unreal ライブラリを手動でビルドする

1. Unreal Engine 用 Amazon GameLift プラグインのリリースパッケージを解凍し、2 つの 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 プラグインアセットを探します。[表示オプション] 設定で [プラグインコンテンツを表示] オプションが選択されていることを確認します。