UGS package version guide
Keep your UGS packages up-to-date with recommended minimum versions for each service.
Read time 5 minutesLast updated 6 months ago
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.
|
|
|
|---|---|---|
Analytics | com.unity.services.analytics | 4.0.1 |
Authentication | com.unity.services.authentication | 2.0.0 |
Cloud Code | com.unity.services.cloudcode | 2.0.0 |
Cloud Save | com.unity.services.cloudsave | 2.0.0 |
Economy | com.unity.services.economy | 2.0.2 |
Lobby | com.unity.services.lobby | 1.0.1 |
Relay | com.unity.services.relay | 1.0.2 |
Remote Config | com.unity.remote-config | 3.0.0 |
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:
|
|
|---|---|
2019.4 (LTS) | 2019.4.40f1 or higher Note For Unity 2019, only the Analytics and Authentication have Verified releases. Other UGS services have not been tested against this version. |
2020.3 (LTS) | 2020.3.36f1 or higher Note All UGS packages are Verified for this version. |
2021.3 (LTS) | 2021.3.5f1 or higher |
2022.1 (Tech Stream) | 2022.1.4f1 or higher |
2022.2 (Tech Stream) | 2022.2.0a17 or higher |
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:
- In the Unity Editor, open Window > Package Manager.
- In the Package Manager, select the Unity Registry list view.
- Search for the package name, or locate it in the registry list.
- 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:
|
|
|---|---|
com.unity.services.analytics | 4.0.1 |
com.unity.remote-config | 3.0.0 |