​

LocalMultiplayerAgent を使用してプロセスモードでゲーム サーバーを実行する方法

• Wrapper サンプルを使用したビルドの作成
• MultiplayerSettings.json の構成
• LocalMultiplayerAgent の実行
• ゲーム接続のテスト

​

ゲームビルドの作成

​

MultiplayerSettings.json の構成

{
  "RunContainer": false, // Set RunContainer to false if you are running LMA in Process mode.
  "OutputFolder": "C:\\output\\WindowProcess", // Path where config files and logs will be generated from LMA at each run
  "NumHeartBeatsForActivateResponse": 10, // default value
  "NumHeartBeatsForTerminateResponse": 60, // default value
  //the server will run in stand-by mode for 10 heartbeats and stay in active state for 35 heartbeats.
  "TitleId": "59F84", // default value
  "BuildId": "8624d52e-87a1-4a12-b7f6-b92720ef8919", // default value
  "Region": "EastUs", // default value
  "AgentListeningPort": 56001, // default value
  "AssetDetails": [
    {
      "MountPath": "",  // Mount Path is only required for Container mode. leave it as blank.
      "SasTokens": null,
      "LocalFilePath": "D:\\gameassets.zip" // where your game server is located as an archive format.
    }
  ],
  "ProcessStartParameters": {
    "StartGameCommand": "wrapper.exe -g fakegame.exe arg1 arg2" 
    // shell command to run Wrapper. Command will be executed where game asset is extracted.
    // Make sure the StartGameCommand provided above is an example of the Wrapper sample. 
  },
  "PortMappingsList": [
    [
      {
        "NodePort": 56100, // default value
        "GamePort": {
          "Name": "game_port",
           // Port name is already defined in the Wrapper sample. Wrapper will grab the port information using game_port via GSDK while it's running.
          "Protocol": "TCP"
        }
      }
    ]
  ],
}

• LocalFilePath - 先ほど作成したゲーム サーバーのアセット zip ファイルへのフル ローカル パス（ワークステーション上）。例: D:\MyAmazingGame\asset.zip（JSON フォーマットではバックスラッシュをエスケープする必要があることに注意してください）。
• StartGameCommand - プロセスの StartGameCommand パスは相対パスです。作業ディレクトリはゲームアセットが解凍される場所となります。
• PortMappingsList - 実行中のゲームで使用可能なポートです。
  • NodePort はワークステーション上で開かれるポートです。
  • GamePort.Number はプロセスモードでは必要ありません。ゲーム サーバーの実行中に、GSDK 経由でポート番号が Node Port にバインドされます。実際のシナリオでは、MPS が各プロセスベースのゲームセッションごとに動的にポートをバインドします。
  • GamePort.Name はゲーム サーバーで定義したものと同じ値に設定してください。実行時に、キー GamePort.Name で GSDK 構成の値を確認できます。Wrapper サンプルを使用している場合、ポート名は既に “game_port” として定義されているので、ここでも同じ値を設定する必要があります。
  • GamePort.Protocol - プロトコル タイプを指定します: TCP または UDP
• OutputFolder - 出力と構成ファイルが生成されるドライブまたはフォルダーへのパス。ゲーム サーバーがこのパスの下に解凍されるため、十分な空き容量があることを確認してください。指定しない場合、agent フォルダーが使用されます。
• AgentListeningPort - これは LMA がゲーム サーバーと通信するためのポートです。空いているポートであれば何でも使えますが、デフォルト値は 56001 です。他のプロセスが 56001 にバインドされている場合は、この値を変更するか、ポート 56001 上の他のプロセスを終了する必要があります。
• ResourceLimits - プロセスモードでは必要ありません。
• MountPath - プロセスモードでは必要ありません。
• SessionCookie (オプション) - RequestMultiplayerServer API 呼び出しの一部としてゲーム サーバーに渡されるセッション Cookie。MPS の実際のシナリオでは、接続が確立された後、サーバーはクライアントに SessionCookie から対応するリソースを読み込むよう通知します。

​

LocalMultiplayerAgent の実行

• PowerShell ウィンドウで: LocalMultiplayerAgent.exe を含む LMA 配下のディレクトリに移動します。
• LocalMultiplayerAgent.exe を実行します。 この時点で、LMA は http リスナーをセットアップし、ゲームアセットを解凍し、別プロセスとしてゲーム サーバーを起動します。

  プロセスとしてゲーム サーバーを実行している場合、指定した NodePort へのトラフィックを許可するかどうかを尋ねる Windows Firewall のポップアップが表示される場合があります。これを避けたい場合、LocalMultiplayerAgent を管理者モードで実行するか、ファイアウォールでポートを有効にすることができます。

1. CurrentGameState - Initializing （ゲーム サーバーが GSDK::ReadyForPlayers を直接呼び出し、GSDK::Start を呼び出さない場合、これは表示されないことがあります）
2. CurrentGameState - StandingBy
3. CurrentGameState - Active
4. CurrentGameState - Terminating

​

ゲームへの接続テスト