strife.cfg man page

default.cfg — Chocolate Doom configuration file

Description

default.cfg is the configuration file for chocolate-doom(6).  The configuration options stored in the file are the same as those stored in the original DOS Vanilla Doom. Extra Chocolate Doom-specific options are stored in a separate configuration file, chocolate-doom.cfg.

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

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

File Format

The file is a plain-text file, consisting of a list of configuration options and their values, separated by whitespace.  Each option is stored on a separate line.  Options have different types; an option may have either an integer, floating point or string value.  If the option is of a string type, the value is surrounded by quotes (").

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 it is advisable not to put them in the file; the file is rewritten from scratch every time the game exits, so any invalid lines or comments will be lost.

Some options are used for keyboard key bindings; these are stored as integer values containing the keyboard scan code of the key to be bound to. Boolean values are also stored as integers, with a value of zero usually indicating "false" and a non-zero value indicating "true".

Configuration Variables

mouse_sensitivity

Mouse sensitivity.  This value is used to multiply 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. A value of 31 or greater will cause the game to crash when entering the options menu.

sfx_volume

Volume of sound effects, range 0-15.

music_volume

Volume of in-game music, range 0-15.

show_talk

If non-zero, dialogue text is displayed over characters' pictures when engaging actors who have voices.

voice_volume

Volume of voice sound effects, range 0-15.

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_strafeleft

Keyboard key to strafe left.

key_straferight

Keyboard key to strafe right.

key_useHealth

Keyboard key to use health.

key_invquery

Keyboard key to query inventory.

key_mission

Keyboard key to display mission objective.

key_invPop

Keyboard key to display inventory popup.

key_invKey

Keyboard key to display keys popup.

key_invHome

Keyboard key to jump to start of inventory.

key_invEnd

Keyboard key to jump to end of inventory.

key_invLeft

Keyboard key to scroll left in the inventory.

key_invRight

Keyboard key to scroll right in the inventory.

key_invUse

Keyboard key to use inventory item.

key_invDrop

Keyboard key to drop an inventory item.

key_lookUp

Keyboard key to look up.

key_lookDown

Keyboard key to look down.

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.

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_jump

Mouse button to jump.

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.

joyb_jump

Joystick virtual button that makes the player jump.

screensize

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.

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.

back_flat

Name of background flat used by view border.

nickname

Multiplayer nickname (?).

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.

comport

Serial port number to use for SERSETUP.EXE (unused).

See Also

chocolate-doom(6), chocolate-doom.cfg(5), chocolate-setup(6)

Referenced By

chocolate-strife(6).