chocolate-doom.cfg(5)

NAME
chocolate-doom.cfg - Chocolate Doom configuration file

DESCRIPTION

chocolate-doom.cfg is a configuration file for chocolate-doom(6). This file acts as an auxiliary configuration file; the main configuration options are stored in default.cfg, which contains the same configuration options as Vanilla Doom (for compatibility). chocolate-doom.cfg contains configuration options that are specific to Chocolate Doom only.

chocolate-doom.cfg is normally stored in the user's home directory, as ~/.chocolate-doom/chocolate-doom.cfg.

The chocolate-setup(6) tool provides a simple to use front-end for editing chocolate-doom.cfg.

FILE FORMAT

The file format is the same as that used for default.cfg(5).

CONFIGURATION VARIABLES

autoadjust_video_settings
    If non-zero, video settings will be autoadjusted to a valid configuration when the screen_width and screen_height variables do not match any valid configuration.

fullscreen
    If non-zero, the game will run in full screen mode. If zero, the game will run in a window.

aspect_ratio_correct
    If non-zero, the screen will be stretched vertically to display correctly on a square pixel video mode.

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.

screen_width
    Screen width in pixels. If running in full screen mode, this is the X dimension of the video mode to use. If running in windowed mode, this is the width of the window in which the game will run.

screen_height
    Screen height in pixels. If running in full screen mode, this is the Y dimension of the video mode to use. If running in windowed mode, this is the height of the window in which the game will run.

screen_bpp
    Color depth of the screen, in bits.

grabmouse
    If this is non-zero, the mouse will be "grabbed" when running in windowed mode so that 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).

snd_samplerate
    Sound output sample rate, in Hz. Typical values to use are 11025, 22050, 44100 and 48000.

opl_io_port
    The I/O port to use to access the OPL chip. Only relevant when using native OPL music playback.

show_endoom
    If non-zero, the ENDOOM screen is displayed when exiting the game. If zero, the ENDOOM screen is not displayed.

vanilla_savegame_limit
    If non-zero, the Vanilla savegame limit is enforced; if the savegame exceeds 180224 bytes 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.

vanilla_demo_limit
    If non-zero, the Vanilla demo size limit is enforced; the game exits with an error when a demo exceeds the demo size limit (128KiB by default). If this has a value of zero, there is no limit to the size of demos.

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.

video_driver
    Name of the SDL video driver to use. If this is an empty string, the default video driver is used.

player_name
    Name to use in network games for identification. This is only used on the "waiting" screen while waiting for the game to start.

joystick_index
    Joystick number to use; '0' is the first joystick. A negative value ('-1') indicates that no joystick is configured.

joystick_x_axis
    Joystick axis to use to for horizontal (X) movement.

joystick_x_invert
    If non-zero, movement on the horizontal joystick axis is inverted.

joystick_y_axis
    Joystick axis to use to for vertical (Y) movement.

joystick_y_invert
    If non-zero, movement on the vertical joystick axis is inverted.

joyb_strafeleft
    Joystick button to strafe left.

joyb_straferight
    Joystick button to strafe right.

joyb_prevweapon
    Joystick button to cycle to the previous weapon.

joyb_nextweapon
    Joystick button to cycle to the next weapon.

mouseb_strafeleft
    Mouse button to strafe left.

mouseb_straferight
    Mouse button to strafe 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.

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.

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_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 the green player during multiplayer games.

key_multi_msgplayer2
    Key to send a message to the indigo player during multiplayer games.

key_multi_msgplayer3
    Key to send a message to the brown player during multiplayer games.

key_multi_msgplayer4
    Key to send a message to the red player during multiplayer games.

SEE ALSO
chocolate-doom(6), default.cfg(5), chocolate-setup(6)