1default.cfg(5) File Formats Manual default.cfg(5)
2
3
4
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
14 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
19 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
29 For example:
30
31 integer_value 1
32 integer_value2 1
33 floating_point_value 4.2
34 string_value "hello world"
35
36 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
41 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
46
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
55 sfx_volume
56 Volume of sound effects, range 0-15.
57
58 music_volume
59 Volume of in-game music, range 0-15.
60
61 show_talk
62 If non-zero, dialogue text is displayed over characters' pic‐
63 tures when engaging actors who have voices.
64
65 voice_volume
66 Volume of voice sound effects, range 0-15.
67
68 key_right
69 Keyboard key to turn right.
70
71 key_left
72 Keyboard key to turn left.
73
74 key_up Keyboard key to move forward.
75
76 key_down
77 Keyboard key to move backward.
78
79 key_strafeleft
80 Keyboard key to strafe left.
81
82 key_straferight
83 Keyboard key to strafe right.
84
85 key_useHealth
86 Keyboard key to use health.
87
88 key_invquery
89 Keyboard key to query inventory.
90
91 key_mission
92 Keyboard key to display mission objective.
93
94 key_invPop
95 Keyboard key to display inventory popup.
96
97 key_invKey
98 Keyboard key to display keys popup.
99
100 key_invHome
101 Keyboard key to jump to start of inventory.
102
103 key_invEnd
104 Keyboard key to jump to end of inventory.
105
106 key_invLeft
107 Keyboard key to scroll left in the inventory.
108
109 key_invRight
110 Keyboard key to scroll right in the inventory.
111
112 key_invUse
113 Keyboard key to use inventory item.
114
115 key_invDrop
116 Keyboard key to drop an inventory item.
117
118 key_lookUp
119 Keyboard key to look up.
120
121 key_lookDown
122 Keyboard key to look down.
123
124 key_fire
125 Keyboard key to fire the currently selected weapon.
126
127 key_use
128 Keyboard key to "use" an object, eg. a door or switch.
129
130 key_strafe
131 Keyboard key to turn on strafing. When held down, pressing the
132 key to turn left or right causes the player to strafe left or
133 right instead.
134
135 key_speed
136 Keyboard key to make the player run.
137
138 use_mouse
139 If non-zero, mouse input is enabled. If zero, mouse input is
140 disabled.
141
142 mouseb_fire
143 Mouse button to fire the currently selected weapon.
144
145 mouseb_strafe
146 Mouse button to turn on strafing. When held down, the player
147 will strafe left and right instead of turning left and right.
148
149 mouseb_forward
150 Mouse button to move forward.
151
152 mouseb_jump
153 Mouse button to jump.
154
155 use_joystick
156 If non-zero, joystick input is enabled.
157
158 joyb_fire
159 Joystick virtual button that fires the current weapon.
160
161 joyb_strafe
162 Joystick virtual button that makes the player strafe while held
163 down.
164
165 joyb_use
166 Joystick virtual button to "use" an object, eg. a door or
167 switch.
168
169 joyb_speed
170 Joystick virtual button that makes the player run while held
171 down. If this has a value of 20 or greater, the player will
172 always run, even if use_joystick is 0.
173
174 joyb_jump
175 Joystick virtual button that makes the player jump.
176
177 screensize
178 Screen size, range 3-11. A value of 11 gives a full-screen view
179 with the status bar not displayed. A value of 10 gives a
180 full-screen view with the status bar displayed.
181
182 snd_channels
183 Number of sounds that will be played simultaneously.
184
185 snd_musicdevice
186 Music output device. A non-zero value gives MIDI sound output,
187 while a value of zero disables music.
188
189 snd_sfxdevice
190 Sound effects device. A value of zero disables in-game sound
191 effects, a value of 1 enables PC speaker sound effects, while a
192 value in the range 2-9 enables the "normal" digital sound
193 effects.
194
195 snd_sbport
196 SoundBlaster I/O port. Unused.
197
198 snd_sbirq
199 SoundBlaster IRQ. Unused.
200
201 snd_sbdma
202 SoundBlaster DMA channel. Unused.
203
204 snd_mport
205 Output port to use for OPL MIDI playback. Unused.
206
207 usegamma
208 Gamma correction level. A value of zero disables gamma correc‐
209 tion, while a value in the range 1-4 gives increasing levels of
210 gamma correction.
211
212 back_flat
213 Name of background flat used by view border.
214
215 nickname
216 Multiplayer nickname (?).
217
218 chatmacro0
219 Multiplayer chat macro: message to send when alt+0 is pressed.
220
221 chatmacro1
222 Multiplayer chat macro: message to send when alt+1 is pressed.
223
224 chatmacro2
225 Multiplayer chat macro: message to send when alt+2 is pressed.
226
227 chatmacro3
228 Multiplayer chat macro: message to send when alt+3 is pressed.
229
230 chatmacro4
231 Multiplayer chat macro: message to send when alt+4 is pressed.
232
233 chatmacro5
234 Multiplayer chat macro: message to send when alt+5 is pressed.
235
236 chatmacro6
237 Multiplayer chat macro: message to send when alt+6 is pressed.
238
239 chatmacro7
240 Multiplayer chat macro: message to send when alt+7 is pressed.
241
242 chatmacro8
243 Multiplayer chat macro: message to send when alt+8 is pressed.
244
245 chatmacro9
246 Multiplayer chat macro: message to send when alt+9 is pressed.
247
248 comport
249 Serial port number to use for SERSETUP.EXE (unused).
250
251
253 chocolate-doom(6), chocolate-doom.cfg(5), chocolate-setup(6)
254
255
256
257
258 default.cfg(5)