Command-line switches

The command-line switches the editor, the game and the dedicated server read, and which ones a release game keeps.

Last updated Oct 31, 2026Edit this pageVersion 1.0.0

Every host parses its command line into FCommandLine, and engine code reads switches from there. A switch may start with one dash or two, and a value follows either = or a space: --project=MyGame.mproject, -project MyGame.mproject. When a switch appears twice, the last one wins. FCommandLine

What a release game keeps

A release game's command line is whatever a shortcut or a store's launch options put there, so the player drops every switch that is not player-facing before anything reads it, and logs what it dropped. What survives:

SwitchesPurpose
-d3d12, -dx12, -d3d11, -dx11, -vulkan, -metalForce a graphics backend
-fullscreen, -windowed, -borderless, -width=, -height=, -resx=, -resy=Window mode and size
-vsync, -novsync, -no-vsync, -hdr, -nohdrPresentation
-no-splashSkip the start-up splash
-nosound, -audiodevice=<name>Mute, or pick the output device for this run
-lang=<tag>, -culture=<tag>Language for this run
-connect=, -port=, -player-name=, -join-steam=, -players=, -load-slot=Multiplayer and save slot
-no-crash-reporter, -silentSuppress the crash reporter's window
-log, -loglevel=<level>Turn on the log file; lower its threshold

A game module can widen the list for its own switches with FCommandLine::RestrictToPlayerArguments. debug, dev, debuggame and profile builds keep the whole command line.

Every host

SwitchEffect
--project=<file>.mprojectThe project to open
--rhi=<d3d12|vulkan|d3d11|metal>The graphics backend; the shorthands above win over it. See Rendering
--cvar=<name>=<value>Set a console variable; wins over every config file. Repeat for several
--no-user-configIgnore the per-user config and editor preferences, for reproducible runs
--app-data=<dir>Keep the per-user config, logs, caches and signing keys under <dir> instead of the real per-user folder; MOWO_APP_DATA does the same and the switch wins
--seed=<n>Pin the gameplay random seed; every run logs the seed it used
--fixed-dt=<seconds>, --fps=<n>Run at a fixed timestep
--max-delta=<seconds>The cap on a single frame's delta time
--log, --loglevel=<level>Logging; see Logging
--no-crash-reporter, --silentDo not show the crash reporter window
--no-migrateRefuse to open a project that needs migrating instead of migrating it
--visual-script-dap[=<port>]Start the Visual Scripting debug adapter for an external IDE
--trace=<file>.mtraceRecord a whole-run trace; see Profiling
--csvprofile=<file>Write a per-frame, per-zone CSV
--metrics=<file>Write a run record (frame-time distribution, build, backend, seed) at shutdown
--gpu-validation, --sync-validationTurn on the graphics API's validation layer
--gpu-crash-debuggingOn D3D12, record GPU breadcrumbs for device-lost reports
--no-async-ioRead files synchronously instead of with the platform's asynchronous I/O

Game

MowoGame and a project's game executable (MyGame.exe):

SwitchEffect
--scene=<Content path>Open this level instead of the project's start scene
--connect=<host>[:<port>][#<key>]Join a session; the port defaults to 7777
--join-key=<key>The key a remote host requires, when not given in --connect
--host-sessionHost a session
--join-steam=<steam id>Join a Steam host
--player-name=<name>The local player's name
--players=<n>Local split-screen players
--load-slot=<n>Restore a save slot's world state on start
--upscaler=<none|taa|spatial|fsr|dlss|tsr>The upscaler
--upscaler-quality=<native|quality|balanced|performance|ultra>The upscaler's quality mode
--render-scale=<factor>Internal resolution scale
--no-render-thread, -onethread, --no-rhi-thread, --no-overlapRun the frame on fewer threads, for debugging
--no-throttleDo not cap the frame rate when the window loses focus
--record-open-order[=<file>]Record the order content is first read, for the archive layout

Offline tools

The game executable also runs these tasks and exits. Packaging and the editor use them; they are available in release because packaging runs the release binary.

SwitchTask
--migrate-project=<file>.mprojectMigrate an old project layout
--migrate-assets=<file>.mproject [--source-art] [--dry-run]Migrate assets to the current package format
--retype-asset-refs=<dir or file>[;…] [--dry-run]Rewrite plain-string asset paths as typed references
--validate-assets=<file>.mproject [--strict-validate]Validate assets; exits non-zero on errors (or warnings with --strict-validate)
--convert-scene=<file>.mmapConvert a level file on disk
--primary-assets=<file>.mproject [--write-chunks] [--cook-rules-out=<file>]Resolve primary assets and chunk assignments
--cook-packages=<dir> [--astc] [--audio-codec=…] [--cook-platform=…]Cook asset packages
--gather-pso --project=<file>.mprojectGather the pipeline-state cache before staging

Dedicated server

MowoServer:

SwitchDefaultEffect
--project=<file>.mprojectThe project
--map=<Content path>The level to serve
--port=<n>7777The port to listen on
--tickrate=<hz>60Server ticks per second
--maxclients=<n>4Player limit
--gamemode=<class>Override the game mode class
--travel-after=<seconds>, --travel-to=<Content path>Travel to another level after a delay
--appid=<steam app id>0Require Steam session tickets for this app
--ticket-key=<hex>, --ticket-key-file=<file>The key that verifies encrypted Steam tickets

See Multiplayer.

Editor

MowoEditor:

SwitchEffect
--project <file>.mprojectThe project to open
--scene=<Content path>Open this level instead of the last one
--no-splashSkip the splash
--window-size=<w>x<h>The main window's size
--theme=<name>The editor theme for this run, without changing the preference
--mcp-stdio, --mcp-port=<n>, --mcp-access=<read|edit|full>Start the editor's MCP server for an AI assistant
--multiuser-host[=<port>], --multiuser-join=<host>:<port>, --multiuser-name=, --multiuser-secret=, --multiuser-lanHost or join a multi-user editing session
--no-render-thread, -onethread, --no-rhi-thread, --no-overlapThreading of the frame

See Editor.

Engine sources

This page describes behavior implemented in these files of the engine repository, checked against commit 7c4a1b166.

  • Engine/Source/Runtime/Core/Public/Core/FCommandLine.h

Page feedback

Was this page helpful?