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, in
15 ~/.chocolate-doom/default.cfg.
16 The chocolate-setup(6) tool provides a simple to use front-end for
18 editing default.cfg.
19
21 The file is a plain-text file, consisting of a list of configuration
22 options and their values, separated by whitespace. Each option is
23 stored on a separate line. Options have different types; an option may
24 have either an integer, floating point or string value. If the option
25 is of a string type, the value is surrounded by quotes (").
26 For example:
28 integer_value 1
30 integer_value2 1
31 floating_point_value 4.2
32 string_value "hello world"
33 Invalid lines or comments in the file will be ignored, but it is advis‐
35 able not to put them in the file; the file is rewritten from scratch
36 every time the game exits, so any invalid lines or comments will be
37 lost.
38 Some options are used for keyboard key bindings; these are stored as
40 integer values containing the keyboard scan code of the key to be bound
41 to. Boolean values are also stored as integers, with a value of zero
42 usually indicating "false" and a non-zero value indicating "true".
43
46 mouse_sensitivity
47 Mouse sensitivity. This value is used to multiply input mouse
48 movement to control the effect of moving the mouse. The "normal"
49 maximum value available for this through the in-game options
50 menu is 9. A value of 31 or greater will cause the game to crash
51 when entering the options menu.
52 sfx_volume
54 Volume of sound effects, range 0-15.
55 music_volume
57 Volume of in-game music, range 0-15.
58 show_talk
60 If non-zero, dialogue text is displayed over characters' pic‐
61 tures when engaging actors who have voices.
62 voice_volume
64 Volume of voice sound effects, range 0-15.
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_useHealth
84 Keyboard key to use health.
85 key_invquery
87 Keyboard key to query inventory.
88 key_mission
90 Keyboard key to display mission objective.
91 key_invPop
93 Keyboard key to display inventory popup.
94 key_invKey
96 Keyboard key to display keys popup.
97 key_invHome
99 Keyboard key to jump to start of inventory.
100 key_invEnd
102 Keyboard key to jump to end of inventory.
103 key_invLeft
105 Keyboard key to scroll left in the inventory.
106 key_invRight
108 Keyboard key to scroll right in the inventory.
109 key_invUse
111 Keyboard key to use inventory item.
112 key_invDrop
114 Keyboard key to drop an inventory item.
115 key_lookUp
117 Keyboard key to look up.
118 key_lookDown
120 Keyboard key to look down.
121 key_fire
123 Keyboard key to fire the currently selected weapon.
124 key_use
126 Keyboard key to "use" an object, eg. a door or switch.
127 key_strafe
129 Keyboard key to turn on strafing. When held down, pressing the
130 key to turn left or right causes the player to strafe left or
131 right instead.
132 key_speed
134 Keyboard key to make the player run.
135 use_mouse
137 If non-zero, mouse input is enabled. If zero, mouse input is
138 disabled.
139 mouseb_fire
141 Mouse button to fire the currently selected weapon.
142 mouseb_strafe
144 Mouse button to turn on strafing. When held down, the player
145 will strafe left and right instead of turning left and right.
146 mouseb_forward
148 Mouse button to move forward.
149 mouseb_jump
151 Mouse button to jump.
152 use_joystick
154 If non-zero, joystick input is enabled.
155 joyb_fire
157 Joystick virtual button that fires the current weapon.
158 joyb_strafe
160 Joystick virtual button that makes the player strafe while held
161 down.
162 joyb_use
164 Joystick virtual button to "use" an object, eg. a door or
165 switch.
166 joyb_speed
168 Joystick virtual button that makes the player run while held
169 down. If this has a value of 20 or greater, the player will
170 always run, even if use_joystick is 0.
171 joyb_jump
173 Joystick virtual button that makes the player jump.
174 screensize
176 Screen size, range 3-11. A value of 11 gives a full-screen view
177 with the status bar not displayed. A value of 10 gives a
178 full-screen view with the status bar displayed.
179 snd_channels
181 Number of sounds that will be played simultaneously.
182 snd_musicdevice
184 Music output device. A non-zero value gives MIDI sound output,
185 while a value of zero disables music.
186 snd_sfxdevice
188 Sound effects device. A value of zero disables in-game sound
189 effects, a value of 1 enables PC speaker sound effects, while a
190 value in the range 2-9 enables the "normal" digital sound
191 effects.
192 snd_sbport
194 SoundBlaster I/O port. Unused.
195 snd_sbirq
197 SoundBlaster IRQ. Unused.
198 snd_sbdma
200 SoundBlaster DMA channel. Unused.
201 snd_mport
203 Output port to use for OPL MIDI playback. Unused.
204 usegamma
206 Gamma correction level. A value of zero disables gamma correc‐
207 tion, while a value in the range 1-4 gives increasing levels of
208 gamma correction.
209 back_flat
211 Name of background flat used by view border.
212 nickname
214 Multiplayer nickname (?).
215 chatmacro0
217 Multiplayer chat macro: message to send when alt+0 is pressed.
218 chatmacro1
220 Multiplayer chat macro: message to send when alt+1 is pressed.
221 chatmacro2
223 Multiplayer chat macro: message to send when alt+2 is pressed.
224 chatmacro3
226 Multiplayer chat macro: message to send when alt+3 is pressed.
227 chatmacro4
229 Multiplayer chat macro: message to send when alt+4 is pressed.
230 chatmacro5
232 Multiplayer chat macro: message to send when alt+5 is pressed.
233 chatmacro6
235 Multiplayer chat macro: message to send when alt+6 is pressed.
236 chatmacro7
238 Multiplayer chat macro: message to send when alt+7 is pressed.
239 chatmacro8
241 Multiplayer chat macro: message to send when alt+8 is pressed.
242 chatmacro9
244 Multiplayer chat macro: message to send when alt+9 is pressed.
245 comport
247 Serial port number to use for SERSETUP.EXE (unused).
248
251 chocolate-doom(6), chocolate-doom.cfg(5), chocolate-setup(6)
252 default.cfg(5)