​

如何以處理序模式使用 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 設定為與遊戲伺服器中定義的相同值。您可以在執行階段檢查 GSDK 設定中索引鍵 GamePort.Name 的值。如果您使用的是 Wrapper 範例，連接埠名稱已定義為 “game_port”，因此您應在此處設定相同的值。
  • GamePort.Protocol - 指定通訊協定類型：TCP 或 UDP
• OutputFolder - 產生輸出和設定檔之磁碟機或資料夾的路徑。由於遊戲伺服器將解壓縮至此路徑下，請確定有足夠的可用空間。如果未指定，則會使用代理程式資料夾。
• AgentListeningPort - 這是 LMA 與遊戲伺服器通訊的連接埠。任何開放的連接埠都可以使用，預設值為 56001。如果您有其他處理序繫結至 56001，則必須變更此值或終止連接埠 56001 上的其他處理序。
• ResourceLimits - 處理序模式不需要。
• MountPath - 處理序模式不需要。
• SessionCookie (選用) - 作為 RequestMultiplayerServer API 呼叫的一部分傳遞給遊戲伺服器的任何工作階段 Cookie。在 MPS 上的實際案例中，建立連線後，伺服器會通知用戶端從 SessionCookie 載入對應的資源。

​

執行 LocalMultiplayerAgent

• 在 PowerShell 視窗中：
  瀏覽至 LMA 下包含 LocalMultiplayerAgent.exe 的目錄。
• 執行 LocalMultiplayerAgent.exe。 此時，LMA 會設定 http 接聽程式、解壓縮遊戲資產，並在個別的處理序中啟動遊戲伺服器。

  如果您以處理序的形式執行遊戲伺服器，Windows 防火牆可能會跳出視窗，詢問您是否要允許流向您所指定之 NodePort 的流量。如果您想避免這種情況，可以以系統管理員模式執行 LocalMultiplayerAgent，或在防火牆中啟用該連接埠。

1. CurrentGameState - Initializing
   (如果您的遊戲伺服器直接呼叫 GSDK::ReadyForPlayers 而未呼叫 GSDK::Start，則可能不會顯示此項)
2. CurrentGameState - StandingBy
3. CurrentGameState - Active
4. CurrentGameState - Terminating

​

測試與遊戲的連線