NAME

       default.cfg - Chocolate Doom configuration file

DESCRIPTION

       default.cfg  is  the  configuration file for chocolate-doom(6).  The configuration options
       stored in the file are the same as those stored in the original DOS Vanilla  Doom.   Extra
       Chocolate  Doom-specific  options  are stored in a separate configuration file, chocolate-
       doom.cfg.

       default.cfg is normally stored in the user's home directory, as  ~/.local/share/chocolate-
       doom/default.cfg.  The path can be overridden using the XDG_DATA_HOME environment variable
       (see the XDG Base Directory Specification).

       The chocolate-setup(6) tool provides a simple to use front-end for editing default.cfg.

FILE FORMAT

       The file is a plain-text file, consisting of a list of  configuration  options  and  their
       values,  separated by whitespace.  Each option is stored on a separate line.  Options have
       different types; an option may have either an integer, floating point or string value.  If
       the option is of a string type, the value is surrounded by quotes (").

       For example:

              integer_value                1
              integer_value2               1
              floating_point_value         4.2
              string_value                 "hello world"

       Invalid lines or comments in the file will be ignored, but it is advisable not to put them
       in the file; the file is rewritten from scratch every time the game exits, so any  invalid
       lines or comments will be lost.

       Some  options  are  used  for  keyboard  key  bindings; these are stored as integer values
       containing the keyboard scan code of the key to be bound  to.   Boolean  values  are  also
       stored  as  integers, with a value of zero usually indicating "false" and a non-zero value
       indicating "true".

CONFIGURATION VARIABLES

       mouse_sensitivity
              Mouse sensitivity.  This value is used to multiply input mouse movement to  control
              the  effect  of  moving  the  mouse.  The "normal" maximum value available for this
              through the in-game options menu is 9. A value of 31 or greater will cause the game
              to crash when entering the options menu.

       sfx_volume
              Volume of sound effects, range 0-15.

       music_volume
              Volume of in-game music, range 0-15.

       show_talk
              If  non-zero,  dialogue  text  is displayed over characters' pictures when engaging
              actors who have voices.

       voice_volume
              Volume of voice sound effects, range 0-15.

       key_right
              Keyboard key to turn right.

       key_left
              Keyboard key to turn left.

       key_up Keyboard key to move forward.

       key_down
              Keyboard key to move backward.

       key_strafeleft
              Keyboard key to strafe left.

       key_straferight
              Keyboard key to strafe right.

       key_useHealth
              Keyboard key to use health.

       key_invquery
              Keyboard key to query inventory.

       key_mission
              Keyboard key to display mission objective.

       key_invPop
              Keyboard key to display inventory popup.

       key_invKey
              Keyboard key to display keys popup.

       key_invHome
              Keyboard key to jump to start of inventory.

       key_invEnd
              Keyboard key to jump to end of inventory.

       key_invLeft
              Keyboard key to scroll left in the inventory.

       key_invRight
              Keyboard key to scroll right in the inventory.

       key_invUse
              Keyboard key to use inventory item.

       key_invDrop
              Keyboard key to drop an inventory item.

       key_lookUp
              Keyboard key to look up.

       key_lookDown
              Keyboard key to look down.

       key_fire
              Keyboard key to fire the currently selected weapon.

       key_use
              Keyboard key to "use" an object, eg. a door or switch.

       key_strafe
              Keyboard key to turn on strafing.  When held down, pressing the key to turn left or
              right causes the player to strafe left or right instead.

       key_speed
              Keyboard key to make the player run.

       use_mouse
              If non-zero, mouse input is enabled.  If zero, mouse input is disabled.

       mouseb_fire
              Mouse button to fire the currently selected weapon.

       mouseb_strafe
              Mouse  button to turn on strafing.  When held down, the player will strafe left and
              right instead of turning left and right.

       mouseb_forward
              Mouse button to move forward.

       mouseb_jump
              Mouse button to jump.

       use_joystick
              If non-zero, joystick input is enabled.

       joyb_fire
              Joystick virtual button that fires the current weapon.

       joyb_strafe
              Joystick virtual button that makes the player strafe while held down.

       joyb_use
              Joystick virtual button to "use" an object, eg. a door or switch.

       joyb_speed
              Joystick virtual button that makes the player run while held down. If  this  has  a
              value of 20 or greater, the player will always run, even if use_joystick is 0.

       joyb_jump
              Joystick virtual button that makes the player jump.

       screensize
              Screen size, range 3-11. A value of 11 gives a full-screen view with the status bar
              not displayed.  A value of  10  gives  a  full-screen  view  with  the  status  bar
              displayed.

       snd_channels
              Number of sounds that will be played simultaneously.

       snd_musicdevice
              Music  output  device.   A non-zero value gives MIDI sound output, while a value of
              zero disables music.

       snd_sfxdevice
              Sound effects device.  A value of zero disables in-game sound effects, a value of 1
              enables  PC  speaker  sound  effects,  while  a  value in the range 2-9 enables the
              "normal" digital sound effects.

       snd_sbport
              SoundBlaster I/O port. Unused.

       snd_sbirq
              SoundBlaster IRQ.  Unused.

       snd_sbdma
              SoundBlaster DMA channel.  Unused.

       snd_mport
              Output port to use for OPL MIDI playback.  Unused.

       usegamma
              Gamma correction level.  A value of zero disables gamma correction, while  a  value
              in the range 1-4 gives increasing levels of gamma correction.

       back_flat
              Name of background flat used by view border.

       nickname
              Multiplayer nickname (?).

       chatmacro0
              Multiplayer chat macro: message to send when alt+0 is pressed.

       chatmacro1
              Multiplayer chat macro: message to send when alt+1 is pressed.

       chatmacro2
              Multiplayer chat macro: message to send when alt+2 is pressed.

       chatmacro3
              Multiplayer chat macro: message to send when alt+3 is pressed.

       chatmacro4
              Multiplayer chat macro: message to send when alt+4 is pressed.

       chatmacro5
              Multiplayer chat macro: message to send when alt+5 is pressed.

       chatmacro6
              Multiplayer chat macro: message to send when alt+6 is pressed.

       chatmacro7
              Multiplayer chat macro: message to send when alt+7 is pressed.

       chatmacro8
              Multiplayer chat macro: message to send when alt+8 is pressed.

       chatmacro9
              Multiplayer chat macro: message to send when alt+9 is pressed.

       comport
              Serial port number to use for SERSETUP.EXE (unused).

SEE ALSO

       chocolate-doom(6), chocolate-doom.cfg(5), chocolate-setup(6)

                                                                                   default.cfg(5)