Game Overrides Config

Create Asset Control configurations

To create a Game Overrides configuration, right-click on Project Window and select Create > Services > Game Overrides Config.

Configuration Format

Configurations must conform to the JSON schema for it to parse properly.

Example

Below is a simple example.

{
  "$schema": "https://ugs-config-schemas.unity3d.com/v1/game-overrides.schema.json",
  "Overrides": {
    //Dictionary of game overrides, the key reprents the name
    "My first Game Override": {
      "Description": "Game Overrides description",
      "Audience": { "Targets": [ "Existing Players", "All Spenders"] },
      "Rollout": 100,
      "Condition": { "Value": "true" },
      "Variants": [
        {
          "RemoteConfig": { "Entries": {  "string_key": "Overriden Value" } }
        }
      ],
      "Scheduling": { "StartDate": "2025-01-16T11:37:45.5015862-05:00" }
    }
  }
}


The schema also supports reusing Content, Audience, or Condition by assigning it as part of the collections in the rest of the object.

e.g.:

{
  "Overrides": {
    "My first Game Override": {
      ...
      "Content": { "$ref": "ContentConfig_3" }
    }
  },
  "Content": [
    {
      "$id": "ContentConfig_3",
      "RemoteConfig": {
        "Entries": { "string_key": "Overriden Value" }
      }
    }
  ]
}


The weight of a Variant is not mandatory, unless multiple variants are declared. The distribution of the variants will follow the given weights and they should add up to 100.

 "Variants": [
  {
    "Weight": 30,
    "RemoteConfig": {
      "Entries": {
        "string_key": "Overriden Value for 30"
      }
    }
  },
  {
    "Weight": 70,
    "RemoteConfig": {
      "Entries": {
        "string_key": "Overriden Value for 70"
      }
    }
  }
]


Types

Currently, only Remote Config is supported for Game Overrides. If you need to disambiguate between numerical types, use the "Types" property, between LONG, INT and FLOAT, as you would in the .rc format.

File Deployment

After you create the configurations, you can deploy them to the environment. To deploy a file, go to Window > Deployment (2021.3-) or Services > Deployment (2022+).
The Deployment window opens and displays all of your local Game Overrides configurations and enables you to deploy them. For more information on the expected deployment window workflow, refer to "com.unity.services.deployment".