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_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

SEE ALSO

219       chocolate-doom(6), chocolate-doom.cfg(5), chocolate-setup(6)
220
221
222
223
224                                                                default.cfg(5)
Impressum