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 key_right
62 Keyboard key to turn right.
63
64 key_left
65 Keyboard key to turn left.
66
67 key_up Keyboard key to move forward.
68
69 key_down
70 Keyboard key to move backward.
71
72 key_strafeleft
73 Keyboard key to strafe left.
74
75 key_straferight
76 Keyboard key to strafe right.
77
78 key_jump
79 Keyboard key to jump.
80
81 key_flyup
82 Keyboard key to fly upward.
83
84 key_flydown
85 Keyboard key to fly downwards.
86
87 key_flycenter
88 Keyboard key to center flying.
89
90 key_lookup
91 Keyboard key to look up.
92
93 key_lookdown
94 Keyboard key to look down.
95
96 key_lookcenter
97 Keyboard key to center the view.
98
99 key_invleft
100 Keyboard key to scroll left in the inventory.
101
102 key_invright
103 Keyboard key to scroll right in the inventory.
104
105 key_useartifact
106 Keyboard key to use the current item in the inventory.
107
108 key_fire
109 Keyboard key to fire the currently selected weapon.
110
111 key_use
112 Keyboard key to "use" an object, eg. a door or switch.
113
114 key_strafe
115 Keyboard key to turn on strafing. When held down, pressing the
116 key to turn left or right causes the player to strafe left or
117 right instead.
118
119 key_speed
120 Keyboard key to make the player run.
121
122 use_mouse
123 If non-zero, mouse input is enabled. If zero, mouse input is
124 disabled.
125
126 mouseb_fire
127 Mouse button to fire the currently selected weapon.
128
129 mouseb_strafe
130 Mouse button to turn on strafing. When held down, the player
131 will strafe left and right instead of turning left and right.
132
133 mouseb_forward
134 Mouse button to move forward.
135
136 mouseb_jump
137 Mouse button to jump.
138
139 use_joystick
140 If non-zero, joystick input is enabled.
141
142 joyb_fire
143 Joystick virtual button that fires the current weapon.
144
145 joyb_strafe
146 Joystick virtual button that makes the player strafe while held
147 down.
148
149 joyb_use
150 Joystick virtual button to "use" an object, eg. a door or
151 switch.
152
153 joyb_speed
154 Joystick virtual button that makes the player run while held
155 down. If this has a value of 20 or greater, the player will
156 always run, even if use_joystick is 0.
157
158 joyb_jump
159 Joystick virtual button that makes the player jump.
160
161 screenblocks
162 Screen size, range 3-11. A value of 11 gives a full-screen view
163 with the status bar not displayed. A value of 10 gives a
164 full-screen view with the status bar displayed.
165
166 snd_channels
167 Number of sounds that will be played simultaneously.
168
169 snd_musicdevice
170 Music output device. A non-zero value gives MIDI sound output,
171 while a value of zero disables music.
172
173 snd_sfxdevice
174 Sound effects device. A value of zero disables in-game sound
175 effects, a value of 1 enables PC speaker sound effects, while a
176 value in the range 2-9 enables the "normal" digital sound
177 effects.
178
179 snd_sbport
180 SoundBlaster I/O port. Unused.
181
182 snd_sbirq
183 SoundBlaster IRQ. Unused.
184
185 snd_sbdma
186 SoundBlaster DMA channel. Unused.
187
188 snd_mport
189 Output port to use for OPL MIDI playback. Unused.
190
191 usegamma
192 Gamma correction level. A value of zero disables gamma correc‐
193 tion, while a value in the range 1-4 gives increasing levels of
194 gamma correction.
195
196 savedir
197 Directory in which to store savegames.
198
199 messageson
200 Controls whether messages are displayed in the heads-up display.
201 If this has a non-zero value, messages are displayed.
202
203 chatmacro0
204 Multiplayer chat macro: message to send when alt+0 is pressed.
205
206 chatmacro1
207 Multiplayer chat macro: message to send when alt+1 is pressed.
208
209 chatmacro2
210 Multiplayer chat macro: message to send when alt+2 is pressed.
211
212 chatmacro3
213 Multiplayer chat macro: message to send when alt+3 is pressed.
214
215 chatmacro4
216 Multiplayer chat macro: message to send when alt+4 is pressed.
217
218 chatmacro5
219 Multiplayer chat macro: message to send when alt+5 is pressed.
220
221 chatmacro6
222 Multiplayer chat macro: message to send when alt+6 is pressed.
223
224 chatmacro7
225 Multiplayer chat macro: message to send when alt+7 is pressed.
226
227 chatmacro8
228 Multiplayer chat macro: message to send when alt+8 is pressed.
229
230 chatmacro9
231 Multiplayer chat macro: message to send when alt+9 is pressed.
232
233
235 chocolate-doom(6), chocolate-doom.cfg(5), chocolate-setup(6)
236
237
238
239
240 default.cfg(5)