crispy-heretic.cfg(5)

💖 crispy-heretic.cfg — the config file for Crispy Heretic 💖

🌸 NAME 🌸

crispy-heretic.cfg — the configuration file for crispy-heretic(6) ✨

---

🦋 DESCRIPTION 🦋

Okay so crispy-heretic.cfg is a config file for crispy-heretic(6), and it's the auxiliary one, bestie. The main config options live in heretic.cfg, which holds all the same settings as Vanilla Heretic (for compatibility, periodt). crispy-heretic.cfg is where the stuff that's Crispy-Heretic-only goes. It's giving extra. It's giving exclusive. We love her 💅

Normally she lives in your home directory, at:

~/.local/share/crispy-heretic/crispy-heretic.cfg

and you can override that path with the XDG_DATA_HOME environment variable (iykyk, it's in the XDG Base Directory Specification ✨).

Also!! There's crispy-heretic-setup(6), which is a super simple front-end for editing crispy-heretic.cfg — so if hand-editing files isn't your vibe, she's got you 🫶

---

🎀 FILE FORMAT 🎀

The file format is exactly the same as the one used for heretic.cfg(5). No cap, no new syntax to learn, we're just reusing the fit 👑

---

👑 CONFIGURATION VARIABLES 👑

Alright bestie, here's the whole menu. Every single one, no skipping 🙈

• video_driver — the name of the SDL video driver you wanna use. If it's an empty string, you just get the default video driver. Let her cook.
• window_position — where the window sits on your screen when you're running in windowed mode. Accepted values are: "" (empty string) — don't care, "center" — place the window at the center of the screen, "x,y" — place the window at those exact coordinates. Iconic, honestly.
• fullscreen — if it's non-zero, the game runs in full screen mode. If it's zero, you get a window. That's it, that's the whole personality 🌈
• video_display — the index of the display the game should run on. This has no effect if you're running in windowed mode (fullscreen=0) and window_position is not set to "center". So like, don't bother, it's not listening to you 💀
• aspect_ratio_correct — if it's non-zero, the screen gets stretched vertically so it displays correctly on a square pixel video mode. Your geometry stays snatched.
• smooth_pixel_scaling — if it's non-zero, the screen gets smooth scaling. Soft. Blurred. Cozy 🧚
• integer_scaling — if it's non-zero, it forces integer scales for resolution-independent rendering. Whole numbers only, we don't do fractions here ✨
• window_width — the window width when you're running in windowed mode.
• window_height — the window height when you're running in windowed mode. (Yes, they're a matching set, they come as a pair, they're literally soulmates 💜)
• fullscreen_width — the width for the screen mode when running fullscreen. If this and fullscreen_height are both set to zero, we run fullscreen as a desktop window that covers the entire screen, rather than ever switching screen modes. It should usually be unnecessary to set this value, so like… don't touch it unless you have to 🙈
• fullscreen_height — the height for the screen mode when running fullscreen. See the docs for fullscreen_width — same energy, different axis.
• force_software_renderer — if it's non-zero, it forces the use of a software renderer. This one's for the systems that are lacking hardware acceleration, no shade, we've all been there 🫶
• max_scaling_buffer_pixels — the maximum number of pixels to use for the intermediate scaling buffer. More pixels means the screen can be rendered more precisely, but there are diminishing returns on quality — so more isn't automatically more, bestie. The default limits it to 16,000,000 pixels, which is enough to cover 4K monitor standards 👑
• startup_delay — the number of milliseconds to wait on startup, after the video mode has been set, before the game will start. This lets the screen settle on some monitors that don't display an image for a brief interval after changing video modes. It's literally just giving your monitor a second to breathe 🧘
• graphical_startup — if it's non-zero, display the graphical startup screen.
• show_endoom — if it's non-zero, the ENDOOM text screen is displayed when you exit the game. If it's zero, the ENDOOM screen is not displayed. Some of y'all live for that text wall and honestly? Respect.
• png_screenshots — if it's non-zero, screenshots get saved in PNG format. If it's zero, screenshots get saved in PCX format, as Vanilla Doom does. Retro choice, valid choice 💅
• mouse_acceleration_y — the vertical mouse acceleration factor. When the speed of mouse movement exceeds the threshold value (mouse_threshold), the speed is multiplied by this value.
• mouse_threshold_y — the vertical mouse acceleration threshold. When the speed of mouse movement exceeds this threshold value, the speed is multiplied by an acceleration factor (mouse_acceleration).
• snd_samplerate — the sound output sample rate, in Hz. Typical values to use are 11025, 22050, 44100 and 48000. Pick your flavor 🍓
• snd_cachesize — the maximum number of bytes to allocate for caching converted sound effects in memory. If it's set to zero, there is no limit applied. YOLO mode, memory-wise.
• snd_maxslicetime_ms — the maximum size of the output sound buffer size in milliseconds. Sound output is generated periodically in slices. Higher values might be more efficient but will introduce latency to the sound output. The default is 28ms (one slice per tic with the 35fps timer). Efficiency vs. latency, the eternal struggle 😭
• snd_pitchshift — if it's non-zero, sound effects will have their pitch varied up or down by a random amount during play. If it's zero, sound effects play back at their default pitch. Chaos on, or chaos off 🌈
• snd_musiccmd — an external command to invoke to perform MIDI playback. If it's set to the empty string, SDL_mixer's internal MIDI playback is used. This only has any effect when snd_musicdevice is set to General MIDI output. Read that twice, bestie ✨
• snd_dmxoption — the value to set for the DMXOPTION environment variable. If this contains "-opl3", output for an OPL3 chip is generated when in OPL MIDI playback mode. Fancy chip behavior, we love to see it 🎀
• opl_io_port — the I/O port to use to access the OPL chip. Only relevant when using native OPL music playback. Niche but iconic.
• use_libsamplerate — controls whether libsamplerate support is used for performing sample rate conversions of sound effects. Support for this must be compiled into the program. If it's zero, libsamplerate support is disabled. If it's non-zero, libsamplerate is enabled. Increasing values roughly correspond to higher quality conversion; the higher the quality, the slower the conversion process. The levels are:
  • Linear conversion = 1
  • Zero order hold = 2
  • Fast Sinc filter = 3
  • Medium quality Sinc filter = 4
  • High quality Sinc filter = 5

Quality or speed, pick your fighter 💀

• libsamplerate_scale — the scaling factor used by libsamplerate. This is used when converting sounds internally back into integer form; normally it should not be necessary to change it from the default value. The only time it might be needed is if a PWAD file is loaded that contains very loud sounds, in which case the conversion may cause sound clipping and the scale factor should be reduced. The lower the value, the quieter the sound effects become, so it should be set as high as is possible without clipping occurring. Balance, bestie, it's all about balance 🧘
• autoload_path — the full path to a directory where WAD files and dehacked patches can be placed so they get automatically loaded on startup. A subdirectory of this directory matching the IWAD name is checked to find the files to load. Set it and forget it, she'll handle the rest 🫶
• music_pack_path — the full path to a directory containing configuration files for substitute music packs. These packs contain high quality renderings of game music to be played instead of using the system's built-in MIDI playback. Glow-up for your soundtrack ✨
• fsynth_chorus_active — if it's 1, activate the FluidSynth chorus effects module. If it's 0, no chorus will be added to the output signal.
• fsynth_chorus_depth — specifies the modulation depth of the FluidSynth chorus. Default is 5.0, range is 0.0 to 256.0.
• fsynth_chorus_level — specifies the output amplitude of the FluidSynth chorus signal. Default is 0.35, range is 0.0 to 10.0.
• fsynth_chorus_nr — sets the voice count of the FluidSynth chorus signal. Default is 3, range is 0 to 99.
• fsynth_chorus_speed — sets the FluidSynth chorus modulation speed in Hz. Default is 0.3, range is 0.1 to 5.0.
• fsynth_midibankselect — this setting defines how FluidSynth interprets Bank Select messages. The default is "gs". Other possible values are "gm", "xg" and "mma".
• fsynth_polyphony — sets the number of FluidSynth voices that can be played in parallel. Default is 256, range is 1 - 65535.
• fsynth_reverb_active — if it's 1, activate the FluidSynth reverb effects module. If it's 0, no reverb will be added to the output signal.
• fsynth_reverb_damp — sets the amount of FluidSynth reverb damping. Default is 0.4, range is 0.0 to 1.0.
• fsynth_reverb_level — sets the FluidSynth reverb amplitude. Default is 0.15, range is 0.0 - 1.0.
• fsynth_reverb_roomsize — sets the room size (i.e. amount of wet) FluidSynth reverb. Default is 0.6, range is 0.0 - 1.0.
• fsynth_reverb_width — sets the stereo spread of the FluidSynth reverb signal. Default is 0.4, range is 0.0 - 100.0.
• fsynth_gain — fine tune the FluidSynth output level. Default is 1.0, range is 0.0 - 10.0.
• fsynth_sf_path — the full path to a soundfont file to use with FluidSynth MIDI playback. Point her at the good stuff 💅
• timidity_cfg_path — the full path to a Timidity configuration file to use for MIDI playback. The file will be evaluated from the directory where it is evaluated, so there is no need to add "dir" commands into it. Convenient!! 🎀
• gus_patch_path — the path to GUS patch files to use when operating in GUS emulation mode.
• gus_ram_kb — the number of kilobytes of RAM to use in GUS emulation mode. Valid values are 256, 512, 768 or 1024.
• winmm_midi_device — the MIDI device for native Windows MIDI.
• winmm_complevel — the compatibility level for native Windows MIDI, default 1. Valid values are 0 (Vanilla), 1 (Standard), 2 (Full).
• winmm_reset_type — the reset device type for native Windows MIDI, default 1. Valid values are 0 (None), 1 (GM Mode), 2 (GS Mode), 3 (XG Mode).
• winmm_reset_delay — the reset device delay for native Windows MIDI, default 0, median value 100 ms.
• vanilla_keyboard_mapping — if it's non-zero, the game behaves like Vanilla Doom, always assuming an American keyboard mapping. If this has a value of zero, the native keyboard mapping of the keyboard is used. Authenticity or localization, you decide 🦋
• a11y_sector_lighting — if it's zero, this disables sectors changing their light level.
• a11y_extra_lighting — the amount of extra light to add to the game scene. Turn it up, it's giving ✨
• a11y_weapon_flash — if it's zero, this disables weapon flashes changing the ambient light level and flickering of torches. Accessibility queens, this one's for you 👑
• a11y_weapon_palette — if it's zero, this disables weapon palette changes.
• a11y_weapon_pspr — if it's zero, this disables rendering of weapon flashes sprites.
• a11y_palette_changes — set this to zero and you kill all the palette shifting that happens when you take damage, grab an item, or rock the radiation suit. bye bye color chaos 💅
• a11y_invul_colormap — zero it out and the colormap stops doing its thing while you're invulnerable. no dramatic screen tint for you ✨
• player_name — the name you show up as in network games, for identification purposes only. heads up tho: it's only used on the "waiting" screen while everyone's waiting for the match to start 🫶
• grabmouse — if this is non-zero, the mouse gets "grabbed" when you're running in windowed mode so it actually works as an input device. when you're running full screen? this does literally nothing, no effect at all 😌
• novert — non-zero means all vertical mouse movement gets ignored. this is emulating the behavior of the "novert" tool from back in the DOS days that did the exact same thing. vintage icon behavior 💀
• mouse_acceleration — the mouse acceleration factor. when your mouse movement speed goes over the threshold value (mouse_threshold), the speed gets multiplied by this value. speed boost era 🔥
• mouse_threshold — the mouse acceleration threshold. once your mouse speed goes past this value, the speed gets multiplied by an acceleration factor (mouse_acceleration). the two of them are besties, they only work as a pair 🌸
• mouseb_strafeleft — mouse button to strafe left.
• mouseb_straferight — mouse button to strafe right.
• mouseb_turnleft — mouse button to turn left.
• mouseb_turnright — mouse button to turn right.
• mouseb_use — mouse button to "use" an object, eg. a door or switch.
• mouseb_backward — mouse button to move backwards.
• mouseb_prevweapon — mouse button to cycle to the previous weapon.
• mouseb_nextweapon — mouse button to cycle to the next weapon.
• mouseb_invleft — mouse button to move to the left in the inventory.
• mouseb_invright — mouse button to move to the right in the inventory.
• mouseb_useartifact — mouse button to use artifact.
• dclick_use — if non-zero, double-clicking a mouse button acts like pressing the "use" key to use an object in-game, eg. a door or switch. double tap supremacy 🖱️✨
• joystick_guid — an SDL GUID string indicating the joystick to use. an empty string means no joystick is configured at all. she's just not plugged in bestie 🎮
• joystick_index — index of the SDL joystick to use. this one's only relevant when you've got multiple identical joystick devices connected that share the same GUID, and you need to tell them apart. twin controller problems fr fr
• use_analog — if non-zero, you get analog movement when playing with a gamepad. smooth like butter 🧈
• joystick_x_axis — joystick axis to use for horizontal (X) movement.
• joystick_x_invert — if non-zero, movement on the horizontal joystick axis gets inverted. upside down energy 🙈
• joystick_turn_sensitivity — joystick turn analog sensitivity, specified as a value between 0 and 20.
• joystick_y_axis — joystick axis to use for vertical (Y) movement.
• joystick_y_invert — if non-zero, movement on the vertical joystick axis gets inverted.
• joystick_strafe_axis — joystick axis to use for strafing movement.
• joystick_strafe_invert — if non-zero, movement on the joystick axis used for strafing gets inverted.
• joystick_move_sensitivity — joystick move and strafe analog sensitivity, specified as a value between 0 and 20.
• joystick_look_axis — joystick axis to use for looking up and down.
• joystick_look_invert — if non-zero, movement on the joystick axis used for looking gets inverted.
• joystick_look_sensitivity — joystick look analog sensitivity, specified as a value between 0 and 20.
• joystick_physical_button0 — the physical joystick button that corresponds to joystick virtual button #0.
• joystick_physical_button1 — the physical joystick button that corresponds to joystick virtual button #1.
• joystick_physical_button2 — the physical joystick button that corresponds to joystick virtual button #2.
• joystick_physical_button3 — the physical joystick button that corresponds to joystick virtual button #3.
• joystick_physical_button4 — the physical joystick button that corresponds to joystick virtual button #4.
• joystick_physical_button5 — the physical joystick button that corresponds to joystick virtual button #5.
• joystick_physical_button6 — the physical joystick button that corresponds to joystick virtual button #6.
• joystick_physical_button7 — the physical joystick button that corresponds to joystick virtual button #7.
• joystick_physical_button8 — the physical joystick button that corresponds to joystick virtual button #8.
• joystick_physical_button9 — the physical joystick button that corresponds to joystick virtual button #9.
• joystick_physical_button10 — the physical joystick button that corresponds to joystick virtual button #10.
• joystick_physical_button11 — the physical joystick button that corresponds to joystick virtual button #11.
• joystick_physical_button12 — the physical joystick button that corresponds to joystick virtual button #12.
• joystick_physical_button13 — the physical joystick button that corresponds to joystick virtual button #13.
• joystick_physical_button14 — the physical joystick button that corresponds to joystick virtual button #14.
• joystick_physical_button15 — the physical joystick button that corresponds to joystick virtual button #15.
• joystick_physical_button16 — the physical joystick button that corresponds to joystick virtual button #16.
• use_gamepad — if non-zero, you use the SDL_GameController interface instead of the SDL_Joystick interface. glow up for your controller ✨
• gamepad_type — stores the SDL_GameControllerType of the last configured gamepad.
• joystick_x_dead_zone — joystick x axis dead zone, specified as a percentage of the axis max value.
• joystick_y_dead_zone — joystick y axis dead zone, specified as a percentage of the axis max value.
• joystick_strafe_dead_zone — joystick strafe axis dead zone, specified as a percentage of the axis max value.
• joystick_look_dead_zone — joystick look axis dead zone, specified as a percentage of the axis max value.
• joyb_strafeleft — joystick virtual button to make the player strafe left.
• joyb_straferight — joystick virtual button to make the player strafe right.
• joyb_menu_activate — joystick virtual button to activate the menu.
• joyb_toggle_automap — joystick virtual button to toggle the automap.
• joyb_prevweapon — joystick virtual button that cycles to the previous weapon.
• joyb_nextweapon — joystick virtual button that cycles to the next weapon.
• joyb_useartifact — joystick virtual button to activate artifact.
• joyb_invleft — joystick virtual button to move left in the inventory.
• joyb_invright — joystick virtual button to move right in the inventory.
• joyb_flyup — joystick virtual button to fly up.
• joyb_flydown — joystick virtual button to fly down.
• joyb_flycenter — joystick virtual button to center flying.

---

okay now we're getting into keyboard territory and honestly this is where the girlies customize everything 💅

• key_pause — key to pause or unpause the game.
• key_menu_activate — key that activates the menu when pressed.
• key_menu_up — key that moves the cursor up on the menu.
• key_menu_down — key that moves the cursor down on the menu.
• key_menu_left — key that moves the currently selected slider on the menu left.
• key_menu_right — key that moves the currently selected slider on the menu right.
• key_menu_back — key to go back to the previous menu.
• key_menu_forward — key to activate the currently selected menu item.
• key_menu_confirm — key to answer 'yes' to a question in the menu.
• key_menu_abort — key to answer 'no' to a question in the menu.
• key_menu_help — keyboard shortcut to bring up the help screen.
• key_menu_save — keyboard shortcut to bring up the save game menu.
• key_menu_load — keyboard shortcut to bring up the load game menu.
• key_menu_volume — keyboard shortcut to bring up the sound volume menu.
• key_menu_detail — keyboard shortcut to toggle the detail level.
• key_menu_qsave — keyboard shortcut to quicksave the current game.
• key_menu_endgame — keyboard shortcut to end the game.
• key_menu_messages — keyboard shortcut to toggle heads-up messages.
• key_menu_qload — keyboard shortcut to load the last quicksave.
• key_menu_quit — keyboard shortcut to quit the game.
• key_menu_gamma — keyboard shortcut to toggle the gamma correction level.
• key_spy — keyboard shortcut to switch view in multiplayer.
• key_menu_nextlevel — keyboard shortcut to go to next level.
• key_menu_reloadlevel — keyboard shortcut to restart current level or demo.
• key_menu_incscreen — keyboard shortcut to increase the screen size.
• key_menu_decscreen — keyboard shortcut to decrease the screen size.
• key_menu_screenshot — keyboard shortcut to save a screenshot.
• key_menu_cleanscreenshot — keyboard shortcut to save a clean screenshot.
• key_menu_del — key to delete a savegame.
• key_map_toggle — key to toggle the map view.
• key_map_north — key to pan north when in the map view.
• key_map_south — key to pan south when in the map view.
• key_map_east — key to pan east when in the map view.
• key_map_west — key to pan west when in the map view.
• key_map_zoomin — key to zoom in when in the map view.
• key_map_zoomout — key to zoom out when in the map view.
• key_map_maxzoom — key to zoom out the maximum amount when in the map view.
• key_map_follow — key to toggle follow mode when in the map view.
• key_map_grid — key to toggle the grid display when in the map view.
• key_map_mark — key to set a mark when in the map view.
• key_map_clearmark — key to clear all marks when in the map view.
• key_map_overlay — key to toggle the overlay mode when in the map view.
• key_map_rotate — key to toggle the rotate mode when in the map view.
• mouseb_mapzoomin — mouse button to zoom in when in the map view.
• mouseb_mapzoomout — the mouse button that zooms out while you're in the map view. 🗺️
• mouseb_mapmaxzoom — the mouse button that zooms out the max amount while you're in the map view. Like, all the way out. No chill.
• mouseb_mapfollow — the mouse button that toggles follow mode while you're in the map view. 🫶
• key_weapon1 — key to select weapon 1. 🔫
• key_weapon2 — key to select weapon 2.
• key_weapon3 — key to select weapon 3.
• key_weapon4 — key to select weapon 4.
• key_weapon5 — key to select weapon 5.
• key_weapon6 — key to select weapon 6.
• key_weapon7 — key to select weapon 7.
• key_weapon8 — key to select weapon 8. bestie really said "eight whole weapons" and honestly? iconic. 👑
• key_prevweapon — key to cycle to the previous weapon. ⏪
• key_nextweapon — key to cycle to the next weapon. ⏩
• key_arti_quartz — key to use the "quartz flask" artifact. 🍶
• key_arti_urn — key to use the "mystic urn" artifact.
• key_arti_bomb — key to use the "timebomb of the ancients" artifact. 💣
• key_arti_tome — key to use the "tome of power" artifact. 📖
• key_arti_ring — key to use the "ring of invincibility" artifact. 💍
• key_arti_chaosdevice — key to use the "chaos device" artifact.
• key_arti_shadowsphere — key to use the "shadowsphere" artifact. 🌑
• key_arti_wings — key to use the "wings of wrath" artifact. 🦋
• key_arti_torch — key to use the "torch" artifact. 🔥
• key_arti_morph — key to use the "morph ovum" artifact. 🥚
• key_message_refresh — key to re-display the last message. 😭
• key_demo_quit — key to quit the game when recording a demo.
• key_multi_msg — key to send a message during multiplayer games. 💬
• key_multi_msgplayer1 — key to send a message to player 1 during multiplayer games.
• key_multi_msgplayer2 — key to send a message to player 2 during multiplayer games.
• key_multi_msgplayer3 — key to send a message to player 3 during multiplayer games.
• key_multi_msgplayer4 — key to send a message to player 4 during multiplayer games.
• key_reverse — quick 180° reverse. Spinning around so fast it's giving main character energy. 💅
• key_togglenovert — toggle vertical mouse movement.
• crispy_defaultskill — the default difficulty when starting a new game. 🎀
• crispy_fpslimit — limit framerate to this value, in frames per second.
• crispy_gamma — Crispy's own variable to support intermediate and negative gamma levels. ✨
• crispy_lvlwpnsnd — Level Weapon Sounds
• crispy_translucency — enable translucency. 🌈

---

✨ SEE ALSO ✨

• crispy-heretic(6)
• heretic.cfg(5)
• crispy-heretic-setup(6)

---

and that's the whole page, bestie!! go forth and keybind responsibly 🫶

This one came to you courtesy of Crispy Doom 7.1.0, dated 2024-01-23 — crispy-heretic.cfg(5), no cap. 💖✨🎀