Sites

Menu

Launch configuration file

This file contains the configuration parameters for starting a deployment. You can specify it in the [launch_configuration] field of a project configuration or pass it to spatial alpha local launch or spatial alpha cloud launch via the --launch_config flag.

File structure and fields

The launch configuration file has no naming conventions, but it should have the following structure:

{
  "template": "...",
  "dimensionsInWorldUnits": {
    "x": 100,
    "z": 100
  },
  "loadBalancing": {
    "layerConfigurations": [
      {
        "layer": "...",
        "hexGrid": {
          "numWorkers": ...
        }
      }
    ]
  },
  "snapshot": {
    "takeSnapshotIntervalSeconds": "600"
  },
  "streamingQueryInterval": 4,
  "runtimeFlags": [
    {
      "name": "...",
      "value": "..."
    }
  ],
  "workerFlags": [
    {
      "workerType": "...",
      "flags": [
        {
          "name": "...",
          "value": "..."
        }
      ]
    }
  ]
}

The following table shows the fields that you are required or optional to specify in the launch configuration file:

Field Required/Optional Description
template Required Defines the compute resources your deployment needs (its ‘topology’). See game templates for more details.
dimensionsInWorldUnits Required Describes how big the world should be. “x” and “z” parameters must both be greater than 0.
loadBalancing Optional The new load balancing configuration as documented in load balancing with layers.
snapshot Optional Defines snapshot related settings. It contains one optional field:
- takeSnapshotIntervalSeconds: The frequency in seconds to automatically write snapshots of your simulated world. The minimum duration is 600 seconds (10 minutes). Set to 0 to disable automatic snapshots. The default value is 0.
streamingQueryInterval Optional Period in seconds between successive streaming query updates. The default value is 4 seconds.
runtimeFlags Optional The Runtime flags that can control advanced Runtime features. Equivalent to legacy flags.
workerFlags Optional Specifies global configuration parameters per worker type. See worker flags for more information.

Search results

Was this page helpful?

Thanks for letting us know!

Thanks for your feedback

Need more help? Ask on the forums