chocolate-strife.cfg(5)
🎀 chocolate-strife.cfg(5) — File Formats Manual 🎀
okay bestie, gather round, because this is the manual page for chocolate-strife.cfg, and it's literally the config file that makes Chocolate Strife behave the way you want instead of the way some 1996 executable decided. it's giving "secret second brain" energy and i'm obsessed 💖
✨ NAME ✨
chocolate-strife.cfg — the Chocolate Strife configuration file. that's it, that's the name, iconic. 👑
💅 DESCRIPTION 💅
so chocolate-strife.cfg is a configuration file for chocolate-strife(6). but here's the tea: it's an auxiliary config file, not the main character. the main configuration options live in strife.cfg, which holds all the same config options as Vanilla Strife (because compatibility is queen and we respect her). meanwhile chocolate-strife.cfg is where all the options that are specific to Chocolate-Strife only hang out. it's the VIP section. 🫶
normally chocolate-strife.cfg chills in your home directory, at:
~/.local/share/chocolate-strife/chocolate-strife.cfgbut you can override that path with the XDG_DATA_HOME environment variable (peep the XDG Base Directory Specification if you wanna know more, iykyk).
also!! there's a tool for this: chocolate-strife-setup(6) is a super easy front-end for editing chocolate-strife.cfg if you don't feel like hand-editing text files like a gremlin (no shade, i do it too 💀).
🌸 FILE FORMAT 🌸
the format is literally the same as the one used for strife.cfg(5). same vibes, same rules. ✨
🌈 CONFIGURATION VARIABLES 🌈
here come the options, bestie. this is the whole squad. no skips, no cuts. 💜
🖥️ Video things
video_driver— the name of the SDL video driver you wanna use. if you set it to an empty string, you just get the default video driver. no notes.window_position— where the window sits on your screen when you're running in windowed mode. accepted values are:""(empty string) — meaning "don't care, wherever","center"— puts the window right in the middle of the screen, and"x,y"— puts it at the exact coordinates you type. ✨fullscreen— if it's non-zero, the game runs in full screen mode. if it's zero, the game runs in a window. simple as.video_display— the index of the display the game should run on. heads up though: this does nothing if you're running in windowed mode (fullscreen=0) andwindow_positionisn't set to"center". so basically it only matters in specific setups. 💅aspect_ratio_correct— if it's non-zero, the screen gets stretched vertically so it displays correctly on a square pixel video mode.smooth_pixel_scaling— if it's non-zero, the screen gets smooth scaling. yes, smooth. very demure, very mindful.integer_scaling— if it's non-zero, it forces integer scales for resolution-independent rendering.window_width— the window width when running in windowed mode.window_height— the window height when running in windowed mode.fullscreen_width— the width for the screen mode when running fullscreen. if this andfullscreen_heightare both set to zero, we run fullscreen as a desktop window that covers the entire screen, instead of ever switching screen modes. honestly it should usually be unnecessary to set this value at all. 🙈fullscreen_height— the height for the screen mode when running fullscreen. see the docs forfullscreen_width, same energy.force_software_renderer— if it's non-zero, force the use of a software renderer. this one's for the systems out there lacking hardware acceleration. we love a fallback. 🫶max_scaling_buffer_pixels— the max 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 (the math is mathing but only so much). the default limits it 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 starts. this lets the screen settle on some monitors that don't display an image for a brief interval after changing video modes. patience is a virtue bestie.graphical_startup— if it's non-zero, display the graphical startup screen.show_endoom— if it's non-zero, the ENDOOM text screen shows up when you exit the game. if it's zero, the ENDOOM screen is not displayed. no ENDOOM, no problem.show_diskicon— if it's non-zero, a disk activity indicator shows up when data is read from disk. if it's zero, the disk activity indicator is not displayed.png_screenshots— if it's non-zero, screenshots get saved in PNG format. if it's zero, screenshots are saved in PCX format, exactly like Vanilla Doom does it. nostalgia format, periodt. 📸
🔊 Sound things
snd_samplerate— sound output sample rate, in Hz. typical values to use are11025,22050,44100and48000.snd_cachesize— the max number of bytes to allocate for caching converted sound effects in memory. if you set it to zero, there is no limit applied. unlimited. unhinged. we love her.snd_maxslicetime_ms— the max size of the output sound buffer size, in milliseconds. sound output is generated periodically in slices. higher values might be more efficient, but they'll introduce latency to the sound output (efficiency vs. vibes, the eternal battle). the default is28ms(that's one slice per tic with the 35fps timer, nerd math incoming).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. no random pitch chaos, just pure sound.snd_musiccmd— an external command to invoke for MIDI playback. if you set it to the empty string, SDL_mixer's internal MIDI playback gets used instead. ⚠️ this only has any effect whensnd_musicdeviceis set to General MIDI output, so don't come for me if it does nothing.snd_dmxoption— the value to set for theDMXOPTIONenvironment 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 you're 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 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 ladder goes: Linear conversion =1; Zero order hold =2; Fast Sinc filter =3; Medium quality Sinc filter =4; High quality Sinc filter =5. pick your fighter. 💅libsamplerate_scale— the scaling factor used by libsamplerate. this is used when converting sounds internally back into integer form; normally you should not need to change it from the default value, so don't touch unless you must. 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 set it as high as possible without clipping occurring. balance, bestie, balance. ⚖️
📂 File paths & autoload
autoload_path— the full path to a directory where WAD files and dehacked patches can be placed so they're 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, king behavior. 👑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 ears. 🎧
🧚 FluidSynth stuff (yes, there's a lot, and yes, it's all here)
fsynth_chorus_active— if1, activate the FluidSynth chorus effects module. if0, no chorus will be added to the output signal.fsynth_chorus_depth— specifies the modulation depth of the FluidSynth chorus. default is5.0, range is0.0to256.0.fsynth_chorus_level— specifies the output amplitude of the FluidSynth chorus signal. default is0.35, range is0.0to10.0.fsynth_chorus_nr— sets the voice count of the FluidSynth chorus signal. default is3, range is0to99.fsynth_chorus_speed— sets the FluidSynth chorus modulation speed in Hz. default is0.3, range is0.1to5.0.fsynth_midibankselect— this setting defines how FluidSynth interprets Bank Select messages. the default is"gs". other possible values are"gm","xg"and"mma". choose your bank select lore wisely.fsynth_polyphony— sets the number of FluidSynth voices that can be played in parallel. default is256, range is1-65535.fsynth_reverb_active— if1, activate the FluidSynth reverb effects module. if0, no reverb will be added to the output signal.fsynth_reverb_damp— sets the amount of FluidSynth reverb damping. default is0.4, range is0.0to1.0.fsynth_reverb_level— sets the FluidSynth reverb amplitude. default is0.15, range is0.0-1.0.fsynth_reverb_roomsize— sets the room size (i.e. amount of wet) of the FluidSynth reverb. default is0.6, range is0.0-1.0. get that cathedral vibe. 🏰fsynth_reverb_width— sets the stereo spread of the FluidSynth reverb signal. default is0.4, range is0.0-100.0.fsynth_gain— fine tune the FluidSynth output level. default is1.0, range is0.0-10.0.fsynth_sf_path— the full path to a soundfont file to use with FluidSynth MIDI playback.
🎹 MIDI & GUS 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's no need to add"dir"commands into it. nice, less work for us. 🫶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 are256,512,768or1024. pick your RAM, bestie.winmm_midi_device— the MIDI device for native Windows MIDI.winmm_complevel— the compatibility level for native Windows MIDI, default0. valid values are0(Vanilla),1(Standard),2(Full).winmm_reset_type— the reset device type for native Windows MIDI, default1. valid values are0(None),1(GM Mode),2(GS Mode),3(XG Mode).winmm_reset_delay— the reset device delay for native Windows MIDI, default0, median value100ms.
💀 Vanilla compatibility / limits
vanilla_savegame_limit— if it's non-zero, the Vanilla savegame limit is enforced; if the savegame exceeds180224bytes in size, the game will exit with an error. 😭 if this has a value of zero, there is no limit to the size of savegames. unlimited saves, dangerous power.vanilla_demo_limit— if it's non-zero, the Vanilla demo size limit is enforced; the game exits with an error when a demo exceeds the demo size limit (128KiBby default). if this has a value of zero, there is no limit to the size of demos.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. 🇺🇸 vs 🌍, you decide.
🏷️ Player identity
player_name— the name to use in network games for identification. heads up: this is only used on the"waiting"screen while waiting for the game to start. so it's a cameo appearance, not a starring role. 💅
part 1 done!! part 2 is coming right up, don't go anywhere bestie 🦋
okay so we're still in the config variables, bestie, and this next batch is all about mice, joysticks, and keys. lowkey iconic. 🖱️🎮⌨️
grabmouse— If this is non-zero, the mouse gets "grabbed" when running in windowed mode so it can be used as an input device. When running full screen, this has no effect. 🖱️novert— If non-zero, all vertical mouse movement is ignored. This emulates the behavior of the "novert" tool available under DOS that performs the same function. 🚫🖱️mouse_acceleration— Mouse acceleration factor. When the speed of mouse movement exceeds the threshold value (mouse_threshold), the speed is multiplied by this value. ⚡mouse_threshold— Mouse acceleration threshold. When the speed of mouse movement exceeds this threshold value, the speed is multiplied by an acceleration factor (mouse_acceleration). 📈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. 🔫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. 🖱️🚪joystick_guid— SDL GUID string indicating the joystick to use. An empty string indicates that no joystick is configured. 🎮joystick_index— Index of SDL joystick to use; this is only used in the case where multiple identical joystick devices are connected which have the same GUID, to distinguish between devices. 🔢use_analog— If non-zero, use analog movement when playing with a gamepad. 🕹️joystick_x_axis— Joystick axis to use for horizontal (X) movement. ↔️joystick_x_invert— If non-zero, movement on the horizontal joystick axis is inverted. 🔄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 is 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 is 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 is 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, use the SDL_GameController interface instead of the SDL_Joystick interface. 🎮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. 🔫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_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_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_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. 🔫key_prevweapon— Key to cycle to the previous weapon. 🔫key_nextweapon— Key to cycle to the next weapon. 🔫key_message_refresh— Key to re-display 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_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. 💬
👀 SEE ALSO 👀
this page was brought to you by Chocolate Doom 3.1.1, dated 2024-01-23, for chocolate-strife.cfg(5). periodt. 💅✨
📦 where this page comes from
- fedora 43: chocolate-doom 3.1.1-1.fc43 · GPL-2.0-or-later
- fedora 44: chocolate-doom 3.1.1-1.fc44 · GPL-2.0-or-later
- nixpkgs unstable: chocolate-doom 3.1.1
- ubuntu resolute: chocolate-doom 3.1.1-1 · GPL-2.0-or-later
- ubuntu stonking: chocolate-doom 3.1.1-1 · GPL-2.0-or-later
- 💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms