Doom Legacy 1.46 Console Reference

Last updated 2016-09-20

Contents

  1. Console basics
    1. Console usage
    2. Console input
    3. Commands and variables
    4. Configuration files
    5. Autoexec.cfg
    6. Script files
  2. Console commands and variables
    1. Basic commands
    2. Console setup
    3. Player setup
    4. Player controls
    5. Game options
    6. Game commands
    7. Net options
    8. Video options
    9. Sound options

Make sure you read this, you will discover a lot of goodies available in Legacy! Be a Doom power user!
Skip to section 2 and browse through the list of commands if you're in a hurry!

Console basics

Console usage

With Doom Legacy's console, you will be able to change most of the game parameters from within the game, and customise it to your preferences. The console is simply a command prompt, where you can enter commands and change the values of game variables. Since the first game console we know of was from id Software's game Quake, we have been inspired by it and have tried to implement the same functionality for the benefit of Quake/Doom fans.

To open the console, press the console key. The default console key is the accent key located just below ESC. You can change your console key using the Setup Controls menu, or edit it in the config.cfg file. To exit the console, either press the console key again, or press ESC which will close the console, and bring up the menu.

The console displays all messages from the game. You can go back in the messages with key PAGE UP, and go down with the key PAGE DOWN. Press the key HOME to jump to the oldest message in the console text buffer, and key END to jump to the last output message (the most recent).

The last lines of the console text buffer are displayed at the top of the screen, when the console is off. That is, you can see 5 lines of messages instead of only 1 in the original Doom. You can change the duration of display of the messages with the console variable con_hudtime, see the commands section for more.

Console input

While the console is on, it accepts typed-in commands. BACKSPACE erases the last input character, and ENTER executes the command. For convenience, you have a history of the last 32 commands entered. Press UP ARROW to go back in the commands history, DOWN ARROW to go forward.

Another very useful key is TAB: it completes a partially entered command or variable name. This is a very good way to see the existing commands: just enter any letter, then press TAB several times to see what commands are available.

The variables to customize the console itself usually start with "con_", thus typing "con" and pressing the TAB key several times will display the following console variables: con_height, con_speed, con_hudtime, con_backpic...

You can also press SHIFT-TAB, which will complete the command line, but in reverse order.

Commands and variables

Basically, a command does not have a value, and is not saved to the configuration file. It may take zero or more parameters. A variable always has an associated value, for example the variable name holds your name as a player.

Entering a command without any parameters will usually tell you the command syntax.

> map Usage: map <number|name> [<entrypoint>]: warp players to a map.

Entering a variable name alone will tell you the current value of the variable.

> name "name" is "flynn"

To set the value of a variable, give the new value after the variable name. For example, to change your name to "dj fab", type

> name "dj fab" flynn renamed to dj fab

There are four types of variables/command parameters: strings, integers, floats (actually 16.16 fixed point numbers) and booleans.

String values containing spaces or certain other special characters must be quoted using double quotes, as we saw in the previous example. Inside a quoted string you can use the following C-style backslash escape sequences:

Escape sequenceResulting character
\\literal backslash
\"double quote (does not end the string!)
\ttab
\nnewline

Example:

> echo "this string contains \"escaped\" special chars such as \\,\n\ttab and newline" this string contains "escaped" special chars such as \, tab and newline

Boolean variables (true/false, yes/no) use 0 to denote false. Any nonzero value means true.

Configuration files

Most variables are automatically saved to the default configuration file config.cfg. Like in the original Doom, the -config parameter will set explicitly the configuration file to use. Thus, you can have default settings for different persons, using different configuration files. While the configuration files support any commands, and are executed like a script, you should not edit them, because they are always overwritten when the game exits.

Some variables, like gravity, are not saved. They are restored to initial settings everytime DoomLegacy is started. These might be changed for a specific game, but would not want to be saved, as that would affect all games that follow. See Autoexec.cfg and exec files for setting up DoomLegacy for a specific game.

Autoexec.cfg

The autoexec.cfg file is a text 'script' file which, if found, is automatically executed at the game startup. You can edit autoexec.cfg to set the values of those variables that are not automatically saved to config.cfg. You can also add commands that will be executed one after another, just like a script.

Comments start with //. Each line of the autoexec.cfg file is like a line that you would have typed at the console. Here are some examples:

This sample 'autoexec.cfg' will warp you to map01 as soon as the game is loaded:

// always start with map01, without waiting at the menu
map map01
echo "welcome to map 01" //useless comment

Another example, here we set the variables that are not saved to the config.cfg, because they are not considered standard parameters:

// set my preferred weird game mode
bloodtime 5 // blood lasts 5 seconds
fastmonsters 1
teamdamage 1
echo "bigjim's weird mode active"

In the last example, each time you start the game, it will set the variables like bloodtime that are not normally saved to config.cfg. Just look at config.cfg to find out which variables are saved.

Script files

config.cfg and autoexec.cfg are script files. It means they contain commands and variables that are executed in sequence. You can create any number of script files, and execute them from the console using the exec command.

For example, to start a script named blood.cfg just enter

> exec blood.cfg

Console commands and variables

This chapter describes all console commands and variables in Doom Legacy. Many console variables can also be modified through the menu. You will need to use the console only if you want to customise the game more to your needs.

Basic commands

Here are the basic commands for script execution. They have the same usage and functionality as in Quake. You can use a semicolon to separate several commands in the same line.

commanddefinition
alias <aliasname> <command>

Define an alias. When you type <aliasname>, it will be like if you had entered <command>. Let's have an example:

> alias silence "soundvolume 0; musicvolume 0"

When you will type "silence", it will execute the corresponding command. In this example, we have given two commands as one, inside " ", and using the semicolon as a separator for commands.

echo <text> Just echoes (prints) the text to console.
exec <filename>

Execute a script file. A script file is just a text file containing a sequence of commands or variables. Script files usually have a .cfg extension. Example:

> exec autoexec.cfg

will execute all the commands in autoexec.cfg

help [<variable>] Shows a list of all the console commands and variables.
If given a variable name, shows detailed info on that variable.
toggle <variable> [<value>]

Without the <value> parameter this toggles a variable, i.e. changes it to the next possible value. With the <value> parameter it adds <value> to the variable. This command is very useful for use with bind. Example:

bind ">" "toggle gr_fogdensity"
bind "<" "toggle gr_fogdensity -1"

so you can modify fogdensity without going into the console or menu!

wait [<ticks>]

Wait a given amount of time before the next command is executed. The unit is 1/35 seconds. Example: this will wait 5 seconds, then display "ok!".

wait 175; echo "ok!"
bind <keyname> <command>

Bind commands to a key. Each time you press the key, the commands will be executed. Example:

> bind s screenshot

Now each time you press the s key the game will save a screenshot.

cls Clear the console text buffer.

Console setup

These variables control the look and feel of the console.

variabletypedefinition
con_backpicbool 0: use a translucent LCD-like console background.
1: use an opaque console background picture, like in Quake.
con_heightint How many percent of the total screen height the console will use. E.g. con_height 50 (the default) will use half the screen height for the console.
con_speedint The speed (in pixels/tic) at which the console comes down or moves out of the screen when you press the console toggle key.
con_hudtimeint The number of seconds messages stay on the top of the screen. They are 5 message lines that scroll as soon as new messages arrive. E.g. con_hudtime 5, which is the default, will make the messages stay for 5 seconds before disappearing. Set this to 0, and you will never see any messages outside the console (HUD means heads-up display).
showmessages
<0-5>
int Limits the messages that are shown on the HUD during gameplay.
  • Off: never show any messages on the screen.
  • Minimal: Important play messages are shown, like you got the BFG. Common messages, like those about ammo, are not shown.
  • Play: The standard Play messages are shown, but verbose and diagnostic messages are not (default).
  • Verbose: Verbose messages too.
  • Debug: Debug and Verbose messages too.
  • Dev: Development. All messages are shown.
There is also a control for this in the Options menu.
darkback
<0-2>
int The console background is darkened to make the text easier to read. This controls how dark it gets.
  • Half: Half darkness (40%).
  • Med: Middle darkness (25%).
  • Dark: Darkest (17%).
There is also a control for this in the Video menu.
con_fontsize <1-5>int The console fontsize.
  • Small: Smallest font.
  • Med2:
  • Med3:
  • Med4:
  • Large: Largest font.
There is also a control for this in the Video menu.
msg_fontsize <1-5>int The HUD message fontsize.
  • Small: Smallest font.
  • Med2:
  • Med3:
  • Med4:
  • Large: Largest font.
There is also a control for this in the Video menu.

Player setup

These variables control your player avatar's appearance and your game preferences. The splitscreenplayer has similar variables, but with the number 2 appended to the variable name, e.g. "color2 red" turns the splitscreenplayer's avatar red.

There is a control in the Options menu.
variabletypedefinition
splitscreenbool Enable/disable the splitscreen. If necessary, this spawns a secondary local player, called the splitscreenplayer.
namestring Enter your name as a player, for network games. Your name will be seen when you send a message (chat key), and is displayed in the deathmatch rankings. Use "" if the name contains spaces, e.g. name "dj fabbe"
color
<0 - 10>
int Choose your avatar's color.
  • 0: Green
  • 1: Gray
  • 2: Brown
  • 3: Red
  • 4: Light Gray
  • 5: Light Brown
  • 6: Light Red
  • 7: Light Blue
  • 8: Blue
  • 9: Yellow
  • 10: Beige
skinstring Change your skin, provided some skins are loaded (use the commandline option -file to add skins wads. The default marine skin name is "marine".
autoaimbool The original Doom used autoaiming in the vertical direction, and a small aim adjustment in the horizontal. Now that you can freely aim up and down with the freelook, you can play like a pro and set autoaim off.
NETWORK NOTE: in a multiplayer game, the server can force the autoaim off for all players with the command allowautoaim.
originalweaponswitchbool Choose whether to use the original weapon change method (1), or the new preferred weapons order (0), see weaponpref for more.
With the original weapon switch, whenever you pick up a new weapon it becomes the active one, even if it is not as powerful as the one you are currently using. That can be sometimes very annoying, especially in fast deathmatches.
weaponprefstring The preferred weapons order.
This works only if you have set originalweaponswitch to 0.

You give a priority to each of the weapons, with a number digit from 0 to 9. Several weapons can have the same priority. When you pick up a weapon that you don't already have, you will switch to that weapon IF AND ONLY IF that weapon's priority is greater that the one you are carrying. If you already had the weapon, you will pickup the ammo as usual, without changing weapon. The command is given a string of priority values, one for each weapon, in the following order:

Fist, Chainsaw, Pistol, Shotgun, Super Shotgun, Chaingun, Rocket Launcher, Plasma Rifle, BFG.

Thus 'weaponpref "021485763"' means that the super shotgun has the highest priority (8), while the fist is lowest priority (0). After the super shotgun, in decreasing priority you have the rocket launcher (7), plasma gun (6), chaingun (5), shotgun (4), BFG (3), chainsaw (2) and pistol (1).

Let's have another interesting example: 'weaponpref "333333333"'

Since all weapons have the same priority in this last example, you will NEVER change weapon automatically, because no weapon has a priority higher than any other one. You might consider this the manual weapon change.

crosshair
<0 - 3>
int Choose the type of aiming point (crosshair) that appears on the screen.
  • Off: No crosshair
  • Cross: Large white + with an open center, the largest crosshair.
  • Angle: Small vertical and horizontal green lines. The aiming point is where the two lines meet.
  • Point: Red aiming dot, like a laser pointer.

Player controls

These variables control the way the game handles the players' input. The splitscreenplayer has similar variables, but with the number 2 appended to the variable name.

variabletypedefinition
autorunbool Set this to 1 to invert the run key. You will always be running, EXCEPT when you push the run key.
automlookbool

You can use the "freelook" (ability to look up and down) in two modes: permanent or temporary.

Setting this variable to 1 will make the freelook permanent.

When automlook is 0, you will need to hold the freelook key down while moving the mouse up and down. When releasing the key, the view will always re-center. This is useful if you keep firing rockets at your feet.

use_mousebool Setting use_mouse to 0 will disable the mouse. The next time you start the game, the mouse won't be detected. Set use_mouse to 1 to search for a mouse, and activate it. There is also a control for this in the Mouse menu.
invertmousebool Set invertmouse to 1 to invert the mouse y (up and down) axis. This is for freelook only, you will look up, when moving the mouse down (backward), and look down when moving mouse forward. There is also a control for this in the Mouse menu.
mousemovebool Enable/disable mouse y-axis for forward/backward movement. There is also a control for this in the Mouse menu.
mousesensx
mousesensy
int Sets the mouse sensitivity in the x and y directions. There is also a control for this in the Mouse menu.

These input variables are common to both local players.

variabletypedefinition
controlperkey <1|2>int When set to 2 (several) you can bind more than one control to a key. Otherwise binding a control to a key will remove the key's other assignations.
mouse2port <1|2|3|4>int Choose the port number of the secondary mouse for the splitscreenplayer between COM1 to COM4.
mousemotionenum Values Absolute | Relative. SDL port only.
Absolute: Uses the original mouse interface with local difference calculations. It should work for any SDL port.
Relative: Uses the newer relative motion interface, which may not work on some SDL library ports. It is reported to work with Linux and Windows. Does not affect mouse2. There is also a control for this in the Mouse menu.
grabinputbool Sets the SDL grabinput attribute. This keeps the mouse in the window. It also disables most of any window manager's keyboard and mouse functions, so DoomLegacy gets all combination events. Pause releases grabinput to let the mouse be used outside of DoomLegacy. There is also a control for this in the Mouse menu.

The game controls can be defined using the setcontrol command.

commanddefinition
setcontrol <control> <key1> [<key2>]

Binds a key/joystick button/mouse button to a game control (forward, fire, use etc.). The second keyname is optional. You can set it, and have two keys attached to one game control, e.g. have both UP ARROW and MOUSE2 mean forward.

If a key does not have a useful name, it uses a name of the form 'KEYxxx' where xxx is the key code. To learn the names of the keys, look for them at the Setup Controls menu.

The controls are forward, backward, strafe, straferight, strafeleft, speed, turnleft, turnright, fire, use, lookup, lookdown, centerview, mouseaiming, weapon1, weapon2, ..., weapon8, talkkey, scores, jump, console.

Example:
> setcontrol forward "keypad 8" "up arrow"
setcontrol2 <control> <key1> [<key2>] Same as setcontrol but for splitscreenplayer.
bindjoyaxis [<joynum> <axisnum> [<playernum> <control> <scale>]]
Lists, releases or creates joystick axis bindings.

Game options

Using these variables you can change may aspects of the game itself. For obvious reasons, in a netgame only the server can change them.

variabletypedefinition
deathmatch <0|1|2|3>int Set the game type
0: coop
1: dm, placed weapons respawn immediately
2: dm, items respawn
3: dm, items respawn, placed weapons respawn immediately
teamplay <0|1|2>int You can change the deathmatch mode while in a multiplayer game.
0: no teams, usual free-for-all deathmatch.
1: teamplay, use color to identify teams (players of the same color will be in the same team), the team names will be like "red team" or "yellow team".
2: teamskin, using skins to identify teams (players who use the same skin will be in the same team), the team names will show as "leprechaun team" or "terminator team", according to the name of the skin.
teamdamagebool Decide whether members of the same team can hurt one another or not. Real players always have teamdamage on.
hiddenplayersbool Are the other players visible in the automap? Also determines if you can switch to their POV using the spy mode. Usually enabled in deathmatch.
fraglimitint When the limit is reached, the level exited and game goes to intermission. Use 0 to disable.
timelimitint After the given number of minutes, the level is exited and game goes to intermission. Use 0 to disable.
gravityfloat Sets the acceleration of gravity in the game. The default gravity is 1.
nomonstersbool Set to 1 if you want no monsters to spoil your gaming experience. Often used in deathmatch.
fastmonstersbool Choose if monster are "fast" like with the original -fastparm
solidcorpsebool Setting solidcorpse to 1 makes the dead corpses (monsters/marines) solid. The corpses thus stack one on top of another, and you walk over them. Sometimes you can even reach ledges where you couldn't get before by climbing on corpses!
allowjumpbool Choose whether jump is allowed or not. Those of you who come from the planet NoJump or have a limited sensory system and couldn't survive a jump in the 3rd axis of our world can disable the jump in single player too.
NOTE: Jumping is considered cheating in maps not designed with it in mind, especially in speedrunning.
allowrocketjumpbool Enable/disable emulation of the Quake1 bug known as "Rocket Jump".
allowautoaimbool Enable/disable autoaiming for all players... make sure everyone is ok before getting your friends angry.
allowfreelookbool Enable/disable looking up and down for all players in the game.
respawnitembool Choose whether items respawn or not. respawnitem 0 is like the old deathmatch. deathmatch 2 automatically sets it to 1.

NOTE: it is considered cheating to allow respawning of items when in single player mode ! :)

respawnitemtimeint Set the respawn item time in seconds. The time between the moment you pick up the item, and the moment it reappears.

The default is 30 seconds, from the original Doom.

respawnmonstersbool Choose if monsters can respawn. respawnmonsters 1 is like the -respawn command-line option of the original Doom.
respawnmonsterstimeint Choose the time of respawn for the monsters, in seconds.

The default is 12, from the original Doom.

monsterbehaviorstring Select the mode of monster infighting.
  • Normal: Monsters take damage from missiles, but do not retaliate.
  • Coop: Monsters cooperate by default. DEH settings in the wad can override this. This is the same setting as the -coopmonsters command line switch.
  • Infight: Monsters retaliate by default. DEH settings in the wad can override this. This is the same setting as the -infight command line switch.
  • Force Coop: Monsters cooperate. This overrides DEH infight settings.
  • Force Infight: Monsters retailiate and damage each other. This overrides DEH infight settings.
Default is Normal.
monsterfrictionstring Select the mode of monster friction.
  • None: Monsters ignore friction, as in vanilla Doom and Heretic.
  • MBF: Monster friction from MBF, where ice gave momentum to monsters. Has momentum effects on transition between ice and other sectors.
  • Momentum: Monsters have momentum all the time. Friction is tuned to match the player friction.
Default is Momentum.
playdemospeedint Number of frames to skip for each frame rendered when playing back demos. Default is 0.
voodoo_modestring Sets the voodoo doll behavior. A voodoo doll is an accident of the original doom code that occurs when a wad has extra player starts. The voodoo dolls that are spawned at the extra starts look like players, but do not move on their own. When they get shot or damaged, a player gets damaged too. Many wads use voodoo dolls for automated actions because they can trip linedefs.
  • Vanilla: No enhancements. Allows zombies and walking dead players.
  • Multispawn: The target of damage is determined by the wad spawn type.
  • Target: DoomLegacy will attempt to determine the player that triggered the voodoo doll, and will put the damage on them. There are still many ways the wrong player can get hurt (which is wad related), some as simple as one player tripping the death-trap, right before another pushes the switch to turn it off (if timed right, the player at the switch dies instead).
  • Auto: If the wad has multiple player voodoo spawning, then it switches to Multispawn, otherwise it will be Target.
Default is Auto.
instadeathstring Used to mitigate the effects of voodoo doll teleport frag. For coop and deathmatch play, a setting other than Die is suggested.
The telefrag kills the player instantly, thus the name "instadeath". Used in unusual wad traps to kill the player, like when they touch something dangerous. Vanilla voodoo doll behavior has the voodoo doll instadeath always killing the same player, and it does not matter who walked into the death-trap. In most wads the victim is always player1.
  • Die: Telefrag death of player.
  • Damage: Player takes 20 damage, stunned, and gets thrown back.
  • Zap: Player takes 5 damage, stunned longer, and gets thrown back.
Default is Die.

Game commands

Here we describe the commands that can be used during the game.

commanddefinition
addfile <wadfile.wad> Add a WAD file to the list of resource files used. Like the -file commandline option, but works in runtime.
map <mapname[.wad]> [-skill <1-5>] [-monsters <0|1>] [-noresetplayers] Warps all the players to a new map.
restartlevel Restart the current map.
exitlevel Exit current map and go to the intermission screen.
pause Pauses/unpauses the game (or requests a pause from the server).
save <slot_number> <description> Save the game in the given slot, with chosen description.
load <slot_number> Loads a previously saved game.
exitgame Closes the current game, goes back to the intro loop.
quit Quits the game without further confirmation.
saveconfig <filename> Save the current config in the specified file. This is always done when you exit Legacy.
loadconfig <filename> Load a config file like at the begining of legacy. For the pro: this is a simple exec command with ".cfg" default.
changeconfig <filename> Do a 'savegame currentconfigfilename', then a 'loadconfig filename'.
screenshot Take a screenshot (like the key F1 in devparm mode).
kill me | <playername | playernum> Kills players. Everyone can suicide, only the server can kill others.
playdemo <demoname[.lmp]> Start demo playback. The demos are either lumps in a WAD or external files. If the demo name ends with .lmp, read it from an external file of that name.
stopdemo Stop the currently playing demo.
timedemo <demoname[.lmp]> Time a demo.
turbo <boost> Set the player movement speed to boost/100 times the original value. Boost needs to lie between 10 and 255.
noclip Enables/disables clipping for the console player. Like the cheat code idclip. When noclip is on, the player can walk through walls and instantly move to the top of any platform, but cannot pick up items. This is useful for exploring, but is considered a cheat when used during game play.
god God mode. Just like the cheat iddqd.
gimme health | ammo | weapons | armor | keys | map | fullmap | chainsaw | shotgun | supershotgun | chaingun | rocket | plasma | bfg | berserk Gives the attributes or items to the player. Can have one or more cheat names on one gimme command, such as "gimme health armor keys".
cd on | off | remap | reset | open | info | play <track> | loop <track> | stop | pause | resume Play audio CDs. Most of the subcommand should be self-explanatory.

reset: Check for a new cd, read the track info. Use after changing the CD.
info: List the tracks on the CD. The track being played is printed in white.
remap: Remap CD tracks. Normally, the game plays the track xx in the map MAPxx, and ExMy corresponds to track number 9*x+y. This command is useful to adapt your favorite cd music to Doom's levels, let's have an example:

cd remap 5 3 1 4 2

At map 1, the game will play track 5 etc. The same track number can be also be repeated.

Network/multiplayer commands

commanddefinition
connect <server_ip | server_address> | any | self Connects to a server to play a netgame. "connect any" starts searching for servers and connects to the first one it finds.
disconnect Disconnects from the server.
kick <playername | playernum> One of the rare pleasures of being the server: Kick somebody out of your game!
addbot Adds a bot (AI player) to the game. You can remove bots from the game using kick.
say <message> Sends a message to all players.
sayto <playername|playernum> <message> Sends a message to a specified player.
sayteam <message> Sends a message to your own team.
chatmacro <0-9> <message> This very useful command allows to change the chat messages at any time during the game. They are saved in the configfile too! You can now quickly setup some circumstance messages at the start of a game. Press the chat key, then ALT plus a number key from 0 to 9 to send one of the chat messages. Well, just like it has always been in Doom.

Informative and debugging commands.

commanddefinition
version Shows the game version and build date.
gameinfo Prints information about the current game.
mapinfo Prints information about the current map.
playerinfo Prints information about the players.
meminfo Show the amount of heap, virtual and physical memory available. The heap is the memory allocated for the game, and you can change it using the -mb command line parameter.
frags Shows the frags table, like in the original Doom intermission. It shows the frags count for each player, against each other player.
teamfrags Shows the frags table for teams.
fs_dumpscript <scriptnum> Prints the given FS script on the console.
fs_runscript <scriptnum> Runs the given FS script.
fs_running Lists all the currently running FS scripts.

Net options

variabletypedefinition
sv_namestring This is the name of your server. It is displayed on clients' screens when they are searching for servers.
sv_publicbool If true, your server will announce itself to the master server so that it will be visible outside the local network.
server1
server2
server3
string The IP addresses (server1, server2, server3) that will be checked to find the DoomLegacy server. The server should have an IP address such as "192.168.1.1", or a network broadcast address such as "192.168.1.255". For a home network, addresses should be 192.168.nn.xx, where all your computers have the same nn, but different xx (nn=1..254, xx=1..254). Do not use addresses such as 255.255.nn.xx as those do not work. Default is "192.168.1.255".
These can be set in the Connect menu.
wait_players
<0 - 32>
int Wait for this number of players to join before starting the game. This can be specified in the network menu when starting the server.
wait_timeout
<0 - 120>
int Wait timeout in seconds. When the timeout expires, start the game even if there are fewer players than specified by wait_players. This can be specified in the network menu when starting the server.
sv_allownewplayersbool Allows or disallows the joining of new players to the game.
sv_maxplayersint Maximum allowed number of players in the game. Default is 32 so don't worry about it.
masterserverstring The masterserver address used during server search and when registering your server.
netstatbool Print network statistics on the HUD?

Video options

These variables control many visual aspects of the game.
The GAMMA_FUNCS code replaces the original 5 level gamma with other controls. The GAMMA_FUNCS code is now standard (no longer optional).

variabletypedefinition
fullscreenbool Choose between fullscreen and windowed mode.
scr_depth
<8|16|24|32>
int Screen color depth in bits.
scr_widthint Screen width in pixels.
scr_heightint Screen height in pixels.
gammafunc
<0 - 3>
int Select the gamma curve function for controlling display brightness.
The function selected enables appropriate control sliders.
Gamma is the brightness encoding curve for CRT displays.
  • Gamma: Gamma adjustment (-12 - +12).
  • Gamma_black: Gamma and a black level control (-12 - +12).
  • Gamma_full: Gamma, black level, and brightness controls (-12 - +12).
  • Linear: Linear segment approximation, useful for some LCD displays.
There is a control for this in the Video menu.
gamma
<-12 - 12>
int Fine gamma control for all gamma functions (slider index, not the actual GAMMA value). Default is 0, which is no-correction (GAMMA=1.0).
Original gamma settings are at (0, -3, -6, -9, -12).
See Gamma table in User Reference Manual.
black
<-12 - 12>
int Fine black level control for Gamma_black and Gamma_bright_black functions. Adjusts the black end of the curve to get even blacks and grays in dark rooms.
Normal is 0.
bright
<-12 - 12>
int Fine brightness control for Gamma_bright_black function. Adjusts the bright end of the curve to get evenness in bright lit rooms.
Normal is 0.
viewsize
<3 - 11>
int Choose the size of the game viewport.
'3' is the smallest view window.
'10' is the full viewsize with the status bar.
'11' is the full viewsize without the status bar.
viewheight
<16 - 56>
int Set the height of the viewpoint (the height of the eyes above the floor). The normal value for the Doom marine is 41. We have limited the range into acceptable values, to prevent cheating.
chasecambool Enable/disable the chasecam.
cam_heightfloat Sets the chasecam height.
cam_distfloat Sets the distance between the chasecam and the player.
cam_speedfloat Sets the speed of the chasecam.
bloodtimeint Choose how many seconds blood will stay on the floor. In the original Doom the blood stayed no more than 1 second. This can be fun for deathmatches, setting 'bloodtime' to '60', for example, will make the blood drops stay 1 minute on the floor before disappearing. Useful for tracking down your prey :)
translucencybool Enable/disable translucent sprites.
screenlink
<0|1|2>
int Change the screen link between
  • 0: None: none
  • 1: Crossfade: crossfade (it was in the original code, we just enabled it).
  • 2: Melt: normal melting
This is the Screens Link control in the Effects menu.
pickupflash
<0 - 3>
int Change the screen link between
  • Off: no pickup flash
  • Status: Flash the status bar in the area where the item is displayed. If the player picks up ammo, the ammo display will flash.
  • Half: Half intensity palette flash. Slightly less confusing than the full intensity palette flash.
  • Vanilla: The Vanilla Doom palette flash. It is similar enough to the palette flash of being hit to be confusing.
This is the Pickup Flash control in the Effects menu.
playerspritesbool Choose whether to draw the player weapon sprites. Don't laugh! Sometimes I like to play with playersprites off.
splatsbool Enable/disable bloodsplats and bullet holes on walls.
scalestatusbarbool The status bar can be small or scaled up.
This is the Scale Status Bar control in the video menu.
hud_overlaystring

Choose what information to show in the HUD when in full screen mode. Each letter represent a piece of information that will be shown.

f: show frags (only in deathmatch)
h: show health
m: show armor
a: show current weapon ammo
k: show keys
e: show monsters kill
s: show secret found count

ticrate
<0 - 2>
int The ticrate is displayed as Frames Per Second.
  • Off: Display of frame rate is off.
  • Graph: Draw a scrolling graph of the Frames Per Second.
  • Numeric: Display the Frames Per Second.
This is the Show Ticrate control in the Video menu.
fuzzymodebool Enables the Vanilla Doom fuzzy draw for cloaked monsters instead of the newer translucent draw.

These options only apply in the OpenGL mode.

variabletypedefinition
gr_coronasbool Enable/disable coronas around light sources.
gr_coronasize float Sets the corona size. In reality coronas are caused by the dispersion of light in the eye. You can adjust the size to get a more realistic effect or just to see bigger coronas :).
gr_dynamiclighting bool Dynamic lighting renders on walls and planes a diffuse reflection of nearby light sources, such as missiles or BFG balls. Be aware it can be slow on low end PC. See also gr_mblighting.
gr_mblighting bool Same as dynamic lighting, except it shows the light emitted by missiles thrown by monsters.
gr_fog bool Enable/disable the fog, default is on.
gr_fogcolor string Change the RGB (in hexadecimal format, "rrggbb") color of the fog. The default is 000000 (black, looks like the original Doom fog). For a grey fog, set the value to 707070 (for example).
gr_fogdensity float Change the fog density. The default value is 500. I suggest you to try different values to see the changes.
gr_fov float

Field of view, in degrees. If you set a value above 90 and gr_mlook (see below) is "Off", then Legacy will automatically set gr_mlook to "On". This is because FOV, with a value higher than 90 degrees, needs this mode to work properly. You can use it for zooming:

Mandeep/FlynnT tips for zooming (see other commands/variables) alias psprites_on "playersprites 1" alias psprites_off "playersprites 0" alias zoom_in "set_zoom_out; psprites_off; gr_fov 80; wait 1; gr_fov 71; wait 1; gr_fov 62; wait 1; gr_fov 54; wait 1; gr_fov 46; wait 1; gr_fov 39; wait 1; gr_fov 32; wait 1; gr_fov 26; wait 1; gr_fov 20; wait 1; gr_fov 15; wait 1; gr_fov 10" alias set_zoom_out "bind n zoom_out" alias zoom_out "set_zoom_in; gr_fov 15; wait 1; gr_fov 20; wait 1; gr_fov 26; wait 1; gr_fov 32; wait 1; gr_fov 39; wait 1; gr_fov 46; wait 1; gr_fov 54; wait 1; gr_fov 62; wait 1; gr_fov 71; wait 1; gr_fov 80; psprites_on; wait 1; gr_fov 90" alias set_zoom_in "bind n zoom_in" bind n zoom_in

I suggest you to put this in the autoexec.cfg file. It allows you to use the n key for zooming in and out.

gr_gammared | gr_gammagreen | gr_gammablue int Set the intensities of red, green and blue on the scale 0-255. You can use them to make Legacy uniformly brighter or darker if you set all these variables to the same smaller or higher value.
gr_mlook int gr_mlook command is there for fixing the "mlook" bug (when you look up and down). The default value is 1. The "Off" (0) should only use if you don't use full mlook. The "On" (1) is fast and fix most of the mlook bug, but walls behind you can be hidden if you look at nearly 90° (up or down). It shouldn't be a big issue for most of you and it's the recommended mode for low end pc. The "Full" (2) is exactly the same as "On" but it fix all the bugs and is a little slower for angle > 45 degree. The gr_mlook command has been "optimized" recently. That's why, when you're aiming at an angle of 0, it acts like if gr_mlook was Off, even if gr_mlook is set to On or Full, and thus it's faster. There is something similar with angle less than 45: if you use gr_mlook Full, it act like gr_mlook On.
gr_staticlighting bool This is an experimental variable for now since it's not yet optimized. I don't recommend you to use it, except if you have the cream of the cream PC. It's ok for some maps, though.
gr_stats - Prints out the memory usage of the hardware renderer.
gr_solvetjoin bool Experimental control to disable the Solve T-join problem code. The function tries to combine vertexes that are close together.
gr_polyshape int Controls the polygon generation, and what shape is allowed. The least amount of overdraw usually gives the fastest rendering.
  • Subsector : Disables cutting the subsector polygon. The polygon is the shape of the BSP subsector. Has the most overdraw into void areas.
  • Fat : Trims void space from the subsector polygon with segs that cross the entire subsector. Ignores short segs. The floor and ceiling overdraw into void areas.
  • Trim : Trims the subsector polygons with the segs. Combines short segs to find cuts across the entire subsector. When a polygon becomes non-convex, then selected vertexes are removed until it is convex. Usually generates smaller polygons than Fat, but there is still some overdraw into void areas where the polygon is forced to be convex.
  • NotConvex : Generates polygons with the least overdraw, but some may be non-convex due to the shape and segs of the subsector. The polygons are required to be convex for hardware draw, but some libraries may tolerate drawing non-convex polygons. My nVidia supplied OpenGL library apparantly does. Test at your own risk, but I do not recommend using it.
The default is Trim.
gr_polytile bool Enables the polytile code that shares vertexes between poly so as to prevent cracks between polys from forming. This control allows the user to disable this code easily. Default is enabled.

Sound options

Variables controlling sound and music.

variabletypedefinition
soundvolume <0-31>int Sound effects volume. There is a control for this in the Sound menu.
musicvolume <0-31>int The game music volume (Midi). The game music is embeded in the game IWAD and PWAD. There is a control for this in the Sound menu.
cd_volume <0-31>int CD music volume. This is music is from any CD that is in the CD drive, not music from the game. There is a control for this in the Sound Menu.
snd_channelsint Number of sound channels used. Usually you will choose a value from 8 to 16, which is enough.
stereoreversebool Reverse the the left and right stereo channels. This is necessary if you hear a monster from the right, but then get hit from the left.
surroundbool Use a software "surround" effect?
precachesoundbool Enables loading all sounds at the map startup, to eliminate delays in playing sound effects. Disk drive activity to load sounds during play can be annoying.
menusound <0-3>int The sound played during menu movements.
The menu sound selections.
  • Auto: DoomLegacy will automatically select the menu sound.
  • Legacy: Softer wooden clack sounds.
  • Doom: Gun shots mostly. Only when playing Doom.
  • Heretic: Heretic clicks. Only when playing Heretic.
There is a control for this in the Effects menu.
musserv_optint This is only present in the Linux X port with the separate musserver.
Sound Device Preeference select for playing Midi music. It determines the order that sound ports are tried. If the preferred port is not found, some other port will be used.
  • Default:
  • Midi: Any midi synth.
  • TiMidity: TiMidity synth.
  • FluidSynth: FluidSynth synth.
  • Ext Midi: An external Midi device. When a external port is found, such as in Alsa, but there is no actual external midi device, the musserver will use the external port anyway (producing silent music).
  • Synth: FM or Awe32 synth
  • FM Synth: FM Synth such as a SoundBlaster port.
  • Awe32 Synth: Only works if Awe32 support is compiled into the musserver.
This is the Music Pref. control in the Sound menu (only in Linux X port).
For a list of devices: "musserver -l"
musserv_cmdstring This is only present in the Linux X port with the separate musserver.
The command to start the music server.
Default value: "musserver".
musserv_argstring This is only present in the Linux X port with the separate musserver.
The arguments to pass to the music server when it is started.
Default value: "-t 20".
sndserv_cmdstring This is only present in the Linux X port with the separate sound server.
The command to start the music server.
Default value: "llsndserv".
sndserv_argstring This is only present in the Linux X port with the separate sound server.
The arguments to pass to the sound server when it is started.
Default value: "-quiet".