Troubleshooting the Editor

Unity Engine
1

We collected a few common issues users have been experiencing, we’re planning to add more to help you solve your problems faster.

Please visit the Troubleshooting Companion Thread to ask questions about any of these topics.

Contents
Click the links to jump to the relevant post.

2 Likes
2

Windows 10

If you’re having issues with:

  • Unity not loading

  • Not reaching the welcome screen

  • Receiving the error message “Unity Editor has stopped working”

  • Not being able to activate your license

Have you tried the following:

  • Clean install of Unity (and in some cases Windows 10)

  • Updated your drivers manually, Windows 10 could have caused a memory leak

  • Installed the 32-bit version of the Unity Editor

  • Cut and paste the hidden folder C:\ProgramData\Unity folder to another drive, delete the folder entirely or just the Unity_v5.x.ulf file in there

  • How to locate your Unity 5.x license file: http://docs.unity3d.com/Manual/UnityActivation-Overview.html

1 Like
3

Editor crashes on startup for Windows 7/8/10

Known issues:

  • If using 5.1 (particularly 64-bit install), third party proxy integration can crash Unity at the Project Browser

  • Unity 5.0 used Gecko browser engine (Firefox/Mozilla based), we switched to libcef which is Chromium for 5.1 and something can be interfering with that

Have you tried the following:

  • Checked if you have any software installed such as Lavasoft Ad-Aware Web Companion, adware like OpenCandy (Windows computers can come with these pre-installed), Qustodio, Nahimic drivers, Astrill VPN or similar

  • Made sure these softwares are disabled (example: for Lavasoft - make sure that “C:\Windows\system32\LavasoftTcpService64.dll” is deleted, in safe mode, or use AdwCleaner)

  • Downloaded the latest version of Unity (or patch release)

  • Opening Unity from the command line Unity - Manual: Command-line arguments

If the information above does not solve your issues, please create a crash dump file and send in a bug report.

To create a crash dump file:

When Unity crashes and you get “Unity Editor has stopped working” dialog, not the Unity crash reporter, don’t press “Close program”: instead;

  • Open task manager

  • Go to the details tab

  • Find Unity.exe & right click it and press “Create dump file”.

That will create a dump file (might take a few-several seconds depending on your hard drive). You can then open the bug reporter and attach the dump file to the report. Unity QA: Building quality with passion

1 Like
4

License activation issues/Welcome Screen issues

There are a few known issues that can occur with the Welcome screen when starting Unity on all operating systems.

If you have one of these problems;

  • License not detected

  • Stuck on ‘Checking license’ screen

Try the following solutions;

  • Check the number of Activations on your license, Pro Licenses have a maximum of two activations per License Key. Deactivate licenses if needed and reactivate through the editor Manage your license | Unity Hub | 3.0

  • Delete your ULF (Unity License File) and activate again through the Editor

ULF is Located;

  • OSX: /Library/Application Support/Unity/Unity_v5.x.ulf (OS X)

  • PC: C:ProgramData/Unity (If the files are hidden, you need to click View and tick the Hidden Items check box.)

Problem: UI on Welcome screen not displaying correctly

1152×720 51.2 KB

Solution: This is caused by a specific virus on Windows 7 that affects .html. Use anti-virus software to run a scan and remove the virus.

Problem: ‘No Network Connection’ warning/I’m using a Proxy

1084×656 39.3 KB

Solution:

Pro Users: Use manual activation

Personal Users: Click the Smiley face in the top right.

Problem: ‘Service not available, please try again later.’

1015×588 34 KB

Solution:

This could be due to a number of things, this message would normally show when there is something wrong with our servers. If the error persists for longer than 30 minutes, this won’t be the case. Check your network connections & DNS also ensure Unity is white listed on any antivirus or firewalls.

If you are connecting through a Proxy, manually activate your license.

All of the above did not help/My welcome screen is blank

You can launch Unity, create projects, load project and do a number of things from the Command Line (PC) or Terminal (OSX). Check our command line arguments.

Bypassing the welcome screen to launch Unity and create/load a Project

Windows

  • Go to Run;

  • Type;

  • On a 64bit Windows system;
    C:\Program Files\Unity\Editor\Unity.exe -createProject

  • On a 32bit Windows system;
    C:\Program Files (x86)\Unity\Editor\Unity.exe -createProject

  • This will open the Editor and create a new project, the Welcome Screen will still be present on top of the Editor screen, close the Welcome Screen and the Editor will remain.

OSX

  • Open Terminal

  • Type:
    /Applications/Unity/Unity.app/Contents/MacOS/Unity -createProject

The needs to be replaced with the location you want a folder to be created without the <> This includes the folder name.

To open an existing project:

Replace;

-createProject

With;

-projectPath

3 Likes