Provided by: chocolate-doom_3.0.1+really3.0.0+git1548-1_amd64 bug

NAME

       heretic.cfg - Chocolate Heretic configuration file

DESCRIPTION

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

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

       The chocolate-heretic-setup(6) tool  provides  a  simple  to  use  front-end  for  editing
       heretic.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.

       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_flyup
              Keyboard key to fly upward.

       key_flydown
              Keyboard key to fly downwards.

       key_flycenter
              Keyboard key to center flying.

       key_lookup
              Keyboard key to look up.

       key_lookdown
              Keyboard key to look down.

       key_lookcenter
              Keyboard key to center the view.

       key_invleft
              Keyboard key to scroll left in the inventory.

       key_invright
              Keyboard key to scroll right in the inventory.

       key_useartifact
              Keyboard key to use the current item in the inventory.

       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_speed
              Mouse button to turn on running.  When held down, the player will run while moving.

       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.

       screenblocks
              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.

       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.

SEE ALSO

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

                                                                                   heretic.cfg(5)