Skip to main content

Commandline Arguments

There are several commandline arguments that the plugin can use

Available Arguments​

  • -AUTH_TYPE=xxx
    Logs in the first local player automatically when the Online Subsystem starts, see the supported types below. Not used on dedicated server builds (UE_SERVER).
  • -AUTH_LOGIN=xxx
    Login Id used by the automatic login, for example the DevTool host address
  • -AUTH_TOKEN=xxx
    Token or password used by the automatic login. If it is not set, -AUTH_PASSWORD= is used instead (this is what the Epic Games Launcher passes)
  • -EOSConfig=configurationName
    Use this configuration from Project Settings instead of the Default Configuration Name
  • -epicsandboxid=xxx
    Overrides the SandboxId of the selected configuration (passed by the Epic Games Launcher)
  • -epicdeploymentid=xxx
    Overrides the DeploymentId of the selected configuration
  • -EpicPortal
    Tells the plugin the game was started by the Epic Games Launcher, this enables the Online Subsystem Store/Purchase interface
  • -DisableEOSOverlay
    Disables the EOS overlay (same as bDisableEOSOverlay in Project Settings)
  • -Port=xxxx
    Game port. The Online Subsystem writes it to the session as the ServerPort attribute so clients connect to the right port

Supported AUTH_TYPE values​

The value is not case sensitive. An unknown value makes the automatic login fail with an error in the log.

AUTH_TYPELogin method
devtool or developerDevTool, AUTH_LOGIN is the DevTool host (localhost:1111), AUTH_TOKEN is the credential name
persistentauth or autologinPreviously saved login on this computer (Persistent Auth)
portal or accountportalAccount Portal (EOS overlay or browser)
exchangecodeExchange code, used when started from the Epic Games Launcher
deviceidDeviceId, AUTH_LOGIN is the display name
passwordEmail and password (restricted by Epic, not generally available)
devicecodeDevice code
refreshtokenRefresh token
external or externalauthExternal auth

Example Usage​

  • Logging in to your instance of DevTool at localhost:1111
"C:\Program Files\Epic Games\UE_5.6\Engine\Binaries\Win64\UnrealEditor.exe" "C:\EOSProject\EOSProject.uproject" -game -log -AUTH_TYPE=devtool -AUTH_LOGIN=localhost:1111 -AUTH_TOKEN=MrX

Auto-Login with previously saved credentials​

"C:\Program Files\Epic Games\UE_5.6\Engine\Binaries\Win64\UnrealEditor.exe" "C:\EOSProject\EOSProject.uproject" -game -log -AUTH_TYPE=autologin

Using a different configuration​

MyGame.exe -EOSConfig=ServerConfig