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