default.cfg(5)

📦 version 6.0, in debian bookworm, ubuntu jammy, ubuntu noble

✨ NAME ✨

hey bestie, meet default.cfg — it's the configuration file for crispy-doom(6), and it hangs out in the File Formats Manual (section 5, iykyk). 🎀

💖 DESCRIPTION 💖

okay so default.cfg is the config file for crispy-doom(6). The options it stores are literally the exact same ones the original DOS Vanilla Doom stored — no cap, same energy, same list. 🕹️

The extra Crispy Doom–specific options? Those do NOT live here. They're chilling in a whole separate config file called crispy-doom.cfg. Two files, two vibes. 💅

Normally default.cfg lives in your home directory, at:

~/.local/share/crispy-doom/default.cfg

You can override that path with the XDG_DATA_HOME environment variable (see the XDG Base Directory Specification, the blueprint of it all). 🌸

And if hand-editing a config file isn't your main character era, the crispy-doom-setup(6) tool is a simple-to-use front-end for editing default.cfg. Slay. ✨

🦋 FILE FORMAT 🦋

So the file is a plain-text file. It's a list of configuration options and their values, separated by whitespace, with each option sitting on its own separate line. 🧚

Options have different types — an option can be an integer, a floating point, or a string value. If it's a string type, the value gets surrounded by quotes ("). Periodt.

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 bestie, it is advisable not to put them in the file at all. The file gets rewritten from scratch every single time the game exits, so any invalid lines or comments you sneak in there will be lost. 💀

heads up: the game literally rewrites this file on every exit. Your cute little # comments? Gone. Poof. 🙈

Some options are used for keyboard key bindings — those get stored as integer values containing the keyboard scan code of the key you're binding to. Boolean values are also stored as integers, where a value of zero usually means "false" and a non-zero value means "true". 🌈

👑 CONFIGURATION VARIABLES 👑

  • mouse_sensitivity — Mouse sensitivity. This value multiplies your 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.
not me warning you: a value of 31 or greater will cause the game to crash when entering the options menu. 💀 please do not.
  • 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 🌈

go read these next, bestie, they're the whole friend group:

and that's the whole page, fr fr. this was default.cfg(5) from the File Formats Manual — no date on this one, just the classic file-formats energy. mwah, go forth and configure. 💖✨🎀🦋🌸💅🫶

📦 where this page comes from