Parameter

From DoomWiki.org

In respect to the Doom engine a parameter (or command line parameter and command line argument) is a start-up indication by the user that the engine should change its default behavior. The parameters are typed after the executable's name in the command line and are followed by variables or text strings, if applicable. The command line may be the MS-DOS command line, or any compatible interface, such as a batch file, the command line or target entry in a shortcut's properties dialog box, the Windows Run command, or the command line in DOSBox. Any number of parameters may be typed in, limited only by the maximum length of text allowed by the interface (for example, a 127 character total in some DOS versions).

Many parameters that affect in-game behavior require warping through -wart, -warp, -episode, -skill, -playdemo, -record, or -loadgame, or else they are overridden when the user starts a game through the menu. In deathmatch and cooperative modes an extra program called a device driver by the Doom documentation handles some of the multiplayer specifics and passes any parameters to the main executable. The extra program will also warp the player to the first level of the game if no other warping parameter is used. Unless stated otherwise, parameters work for all versions of both Doom and Doom II, with some exceptions that are detailed accordingly in their descriptions. Note that if you warp internally using the idclev cheat code, any parameters that required warping will be disabled.

Engine variants[edit]

While most parameters are available to all the released versions of the Doom games, some became obsolete with newer versions, and some were added as features were enabled or changed. Earlier versions of the engine, particularly up to 1.2, tend to require the -devparm parameter (that enables "developers mode") to use many of the parameters, but later versions do not require it.

Ports of the Doom engine usually retain most if not all the available parameters, and sometimes add some of their own, or customize some of the original ones. Since ports often rely less on the command line and more on a graphical user interface they may have alternate ways of entering commands and parameters. Doom95, for example, accepts the usual parameters but adds a launcher to be used by default for all purposes, and various source ports add a console that can handle most options and variables, or support drag-and-drop capabilities that take care of some of the start-up options.

Other games with Doom-based engines, such as Heretic, Hexen, and Strife, also use the same parameters with only slight differences, mostly because of required customizations or because they are based on earlier versions of the Doom engine that did not include all the parameters available in the latest versions of the Doom games.

In order to use parameters in Strife, the player needs to launch the game using strife1.exe. Strife.bat will trigger two opening videos before giving the command to load the game itself. After the videos have been displayed, strife1.exe is launched automatically meaning that all previously added parameters will be ignored.

List of parameters[edit]

The parameter descriptions in the list below are preceded by practical identifiers which give a general idea of what the general effect of each parameter is. The parameter identifiers include:

  • Analysis: measures something
  • Configuration: access to settings or files
  • Gameplay: changes the way the game is played
  • Input: affects player input devices
  • Monsters: affects monster qualities
  • Multiplayer: enables multiplayer functions
  • None: disabled development parameter
  • Output: affects sound or graphic output
  • Recording: records or plays demos
  • Warping: starts the game in a level

Below the identifier each parameter description includes a basic command line structure, headed by the type of executable needed or generally used with the parameter, mainly doom (doom.exe or doom2.exe) or a driver (ipxsetup.exe or sersetup.exe), and followed by other required parameters, the parameter in question, and a variable, if applicable. If doom is used driver also applies unless noted otherwise, and executable types not in italics are actual executable file names.

Note: Except where noted, when a variable required by a parameter is a number, any value lower than the lowest expected value will be taken as that lowest value, and any value higher than the highest expected value, as the highest value. Non-numerical characters will be considered either as the lowest or the highest value, depending whether the operating system places them after or before the numbers in an alphanumeric listing.

-8250[edit]

(multiplayer)
sersetup -8250
This parameter sets the UART value for the modem to 8250, in case 16550 fails to work properly.

-9600, -14400, -38400, -57600[edit]

(multiplayer)
sersetup -9600
With these parameters the baud rate for the modem can be changed from the default 14400.

-altdeath[edit]

(gameplay, multiplayer)
driver -altdeath
The -altdeath parameter enables the alternate deathmatch mode (called deathmatch v2.0 in the documentation) added in version 1.5 where most items picked up by players respawn after a while after being picked up. This also applies to weapons, which (unlike in normal deathmatch mode) also disappear for a while upon being picked up, and provide the same amount of ammo they do in single player and cooperative modes. The mode is meant for multiplayer games, although it will work in single player mode as well (doom -warp <map> -altdeath), where the player will be spawned on a deathmatch spot.

-answer[edit]

(multiplayer)
sersetup -answer
With this parameter the Doom networking component tells the modem that it should await an incoming call.

-avg[edit]

(multiplayer)
driver -deathmatch -avg
This -avg parameter tells Doom to behave as if -timer 20 were used. The three letters are an acronym that stands for an establishment called "Austin Virtual Gaming" near the University of Texas set up in 1994 for pay-to-play Doom multiplayer.

-cdrom[edit]

(configuration)
doom -cdrom
This parameter makes the engine use C:\DOOMDATA as the directory where configuration data (such as default.cfg and any saved games or screen shots) is stored, so that the game can be run directly from a CD-ROM. If the directory does not exist on the system, Doom creates it. The disk activity indicator also changes to a picture of a CD, rather than a diskette, when the parameter is applied.
In other Doom engine games the directory name is different. Heretic uses C:\HERETIC.CD, Hexen uses C:\HEXNDATA, and Strife uses C:\STRIFE.CD.

-class[edit]

(gameplay, warping)
hexen -class <class number>
In Hexen, selects the player class to start with on the map specified by -warp parameter. Class number must be equal to 0, 1 or 2 (0 - Fighter; 1 - Cleric; 2 - Mage).

-com1, -com2, -com3, -com4[edit]

(multiplayer)
sersetup -com1
The -com parameters define what COM port is used when making a connection.

-comdev[edit]

(configuration)
doom -comdev
With -comdev the id Software developers told the engine to read the WAD and lump data for the commercial game (Doom II) from specified directories.

-config[edit]

(configuration)
doom -config <configuration>
With this parameter the engine uses an alternate configuration file instead of the usual default.cfg. The required configuration string may be just a file name (such as doom.cfg), which will be read from (or created in) the game's directory, or a path-and-file name (c:\configs\doom.cfg, for example) if another directory is desired.
The -config parameter may be used along with -cdrom, in which case the configuration file will be assigned as chosen while saved games and screen shots will be placed in the Doomdata directory.

-control[edit]

(none)
doom -control <pointer>
This parameter, added in v1.4, enables an interrupt-driven external control driver to provide input to the game. A pointer to a buffer containing an interrupt number and a tic command structure must be passed as the argument (providing an invalid value could crash or corrupt the game). When provided, this parameter causes the message Using external control API to appear. This parameter is also available in Strife, but not in Heretic or Hexen.

-deathmatch[edit]

(gameplay, multiplayer)
driver -deathmatch
The -deathmatch parameter enables the head-to-head competitive mode that pits players against each other, as opposed to the cooperative mode. This is the original deathmatch mode where ammunition and power-ups do not respawn and weapons remain but can be picked up only once per player life, like in cooperative games. There is a difference, however: in deathmatch weapons come with quantity of ammo equal to one large pickup (that is, either 50 bullets, 20 shells, 5 rockets, or 100 energy cells). This parameter is meant for multiplayer games, although it will work in single player mode as well (doom -warp <map> -deathmatch), where the player will be spawned on a deathmatch spot. This parameter does not exist in Strife due to its lack of cooperative play; a netgame is inherently always a deathmatch in that game.

-debugfile[edit]

(analysis)
doom -debugfile
With this parameter the engine produces a file listing available realtics against used gametics to show the internal resources available at each point during play or demo playback. It produces a file called debug0.txt where the data is stored in real time. This parameter has no effect when used in conjunction with -timedemo (which also deals with the same data).

-devparm[edit]

(analysis, configuration)
doom -devparm
The developer's parameter runs the game in developer mode, creating screen shots with the F1 key instead of displaying the help screen and showing the tics-per-frame meter on the lower left of the screen. If only the first dot on the meter is displayed, performance is optimal. The -devparm parameter is also required by some parameters in older versions of Doom. In Strife, -devparm disables the graphical startup sequence, but does not enable a tic counter or change the function of the F1 key, as Strife already has a dedicated key for taking screenshots.

-devsnd[edit]

(analysis, configuration)
hexen -devsnd c:\path\to\sndinfo.txt
A development function from Hexen. Instead of loading the SNDINFO lump embedded in the IWAD, the game will load the given text file as a SNDINFO lump. It is only in this mode that the $archivepath command is used.

-dial[edit]

(multiplayer)
sersetup -dial <phone>
With this parameter the Doom networking component tells the modem what phone number to dial.

-dup[edit]

(multiplayer)
driver -dup
The -dup parameter duplicates tic commands (see ticdup). When this is specified, the same tic command is used for two consecutive tics; as a result, the network bandwidth is halved at a cost in movement accuracy.

-episode[edit]

(warping)
doom -episode <episode>
This parameter starts one of Doom's three episodes from its first level. The usual values for the episode variable are the numbers 1, 2, or 3, representing each episode. This parameter is the equivalent of -warp <e> 1, where e is the number of the episode, and when playing Doom II it always loads the first level of the game, regardless of what episode number is chosen. The -episode parameter has no effect if no value is added after it. This parameter does not exist for Strife.

-extratic[edit]

(multiplayer)
driver -extratic
The -extratic parameter provides extra data in each data packet sent over the network; this adds redundancy and makes the game more resilient to dropped packets at the possible cost of using more bandwidth (see extratic).

-fast[edit]

(gameplay, monsters)
doom -warp <map> -fast
The fast monsters parameter makes monsters attack more often, increases the speed of demons and spectres, and makes demonic fireballs faster than usual. It requires warping (such as -warp) to be effective and was first introduced with version 1.2 of Doom. Note that Heretic and Hexen lack this command.

-file[edit]

(configuration)
doom -file <files>
The -file parameter allows Doom to load additional WADs and lumps, beyond the usual IWAD. The files variable may be a single file name, path-and-file name (if the file is on a different directory than where Doom is run from), or a series of these. A second file would be typed in one space after the first, a third one space after the second, and so on. The order of multiple files may make a difference, as equivalent lumps will be overwritten in the run-time memory, with the rightmost file in the list taking precedence. Note that the engine has a static limit of twenty loaded files (IWAD included), so no more than nineteen separate files should be listed after this parameter.
Adding a tilde (~) character before the filename causes the WAD to be reloaded each time the level is restarted, allowing the level to be edited in parallel without the overhead of restarting the game (see reload hack).
When this parameter is used a warning message stating that the game has been modified is enabled during start-up. The engine normally stops at the message, and to continue the user must press the Enter key. The message can be bypassed by creating a text file (named a, for example) with nothing but echo typed in it, and adding it thus in the command line:
doom -file<a <files>
In any case, if any of the files is missing, the engine will notify the user over the warning message, but will still run normally, missing files notwithstanding. Issues may occur if those missing files are required, though, so it may be convenient not to disable the warning if the location of files being loaded is uncertain.

-flip[edit]

(gameplay, output)
strife1 -flip
Attempts to display flipped player gun sprite graphics in Strife, for players with opposite handedness. Unfortunately the effect is incomplete and broken, because while it flips the graphics, it does not suitably reverse their x offsets as well, causing the weapon animations to appear improperly aligned. Rogue Entertainment never documented this parameter in the game's text files as a result. This parameter exists only in Strife.

-irq[edit]

(multiplayer)
sersetup -irq
With this parameter the Doom networking component will define what IRQ number will be used for the COM port. The irqport variable should be a valid IRQ number to have any effect.

-left[edit]

(output)
doom -net 3 -left
Used for three screen mode. Under Doom version 1.0 or 1.1, the -left parameter will cause a networked computer to display the area to the left of the player's normal view.

-loadgame[edit]

(configuration, warping)
doom -loadgame <savegame>
This parameter starts Doom from a previously saved game. The savegame is normally a number from 0 to 5 (these stand for the 6 slots available from the "save game" menu) although an edited slot using any other single readable character, such as a single digit number or a letter, will also be loaded (doom -loadgame z will load doomsavz.dsg). If you use this parameter with -record, a demo will be produced, but it will quite likely not properly be played back, because it will start "from scratch" on the usual player start, instead of using the location and conditions of the saved game, even if -loadgame is used along with -playdemo or -timedemo (in which cases it is ignored).

-maxdemo[edit]

(recording)
doom -record <demo> -maxdemo <kilobytes>
This defines the maximum size in kilobytes for a demo recording, instead of the usual value of 128 (which is roughly 15 minutes for a single-player game). If the limit is reached while recording, the game ends with a Demo <demo>.lmp recorded message in the command line.

-net[edit]

(multiplayer)
doom -net <players>
The -net parameter enables the networking component in Doom versions 1.0 and 1.1, and defines the number of players (1 to 4) involved. In later versions this parameter is not added externally by the user, and instead applied automatically by part of the networking component of the engine to enable certain multiplayer functions, when a driver is used.

-nodes[edit]

(multiplayer)
ipxsetup -nodes <players>
Networked games connected through the IPX protocol use the -nodes parameter to define how many computers will join the game. The players value stands for the number of players or nodes, from 1 to 4. If this parameter is not used, the engine assumes two players.

-nodraw[edit]

(output)
doom -timedemo <demo> -nodraw
When the -nodraw parameter is used along with -timedemo the graphics drawing functions of the Doom rendering engine are not used, so the speed of the underlying engine can be measured without any resources spent displaying the in-game graphics. Without -timedemo, this parameter has no effect.

-noblit[edit]

(none)
doom -noblit
This is a disabled parameter similar to -nodraw with which, during development, the programmers told the engine not to pass data from an internal buffer onto the screen.

-nograph[edit]

(output)
strife1 -nograph
Disables the graphical introduction sequence in Strife and replaces it with limited DOOM-style text output. The -devparm parameter has the same effect, so specifying the two together is redundant. This parameter only exists in Strife.

-nomonsters[edit]

(monsters)
doom -warp <level> -nomonsters
If the -nomonsters parameter is applied, monsters will not be spawned when any levels are loaded. It is usually used along with deathmatch modes although it can also be useful for walkthroughs and during testing. It must be used along with a warping parameter, to be effective.

-nomouse[edit]

(input)
doom -nomouse
This parameter disables the mouse during the game session.

-nomusic[edit]

(output)
doom -nomusic
The -nomusic parameter simply disables the background music during the game session.

-nosfx[edit]

(output)
doom -nosfx
This parameter disables the game's sound effects (screams, clunks, explosions, and so on) during the game session.

-nosound[edit]

(output)
doom -nosound
With -nosound both music and sound effects are disabled during the game session.

-novoice[edit]

(output)
strife1 -novoice
Causes Strife to play as though voices.wad was unable to be found, even if the file is present. Text will appear in all dialogue boxes by default. This parameter exists only in Strife.

-playdemo[edit]

(recording, warping)
doom -playdemo <lump>
Demo recordings are played using the -playdemo parameter. The lump variable is the name of a lump, excluding any file extension and without a file path. The parameter will play any one demo in the directory where the engine is executed, in the IWAD, or that is loaded using the -file parameter (as part of a PWAD or as a separate lump). In the latter cases the engine will state that it has not found the demo, but it will play it any way (as the message refers to not finding it in the directory the engine is launched from). If the specified lump does not exist, the engine exits to the command prompt with an error message.

-port[edit]

(multiplayer)
driver -port <port>
For IPX connections, this parameter defines the port number the Doom networking component will use between connected computers, instead of the default 666. It allows simultaneous games on a single network or a means to bypass blocked ports. If the parameter is used without a variable, or if the variable is a non-numerical character, the driver will attempt to use port 0.
For modem connections, -port will define the COM I/O port the Doom networking component uses to communicate with the modem. In this case the port variable allows either decimal or hexadecimal values.

-random[edit]

(gameplay, multiplayer)
strife1 -altdeath -random
When -altdeath mode is active, this parameter causes Strife to respawn items after a randomized amount of time, rather than a fixed interval as occurs normally. This parameter exists only in Strife.

-ravpic[edit]

(analysis)
heretic -ravpic
hexen -ravpic
This parameter replaces -devparm for Heretic and Hexen, and allows to take screen shots with the F1 key. It does not display the ticker which is instead enabled by cheat codes for these games, ticker for Heretic and rrettenmund for Hexen. This parameter does not exist for Doom.

-record[edit]

(recording, warping)
doom -record <demo>
The -record parameter tells the engine to generate a demo lump containing the actions of any participating players when it exits to the command prompt, displaying a message that the demo has been recorded, instead of the ENDOOM screen. The demo variable is the name of the lump to be created, excluding any file extension and optionally including a file path. If a file path is included, the demo will be recorded only if the target directory exists. If the directory in the optional path does not exist, the engine will state a demo has been recorded upon exiting the game, but no demo will be produced. If this parameter is not used along with a warping parameter, it will load the first level of the game. If it is applied without a demo name, it will try to read any following parameter as a name, or will have no effect if nothing follows.
When this parameter is applied the Q key will immediately exit the game, and since the demo format simplifies what tics are recorded for the player's movements, movement may be slightly less accurate. This is noticeable while using the mouse and, if a multiplayer game is attempted, it will not allow a recording peer to connect to one that is not recording (a consistency failure will occur).
When used with the -cdrom parameter it may be necessary to use a path-and-file name for the demo string, particularly if the game is launched from a CD, or else Doom will attempt to unsuccessfully write the demo lump onto the disc.

-recordfrom[edit]

(recording, warping)
doom -recordfrom <savegame> <demo>
This parameter was meant to record from a saved game, where savegame is generally a number from 0 to 5, and demo the name of the lump to be recorded. It was never fully implemented, as in versions 1.0 to the leaked "1.4" of Doom it warps to the start of the level the saved game takes place in, instead of loading the saved game, and does not record a demo. In later versions, it was removed.

-regdev[edit]

(configuration)
doom -regdev
With -regdev the id Software developers told the engine to read the WAD and lump data for the registered game (Doom) from specified directories.

-respawn[edit]

(gameplay, monsters)
doom -warp <map> -respawn
The -respawn parameter makes each monster return via respawning after a few seconds. Monster corpses are teleported away and replaced by a live monster teleporting in at the monster's initial starting location on the level. After respawned monsters remain active and move immediately if any opponent they were pursuing before death occurred still lives, but will be spawned in dormant state otherwise. The parameter requires warping (such as -episode) to be effective and was first introduced with version 1.2 of Doom.

-right[edit]

(output)
doom -net 3 -right
Used for three screen mode. Under Doom version 1.0 or 1.1, the -right parameter will cause a networked computer to display the area to the right of the player's normal view.

-shdev[edit]

(configuration)
doom -shdev
With -shdev the id Software developers told the engine to read the WAD and lump data for the shareware game (Doom: Knee-Deep in the Dead) from specified directories.

-skill[edit]

(gameplay, monsters, warping)
doom -skill <level>
Doom's difficulty skill level can be chosen during start-up by using the -skill parameter. The level variable stands for the particular skill level, where 1 is "I'm Too Young To Die", 2 is "Hey, Not Too Rough", 3 is "Hurt Me Plenty", 4 is "Ultra-Violence", and 5 is "Nightmare!". If a value of 0 (or any character of less value than a 1) is chosen, all things except for the player are absent from the game. This parameter will warp the player to the first level of the game if another warping parameter is not included in the command line.

-statcopy[edit]

(analysis)
statdriver
A statistics driver (statdriver stands for the name of a program, such as statdump) which invokes the Doom executable uses this parameter to link to it in order to collect the statistics that are presented on the game's tally screens.

-timedemo[edit]

(analysis, recording, warping)
doom -timedemo <lump>
The -timedemo parameter plays a demo without limiting graphics to 35 frames per second and upon exiting to the command prompt displays the number of screen frames drawn (gametics) and the time taken to play them (realtics), instead of the ENDOOM screen. The average screen frame rate on a level can be determined using the formula (gametics/realtics)*35=fps. If a demo recording spans more than one level, the resulting values will be incorrect, as the realtics will correspond only to the last level played.
Like during the built-in demo sequence normally played at the start of a game, this parameter makes most device input bring up the menu while the demo is playing, so pressing the Tab key to select automap mode or pressing Enter to display the last status message cannot be used. Some non-playing functions do still work, such as increasing or decreasing the screen size.

-timer[edit]

(multiplayer)
driver -deathmatch -timer <minutes>
With -timer users tell Doom to automatically exit levels to the intermission screen after a number of minutes, as if an exit switch had been activated. The parameter requires either -deathmatch or -altdeath to have any effect.

-turbo[edit]

(gameplay)
doom -turbo <percentage>
The -turbo parameter multiplies the player's movement speed by a percentage of 10 (the player moves ten times slower than usual) to 400 (the player moves four times faster than usual). When no value is specified, the player moves at twice normal speed, and any value exceeding 255 will cause the player to move backwards at twice the increased speed if the user presses the "run" key (key_speed). This command is present in Doom and Strife.
The parameter was added to the game by John Carmack in secret to help Shawn Green beat John Romero in deathmatch [1].

-warp[edit]

(warping)
doom -warp <map>
This parameter selects on what level the game will start, skipping title screen and the demo sequence. When playing Doom both an episode number from 1 to 3 and a map number from 1 to 9 must be specified, with a space in between, while in Doom II only a map number from 1 (or 01) to 32 is required. If no variable is placed after the parameter, the game starts with the title screen as usual. The -warp parameter first appears in the leaked "v1.4" version.

-wart[edit]

(configuration, warping)
doom -devparm -wart <map>
The -wart parameter is an earlier version of -warp. In versions above 1.2 it is superseded by -warp, but is still available instead as a development parameter that does not require -devparm and which attempts to load a WAD file named after level located in a hard-coded directory; 1 3 will try to load E1M3.wad, for example. If the WAD file is not found, the user is sent to the command prompt with a W_Reload error message. The unusual error message is because -wart loads files using the reload hack, prepending the tilde character (~) to filenames. This was a method used by id to allow simultaneous play-testing and editing of their levels, with changes being visible in near real-time.

-work[edit]

(gameplay, analysis)
strife1 -work
Enables Rogue Entertainment's hidden playtesting mode in Strife. God mode is automatically given to all players and pressing the inventory drop key (backspace by default) will toggle no-clipping state. This parameter exists only in Strife.

@[edit]

(configuration)
doom @<response>
This parameter tells the Doom engine to read from a response file, a text file that may store additional command line parameters. The file may have any name that is valid to the system, optionally with an extension. The parameters are typed as in the command line (-episode 2, for example), but one per line, where up to 100 lines may be used. The additional parameters may be disabled for later use by placing a vertical bar (the | character) between the prefixing dash (-) and the rest of the parameter name.

Environment variables[edit]

Main article: Environment variables

Unix port parameters[edit]

Main article: Unix port parameters

Source port parameters[edit]

Main article: Source port parameters

Sources[edit]

See also[edit]

External links[edit]