Upgrade 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.

Gallery

Migration of projects from Collaborate to Plastic SCM is now underway!

  • 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.

  • Timeline and Action Required

    Upgrades from Collaborate to Unity Plastic SCM are ongoing and will continue through the month of April. You will get an email 2 business days before we upgrade your organization to Plastic SCM. You can extract your data from Collaborate projects from the Unity Dashboard. You have until May 31st, 2022 to extract your data before it is permanently deleted. Your unarchived Collaborate projects are being automatically upgraded to Plastic SCM. We are not migrating archived projects to Plastic SCM. If you want to keep a copy of your archived projects and their history, make sure to go to the Unity Dashboard , select the project you want to export and access DevOps > Collaborate > Storage to start the export.

  • 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.

Read more detail here.

The Collaborate icon is a Plastic SCM icon in the Unity Editor

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."

Revert file to this revision option

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

Install Plastic SCM Cloud Edition

Download and install Plastic SCM Cloud Edition.

Sign in with your Unity ID

Sign in with your Unity ID

Open the Plastic SCM client and log in using your Unity ID.

Select your cloud organization

Select your cloud organization

Select your Plastic SCM cloud organization to start working on it.

Select the workflow that fits your needs

Select the workflow that fits your needs

Choose between Gluon mode (a workflow tailored for artists) or the Developer mode.

Create a workspace

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

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

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

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.

FAQ: Collaborate Upgrade to Plastic SCM

Click here...

The Collaborate upgrade to Plastic SCM will be done gradually in cohorts over the coming months, starting with users with projects on Editor versions which are already supported by Plastic SCM. You can use any of the latest available versions of the Unity Editor, as they already support Plastic SCM.

Specifically, you need to upgrade your projects to any of the versions below in order to use Plastic SCM for Unity:

  • 2019.4.32f1 or later 2019.4 versions
  • 2020.3.20f1 or later 2020.3 versions
  • 2021.1.25f1 or later 2021.1 versions
  • 2021.2.0b16 or later 2021.2 versions
  • 2022.1.0a12 or later 2022.1 versions

After the upgrade, local Collaborate projects on supported versions will be converted into Plastic SCM workspaces, so that you can resume creating with minimal interruption.

If you do not want to wait for the automated migration to reach your cohort and wish to migrate immediately, you can do so using our Collaborate migration tool.

No, you will not pay anything extra to get started with Plastic SCM.

Once upgraded, Unity Teams Basic Users will receive three (3) seats of Plastic and 5 GB of storage.

Unity Teams Advanced Users will receive three (3) seats of Plastic and 25 GB of complimentary storage. You will not pay more after the upgrade than you did before the upgrade for the same amount of usage.

Plastic SCM provides robust collaboration and source control capabilities that empower all members of your team to work safely, responsively, and securely at scale.

Unlike Collaborate, Plastic SCM provides branching and merging, as well as locking capabilities that empower multiple team members to work on the same code without fear of unresolvable conflicts or lost work.

Additionally, as projects grow, so do file sizes, and Plastic SCM is purpose-built to remain responsive, even when working with massive files. No more wasted hours waiting for projects to load!

In 2022, Unity Teams and Collaborate will be going away. We are still working out exact timelines, but will be in constant communication with you between now and that date.

Plastic SCM will be our fully-featured Version Control offering moving forward, which is why we're upgrading you as soon as possible. As part of this upgrade, we will be migrating your unarchived Collaborate projects over to Plastic.

You will have until February 28, 2022 to extract your data from archived Collaborate projects. On this date, all archived projects will be deleted permanently. All unarchived projects will automatically be upgraded to Plastic SCM.

We will also be launching a standalone version of Cloud Build in 2022, with new pay-as-you-go pricing, to ensure you can still use Cloud Build once Teams Advanced goes away.