All content in this course uses:

Collaborate with Unity Version Control

The real power of Unity Version Control is the ability to collaborate on a Unity project while keeping your changes organized and your files backed up. In this tutorial, you’ll learn how to invite and work with collaborators through Unity Version Control.

A source control tool such as Unity Version Control is a must for Unity creators who work together on one project. Next, you’ll learn the basics of collaborating through Unity Version Control, and that is just the beginning! Unity Version Control is a robust source control application with many features. At the end of this tutorial, you’ll find resources for learning more.

Overview

It is necessary to complete the previous tutorials in this learning experience before continuing with this tutorial. You may also have completed the following tasks:

Download and install the Unity Version Control Cloud Edition client application.

Check in a simple Unity project into the repository.

Make a few additional changesets to the repository.

Before you begin

Follow these steps to invite a collaborator to become a member of your organization and give them access to your repositories there:

.  In the Unity Version Control window of the Unity Editor, locate the 

 (gear) button. Select it, and then select 

. A browser window will open to a page on 

. If prompted, sign in, preferably with your Unity ID. The 

.  Enter the email address of your collaborator. It will be simpler for them to join if you use the email address associated with their Unity ID, if they have one.

and your collaborator will receive an email invitation like the one below.

Invite a member to your organization

This step is optional, if you happen to have a friend or coworker with whom you’d like to share this repository and collaborate. It is not necessary to have a collaborator to complete this learning experience.

Your collaborator does not have to create an organization and a repository as you did in the previous tutorial — they only need to create a workspace by downloading the Unity project you’ve already created. 

: For best results, all collaborators should use the same Unity version.

Follow these steps, or have your collaborator follow them, upon receiving an email invitation to join the organization:

.  Make note of the name of the organization in the email, for example 

in the email. A browser window will open.

.  Run the installer and accept all the default settings to complete the installation.

.  Open the Unity Version Control application. If it doesn’t open to the home screen, navigate to 

: Unity Version Control offers both a legacy user interface and a new one. The images below represent the new user interface.

.  On the left, select the repository of the Unity project you want to collaborate on, if there is more than one.

, which will be the same as the name of the Unity project folder on your local disk. You may also select 

to change the location of the folder on your disk.

You have now downloaded a new Unity project, but since you did not create it in Unity, it is not listed in your Unity Hub.

. For best results, use the same Unity version as the project.

.  In the Unity Editor, make sure you are logged in, using your regular Unity ID.

.  With that project open in the Unity Editor, go to the main toolbar and select the 

 button, or go to the main menu and select 

: You might have to open a different scene to view the project.

You and your collaborator may both follow the rest of this tutorial.  

Join a project as a collaborator

 in the Unity Version Control client app provides a graphical view of all changesets, whether they were made by you or your collaborator(s). To view it, right-click the 

button on the Unity Version Control toolbar, and select 

. The Branch Explorer will come up in a new window.

: In the new Unity Version Control user interface, you might need to select your repository and the Branch Explorer option from the left menu.

Each node in the Branch Explorer diagram represents a changeset. Hover over each node for details. Right now, it is just a single row, but later in this tutorial, it will have branches.

For now, the interesting thing you can see in the Branch Explorer is the home icon, which indicates which changeset is currently downloaded to your workspace.

: Whenever you return to the Branch Explorer window, be sure to select the Refresh button to view any changes your collaborators make to the repository. 

Manage changesets on the Branch Explorer

As you and your collaborator(s) work together, you will each make changes to the project, and then you’ll want to download each other’s changes at certain intervals. You’ll be able to see their changesets listed on the Changesets tab in the Unity Version Control window of the Unity Editor and on the Branch Explorer.

When others check in changesets on the same branch you are working on (you’ll learn about branches next), the files they have changed will be listed on the Incoming Changes tab. The Unity Version Control window’s tab is updated with an icon to alert you that there are updates to the repository.

 button to accept the changes and advance your workspace to the most recent changeset.

Follow these steps for a demonstration of how to use the Incoming Changes tab:

.  If you have a real collaborator set up on your repository, have them check in a changeset. Then skip the next instruction. 

.  If you don’t have a collaborator, in the Branch Explorer, right-click on a previous changeset node (before the rightmost one), and select 

. The home icon will move to the changeset you selected. 

For the purposes of this demonstration, pretend you were working here all along and a collaborator checked in the newer changeset.

.  On the Incoming Changes tab in the Unity Editor, you’ll now see some files listed. These are the files that are newer in the repository than they are in your workspace. These are the files that your (real or imaginary) collaborator has changed.

 button to accept the changes and advance your workspace to the new changeset. 

.  Any time you update your workspace using Unity Version Control, you’ll see one or more prompts in the Unity Editor to accept the changes and reload your scene. Select the options that will allow all changes.

Your scene should update to display the change.

.  Return to the Branch Explorer and refresh it. Your home icon will move to the newer changeset because you have now downloaded those changes to your workspace.  

Now that you’ve used the first two tabs in the Unity Version Control window, here’s a review of what they show you and how to use them:

The Pending Changes tab lists changes in your workspace, on your current branch, that are not yet uploaded to your repository. It allows you to update the repository (check in a new changeset) to match your workspace.

The Incoming Changes tab lists changes that have been made to the repository, on your current branch, that are not yet downloaded to your workspace. It allows you to update your workspace to match the repository.

Get incoming changes from your collaborator

At any time, you may update your workspace to view any changeset using the 

 option. For example, if you had a blue chair in your scene and you replaced it with a green one, you can quickly switch back to the previous changeset to take another look at the blue chair, and switch back again.

Follow these steps to examine the Switch workspace to changeset feature:

.  Go to the Changesets tab, select any previous changeset, and right-click to select 

. You can also do this by right-clicking a changeset node in the Branch Explorer.

.  Next, open the Incoming Changes tab. This is a list of the changes in the more recent changeset(s). 

 button to accept all these changes and restore your workspace to the most recent changeset. 

You can use this feature to switch back to any changeset, even changesets in other branches. This technique is useful for viewing work at any point in the development of the project. 

Review a previous changeset

This learning experience is just enough to get your started with Plastic SCM. There are many more features to explore!

Plastic SCM in the Unity Editor provides a simplified workflow called Transparent SCM. 

Read more about the transparent workflow in the Plastic SCM documentation

The full Plastic SCM client application provides more advanced features for any of your source control needs. To learn more, 

read a primer on Plastic SCM workflows in the client app and command line interface

all of their documentation on the Plastic SCM website

Unity Version 2022.1