DSDA-DOOM(6)

NAME
dsda-doom - DSDA-Doom, a version of Doom for Unix, Linux and Windows systems

SYNOPSIS
dsda-doom [options] [values|files]

DESCRIPTION
PrBoom is a version of the first-person shooter game Doom, originally released by iD software in 1993. It is based on Boom, a version of Doom adapted by TeamTNT (http://www.teamtnt.com/) for Dos. PrBoom uses the SDL library, meaning it can run on a variety of different systems, including Windows and Unix/X11.

PrBoom+ is a Doom source port developed from the original PrBoom project. It adds uncapped framerate, variable gamespeed, re-record, walkcam, chasecam, full mouselook, FOV and other features without loss of compatibility with original Doom. DSDA-Doom is a fork of PrBoom+ with extra tooling for demo recording and playback, with a focus on speedrunning.

GAME OPTIONS

-complevel lvl
    This sets the compatibility mode that DSDA-Doom runs in. If you need to change this, see README.compat.

-loadgame { 0,1,2,3,4,5,6,7 }
    Instructs DSDA-Doom to load the specified saved game immediately.

-warp { map | epis level }
    Tells DSDA-Doom to begin a new game immediately. For Doom 1 or The Ultimate Doom, you must specify the episode and level number to begin at (epis is 1 for Knee-Deep in the Dead, 2 for Shores of Hell, 3 for Inferno, 4 for Thy flesh Consumed; level is between 1 and 9). For Doom 2 or Final Doom, you must specify the map to begin at, which is between 1 and 32 (30 for German Doom 2).

-skill n
    Tells DSDA-Doom to begin the game at skill level n (1 for I'm Too Young To Die; 2 for Hey, Not Too Rough; 3 for Hurt Me Plenty; 4 for Ultra-Violent; 5 for Nightmare!).

-respawn
    Tells DSDA-Doom that monsters that die should respawn (come back to life) after a while. Not for the inexperienced.

-fast
    Tells DSDA-Doom to make all the monsters move and react faster. Not for the inexperienced.

-nomonsters
    Tells DSDA-Doom to include no monsters in the game.

-nocheats
    Disable applying cheats from dehacked files.

WAD OPTIONS

-iwad iwadname
    Specifies the location of the IWAD file, typically doom.wad or doom2.wad (or doom2f.wad). This tells DSDA-Doom where the main .wad file that came with the version of Doom that you own is.

-file wad1 ...
    Specifies a list of PWAD files to load in addition to the IWAD file. PWAD files modify the existing Doom game, by adding levels or new sounds or graphics. PWAD files are widely available for download; try http://www.doomworld.com/idgames/ for starters.

-deh deh_file
    Tells DSDA-Doom to load the dehacked patch deh_file.

DEMO (LMP) OPTIONS

-record demofile
    Instructs DSDA-Doom to begin recording a demo, to be stored in demofile.lmp. You should specify game options to specify which level and skill to record at.

-playdemo demofile
    Play the recorded demo demofile.lmp.

-timedemo demofile
    Play the recorded demo demofile.lmp, reporting information about the length of the demo (in gametics) afterwards.

-viddump filename
    Record a movie file, it requires external command-line encoding tools, oggenc2 (ogg vorbis audio encoder), x264 (h264 video encoder) and mkvmerge (mkv muxer). It is meant to be used with -timedemo, e.g. "dsda-doom -timedemo anydemo.lmp -viddump filename.mkv".

-fastdemo demofile
    Play the recorded demo demofile.lmp as fast as possible. Useful for benchmarking DSDA-Doom, as compared to other versions of Doom.

-ffmap num
    Fast forward the demo (play at max speed) until reaching map num (note that this takes just a number, not a map name, so so -ffmap 7 to go fast until MAP07 or ExM7).

-warp x
    Warps directly to the start of map x of a recording without rendering any of the play up to that point. Pressing Use (<Space> by default) during skipping shows the current frame.

-avidemo fileprefix
    Grabbing of the screenshots to frmXXXX.tga.

-skipsec x
    Skip X secs during viewing of the demo.

-warp x -skipsec y
    Will skip y seconds on level x.

-recordfromto n.lmp m
    Play back the demo n.lmp, allowing the user to take over the controls at a point of his choosing, and save the resulting demo as m.lmp.

-levelstat
    Outputs a text-file called levelstat.txt containing level-by-level information on times, kills, items and secrets.

-spechit xxx
    Provides a spechits magic number, overriding the program's default value.

-nomonsters
    For playback of -nomonsters demos recorded with Doom.exe 1.2.

-respawn
    For playback of -respawn demos recorded with Doom.exe 1.2.

-auto
    Enables the autoloading of wads according to the lmp file-name. See below for information.

  DEMOS OLD VERSIONS COMPATIBILITY PARAMETERS

-emulate prboom_ver
    For viewing old desynching PrBoom demos with all recording bugs from a particular version emulated. For example, "-emulate 2.2.6" would be used to play back a desynching demo recorded with PrBoom 2.2.6. This would be instead of using the various command-line options for each recording bug (see below) from that version.

-force_monster_avoid_hazards
    For viewing old desynching doom-compatible PrBoom demos recorded with "monster_avoid_hazards 1" in config.

-force_remove_slime_trails
    For viewing old desynching doom-compatible demos recorded with old versions of PrBoom (< 2.4.6) or PrBoom+ (< 2.4.6.1) that are affected by the "remove slime trails" incompatibility.

-reject_pad_with_ff
    For viewing old desynching doom-compatible demos recorded with old versions of PrBoom (including 2.2.5 and 2.2.6) that padded a short REJECT with ones instead of zeroes.

-force_truncated_sector_specials
    For emulation of old buggy behaviour whereby Boom's generalized effects could work instead of failing in a compatibility mode in the case of a bad action number.

-force_no_dropoff
    For emulation of MBF_compatibility behaviour in PrBoom 2.2.2 - 2.4.7, whereby things did not drop off ledges when they would have done in MBF.

-force_prboom_friction
    For emulation of old buggy behaviour whereby Boom's friction and bobbing code were not faithfully replicated.

-force_force_boom_brainawake
    For emulation of Boom's behaviour with respect to the Monster Spawner, which differed slightly from that of "vanilla" Doom.

-force_lxdoom_demo_compatibility
    For emulation of all bugs in demo compatibility mode in lxdoom.

-boom_deh_parser
    Forces the Boom DEH parser.

-setmem system
    The desynch in fez1-924.lmp @ fez1.wad is gone, but you still need to add "-setmem dosbox" or "-setmem dos71" command line parameter, because the default "dos622" memory layout causes a desynch.

-deathmatch
    No longer used. Tells DSDA-Doom to begin a deathmatch game, but this is overridden by the server's settings. Only works for single play (!).

-altdeath
    Similar to -deathmatch, but implies a different set of rules for the deathmatch game. No longer used (specified by the server).

-timer mins
    No longer used. Specifies that levels will end after mins minutes of play if the level is still being played, but is overridden by the server in a netgame. Not really useful for single play.

-avg
    Equivalent to -timer 20.

-solo-net
    Used to run a single-player network game, without a network game server. This enables network game items & options for an otherwise single-player game; some demos are recorded like this.

VIDEO OPTIONS

-width w
    Specifies the width of the DSDA-Doom window, in pixels. Default is 320, the width must be greater than 320.

-height h
    Specifies the height of the DSDA-Doom window, in pixels. Default is 200, the height must be greater than 200.

-viewangle n
    Causes the player view to be rotated by a given offset (specified in 45degree increments, in the range 0..7) from the way the player is facing.

-vidmode gl
    Use the OpenGL video mode. The default is to use the software video mode.

-fullscreen, -nofullscreen
    These options toggle fullscreen mode. The default is fullscreen.

-window, -nowindow
    This pair of options also toggle fullscreen mode. They only take effect for this DSDA-Doom+ session and do not alter your configuration file.

-noaccel
    For DSDA-Doom, this prevents it using the MITShm server extension for passing the screen data to the X server. This option may be required if the X server is not local. For lsdoom, this tells lsdoom not to use the accelerated graphics functions that SVGALib provides even when they are supported for your video card (normally this is autodetected).

-1, -2, -3
    Specifies the scale factor by which to enlarge the window. The default, -1, displays the normal 320x200 pixel Doom screen (or whatever size is specified by the -width and -height parameters or in the config file for DSDA-Doom). If this window is too small, try using -2 or -3 to enlarge the window.

-nodraw
    Suppress all graphical display. Only for debugging & demo testing.

-aspect NxM
    For using a different aspect ratio; e.g. -aspect 5x4, -aspect 8x5 or -aspect 2x1.

-videodriver name
    For setting up the videodriver name that SDL will use (See SDL documentation). "-videodriver default" can be used to force SDL behaviour by default.

-resetgamma
    Restores the original gamma after a crash.

-geom NxM
    Basic syntax, for temporarily using a particular resolution without saving this in the cfg; e.g. -geom 1280x1024.

-geom WidthxHeight[w|f]
    Advanced syntax, w - windowed, f - fullscreen. Examples: -geom 320x200f, -geom 640x480w.

I/O OPTIONS

-nosound
    Disables all sound effects and in-game music. This prevents the sound server loading, which lets the game run a little faster.

-nosfx
    Disables sound effects during the game. This does not stop the sound server loading, however, so for best performance use -nosound.

-nomusic
    Disables playing of music in the game.

-nojoy
    Disables joystick support.

-nomouse
    Prevents the mouse being grabbed by the DSDA-Doom window.

-shorttics
    Forces the same mouse behaviour as when recording (i.e. the converse of "-longtics").

CONFIGURATION

-config myconf
    Loads an alternative configuration file, named myconf. The default is dsda-doom.cfg(5), taken from the same directory as DSDA-Doom was run from.

-save savedir
    Causes DSDA-Doom to save games in the directory specified by savedir instead of ~/.dsda-doom/.

-shotdir shotdir
    Causes DSDA-Doom to save screenshots in shotdir instead of the current directory.

DEBUGGING/PROFILING OPTIONS

-devparm
    Development mode. Mostly redundant these days, but it does force non-lazy generation of texture lookups which can be useful for level authors debugging PWADs.

-debugfile debug_file
    Causes some debugging information, mainly network info, to be written to the named file as DSDA-Doom runs.

-nodrawers
    Causes no rendering to be done. The only conceivable use of this is (a) a multiplayer server (b) to test the speed of the other routines in the program, when combined with -timedemo.

-noblit
    Causes no copying to the screen from the rendering buffer to be performed. The only conceivable use of this is (a) a multiplayer server (b) to test the speed of the other routines in the program, when combined with -timedemo.

-bexout bexdbg
    Causes diagnostics related to bex and dehacked file processing to be written to the names file.

-blockmap
    Use if dsda-doom reports a buggy blockmap.

SEE ALSO
dsda-doom.cfg(5), dsda-doom-game-server(6)

For more information, see the README.md that came with DSDA-Doom, the Boom documentation, and your original Doom documentation.

Doom is a registered trademark of id software (http://www.idsoftware.com/).

AUTHORS
See the file AUTHORS included with the DSDA-Doom distribution.