1default.cfg(5)                File Formats Manual               default.cfg(5)
2
3
4

NAME

6       default.cfg - Chocolate Doom configuration file
7

DESCRIPTION

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

FILE FORMAT

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

CONFIGURATION VARIABLES

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       show_talk
62              If non-zero, dialogue text is displayed  over  characters'  pic‐
63              tures when engaging actors who have voices.
64
65       voice_volume
66              Volume of voice sound effects, range 0-15.
67
68       key_right
69              Keyboard key to turn right.
70
71       key_left
72              Keyboard key to turn left.
73
74       key_up Keyboard key to move forward.
75
76       key_down
77              Keyboard key to move backward.
78
79       key_strafeleft
80              Keyboard key to strafe left.
81
82       key_straferight
83              Keyboard key to strafe right.
84
85       key_useHealth
86              Keyboard key to use health.
87
88       key_invquery
89              Keyboard key to query inventory.
90
91       key_mission
92              Keyboard key to display mission objective.
93
94       key_invPop
95              Keyboard key to display inventory popup.
96
97       key_invKey
98              Keyboard key to display keys popup.
99
100       key_invHome
101              Keyboard key to jump to start of inventory.
102
103       key_invEnd
104              Keyboard key to jump to end of inventory.
105
106       key_invLeft
107              Keyboard key to scroll left in the inventory.
108
109       key_invRight
110              Keyboard key to scroll right in the inventory.
111
112       key_invUse
113              Keyboard key to use inventory item.
114
115       key_invDrop
116              Keyboard key to drop an inventory item.
117
118       key_lookUp
119              Keyboard key to look up.
120
121       key_lookDown
122              Keyboard key to look down.
123
124       key_fire
125              Keyboard key to fire the currently selected weapon.
126
127       key_use
128              Keyboard key to "use" an object, eg. a door or switch.
129
130       key_strafe
131              Keyboard  key to turn on strafing.  When held down, pressing the
132              key to turn left or right causes the player to  strafe  left  or
133              right instead.
134
135       key_speed
136              Keyboard key to make the player run.
137
138       use_mouse
139              If  non-zero,  mouse  input is enabled.  If zero, mouse input is
140              disabled.
141
142       mouseb_fire
143              Mouse button to fire the currently selected weapon.
144
145       mouseb_strafe
146              Mouse button to turn on strafing.  When held  down,  the  player
147              will strafe left and right instead of turning left and right.
148
149       mouseb_forward
150              Mouse button to move forward.
151
152       mouseb_jump
153              Mouse button to jump.
154
155       use_joystick
156              If non-zero, joystick input is enabled.
157
158       joyb_fire
159              Joystick virtual button that fires the current weapon.
160
161       joyb_strafe
162              Joystick  virtual button that makes the player strafe while held
163              down.
164
165       joyb_use
166              Joystick virtual button to  "use"  an  object,  eg.  a  door  or
167              switch.
168
169       joyb_speed
170              Joystick  virtual  button  that  makes the player run while held
171              down. If this has a value of 20  or  greater,  the  player  will
172              always run, even if use_joystick is 0.
173
174       joyb_jump
175              Joystick virtual button that makes the player jump.
176
177       screensize
178              Screen  size, range 3-11. A value of 11 gives a full-screen view
179              with the status bar not  displayed.   A  value  of  10  gives  a
180              full-screen view with the status bar displayed.
181
182       snd_channels
183              Number of sounds that will be played simultaneously.
184
185       snd_musicdevice
186              Music  output device.  A non-zero value gives MIDI sound output,
187              while a value of zero disables music.
188
189       snd_sfxdevice
190              Sound effects device.  A value of zero  disables  in-game  sound
191              effects,  a value of 1 enables PC speaker sound effects, while a
192              value in the  range  2-9  enables  the  "normal"  digital  sound
193              effects.
194
195       snd_sbport
196              SoundBlaster I/O port. Unused.
197
198       snd_sbirq
199              SoundBlaster IRQ.  Unused.
200
201       snd_sbdma
202              SoundBlaster DMA channel.  Unused.
203
204       snd_mport
205              Output port to use for OPL MIDI playback.  Unused.
206
207       usegamma
208              Gamma  correction level.  A value of zero disables gamma correc‐
209              tion, while a value in the range 1-4 gives increasing levels  of
210              gamma correction.
211
212       back_flat
213              Name of background flat used by view border.
214
215       nickname
216              Multiplayer nickname (?).
217
218       chatmacro0
219              Multiplayer chat macro: message to send when alt+0 is pressed.
220
221       chatmacro1
222              Multiplayer chat macro: message to send when alt+1 is pressed.
223
224       chatmacro2
225              Multiplayer chat macro: message to send when alt+2 is pressed.
226
227       chatmacro3
228              Multiplayer chat macro: message to send when alt+3 is pressed.
229
230       chatmacro4
231              Multiplayer chat macro: message to send when alt+4 is pressed.
232
233       chatmacro5
234              Multiplayer chat macro: message to send when alt+5 is pressed.
235
236       chatmacro6
237              Multiplayer chat macro: message to send when alt+6 is pressed.
238
239       chatmacro7
240              Multiplayer chat macro: message to send when alt+7 is pressed.
241
242       chatmacro8
243              Multiplayer chat macro: message to send when alt+8 is pressed.
244
245       chatmacro9
246              Multiplayer chat macro: message to send when alt+9 is pressed.
247
248       comport
249              Serial port number to use for SERSETUP.EXE (unused).
250
251

SEE ALSO

253       chocolate-doom(6), chocolate-doom.cfg(5), chocolate-setup(6)
254
255
256
257
258                                                                default.cfg(5)
Impressum