From Collaborate to Plastic SCM
Find out all you need to know about the move to Plastic SCM, Unity's version control system (VCS) built for game development
Watch the Unity Plastic SCM team offer hands-on support to help navigate the upgrade and answer questions. View Recording.
Migration of projects from Collaborate to Plastic SCM is now completed!
-
Why Plastic SCM?
Through optimized workflows for artists and programmers and superior speed with large files and binaries, Unity Plastic SCM is a version control and source code management tool built to improve team collaboration and scalability with any engine.
-
Cloud Build Projects
You will also need to update settings for any Unity Cloud Build projects that are using Collaborate for source control management, or have Integrations that rely on Collaborate. You can get more information on how to update your Cloud build setting here.
-
Unity versions that support the Plastic SCM package
The Plastic SCM package allows for in-editor version control and it's functionality will be more similar to Unity Collaborate. The Plastic SCM package is supported in the below Unity versions:
- 2019.4.32f1 or later
- 2020.3.20f1 or later
- 2021.1.25f1 or later
- 2021.2.0b16 or later
- 2022.1.0a12 or later
Other Unity versions will need to use the Plastic SCM Cloud Edition client, which can be downloaded here.
Accessing projects after the upgrade with Plastic SCM in Unity
-
Local workspace migration
If you are on a supported version of Plastic SCM for Unity, after opening your project in the Unity Hub, you will see a pop up prompting you to upgrade your Collaborate project to Plastic SCM. Completing this step will convert your local workspace to a Plastic SCM format automatically.
-
How to access remote projects
If you are on one of the supported versions of Plastic SCM for Unity, use the Unity Hub to access your project.
Getting Started with Plastic SCM in Unity
Orienting to Plastic SCM vs Collaborate
For supported Unity versions (see above), the Collaborate icon will be replaced by a Plastic SCM icon in the Unity Editor.
Use the Pending Changes tab to complete what is known as the Publish action in Collaborate. In Plastic SCM, this is called Checkin Changes.
Check the Changesets tab to view your project history. Any changes previously done in Collaborate will still be available via Plastic SCM. You can go back to previous revisions, even if they were done using Collaborate prior to the Plastic SCM upgrade.
The Plastic SCM icon turns yellow when new changes are available for your project.
Basics of Plastic SCM in Unity
The Pending Changes tab is where you will checkin changes you've made to the project to send to your repository.
The Changesets tab will show you the project history of changes made to the repository and who made each change. Clicking on each changeset listed will allow you to see which files were impacted by that changeset.
You can also view the history of each file by right-clicking and selecting "View file history" which will show you a list of changes made to the file. You have the option to right-click on an earlier version and select "Revert file to this revision."
Getting Started with the standalone Plastic SCM client
Whether you are using Unreal Engine, a version of Unity that doesn't support Plastic SCM for Unity, or another engine, you can still use Plastic SCM's full functionality by downloading the full client.
Install Plastic SCM Cloud Edition
Download and install Plastic SCM Cloud Edition.
Sign in with your Unity ID
Open the Plastic SCM client and log in using your Unity ID.
Select your cloud organization
Select your Plastic SCM cloud organization to start working on it.
Select the workflow that fits your needs
Choose between Gluon mode (a workflow tailored for artists) or the Developer mode.
Create a workspace
If your Unity project files are already on your machine, select the path on disk that corresponds to the root of your Unity project. If not, select any location in which you want to create your workspace.
Start working with your workspace
If you choose Gluon, configure your workspace to load the Unity project files you want to work with.
If you choose Plastic, update your workspace to ensure your project is up to date with all the incoming changes.
If you are using Unity, open your Unity project through the Hub.
Check in your changes
Use Plastic or Gluon, to check in your changes (for example, adding a scene) after saving them to the project in your editor. This is the way to send the changes to the repository. Every time you check in, a changeset is created.
View file history
The changesets show you the project history of changes. If you double-click a changeset, you'll see which files were impacted by that changeset.
You can also view the history of each file by right-clicking it and selecting "View file history". You have the option to right-click on an earlier version and revert to this revision.
Long-term support and roadmap
Unity is committed to crafting DevOps and version control solutions for an inclusive collaborative environment that accommodates all team members, regardless of their role and technical expertise.
To get a better idea of what's been released, what's in progress, and what's on the horizon, take a look at our product roadmap page.