NAME

       strife.cfg - Chocolate Strife configuration file

DESCRIPTION

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

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

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

                                                                                                   strife.cfg(5)