--- name: "crispy_default.cfg" section: "5" platform: "linux" package: "crispy-doom" version: "5.12.0-1" release: "Debian 12 (Bookworm)" platforms: ["linux"] url: "https://new.carta.tech/crispy_default.cfg" --- # crispy\_default.cfg(5) Crispy Doom configuration file ## NAME default.cfg - Crispy Doom configuration file ## DESCRIPTION *default.cfg* is the configuration file for [**crispy-doom**(6)](/crispy-doom/6.md). The configuration options stored in the file are the same as those stored in the original DOS Vanilla Doom. Extra Crispy Doom-specific options are stored in a separate configuration file, **crispy-doom.cfg**. *default.cfg* is normally stored in the user's home directory, as *~/.local/share/crispy-doom/default.cfg*. The path can be overridden using the **XDG\_DATA\_HOME** environment variable (see the XDG Base Directory Specification). The [**crispy-doom-setup**(6)](/crispy-doom-setup/6.md) 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. - **mouse\_sensitivity\_x2** Horizontal mouse sensitivity (strafe) - **mouse\_sensitivity\_y** Vertical mouse sensitivity - **sfx\_volume** Volume of sound effects, range 0-15. - **music\_volume** Volume of in-game music, range 0-15. - **show\_messages** If non-zero, messages are displayed on the heads-up display in the game ("picked up a clip", etc). If zero, these messages are not displayed. - **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\_alt\_up** Keyboard key to move forward (alternative). - **key\_alt\_down** Keyboard key to move backward (alternative). - **key\_strafeleft** Keyboard key to strafe left. - **key\_alt\_strafeleft** Keyboard key to strafe left (alternative). - **key\_straferight** Keyboard key to strafe right. - **key\_alt\_straferight** Keyboard key to strafe right (alternative). - **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. - **key\_demospeed** Keyboard key to fast-forward through a demo. - **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\_mouselook** Mouse button to enable free looking. - **mouseb\_reverse** Quick 180° reverse. - **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. - **detaillevel** Screen detail. Zero gives normal "high detail" mode, while a non-zero value gives "low detail" mode. - **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 [**crispy-doom**(6)](/crispy-doom/6.md), [**crispy-doom.cfg**(5)](/crispy-doom.cfg/5.md), [**crispy-doom-setup**(6)](/crispy-doom-setup/6.md)