Plastic SCM Integration

Use Plastic SCM version control software to enable teams to collaborate on Unity projetcs.

Learn how to set up Plastic SCM. Leanr how to set up version control in Unity.

Checking files out with Plastic SCM

Plastic SCM automatically checks files out if you have modified them. The only files that you must specificly check out to modify are Project Settings files.

Resolving conflicts and merging with Plastic SCM

When you edit something locally in your project which has also been edited remotely, a conflict occurs. If your project has conflicts, you must:

Review the changes
Merge the changes

If Unity recognises that you need to perform a merge before you submit changes then it prompts you to complete the merge. This takes you to the Plastic SCM client.

If incoming changes conflict with local changes then a question mark icon appears on the conflicting files in the Incoming changes window. Here is a quick guide to resolving conflicts and merging with Plastic SCM:

In the Version Control window select the Apply all incoming changes button. This automatically takes you to the Plastic SCM GUI client.
In the client window, click Explain merge for a more visual understanding of the changes. Select Process all merges and another window displays.
This window shows the individual conflicts, and you can choose what changes you want to keep or discard.
Once you have resolved the conflicts, select save and exit, and Plastic SCM will complete the merge operation.
Push the changes through Unity’s Version Control window.

Locking Files with Plastic SCM

To lock files with Plastic SCM, perform the following actions:

Create a lock.conf file and place it in your server directory. You can find your server directory in ../PlasticSCM/server.
In the lock.conf file, specify the repository you are working on and the server to complete the lock checks. Here is an example:

rep:default lockserver:localhost:8087
*.unity
*.unity.meta

En este caso todos los archivos .unity y.unity.meta van a ser bloqueados para checkout en un repositorio ‘default’.

Open the Unity Editor and check out a file that you expect to be locked, then go back to the terminal/command line and type: cm listlocks
The terminal/command line window displays a list of locked files. You can also test if this has worked by trying to check out the same file using a different user. An error will appear in Unity’s console saying the file is already checked out by another user.

For more information on locking, see Locking: avoiding merges for unmergeable files and Configuring exclusive checkout (Lock).

Differences from Perforce

PlasticSCM does not support remote activity, like Perforce does. As such, this functionality is unavailable for Plastic SCM in the Editor. Statuses such as: “Checked out Remote” or “Out of Sync” aren’t displayed in the Project window.