crispy-hexen.cfg(5)

💖 NAME 💖

crispy-hexen.cfg — Crispy Hexen configuration file. And yes bestie, you're reading the manual page for crispy-hexen.cfg(5), so you're exactly where you need to be. 🫶

---

✨ DESCRIPTION ✨

okay so crispy-hexen.cfg is a configuration file for crispy-hexen(6). It's like the auxiliary config file — the main configuration options are stored in hexen.cfg, which contains the same configuration options as Vanilla Hexen (for compatibility). crispy-hexen.cfg is where the configuration options that are specific to Crispy-Hexen only live. periodt.

crispy-hexen.cfg is normally stored in the user's home directory, as ~/.local/share/crispy-hexen/crispy-hexen.cfg. The path can be overridden using the XDG_DATA_HOME environment variable (see the XDG Base Directory Specification). 💅

The crispy-hexen-setup(6) tool provides a simple to use front-end for editing crispy-hexen.cfg. Obsessed.

---

🎀 FILE FORMAT 🎀

The file format is the same as that used for hexen.cfg(5). No cap.

---

👑 CONFIGURATION VARIABLES 👑

• video_driver — Name of the SDL video driver to use. If this is an empty string, the default video driver is used. 💖
• window_position — Position of the window on the screen when running in windowed mode. Accepted values are: "" (empty string) - don't care, "center" - place window at center of screen, "x,y" - place window at the specified coordinates. 🪟
• fullscreen — If non-zero, the game will run in full screen mode. If zero, the game will run in a window.
• video_display — Index of the display on which the game should run. This has no effect if running in windowed mode (fullscreen=0) and window_position is not set to "center".
• aspect_ratio_correct — If non-zero, the screen will be stretched vertically to display correctly on a square pixel video mode. ✨
• smooth_pixel_scaling — If non-zero, the screen will have smooth scaling.
• integer_scaling — If non-zero, forces integer scales for resolution-independent rendering.
• window_width — Window width when running in windowed mode.
• window_height — Window height when running in windowed mode.
• fullscreen_width — Width for 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.
• fullscreen_height — Height for screen mode when running fullscreen. See documentation for fullscreen_width.
• force_software_renderer — If non-zero, force the use of a software renderer. For use on systems lacking hardware acceleration. 🫶
• max_scaling_buffer_pixels — Maximum number of pixels to use for intermediate scaling buffer. More pixels mean that the screen can be rendered more precisely, but there are diminishing returns on quality. The default limits to 16,000,000 pixels, which is enough to cover 4K monitor standards. 🔥
• startup_delay — Number of milliseconds to wait on startup after the video mode has been set, before the game will start. This allows the screen to settle on some monitors that do not display an image for a brief interval after changing video modes.
• graphical_startup — If non-zero, display the graphical startup screen.
• png_screenshots — If non-zero, save screenshots in PNG format. If zero, screenshots are saved in PCX format, as Vanilla Doom does.
• mouse_acceleration_y — 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 — 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 — Sound output sample rate, in Hz. Typical values to use are 11025, 22050, 44100 and 48000. 🎧
• snd_cachesize — Maximum number of bytes to allocate for caching converted sound effects in memory. If set to zero, there is no limit applied.
• snd_maxslicetime_ms — 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).
• snd_pitchshift — If non-zero, sound effects will have their pitch varied up or down by a random amount during play. If zero, sound effects play back at their default pitch.
• snd_musiccmd — External command to invoke to perform MIDI playback. If 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.
• snd_dmxoption — 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.
• opl_io_port — The I/O port to use to access the OPL chip. Only relevant when using native OPL music playback.
• 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 zero, libsamplerate support is disabled. If non-zero, libsamplerate is enabled. Increasing values roughly correspond to higher quality conversion; the higher the quality, the slower the conversion process. Linear conversion = 1; Zero order hold = 2; Fast Sinc filter = 3; Medium quality Sinc filter = 4; High quality Sinc filter = 5. 🧚
• libsamplerate_scale — 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.
• autoload_path — Full path to a directory in which WAD files and dehacked patches can be placed to be automatically loaded on startup. A subdirectory of this directory matching the IWAD name is checked to find the files to load. 🌈
• music_pack_path — 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. 🎶
• fsynth_chorus_active — If 1, activate the FluidSynth chorus effects module. If 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 1, activate the FluidSynth reverb effects module. If 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 — Full path to a soundfont file to use with FluidSynth MIDI playback.
• timidity_cfg_path — 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.
• gus_patch_path — Path to GUS patch files to use when operating in GUS emulation mode.
• gus_ram_kb — Number of kilobytes of RAM to use in GUS emulation mode. Valid values are 256, 512, 768 or 1024.
• winmm_midi_device — MIDI device for native Windows MIDI.
• winmm_complevel — Compatibility level for native Windows MIDI, default 1. Valid values are 0 (Vanilla), 1 (Standard), 2 (Full).
• winmm_reset_type — 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 — Reset device delay for native Windows MIDI, default 0, median value 100 ms.
• vanilla_keyboard_mapping — If 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.
• a11y_sector_lighting — If zero, this disables sectors changing their light level.
• a11y_extra_lighting — Amount of extra light to add to the game scene. 💡
• a11y_weapon_flash — If zero, this disables weapon flashes changing the ambient light level and flickering of torches.
• a11y_weapon_palette — If zero, this disables weapon palette changes
• a11y_weapon_pspr — If zero, this disables rendering of weapon flashes sprites.
• a11y_palette_changes — If zero, this disables palette changes upon damage, item pickup, or when wearing the radiation suit. 💜
• a11y_invul_colormap — set this to zero and the colormap stops doing its little shift-into-a-different-palette thing while you're invulnerable 💅 accessibility bestie behaviour, fr.
• player_name — the name the game shows off in network games so everyone knows it's you 👑 ngl it's literally only used on the "waiting" screen while you're waiting for the match to start, that's it.
• grabmouse — non-zero means the mouse gets "grabbed" when you're running windowed, so you can actually use it as an input device 🖱️ when you're full screen this does absolutely nothing, zero effect, nada.
• novert — non-zero and every bit of vertical mouse movement just gets ignored 🙈 it's emulating that old novert tool from the DOS days that did the exact same thing.
• mouse_acceleration — the mouse acceleration factor 🚀 once your mouse movement speed goes over the threshold value (mouse_threshold), the speed gets multiplied by this.
• mouse_threshold — the mouse acceleration threshold ✨ once your mouse movement speed goes over this value, the speed gets multiplied by the acceleration factor (mouse_acceleration).
• mouseb_strafeleft — mouse button for strafing left ⬅️
• mouseb_straferight — mouse button for strafing right ➡️
• mouseb_turnleft — mouse button for turning left ↩️
• mouseb_turnright — mouse button for turning right ↪️
• mouseb_use — mouse button that "uses" stuff, like a door or a switch 🚪 iconic.
• mouseb_backward — mouse button for walking backwards 🦀
• mouseb_prevweapon — mouse button that cycles to the previous weapon 🔫
• mouseb_nextweapon — mouse button that cycles to the next weapon 🔥
• mouseb_useartifact — mouse button to use an artifact 🎀

---

ok bestie we're entering joystick territory now, buckle up 💀

---

• joystick_guid — an SDL GUID string saying which joystick to use 🕹️ an empty string means no joystick is configured at all, it's giving lonely.
• joystick_index — the index of the SDL joystick to use 🌸 this one only matters when you've got multiple identical joystick devices connected with the same GUID and you need to tell them apart.
• use_analog — non-zero and you get analog movement when playing with a gamepad 🎮
• joystick_x_axis — which joystick axis handles horizontal (X) movement ↔️
• joystick_x_invert — non-zero and movement on the horizontal joystick axis gets inverted 🔄
• joystick_turn_sensitivity — joystick turn analog sensitivity, given as a value between 0 and 20 🎚️
• joystick_y_axis — which joystick axis handles vertical (Y) movement ↕️
• joystick_y_invert — non-zero and movement on the vertical joystick axis gets inverted 🔄
• joystick_strafe_axis — which joystick axis handles strafing movement 🦋
• joystick_strafe_invert — non-zero and movement on the joystick axis used for strafing gets inverted 🔄
• joystick_move_sensitivity — joystick move and strafe analog sensitivity, given as a value between 0 and 20 🎚️
• joystick_look_axis — which joystick axis handles looking up and down 👀
• joystick_look_invert — non-zero and movement on the joystick axis used for looking gets inverted 🔄
• joystick_look_sensitivity — joystick look analog sensitivity, given as a value between 0 and 20 🎚️
• joystick_physical_button0 — the physical joystick button that maps to joystick virtual button #0 🎯
• joystick_physical_button1 — the physical joystick button that maps to joystick virtual button #1 🎯
• joystick_physical_button2 — the physical joystick button that maps to joystick virtual button #2 🎯
• joystick_physical_button3 — the physical joystick button that maps to joystick virtual button #3 🎯
• joystick_physical_button4 — the physical joystick button that maps to joystick virtual button #4 🎯
• joystick_physical_button5 — the physical joystick button that maps to joystick virtual button #5 🎯
• joystick_physical_button6 — the physical joystick button that maps to joystick virtual button #6 🎯
• joystick_physical_button7 — the physical joystick button that maps to joystick virtual button #7 🎯
• joystick_physical_button8 — the physical joystick button that maps to joystick virtual button #8 🎯
• joystick_physical_button9 — the physical joystick button that maps to joystick virtual button #9 🎯
• joystick_physical_button10 — the physical joystick button that maps to joystick virtual button #10 🎯
• joystick_physical_button11 — the physical joystick button that maps to joystick virtual button #11 🎯
• joystick_physical_button12 — the physical joystick button that maps to joystick virtual button #12 🎯
• joystick_physical_button13 — the physical joystick button that maps to joystick virtual button #13 🎯
• joystick_physical_button14 — the physical joystick button that maps to joystick virtual button #14 🎯
• joystick_physical_button15 — the physical joystick button that maps to joystick virtual button #15 🎯
• joystick_physical_button16 — the physical joystick button that maps to joystick virtual button #16 🎯
• use_gamepad — non-zero and the game uses the SDL_GameController interface instead of the SDL_Joystick interface 🎮 periodt.
• gamepad_type — stores the SDL_GameControllerType of the last configured gamepad 📝
• joystick_x_dead_zone — joystick x axis dead zone, given as a percentage of the axis max value 🎯
• joystick_y_dead_zone — joystick y axis dead zone, given as a percentage of the axis max value 🎯
• joystick_strafe_dead_zone — joystick strafe axis dead zone, given as a percentage of the axis max value 🎯
• joystick_look_dead_zone — joystick look axis dead zone, given as a percentage of the axis max value 🎯
• joyb_strafeleft — joystick virtual button that makes the player strafe left ⬅️
• joyb_straferight — joystick virtual button that makes the player strafe right ➡️
• joyb_menu_activate — joystick virtual button that activates the menu 📋
• joyb_toggle_automap — joystick virtual button that toggles 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 that activates an artifact 🎀
• joyb_invleft — joystick virtual button that moves left in the inventory 🎒
• joyb_invright — joystick virtual button that moves right in the inventory 🎒
• joyb_flyup — joystick virtual button that flies up 🦅
• joyb_flydown — joystick virtual button that flies down 🪂
• joyb_flycenter — joystick virtual button that centers flying 🧚

---

and now… the keyboard keys ⌨️ there are so many bestie, we're gonna get through them together 🫶

---

• key_pause — key that pauses or unpauses the game ⏸️
• key_menu_activate — key that activates the menu when you press it 📋
• key_menu_up — key that moves the cursor up in the menu ⬆️
• key_menu_down — key that moves the cursor down in the menu ⬇️
• key_menu_left — key that moves the currently selected slider on the menu to the left 🎚️
• key_menu_right — key that moves the currently selected slider on the menu to the right 🎚️
• key_menu_back — key that goes back to the previous menu ↩️
• key_menu_forward — key that activates the currently selected menu item ✅
• key_menu_confirm — key that answers 'yes' to a question in the menu 💖
• key_menu_abort — key that answers 'no' to a question in the menu 🙅
• key_menu_help — keyboard shortcut that brings up the help screen 🆘
• key_menu_save — keyboard shortcut that brings up the save game menu 💾
• key_menu_load — keyboard shortcut that brings up the load game menu 📂
• key_menu_volume — keyboard shortcut that brings up the sound volume menu 🔊
• key_menu_detail — keyboard shortcut that toggles the detail level 🔍
• key_menu_qsave — keyboard shortcut that quicksaves the current game ⚡💾
• key_menu_endgame — keyboard shortcut that ends the game 🛑
• key_menu_messages — keyboard shortcut that toggles heads-up messages 💬
• key_menu_qload — keyboard shortcut that loads the last quicksave ⚡📂
• key_menu_quit — keyboard shortcut that quits the game 🚪
• key_menu_gamma — keyboard shortcut that toggles the gamma correction level ☀️
• key_spy — keyboard shortcut that switches view in multiplayer 👀
• key_menu_nextlevel — keyboard shortcut that goes to the next level ⏭️
• key_menu_reloadlevel — keyboard shortcut that restarts the current level or demo 🔁
• key_menu_incscreen — keyboard shortcut that increases the screen size 🔎
• key_menu_decscreen — keyboard shortcut that decreases the screen size 🔍
• key_menu_screenshot — keyboard shortcut that saves a screenshot 📸
• key_menu_cleanscreenshot — keyboard shortcut that saves a clean screenshot ✨📸
• key_menu_del — key that deletes a savegame 🗑️
• key_map_toggle — key that toggles the map view 🗺️
• key_map_north — key that pans north when you're in the map view ⬆️
• key_map_south — key that pans south when you're in the map view ⬇️
• key_map_east — key that pans east when you're in the map view ➡️
• key_map_west — key that pans west when you're in the map view ⬅️
• key_map_zoomin — key that zooms in when you're in the map view 🔎
• key_map_zoomout — key that zooms out when you're in the map view 🔍
• key_map_maxzoom — key that zooms out the maximum amount when you're in the map view 🔭
• key_map_follow — key that toggles follow mode when you're in the map view 👣
• key_map_grid — key that toggles the grid display when you're in the map view ▦
• key_map_mark — key that sets a mark when you're in the map view 📍
• key_map_clearmark — key that clears all marks when you're in the map view 🧹
• key_map_overlay — key that toggles the overlay mode when you're in the map view 🧩
• key_map_rotate — key that toggles the rotate mode when you're in the map view 🔄
• mouseb_mapzoomin — mouse button that zooms in when you're in the map view 🔎
• mouseb_mapzoomout — mouse button that zooms out when you're in the map view 🔍
• mouseb_mapmaxzoom — mouse button that zooms out the max amount when you're in the map view 🔭
• mouseb_mapfollow — mouse button that toggles follow mode when you're in the map view 👣
• key_weapon1 — key that selects weapon 1 🔫
• key_weapon2 — key that selects weapon 2 🔫
• key_weapon3 — the key that selects weapon 3, periodt 💅
• key_weapon4 — key to select weapon 4, no cap ✨
• key_weapon5 — key to select weapon 5, bestie 🎀
• key_weapon6 — key to select weapon 6, lowkey essential 💖
• key_weapon7 — key to select weapon 7, iconic 🦋
• key_weapon8 — key to select weapon 8, slay 🌸
• key_prevweapon — key to cycle to the previous weapon, the way that it goes backwards 🔄
• key_nextweapon — key to cycle to the next weapon, main character energy forward vibes 💫
• key_arti_all — key to use one of each artifact, go absolutely feral with it 👑
• key_arti_health — key to use the "quartz flask" artifact, heal up bestie 🧪
• key_arti_poisonbag — key to use the "flechette" artifact, little poison moment 🍓
• key_arti_blastradius — key to use the "disc of repulsion" artifact, push everything away 💥
• key_arti_teleport — key to use the "chaos device" artifact, teleport slay ✨
• key_arti_teleportother — key to use the "banishment device" artifact, send them elsewhere 🌀
• key_arti_egg — key to use the "porkalator" artifact, yes that's literally the name 🐷
• key_arti_invulnerability — key to use the "icon of the defender" artifact, unkillable era 🛡️
• key_message_refresh — key to re-display the last message, in case you missed it 🙈
• key_demo_quit — key to quit the game when recording a demo, bye bestie 👋
• key_multi_msg — key to send a message during multiplayer games, chatty queen 💬
• 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_multi_msgplayer5 — key to send a message to player 5 during multiplayer games 📨
• key_multi_msgplayer6 — key to send a message to player 6 during multiplayer games 📨
• key_multi_msgplayer7 — key to send a message to player 7 during multiplayer games 📨
• key_multi_msgplayer8 — key to send a message to player 8 during multiplayer games 📨
• key_reverse — quick 180° reverse, spin around like a pop star 🎤
• crispy_crosshairtype — crosshair type, pick your little aim vibe 🎯
• crispy_crosshaircolor — crosshair color, aesthetic choices only 🌈
• crispy_defaultskill — default difficulty when starting a new game, choose your chaos level 🔥
• crispy_fpslimit — limit framerate to this value in frames per second, smooth or speedy, your call ⏱️
• crispy_gamma — Crispy's variable to support intermediate and negative gamma levels, brightness girlies rise ☀️
• crispy_translucency — enable translucency, see-through slay 💎

---

🌈 SEE ALSO 🌈

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

---

okay that's the whole page bestie 💖 this was crispy-hexen.cfg(5) from Crispy Doom 7.1.0, dated 2024-01-23 — go forth and configure your keybinds, ily 🫶✨