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