Install and setup SDK - Initial setup - (Unreal Engine module)

Last updated on February 4, 2026

注釈：本資料はAI技術を用いて翻訳されています。

はじめに​

AccelByte Multiplayer Servers (AMS) を統合するには、AccelByte Gaming Services (AGS) Game Software Development Kit (SDK) を使用する必要があります。SDK には AGS が提供する他のすべての機能も含まれていますが、このチュートリアルでは AMS をゲームサーバーに統合することのみに焦点を当てます。つまり、サーバービルドのみにこの SDK を含めるようにゲームを設定します。

AccelByte Game SDK は次のリポジトリに保存されています:

プロジェクトのセットアップ​

Byte Wars Unreal プロジェクトを AGS 実装の準備が整う前に、いくつかのセットアッププロセスを完了する必要があります。Byte Wars のチュートリアルとしてこれに従っている場合は、ブランチを変更して次のページにスキップすることをお勧めします。ただし、ゲームに SDK をセットアップする方法のガイドが必要な場合は、AGS SDK のクローンに進んでください。

オプション: tutorialmodules-ams ブランチでセットアップをスキップ​

すべてのセットアップが完了したブランチを用意しています。Byte Wars のチュートリアルとしてこれに従っている場合は、以下のコマンドでクローンした Byte Wars リポジトリを tutorialmodules-ams ブランチに切り替えて、サンプルマッチメイキングバックエンドサービスのクローンに直接スキップしてください。

git switch -f tutorialmodules-ams

独自のプロジェクトに AGS SDK をセットアップする方法を知りたい場合は、次のサブセクションに進んでください。

AGS Unreal Game SDK のクローン​

  1. Byte Wars プロジェクトフォルダに戻り、次のコマンドを使用して AGS Unreal SDK サブモジュールを追加します:

    git submodule add git@github.com:AccelByte/accelbyte-unreal-sdk-plugin.git Plugins/AccelByte/AccelByteUe4Sdk

  2. 次のコマンドを使用して AGS Unreal Game SDK サブモジュールをチェックアウトします:

    cd Plugins/AccelByte/AccelByteUe4Sdk

    git checkout 25.0.0

プラグインのセットアップを確認​

すべてのプラグインがサブモジュールとして正しくセットアップされていることを確認するには、%PROJECTPATH%/.gitmodules ファイルに以下の例のようにすべてのサブモジュールの設定が含まれていることを確認してください。

[submodule "Plugins/AccelByte/AccelByteUe4Sdk"]
    path = Plugins/AccelByte/AccelByteUe4Sdk
    url = git@github.com:AccelByte/accelbyte-unreal-sdk-plugin.git

プラグインを使用するようにプロジェクトを設定​

プラグインが Plugins/AccelByte に正しくクローンされたので、Byte Wars プロジェクトに AGS Game SDK プラグインを使用するように指示する必要があります。

  1. すべてのプラグインを AccelByteWars.uproject ファイルに追加します:

    "Plugins": [
        ...
        {
            "Name": "AccelByteUe4Sdk",
            "Enabled": true
        },
    ]

  2. プラグインを /Source/AccelByteWarsServer.Target.cs ファイルに追加します:

    ExtraModuleNames.AddRange( 
        new string[] 
        { 
            "AccelByteWars", 
            "AccelByteUe4Sdk"
        } 
    );
    備考

    モジュールは Server ターゲットファイルにのみ追加していることに注意してください。SDK はゲームサーバーにのみ必要です。

  3. /Source/AccelByteWars/AccelByteWars.Build.cs ファイルの PublicDependencyModuleNames にプラグインを登録します

    	PublicDependencyModuleNames.AddRange(new string[] 
    	{ 
    		//...
    	});

    	if (Target.Type == TargetType.Editor || Target.Type == TargetType.Server)
    	{
    		PublicDependencyModuleNames.Add("AccelByteUe4Sdk");
    	}
    備考

    現在のビルドターゲットがサーバーまたはエディターの場合にのみモジュールを追加していることに注意してください。

  4. Visual Studio プロジェクトファイルを再生成してコンパイルします。

  5. Unreal Editor を実行し、Edit > Plugins に移動して、プロジェクトで AGS Game SDK プラグインが有効になっていることを確認します。

に最終更新
On this page