Editing List of command line parameters

From Eternity Wiki
Jump to navigationJump to search
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.

Latest revision Your text
Line 2: Line 2:


:''See also: [[Doom_Wiki:Command line arguments|Command line arguments]] on the [[Doom Wiki]]''
:''See also: [[Doom_Wiki:Command line arguments|Command line arguments]] on the [[Doom Wiki]]''
{{Backto|Eternity Engine}}


==Console==
==Console==
{|class="wikitable sortable"
* -exec <filename> : Executes the indicated file as a console script at game startup.
! Name
* -nocscload : Disables autoloaded console scripts for this play session only.
! Description
|-
||-exec ''filename''||Executes the indicated file as a console script at game startup. Expected file extension is ".csc".
|-
||-nocscload||Disables autoloaded console scripts for this play session only.
|}


==Debugging==
==Debugging==
{|class="wikitable sortable"
* -devparm : Enables FPS ticker and screenshots with F1 key (id development mode)
! Name
! Description
|-
||-devparm||Enables FPS ticker and screenshots with F1 key (id development mode)
|}


==DeHackEd/BEX==
==DeHackEd/BEX==
{|class="wikitable sortable"
* -bex <filename> ... : Alias for -deh.
! Name
* -bexout <filename> : Alias for -dehout.
! Description
* -deh <filename> ... : Loads one or more DeHackEd/BEX patch files.
|-
* -dehout <filename> : Enables verbose DeHackEd parser logging.
||-bex ''filename'' ...||Alias for -deh.
 
|-
||-bexout ''filename''||Alias for -dehout.
|-
||-deh ''filename'' ...||Loads one or more DeHackEd/BEX patch files.
|-
||-dehout ''filename''||Enables verbose DeHackEd parser logging.
|}
==EDF==
==EDF==
{|class="wikitable sortable"
* -edf <filename> : Specifies the root EDF file.
! Name
* -edfenables : Causes all gamemode's definitions to be enabled. For compatibility with older projects.
! Description
* -edfout : Enables verbose EDF logging to edfout##.txt
|-
* -edf-show-warnings : Displays verbose EDF warning information on the system console at startup.
||-edf ''filename''||Specifies the root EDF file.
|-
||-edfenables||Causes all gamemode's definitions to be enabled. For compatibility with older projects.
|-
||-edfout||Enables verbose EDF logging to edfout##.txt
|-
||-edf-show-warnings||Displays verbose EDF warning information on the system console at startup.
|}


==Gameplay==
==Gameplay==
{|class="wikitable sortable"
* -dog : Enables a single MBF helper dog.
! Name
* -dogs <n> : Enables from one to three MBF helper dogs, depending on the number specified.
! Description
* -episode <n> : Start a new game on episode n. For DOOM and Heretic only.
|-
* -fast : Enables Nightmare-mode monster speed in any difficulty.
||-dog||Enables a single MBF helper dog.
* -nomonsters : Removes all monsters except Lost Souls from all levels.
|-
* -respawn : Enables Nightmare-mode monster respawning in any difficulty.
||-dogs ''n''||Enables from one to three MBF helper dogs, depending on the number specified.
* -skill <n> : Sets skill to level 1 through 5.
|-
* -solo-net : Starts the game as single-player cooperative '''(SVN revision 1071+)'''
||-episode ''n''||Start a new game on episode n. For DOOM and Heretic only.
* -spechit <n> : Sets spechit emulation magic number to n. Spechit emulation must be enabled separately.
|-
* -turbo <n> : Sets player turbo factor to n.
||-fast||Enables Nightmare-mode monster speed in any difficulty.
* -warp <x> <y> : Warps to level x in DOOM 2, or ExMy for DOOM or Heretic.
|-
* -wart : Alias for -warp.
||-nomonsters||Removes all monsters except Lost Souls from all levels.
|-
||-respawn||Enables Nightmare-mode monster respawning in any difficulty.
|-
||-skill ''n''||Sets skill to level 1 through 5.
|-
||-solo-net||Starts the game as single-player cooperative '''(SVN revision 1071+)'''
|-
||-spechit ''n''||Sets spechit emulation magic number to n. Spechit emulation must be enabled separately.
|-
||-turbo ''n''||Sets player turbo factor to n.
|-
||-warp ''level''||Changes current level. In Doom 1 and Heretic, ''level'' is made of two numbers, the episode and the level number (e.g. <code>-warp 2 5</code>). In Doom 2, it's made of one number (e.g. <code>-warp 16</code>). You can also use the actual lump name if it's nonstandard (neither ExMy nor MAPxy), e.g. <code>-warp start</code>.
|-
||-wart||Alias for -warp.
|}


==Miscellaneous==
==Miscellaneous==
{|class="wikitable sortable"
* -affinity &lt;num&gt; : Enables processor affinity mask to stop SDL_mixer crashes on multicore processors. Expert setting only.
! Name
* -blockmap : Enables MBF blockmap builder for all levels.
! Description
* -cdrom : Game is running from a cd-rom. Data is written to C:\DOOMDATA. Does not work in Linux.
|-
* -grabmouse : Enables mouse input grabbing.
||-affinity ''num''||Enables processor affinity mask to stop SDL_mixer crashes on multicore processors. Expert setting only.
* -nograbmouse : Disables mouse input grabbing.
|-
* -numparticles &lt;n&gt; : Sets the static particle limit to n.
||-blockmap||Enables MBF blockmap builder for all levels.
* -speed &lt;n&gt; : Sets game speed to n% of normal speed. Range is 10 to 1000.
|-
* -statcopy : Does nothing. Enabled external statistics driver in Vanilla Doom.
||-grabmouse||Enables mouse input grabbing.
 
|-
||-nograbmouse||Disables mouse input grabbing.
|-
||-numparticles ''n''||Sets the static particle limit to n.
|-
||-speed ''n''||Sets game speed to n% of normal speed. Range is 10 to 1000.
|-
||-statcopy||Does nothing. Enabled external statistics driver in Vanilla Doom.
|}
==Multiplayer==
==Multiplayer==
{|class="wikitable sortable"
* -altdeath : Enables Deathmatch 2.0 (items respawn, weapons stay).
! Name
* -avg : Austin Virtual Gaming. Deathmatch levels end after 20 minutes.
! Description
* -deathmatch : Enables original Deathmatch mode.
|-
* -dmflags &lt;n&gt; : Sets the dmflags variable to value n.
||-altdeath||Enables Deathmatch 2.0 (items respawn, weapons stay).
* -dup
|-
* -extratic
||-avg||Austin Virtual Gaming. Deathmatch levels end after 20 minutes.
* -frags &lt;n&gt; : Sets fraglimit for Deathmatch. Levels end when the fraglimit is reached.
|-
* -net : Specifies the peer-to-peer player node to use and the IP addresses of the other players.
||-deathmatch||Enables original Deathmatch mode.
* -timer &lt;n&gt; : Sets timelimit for Deathmatch to n minutes.
|-
* -trideath : Enables SMMU Deathmatch 3.0 (barrels respawn, players drop backpacks [currently broken]).
||-dmflags ''n''||Sets the dmflags variable to value n.
 
|-
||-dup
|-
||-extratic
|-
||-frags ''n''||Sets fraglimit for Deathmatch. Levels end when the fraglimit is reached.
|-
||-net||Specifies the peer-to-peer player node to use and the IP addresses of the other players.
|-
||-port||Specify the alternative port.
|-
||-timer ''n''||Sets timelimit for Deathmatch to n minutes.
|-
||-trideath||Enables SMMU Deathmatch 3.0 (barrels respawn, players drop backpacks [currently broken]).
|}
===Multiplayer Example===
===Multiplayer Example===


Line 149: Line 82:


==Savegames==
==Savegames==
{|class="wikitable sortable"
* -loadgame &lt;n&gt; : Loads the savegame in slot n (0-7).
! Name
* -save &lt;path&gt; : Sets the directory from/to which savegames are loaded and saved.
! Description
 
|-
||-loadgame ''n''||Loads the savegame in slot n (0-7).
|-
||-save ''path''||Sets the directory from/to which savegames are loaded and saved.
|}
==Sound engine==
==Sound engine==
{|class="wikitable sortable"
* -nomusic : Disables the music engine.
! Name
* -nosfx : Disables the digital sound engine.
! Description
* -nosound : Disables sound and music.
|-
 
||-nomusic||Disables the music engine.
|-
||-nosfx||Disables the digital sound engine.
|-
||-nosound||Disables sound and music.
|-
||-randmusic||Each level will play a random music when started.
|}
==Video==
==Video==
{|class="wikitable sortable"
* -8in32 : Runs Eternity in a 32-bit video mode and crossblits the 8-bit framebuffer to the screen. Circumvents some SDL palette issues, but is slower.
! Name
* -directx : Windows only. Selects the DirectX 5.0 SDL video driver.
! Description
* -frame : Creates a main window with a frame (this is on by default for windowed modes and off for fullscreen).
|-
* -fullscreen : Toggles fullscreen mode.
||-8in32||Runs Eternity in a 32-bit video mode and crossblits the 8-bit framebuffer to the screen. Circumvents some SDL palette issues, but is slower.
* -gdi : Windows only. Selects the Win32 GDI SDL video driver.
|-
* -geom &lt;geomstring&gt; : Sets the video mode using a [[Geom string]].
||-directx||Windows only. Selects the DirectX 5.0 SDL video driver.
* -noblit : Disables blitting for benchmark testing.  
|-
* -nodraw : Disables all screen drawing.
||-frame||Creates a main window with a frame (this is on by default for windowed modes and off for fullscreen).
* -noframe : Opposite of -frame, creates a frameless window, if possible on the current platform.
|-
* -nofullscreen : Alias for -window.
||-fullscreen||Toggles fullscreen mode.
* -novsync : Disables waiting for vsync.
|-
* -vheight &lt;n&gt; : Sets screen height to n; current limits are 200 to 1600.
||-gdi||Windows only. Selects the Win32 GDI SDL video driver.
* -vsync : Enables waiting for vsync.
|-
* -vwidth &lt;n&gt; : Sets screen width to n; current limits are 320 to 2560.
||-geom ''geomstring''||Sets the video mode using a [[Geom string]].
* -window : Toggles windowed mode.
|-
 
||-hardware||Use hardware surface.
|-
||-noblit||Disables blitting for benchmark testing.  
|-
||-nodraw||Disables all screen drawing.
|-
||-noframe||Opposite of -frame, creates a frameless window, if possible on the current platform.
|-
||-nofullscreen||Alias for -window.
|-
||-novsync||Disables waiting for vsync.
|-
||-software||Use software surface.
|-
||-vheight ''n''||Sets screen height to n; current limits are 200 to 1600.
|-
||-vsync||Enables waiting for vsync.
|-
||-vwidth ''n''||Sets screen width to n; current limits are 320 to 2560.
|-
||-window||Toggles windowed mode.
|}
==Wads and other files==
==Wads and other files==
{|class="wikitable sortable"
* -base &lt;path&gt; : Sets the base path to the indicated path. The path must be a directory, not a file.
! Name
* -config &lt;filename&gt; : Game will use the given configuration file.
! Description
* -file &lt;filename&gt; ... : Loads one or more WAD or lump files. Lump file names must be 8 characters or less with .lmp extension added.
|-
* -game &lt;name&gt; : Causes Eternity to use the named game folder under its current base path.
||-base ''path''||Sets the base path to the indicated path. The path must be a directory, not a file. You can also use the [[ETERNITYBASE]] environment variable to store the desired base path.
* -gfs &lt;filename&gt; : Loads the given GFS script. GFS scripts may load WADs, DEH/BEX files, EDF, and console scripts.
|-
* -iwad &lt;filename&gt; : Specifies the given WAD file as the IWAD.
||-config ''filename''||Game will use the given configuration file.
* -noload : Disables autoloaded WADs and DEH/BEX patches during this play session only.
|-
* -nowadhacks : Disables automatic application of wad directory hacks to known broken WAD files, such as Gothic DM 2.
||-disk ''filename''||Loads a disk image file.
* -showhashes : Enables display of WAD header/directory SHA-1 hashes on the system console.
|-
 
||-file ''filename'' ...||Loads one or more WAD or lump files. Lump file names must be 8 characters or less with .lmp extension added.
|-
||-game ''name''||Causes Eternity to use the named game folder under its current base path.
|-
||-gfs ''filename''||Loads the given GFS script. GFS scripts may load WADs, DEH/BEX files, EDF, and console scripts.
|-
||-iwad ''filename''||Specifies the given WAD file as the IWAD.
|-
||-noload||Disables autoloaded WADs and DEH/BEX patches during this play session only.
|-
||-nowadhacks||Disables automatic application of wad directory hacks to known broken WAD files, such as Gothic DM 2.
|-
||-showhashes||Enables display of WAD header/directory SHA-1 hashes on the system console.
|-
||-user ''path''||Sets the user path to the indicated path. The path must be a directory, not a file. You can also use the [[ETERNITYUSER]] environment variable to store the desired user path.
|}
==Demos==
==Demos==
{|class="wikitable sortable"
* -donut &lt;height&gt; &lt;pic&gt; : Enables donut overflow emulation using the specified parameters.
! Name
* -fastdemo &lt;filename&gt; : Plays the given demo as fast as possible.
! Description
* -longtics : Enables v1.91 longtics demo recording when used with -vanilla.
|-
* -maxdemo &lt;n&gt; : Sets the initial size of the demo recording buffer. This is no longer a hard limit, and the buffer will expand if the given limit is exceeded.
||-demolog ''path''||Enables demo logging. See the [https://github.com/ioan-chera/EternityDemoTest EternityDemoTest] project for its target use.
* -play : Alias for -playdemo.
|-
* -playdemo &lt;filename&gt; : Plays the given demo.
||-donut ''height'' ''pic''||Enables donut overflow emulation using the specified parameters.
* -record &lt;filename&gt; : Records this play session as a demo named "filename".
|-
* -recorddemo : Alias for -record.
||-fastdemo ''filename''||Plays the given demo as fast as possible.
* -recordfrom  
|-
* -spechit &lt;number&gt; : Enables spechits overflow emulation with the given magic number.
||-longtics||Enables v1.91 longtics demo recording when used with -vanilla.
* -timedemo &lt;filename&gt; : Plays the given demo normally and reports FPS information at exit.
|-
* -vanilla : Enables recording of v1.9-compatible demo files.
||-maxdemo ''n''||Sets the initial size of the demo recording buffer. This is no longer a hard limit, and the buffer will expand if the given limit is exceeded.
|-
||-play||Alias for -playdemo.
|-
||-playdemo ''filename''||Plays the given demo.
|-
||-record ''filename''||Records this play session as a demo named "filename".
|-
||-recorddemo||Alias for -record.
|-
||-recordfrom
|-
||-recordfromto ''demo1'' ''demo2''||Allows continuing ''demo1'' after it ends or when the user presses the join ('''joindemo''' bound) key, the result getting saved as ''demo2''.
|-
||-spechit ''number''||Enables spechits overflow emulation with the given magic number.
|-
||-reject_pad_with_ff||in case of REJECT overflow, it pads excess bytes with 0xFF instead of 0x00. Use this parameter in case a Doom, Boom or MBF demo desyncs and you get the "REJECT lump too short to pad" warning message in the console.
|-
||-timedemo ''filename''||Plays the given demo normally and reports FPS information at exit.
|-
||-vanilla||Enables recording of v1.9-compatible demo files.
|}
Please note that all contributions to Eternity Wiki are considered to be released under the GNU Free Documentation License 1.2 (see Eternity Wiki:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!
Cancel Editing help (opens in new window)

Template used on this page: