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_flyup
77 Keyboard key to fly upward.
78 key_flydown
80 Keyboard key to fly downwards.
81 key_flycenter
83 Keyboard key to center flying.
84 key_lookup
86 Keyboard key to look up.
87 key_lookdown
89 Keyboard key to look down.
90 key_lookcenter
92 Keyboard key to center the view.
93 key_invleft
95 Keyboard key to scroll left in the inventory.
96 key_invright
98 Keyboard key to scroll right in the inventory.
99 key_useartifact
101 Keyboard key to use the current item in the inventory.
102 key_fire
104 Keyboard key to fire the currently selected weapon.
105 key_use
107 Keyboard key to "use" an object, eg. a door or switch.
108 key_strafe
110 Keyboard key to turn on strafing. When held down, pressing the
111 key to turn left or right causes the player to strafe left or
112 right instead.
113 key_speed
115 Keyboard key to make the player run.
116 use_mouse
118 If non-zero, mouse input is enabled. If zero, mouse input is
119 disabled.
120 mouseb_fire
122 Mouse button to fire the currently selected weapon.
123 mouseb_strafe
125 Mouse button to turn on strafing. When held down, the player
126 will strafe left and right instead of turning left and right.
127 mouseb_forward
129 Mouse button to move forward.
130 use_joystick
132 If non-zero, joystick input is enabled.
133 joyb_fire
135 Joystick virtual button that fires the current weapon.
136 joyb_strafe
138 Joystick virtual button that makes the player strafe while held
139 down.
140 joyb_use
142 Joystick virtual button to "use" an object, eg. a door or
143 switch.
144 joyb_speed
146 Joystick virtual button that makes the player run while held
147 down. If this has a value of 20 or greater, the player will
148 always run, even if use_joystick is 0.
149 screenblocks
151 Screen size, range 3-11. A value of 11 gives a full-screen view
152 with the status bar not displayed. A value of 10 gives a
153 full-screen view with the status bar displayed.
154 snd_channels
156 Number of sounds that will be played simultaneously.
157 snd_musicdevice
159 Music output device. A non-zero value gives MIDI sound output,
160 while a value of zero disables music.
161 snd_sfxdevice
163 Sound effects device. A value of zero disables in-game sound
164 effects, a value of 1 enables PC speaker sound effects, while a
165 value in the range 2-9 enables the "normal" digital sound
166 effects.
167 snd_sbport
169 SoundBlaster I/O port. Unused.
170 snd_sbirq
172 SoundBlaster IRQ. Unused.
173 snd_sbdma
175 SoundBlaster DMA channel. Unused.
176 snd_mport
178 Output port to use for OPL MIDI playback. Unused.
179 usegamma
181 Gamma correction level. A value of zero disables gamma correc‐
182 tion, while a value in the range 1-4 gives increasing levels of
183 gamma correction.
184 chatmacro0
186 Multiplayer chat macro: message to send when alt+0 is pressed.
187 chatmacro1
189 Multiplayer chat macro: message to send when alt+1 is pressed.
190 chatmacro2
192 Multiplayer chat macro: message to send when alt+2 is pressed.
193 chatmacro3
195 Multiplayer chat macro: message to send when alt+3 is pressed.
196 chatmacro4
198 Multiplayer chat macro: message to send when alt+4 is pressed.
199 chatmacro5
201 Multiplayer chat macro: message to send when alt+5 is pressed.
202 chatmacro6
204 Multiplayer chat macro: message to send when alt+6 is pressed.
205 chatmacro7
207 Multiplayer chat macro: message to send when alt+7 is pressed.
208 chatmacro8
210 Multiplayer chat macro: message to send when alt+8 is pressed.
211 chatmacro9
213 Multiplayer chat macro: message to send when alt+9 is pressed.
214
217 chocolate-doom(6), chocolate-doom.cfg(5), chocolate-setup(6)
218 default.cfg(5)