default.cfg - Crispy Doom configuration file
default.cfg is the configuration file for
crispy-doom(6). The configuration options stored in the file are the
same as those stored in the original DOS Vanilla Doom. Extra Crispy
Doom-specific options are stored in a separate configuration file,
crispy-doom.cfg.
default.cfg is normally stored in the user's home
directory, as ~/.local/share/crispy-doom/default.cfg. The path can be
overridden using the XDG_DATA_HOME environment variable (see the XDG
Base Directory Specification).
The crispy-doom-setup(6) tool provides a simple to use
front-end for editing default.cfg.
The file is a plain-text file, consisting of a list of
configuration options and their values, separated by whitespace. Each option
is stored on a separate line. Options have different types; an option may
have either an integer, floating point or string value. If the option is of
a string type, the value is surrounded by quotes (").
For example:
integer_value 1
integer_value2 1
floating_point_value 4.2
string_value "hello world"
Invalid lines or comments in the file will be ignored, but it is
advisable not to put them in the file; the file is rewritten from scratch
every time the game exits, so any invalid lines or comments will be
lost.
Some options are used for keyboard key bindings; these are stored
as integer values containing the keyboard scan code of the key to be bound
to. Boolean values are also stored as integers, with a value of zero usually
indicating "false" and a non-zero value indicating
"true".
- mouse_sensitivity
- Mouse sensitivity. This value is used to multiply input mouse movement to
control the effect of moving the mouse. The "normal" maximum
value available for this through the in-game options menu is 9. A value of
31 or greater will cause the game to crash when entering the options
menu.
- mouse_sensitivity_x2
- Horizontal mouse sensitivity (strafe)
- mouse_sensitivity_y
- Vertical mouse sensitivity
- sfx_volume
- Volume of sound effects, range 0-15.
- music_volume
- Volume of in-game music, range 0-15.
- show_messages
- If non-zero, messages are displayed on the heads-up display in the game
("picked up a clip", etc). If zero, these messages are not
displayed.
- key_right
- Keyboard key to turn right.
- key_left
- Keyboard key to turn left.
- key_up
- Keyboard key to move forward.
- key_down
- Keyboard key to move backward.
- key_alt_up
- Keyboard key to move forward (alternative).
- key_alt_down
- Keyboard key to move backward (alternative).
- key_strafeleft
- Keyboard key to strafe left.
- key_alt_strafeleft
- Keyboard key to strafe left (alternative).
- key_straferight
- Keyboard key to strafe right.
- key_alt_straferight
- Keyboard key to strafe right (alternative).
- key_fire
- Keyboard key to fire the currently selected weapon.
- key_use
- Keyboard key to "use" an object, eg. a door or switch.
- key_strafe
- Keyboard key to turn on strafing. When held down, pressing the key to turn
left or right causes the player to strafe left or right instead.
- key_speed
- Keyboard key to make the player run.
- key_demospeed
- Keyboard key to fast-forward through a demo.
- use_mouse
- If non-zero, mouse input is enabled. If zero, mouse input is
disabled.
- mouseb_fire
- Mouse button to fire the currently selected weapon.
- mouseb_strafe
- Mouse button to turn on strafing. When held down, the player will strafe
left and right instead of turning left and right.
- mouseb_forward
- Mouse button to move forward.
- mouseb_speed
- Mouse button to turn on running. When held down, the player will run while
moving.
- mouseb_mouselook
- Mouse button to enable free looking.
- mouseb_reverse
- Quick 180° reverse.
- use_joystick
- If non-zero, joystick input is enabled.
- joyb_fire
- Joystick virtual button that fires the current weapon.
- joyb_strafe
- Joystick virtual button that makes the player strafe while held down.
- joyb_use
- Joystick virtual button to "use" an object, eg. a door or
switch.
- joyb_speed
- Joystick virtual button that makes the player run while held down. If this
has a value of 20 or greater, the player will always run, even if
use_joystick is 0.
- screenblocks
- Screen size, range 3-11. A value of 11 gives a full-screen view with the
status bar not displayed. A value of 10 gives a full-screen view with the
status bar displayed.
- detaillevel
- Screen detail. Zero gives normal "high detail" mode, while a
non-zero value gives "low detail" mode.
- snd_channels
- Number of sounds that will be played simultaneously.
- snd_musicdevice
- Music output device. A non-zero value gives MIDI sound output, while a
value of zero disables music.
- snd_sfxdevice
- Sound effects device. A value of zero disables in-game sound effects, a
value of 1 enables PC speaker sound effects, while a value in the range
2-9 enables the "normal" digital sound effects.
- snd_sbport
- SoundBlaster I/O port. Unused.
- snd_sbirq
- SoundBlaster IRQ. Unused.
- snd_sbdma
- SoundBlaster DMA channel. Unused.
- snd_mport
- Output port to use for OPL MIDI playback. Unused.
- usegamma
- Gamma correction level. A value of zero disables gamma correction, while a
value in the range 1-4 gives increasing levels of gamma correction.
- chatmacro0
- Multiplayer chat macro: message to send when alt+0 is pressed.
- chatmacro1
- Multiplayer chat macro: message to send when alt+1 is pressed.
- chatmacro2
- Multiplayer chat macro: message to send when alt+2 is pressed.
- chatmacro3
- Multiplayer chat macro: message to send when alt+3 is pressed.
- chatmacro4
- Multiplayer chat macro: message to send when alt+4 is pressed.
- chatmacro5
- Multiplayer chat macro: message to send when alt+5 is pressed.
- chatmacro6
- Multiplayer chat macro: message to send when alt+6 is pressed.
- chatmacro7
- Multiplayer chat macro: message to send when alt+7 is pressed.
- chatmacro8
- Multiplayer chat macro: message to send when alt+8 is pressed.
- chatmacro9
- Multiplayer chat macro: message to send when alt+9 is pressed.