--- name: "hexen.cfg" section: "5" platform: "linux" package: "chocolate-doom" version: "3.1.0-1" release: "Debian 13 (Trixie)" platforms: ["linux"] url: "https://new.carta.tech/hexen.cfg" --- # hexen.cfg(5) Chocolate Hexen configuration file ## NAME hexen.cfg - Chocolate Hexen configuration file ## DESCRIPTION *hexen.cfg* is the configuration file for [**chocolate-hexen**(6)](/chocolate-hexen/6.md). The configuration options stored in the file are the same as those stored in the original DOS Vanilla Hexen. Extra Chocolate Hexen-specific options are stored in a separate configuration file, **chocolate-hexen.cfg**. *hexen.cfg* is normally stored in the user's home directory, as *~/.local/share/chocolate-hexen/hexen.cfg*. The path can be overridden using the **XDG\_DATA\_HOME** environment variable (see the XDG Base Directory Specification). The [**chocolate-hexen-setup**(6)](/chocolate-hexen-setup/6.md) tool provides a simple to use front-end for editing *hexen.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\_jump** Keyboard key to jump. - **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. - **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. - **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. - **savedir** Directory in which to store savegames. - **messageson** Controls whether messages are displayed in the heads-up display. If this has a non-zero value, messages are displayed. - **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-hexen**(6)](/chocolate-hexen/6.md), [**chocolate-hexen.cfg**(5)](/chocolate-hexen.cfg/5.md), [**chocolate-hexen-setup**(6)](/chocolate-hexen-setup/6.md)