Amazon GameLift · JSON Structure

Gamelift Runtime Configuration Structure

A collection of server process configurations that describe the set of processes to run on each instance in a fleet. Server processes run either an executable in a custom game build or a Realtime Servers script. Amazon GameLift launches the configured processes, manages their life cycle, and replaces them as needed. Each instance checks regularly for an updated runtime configuration.

A Amazon GameLift instance is limited to 50 processes running concurrently. To calculate the total number of processes in a runtime configuration, add the values of the ConcurrentExecutions parameter for each server process. Learn more about Running Multiple Processes on a Fleet.

Type: object Properties: 3
Cloud ComputingGame ServersGamingMultiplayerMatchmakingFlexMatchFleetIQ

RuntimeConfiguration is a JSON Structure definition published by Amazon GameLift, describing 3 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

ServerProcesses MaxConcurrentGameSessionActivations GameSessionActivationTimeoutSeconds

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-gamelift/refs/heads/main/json-structure/gamelift-runtime-configuration-structure.json",
  "name": "RuntimeConfiguration",
  "description": "<p>A collection of server process configurations that describe the set of processes to run on each instance in a fleet. Server processes run either an executable in a custom game build or a Realtime Servers script. Amazon GameLift launches the configured processes, manages their life cycle, and replaces them as needed. Each instance checks regularly for an updated runtime configuration. </p> <p>A Amazon GameLift instance is limited to 50 processes running concurrently. To calculate the total number of processes in a runtime configuration, add the values of the <code>ConcurrentExecutions</code> parameter for each server process. Learn more about <a href=\"https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-multiprocess.html\"> Running Multiple Processes on a Fleet</a>.</p>",
  "type": "object",
  "properties": {
    "ServerProcesses": {
      "allOf": [
        {
          "$ref": "#/components/schemas/ServerProcessList"
        },
        {
          "description": "A collection of server process configurations that identify what server processes to run on each instance in a fleet."
        }
      ]
    },
    "MaxConcurrentGameSessionActivations": {
      "allOf": [
        {
          "$ref": "#/components/schemas/MaxConcurrentGameSessionActivations"
        },
        {
          "description": "The number of game sessions in status <code>ACTIVATING</code> to allow on an instance. This setting limits the instance resources that can be used for new game activations at any one time."
        }
      ]
    },
    "GameSessionActivationTimeoutSeconds": {
      "allOf": [
        {
          "$ref": "#/components/schemas/GameSessionActivationTimeoutSeconds"
        },
        {
          "description": "The maximum amount of time (in seconds) allowed to launch a new game session and have it report ready to host players. During this time, the game session is in status <code>ACTIVATING</code>. If the game session does not become active before the timeout, it is ended and the game session status is changed to <code>TERMINATED</code>."
        }
      ]
    }
  }
}