UGS package version guide#

In order to take advantage of the newest UGS features and updates, Unity recommends upgrading all projects using beta versions of UGS services to the latest released version.

Package versions to use#

Compare your project’s installed package versions with the following minimum recommended versions for each service. Any packages with a lower version number than the minimum versions listed below are not recommended and should be updated.

Install recommended service packages in your project#

The services listed above are compatible with any Unity Editor version 2020.3 or higher. However, depending on your specific Editor version, the service's packages may not be available to install from the Package Manager window. The following table shows which Editor releases to use in order to ensure that each service is fully compatible:

Note: If you do not see supported versions of Analytics and Remote Config packages in the Package Manager* *window for Editor versions 2021.3, 2022.1, or 2022.2, please see the below upgrade scenario.

Upgrade scenarios#

My Editor version supports UGS release packages#

In this scenario, you can download and install all packages from the Unity Editor’s Package Manager registry. To download and install packages using the Package Manager:

1. In the Unity Editor, open Window > Package Manager.
2. In the Package Manager, select the Unity Registry list view.
3. Search for the package name, or locate it in the registry list.
4. Select the package, then click Install.

You can also type “services” in the search bar, which returns results for all the services except Remote Config.

In Editor versions 2022.1 or higher, you’ll find all services in the Package Manager’s Services tab.

My Editor version does not support UGS release packages#

For Editor versions 2020.3 or higher, the easiest way to install packages in the project is to include them directly in the project manifest with the following code:

{
    "dependencies": {
        "com.unity.services.analytics": "4.0.1",
        "com.unity.services.authentication": "2.0.0",
        "com.unity.services.cloudcode": "2.0.0",
        "com.unity.services.cloudsave": "2.0.0",
        "com.unity.services.economy": "2.0.2",
        "com.unity.services.lobby": "1.0.1",
        "com.unity.services.relay": "1.0.2",
        "com.unity.remote-config": "3.0.0"
    }
}

Note: Analytics and Authentication are the only services that are compatible with Editor version 2019.4. Other UGS services have not been verified for this specific version.

I want to upgrade Analytics and Remote Config but can't see them in the Package Manager#

You can add the following code to the package manifest:

"com.unity.services.analytics": "4.0.1",
        "com.unity.remote-config": "3.0.0"

Or, you can manually install the packages by name using the following versions: