Getting Started with Unity Version Control Using Plastic SCM
Managing a Unity Organization
A Unity organization acts as the container for your projects and collaborators. To create one, open the account settings from Unity Hub and navigate to the Organizations tab. Choose to add a new organization or select an existing one. When setting up a new organization, you need to provide a name and select an industry category.
Once the organization exists, you can control team access. Open your organization, go to Members & Groups, and select Add Member. The number of available seats depends on your subscription tier. Adding members by email is the recommended approach; after sending the invitation, each recipient will receive an email notification to confirm.
Setting Up a Plastic SCM Project
Older Editor Workflow (2019)
During new project creation, enable the Plastic SCM toggle and assign the project to your organization. After the project loads, go to the Plastic SCM menu in the top-left corner to open the dedicated window. Initialize the scene for collaboration, make your first check-in, and a success confirmation will appear.
To review change history, switch to the Changesets view by clicking the branch inspector. All branches are listed there. Double-click any changeset to see a detailed diff of the modifications.
Current Editor Approach (2022+)
In Unity 2022 and later, the panel is accessible from Window > Unity Version Control. The workflow for updating a scene is straightforward: after modifying a scene, any asset with pending changes displays a purple indicator on its icon. In the Inspector, the Check in button becomes available. Click it, write a meaningful description, and the content is pushed to the Plastic SCM server.
Core Plastic SCM Operations
Understanding the Main View
The primary interface is divided into three sections:
- Pending changes: Your local modifications that need to be committed.
- Incoming changes: Changes submitted by other collaborators.
- Changesets: The complete history of the project.
When an incoming change block is present, update your workspace first. Selecting a branch from the changesets view reveals all related check-ins.
Working with Branches
To spawn a new branch, right-click on a specific changeset node. Provide a descriptive name and a comment explaining the branch’s purpose. The new branch appears, letting you work in isolation. Any mistake made on the branch is recoverable because you can revert to an earlier version. Use the diff tool to inspect differences, and view all branch-specific modifications when needed.
Branch Coloring
Apply distinct colors to branches belonging to different team members to visually separate ownership with in the history graph.
Launching the External Client and Configuration
Two critical commands within the Unity editor are Launch Plastic SCM (opens the full standalone client) and Options, which govern Plastic SCM’s behavior inside Unity.
Managing Repositories
Repositories are created or deleted from the Plastic SCM panel. A deleted repository can be restored if necessary.
Chenging the Plastic SCM UI Language
-
Using the Windows search box, locate the Plastic SCM executable and open its file location.
-
Navigate to the directory containing the Plastic SCM executable.
-
Search for the
client.confconfiguration file in the same folder. -
Open
client.confwith Notepad or another text editor. -
Modify the language parameter. Examples:
zh-Hansfor Simplified Chinesezh-Hantfor Traditional Chineseenfor Englishjafor Japanesekofor Korean
If saving is blocked, temporarily move the file to your desktop, edit it, and move it back.
-
Relaunch Plastic SCM to see the updated interface. A system restart may be needed if changes are not immediately reflected.