NAME
default.cfg - Chocolate Doom configuration file
DESCRIPTION
default.cfg is the configuration file for chocolate-doom(6). The
configuration options stored in the file are the same as those stored
in the original DOS Vanilla Doom. Extra Chocolate Doom-specific
options are stored in a separate configuration file, chocolate-
doom.cfg.
default.cfg is normally stored in the user’s home directory, in
~/.chocolate-doom/default.cfg.
The chocolate-setup(6) tool provides a simple to use front-end for
editing default.cfg.
FILE FORMAT
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".
CONFIGURATION VARIABLES
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.
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_strafeleft
Keyboard key to strafe left.
key_straferight
Keyboard key to strafe right.
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.
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.
use_joystick
If non-zero, joystick input is enabled.
joyb_fire
Joystick button to fire the current weapon.
joyb_strafe
Joystick button to fire the current weapon.
joyb_use
Joystick button to "use" an object, eg. a door or switch.
joyb_speed
Joystick button to make the player run. If this has a value of
20 or greater, the player will always run.
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.
SEE ALSO
chocolate-doom(6), chocolate-doom.cfg(5), chocolate-setup(6)
default.cfg(5)