zdoom.org Open in urlscan Pro
2600:3c03::f03c:91ff:fe96:a40a  Public Scan

Form analysis
1 forms found in the DOM

/w/index.php

<form action="/w/index.php" id="searchform" class="vector-search-box-form">
  <div id="simpleSearch" class="vector-search-box-inner" data-search-loc="header-navigation">
    <input class="vector-search-box-input" type="search" name="search" placeholder="Search ZDoom Wiki" aria-label="Search ZDoom Wiki" autocapitalize="sentences" title="Search ZDoom Wiki [alt-shift-f]" accesskey="f" id="searchInput">
    <input type="hidden" name="title" value="Special:Search">
    <input id="mw-searchButton" class="searchButton mw-fallbackSearchButton" type="submit" name="fulltext" title="Search the pages for this text" value="Search">
    <input id="searchButton" class="searchButton" type="submit" name="go" title="Go to a page with this exact name if it exists" value="Go">
  </div>
</form>

Text Content

COMMAND LINE PARAMETERS

From ZDoom Wiki



Jump to navigation Jump to search
For more information on this article, visit the parameter page on the Doom Wiki.

A command line parameter is simply a keyword and, if needs be, associated value
typed after the executable's name on the command line. They should not be
confused with console commands! A command line parameter is entered before the
game is even launched; whereas console commands are entered during the game in
the console.

A typical command line looks like:

zdoom -skill 4 -warp 24


“-skill 4” and “-warp 24” are two of the command line parameters ZDoom supports.
There are several others, described below:


CONTENTS

 * 1 Configuration options
 * 2 Play options
 * 3 Loading options
 * 4 Debug options
 * 5 Multiplayer options
 * 6 Zandronum Specific
 * 7 Other options
 * 8 See also


CONFIGURATION OPTIONS

-2 Forces all video modes to use pixel doubling, resulting in the final video
mode being two times larger than specified. -4 Forces all video modes to use
pixel quadrupling, resulting in the final video mode being four times larger
than specified. -bits numbits Specifies the display depth. Currently, only 8 is
supported (for the software renderer). -width x -height y Specifies the desired
resolution of the screen. If only one of -width or -height is specified, ZDoom
will try to guess the other one based on a standard aspect ratio. If the
specified resolution is not supported by your SDL/DirectDraw drivers, ZDoom will
try various resolutions until it either finds one that works, or it will finally
give up. To determine which resolutions ZDoom can use, use the vid_describemodes
command from the console once you have started the game. -blockmap Causes ZDoom
to ignore all the BLOCKMAP information a map provides and generate it instead.
This is equivalent to +set genblockmap 1. -cdrom Causes ZDoom to look for
savegames and zdoom.cfg in a directory called C:\ZDOOMDAT. Screenshots will also
be saved in this directory. -config configfile Causes ZDoom to use an
alternative configuration file. If configfile does not exist, it will be
created. -iwad iwadfile[.wad] The IWAD file specified after this parameter will
be used as the game IWAD file. ZDoom will look for the IWAD in the current
directory, in the same directory as zdoom.exe, in the directory set in the
DOOMWADDIR environment variable, and in the directory set in the HOME
environment variable. (Verification needed) -nocdaudio Disables CD audio. Since
only the Windows version supports CD audio, other versions ignore this option.
(Verification needed) -noidle (Windows only) When the user presses Alt-Tab to
switch from ZDoom to another window, ZDoom will normally reduce its priority
class so that it does not slow the rest of the system down. By specifying this
parameter, ZDoom will try to run at full speed even when it is not the active
window. -nojoy (Windows only) Disables joystick support. If you have an
old-fashioned gameport (non-USB) device attached, it can slow down the game even
if you do not intend to use it. Use -nojoy to avoid the slowdown that comes from
polling it for input. Only the Windows version supports a joystick. -nomusic
Prevents the playback of music. -nosfx Prevents the playback of sound effects.
-nosound Disables both music and sound effects. -nostartup Disables the startup
screens used by Heretic, Hexen and Strife, and use the Doom text-mode startup
instead. -oldsprites Disables sprite renaming. Unless you are playing a mod for
Heretic, Hexen or Strife that replaced a few select sprites, you do not need
this. -savedir path Specifies an alternate directory to use for saved files. If
this is not specified, ZDoom stores them in the directory indicated by the
save_dir CVAR.


PLAY OPTIONS

-avg Stands for “Austin Virtual Gaming”. Automatically advances to the next
level after 20 minutes. This is equivalent to +set timelimit 20 or -timer 20.
-fast Sets the dmflags CVAR to make the monsters as fast as in Nightmare mode
even if you are not playing Nightmare. -nomonsters Sets the dmflags CVAR so that
monsters are not spawned on levels. -respawn Sets the dmflags CVAR so that
monsters respawn even if you are not playing at Nightmare difficulty. -timer x
Causes ZDoom to automatically advance to the next level after x minutes. This is
equivalent to +set timelimit x. -turbo x Causes player movement to be x% as fast
as normal. Valid values are 10–255, with 100 being normal. Values larger than
100 are considered cheating. This is equivalent to +set turbo x.


LOADING OPTIONS

-deh dehfile[.deh] Causes ZDoom to apply a DeHackEd or .bex patch to the game.
This must be a text patch; binary patches are not supported. (As far as I know,
most patches are text patches, so this should not be too much of a problem.)
Also, only patch format 6 is known to be supported. Other formats may or may not
work properly. If the .deh extension is omitted, ZDoom will automatically add
it. -bex bexfile[.bex] This is the same as -deh, except the default file
extension is .bex. -file file1[.wad] file2[.wad] file3[.wad] ... Used to load
one or more PWAD files which generally contain user-created levels. Files listed
further right take precedence to files listed before them, so as an example, if
both file1.wad and file2.wad contain have a MAP01, the MAP01 in file2.wad will
be used instead of the one in file1.wad. If the .wad extension is omitted, ZDoom
will automatically add it. Using this parameter is no longer needed, zdoom
file1.wad file2.wad file3.wad will work just as well as zdoom -file file1.wad
file2.wad file3.wad. -allowduplicates (Verification needed) When loading files
with -file, files with the same name are discarded from the load list to prevent
potential errors as a result. This command allows such files to be loaded
regardless. -noautoload Prevents files from being autoloaded based on the
“AutoLoad” sections in the user's configuration file. This flag also disables
autoloading of zvox.wad and the skins directory. This can be useful if you use
files which are autoloaded when playing normally, but want to load without them
for debugging purposes or to play a mod which might be incompatible with them.
-noautoexec Disables the execution of the autoexec.cfg files. -loadgame
saveXX.[zds] Automatically loads the specified savegame. To find out a save's
file name, press F1 while it is highlighted in the save or load menu. If you do
not include the .zds extension, ZDoom will automatically add it for you.
-playdemo demofile[.lmp] ZDoom will automatically play the specified demo when
it starts. If the .lmp extension is omitted, it will automatically be added.
-record demofile[.lmp] Records a demo. The -warp parameter or +map command
should also be used if you do not want to record the demo on MAP01 or E1M1. You
may only record from the start of a map. Loading a savegame and recording from
there is unsupported. To stop the demo recording, use the “stop” console
command. If the .lmp extension is omitted, it will automatically be added.
Unlike vanilla Doom, only one person in a multiplayer game needs to specify the
-record parameter if they want to record a demo. However, if someone quits
before the person recording the demo does, the person recording will
automatically quit, too, because demos do not have a way to record when a player
leaves the game. +playerclass class Only relevant when playing a game with
several available player classes. Without mods, this applies to Hexen only. For
example: +playerclass Fighter +playerclass Cleric +playerclass Mage +playerclass
Random -skill x Sets the initial skill level. This is overridden if you start a
new game from the New Game menu. Note that this is different from the skill
CVAR, which ranges from 0-4. -timedemo demofile[.lmp] Plays back a demo faster
than -playdemo and displays a framerate when the demo is over. If the .lmp
extension is omitted, it will automatically be added. -warp m -warp e m For Doom
II, Final Doom, Hexen and Strife, starts the game on map m. For Chex Quest, Doom
and Heretic, starts the game on episode e, map m. The +map command can also be
used to perform this action, but it expects the actual name of the map (e.g.
MAP01, E1M1). -warpwipe Forces a screen wipe to happen after loading a map
immediately at startup. Useless unless used in conjunction with -warp or +map.
-xlat file Specify a different default map translator to use if one isn't
specified in MAPINFO. The default translators are xlat/doom.txt for Doom, Chex
Quest, Urban Brawl and Harmony; xlat/heretic.txt for Heretic and Hexen (though
Hexen maps normally need no translator since only Doom-format maps are
translated) and xlat/strife.txt for Strife. For playing an Eternity Engine mod,
the xlat/eternity.txt file can be used, though keep in mind that many Eternity
features are not implemented in ZDoom and will not work even after translation.
You can specify your own custom translator.


DEBUG OPTIONS

While not a true command line parameter, the set console command can be called
from the command line by prefixing it with '+'. For example, +set developer 1
will print a bunch of debugging messages to the console. Other useful CVARs that
can be set in this way for debugging purposes include debuganimated,
dumpspawnedthings, showloadtimes and script_debug.

-0 Resets the window position to the top-left corner of the screen. -debugfile
Causes ZDoom to write network debugging information to a file called debugN.txt
where N is your player number. -devparm Prints a message telling you that you
“useless mode is activated”. With the original Doom, using -devparm was the only
way to take screenshots. With ZDoom, screenshot is just another command, so
-devparm serves no real purpose. -dumpjit Outputs a result of the ZScript
JIT-compilation to Assembler to the external file "dumpjit.txt". -hashfiles
Produces a file fileinfo.txt which contains the MD5 hash for every lump and
resource ZDoom can load, along with version information and launch parameters.
This is useful for synchronization diagnostics with demos and netgames. -noblit
Causes ZDoom not to update the display on the screen, but it still draws
everything to an internal buffer. Only useful with -timedemo. -nodraw Causes
ZDoom not to draw anything at all. Only useful with -timedemo. -norun Quits the
game just before video initialization. To be used to check for errors in scripts
without actually running the game. -stdout (Win32 only) Sends all output to a
system console. Unix and MacOS builds of ZDoom will always do that.


MULTIPLAYER OPTIONS

-altdeath Informs ZDoom that you will be playing a deathmatch game and sets the
dmflags CVAR so that items other than invulnerability and invisibilty respawn
after being picked up. Only player 1 needs to specify this. -deathmatch Informs
ZDoom that you will be playing a deathmatch game and sets the dmflags CVAR so
that weapons stay behind when a player picks them up. Only player 1 needs to
specify this. -dup x Causes ZDoom to transmit fewer player movement commands
across the network. Valid values range from 1–9. For example, -dup 2 would cause
ZDoom to send half as many movements as normal. -extratic Causes ZDoom to send a
backup copy of every movement command across the network. -host x This machine
will function as a host for a multiplayer game with x players (including this
machine). It will wait for other machines to connect using the -join parameter
and then start the game when everyone is connected. -join host's IP
address[:host's port] Connect to a host for a multiplayer game. -net
console-number hosts ... Informs ZDoom that you will be playing a network game.
Using the -host/-join parameters instead is strongly recommended because they
are much easier to use. -netmode 0 or 1 Changes the network mode the game uses
(Peer-to-Peer or Packet Server). More information on each mode can be found on
the Multiplayer page. -port x Specifies an alternate IP port for this machine to
use during a network game. By default, port 5029 is used.


ZANDRONUM SPECIFIC

-nobroadcast When used with '-host', the server will not advertise within the
Local Area Network (aka LAN). -private When used with '-host', the server will
not publicly broadcast to the master server. -upnp [port number] Enable
Universal Plug-and-Play support on Zandronum. The game server tries to
automatically add a port mapping on the router that connects the game server to
the internet. The external port of the mapping can be overridden if invoked with
"-upnp portNumber". For example: -upnp 10666 -useip x.y.z.w This will set
Zandronum to only listen to the network adapter that contains the specified IPv4
address. However, if this command is not used, by default, Zandronum will listen
from all network adapters that are available within the system. This command can
be ignored if there is no multiple network adapters, or if wanting Zandronum to
listen to all network adapters available. For example: -useip 192.168.0.3
-noinput (GNU/Linux Only) Available in the GNU/Linux platform, the console will
only print messages but will never accept and input within the game server's
console directly. The game server can still be controlled remotely, but not
directly within the actual server. Note: This does not hide the output from
Zandronum from your current shell. You can do that by appending to following to
your command line parameters: > /dev/null 2>&1 -exec Directory Executes a script
file that houses configurations such as settings that can be used within the
virtual world and generalized game server specific settings, such as how votes
are managed. For example of usage: -exec "..\..\My
Configurations\SpecialServer.cfg" -record Directory When used, Zandronum will
record all actions that take place within the multiplayer game. These demos can
be played back later with the -playdemo parameter and the same exact WAD files.
An example of its usage: zandronum -iwad Doom2.wad -file STCTF.wad
ICantBelieveItsNotButter.pk3 -record ".\MyZandronumDemo.cld" -playdemo Directory
Plays back the specified demo file. In order to play the previously recorded
demo, it is necessary to include the exact PWADs and in its precise order of
which the wad files were recorded, failure to do so could result into an error
from the Zandronum engine. An example of its usage: zandronum -iwad Doom2.wad
-file STCTF.wad ICantBelieveItsNotButter.pk3 -playdemo ".\MyZandronumDemo.cld"
-optfile Directory The game server can allow the ability for connecting-clients
(players) to join the game server without needing the optional listed PWAD's.
However, it is recommended to use this feature for additional customizations
such as: announcers, music, high resolution textures, 3D Models, Voxel packs,
etc. For example: -optfile "C:\Games\Zandronum\WADs\SVDoom.wad"


OTHER OPTIONS

In addition to the above parameters, console commands can be included on the
command line by preceding them with a '+'. If you wish to change a CVAR in this
manner, it is a good idea to use the set command. This is because any set
commands will be executed just after the config file is loaded, and all other
commands are executed after every game subsystem has been initialized. For
example, to turn on developer messages when you start ZDoom, use the command
line:

zdoom +set developer 1


instead of

zdoom +developer 1


If you use the second line, you will miss out on all the developer messages that
get generated during the startup process.


SEE ALSO

 * CCMDs (Console commands)
 * CVARs (Console variables)
 * Frontend

Remember, if you are not comfortable with the frequent use of the command line,
you may enter these commands into any text editor, then save the document with a
.bat extension for future use.

Retrieved from
"https://zdoom.org/w/index.php?title=Command_line_parameters&oldid=50179"
Category:
 * Game concepts


NAVIGATION MENU


PERSONAL TOOLS

 * Create account
 * Log in
 * Dark mode


NAMESPACES

 * Page
 * Discussion

English



VIEWS

 * Read
 * View source
 * View history

More



SEARCH




NAVIGATION

 * Main Page
 * Recent changes
 * Random page
 * Help


ZSCRIPT

 * Reference
 * Classes
 * Data types
 * Actor functions
 * Virtual functions
 * Action functions
 * Actor flags
 * Actor properties
 * Actor states
 * Expressions
 * ZScript guides


ACS

 * ACS functions
 * Action specials


DECORATE (DEPRECATED)

 * Action functions
 * Actor classes
 * Actor flags
 * Actor properties
 * Actor states
 * Expressions


TOOLS

 * What links here
 * Related changes
 * Special pages
 * Printable version
 * Permanent link
 * Page information

 * This page was last edited on 22 March 2023, at 03:21.
 * Content is available under GNU Free Documentation License 1.2 unless
   otherwise noted.

 * Privacy policy
 * About ZDoom Wiki
 * Disclaimers
 * Mobile view

 * 
 *