Preferences
Unity provides a number of preferences that allow you to customize the behavior of the Unity Editor.
To access the Preferences window, go to Edit > Preferences (Windows) or Unity > Preferences (Mac) from the main menu in Unity. The following preference categories are available:
- General
- 2D
- Analysis
- Cache Server
- Colors
- External Tools
- GI Cache
- UI Scaling
- Custom package preferences
Navigating the Preferences window
Use the search box to filter the list of settings categories, and highlight keywords in the details pane on the right.
General
General preferences allow you to customize working in Unity overall.
| Propiedad: | Función: | |
|---|---|---|
| Auto Refresh | Enable this setting to update Assets automatically as they change. | |
| ¿Debe mostrarse el proyecto anterior al inicio? | Enable this setting to always load the previous Project at startup. | |
| Compress Assets on Import | Enable this setting to automatically compress Assets during import. | |
| Disable Editor Analytics (Pro solamente) | Enable this setting to stop the Editor automatically sending information back to Unity. | |
| Show Asset Store search hits | Enable this setting to show the number of free/paid Assets from the Asset Store in the Project Browser. | |
| Verify Saving Assets | Enable this setting if you wish to verify which Assets to save individually on quitting Unity. | |
| Script Changes While Playing | Choose Unity’s behavior when scripts change while your game is running in the Editor. | |
| Recompile And Continue Playing | Recompile your scripts and keep running the Scene. This is the default behaviour, but you might want to change it if your scripts rely on any non-serializable data. | |
| Recompile After Finished Playing | Defer recompilation until you manually stop your Scene, avoiding any interruption. | |
| Stop Playing And Recompile | Immediately stop your Scene for recompilation, allowing you to quickly restart testing. | |
| Editor Theme | Choose which skin to use in the Unity Editor. This is only available for Plus and Pro Unity subscriptions. | |
| Personal | Use the light grey background with black text. | |
| Professional | Use the dark grey background with white text. | |
| Editor Font | Select which font to display in the Unity Editor. The default font is Inter. | |
| Enable Alpha Numeric Sorting | Enable this setting to display a button in the top-right corner of the Hierarchy window, which toggles between Transform sort (the default) and Alphanumeric sort. | |
| Enable Code Coverage | Enable this setting to access the interface for the code coverage data that Mono exposes. Code coverage lets you see how much of your code is executed when it is run. It’s normally associated with automated unit tests, but coverage data in Unity can be gathered at any time when the Editor is running. For more information, see documentation on Coverage API. | |
2D
Use the Max Sprite Atlas Cache Size (GB) preference to set the maximum size of the Sprite Atlas cache folder. Whenever possible, Unity keeps the size of this folder below this level.
Analysis
The Analysis preferences let you define settings for the Profiler.
| Propiedad: | Función: |
|---|---|
| Frame Count | Choose how many frames to display in the Profiler window. |
| Remember last recording state | Save and load the recording state between Profiler sessions. |
| Default recording state | Choose whether recording is enabled or disabled when the Profiler begins. |
Cache Server
Any time an Asset changes, Unity automatically re-imports it. Setting up a Cache Server drastically reduces the time it takes to import Assets. You can set up a Cache Server using remote hosting or stored on your local computer.
| Propiedad: | Función: |
|---|---|
| New Projects default asset pipeline | Select the default asset pipeline for new Projects. |
| Active version | Displays the current asset pipeline version. |
| Asset Pipeline v1 (deprecated) | |
| Cache Server Mode | Define the Cache Server mode. Local: Use a local Cache Server on this computer. The preferences for Local storage appear. Remote: Use a Cache Server hosted on a remote computer. The preferences for Remote hosting appear. By default the Cache Server is disabled. |
| Asset Pipeline v2 | |
| Cache Server Default Mode | Define whether the Cache Server is enabled or disabled by default. You can override this per Project in the Unity Editor settings. |
| Default IP address | Set the default IP address for the Cache Server to use. You can override this per Project in the Unity Editor settings. |
| Check Connection | Click this button to attempt to connect to the remote Cache Server. |
Remote hosting
These preferences are only available when Use Cache Server is set to Remote.
| Propiedad: | Función: |
|---|---|
| IP Address | Enter the IP address of the dedicated cache server that an administrator set up. |
| Check Connection | Click this button to attempt to connect to the remote Cache Server. |
Local storage
These preferences are only available when the Use Cache Server is set to Local.
| Propiedad: | Función: |
|---|---|
| Maximum Cache Size (GB) | Specify the maximum size in gigabytes for the Cache Server on this computer’s storage. The minimum size is 1GB. The maximum size is 200GB. The default cache size is 10GB. |
| Ubicación actual de la caché. | Enable this option to specify a location where you want to store the cache. |
| Cache Folder Location | Click the Browse button to specify a location for the cache. |
| Cache size is … | Message displaying the current size of the cache. Before clicking the Check Cache Size button, this appears as Cache size is unknown. After clicking the button, the calculated cache size appears in the message. |
| Check Cache Size | Click this to find out how much storage the Local Cache Server is using. This operation can take some time to complete if you have a large project. |
| Clean Cache | Delete the contents of the cache. |
| Cache Folder Location | Displays the current cache folder location. |
Colors
The Colors preferences allow you to choose the colors that Unity uses when displaying various user interface elements.
External Tools
The External Tools preferences allow you to set up external applications for scripting, working with images, and source control.
| Propiedad: | Función: |
|---|---|
| External Script Editor | Choose which application Unity should use to open script files. Unity automatically passes the correct arguments to script editors it has built-in support for. Unity has built-in support for Visual Studio (Express), Visual Studio Code, Xamarin Studio, MonoDevelop and JetBrains Rider. |
| Generate all .csproj files. | Enable this setting to generate all .csproj files. |
| Add .unityproj’s to .sln | Enable this setting to add UnityScript (.unityproj) projects to the generated solution (.sln) file. This is enabled by default for MonoDevelop and Xamarin Studio, and disabled by default for Visual Studio (Express) and Visual Studio Code. |
| Editor Attaching | Enable this setting to allow debugging of scripts in the Unity Editor. If you disable this option, you can’t attach a script debugger to Unity to debug your scripts. |
| Ubicación actual de la caché. | ¿Qué aplicación debería usar Unity para abrir archivos de imagen? |
| Revision Control Diff/Merge | Choose which application you want Unity to use to resolve file differences with the Asset server. Unity detects these tools in their default installation locations (and checks registry keys for TortoiseMerge, WinMerge, PlasticSCM Merge, and Beyond Compare 4 on Windows). |
| JDK Installed with Unity (recommended) | See Android environment setup. |
| Android SDK Tools Installed with Unity (recommended) | See Android environment setup. |
| Android NDK Installed with Unity (recommended) | See Android environment setup. |
| Gradle Installed with Unity (recommended) | This option is enabled by default. Unity installs Gradle tools under Unity/Hub/Editor/[EditorVersion]/PlaybackEngines/AndroidPlayer/Tools/gradle. If you manually install Gradle tools in another location, you can disable this option and click the Browse button to select the correct installation folder. For more information about using Gradle in Unity, see Gradle for Android. |
| Stop Gradle daemons on exit | Enable this option so that when you close the Editor, Unity stops Gradle. If you are using Gradle to build multiple Android Projects at the same time, disable this option as it might cause your other builds to fail. |
| Maximum JVM heap size, Mbytes | Set the maximum Java heap size for building. |
| Keystores Dedicated Location | Choose the location for Keystores. |
GI Cache
The Global Illumination (GI) system uses a cache on each computer to store intermediate files used to pre-compute real-time Global Illumination. All projects on the computer share the cache.
| Propiedad: | Función: |
|---|---|
| Maximum Cache Size (GB) | Use the slider to set the maximum GI cache folder size. Unity keeps the GI cache folder size below this number whenever possible. Unity periodically deletes unused files to create more space (deleting the oldest files first). This is an automatic process, and doesn’t require you to do anything. Note: If the current Scene is using all the files in the GI cache, increase your cache size. Otherwise, resource-intensive recomputation occurs when baking. This can happen when the Scene is very large or the cache size is too small. |
| Ubicación actual de la caché. | Enable this option to allow a custom location for the GI cache folder. By default, the GI cache is stored in the Caches folder. All Projects share the cache folder. Tip: Storing the GI Cache on an SSD drive can speed up baking in cases where the baking process is I/O bound. |
| Cache Folder Location | Click the Browse button to specify a location for the cache. |
| Cache compression | Enable this option to allow Unity to compress files in the GI cache and reduce the size of the generated data. The files are LZ4-compressed by default, and the naming scheme is a hash and a file extension. The hashes are computed based on the inputs to the lighting system, so changing any of the following can lead to recomputation of lighting: - Materials (Textures, Albedo, Emission) - Lights - Geometry - Static flags - Light Probe groups - Reflection probes - Lightmap Parameters Tip: If you need to access the raw Enlighten data, disable Cache Compression and clean the cache. |
| Clean Cache | Use this button to clear the cache directory. It is not safe to delete the GI Cache directory manually while the Editor is running. This is because the Editor creates the GiCache folder when it starts and maintains a set of references to those files. The Clean Cache button ensures that the Editor releases all references to the files on disk before they are deleted. |
| Cache size is | Displays the current size of the cache. |
| Cache Folder Location | Displays the current cache folder location. |
UI Scaling
The UI Scaling preferences let you define how to scale UI text and icons in the Unity Editor.
| Propiedad: | Función: |
|---|---|
| Use default desktop setting | Enable this setting to use your computer’s default settings for scaling UI text and icons. |
| Current scaling | Displays the current scaling value. |
| Use custom scaling value | Override the scaling value. |
Custom package preferences
Some Asset Store or Unity packages add their own custom preferences to the Preferences window. Generally these use the package name as the preferences category. In this example, you can see the Cinemachine package preferences:
For information about a specific package’s preferences, see the documentation for that package. This section contains documentation for standard Unity preferences only.
2019–10–21 Page amended
Added Analysis and UI Scaling tabs, and removed Grid Brush and Tile Palette tabs in 2019.3
Added Gradle for Android options to the External Tools section in 2019.1.
Removed keys and added further options to the Tile Palette Preferences in 2019.1. NewIn20191
Selection outline color preference for child GameObjects added in 2018.3
New unified settings and other updates for Unity 2018.3
Script Changes While Playing and Device To Use drop-down menus added in Unity 2018.2
Updated list of external script editors in 2018.1