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

SEE ALSO

235       chocolate-doom(6), chocolate-doom.cfg(5), chocolate-setup(6)
236
237
238
239
240                                                                default.cfg(5)
Impressum