Command line arguments

You can run Unity from the command line (from the macOS Terminal or the Windows Command Prompt).

Launching Unity

On macOS, type the following into the Terminal to launch Unity:

/Applications/Unity/Unity.app/Contents/MacOS/Unity

On Windows, type the following into the Command Prompt to launch Unity:

"C:\Program Files\Unity\Editor\Unity.exe"

When you launch Unity like this, it receives commands and information on startup, which can be very useful for test suites, automated builds and other production tasks.

Note: Use the same method to launch standalone Unity applications.

Options

You can run the Editor and build Unity applications with additional commands and information on startup. This section describes the command line options available.

Examples

C# script in the project:

using UnityEditor;
class MyEditorScript
{
     static void PerformBuild ()
     {
         string[] scenes = { "Assets/MyScene.unity" };
         BuildPipeline.BuildPlayer(scenes, ...);
     }
}

The following command executes Unity in batch mode, executes the MyEditorScript.PerformBuild method, and then quits upon completion.

Windows:

"C:\Program Files\Unity\Editor\Unity.exe" -quit -batchmode -projectPath "C:\Users\UserName\Documents\MyProject" -executeMethod MyEditorScript.PerformBuild

Mac OS:

/Applications/Unity/Unity.app/Contents/MacOS/Unity -quit -batchmode -projectPath ~/UnityProjects/MyProject -executeMethod MyEditorScript.PerformBuild

Unity Editor special command line arguments

You should only use these under special circumstances, or when directed by Unity Support.

Extra Editor arguments from packages

Additional Editor command line arguments are available when these packages are installed.

Unity Standalone Player command line arguments

Standalone players built with Unity also understand some command line arguments:

Universal Windows Platform command line arguments

Universal Windows Apps don’t accept command line arguments by default, so to pass them you need to call a special function from MainPage.xaml.cs/cpp or MainPage.cs/cpp. For example:

appCallbacks.AddCommandLineArg("-nolog");

You should call this before the appCallbacks.Initialize() function.

• “accept-apiupdate” command line option added in Unity 2017.2 NewIn20172

• “-force-clamped” command line argument added in Unity 2017.3 NewIn20172

• Tizen support discontinued in 2017.3 NewIn20173

• “noUpm”, “setDefaultPlatformTextureFormat” and “CacheServerIPAddress” command line options added in Unity 2018.1 NewIn20181

• “Application.isBatchMode” operator added in 2018.2 NewIn20182

Android

To pass additional command line arguments, expand the updateUnityCommandLineArguments method in the UnityPlayerActivity class.

public class UnityPlayerActivity extends Activity implements IUnityPlayerLifecycleEvents
{
...
    protected String updateUnityCommandLineArguments(String cmdLine)
    {
        return (cmdLine == null ? "" : " ") + "-force-vulkan -quit";
    }
}