Legacy Documentation: Version 5.4
Smart Merge
Advanced Development

Troubleshooting The Editor

The following sections explain how to troubleshoot and prevent problems with the Unity editor in different situations. In general, make sure your computer meets all the system requirements, it’s up-to-date, and you have the required user permissions in your system. Also make backups regularly to protect your projects.

Versions

You can install different versions of the editor in different folders. However, make sure you backup your projects as these might be upgraded by a newer version, and you won’t be able to open them in an older version of Unity. See the manual page on installing Unity for further information.

Licenses of add-ons are valid only for the Unity versions that share the same major number, for example 3.x and 4.x. If you upgrade to a minor version of Unity, for example 4.0 to 4.1, the add-ons will be kept.

Activation

Internet Activation is the preferred method to generate your license of Unity. But if you are having problems follow these steps:

  1. Disconnect your computer from the network, otherwise you might get a “tx_id invalid” error.
  2. Select Manual Activation.
  3. Click on Save License Request.
  4. Choose a known save location, for example the Downloads folder.
  5. Reconnect to the network and open https://license.unity3d.com/
  6. In the file field click Browse, and select the license request file.
  7. Choose the required license for Unity and fill out the information requested.
  8. Click Download License and save the file.
  9. Go back to Unity and select Manual Activation if required.
  10. Click on Read License and then select the downloaded license file.

If you still have problems with registering or logging in to your user account please contact support@unity3d.com.

Failure to Start

If Unity crashes when starting then firstly make sure that your computer meets the minimal system requirements. Also update to the latest graphic and sound drivers.

If you get disk write errors, you should check your user account restrictions. When in MacOS, note the “root user” is not recommended and Unity hasn’t been tested in this mode. Unity should always have write permissions for its folders, but if you are granting them manually check these folders:

On Windows:

  • Unity’s installation folder
  • %AllUsersProfile%\Unity (typically C:\ProgramData\Unity)
  • C:\Documents and Settings\<user>\Local Settings\Application Data\Unity
  • C:\Users\<user>\AppData\Local\Unity

MacOS:

  • Package contents of Unity.app
  • /Library/Application Support/Unity
  • ~/Library/Logs/Unity

Some users have experienced difficulties when using hard disks formated with non-native partitions, and using certain software to translate data between storage devices.

Fonts

Corrupt fonts can crash Unity, you can find damaged files following these steps:

On Windows:

  1. Open the fonts folder on your computer, located in the “Windows” folder.
  2. Select “Details” from the “View” menu.
  3. Check the “Size” column for fonts with a “0” size, which indicates a problematic file.
  4. Delete corrupt fonts and reinstall them.

On MacOS:

  1. Launch your Font Book application.
  2. Select all the fonts.
  3. Open the “File” menu and choose “Validate Fonts” -> problematic fonts will be shown as invalid.
  4. Delete corrupt fonts and reinstall them.

The system might have resources constrained, for example running in a virtual machine. Use the Task Manager to find processes consuming lots of memory.

Corrupt Project or Installation

Unity could try to open a project that is corrupt, this might include the default sample project. In such case rename or move the folder of the project. After Unity starts correctly you can restore the project’s folder if wished.

In the event of a corrupt installation, you may need to reinstall Unity - see the instructions below.

In Windows, there could be problems like installation errors, registry corruption, conflicts, etc. For example, error 0xC0000005 means the program has attempted to access memory that it shouldn’t. If you added new hardware or drivers recently, remove and replace the hardware to determine if it’s causing the problem. Run diagnostics software and check information on trouble-shooting the operating system.

Performance and Crashes

If the editor runs slowly or crashes, particularly on builds, this might be caused by all of the available system resources being consumed. Close all other applications when you build the project. Clean up the system using its utilities, and consult the Task Manager (Windows) or Activity Monitor (MacOS) to find out if there are processes using lots of resources, for example memory. Sometimes virus protection software can slow down or even block the file system with its scanning process.

Project Loss

There are many factors that can destroy a project, you should constantly backup your projects to prevent unfortunate accidents. When in MacOS, activate the TimeMachine using an external hard disk reserved for this sole purpose. After a loss you can try any of the file recovery utilities that exist, but sometimes this is irreversible.

Re-installation

Follow these steps to reinstall the editor:

  1. Uninstall Unity. When in MacOS, drag the Unity app to trash.

  2. Delete these files if present:

    • Windows:
      • %AllUsersProfile%\Unity\ (typically C:\ProgramData\Unity)
    • MacOS:
      • /Library/Application Support/Unity/
  3. Restart the computer.

  4. Download the latest version from our website, since your original install might be corrupt: http://unity3d.com/unity/download/archive

  5. Reinstall Unity.

Smart Merge
Advanced Development