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_messages
60 If non-zero, messages are displayed on the heads-up display in
61 the game ("picked up a clip", etc). If zero, these messages are
62 not displayed.
63 key_right
65 Keyboard key to turn right.
66 key_left
68 Keyboard key to turn left.
69 key_up Keyboard key to move forward.
71 key_down
73 Keyboard key to move backward.
74 key_strafeleft
76 Keyboard key to strafe left.
77 key_straferight
79 Keyboard key to strafe right.
80 key_fire
82 Keyboard key to fire the currently selected weapon.
83 key_use
85 Keyboard key to "use" an object, eg. a door or switch.
86 key_strafe
88 Keyboard key to turn on strafing. When held down, pressing the
89 key to turn left or right causes the player to strafe left or
90 right instead.
91 key_speed
93 Keyboard key to make the player run.
94 use_mouse
96 If non-zero, mouse input is enabled. If zero, mouse input is
97 disabled.
98 mouseb_fire
100 Mouse button to fire the currently selected weapon.
101 mouseb_strafe
103 Mouse button to turn on strafing. When held down, the player
104 will strafe left and right instead of turning left and right.
105 mouseb_forward
107 Mouse button to move forward.
108 use_joystick
110 If non-zero, joystick input is enabled.
111 joyb_fire
113 Joystick virtual button that fires the current weapon.
114 joyb_strafe
116 Joystick virtual button that makes the player strafe while held
117 down.
118 joyb_use
120 Joystick virtual button to "use" an object, eg. a door or
121 switch.
122 joyb_speed
124 Joystick virtual button that makes the player run while held
125 down. If this has a value of 20 or greater, the player will
126 always run, even if use_joystick is 0.
127 screenblocks
129 Screen size, range 3-11. A value of 11 gives a full-screen view
130 with the status bar not displayed. A value of 10 gives a
131 full-screen view with the status bar displayed.
132 detaillevel
134 Screen detail. Zero gives normal "high detail" mode, while a
135 non-zero value gives "low detail" mode.
136 snd_channels
138 Number of sounds that will be played simultaneously.
139 snd_musicdevice
141 Music output device. A non-zero value gives MIDI sound output,
142 while a value of zero disables music.
143 snd_sfxdevice
145 Sound effects device. A value of zero disables in-game sound
146 effects, a value of 1 enables PC speaker sound effects, while a
147 value in the range 2-9 enables the "normal" digital sound
148 effects.
149 snd_sbport
151 SoundBlaster I/O port. Unused.
152 snd_sbirq
154 SoundBlaster IRQ. Unused.
155 snd_sbdma
157 SoundBlaster DMA channel. Unused.
158 snd_mport
160 Output port to use for OPL MIDI playback. Unused.
161 usegamma
163 Gamma correction level. A value of zero disables gamma correc‐
164 tion, while a value in the range 1-4 gives increasing levels of
165 gamma correction.
166 chatmacro0
168 Multiplayer chat macro: message to send when alt+0 is pressed.
169 chatmacro1
171 Multiplayer chat macro: message to send when alt+1 is pressed.
172 chatmacro2
174 Multiplayer chat macro: message to send when alt+2 is pressed.
175 chatmacro3
177 Multiplayer chat macro: message to send when alt+3 is pressed.
178 chatmacro4
180 Multiplayer chat macro: message to send when alt+4 is pressed.
181 chatmacro5
183 Multiplayer chat macro: message to send when alt+5 is pressed.
184 chatmacro6
186 Multiplayer chat macro: message to send when alt+6 is pressed.
187 chatmacro7
189 Multiplayer chat macro: message to send when alt+7 is pressed.
190 chatmacro8
192 Multiplayer chat macro: message to send when alt+8 is pressed.
193 chatmacro9
195 Multiplayer chat macro: message to send when alt+9 is pressed.
196
199 chocolate-doom(6), chocolate-doom.cfg(5), chocolate-setup(6)
200 default.cfg(5)