Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
heretic.cfg(5)		      File Formats Manual		heretic.cfg(5)

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,	choco-
       late-heretic.cfg.

       heretic.cfg  is normally	stored in the user's home directory, as	~/.lo-
       cal/share/chocolate-heretic/heretic.cfg.	 The path  can	be  overridden
       using  the  XDG_DATA_HOME environment variable (see the XDG Base	Direc-
       tory 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	advis-
       able 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  al-
	      ways 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  ef-
	      fects.

       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 correc-
	      tion, 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),		choco-
       late-heretic-setup(6)

								heretic.cfg(5)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=heretic.cfg&sektion=5&manpath=FreeBSD+Ports+14.3.quarterly>

home | help