1default.cfg(5) File Formats Manual default.cfg(5)
2
6 default.cfg - Chocolate Doom configuration file
7
9 default.cfg is the configuration file for chocolate-doom(6). The con‐
10 figuration options stored in the file are the same as those stored in
11 the original DOS Vanilla Doom. Extra Chocolate Doom-specific options
12 are stored in a separate configuration file, chocolate-doom.cfg.
13 default.cfg is normally stored in the user's home directory, as
15 ~/.local/share/chocolate-doom/default.cfg. The path can be overridden
16 using the XDG_DATA_HOME environment variable (see the XDG Base Direc‐
17 tory Specification).
18 The chocolate-setup(6) tool provides a simple to use front-end for
20 editing default.cfg.
21
23 The file is a plain-text file, consisting of a list of configuration
24 options and their values, separated by whitespace. Each option is
25 stored on a separate line. Options have different types; an option may
26 have either an integer, floating point or string value. If the option
27 is of a string type, the value is surrounded by quotes (").
28 For example:
30 integer_value 1
32 integer_value2 1
33 floating_point_value 4.2
34 string_value "hello world"
35 Invalid lines or comments in the file will be ignored, but it is advis‐
37 able not to put them in the file; the file is rewritten from scratch
38 every time the game exits, so any invalid lines or comments will be
39 lost.
40 Some options are used for keyboard key bindings; these are stored as
42 integer values containing the keyboard scan code of the key to be bound
43 to. Boolean values are also stored as integers, with a value of zero
44 usually indicating "false" and a non-zero value indicating "true".
45
48 mouse_sensitivity
49 Mouse sensitivity. This value is used to multiply input mouse
50 movement to control the effect of moving the mouse. The "normal"
51 maximum value available for this through the in-game options
52 menu is 9. A value of 31 or greater will cause the game to crash
53 when entering the options menu.
54 sfx_volume
56 Volume of sound effects, range 0-15.
57 music_volume
59 Volume of in-game music, range 0-15.
60 show_messages
62 If non-zero, messages are displayed on the heads-up display in
63 the game ("picked up a clip", etc). If zero, these messages are
64 not displayed.
65 key_right
67 Keyboard key to turn right.
68 key_left
70 Keyboard key to turn left.
71 key_up Keyboard key to move forward.
73 key_down
75 Keyboard key to move backward.
76 key_strafeleft
78 Keyboard key to strafe left.
79 key_straferight
81 Keyboard key to strafe right.
82 key_fire
84 Keyboard key to fire the currently selected weapon.
85 key_use
87 Keyboard key to "use" an object, eg. a door or switch.
88 key_strafe
90 Keyboard key to turn on strafing. When held down, pressing the
91 key to turn left or right causes the player to strafe left or
92 right instead.
93 key_speed
95 Keyboard key to make the player run.
96 use_mouse
98 If non-zero, mouse input is enabled. If zero, mouse input is
99 disabled.
100 mouseb_fire
102 Mouse button to fire the currently selected weapon.
103 mouseb_strafe
105 Mouse button to turn on strafing. When held down, the player
106 will strafe left and right instead of turning left and right.
107 mouseb_forward
109 Mouse button to move forward.
110 use_joystick
112 If non-zero, joystick input is enabled.
113 joyb_fire
115 Joystick virtual button that fires the current weapon.
116 joyb_strafe
118 Joystick virtual button that makes the player strafe while held
119 down.
120 joyb_use
122 Joystick virtual button to "use" an object, eg. a door or
123 switch.
124 joyb_speed
126 Joystick virtual button that makes the player run while held
127 down. If this has a value of 20 or greater, the player will
128 always run, even if use_joystick is 0.
129 screenblocks
131 Screen size, range 3-11. A value of 11 gives a full-screen view
132 with the status bar not displayed. A value of 10 gives a
133 full-screen view with the status bar displayed.
134 detaillevel
136 Screen detail. Zero gives normal "high detail" mode, while a
137 non-zero value gives "low detail" mode.
138 snd_channels
140 Number of sounds that will be played simultaneously.
141 snd_musicdevice
143 Music output device. A non-zero value gives MIDI sound output,
144 while a value of zero disables music.
145 snd_sfxdevice
147 Sound effects device. A value of zero disables in-game sound
148 effects, a value of 1 enables PC speaker sound effects, while a
149 value in the range 2-9 enables the "normal" digital sound
150 effects.
151 snd_sbport
153 SoundBlaster I/O port. Unused.
154 snd_sbirq
156 SoundBlaster IRQ. Unused.
157 snd_sbdma
159 SoundBlaster DMA channel. Unused.
160 snd_mport
162 Output port to use for OPL MIDI playback. Unused.
163 usegamma
165 Gamma correction level. A value of zero disables gamma correc‐
166 tion, while a value in the range 1-4 gives increasing levels of
167 gamma correction.
168 chatmacro0
170 Multiplayer chat macro: message to send when alt+0 is pressed.
171 chatmacro1
173 Multiplayer chat macro: message to send when alt+1 is pressed.
174 chatmacro2
176 Multiplayer chat macro: message to send when alt+2 is pressed.
177 chatmacro3
179 Multiplayer chat macro: message to send when alt+3 is pressed.
180 chatmacro4
182 Multiplayer chat macro: message to send when alt+4 is pressed.
183 chatmacro5
185 Multiplayer chat macro: message to send when alt+5 is pressed.
186 chatmacro6
188 Multiplayer chat macro: message to send when alt+6 is pressed.
189 chatmacro7
191 Multiplayer chat macro: message to send when alt+7 is pressed.
192 chatmacro8
194 Multiplayer chat macro: message to send when alt+8 is pressed.
195 chatmacro9
197 Multiplayer chat macro: message to send when alt+9 is pressed.
198
201 chocolate-doom(6), chocolate-doom.cfg(5), chocolate-setup(6)
202 default.cfg(5)