Getting started

Unity Plastic SCM

Collaborate and work better together using Unity Plastic SCM for version control and source code management.

Система управления версиями для игр

Plastic SCM source control

Unity Plastic SCM is a version control and source code management tool built to improve team collaboration and scalability with any engine. It offers optimized workflows for artists and programmers and superior speed working with large files and binaries.

Setup guide

Learn how to use Unity Plastic SCM in your project.

Using Plastic SCM with Unity

This guide covers how to set up Plastic SCM in Unity with any of the following Editor 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
Подключение Plastic SCM к Unity

1. Connect Plastic SCM to Unity

To begin, you will need to connect your Unity ID to Plastic SCM and select or create an organization.

First, open Plastic SCM in Unity by clicking the Plastic SCM icon in the toolbar on the top right. You will see the Plastic SCM window prompting you to complete your setup. 

Click log in or sign up, and Plastic SCM will connect automatically to your Unity ID. Next, if your Unity ID isn’t already associated with an organization, you will be prompted to create one. If you already belong to an organization, you will be able to select one to join from a dropdown menu.  

Создание рабочей области

2. Create a workspace optimized for your workflow

Next, return to the Plastic SCM window and click Create workspace. 

Plastic SCM will suggest names for your repository (shared files and history) and workspace (your local copy). If you wish to use an existing Plastic SCM repository, click the three dots (:) next to the repo name, and select a repository from the list.

Next, select the type of workspace you prefer. Plastic SCM is a version control system optimized for game development and 3D projects, and as such, it supports separate workflows within the same repo. We designed the Plastic workspace for programmers and the Gluon workspace for artists.

Добавление файлов ассетов, связанных с проектом

3. Add asset files associated with your project

Next, Plastic SCM will display the project files from the asset folder in the Pending changes tab. You can choose specific files to include or add all to the repository by selecting the files and clicking Checkin changes

Plastic SCM will automatically perform a check in for appropriate folders and files – such as package files and project settings – when it’s set up from the Unity Editor. You can view these in the Changesets tab.

Once your initial asset check in is complete, you’re set up with Plastic SCM for Unity and ready to create.

Типы файлов, игнорируемые по умолчанию

4. File types set to ignore by default

Additionally, there is a list that’s saved in the ignore.conf file at the root of the project, and this describes which files should be ignored by default. You can edit this to either add or exclude files from the ignore list. 

Как приглашать участников команды в Plastic SCM

5. How to invite team members to Plastic SCM

To invite team members working on your project, click on the Options menu (gear icon) in the Plastic SCM tab in Unity, then select Invite Members to Workspace. 

You will be brought to the Plastic SCM cloud dashboard. Here, you can add new users, resend invitations, or set permissions. 

Note: You may be prompted to log in with your Unity ID if you are not signed into the Plastic SCM cloud dashboard.

Основная информация о регистрации изменений и истории файла

6. The basics of checking in changes and file history

The Pending changes tab is where you will Check in the changes you’ve saved to the project to send to your repository.

The Changesets tab shows you the project history of changes made to the repository and who made each change. Clicking on each changeset listed allows 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 shows 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.

Plastic SCM everywhere else

Whether you are using Unreal Engine, an unsupported Unity version, or another engine, you can still use Plastic SCM’s full functionality by downloading the full client.

1. Download, log in, and set up Plastic SCM

First, start by downloading Plastic SCM from the Plastic SCM website and following the instructions from the installation wizard. 

Once complete, you will be asked to sign in or sign up for an account. Even if you will not be using Unity as the engine for your project, we recommend using a Unity ID.

Next, if your account is not already associated with an organization, you will be prompted to create one. If you already belong to an organization, you can select one to join from a dropdown menu.  

2. Select a workflow optimized for you

Next, you will be prompted to launch with the type of workflow you prefer. Plastic SCM is a version control system that’s optimized for game development and 3D projects. In order to minimize conflicts between artists and programmers as they collaborate, Plastic provides separate GUIs to facilitate two different workflows within the same repo.

We designed Plastic for developers for programmers and the Gluon workspace for artists.

Создание репозитория с помощью клиента Plastic SCM

3. Select or create a repository and workspace

Next, you’ll be asked whether you want to work centralized or distributed (developers only). Then, choose an existing repo or create a new one. Plastic SCM suggests names for your repository (shared files and history) and workspace (your local copy).

To change the name of the new repo, click New, name the repository, and select the server. If you wish to select an existing Plastic SCM repository, click the dropdown menu or click the three dots (⋮) next to the repo name and select from the list.

For the on-disk path, make sure to select the directory that currently contains the files for your project.

Настройки проекта в клиенте Plastic

4. Add packages and project settings files

The Plastic SCM client will now open your project.

If you are directed to an existing project in the previous step, you will need to navigate to the Pending changes tab (if using the developer interface, as shown above), select all packages and Project Settings files and folders, then click Checkin to commit them.

Note: this tab will be called Checkin changes if you’re using Gluon.

Добавление файлов ассетов и подготовка к работе

5. Add asset files and get ready to start

Next, select the asset folders and files you need to add to the repository to begin working, and click Checkin again. 

If these are set to private, you can navigate back to Workspace Explorer (called Explore workspace in Gluon), find the files, right-click on them, and select Add to source control, then complete the checkin in the Pending changes tab.

You are now set up with Unity Plastic SCM and ready to create.

6. File types set to ignore by default

Additionally, there is a list that’s saved in the ‘ignore.conf’ file at the root of the project that describes which files are ignored by default. You can edit this to either add or exclude files on the ignore list.

Внесение изменений

7. Pushing changes using a separate client

When using the standalone Plastic SCM client outside of the engine, you’ll need to Checkin changes you saved to the project using the client in a separate window.  

The Pending changes tab (or Checkin changes in Gluon) is where you will check in changes you’ve made to the project to send to your repository.

Просмотр истории файлов и восстановление версий

8. View file history and reverting files in client

The Changesets tab shows you the project history of changes made to the repository and who made each change. Double-clicking on changeset listed allows 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 shows you a list of the changes made to the file. You can also right-click on an earlier version and select Revert to this revision.

Подключение Plastic SCM к Unreal Engine

9. Connecting Plastic SCM to Unreal Engine

If you’re using Plastic SCM with Unreal Engine, you can use source control inside the editor without maintaining separate windows for most tasks. You can find more information on the Unreal Engine plug-in at the link below.

Explore more

More resources

Explore best practices and more-advanced tricks for version control.

Your hidden productivity costs

We’ve collected insights from our product and engineering teams on three of the most common version control pitfalls holding studios back from doing what they do best: creating.

KO_OP accelerates production and reduces chaos

How does a worker-owned cooperative studio get both artists and engineers aligned on a production process? Read how KO_OP powered collaboration with Plastic SCM.

Project organization and VCS best practices

Learn the key concepts of version control as well as tips and tricks you can use when setting up your Unity project to help ensure team collaboration is smooth and efficient.

Did you find this content helpful?

Мы используем cookie-файлы, чтобы вам было удобнее работать с нашим веб-сайтом. Подробнее об этом можно узнать на странице, посвященной политике использования cookie-файлов.

Согласен