Command-Line Arguments

Collection of arguments that can be passed to the engine's executable to configure options controlling how it runs.

Windows
MacOS
Linux

Command-Line Arguments are strings of keywords that you can pass when running the executable via the command line or a shortcut to the executable. Their purpose is to customize the manner in which the engine runs to suit the needs of the developer or user. This can be as simple as causing the editor to run instead of the game, or it can be much more involved such as starting up the game with a certain map running at a specified resolution and framerate while dumping out each frame to individual image files.

Modes

These arguments are used to force the main editor executable (UE4Editor.exe) to run as the game or a server using uncooked content.

These commands are not case sensitive.

Example:

UE4Editor.exe -game

Argument

Description

-game

Launch the game using uncooked content.

-server

Run the game as a server using uncooked content.

URL Parameters

URLs can be passed to the executable to force the game to load a specific map upon startup. These can also be used in conjunction with the SERVER or EDITOR modes to run the editor or a server with a specific map. Passing a URL is optional, but must immediately follow the executable name or any mode switch if one is present.

A URL consists of two parts: a map name or server IP address and a series of optional additional parameters. A map name can be any map located within the Maps directory. The inclusion of a file extension (.umap) here is optional. To load a map not found in the Maps directory, an absolute path or a relative path from the Maps directory can be used. In this case, the inclusion of the file extension is mandatory. The server IP address is a standard four-part IP address consisting of four values between 0 and 255 separated by periods. The additional options are specified by appending them to the map name or server IP address. Each option is prefaced by a '?', and can set a value with '='. Starting an option with '-' will remove that option from the cached URL options.

Examples:

MyGame.exe /Game/Maps/MyMap
UE4Editor.exe MyGame.uproject /Game/Maps/MyMap?game=MyGameInfo -game
UE4Editor.exe MyGame.uproject /Game/Maps/MyMap?listen -server
MyGame.exe 127.0.0.1

General Options

Argument

Description

game

Tells the engine what GameInfo class to use (overriding default).

name

Tells the engine the Player name to use.

Server Options

Argument

Description

listen

Specifes the server as a listen server.

bIsLanMatch

Sets whether multiplayer game is on the local network (e.g. bIsLanMatch=0).

bIsFromInvite

Specifies that the player joining was invited.

spectatoronly

Starts the game in spectator mode.

Switches

These arguments can be passed to either the game or the editor, depending on the specific keyword and its intended usage. Some arguments are plain switches (-UNATTENDED) while others are setting switches that are "key=value" pairs (-LOG=MyLog.txt). These commands are not case sensitive. The syntax for passing plain switches is to preface each argument with a minus '-' and then the argument immediately afterward. Setting switches need no leading '-', with the exception of the server switches.

Example:

UE4Editor.exe -silent LOG=MyLog.txt

Developer

  • ABSLOG: Same as LOG= but without a filename length check.

  • ALLUSERS: Add the game for all users when INSTALLGE is specified.

  • AUTO: Assume yes on all questions. (for example during compile)

  • AUTOCHECKOUTPACKAGES: Automatically checkout packages that need to be saved.

  • AutomatedMapBuild: Perform an automated build of a specified map.

  • BIASCOMPRESSIONFORSIZE: Override compression settings with respect to size.

  • BUILDMACHINE: Set as build machine. Used for deciding if debug output is enabled.

  • BULKIMPORTINGSOUNDS: Use when importing sounds in bulk. (Content Browser specific.)

  • CHECK_NATIVE_CLASS_SIZES: Enable checking of native class sizes. Note: Native classes on console platforms will cause native class size checks to fail even though they are assumed to be correct.

  • CODERMODE: Enables Coder mode.

  • COMPATSCALE: Set compatibility settings manually to override PCCompat tool settings.

  • CONFORMDIR: Directory to use when conforming packages.

  • COOKFORDEMO: Specify as cooking packages for the demo.

  • COOKPACKAGES: Tag to specify cooking packages.

  • CRASHREPORTS: Always report crashes of the engine.

  • D3DDEBUG: Use a d3d debug device.

  • DEVCON: Disable secure connections for developers. (Uses unencrypted sockets.)

  • DUMPFILEIOSTATS: Track and log File IO statistics.

  • FIXEDSEED: Initialize the random number generator with a fixed value, 0.

  • FIXUPTANGENTS: Fix legacy tangents in distributions automatically.

  • FORCELOGFLUSH: Force a log flush after each line.

  • FORCEPVRTC: Force pvrtc texture compression for mobile platform.

  • FORCESOUNDRECOOK: Force a complete re-cook of all sounds.

  • GENERICBROWSER: Use the Generic Browser.

  • INSTALLED: For development purposes, run the game as if installed.

  • INSTALLFW / UNINSTALLFW: Set whether the handling of the firewall integration should be performed.

  • INSTALLGE: Add the game to the Game Explorer.

  • CULTUREFORCOOKING: Set language to be used for cooking.

  • LIGHTMASSDEBUG: Launch lightmass manually with -debug and allow lightmass to be executed multiple times.

  • LIGHTMASSSTATS: Force all lightmass agents to report detailed stats to the log.

  • LOG: When used as a switch (-log), opens a separate window to display the contents of the log in real time. When used as a setting (LOG=filename.log), tells the engine to use the log filename of the string that immediately follows.

  • LOGTIMES: Print time with log output. (Default, same as setting LogTimes=True in the [LogFiles] section of *Engine.ini.)

  • NOCONFORM: Tell the engine not to conform packages as they are compiled.

  • NOCONTENTBROWSER: Disable the Content Browser.

  • NOINNEREXCEPTION: Disable the exception handler within native C++.

  • NOLOADSTARTUPPACKAGES: Force startup packages not to be loaded. You can use this if objects in a startup package must be deleted from within the editor.

  • NOLOGTIMES: Do not print time with log output. (Same as setting LogTimes=False in the [LogFiles] section of *Engine.ini.)

  • NOPAUSE: Close the log window automatically on exit.

  • NOPAUSEONSUCCESS: Close the log window automatically on exit as long as no errors were present.

  • NORC: Disable the remote control. Used for dedicated servers.

  • NOVERIFYGC: Do not verify garbage compiler assumptions.

  • NOWRITE: Disable output to log.

  • SEEKFREELOADING: Only use cooked data.

  • SEEKFREEPACKAGEMAP: Override the package map with the seekfree (cooked) version.

  • SEEKFREELOADINGPCCONSOLE: Only use cooked data for PC console mode.

  • SEEKFREELOADINGSERVER: Only use cooked data for server.

  • SETTHREADNAMES: (Xbox only) Force thread names to be set. This can mess up the XDK COM API which is why it must be explicitly set to be performed if desired.

  • SHOWMISSINGLOC: If missing localized text, return error string instead of English text.

  • SILENT: Disable output and feedback.

  • TRACEANIMUSAGE: Trace animation usage.

  • TREATLOADWARNINGSASERRORS: Force load warnings to be treated as errors.

  • UNATTENDED: Set as unattended. Disable anything requiring feedback from user.

  • UNINSTALLGE: Remove the game from the Game Explorer.

  • USEUNPUBLISHED: Force packages in the Unpublished folder to be used.

  • VADEBUG: Use the Visual Studio debugger interface.

  • VERBOSE: Set compiler to use verbose output.

  • VERIFYGC: Force garbage compiler assumptions to be verified.

  • WARNINGSASERRORS: Treat warnings as errors.

Rendering

  • ConsoleX: Set the horizontal position for console output window.

  • ConsoleY: Set the vertical position for console output window.

  • WinX: Set the horizontal position of the game window on the screen.

  • WinY: Set the vertical position of the game window on the screen.

  • ResX: Set horizontal resolution for game window.

  • ResY: Set vertical resolution for game window.

  • VSync: Activate the VSYNC via command line. Pprevents tearing of the image but costs fps and causes input latency.)

  • NoVSync: Deactivate the VSYNC via command line.

  • BENCHMARK: Run game at fixed-step in order to process each frame without skipping any frames. This is useful in conjunction with DUMPMOVIE options.

  • DUMPMOVIE: Dump rendered frames to files using current resolution of game.

  • EXEC: Executes the specified exec file.

  • FPS: Set the frames per second for benchmarking.

  • FULLSCREEN: Set game to run in fullscreen mode.

  • SECONDS: Set the maximum tick time.

  • WINDOWED: Set game to run in windowed mode.

Network

  • LANPLAY: Tell the engine to not cap client bandwidth when connecting to servers. Causes double the amount of server updates and can saturate client's bandwidth.

  • Limitclientticks: Force throttling of network updates.

  • MULTIHOME: Tell the engine to use a multihome address for networking.

  • NETWORKPROFILER: Enable network profiler tracking.

  • NOSTEAM: Set steamworks to not be used.

  • PORT: Tell the engine to use a specific port number.

  • PRIMARYNET: Affect how the engine handles network binding.

User

  • NOHOMEDIR: Override use of My Documents folder as home directory.

  • NOFORCEFEEDBACK: Disable force feedback in the engine.

  • NOSOUND: Disable any sound output from the engine.

  • NOSPLASH: Disable use of splash image when loading the game.

  • NOTEXTURESTREAMING: Disable texture streaming. Highest quality textures are always loaded.

  • ONETHREAD: Run the engine using a single thread instead of multi-threading.

  • PATHS: Set what paths to use for testing wrangled content. Not used for shipping releases.

  • PREFERREDPROCESSOR: Set the thread affinity for a specific processor.

  • USEALLAVAILABLECORES: Force the use of all available cores on the target platform.

Server Switches

  • LOGIN: Set username to use when logging in.

  • PASSWORD: Set password to use when logging in.

Game Stats/Database

  • NODATABASE: Do not use database, and ignore database connection errors.

  • NOLIVETAGS: Skip loading unverified tag changes from SQL database. Only load for current user.

INI/Config Files

  • ENGLISHCOALESCED: Revert to the default (English) coalesced .ini if the language-localized version cannot be found.

  • NOAUTOINIUPDATE: Suppress prompts to update .ini files.

  • NOINI: Do not update the .ini files.

  • REGENERATEINIS: Forces .ini files to be regenerated.

Use Aaother command-line argument to temporarily override which INIs are loaded by the game or editor. For example, if a custom 'MyGame.ini' is to be used instead of 'MyOldGame.ini', the argument would be -GAMEINI=MyGame.ini. This table lists the arguments used to override the different INI files used in UE4:

Command-Line Argument

INI Override

DEFEDITORINI=

Default Editor

EDITORINI=

Editor

DEFEDITORUSERSETTINGSINI=

Default EditorUserSettings

EDITORUSERSETTINGSINI=

EditorUserSettings

DEFCOMPATINI=

Default Compat

COMPATINI=

Compat

DEFLIGHTMASSINI=

Default Lightmass

LIGHTMASSINI=

Lightmass

DEFENGINEINI=

Default Engine

ENGINEINI=

Engine

DEFGAMEINI=

Default Game

GAMEINI=

Game

DEFINPUTINI=

Default Input

INPUTINI=

Input

DEFUIINI=

Default UI

UIINI=

UI

Debugging

  • BugLoc (e.g. BugLoc=(X=1798.8569,Y=475.9513,Z=-8.8500))

  • BugRot (e.g. BugRot=(Pitch=-1978,Yaw=-7197,Roll=0))

Misc.

  • timelimit (e.g. timelimit=[time])

  • goalscore (e.g. goalscore=[score])

  • numbots (e.g. numbots=[num])

Select Skin
Light
Dark

Welcome to the new Unreal Engine 4 Documentation site!

We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

We'll be sure to let you know when the new system is up and running.

Post Feedback