You can use Unity in conjunction with most common version control tools, including Perforce and Unity Version Control.
To access the Version Control settings, go to Edit > Project Settings then select the Version Control category.
Property | Description | |
---|---|---|
Mode | Select the version control mode. | |
Hidden meta files | Hide the .meta files in your operating system’s file explorer. Unity does not show .meta files in the Project view, no matter which mode you choose. | |
Visible meta files | Select this option to work with a version control system that Unity doesn’t support. This is the default setting. You can then manage the source Assets and metadata for those Assets with a version control system of your choice. | |
Perforce | Select this option if you use PerforceA version control system for file change management. More info See in Glossary as your version control system. |
|
Username | Enter the username associated with your Perforce account. This property is only visible when Mode is set to Perforce. | |
Password | Enter the password associated with your Perforce account. This property is only visible when Mode is set to Perforce. | |
Workspace | Enter your workspace. For example, Example**Workspace**1 . This property is only visible when Mode is set to Perforce. |
|
Server | Enter the server your Unity Project is on. For example, localhost:1666. This property is only visible when Mode is set to Perforce. | |
Host | Enter the hostname that you want your computer to impersonate. For example, workstation123.perforce.com. This property is only visible when Mode is set to Perforce. | |
Log Level | Select how much version control information to receive in Unity’s console log. | |
Verbose | Log every operation related to version control. This option provides very detailed logging, and is useful if you want to debug your version control setup. This property is only visible when Mode is set to Perforce. | |
Info | Log errors, warnings, and information related to version control. | |
Notice | Log errors and warnings. | |
Fatal | Unity prints only fatal errors to the console. | |
Status | Display information on the status of the connection to the version control system. If you are not connected, select Connect to connect to the system you have configured. This property is only visible when Mode is set to Perforce. | |
Automatic Add | When this setting is enabled, automatically add your files to the version control system when you add them to the Project, either via the Editor or the folder on disk. When this setting is disabled, you need to add files manually to the version control system. This setting is enabled by default. This property is only visible when Mode is set to Perforce. | |
Work Offline | Enable this setting to work offline. When this setting is enabled, you need to reconcile offline work in P4V or use the reconcile command in P4 to bring the Perforce server depot up to date with the work you did while offline. For more information, refer to Working offline with Perforce. This property is only visible when Mode is set to Perforce. | |
Async Update | Enable this setting to use asynchronous version control status queries. When enabled, Perforce updates the version control status of files without stalling the Unity Editor. Use this setting when the connection to your version control server has high latency. Note: Only status queries are asynchronous. Unity synchronously performs operations that change the state of files, or require up-to-date knowledge of a file status. This property is only visible when Mode is set to Perforce. |
|
Show Failed Checkouts | Enable this property to display a dialog when Perforce can’t perform the check out operation. This might happen if you lose connection, or if another user has exclusively checked out the Asset you want to edit. This property is only visible when Mode is set to Perforce. | |
Overwrite Failed Checkout Assets | When you enable this setting, Unity saves any Assets that can not be checked out. This means Unity forces through a save to a file, even if Perforce cannot check out the file. This is enabled by default. If you disable it, Unity doesn’t force your files to save if Perforce can’t check them out. This property is only visible when Mode is set to Perforce. | |
Smart Merge | Smart Merge makes it easier for Unity to merge files that have changes on the same line. This is useful if several users are working on the same Project at the same time. This property is only visible when Mode is set to Perforce. | |
Off | Disable Smart Merge. | |
Ask | Enable Smart Merge, but receive a notification before you merge, if a conflict happens. This is the default setting. | |
Premerge | Automatically use Smart Merge. | |
Version Packages Outside Project | Tracks changes to packages that reside on disk outside of the Unity project’s root folder while still in the local workspace. This property is only visible when Mode is set to Perforce. | |
Overlay Icons | Enable this setting to display version control status icons in the Editor. This property is only visible when Mode is set to Perforce. |
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.
When you visit any website, it may store or retrieve information on your browser, mostly in the form of cookies. This information might be about you, your preferences or your device and is mostly used to make the site work as you expect it to. The information does not usually directly identify you, but it can give you a more personalized web experience. Because we respect your right to privacy, you can choose not to allow some types of cookies. Click on the different category headings to find out more and change our default settings. However, blocking some types of cookies may impact your experience of the site and the services we are able to offer.
More information
These cookies enable the website to provide enhanced functionality and personalisation. They may be set by us or by third party providers whose services we have added to our pages. If you do not allow these cookies then some or all of these services may not function properly.
These cookies allow us to count visits and traffic sources so we can measure and improve the performance of our site. They help us to know which pages are the most and least popular and see how visitors move around the site. All information these cookies collect is aggregated and therefore anonymous. If you do not allow these cookies we will not know when you have visited our site, and will not be able to monitor its performance.
These cookies may be set through our site by our advertising partners. They may be used by those companies to build a profile of your interests and show you relevant adverts on other sites. They do not store directly personal information, but are based on uniquely identifying your browser and internet device. If you do not allow these cookies, you will experience less targeted advertising. Some 3rd party video providers do not allow video views without targeting cookies. If you are experiencing difficulty viewing a video, you will need to set your cookie preferences for targeting to yes if you wish to view videos from these providers. Unity does not control this.
These cookies are necessary for the website to function and cannot be switched off in our systems. They are usually only set in response to actions made by you which amount to a request for services, such as setting your privacy preferences, logging in or filling in forms. You can set your browser to block or alert you about these cookies, but some parts of the site will not then work. These cookies do not store any personally identifiable information.