default.cfg
Section: File Formats (5)
Page Index
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,
as ~/.local/share/chocolate-doom/default.cfg. The path can be
overridden using the XDG_DATA_HOME environment variable (see the XDG
Base Directory Specification).
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_talk
-
If non-zero, dialogue text is displayed over characters' pictures when engaging actors who have voices.
- voice_volume
-
Volume of voice sound effects, range 0-15.
- 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_useHealth
-
Keyboard key to use health.
- key_invquery
-
Keyboard key to query inventory.
- key_mission
-
Keyboard key to display mission objective.
- key_invPop
-
Keyboard key to display inventory popup.
- key_invKey
-
Keyboard key to display keys popup.
- key_invHome
-
Keyboard key to jump to start of inventory.
- key_invEnd
-
Keyboard key to jump to end of inventory.
- key_invLeft
-
Keyboard key to scroll left in the inventory.
- key_invRight
-
Keyboard key to scroll right in the inventory.
- key_invUse
-
Keyboard key to use inventory item.
- key_invDrop
-
Keyboard key to drop an inventory item.
- key_lookUp
-
Keyboard key to look up.
- key_lookDown
-
Keyboard key to look down.
- 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.
- mouseb_jump
-
Mouse button to jump.
- 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.
- joyb_jump
-
Joystick virtual button that makes the player jump.
- screensize
-
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.
- 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.
- back_flat
-
Name of background flat used by view border.
- nickname
-
Multiplayer nickname (?).
- 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.
- comport
-
Serial port number to use for SERSETUP.EXE (unused).
SEE ALSO
chocolate-doom(6),
chocolate-doom.cfg(5),
chocolate-setup(6)