Options (OpenXcom)

User Folder

OpenXcom creates a User folder with all the screenshots, savegames and options in one of the following paths:

• C:\Documents and Settings\<user>\My Documents\OpenXcom (Windows 2000/XP)
• C:\Users\<user>\Documents\OpenXcom (Windows Vista/7)
• ~/Library/Application Support/OpenXcom (Mac OS X)
• $XDG_DATA_HOME/openxcom (Linux)
• $XDG_CONFIG_HOME/openxcom (Linux)
• <working directory>\user\
• <binary directory>\user\

You can also specify your own path by passing the command-line argument "-user <user path>".

Options

OpenXcom stores various game settings in the options.cfg YAML file stored in the User folder, which can be easily edited with any text editor. You can also pass them as command line arguments in the form "-<option name> <option value>".

WARNING: Invalid values can cause incorrect behaviour or game crashes.

System

• displayWidth: Display width in pixels.
• displayHeight: Display height in pixels.
• fullscreen: Fullscreen (true) or windowed (false) display.
• musicVolume: Background music volume (0-128).
• soundVolume: Sound FX volume (0-128).
• mute: Disable all audio output (true/false). Automatically enabled if no audio hardware is available.
• audioBitDepth: Bit depth of the output audio. Only change this if you know what you're doing!
• audioSampleRate: Sample rate (in Hz) of the output audio. Only change this if you know what you're doing!
• debug: Debug mode (true/false), provides features to make it easier for developers/contributors to debug their work.
• debugUi: Shows text borders in UI elements to make it easier for developers/translators to debug their work (true/false).
• fpsCounter: Shows FPS Counter on the top-left of the screen (true/false).
• language: Filename of the language loaded at startup.
• keyboardMode: Keyboard input mode. 0 = Keyboard enabled. 1 = Keyboard disabled, type in text boxes with the arrow keys (arcade style).

Geoscape

• craftLaunchAlways: Allow crafts to take off without being READY (true/false).
• globeSeasons: The globe lighting changes according to seasons (true/false).

Battlescape

• battleAlienSpeed: Alien unit movement speed.
• battleAltGrenade: Hot grenade behaviour (true/false).
• battlePreviewPath: Preview path + second click to confirm the path (true/false).
• battleFireSpeed: Bullet movement speed.
• battleRangeBasedAccuracy: Range-based accuracy (true/false).
• battleScrollSpeed: Map scrolling speed.
• battleScrollType: Map scrolling mode (0 = Trigger Scroll, 1 = Auto Scroll, 2 = RMB Scroll).
• battleXcomSpeed: X-COM unit movement speed.

Keyboard Shortcuts

• F5 – Toggles a FPS counter in top-left corner.
• F12 – Saves BMP screenshot to User folder.
• ALT-ENTER – Toggles fullscreen mode.

Custom Music

If you don't like or have trouble getting the original X-COM music to work, you can use your own (eg. the Playstation or Cydonia's Fall soundtracks) by putting it in the SOUND subfolder of the Data folder with the same filenames as the original:

• GMDEFEND - Base Defense Briefing.
• GMENBASE - Mission Briefing.
• GMGEO1 - Geoscape 1.
• GMGEO2 - Geoscape 2.
• GMINTER - Interception / Dogfight.
• GMINTRO1 - Intro 1.
• GMINTRO2 - Intro 2.
• GMINTRO3 - Intro 3.
• GMLOSE - Game Over.
• GMMARS - Debriefing.
• GMNEWMAR - Mars Briefing.
• GMSTORY - Title.
• GMTACTIC - Battlescape.
• GMWIN - Victory.

The formats supported are MIDI, MP3, OGG and MOD. You might need to delete the original music (including GM.CAT) for it to work.