UFOpaedia - User contributions [en]

Options (OpenXcom)

2014-06-22T16:24:23Z

Cfailde: /* Options File */ alienContainmentLimitEnforced renamed to storageLimitsEnforced

[[Image:OpenXcom options screen.gif|right|thumb|OpenXcom Options screen]]

OpenXcom has a variety of game settings that can be customized through the Options screen in the Main Menu. These options are global and affect any old or new savegame, and take effect instantly after pressing OK.

== Display Filter ==

By default OpenXcom just resizes the screen to fit the resolution, maintaining pixel accuracy as in the original game, but a variety of [[:Wikipedia:Image scaling|image scaling]] filters can be applied to change the image quality or apply smoothing and emulation effects:
* '''Scale''': Smooths out edges, making the game look less pixelated. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions.
* '''HQX''': Similar to '''Scale''', but more accurate and high-quality. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions.
* '''CRT (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''CRT-interlaced (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''CRT-simple (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''Curvature (OpenGL)''': Simulates a rounded display.
* '''dot_n_bloom (OpenGL)''' Applies both a dot grid effect and a bloom effect.
* '''heavybloom (OpenGL)''': Applies a very heavy bloom effect.
* '''HQ2X (OpenGL)''': A double-scale version of '''HQX''', which smoothes pixel edges, but not quite to the extreme of '''HQX'''.
* '''Openxcom (OpenGL)''': Smooths rough edges while maintaining a semi-pixellated feel similar to the original X-Com. (default)
* '''Phosphor-simple (OpenGL)''' Applies a dot grid effect.
* '''Pixellate (OpenGL)''': Default pixel-accurate behaviour, but using OpenGL.
* '''SABR (OpenGL)''': Applies texel-based smoothing to the display.
* '''Scale4xHQ (OpenGL)''': A quadruple-scale version of '''HQX''', which results in a more subtle smoothing of pixel edges.
* '''simplebloom (OpenGL)''': Applies a bloom effect.

== Controls ==

In the ''Controls'' screen you can customize keyboard shortcuts for a variety of functions normally only accessible with the mouse. To change a control, left-click on it and press the new key. To erase a control, right-click it.

Besides the controls listed on the screen, there are also these hardcoded shortcuts:

*'''ALT-ENTER''' – Toggles between windowed and fullscreen mode.
*'''Right-Click''' - Automatically set the min/max on an increase/decrease arrow button.
*'''Scroll Wheel''' - Scroll lists / Zoom globe / Change Battlescape view level.
*'''Back/Forward Buttons''' - (if available) Switch between soldiers on the Battlescape.

== Advanced Options ==

By default OpenXcom is set up for vanilla behavior, but provides a variety of options that allow players to change gameplay features. In the ''Advanced Options'' screen you can customize the most-popular options to your preference, and further options can be found in the Options File described below.

== Custom Music ==

If you don't like or have trouble getting the original X-COM music to work, you can use your own. The formats supported are MIDI, MP3, OGG, MOD and FLAC. Just put it in the [[SOUND]] subfolder of the [[Installing (OpenXcom)#Data Folder|Data folder]] with the same filenames as the original:

{| class="wikitable"
! Original
! PlayStation
! Cydonia's Fall
|-
| GMDEFEND
| Briefing1
| Defend Base
|-
| GMENBASE
| Briefing2
| N/A
|-
| GMGEO1
| Geoscape1
| Geoscape (Part I)
|-
| GMGEO2
| Geoscape2
| Geoscape (Part II)
|-
| GMGEO3*
| Geoscape3
| N/A
|-
| GMGEO4*
| Geoscape4
| N/A
|-
| GMINTER
| Dogfight
| Interception
|-
| GMINTRO1
| N/A
| Intro (Part I)
|-
| GMINTRO2
| N/A
| Intro (Part II)
|-
| GMINTRO3
| N/A
| Intro (Part III)
|-
| GMLOSE
| N/A
| Lose Game
|-
| GMMARS
| Debriefing
| Debriefing
|-
| GMNEWMAR
| Mission Accomplished
| Mars Briefing
|-
| GMSTORY
| Final Briefing
| The Story
|-
| GMTACTIC
| Battlescape1
| Tactical Battle
|-
| GMTACTIC2*
| Battlescape2
| N/A
|-
| GMWIN
| N/A
| Win Game
|}

''*not available in original''

'''WARNING:''' There are some bugs with the audio playback on MP3, primarily on Unix-like systems. If you start experiencing crashes after using custom music, switch to a different music format.

== Options File ==

OpenXcom stores its options in a ''options.cfg'' YAML file stored in the [[Installing (OpenXcom)#User Folder|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>". These include the options shown in the Options screen as well as other advanced options.

'''WARNING:''' Invalid values can cause incorrect behaviour or game crashes. Options that accept true/false are marked by "When enabled", options that accept a range of numbers have this listed in brackets after their description, and options that accept a numeric flag have bullets to describe the functionality of each option.

{| class="wikitable"
! Option
! Description
! Default
|-

! colspan="3" style="background-color: #CCCCCC" | General

|-
| '''autosave'''
| When enabled, the game is autosaved every ten Geoscape days and five Battlescape turns to dedicated slots.
| true
|-
| '''autosaveFrequency'''
| Autosaves the game every X amount of Battlescape turns.
| 5
|-
| '''captureMouse'''
| When enabled, the mouse cursor is locked to the window.
| false
|-
| '''changeValueByMouseWheel'''
| The amount to increase/decrease a value when scrolling the mouse wheel over increase/decrease buttons.
| 0
|-
|'''cursorInBlackBandsInFullscreen'''<br />
'''cursorInBlackBandsInWindow'''<br />
'''cursorInBlackBandsInBorderlessWindow'''
| When enabled, the mouse cursor can move into the black bands added by letterboxing.
|
false<br />
true<br />
false
|-
| '''debug'''
| When enabled, provides features to make it easier for developers/contributors to debug their work. See [[Hidden Features (OpenXcom)#Debug Mode|Debug Mode]].
| false
|-
| '''debugUi'''
| When enabled, shows text borders in UI elements to make it easier for developers/translators to debug their work.
| false
|-
| '''dragScrollTimeTolerance'''
| Amount of milliseconds the mouse needs to be pressed to trigger a Drag Scroll.
| 300
|-
| '''dragScrollPixelTolerance'''
| Amount of pixels the mouse needs to be moved after pressing to trigger a Drag Scroll.
| 10
|-
| '''FPS'''
| Limits the game to this many [[Wikipedia:Frame rate|frames per second]]. Doesn't apply when [[Wikipedia:Vsync|Vsync]] is used.
| 60
|-
| '''fpsCounter'''
| When enabled, shows an FPS Counter on the top-left of the screen.
| false
|-
| '''keyboardMode'''
| Keyboard input mode for typing in text boxes..
* 0 = No keyboard, use the arrow keys to type (arcade style).
* 1 = Use the system keyboard to type.
* 2 = Pops up a virtual keyboard to type (not implemented).
| 0
|-
| '''key*'''
| (...various options starting with this prefix) Stores the keyboard controls.
|
|-
| '''language'''
| Filename of the language loaded at startup.
| en-US
|-
| '''maximizeInfoScreens'''
| When enabled, info screens are always shown at the original resolution instead of using the base resolution setting.
| false
|-
| '''mousewheelSpeed'''
| Specifies the amount of lines scrolled by the mousewheel.
| 3
|-
| '''newSeedOnLoad'''
| When enabled, uses a new seed for the random number generator instead of the one saved to a save file. The game saves the seed of its random number generator to the save files, so normally a shot's result is the same even if the saved game is reloaded. With a new seed the game re-randomises a shot's chance of success.
| false
|-
| '''pauseMode'''
| Controls how the game behaves when it loses focus (eg. minimized or alt-tabbed).
* 0,1 = Continue running normally on loss of focus.
* 2 = Slow down the game on loss of focus.
* 3 = Pause completely on loss of focus.
| 0
|-
| '''playIntro'''
| When enabled, plays the intro cinematic on startup.
| true
|-
| '''saveOrder'''
| Controls the order in which saved games are displayed in the save/load game menus.
* 0 Ascending name order, i.e. A to Z.
* 1 Descending name order, i.e. Z to A.
* 2 Ascending date order, i.e. oldest saves first.
* 3 Descending date order, i.e. newest saves first.
| 3
|-

! colspan="3" style="background-color: #CCCCCC" | Display

|-
| '''allowResize'''
| When enabled and the game is in windowed mode, the game resolution can be dynamically resized by changing the window size.
| false
|-
| '''asyncBlit'''
| When enabled, the display surface uses asynchronous updates. This will usually slow down blitting on single CPU machines, but may provide a speed increase on SMP systems.
| true
|-
| '''baseXBattlescape'''
'''baseYBattlescape'''
| The Battlescape's base resolution in pixels, you can think of it as the "viewport", so changing this would let you see more at once.
| 320
200
|-
| '''baseXGeoscape'''
'''baseYGeoscape'''
| The Geoscape's base resolution in pixels, you can think of it as the "viewport", so changing this would let you see more at once.
| 320
200
|-
| '''baseXResolution'''
'''baseYResolution'''
| The game's base resolution in pixels, you can think of it as the "viewport", so changing this would let you see more of the Geoscape/Battlescape at once.
| 320
200
|-
| '''borderless'''
| When enabled, the game is displayed without a window frame when playing in windowed mode.
| false
|-
| '''displayWidth'''
'''displayHeight'''
| Display resolution in pixels. The game will scale the base resolution to fit this value, so it should be greater than or equal to '''baseXResolution''' x '''baseYResolution.
| 640
400
|-
| '''fullscreen'''
| When enabled, the game will run in fullscreen mode as opposed to windowed mode.
'''NOTE''': The display might become distorted or clipped in fullscreen if your device doesn't support the specified resolution.
| false
|-
| '''keepAspectRatio'''
| When enabled, letterboxes the display to maintain the original aspect ratio.
| false
|-
| '''maxFrameSkip'''
| Specifies the maximum amount of frames the game can skip rendering.
| 0
|-
| '''windowedModePositionX'''
'''windowedModePositionY'''
| When running in windowed mode, forces the game window to start in the specified position in pixels. Use -1 to have the OS decide the window position.
| -1
-1
|-
| '''useHQXFilter'''
| When enabled, applies a rendering filter that smoothes out diagonal edges, making the game look less pixelated. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions, and '''useOpenGL''' must be disabled.
| false
|-
| '''useScaleFilter'''
| When enabled, passes the game through a software Scale2x filter. This option achieves similar results to '''useHQXFilter''' but with less overhead and slightly less quality. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions, and '''useOpenGL''' must be disabled.
| false
|-
| '''useOpenGL'''
| When enabled, uses [[Wikipedia:OpenGL|OpenGL]] hardware rendering and enables the following OpenGL options:
| false
|-
| '''checkOpenGLErrors'''
| When enabled, logs all errors returned by OpenGL.
| false
|-
| '''useOpenGLShader'''
| Selects which [[Wikipedia:GLSL|GLSL]] rendering filter to apply when the '''useOpenGL''' option is enabled. This option takes a path relative to the OpenXcom Data Folder as an argument. OpenXcom comes packaged with some filters in the ''data\Shaders'' folder which are described earlier in ''Display Filter''.
| Shaders/Openxcom.OpenGL.shader
|-
| '''useOpenGLSmoothing'''
| When enabled, the game will use linear interpolation instead of nearest-neighbour pixel scaling when no shader is specified.
| true
|-
| '''vSyncForOpenGL'''
| When enabled, puts OpenGL into [[Wikipedia:Vsync|vertical synchronisation]] mode, ensuring the FPS do not exceed your monitor's refresh rate, preventing tearing and excessive hardware demand, but may cause slower animations.
| true
|-

! colspan="3" style="background-color: #CCCCCC" | Sound

|-
| '''audioBitDepth'''
| Bit depth of the output audio. ''Only change this if you know what you're doing!''
| 16
|-
| '''audioSampleRate'''
| Sample rate (in Hz) of the output audio. ''Only change this if you know what you're doing!''
| 22050
|-
| '''musicAlwaysLoop'''
| Forces every music track to loop, including the Main Menu and Win/Lose tracks.
| false
|-
| '''musicVolume'''
| Background music volume (0-128).
| 128
|-
| '''preferredMusic'''
| Preferred background music format:
* 0 = Auto - Picks the best available format in the following order:
* 1 = 1.4 Format
* 2 = 1.0 Format
| 0
|-
| '''preferredSound'''
| Preferred sound FX format.
* 0 = Auto - Picks the best available format in the following order:
* 1 = FLAC
* 2 = OGG
* 3 = MP3
* 4 = MOD
* 5 = WAV
* 6 = Adlib
* 7 = MIDI
| 0
|-
| '''soundVolume'''
| Sound FX volume (0-128).
| 128
|-
| '''uiVolume'''
| User interface volume (0-128).
| 128
|-

! colspan="3" style="background-color: #CCCCCC" | Geoscape/Basescape

|-
| '''aggressiveRetaliation'''
| When enabled, aliens on any type of mission may detect your base if they are in very close range.
| false
|-
| '''allowBuildingQueue'''
| When enabled, unfinished facilities act as links to the access lift when new facilities are placed, thereby allowing facilities to be "queued" waiting for neighboring facilities to finish.
| false
|-
| '''allowPsiStrengthImprovement'''
| When enabled, soldiers can improve their [[Psi Strength]] through practice and psi training.
| false
|-
| '''anytimePsiTraining'''
| When enabled, psi training can be performed at any time, instead of waiting for the end of the month.
| false
|-
| '''canManufactureMoreItemsPerHour'''
| When enabled, allows manufacturing projects to produce more than one item per hour, if the amount of engineers is very large (like in [[TFTD]]).
| false
|-
| '''canSellLiveAliens'''
| When enabled, captured aliens can be sold for cash in the same fashion as alien corpses. Recommended when '''storageLimitsEnforced''' is enabled.
| false
|-
| '''canTransferCraftsWhileAirborne'''
| When enabled, crafts can be transferred between bases while they are OUT (as long as they have enough fuel).
| false
|-
| '''craftLaunchAlways'''
| When enabled, allow crafts to take off without being READY.
| false
|-
| '''customInitialBase'''
| When enabled, allows the player to customize the facility placement of the starting base.
|-
| '''dogfightSpeed'''
| The animation speed of dogfights.
| 20
|-
| '''geoscapeScale'''
| The base resolution to use for the Geoscape:
* 0 = Original = 320x200 resolution
* 1 = 1.5x Original = 480x300 resolution
* 2 = 2x Original = 640x400 resolution
* 3 = 1/3 Display Resolution
* 4 = 1/2 Display Resolution
* 5 = Full Display Resolution
| 0
|-
| '''geoClockSpeed'''
| The speed of the Geoscape clock.
| 80
|-
| '''geoDragScrollButton'''
| Controls which mouse button is held down when Drag Scrolling the globe.
* 0 = None
* 1 = Left Mouse Button.
* 2 = Middle Mouse Button.
* 3 = Right Mouse Button.
* 6... = Other Mouse Buttons.
| 2
|-
| '''geoDragScrollInvert'''
| When enabled, Drag Scrolling moves the globe away from your mouse, rather than moving towards it.
| false
|-
| '''globeAllRadarsOnBaseBuild'''
| When enabled, all radar ranges will be shown when hovering a valid base location while building a new base.
| true
|-
| '''globeDetail'''
| When enabled, country and city details are shown when zoomed in on the globe.
| true
|-
| '''globeFlightPaths
| When enabled, shows craft flight paths on the globe.
| true
|-
| '''globeRadarLines
| When enabled, the radar ranges of player bases on the globe are shown.
| true
|-
| '''globeScrollSpeed
| The scrolling speed of the globe.
| 20
|-
| '''globeSeasons'''
| When enabled, the day/night cycle takes into account the Earth's [[:Wikipedia:Axial tilt|axial tilt]] for a more realistic projection of the light.
| false
|-
| '''psiStrengthEval'''
| When enabled, evaluates the psionic strength of all soldiers after the appropriate research has been completed.
| false
|-
| '''spendResearchedItems'''
| When enabled, researching an item removes it from stores and disassembles it, like in [[XCOM (2012)]], and researching a living alien returns a corpse to the stores.
| false
|-
| '''showFundsOnGeoscape'''
| When enabled, shows your available funds above the time/date on the Geoscape sidebar.
| false
|-
| '''storageLimitsEnforced'''
| When enabled, enforces the limit of live aliens that can be held in each containment facility as well as general stores limits for recovered items.
| false
|-

! colspan="3" style="background-color: #CCCCCC" | Battlescape

|-
| '''allowPsionicCapture'''
| When enabled, mind-controlling all the remaining enemy units results in a victory, and they count as live captures.
| false
|-
| '''alienBleeding'''
| When enabled, allows the player to inflict [[Fatal Wounds]] on aliens.
| false
|-
| '''battlescapeScale'''
| The base resolution to use for the Battlescape:
* 0 = Original = 320x200 resolution
* 1 = 1.5x Original = 480x300 resolution
* 2 = 2x Original = 640x400 resolution
* 3 = 1/3 Display Resolution
* 4 = 1/2 Display Resolution
* 5 = Full Display Resolution
| 0
|-
| '''battleAlienSpeed'''
| Animation speed of alien / civilian units moving on the map.
| 30
|-
| '''battleAutoEnd'''
| When enabled, the turn is automatically ended when all friendly/enemy units are neutralized, therefore ending the mission.
| false
|-
| '''battleConfirmFireMode'''
| When enabled, a second click is required on the same tile to confirm fire orders.
| false
|-
| '''battleDragScrollButton'''
| Controls which mouse button is held down in Drag Scrolling
* 0 = None
* 1 = Left Mouse Button.
* 2 = Middle Mouse Button.
* 3 = Right Mouse Button.
* 6... = Other Mouse Buttons.
| 2
|-
| '''battleDragScrollInvert'''
| When enabled, Drag Scrolling moves the camera away from your mouse, rather than moving towards it.
| false
|-
| '''battleEdgeScroll'''
| Map edge scrolling mode.
* 0 = None
* 1 = Trigger Scroll: Hold down the LMB over the edges of the screen to scroll.
* 2 = Auto Scroll: Hover your mouse over the edges of the screen to scroll.
| 2
|-
| '''battleExplosionHeight'''
| A coefficient that controls how much vertical power explosions have.
* 0 = Explosions are completely flat, as per the original game.
* 1 = -30 damage units per level (this penalty is in addition to the horizontal penalty of -10 damage per tile).
* 2 = -10 damage units per level.
* 3 = -5 damage units per level.
| 0
|-
| '''battleFireSpeed'''
| Animation speed of bullets after being fired in pixels per frame. Game setting * 2.
| 6
|-
| '''battleHairBleach'''
| Changes soldier Battlescape sprites to match their inventory look.
| true
|-
| '''battleInstantGrenade'''
| When enabled, grenades are "hot". This means that when primed to 0 turns, they simply explode on impact, instead of waiting for the end of the turn.
| false
|-
| '''battleNotifyDeath'''
| When enabled, displays a text notification when a soldier dies.
| false
|-
| '''battleNewPreviewPath'''
| When enabled, your first left-click displays the path the selected unit will take, and your second click confirms the move order.
* 0 No preview.
* 1 Display path taken with colored arrows: green - can move and fire; yellow - can move; red - cannot move.
* 2 Display the time units you will have remaining after moving to the destination.
* 3 Display colored arrows and time units remaining.
| 0
|-
| '''battleSmoothCamera'''
| When enabled, the battlescape camera will remain centered on projectiles while in flight.
| false
|-
| '''battleScrollSpeed'''
| Map scrolling speed.
| 8
|-
| '''battleTooltips'''
| When enabled, hovering the Battlescape buttons displays a tooltip.
| true
|-
| '''battleUFOExtenderAccuracy'''
| When enabled, mimics [[UFOextender#Range_Based_Accuracy|UFO Extender's Range based accuracy]], except using stats taken from the weapon itself rather than global config options.
| false
|-
| '''battleXcomSpeed'''
| Animation speed of X-COM units moving on the map.
| 30
|-
| '''disableAutoEquip'''
| When enabled, disables auto-equipping of new soldiers before battle.
| false
|-
| '''fieldPromotions'''
| When enabled, only soldiers that were in the battle can get promoted.
| false
|-
| '''noAlienPanicMessages'''
| When enabled, doesn't show messages when an alien unit panics or goes berserk.
| false
|-
| '''skipNextTurnScreen'''
| When enabled, the "Next Turn" screens during battle are advanced automatically after a short delay.
| false
|-
| '''showMoreStatsInInventoryView'''
| When enabled, the inventory screen displays extra stats in the top-right corner, such as the weight of equipment the soldier is currently wearing/carrying and their maximum weight before TU reduction sets in, their firing accuracy, reactions and psi stats.
| false
|-
| '''sneakyAI'''
| When enabled, AI avoids exposing themselves to player whenever possible.
| false
|-
| '''strafe'''
| When enabled, holding CTRL allows soldiers to strafe and run, and allows tanks to rotate their turret independently of the chassis.
| false
|-
| '''TFTDDamage'''
| When enabled, weapons will do between 50% and 150% of their rated damage like in [[TFTD]], as opposed to [[X-COM]]'s 0% to 200%.
| false
|-
| '''traceAI'''
| Debug feature. When enabled, highlights the paths that enemy units took after their turn.
| false
|-
| '''weaponSelfDestruction'''
| When enabled, weapons dropped by aliens are destroyed unless they are captured alive (similar to the [[Enemy Unknown (EU2012)|new X-COM]]).
| false
|-
|}

[[Category:OpenXcom]]

Options (OpenXcom)

2014-05-02T17:41:45Z

Cfailde: /* Options File */ storageLimitsEnforced and autosave

[[Image:OpenXcom options screen.gif|right|thumb|OpenXcom Options screen]]

OpenXcom has a variety of game settings that can be customized through the Options screen in the Main Menu. These options are global and affect any old or new savegame, and take effect instantly after pressing OK.

* '''Display Resolution:''' Resolution the game is rendered at. Note that the game always renders at 320x200 (original DOS resolution) and resizes to whatever you specify, so for a better picture use a resolution with the same ratio. 640x400 or 640x480 (if you like non-square pixels) are recommended. Use the arrows to scroll through the resolutions supported by your monitor, or click on the numbers to type in your own resolution. If you screw it up, use ''Restore Defaults'' or delete your ''options.cfg'' file (see below) to reset your settings.
* '''Display Mode:''' Display the game in a window or covering the whole screen. Windowed mode is recommended as monitors usually don't properly support OpenXcom's lo-fi nature in fullscreen.
* '''Music Volume:''' The volume of the background music (0 is mute, 1 is lowest, 4 is highest).
* '''SFX Volume:''' The volume of the sound effects (0 is mute, 1 is lowest, 4 is highest).
* '''Language:''' Change the language used to display all the game text.

== Display Filter ==

By default OpenXcom just resizes the screen to fit the resolution, maintaining pixel accuracy as in the original game, but a variety of [[:Wikipedia:Image scaling|image scaling]] filters can be applied to change the image quality or apply smoothing and emulation effects:
* '''Scale''': Smooths out edges, making the game look less pixelated. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions.
* '''HQX''': Similar to '''Scale''', but more accurate and high-quality. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions.
* '''CRT (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''CRT-interlaced (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''CRT-simple (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''Curvature (OpenGL)''': Simulates a rounded display.
* '''dot_n_bloom (OpenGL)''' Applies both a dot grid effect and a bloom effect.
* '''heavybloom (OpenGL)''': Applies a very heavy bloom effect.
* '''HQ2X (OpenGL)''': A double-scale version of '''HQX''', which smoothes pixel edges, but not quite to the extreme of '''HQX'''.
* '''Openxcom (OpenGL)''': Smooths rough edges while maintaining a semi-pixellated feel similar to the original X-Com. (default)
* '''Phosphor-simple (OpenGL)''' Applies a dot grid effect.
* '''Pixellate (OpenGL)''': Default pixel-accurate behaviour, but using OpenGL.
* '''SABR (OpenGL)''': Applies texel-based smoothing to the display.
* '''Scale4xHQ (OpenGL)''': A quadruple-scale version of '''HQX''', which results in a more subtle smoothing of pixel edges.
* '''simplebloom (OpenGL)''': Applies a bloom effect.

== Controls ==

In the ''Controls'' screen you can customize keyboard shortcuts for a variety of functions normally only accessible with the mouse. To change a control, left-click on it and press the new key. To erase a control, right-click it.

Besides the controls listed on the screen, there are also these hardcoded shortcuts:

*'''ALT-ENTER''' – Toggles between windowed and fullscreen mode.
*'''Right-Click''' - Automatically set the min/max on an increase/decrease arrow button.
*'''Scroll Wheel''' - Scroll lists / Zoom globe / Change Battlescape view level.
*'''Back/Forward Buttons''' - (if available) Switch between soldiers on the Battlescape.

== Advanced Options ==

By default OpenXcom is set up for vanilla behavior, but provides a variety of options that allow players to change gameplay features. In the ''Advanced Options'' screen you can customize the most-popular options to your preference, and further options can be found in the Options File described below.

== Custom Music ==

If you don't like or have trouble getting the original X-COM music to work, you can use your own. The game will look for the original gm.cat, delete (or rename to restore it later in case you change your mind) it before using custom music. The formats supported are MIDI, MP3, OGG, MOD and FLAC. Just put it in the [[SOUND]] subfolder of the [[Installing (OpenXcom)#Data Folder|Data folder]] with the same filenames as the original:

{| class="wikitable"
! Original
! PlayStation
! Cydonia's Fall
|-
| GMDEFEND
| Briefing1
| Defend Base
|-
| GMENBASE
| Briefing2
| N/A
|-
| GMGEO1
| Geoscape1
| Geoscape (Part I)
|-
| GMGEO2
| Geoscape2
| Geoscape (Part II)
|-
| GMGEO3*
| Geoscape3
| N/A
|-
| GMGEO4*
| Geoscape4
| N/A
|-
| GMINTER
| Dogfight
| Interception
|-
| GMINTRO1
| N/A
| Intro (Part I)
|-
| GMINTRO2
| N/A
| Intro (Part II)
|-
| GMINTRO3
| N/A
| Intro (Part III)
|-
| GMLOSE
| N/A
| Lose Game
|-
| GMMARS
| Debriefing
| Debriefing
|-
| GMNEWMAR
| Mission Accomplished
| Mars Briefing
|-
| GMSTORY
| Final Briefing
| The Story
|-
| GMTACTIC
| Battlescape1
| Tactical Battle
|-
| GMTACTIC2*
| Battlescape2
| N/A
|-
| GMWIN
| N/A
| Win Game
|}

''*not available in original''

'''WARNING:''' There are some bugs with the audio playback on MP3, primarily on Unix-like systems. If you start experiencing crashes after using custom music, switch to a different music format.

== Options File ==

OpenXcom stores its options in a ''options.cfg'' YAML file stored in the [[Installing (OpenXcom)#User Folder|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>". These include the options shown in the Options screen as well as other advanced options.

'''WARNING:''' Invalid values can cause incorrect behaviour or game crashes. Options that accept true/false are marked by "When enabled", options that accept a range of numbers have this listed in brackets after their description, and options that accept a numeric flag have bullets to describe the functionality of each option.

{| class="wikitable"
! Option
! Description
! Default
|-

! colspan="3" style="background-color: #CCCCCC" | General

|-
| '''autosave'''
| When enabled, the game is autosaved every ten Geoscape days and five Battlescape turns to dedicated slots.
| true
|-
| '''captureMouse'''
| When enabled, the mouse cursor is locked to the window.
| false
|-
| '''changeValueByMouseWheel'''
| The amount to increase/decrease a value when scrolling the mouse wheel over increase/decrease buttons in lists.
| 0
|-
|'''cursorInBlackBandsInFullscreen'''<br />
'''cursorInBlackBandsInWindow'''<br />
'''cursorInBlackBandsInBorderlessWindow'''
|
|
false<br />
true<br />
false
|-
| '''debug'''
| When enabled, provides features to make it easier for developers/contributors to debug their work.
| false
|-
| '''debugUi'''
| When enabled, shows text borders in UI elements to make it easier for developers/translators to debug their work.
| false
|-
| '''dragScrollInvert'''
| Inverts the direction of drag-scrolling. When enabled, you must drag towards the target. When disabled, you drag away instead.
| false
|-
| '''FPS'''
|
| 15
|-
| '''fpsCounter'''
| When enabled, shows an FPS Counter on the top-left of the screen.
| false
|-
| '''language'''
| Filename of the language loaded at startup.
| en-US
|-
| '''keyboardMode'''
| Keyboard input mode.
* 0 = Keyboard enabled.
* 1 = Keyboard disabled, type in text boxes with the arrow keys (arcade style).
| 0
|-
| '''key*'''
| (...various options starting with this prefix) Stores the keyboard controls.
|
|-
| '''NewBattle_*'''
| (...various options starting with this prefix) Stores the last-used settings in the ''New Battle'' screen.
|
|-
| '''newSeedOnLoad'''
| When enabled, uses a new seed for the random number generator instead of the one saved to a save file. The game saves the seed of its random number generator to the save files, so normally a shot’s result is the same even if the saved game is reloaded. With a new seed the game re-randomises a shot’s chance of success.
| false
|-
| '''pauseMode'''
| Controls how the game behaves when it loses focus (eg. minimized or alt-tabbed).
* 0,1 = Continue running normally on loss of focus.
* 2 = Slow down the game on loss of focus.
* 3 = Pause completely on loss of focus.
| 0
|-
| '''playIntro'''
| When enabled, plays the intro cinematic on startup.
| true
|-
| '''saveOrder'''
| Controls the order in which saved games are displayed in the save/load game menus.
* 0 Ascending name order, i.e. A to Z.
* 1 Descending name order, i.e. Z to A.
* 2 Ascending date order, i.e. oldest saves first.
* 3 Descending date order, i.e. newest saves first.
| 3
|-

! colspan="3" style="background-color: #CCCCCC" | Display

|-
| '''allowResize'''
| When enabled and the game is in windowed mode, the game resolution can be dynamically resized by changing the window size.
| false
|-
| '''asyncBlit'''
| When enabled, the display surface uses asynchronous updates. This will usually slow down blitting on single CPU machines, but may provide a speed increase on SMP systems.
| true
|-
| '''baseXBattlescape'''
'''baseYBattlescape'''
|
| 320
200
|-
| '''baseXGeoscape'''
'''baseYGeoscape'''
|
| 320
200
|-
| '''baseXResolution'''
'''baseYResolution'''
| The game's base resolution in pixels, you can think of it as the "viewport", so changing this would let you see more of the Geoscape/Battlescape at once.
'''WARNING:''' This feature is experimental and can cause UI and performance problems, as the game is not designed for flexible resolutions.
| 320
200
|-
| '''borderless'''
| When enabled, the game is displayed without a window frame when playing in windowed mode.
| false
|-
| '''displayWidth'''
'''displayHeight'''
| Display resolution in pixels. The game will scale the base resolution to fit this value, so it should be greater than or equal to '''baseXResolution''' x '''baseYResolution.
| 640
400
|-
| '''fullscreen'''
| When enabled, the game will run in fullscreen mode as opposed to windowed mode.
'''NOTE''': The display might become distorted or clipped in fullscreen if your device doesn't support the specified resolution.
| false
|-
| '''keepAspectRatio'''
| When enabled, letterboxes the display to maintain the original aspect ratio.
| false
|-
| '''maxFrameSkip'''
| Specifies the maximum amount of frames the game can skip rendering.
| 0
|-
| '''windowedModePositionX'''
'''windowedModePositionY'''
| When running in windowed mode, forces the game window to start in the specified position in pixels. Use -1 to have the OS decide the window position.
| -1
-1
|-
| '''useHQXFilter'''
| When enabled, applies a rendering filter that smoothes out diagonal edges, making the game look less pixelated. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions, and '''useOpenGL''' must be disabled.
| false
|-
| '''useScaleFilter'''
| When enabled, passes the game through a software Scale2x filter. This option achieves similar results to '''useHQXFilter''' but with less overhead and slightly less quality. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions, and '''useOpenGL''' must be disabled.
| false
|-
| '''useOpenGL'''
| When enabled, uses OpenGL hardware rendering and enables the following OpenGL options:
| false
|-
| '''checkOpenGLErrors'''
| When enabled, logs all errors returned by OpenGL.
| false
|-
| '''useOpenGLShader'''
| Selects which GLSL rendering filter to apply when the '''useOpenGL''' option is enabled. This option takes a path relative to the OpenXcom Data Folder as an argument. OpenXcom comes packaged with some filters in the ''data\Shaders'' folder which are described earlier in ''Display Filter''.
| Shaders/Openxcom.OpenGL.shader
|-
| '''useOpenGLSmoothing'''
| When enabled, the game will use linear interpolation instead of nearest-neighbour pixel scaling when no shader is specified.
| true
|-
| '''vSyncForOpenGL'''
| When enabled, puts OpenGL into vertical synchronisation mode, ensuring the FPS do not exceed your monitor's refresh rate, preventing tearing and excessive hardware demand, but may cause slower animations.
| true
|-

! colspan="3" style="background-color: #CCCCCC" | Sound

|-
| '''audioBitDepth'''
| Bit depth of the output audio. ''Only change this if you know what you're doing!''
| 16
|-
| '''audioSampleRate'''
| Sample rate (in Hz) of the output audio. ''Only change this if you know what you're doing!''
| 22050
|-
| '''musicVolume'''
| Background music volume (0-128).
| 128
|-
| '''soundVolume'''
| Sound FX volume (0-128).
| 128
|-
| '''mute'''
| When enabled, disables all audio output. Automatically enabled if no audio hardware is detected.
| false
|-

! colspan="3" style="background-color: #CCCCCC" | Geoscape/Basescape

|-
| '''aggressiveRetaliation'''
| When enabled, aliens on any type of mission may detect your base if they are in very close range.
| false
|-
| '''allowAutoSellProduction'''
| When enabled, players can automatically sell manufactured items by right-clicking the Up Arrow on the Quantity in the manufacture screen.
| false
|-
| '''allowBuildingQueue'''
| When enabled, unfinished facilities act as links to the access lift when new facilities are placed, thereby allowing facilities to be "queued" waiting for neighboring facilities to finish.
| false
|-
| '''anytimePsiTraining'''
| When enabled, psi training can be performed at any time, instead of waiting for the end of the month.
| false
|-
| '''canManufactureMoreItemsPerHour'''
| When enabled, allows manufacturing projects to produce more than one item per hour, if the amount of engineers is very large (like in [[TFTD]]).
| false
|-
| '''canSellLiveAliens'''
| When enabled, captured aliens can be sold for cash in the same fashion as alien corpses. Recommended when '''alienContainmentLimitEnforced''' is enabled.
| false
|-
| '''canTransferCraftsWhileAirborne'''
| When enabled, crafts can be transferred between bases while they are OUT (as long as they have enough fuel).
| false
|-
| '''craftLaunchAlways'''
| When enabled, allow crafts to take off without being READY.
| false
|-
| '''customInitialBase'''
| When enabled, allows the player to customize the facility placement of the starting base.
|-
| '''dogfightSpeed'''
|
| 20
|-
| '''geoClockSpeed'''
|
| 80
|-
| '''globeAllRadarsOnBaseBuild'''
| When enabled, all radar ranges will be shown when hovering a valid base location while building a new base.
| true
|-
| '''globeDetail'''
| When enabled, country and city details are shown when zoomed in on the globe.
| true
|-
| '''globeFlightPaths
| When enabled, shows craft flight paths on the globe.
| true
|-
| '''globeRadarLines
| When enabled, the radar ranges of player bases on the globe are shown.
| true
|-
| '''globeScrollDragButton'''
| Scrolls the map when the specified mouse button is held down and dragged.
* 0 None.
* 1 Left mouse button.
* 2 Middle mouse button.
* 3 Right mouse button.
| 2
|-
| '''globeScrollSpeed
| The scrolling speed of the globe.
| 20
|-
| '''globeSeasons'''
| When enabled, the day/night cycle takes into account the Earth's [[:Wikipedia:Axial tilt|axial tilt]] for a more realistic projection of the light.
| false
|-
| '''psiStrengthEval'''
| When enabled, evaluates the psionic strength of all soldiers after the appropriate research has been completed.
| false
|-
| '''spendResearchedItems'''
| When enabled, researching an item removes it from stores and disassembles it, like in XCom 2012, and researching a living alien returns a corpse to the stores.
| false
|-
| '''showFundsOnGeoscape'''
| When enabled, shows your available funds above the time/date on the Geoscape sidebar.
| false
|-
| '''storageLimitsEnforced'''
| When enabled, enforces the limit of live aliens that can be held in each containment facility and imposes general stores limits at all times.
| false
|-

! colspan="3" style="background-color: #CCCCCC" | Battlescape

|-
| '''allowPsionicCapture'''
| When enabled, mind-controlling all the remaining enemy units results in a victory, and they count as live captures.
| false
|-
| '''battleAlienSpeed'''
| Animation speed of alien / civilian units moving on the map.
| 30
|-
| '''battleAutoEnd'''
| When enabled, the turn is automatically ended when all friendly/enemy units are neutralized, therefore ending the mission.
| false
|-
| '''battleConfirmFireMode'''
| When enabled, a second click is required on the same tile to confirm fire orders.
| false
|-
| '''battleEdgeScroll'''
| Sets how to scroll the map.
* 0 None.
* 1 Trigger - scroll map when the left mouse button is held down on a screen edge.
* 2 Auto - scroll map when the cursor is over a screen edge.
| 2
|-
| '''battleExplosionHeight'''
| A coefficient that controls how much vertical power explosions have.
* 0 = Explosions are completely flat, as per the original game.
* 1 = -30 damage units per level (this penalty is in addition to the horizontal penalty of -10 damage per tile).
* 2 = -10 damage units per level.
* 3 = -5 damage units per level.
| 0
|-
| '''battleFireSpeed'''
| Animation speed of bullets after being fired in pixels per frame. Game setting * 2.
| 6
|-
| '''battleHairBleach'''
| Changes soldier Battlescape sprites to match their inventory look.
| true
|-
| '''battleInstantGrenade'''
| When enabled, grenades are "hot". This means that when primed to 0 turns, they simply explode on impact, instead of waiting for the end of the turn.
| false
|-
| '''battleNotifyDeath'''
| When enabled, displays a text notification when a soldier dies.
| false
|-
| '''battleNewPreviewPath'''
| When enabled, your first left-click displays the path the selected unit will take, and your second click confirms the move order.
* 0 No preview.
* 1 Display path taken with colored arrows: green - can move and fire; yellow - can move; red - cannot move.
* 2 Display the time units you will have remaining after moving to the destination.
* 3 Display colored arrows and time units remaining.
| 0
|-
| '''battleSmoothCamera'''
| When enabled, the battlescape camera will remain centered on projectiles while in flight.
| false
|-
| '''battleUFOExtenderAccuracy'''
| When enabled, mimics [[UFOextender#Range_Based_Accuracy |UFO Extender's Range based accuracy]], except using stats taken from the weapon itself rather than global config options.
| false
|-
| '''battleScrollSpeed'''
| Map scrolling speed.
| 8
|-
| '''battleScrollType'''
| Map scrolling mode.
* 0 = Trigger Scroll: Hold down the LMB over the edges of the screen to scroll.
* 1 = Auto Scroll: Hover your mouse over the edges of the screen to scroll.
* 2 = Drag Scroll: Hold down MMB and drag to scroll. Recommended for playing windowed.
| 1
|-
| '''battleScrollDragButtion'''
| Controls which mouse button is held down in Drag Scrolling
* 1 = Left Mouse Button.
* 2 = Middle Mouse Button.
* 3 = Right Mouse Button.
* 6... = Other Mouse Buttons.
| 2
|-
| '''battleScrollDragInvert'''
| When enabled, Drag Scrolling moves the camera away from your mouse, rather than moving towards it.
| false
|-
| '''battleScrollDragTimeTolerance'''
| Amount of miliseconds the mouse needs to be pressed to trigger a Drag Scroll.
| 300
|-
| '''battleScrollDragPixelTolerance'''
| Amount of pixels the mouse needs to be moved after pressing to trigger a Drag Scroll.
| 10
|-
| '''battleTooltips'''
| When enabled, hovering the Battlescape buttons displays a tooltip.
| true
|-
| '''battleXcomSpeed'''
| Animation speed of X-COM units moving on the map.
| 30
|-
| '''disableAutoEquip'''
| When enabled, disables auto-equipping of new soldiers before battle.
| false
|-
| '''skipNextTurnScreen'''
| When enabled, the "Next Turn" screens during battle are advanced automatically after a short delay.
| false
|-
| '''showMoreStatsInInventoryView'''
| When enabled, the inventory screen displays extra stats in the top-right corner, such as the weight of equipment the soldier is currently wearing/carrying and their maximum weight before TU reduction sets in, their firing accuracy, reactions and psi stats.
| false
|-
| '''sneakyAI'''
| When enabled, AI avoids exposing themselves to player whenever possible.
| false
|-
| '''strafe'''
| When enabled, holding CTRL allows soldiers to strafe and run, and allows tanks to rotate their turret independently of the chassis.
| false
|-
| '''TFTDDamage'''
| When enabled, weapons will do between 50% and 150% of their rated damage as opposed to UFO:Enemy Unknown's 0% to 200%.
| false
|-
| '''traceAI'''
| Debug feature. When enabled, highlights the paths that enemy units took after their turn.
| false
|-
| '''weaponSelfDestruction'''
| When enabled, weapons dropped by aliens are destroyed unless they are captured alive (similar to the [[Enemy Unknown (EU2012)|new X-COM]]).
| false
|-
|}

== Debug mode ==

''Debug mode'' is a special feature that makes it easier for developers/contributors to test out game features without needing to play a new game from scratch. After setting "debug: true" in the ''options.cfg'' file (see above), you can enable it by pressing ''Ctrl-D'' in-game to access a variety of features:

'''Geoscape''': All research is unlocked, allowing you to easily test all features in the Geoscape without needing to manually unlock them yourself. This doesn't affect your saved game. Regional and Country borders will be displayed.

'''Battlescape''': Whole map is revealed and opening the inventory screen resets TUs, allowing you to easily test out the map and any Battlescape features without being affected by game restrictions.

[[Category:OpenXcom]]

Options (OpenXcom)

2014-04-16T11:49:34Z

Cfailde: /* Options File */ Update descriptions.

[[Image:OpenXcom options screen.gif|right|thumb|OpenXcom Options screen]]

OpenXcom has a variety of game settings that can be customized through the Options screen in the Main Menu. These options are global and affect any old or new savegame, and take effect instantly after pressing OK.

* '''Display Resolution:''' Resolution the game is rendered at. Note that the game always renders at 320x200 (original DOS resolution) and resizes to whatever you specify, so for a better picture use a resolution with the same ratio. 640x400 or 640x480 (if you like non-square pixels) are recommended. Use the arrows to scroll through the resolutions supported by your monitor, or click on the numbers to type in your own resolution. If you screw it up, use ''Restore Defaults'' or delete your ''options.cfg'' file (see below) to reset your settings.
* '''Display Mode:''' Display the game in a window or covering the whole screen. Windowed mode is recommended as monitors usually don't properly support OpenXcom's lo-fi nature in fullscreen.
* '''Music Volume:''' The volume of the background music (0 is mute, 1 is lowest, 4 is highest).
* '''SFX Volume:''' The volume of the sound effects (0 is mute, 1 is lowest, 4 is highest).
* '''Language:''' Change the language used to display all the game text.

== Display Filter ==

By default OpenXcom just resizes the screen to fit the resolution, maintaining pixel accuracy as in the original game, but a variety of [[:Wikipedia:Image scaling|image scaling]] filters can be applied to change the image quality or apply smoothing and emulation effects:
* '''Scale''': Smooths out edges, making the game look less pixelated. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions.
* '''HQX''': Similar to '''Scale''', but more accurate and high-quality. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions.
* '''CRT (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''CRT-interlaced (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''CRT-simple (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''Curvature (OpenGL)''': Simulates a rounded display.
* '''dot_n_bloom (OpenGL)''' Applies both a dot grid effect and a bloom effect.
* '''heavybloom (OpenGL)''': Applies a very heavy bloom effect.
* '''HQ2X (OpenGL)''': A double-scale version of '''HQX''', which smoothes pixel edges, but not quite to the extreme of '''HQX'''.
* '''Openxcom (OpenGL)''': Smooths rough edges while maintaining a semi-pixellated feel similar to the original X-Com. (default)
* '''Phosphor-simple (OpenGL)''' Applies a dot grid effect.
* '''Pixellate (OpenGL)''': Default pixel-accurate behaviour, but using OpenGL.
* '''SABR (OpenGL)''': Applies texel-based smoothing to the display.
* '''Scale4xHQ (OpenGL)''': A quadruple-scale version of '''HQX''', which results in a more subtle smoothing of pixel edges.
* '''simplebloom (OpenGL)''': Applies a bloom effect.

== Controls ==

In the ''Controls'' screen you can customize keyboard shortcuts for a variety of functions normally only accessible with the mouse. To change a control, left-click on it and press the new key. To erase a control, right-click it.

Besides the controls listed on the screen, there are also these hardcoded shortcuts:

*'''ALT-ENTER''' – Toggles between windowed and fullscreen mode.
*'''Right-Click''' - Automatically set the min/max on an increase/decrease arrow button.
*'''Scroll Wheel''' - Scroll lists / Zoom globe / Change Battlescape view level.
*'''Back/Forward Buttons''' - (if available) Switch between soldiers on the Battlescape.

== Advanced Options ==

By default OpenXcom is set up for vanilla behavior, but provides a variety of options that allow players to change gameplay features. In the ''Advanced Options'' screen you can customize the most-popular options to your preference, and further options can be found in the Options File described below.

== Custom Music ==

If you don't like or have trouble getting the original X-COM music to work, you can use your own. The game will look for the original gm.cat, delete (or rename to restore it later in case you change your mind) it before using custom music. The formats supported are MIDI, MP3, OGG, MOD and FLAC. Just put it in the [[SOUND]] subfolder of the [[Installing (OpenXcom)#Data Folder|Data folder]] with the same filenames as the original:

{| class="wikitable"
! Original
! PlayStation
! Cydonia's Fall
|-
| GMDEFEND
| Briefing1
| Defend Base
|-
| GMENBASE
| Briefing2
| N/A
|-
| GMGEO1
| Geoscape1
| Geoscape (Part I)
|-
| GMGEO2
| Geoscape2
| Geoscape (Part II)
|-
| GMGEO3*
| Geoscape3
| N/A
|-
| GMGEO4*
| Geoscape4
| N/A
|-
| GMINTER
| Dogfight
| Interception
|-
| GMINTRO1
| N/A
| Intro (Part I)
|-
| GMINTRO2
| N/A
| Intro (Part II)
|-
| GMINTRO3
| N/A
| Intro (Part III)
|-
| GMLOSE
| N/A
| Lose Game
|-
| GMMARS
| Debriefing
| Debriefing
|-
| GMNEWMAR
| Mission Accomplished
| Mars Briefing
|-
| GMSTORY
| Final Briefing
| The Story
|-
| GMTACTIC
| Battlescape1
| Tactical Battle
|-
| GMTACTIC2*
| Battlescape2
| N/A
|-
| GMWIN
| N/A
| Win Game
|}

''*not available in original''

'''WARNING:''' There are some bugs with the audio playback on MP3, primarily on Unix-like systems. If you start experiencing crashes after using custom music, switch to a different music format.

== Options File ==

OpenXcom stores its options in a ''options.cfg'' YAML file stored in the [[Installing (OpenXcom)#User Folder|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>". These include the options shown in the Options screen as well as other advanced options.

'''WARNING:''' Invalid values can cause incorrect behaviour or game crashes. Options that accept true/false are marked by "When enabled", options that accept a range of numbers have this listed in brackets after their description, and options that accept a numeric flag have bullets to describe the functionality of each option.

{| class="wikitable"
! Option
! Description
! Default
|-

! colspan="3" style="background-color: #CCCCCC" | General

|-
| '''autosave'''
| When enabled, the game is autosaved.
* 0 = disabled.
* 1 = quick save and quick load buttons are enabled.
* 2 = game automatically saves at 00:00 and all save and load buttons are disabled.
* 3 = same as 2, as well as automatically saving on exit of the game.
| 0
|-
| '''captureMouse'''
| When enabled, the mouse cursor is locked to the window.
| false
|-
| '''changeValueByMouseWheel'''
| The amount to increase/decrease a value when scrolling the mouse wheel over increase/decrease buttons in lists.
| 0
|-
|'''cursorInBlackBandsInFullscreen'''<br />
'''cursorInBlackBandsInWindow'''<br />
'''cursorInBlackBandsInBorderlessWindow'''
|
|
false<br />
true<br />
false
|-
| '''debug'''
| When enabled, provides features to make it easier for developers/contributors to debug their work.
| false
|-
| '''debugUi'''
| When enabled, shows text borders in UI elements to make it easier for developers/translators to debug their work.
| false
|-
| '''dragScrollInvert'''
| Inverts the direction of drag-scrolling. When enabled, you must drag towards the target. When disabled, you drag away instead.
| false
|-
| '''FPS'''
|
| 15
|-
| '''fpsCounter'''
| When enabled, shows an FPS Counter on the top-left of the screen.
| false
|-
| '''language'''
| Filename of the language loaded at startup.
| en-US
|-
| '''keyboardMode'''
| Keyboard input mode.
* 0 = Keyboard enabled.
* 1 = Keyboard disabled, type in text boxes with the arrow keys (arcade style).
| 0
|-
| '''key*'''
| (...various options starting with this prefix) Stores the keyboard controls.
|
|-
| '''NewBattle_*'''
| (...various options starting with this prefix) Stores the last-used settings in the ''New Battle'' screen.
|
|-
| '''newSeedOnLoad'''
| When enabled, uses a new seed for the random number generator instead of the one saved to a save file. The game saves the seed of its random number generator to the save files, so normally a shot’s result is the same even if the saved game is reloaded. With a new seed the game re-randomises a shot’s chance of success.
| false
|-
| '''pauseMode'''
| Controls how the game behaves when it loses focus (eg. minimized or alt-tabbed).
* 0,1 = Continue running normally on loss of focus.
* 2 = Slow down the game on loss of focus.
* 3 = Pause completely on loss of focus.
| 0
|-
| '''playIntro'''
| When enabled, plays the intro cinematic on startup.
| true
|-
| '''saveOrder'''
| Controls the order in which saved games are displayed in the save/load game menus.
* 0 Ascending name order, i.e. A to Z.
* 1 Descending name order, i.e. Z to A.
* 2 Ascending date order, i.e. oldest saves first.
* 3 Descending date order, i.e. newest saves first.
| 3
|-

! colspan="3" style="background-color: #CCCCCC" | Display

|-
| '''allowResize'''
| When enabled and the game is in windowed mode, the game resolution can be dynamically resized by changing the window size.
| false
|-
| '''asyncBlit'''
| When enabled, the display surface uses asynchronous updates. This will usually slow down blitting on single CPU machines, but may provide a speed increase on SMP systems.
| true
|-
| '''baseXBattlescape'''
'''baseYBattlescape'''
|
| 320
200
|-
| '''baseXGeoscape'''
'''baseYGeoscape'''
|
| 320
200
|-
| '''baseXResolution'''
'''baseYResolution'''
| The game's base resolution in pixels, you can think of it as the "viewport", so changing this would let you see more of the Geoscape/Battlescape at once.
'''WARNING:''' This feature is experimental and can cause UI and performance problems, as the game is not designed for flexible resolutions.
| 320
200
|-
| '''borderless'''
| When enabled, the game is displayed without a window frame when playing in windowed mode.
| false
|-
| '''displayWidth'''
'''displayHeight'''
| Display resolution in pixels. The game will scale the base resolution to fit this value, so it should be greater than or equal to '''baseXResolution''' x '''baseYResolution.
| 640
400
|-
| '''fullscreen'''
| When enabled, the game will run in fullscreen mode as opposed to windowed mode.
'''NOTE''': The display might become distorted or clipped in fullscreen if your device doesn't support the specified resolution.
| false
|-
| '''keepAspectRatio'''
| When enabled, letterboxes the display to maintain the original aspect ratio.
| false
|-
| '''maxFrameSkip'''
| Specifies the maximum amount of frames the game can skip rendering.
| 0
|-
| '''windowedModePositionX'''
'''windowedModePositionY'''
| When running in windowed mode, forces the game window to start in the specified position in pixels. Use -1 to have the OS decide the window position.
| -1
-1
|-
| '''useHQXFilter'''
| When enabled, applies a rendering filter that smoothes out diagonal edges, making the game look less pixelated. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions, and '''useOpenGL''' must be disabled.
| false
|-
| '''useScaleFilter'''
| When enabled, passes the game through a software Scale2x filter. This option achieves similar results to '''useHQXFilter''' but with less overhead and slightly less quality. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions, and '''useOpenGL''' must be disabled.
| false
|-
| '''useOpenGL'''
| When enabled, uses OpenGL hardware rendering and enables the following OpenGL options:
| false
|-
| '''checkOpenGLErrors'''
| When enabled, logs all errors returned by OpenGL.
| false
|-
| '''useOpenGLShader'''
| Selects which GLSL rendering filter to apply when the '''useOpenGL''' option is enabled. This option takes a path relative to the OpenXcom Data Folder as an argument. OpenXcom comes packaged with some filters in the ''data\Shaders'' folder which are described earlier in ''Display Filter''.
| Shaders/Openxcom.OpenGL.shader
|-
| '''useOpenGLSmoothing'''
| When enabled, the game will use linear interpolation instead of nearest-neighbour pixel scaling when no shader is specified.
| true
|-
| '''vSyncForOpenGL'''
| When enabled, puts OpenGL into vertical synchronisation mode, ensuring the FPS do not exceed your monitor's refresh rate, preventing tearing and excessive hardware demand, but may cause slower animations.
| true
|-

! colspan="3" style="background-color: #CCCCCC" | Sound

|-
| '''audioBitDepth'''
| Bit depth of the output audio. ''Only change this if you know what you're doing!''
| 16
|-
| '''audioSampleRate'''
| Sample rate (in Hz) of the output audio. ''Only change this if you know what you're doing!''
| 22050
|-
| '''musicVolume'''
| Background music volume (0-128).
| 128
|-
| '''soundVolume'''
| Sound FX volume (0-128).
| 128
|-
| '''mute'''
| When enabled, disables all audio output. Automatically enabled if no audio hardware is detected.
| false
|-

! colspan="3" style="background-color: #CCCCCC" | Geoscape/Basescape

|-
| '''aggressiveRetaliation'''
| When enabled, aliens on any type of mission may detect your base if they are in very close range.
| false
|-
| '''alienContainmentLimitEnforced'''
| When enabled, enforces the limit of live aliens that can be held in each containment facility.
| false
|-
| '''allowAutoSellProduction'''
| When enabled, players can automatically sell manufactured items by right-clicking the Up Arrow on the Quantity in the manufacture screen.
| false
|-
| '''allowBuildingQueue'''
| When enabled, unfinished facilities act as links to the access lift when new facilities are placed, thereby allowing facilities to be "queued" waiting for neighboring facilities to finish.
| false
|-
| '''anytimePsiTraining'''
| When enabled, psi training can be performed at any time, instead of waiting for the end of the month.
| false
|-
| '''canManufactureMoreItemsPerHour'''
| When enabled, allows manufacturing projects to produce more than one item per hour, if the amount of engineers is very large (like in [[TFTD]]).
| false
|-
| '''canSellLiveAliens'''
| When enabled, captured aliens can be sold for cash in the same fashion as alien corpses. Recommended when '''alienContainmentLimitEnforced''' is enabled.
| false
|-
| '''canTransferCraftsWhileAirborne'''
| When enabled, crafts can be transferred between bases while they are OUT (as long as they have enough fuel).
| false
|-
| '''craftLaunchAlways'''
| When enabled, allow crafts to take off without being READY.
| false
|-
| '''customInitialBase'''
| When enabled, allows the player to customize the facility placement of the starting base.
|-
| '''dogfightSpeed'''
|
| 20
|-
| '''geoClockSpeed'''
|
| 80
|-
| '''globeAllRadarsOnBaseBuild'''
| When enabled, all radar ranges will be shown when hovering a valid base location while building a new base.
| true
|-
| '''globeDetail'''
| When enabled, country and city details are shown when zoomed in on the globe.
| true
|-
| '''globeFlightPaths
| When enabled, shows craft flight paths on the globe.
| true
|-
| '''globeRadarLines
| When enabled, the radar ranges of player bases on the globe are shown.
| true
|-
| '''globeScrollDragButton'''
| Scrolls the map when the specified mouse button is held down and dragged.
* 0 None.
* 1 Left mouse button.
* 2 Middle mouse button.
* 3 Right mouse button.
| 2
|-
| '''globeScrollSpeed
| The scrolling speed of the globe.
| 20
|-
| '''globeSeasons'''
| When enabled, the day/night cycle takes into account the Earth's [[:Wikipedia:Axial tilt|axial tilt]] for a more realistic projection of the light.
| false
|-
| '''psiStrengthEval'''
| When enabled, evaluates the psionic strength of all soldiers after the appropriate research has been completed.
| false
|-
| '''spendResearchedItems'''
| When enabled, researching an item removes it from stores and disassembles it, like in XCom 2012, and researching a living alien returns a corpse to the stores.
| false
|-
| '''showFundsOnGeoscape'''
| When enabled, shows your available funds above the time/date on the Geoscape sidebar.
| false
|-

! colspan="3" style="background-color: #CCCCCC" | Battlescape

|-
| '''allowPsionicCapture'''
| When enabled, mind-controlling all the remaining enemy units results in a victory, and they count as live captures.
| false
|-
| '''battleAlienSpeed'''
| Animation speed of alien / civilian units moving on the map.
| 30
|-
| '''battleAutoEnd'''
| When enabled, the turn is automatically ended when all friendly/enemy units are neutralized, therefore ending the mission.
| false
|-
| '''battleConfirmFireMode'''
| When enabled, a second click is required on the same tile to confirm fire orders.
| false
|-
| '''battleEdgeScroll'''
| Sets how to scroll the map.
* 0 None.
* 1 Trigger - scroll map when the left mouse button is held down on a screen edge.
* 2 Auto - scroll map when the cursor is over a screen edge.
| 2
|-
| '''battleExplosionHeight'''
| A coefficient that controls how much vertical power explosions have.
* 0 = Explosions are completely flat, as per the original game.
* 1 = -30 damage units per level (this penalty is in addition to the horizontal penalty of -10 damage per tile).
* 2 = -10 damage units per level.
* 3 = -5 damage units per level.
| 0
|-
| '''battleFireSpeed'''
| Animation speed of bullets after being fired in pixels per frame. Game setting * 2.
| 6
|-
| '''battleHairBleach'''
| Changes soldier Battlescape sprites to match their inventory look.
| true
|-
| '''battleInstantGrenade'''
| When enabled, grenades are "hot". This means that when primed to 0 turns, they simply explode on impact, instead of waiting for the end of the turn.
| false
|-
| '''battleNotifyDeath'''
| When enabled, displays a text notification when a soldier dies.
| false
|-
| '''battleNewPreviewPath'''
| When enabled, your first left-click displays the path the selected unit will take, and your second click confirms the move order.
* 0 No preview.
* 1 Display path taken with colored arrows: green - can move and fire; yellow - can move; red - cannot move.
* 2 Display the time units you will have remaining after moving to the destination.
* 3 Display colored arrows and time units remaining.
| 0
|-
| '''battleSmoothCamera'''
| When enabled, the battlescape camera will remain centered on projectiles while in flight.
| false
|-
| '''battleUFOExtenderAccuracy'''
| When enabled, mimics [[UFOextender#Range_Based_Accuracy |UFO Extender's Range based accuracy]], except using stats taken from the weapon itself rather than global config options.
| false
|-
| '''battleScrollSpeed'''
| Map scrolling speed.
| 8
|-
| '''battleScrollType'''
| Map scrolling mode.
* 0 = Trigger Scroll: Hold down the LMB over the edges of the screen to scroll.
* 1 = Auto Scroll: Hover your mouse over the edges of the screen to scroll.
* 2 = Drag Scroll: Hold down MMB and drag to scroll. Recommended for playing windowed.
| 1
|-
| '''battleScrollDragButtion'''
| Controls which mouse button is held down in Drag Scrolling
* 1 = Left Mouse Button.
* 2 = Middle Mouse Button.
* 3 = Right Mouse Button.
* 6... = Other Mouse Buttons.
| 2
|-
| '''battleScrollDragInvert'''
| When enabled, Drag Scrolling moves the camera away from your mouse, rather than moving towards it.
| false
|-
| '''battleScrollDragTimeTolerance'''
| Amount of miliseconds the mouse needs to be pressed to trigger a Drag Scroll.
| 300
|-
| '''battleScrollDragPixelTolerance'''
| Amount of pixels the mouse needs to be moved after pressing to trigger a Drag Scroll.
| 10
|-
| '''battleTooltips'''
| When enabled, hovering the Battlescape buttons displays a tooltip.
| true
|-
| '''battleXcomSpeed'''
| Animation speed of X-COM units moving on the map.
| 30
|-
| '''disableAutoEquip'''
| When enabled, disables auto-equipping of new soldiers before battle.
| false
|-
| '''skipNextTurnScreen'''
| When enabled, the "Next Turn" screens during battle are advanced automatically after a short delay.
| false
|-
| '''showMoreStatsInInventoryView'''
| When enabled, the inventory screen displays extra stats in the top-right corner, such as the weight of equipment the soldier is currently wearing/carrying and their maximum weight before TU reduction sets in, their firing accuracy, reactions and psi stats.
| false
|-
| '''sneakyAI'''
| When enabled, AI avoids exposing themselves to player whenever possible.
| false
|-
| '''strafe'''
| When enabled, holding CTRL allows soldiers to strafe and run, and allows tanks to rotate their turret independently of the chassis.
| false
|-
| '''TFTDDamage'''
| When enabled, weapons will do between 50% and 150% of their rated damage as opposed to UFO:Enemy Unknown's 0% to 200%.
| false
|-
| '''traceAI'''
| Debug feature. When enabled, highlights the paths that enemy units took after their turn.
| false
|-
| '''weaponSelfDestruction'''
| When enabled, weapons dropped by aliens are destroyed unless they are captured alive (similar to the [[Enemy Unknown (EU2012)|new X-COM]]).
| false
|-
|}

== Debug mode ==

''Debug mode'' is a special feature that makes it easier for developers/contributors to test out game features without needing to play a new game from scratch. After setting "debug: true" in the ''options.cfg'' file (see above), you can enable it by pressing ''Ctrl-D'' in-game to access a variety of features:

'''Geoscape''': All research is unlocked, allowing you to easily test all features in the Geoscape without needing to manually unlock them yourself. This doesn't affect your saved game. Regional and Country borders will be displayed.

'''Battlescape''': Whole map is revealed and opening the inventory screen resets TUs, allowing you to easily test out the map and any Battlescape features without being affected by game restrictions.

[[Category:OpenXcom]]

Options (OpenXcom)

2014-04-10T14:50:41Z

Cfailde: Updated image

[[Image:OpenXcom options screen.gif|right|thumb|OpenXcom Options screen]]

OpenXcom has a variety of game settings that can be customized through the Options screen in the Main Menu. These options are global and affect any old or new savegame, and take effect instantly after pressing OK.

* '''Display Resolution:''' Resolution the game is rendered at. Note that the game always renders at 320x200 (original DOS resolution) and resizes to whatever you specify, so for a better picture use a resolution with the same ratio. 640x400 or 640x480 (if you like non-square pixels) are recommended. Use the arrows to scroll through the resolutions supported by your monitor, or click on the numbers to type in your own resolution. If you screw it up, use ''Restore Defaults'' or delete your ''options.cfg'' file (see below) to reset your settings.
* '''Display Mode:''' Display the game in a window or covering the whole screen. Windowed mode is recommended as monitors usually don't properly support OpenXcom's lo-fi nature in fullscreen.
* '''Music Volume:''' The volume of the background music (0 is mute, 1 is lowest, 4 is highest).
* '''SFX Volume:''' The volume of the sound effects (0 is mute, 1 is lowest, 4 is highest).
* '''Language:''' Change the language used to display all the game text.

== Display Filter ==

By default OpenXcom just resizes the screen to fit the resolution, maintaining pixel accuracy as in the original game, but a variety of [[:Wikipedia:Image scaling|image scaling]] filters can be applied to change the image quality or apply smoothing and emulation effects:
* '''Scale''': Smooths out edges, making the game look less pixelated. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions.
* '''HQX''': Similar to '''Scale''', but more accurate and high-quality. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions.
* '''CRT (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''CRT-interlaced (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''CRT-simple (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''Curvature (OpenGL)''': Simulates a rounded display.
* '''dot_n_bloom (OpenGL)''' Applies both a dot grid effect and a bloom effect.
* '''heavybloom (OpenGL)''': Applies a very heavy bloom effect.
* '''HQ2X (OpenGL)''': A double-scale version of '''HQX''', which smoothes pixel edges, but not quite to the extreme of '''HQX'''.
* '''Openxcom (OpenGL)''': Smooths rough edges while maintaining a semi-pixellated feel similar to the original X-Com. (default)
* '''Phosphor-simple (OpenGL)''' Applies a dot grid effect.
* '''Pixellate (OpenGL)''': Default pixel-accurate behaviour, but using OpenGL.
* '''SABR (OpenGL)''': Applies texel-based smoothing to the display.
* '''Scale4xHQ (OpenGL)''': A quadruple-scale version of '''HQX''', which results in a more subtle smoothing of pixel edges.
* '''simplebloom (OpenGL)''': Applies a bloom effect.

== Controls ==

In the ''Controls'' screen you can customize keyboard shortcuts for a variety of functions normally only accessible with the mouse. To change a control, left-click on it and press the new key. To erase a control, right-click it.

Besides the controls listed on the screen, there are also these hardcoded shortcuts:

*'''ALT-ENTER''' – Toggles between windowed and fullscreen mode.
*'''Right-Click''' - Automatically set the min/max on an increase/decrease arrow button.
*'''Scroll Wheel''' - Scroll lists / Zoom globe / Change Battlescape view level.
*'''Back/Forward Buttons''' - (if available) Switch between soldiers on the Battlescape.

== Advanced Options ==

By default OpenXcom is set up for vanilla behavior, but provides a variety of options that allow players to change gameplay features. In the ''Advanced Options'' screen you can customize the most-popular options to your preference, and further options can be found in the Options File described below.

== Custom Music ==

If you don't like or have trouble getting the original X-COM music to work, you can use your own. The game will look for the original gm.cat, delete (or rename to restore it later in case you change your mind) it before using custom music. The formats supported are MIDI, MP3, OGG, MOD and FLAC. Just put it in the [[SOUND]] subfolder of the [[Installing (OpenXcom)#Data Folder|Data folder]] with the same filenames as the original:

{| class="wikitable"
! Original
! PlayStation
! Cydonia's Fall
|-
| GMDEFEND
| Briefing1
| Defend Base
|-
| GMENBASE
| Briefing2
| N/A
|-
| GMGEO1
| Geoscape1
| Geoscape (Part I)
|-
| GMGEO2
| Geoscape2
| Geoscape (Part II)
|-
| GMGEO3*
| Geoscape3
| N/A
|-
| GMGEO4*
| Geoscape4
| N/A
|-
| GMINTER
| Dogfight
| Interception
|-
| GMINTRO1
| N/A
| Intro (Part I)
|-
| GMINTRO2
| N/A
| Intro (Part II)
|-
| GMINTRO3
| N/A
| Intro (Part III)
|-
| GMLOSE
| N/A
| Lose Game
|-
| GMMARS
| Debriefing
| Debriefing
|-
| GMNEWMAR
| Mission Accomplished
| Mars Briefing
|-
| GMSTORY
| Final Briefing
| The Story
|-
| GMTACTIC
| Battlescape1
| Tactical Battle
|-
| GMTACTIC2*
| Battlescape2
| N/A
|-
| GMWIN
| N/A
| Win Game
|}

''*not available in original''

'''WARNING:''' There are some bugs with the audio playback on MP3, primarily on Unix-like systems. If you start experiencing crashes after using custom music, switch to a different music format.

== Options File ==

OpenXcom stores its options in a ''options.cfg'' YAML file stored in the [[Installing (OpenXcom)#User Folder|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>". These include the options shown in the Options screen as well as other advanced options.

'''WARNING:''' Invalid values can cause incorrect behaviour or game crashes. Options that accept true/false are marked by "When enabled", options that accept a range of numbers have this listed in brackets after their description, and options that accept a numeric flag have bullets to describe the functionality of each option.

{| class="wikitable"
! Option
! Description
! Default
|-

! colspan="3" style="background-color: #CCCCCC" | General

|-
| '''autosave'''
| When enabled, the game is autosaved.
* 0 = disabled.
* 1 = quick save and quick load buttons are enabled.
* 2 = game automatically saves at 00:00 and all save and load buttons are disabled.
* 3 = same as 2, as well as automatically saving on exit of the game.
| 0
|-
| '''captureMouse'''
| When enabled, the mouse cursor is locked to the window.
| false
|-
| '''changeValueByMouseWheel'''
| The amount to increase/decrease a value when scrolling the mouse wheel over increase/decrease buttons in lists.
| 10
|-
|'''cursorInBlackBandsInFullscreen'''<br />
'''cursorInBlackBandsInWindow'''<br />
'''cursorInBlackBandsInBorderlessWindow'''
|
|
false<br />
true<br />
false
|-
| '''debug'''
| When enabled, provides features to make it easier for developers/contributors to debug their work.
| false
|-
| '''debugUi'''
| When enabled, shows text borders in UI elements to make it easier for developers/translators to debug their work.
| false
|-
| '''FPS'''
|
| 15
|-
| '''fpsCounter'''
| When enabled, shows an FPS Counter on the top-left of the screen.
| false
|-
| '''language'''
| Filename of the language loaded at startup.
| en-US
|-
| '''keyboardMode'''
| Keyboard input mode.
* 0 = Keyboard enabled.
* 1 = Keyboard disabled, type in text boxes with the arrow keys (arcade style).
| 0
|-
| '''key*'''
| (...various options starting with this prefix) Stores the keyboard controls.
|
|-
| '''NewBattle_*'''
| (...various options starting with this prefix) Stores the last-used settings in the ''New Battle'' screen.
|
|-
| '''newSeedOnLoad'''
| When enabled, uses a new seed for the random number generator instead of the one saved to a save file. The game saves the seed of its random number generator to the save files, so normally a shot’s result is the same even if the saved game is reloaded. With a new seed the game re-randomises a shot’s chance of success.
| false
|-
| '''pauseMode'''
| Controls how the game behaves when it loses focus (eg. minimized or alt-tabbed).
* 0,1 = Continue running normally on loss of focus.
* 2 = Slow down the game on loss of focus.
* 3 = Pause completely on loss of focus.
| 0
|-
| '''playIntro'''
| When enabled, plays the intro cinematic on startup.
| true
|-
| '''saveOrder'''
| Controls the order in which saved games are displayed in the save/load game menus.
* 0 Ascending name order, i.e. A to Z.
* 1 Descending name order, i.e. Z to A.
* 2 Ascending date order, i.e. oldest saves first.
* 3 Descending date order, i.e. newest saves first.
| 3
|-

! colspan="3" style="background-color: #CCCCCC" | Display

|-
| '''allowResize'''
| When enabled and the game is in windowed mode, the game resolution can be dynamically resized by changing the window size.
| false
|-
| '''asyncBlit'''
| When enabled, the display surface uses asynchronous updates. This will usually slow down blitting on single CPU machines, but may provide a speed increase on SMP systems.
| true
|-
| '''baseXBattlescape'''
'''baseYBattlescape'''
|
| 320
200
|-
| '''baseXGeoscape'''
'''baseYGeoscape'''
|
| 320
200
|-
| '''baseXResolution'''
'''baseYResolution'''
| The game's base resolution in pixels, you can think of it as the "viewport", so changing this would let you see more of the Geoscape/Battlescape at once.
'''WARNING:''' This feature is experimental and can cause UI and performance problems, as the game is not designed for flexible resolutions.
| 320
200
|-
| '''borderless'''
| When enabled, the game is displayed without a window frame when playing in windowed mode.
| false
|-
| '''displayWidth'''
'''displayHeight'''
| Display resolution in pixels. The game will scale the base resolution to fit this value, so it should be greater than or equal to '''baseXResolution''' x '''baseYResolution.
| 640
400
|-
| '''fullscreen'''
| When enabled, the game will run in fullscreen mode as opposed to windowed mode.
'''NOTE''': The display might become distorted or clipped in fullscreen if your device doesn't support the specified resolution.
| false
|-
| '''keepAspectRatio'''
| When enabled, letterboxes the display to maintain the original aspect ratio.
| false
|-
| '''maxFrameSkip'''
| Specifies the maximum amount of frames the game can skip rendering.
| 0
|-
| '''windowedModePositionX'''
'''windowedModePositionY'''
| When running in windowed mode, forces the game window to start in the specified position in pixels. Use -1 to have the OS decide the window position.
| -1
-1
|-
| '''useHQXFilter'''
| When enabled, applies a rendering filter that smoothes out diagonal edges, making the game look less pixelated. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions, and '''useOpenGL''' must be disabled.
| false
|-
| '''useScaleFilter'''
| When enabled, passes the game through a software Scale2x filter. This option achieves similar results to '''useHQXFilter''' but with less overhead and slightly less quality. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions, and '''useOpenGL''' must be disabled.
| false
|-
| '''useOpenGL'''
| When enabled, uses OpenGL hardware rendering and enables the following OpenGL options:
| false
|-
| '''checkOpenGLErrors'''
| When enabled, logs all errors returned by OpenGL.
| false
|-
| '''useOpenGLShader'''
| Selects which GLSL rendering filter to apply when the '''useOpenGL''' option is enabled. This option takes a path relative to the OpenXcom Data Folder as an argument. OpenXcom comes packaged with some filters in the ''data\Shaders'' folder which are described earlier in ''Display Filter''.
| Shaders/Openxcom.OpenGL.shader
|-
| '''useOpenGLSmoothing'''
| When enabled, the game will use linear interpolation instead of nearest-neighbour pixel scaling when no shader is specified.
| true
|-
| '''vSyncForOpenGL'''
| When enabled, puts OpenGL into vertical synchronisation mode, ensuring the FPS do not exceed your monitor's refresh rate, preventing tearing and excessive hardware demand, but may cause slower animations.
| true
|-

! colspan="3" style="background-color: #CCCCCC" | Sound

|-
| '''audioBitDepth'''
| Bit depth of the output audio. ''Only change this if you know what you're doing!''
| 16
|-
| '''audioSampleRate'''
| Sample rate (in Hz) of the output audio. ''Only change this if you know what you're doing!''
| 22050
|-
| '''musicVolume'''
| Background music volume (0-128).
| 128
|-
| '''soundVolume'''
| Sound FX volume (0-128).
| 128
|-
| '''mute'''
| When enabled, disables all audio output. Automatically enabled if no audio hardware is detected.
| false
|-

! colspan="3" style="background-color: #CCCCCC" | Geoscape/Basescape

|-
| '''aggressiveRetaliation'''
| When enabled, aliens on any type of mission may detect your base if they are in very close range.
| false
|-
| '''alienContainmentLimitEnforced'''
| When enabled, enforces the limit of live aliens that can be held in each containment facility.
| false
|-
| '''allowAutoSellProduction'''
| When enabled, players can automatically sell manufactured items by right-clicking the Up Arrow on the Quantity in the manufacture screen.
| false
|-
| '''allowBuildingQueue'''
| When enabled, unfinished facilities act as links to the access lift when new facilities are placed, thereby allowing facilities to be "queued" waiting for neighboring facilities to finish.
| false
|-
| '''anytimePsiTraining'''
| When enabled, psi training can be performed at any time, instead of waiting for the end of the month.
| false
|-
| '''canManufactureMoreItemsPerHour'''
| When enabled, allows manufacturing projects to produce more than one item per hour, if the amount of engineers is very large (like in [[TFTD]]).
| false
|-
| '''canSellLiveAliens'''
| When enabled, captured aliens can be sold for cash in the same fashion as alien corpses. Recommended when '''alienContainmentLimitEnforced''' is enabled.
| false
|-
| '''canTransferCraftsWhileAirborne'''
| When enabled, crafts can be transferred between bases while they are OUT (as long as they have enough fuel).
| false
|-
| '''craftLaunchAlways'''
| When enabled, allow crafts to take off without being READY.
| false
|-
| '''customInitialBase'''
| When enabled, allows the player to customize the facility placement of the starting base.
|-
| '''dogfightSpeed'''
|
| 20
|-
| '''geoClockSpeed'''
|
| 80
|-
| '''globeAllRadarsOnBaseBuild'''
| When enabled, all radar ranges will be shown when hovering a valid base location while building a new base.
| true
|-
| '''globeDetail'''
| When enabled, country and city details are shown when zoomed in on the globe.
| true
|-
| '''globeFlightPaths
| When enabled, shows craft flight paths on the globe.
| true
|-
| '''globeRadarLines
| When enabled, the radar ranges of player bases on the globe are shown.
| true
|-
| '''globeScrollDragButton'''
| Scrolls the map when the specified mouse button is held down and dragged.
* 0 None.
* 1 Left mouse button.
* 2 Middle mouse button.
* 3 Right mouse button.
| 2
|-
| '''globeScrollSpeed
| The scrolling speed of the globe.
| 20
|-
| '''globeSeasons'''
| When enabled, the day/night cycle takes into account the Earth's [[:Wikipedia:Axial tilt|axial tilt]] for a more realistic projection of the light.
| false
|-
| '''psiStrengthEval'''
| When enabled, evaluates the psionic strength of all soldiers after the appropriate research has been completed.
| false
|-
| '''spendResearchedItems'''
| When enabled, researching an item spends it.
| false
|-
| '''showFundsOnGeoscape'''
| When enabled, shows your available funds above the time/date on the Geoscape sidebar.
| false
|-

! colspan="3" style="background-color: #CCCCCC" | Battlescape

|-
| '''allowPsionicCapture'''
| When enabled, mind-controlling all the remaining enemy units results in a victory, and they count as live captures.
| false
|-
| '''battleAlienSpeed'''
| Animation speed of alien / civilian units moving on the map.
| 30
|-
| '''battleAutoEnd'''
| When enabled, the turn is automatically ended when all friendly/enemy units are neutralized, therefore ending the mission.
| false
|-
| '''battleConfirmFireMode'''
| When enabled, a second click is required on the same tile to confirm fire orders.
| false
|-
| '''battleEdgeScroll'''
| Sets how to scroll the map.
* 0 None.
* 1 Trigger - scroll map when the left mouse button is held down on a screen edge.
* 2 Auto - scroll map when the cursor is over a screen edge.
| 2
|-
| '''battleExplosionHeight'''
| A coefficient that controls how much vertical power explosions have.
* 0 = Explosions are completely flat, as per the original game.
* 1 = -30 damage units per level (this penalty is in addition to the horizontal penalty of -10 damage per tile).
* 2 = -10 damage units per level.
* 3 = -5 damage units per level.
| 0
|-
| '''battleFireSpeed'''
| Animation speed of bullets after being fired in pixels per frame. Game setting * 2.
| 6
|-
| '''battleHairBleach'''
|
| true
|-
| '''battleInstantGrenade'''
| When enabled, grenades are "hot". This means that when primed to 0 turns, they simply explode on impact, instead of waiting for the end of the turn.
| false
|-
| '''battleNotifyDeath'''
| When enabled, displays a text notification when a soldier dies.
| false
|-
| '''battleNewPreviewPath'''
| When enabled, your first left-click displays the path the selected unit will take, and your second click confirms the move order.
* 0 No preview.
* 1 Display path taken with colored arrows: green - can move and fire; yellow - can move; red - cannot move.
* 2 Display the time units you will have remaining after moving to the destination.
* 3 Display colored arrows and time units remaining.
| 0
|-
| '''battleSmoothCamera'''
| When enabled, the battlescape camera will remain centered on projectiles while in flight.
| false
|-
| '''battleUFOExtenderAccuracy'''
| When enabled, mimics [[UFOextender#Range_Based_Accuracy |UFO Extender's Range based accuracy]], except using stats taken from the weapon itself rather than global config options.
| false
|-
| '''battleScrollSpeed'''
| Map scrolling speed.
| 8
|-
| '''battleScrollType'''
| Map scrolling mode.
* 0 = Trigger Scroll: Hold down the LMB over the edges of the screen to scroll.
* 1 = Auto Scroll: Hover your mouse over the edges of the screen to scroll.
* 2 = Drag Scroll: Hold down MMB and drag to scroll. Recommended for playing windowed.
| 1
|-
| '''battleScrollDragButtion'''
| Controls which mouse button is held down in Drag Scrolling
* 1 = Left Mouse Button.
* 2 = Middle Mouse Button.
* 3 = Right Mouse Button.
* 6... = Other Mouse Buttons.
| 2
|-
| '''battleScrollDragInvert'''
| When enabled, Drag Scrolling moves the camera away from your mouse, rather than moving towards it.
| false
|-
| '''battleScrollDragTimeTolerance'''
| Amount of miliseconds the mouse needs to be pressed to trigger a Drag Scroll.
| 300
|-
| '''battleScrollDragPixelTolerance'''
| Amount of pixels the mouse needs to be moved after pressing to trigger a Drag Scroll.
| 10
|-
| '''battleTooltips'''
| When enabled, hovering the Battlescape buttons displays a tooltip.
| true
|-
| '''battleXcomSpeed'''
| Animation speed of X-COM units moving on the map.
| 30
|-
| '''disableAutoEquip'''
| When enabled, disables auto-equipping of new soldiers before battle.
| false
|-
| '''skipNextTurnScreen'''
| When enabled, the "Next Turn" screens during battle are advanced automatically after a short delay.
| false
|-
| '''showMoreStatsInInventoryView'''
| When enabled, the inventory screen displays extra stats in the top-right corner, such as the weight of equipment the soldier is currently wearing/carrying and their maximum weight before TU reduction sets in, their firing accuracy, reactions and psi stats.
| false
|-
| '''sneakyAI'''
| When enabled, AI avoids exposing themselves to player whenever possible.
| false
|-
| '''strafe'''
| When enabled, holding CTRL allows soldiers to strafe and run, and allows tanks to rotate their turret independently of the chassis.
| false
|-
| '''TFTDDamage'''
| When enabled, weapons will do between 50% and 150% of their rated damage as opposed to UFO:Enemy Unknown's 0% to 200%.
| false
|-
| '''traceAI'''
| Debug feature. When enabled, highlights the paths that enemy units took after their turn.
| false
|-
| '''weaponSelfDestruction'''
| When enabled, weapons dropped by aliens are destroyed unless they are captured alive (similar to the [[Enemy Unknown (EU2012)|new X-COM]]).
| false
|-
|}

== Debug mode ==

''Debug mode'' is a special feature that makes it easier for developers/contributors to test out game features without needing to play a new game from scratch. After setting "debug: true" in the ''options.cfg'' file (see above), you can enable it by pressing ''Ctrl-D'' in-game to access a variety of features:

'''Geoscape''': All research is unlocked, allowing you to easily test all features in the Geoscape without needing to manually unlock them yourself. This doesn't affect your saved game. Regional and Country borders will be displayed.

'''Battlescape''': Whole map is revealed and opening the inventory screen resets TUs, allowing you to easily test out the map and any Battlescape features without being affected by game restrictions.

[[Category:OpenXcom]]

File:OpenXcom options screen.gif

2014-04-10T14:49:45Z

Cfailde: OpenXcom "So… many… options…" options screen.

OpenXcom "So… many… options…" options screen.

Options (OpenXcom)

2014-04-08T19:27:07Z

Cfailde: /* Options File */ aspect ratio and black band options

[[Image:OpenXcomOptions.png|right|thumb|OpenXcom Options screen]]

OpenXcom has a variety of game settings that can be customized through the Options screen in the Main Menu. These options are global and affect any old or new savegame, and take effect instantly after pressing OK.

* '''Display Resolution:''' Resolution the game is rendered at. Note that the game always renders at 320x200 (original DOS resolution) and resizes to whatever you specify, so for a better picture use a resolution with the same ratio. 640x400 or 640x480 (if you like non-square pixels) are recommended. Use the arrows to scroll through the resolutions supported by your monitor, or click on the numbers to type in your own resolution. If you screw it up, use ''Restore Defaults'' or delete your ''options.cfg'' file (see below) to reset your settings.
* '''Display Mode:''' Display the game in a window or covering the whole screen. Windowed mode is recommended as monitors usually don't properly support OpenXcom's lo-fi nature in fullscreen.
* '''Music Volume:''' The volume of the background music (0 is mute, 1 is lowest, 4 is highest).
* '''SFX Volume:''' The volume of the sound effects (0 is mute, 1 is lowest, 4 is highest).
* '''Language:''' Change the language used to display all the game text.

== Display Filter ==

By default OpenXcom just resizes the screen to fit the resolution, maintaining pixel accuracy as in the original game, but a variety of [[:Wikipedia:Image scaling|image scaling]] filters can be applied to change the image quality or apply smoothing and emulation effects:
* '''Scale''': Smooths out edges, making the game look less pixelated. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions.
* '''HQX''': Similar to '''Scale''', but more accurate and high-quality. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions.
* '''CRT (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''CRT-interlaced (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''CRT-simple (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''Curvature (OpenGL)''': Simulates a rounded display.
* '''dot_n_bloom (OpenGL)''' Applies both a dot grid effect and a bloom effect.
* '''heavybloom (OpenGL)''': Applies a very heavy bloom effect.
* '''HQ2X (OpenGL)''': A double-scale version of '''HQX''', which smoothes pixel edges, but not quite to the extreme of '''HQX'''.
* '''Openxcom (OpenGL)''': Smooths rough edges while maintaining a semi-pixellated feel similar to the original X-Com. (default)
* '''Phosphor-simple (OpenGL)''' Applies a dot grid effect.
* '''Pixellate (OpenGL)''': Default pixel-accurate behaviour, but using OpenGL.
* '''SABR (OpenGL)''': Applies texel-based smoothing to the display.
* '''Scale4xHQ (OpenGL)''': A quadruple-scale version of '''HQX''', which results in a more subtle smoothing of pixel edges.
* '''simplebloom (OpenGL)''': Applies a bloom effect.

== Controls ==

In the ''Controls'' screen you can customize keyboard shortcuts for a variety of functions normally only accessible with the mouse. To change a control, left-click on it and press the new key. To erase a control, right-click it.

Besides the controls listed on the screen, there are also these hardcoded shortcuts:

*'''ALT-ENTER''' – Toggles between windowed and fullscreen mode.
*'''Right-Click''' - Automatically set the min/max on an increase/decrease arrow button.
*'''Scroll Wheel''' - Scroll lists / Zoom globe / Change Battlescape view level.
*'''Back/Forward Buttons''' - (if available) Switch between soldiers on the Battlescape.

== Advanced Options ==

By default OpenXcom is set up for vanilla behavior, but provides a variety of options that allow players to change gameplay features. In the ''Advanced Options'' screen you can customize the most-popular options to your preference, and further options can be found in the Options File described below.

== Custom Music ==

If you don't like or have trouble getting the original X-COM music to work, you can use your own. The game will look for the original gm.cat, delete (or rename to restore it later in case you change your mind) it before using custom music. The formats supported are MIDI, MP3, OGG, MOD and FLAC. Just put it in the [[SOUND]] subfolder of the [[Installing (OpenXcom)#Data Folder|Data folder]] with the same filenames as the original:

{| class="wikitable"
! Original
! PlayStation
! Cydonia's Fall
|-
| GMDEFEND
| Briefing1
| Defend Base
|-
| GMENBASE
| Briefing2
| N/A
|-
| GMGEO1
| Geoscape1
| Geoscape (Part I)
|-
| GMGEO2
| Geoscape2
| Geoscape (Part II)
|-
| GMGEO3*
| Geoscape3
| N/A
|-
| GMGEO4*
| Geoscape4
| N/A
|-
| GMINTER
| Dogfight
| Interception
|-
| GMINTRO1
| N/A
| Intro (Part I)
|-
| GMINTRO2
| N/A
| Intro (Part II)
|-
| GMINTRO3
| N/A
| Intro (Part III)
|-
| GMLOSE
| N/A
| Lose Game
|-
| GMMARS
| Debriefing
| Debriefing
|-
| GMNEWMAR
| Mission Accomplished
| Mars Briefing
|-
| GMSTORY
| Final Briefing
| The Story
|-
| GMTACTIC
| Battlescape1
| Tactical Battle
|-
| GMTACTIC2*
| Battlescape2
| N/A
|-
| GMWIN
| N/A
| Win Game
|}

''*not available in original''

'''WARNING:''' There are some bugs with the audio playback on MP3, primarily on Unix-like systems. If you start experiencing crashes after using custom music, switch to a different music format.

== Options File ==

OpenXcom stores its options in a ''options.cfg'' YAML file stored in the [[Installing (OpenXcom)#User Folder|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>". These include the options shown in the Options screen as well as other advanced options.

'''WARNING:''' Invalid values can cause incorrect behaviour or game crashes. Options that accept true/false are marked by "When enabled", options that accept a range of numbers have this listed in brackets after their description, and options that accept a numeric flag have bullets to describe the functionality of each option.

{| class="wikitable"
! Option
! Description
! Default
|-

! colspan="3" style="background-color: #CCCCCC" | General

|-
| '''autosave'''
| When enabled, the game is autosaved.
* 0 = disabled.
* 1 = quick save and quick load buttons are enabled.
* 2 = game automatically saves at 00:00 and all save and load buttons are disabled.
* 3 = same as 2, as well as automatically saving on exit of the game.
| 0
|-
| '''captureMouse'''
| When enabled, the mouse cursor is locked to the window.
| false
|-
| '''changeValueByMouseWheel'''
| The amount to increase/decrease a value when scrolling the mouse wheel over increase/decrease buttons in lists.
| 10
|-
|'''cursorInBlackBandsInFullscreen'''<br />
'''cursorInBlackBandsInWindow'''<br />
'''cursorInBlackBandsInBorderlessWindow'''
|
|
false<br />
true<br />
false
|-
| '''debug'''
| When enabled, provides features to make it easier for developers/contributors to debug their work.
| false
|-
| '''debugUi'''
| When enabled, shows text borders in UI elements to make it easier for developers/translators to debug their work.
| false
|-
| '''FPS'''
|
| 15
|-
| '''fpsCounter'''
| When enabled, shows an FPS Counter on the top-left of the screen.
| false
|-
| '''language'''
| Filename of the language loaded at startup.
| en-US
|-
| '''keyboardMode'''
| Keyboard input mode.
* 0 = Keyboard enabled.
* 1 = Keyboard disabled, type in text boxes with the arrow keys (arcade style).
| 0
|-
| '''key*'''
| (...various options starting with this prefix) Stores the keyboard controls.
|
|-
| '''NewBattle_*'''
| (...various options starting with this prefix) Stores the last-used settings in the ''New Battle'' screen.
|
|-
| '''newSeedOnLoad'''
| When enabled, uses a new seed for the random number generator instead of the one saved to a save file. The game saves the seed of its random number generator to the save files, so normally a shot’s result is the same even if the saved game is reloaded. With a new seed the game re-randomises a shot’s chance of success.
| false
|-
| '''pauseMode'''
| Controls how the game behaves when it loses focus (eg. minimized or alt-tabbed).
* 0,1 = Continue running normally on loss of focus.
* 2 = Slow down the game on loss of focus.
* 3 = Pause completely on loss of focus.
| 0
|-
| '''playIntro'''
| When enabled, plays the intro cinematic on startup.
| true
|-
| '''saveOrder'''
| Controls the order in which saved games are displayed in the save/load game menus.
* 0 Ascending name order, i.e. A to Z.
* 1 Descending name order, i.e. Z to A.
* 2 Ascending date order, i.e. oldest saves first.
* 3 Descending date order, i.e. newest saves first.
| 3
|-

! colspan="3" style="background-color: #CCCCCC" | Display

|-
| '''allowResize'''
| When enabled and the game is in windowed mode, the game resolution can be dynamically resized by changing the window size.
| false
|-
| '''asyncBlit'''
| When enabled, the display surface uses asynchronous updates. This will usually slow down blitting on single CPU machines, but may provide a speed increase on SMP systems.
| true
|-
| '''baseXBattlescape'''
'''baseYBattlescape'''
|
| 320
200
|-
| '''baseXGeoscape'''
'''baseYGeoscape'''
|
| 320
200
|-
| '''baseXResolution'''
'''baseYResolution'''
| The game's base resolution in pixels, you can think of it as the "viewport", so changing this would let you see more of the Geoscape/Battlescape at once.
'''WARNING:''' This feature is experimental and can cause UI and performance problems, as the game is not designed for flexible resolutions.
| 320
200
|-
| '''borderless'''
| When enabled, the game is displayed without a window frame when playing in windowed mode.
| false
|-
| '''displayWidth'''
'''displayHeight'''
| Display resolution in pixels. The game will scale the base resolution to fit this value, so it should be greater than or equal to '''baseXResolution''' x '''baseYResolution.
| 640
400
|-
| '''fullscreen'''
| When enabled, the game will run in fullscreen mode as opposed to windowed mode.
'''NOTE''': The display might become distorted or clipped in fullscreen if your device doesn't support the specified resolution.
| false
|-
| '''keepAspectRatio'''
| When enabled, letterboxes the display to maintain the original aspect ratio.
| false
|-
| '''maxFrameSkip'''
| Specifies the maximum amount of frames the game can skip rendering.
| 0
|-
| '''windowedModePositionX'''
'''windowedModePositionY'''
| When running in windowed mode, forces the game window to start in the specified position in pixels. Use -1 to have the OS decide the window position.
| -1
-1
|-
| '''useHQXFilter'''
| When enabled, applies a rendering filter that smoothes out diagonal edges, making the game look less pixelated. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions, and '''useOpenGL''' must be disabled.
| false
|-
| '''useScaleFilter'''
| When enabled, passes the game through a software Scale2x filter. This option achieves similar results to '''useHQXFilter''' but with less overhead and slightly less quality. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions, and '''useOpenGL''' must be disabled.
| false
|-
| '''useOpenGL'''
| When enabled, uses OpenGL hardware rendering and enables the following OpenGL options:
| false
|-
| '''checkOpenGLErrors'''
| When enabled, logs all errors returned by OpenGL.
| false
|-
| '''useOpenGLShader'''
| Selects which GLSL rendering filter to apply when the '''useOpenGL''' option is enabled. This option takes a path relative to the OpenXcom Data Folder as an argument. OpenXcom comes packaged with some filters in the ''data\Shaders'' folder which are described earlier in ''Display Filter''.
| Shaders/Openxcom.OpenGL.shader
|-
| '''useOpenGLSmoothing'''
| When enabled, the game will use linear interpolation instead of nearest-neighbour pixel scaling when no shader is specified.
| true
|-
| '''vSyncForOpenGL'''
| When enabled, puts OpenGL into vertical synchronisation mode, ensuring the FPS do not exceed your monitor's refresh rate, preventing tearing and excessive hardware demand, but may cause slower animations.
| true
|-

! colspan="3" style="background-color: #CCCCCC" | Sound

|-
| '''audioBitDepth'''
| Bit depth of the output audio. ''Only change this if you know what you're doing!''
| 16
|-
| '''audioSampleRate'''
| Sample rate (in Hz) of the output audio. ''Only change this if you know what you're doing!''
| 22050
|-
| '''musicVolume'''
| Background music volume (0-128).
| 128
|-
| '''soundVolume'''
| Sound FX volume (0-128).
| 128
|-
| '''mute'''
| When enabled, disables all audio output. Automatically enabled if no audio hardware is detected.
| false
|-

! colspan="3" style="background-color: #CCCCCC" | Geoscape/Basescape

|-
| '''aggressiveRetaliation'''
| When enabled, aliens on any type of mission may detect your base if they are in very close range.
| false
|-
| '''alienContainmentLimitEnforced'''
| When enabled, enforces the limit of live aliens that can be held in each containment facility.
| false
|-
| '''allowAutoSellProduction'''
| When enabled, players can automatically sell manufactured items by right-clicking the Up Arrow on the Quantity in the manufacture screen.
| false
|-
| '''allowBuildingQueue'''
| When enabled, unfinished facilities act as links to the access lift when new facilities are placed, thereby allowing facilities to be "queued" waiting for neighboring facilities to finish.
| false
|-
| '''anytimePsiTraining'''
| When enabled, psi training can be performed at any time, instead of waiting for the end of the month.
| false
|-
| '''canManufactureMoreItemsPerHour'''
| When enabled, allows manufacturing projects to produce more than one item per hour, if the amount of engineers is very large (like in [[TFTD]]).
| false
|-
| '''canSellLiveAliens'''
| When enabled, captured aliens can be sold for cash in the same fashion as alien corpses. Recommended when '''alienContainmentLimitEnforced''' is enabled.
| false
|-
| '''canTransferCraftsWhileAirborne'''
| When enabled, crafts can be transferred between bases while they are OUT (as long as they have enough fuel).
| false
|-
| '''craftLaunchAlways'''
| When enabled, allow crafts to take off without being READY.
| false
|-
| '''customInitialBase'''
| When enabled, allows the player to customize the facility placement of the starting base.
|-
| '''dogfightSpeed'''
|
| 20
|-
| '''geoClockSpeed'''
|
| 80
|-
| '''globeAllRadarsOnBaseBuild'''
| When enabled, all radar ranges will be shown when hovering a valid base location while building a new base.
| true
|-
| '''globeDetail'''
| When enabled, country and city details are shown when zoomed in on the globe.
| true
|-
| '''globeFlightPaths
| When enabled, shows craft flight paths on the globe.
| true
|-
| '''globeRadarLines
| When enabled, the radar ranges of player bases on the globe are shown.
| true
|-
| '''globeScrollDragButton'''
| Scrolls the map when the specified mouse button is held down and dragged.
* 0 None.
* 1 Left mouse button.
* 2 Middle mouse button.
* 3 Right mouse button.
| 2
|-
| '''globeScrollSpeed
| The scrolling speed of the globe.
| 20
|-
| '''globeSeasons'''
| When enabled, the day/night cycle takes into account the Earth's [[:Wikipedia:Axial tilt|axial tilt]] for a more realistic projection of the light.
| false
|-
| '''psiStrengthEval'''
| When enabled, evaluates the psionic strength of all soldiers after the appropriate research has been completed.
| false
|-
| '''spendResearchedItems'''
| When enabled, researching an item spends it.
| false
|-
| '''showFundsOnGeoscape'''
| When enabled, shows your available funds above the time/date on the Geoscape sidebar.
| false
|-

! colspan="3" style="background-color: #CCCCCC" | Battlescape

|-
| '''allowPsionicCapture'''
| When enabled, mind-controlling all the remaining enemy units results in a victory, and they count as live captures.
| false
|-
| '''battleAlienSpeed'''
| Animation speed of alien / civilian units moving on the map.
| 30
|-
| '''battleAutoEnd'''
| When enabled, the turn is automatically ended when all friendly/enemy units are neutralized, therefore ending the mission.
| false
|-
| '''battleConfirmFireMode'''
| When enabled, a second click is required on the same tile to confirm fire orders.
| false
|-
| '''battleEdgeScroll'''
| Sets how to scroll the map.
* 0 None.
* 1 Trigger - scroll map when the left mouse button is held down on a screen edge.
* 2 Auto - scroll map when the cursor is over a screen edge.
| 2
|-
| '''battleExplosionHeight'''
| A coefficient that controls how much vertical power explosions have.
* 0 = Explosions are completely flat, as per the original game.
* 1 = -30 damage units per level (this penalty is in addition to the horizontal penalty of -10 damage per tile).
* 2 = -10 damage units per level.
* 3 = -5 damage units per level.
| 0
|-
| '''battleFireSpeed'''
| Animation speed of bullets after being fired in pixels per frame. Game setting * 2.
| 6
|-
| '''battleHairBleach'''
|
| true
|-
| '''battleInstantGrenade'''
| When enabled, grenades are "hot". This means that when primed to 0 turns, they simply explode on impact, instead of waiting for the end of the turn.
| false
|-
| '''battleNotifyDeath'''
| When enabled, displays a text notification when a soldier dies.
| false
|-
| '''battleNewPreviewPath'''
| When enabled, your first left-click displays the path the selected unit will take, and your second click confirms the move order.
* 0 No preview.
* 1 Display path taken with colored arrows: green - can move and fire; yellow - can move; red - cannot move.
* 2 Display the time units you will have remaining after moving to the destination.
* 3 Display colored arrows and time units remaining.
| 0
|-
| '''battleSmoothCamera'''
| When enabled, the battlescape camera will remain centered on projectiles while in flight.
| false
|-
| '''battleUFOExtenderAccuracy'''
| When enabled, mimics [[UFOextender#Range_Based_Accuracy |UFO Extender's Range based accuracy]], except using stats taken from the weapon itself rather than global config options.
| false
|-
| '''battleScrollSpeed'''
| Map scrolling speed.
| 8
|-
| '''battleScrollType'''
| Map scrolling mode.
* 0 = Trigger Scroll: Hold down the LMB over the edges of the screen to scroll.
* 1 = Auto Scroll: Hover your mouse over the edges of the screen to scroll.
* 2 = Drag Scroll: Hold down MMB and drag to scroll. Recommended for playing windowed.
| 1
|-
| '''battleScrollDragButtion'''
| Controls which mouse button is held down in Drag Scrolling
* 1 = Left Mouse Button.
* 2 = Middle Mouse Button.
* 3 = Right Mouse Button.
* 6... = Other Mouse Buttons.
| 2
|-
| '''battleScrollDragInvert'''
| When enabled, Drag Scrolling moves the camera away from your mouse, rather than moving towards it.
| false
|-
| '''battleScrollDragTimeTolerance'''
| Amount of miliseconds the mouse needs to be pressed to trigger a Drag Scroll.
| 300
|-
| '''battleScrollDragPixelTolerance'''
| Amount of pixels the mouse needs to be moved after pressing to trigger a Drag Scroll.
| 10
|-
| '''battleTooltips'''
| When enabled, hovering the Battlescape buttons displays a tooltip.
| true
|-
| '''battleXcomSpeed'''
| Animation speed of X-COM units moving on the map.
| 30
|-
| '''disableAutoEquip'''
| When enabled, disables auto-equipping of new soldiers before battle.
| false
|-
| '''skipNextTurnScreen'''
| When enabled, the "Next Turn" screens during battle are advanced automatically after a short delay.
| false
|-
| '''showMoreStatsInInventoryView'''
| When enabled, the inventory screen displays extra stats in the top-right corner, such as the weight of equipment the soldier is currently wearing/carrying and their maximum weight before TU reduction sets in, their firing accuracy, reactions and psi stats.
| false
|-
| '''sneakyAI'''
| When enabled, AI avoids exposing themselves to player whenever possible.
| false
|-
| '''strafe'''
| When enabled, holding CTRL allows soldiers to strafe and run, and allows tanks to rotate their turret independently of the chassis.
| false
|-
| '''TFTDDamage'''
| When enabled, weapons will do between 50% and 150% of their rated damage as opposed to UFO:Enemy Unknown's 0% to 200%.
| false
|-
| '''traceAI'''
| Debug feature. When enabled, highlights the paths that enemy units took after their turn.
| false
|-
| '''weaponSelfDestruction'''
| When enabled, weapons dropped by aliens are destroyed unless they are captured alive (similar to the [[Enemy Unknown (EU2012)|new X-COM]]).
| false
|-
|}

== Debug mode ==

''Debug mode'' is a special feature that makes it easier for developers/contributors to test out game features without needing to play a new game from scratch. After setting "debug: true" in the ''options.cfg'' file (see above), you can enable it by pressing ''Ctrl-D'' in-game to access a variety of features:

'''Geoscape''': All research is unlocked, allowing you to easily test all features in the Geoscape without needing to manually unlock them yourself. This doesn't affect your saved game. Regional and Country borders will be displayed.

'''Battlescape''': Whole map is revealed and opening the inventory screen resets TUs, allowing you to easily test out the map and any Battlescape features without being affected by game restrictions.

[[Category:OpenXcom]]

Options (OpenXcom)

2014-04-08T19:04:11Z

Cfailde: /* Options File */ newSeedOnLoad

[[Image:OpenXcomOptions.png|right|thumb|OpenXcom Options screen]]

OpenXcom has a variety of game settings that can be customized through the Options screen in the Main Menu. These options are global and affect any old or new savegame, and take effect instantly after pressing OK.

* '''Display Resolution:''' Resolution the game is rendered at. Note that the game always renders at 320x200 (original DOS resolution) and resizes to whatever you specify, so for a better picture use a resolution with the same ratio. 640x400 or 640x480 (if you like non-square pixels) are recommended. Use the arrows to scroll through the resolutions supported by your monitor, or click on the numbers to type in your own resolution. If you screw it up, use ''Restore Defaults'' or delete your ''options.cfg'' file (see below) to reset your settings.
* '''Display Mode:''' Display the game in a window or covering the whole screen. Windowed mode is recommended as monitors usually don't properly support OpenXcom's lo-fi nature in fullscreen.
* '''Music Volume:''' The volume of the background music (0 is mute, 1 is lowest, 4 is highest).
* '''SFX Volume:''' The volume of the sound effects (0 is mute, 1 is lowest, 4 is highest).
* '''Language:''' Change the language used to display all the game text.

== Display Filter ==

By default OpenXcom just resizes the screen to fit the resolution, maintaining pixel accuracy as in the original game, but a variety of [[:Wikipedia:Image scaling|image scaling]] filters can be applied to change the image quality or apply smoothing and emulation effects:
* '''Scale''': Smooths out edges, making the game look less pixelated. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions.
* '''HQX''': Similar to '''Scale''', but more accurate and high-quality. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions.
* '''CRT (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''CRT-interlaced (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''CRT-simple (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''Curvature (OpenGL)''': Simulates a rounded display.
* '''dot_n_bloom (OpenGL)''' Applies both a dot grid effect and a bloom effect.
* '''heavybloom (OpenGL)''': Applies a very heavy bloom effect.
* '''HQ2X (OpenGL)''': A double-scale version of '''HQX''', which smoothes pixel edges, but not quite to the extreme of '''HQX'''.
* '''Openxcom (OpenGL)''': Smooths rough edges while maintaining a semi-pixellated feel similar to the original X-Com. (default)
* '''Phosphor-simple (OpenGL)''' Applies a dot grid effect.
* '''Pixellate (OpenGL)''': Default pixel-accurate behaviour, but using OpenGL.
* '''SABR (OpenGL)''': Applies texel-based smoothing to the display.
* '''Scale4xHQ (OpenGL)''': A quadruple-scale version of '''HQX''', which results in a more subtle smoothing of pixel edges.
* '''simplebloom (OpenGL)''': Applies a bloom effect.

== Controls ==

In the ''Controls'' screen you can customize keyboard shortcuts for a variety of functions normally only accessible with the mouse. To change a control, left-click on it and press the new key. To erase a control, right-click it.

Besides the controls listed on the screen, there are also these hardcoded shortcuts:

*'''ALT-ENTER''' – Toggles between windowed and fullscreen mode.
*'''Right-Click''' - Automatically set the min/max on an increase/decrease arrow button.
*'''Scroll Wheel''' - Scroll lists / Zoom globe / Change Battlescape view level.
*'''Back/Forward Buttons''' - (if available) Switch between soldiers on the Battlescape.

== Advanced Options ==

By default OpenXcom is set up for vanilla behavior, but provides a variety of options that allow players to change gameplay features. In the ''Advanced Options'' screen you can customize the most-popular options to your preference, and further options can be found in the Options File described below.

== Custom Music ==

If you don't like or have trouble getting the original X-COM music to work, you can use your own. The game will look for the original gm.cat, delete (or rename to restore it later in case you change your mind) it before using custom music. The formats supported are MIDI, MP3, OGG, MOD and FLAC. Just put it in the [[SOUND]] subfolder of the [[Installing (OpenXcom)#Data Folder|Data folder]] with the same filenames as the original:

{| class="wikitable"
! Original
! PlayStation
! Cydonia's Fall
|-
| GMDEFEND
| Briefing1
| Defend Base
|-
| GMENBASE
| Briefing2
| N/A
|-
| GMGEO1
| Geoscape1
| Geoscape (Part I)
|-
| GMGEO2
| Geoscape2
| Geoscape (Part II)
|-
| GMGEO3*
| Geoscape3
| N/A
|-
| GMGEO4*
| Geoscape4
| N/A
|-
| GMINTER
| Dogfight
| Interception
|-
| GMINTRO1
| N/A
| Intro (Part I)
|-
| GMINTRO2
| N/A
| Intro (Part II)
|-
| GMINTRO3
| N/A
| Intro (Part III)
|-
| GMLOSE
| N/A
| Lose Game
|-
| GMMARS
| Debriefing
| Debriefing
|-
| GMNEWMAR
| Mission Accomplished
| Mars Briefing
|-
| GMSTORY
| Final Briefing
| The Story
|-
| GMTACTIC
| Battlescape1
| Tactical Battle
|-
| GMTACTIC2*
| Battlescape2
| N/A
|-
| GMWIN
| N/A
| Win Game
|}

''*not available in original''

'''WARNING:''' There are some bugs with the audio playback on MP3, primarily on Unix-like systems. If you start experiencing crashes after using custom music, switch to a different music format.

== Options File ==

OpenXcom stores its options in a ''options.cfg'' YAML file stored in the [[Installing (OpenXcom)#User Folder|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>". These include the options shown in the Options screen as well as other advanced options.

'''WARNING:''' Invalid values can cause incorrect behaviour or game crashes. Options that accept true/false are marked by "When enabled", options that accept a range of numbers have this listed in brackets after their description, and options that accept a numeric flag have bullets to describe the functionality of each option.

{| class="wikitable"
! Option
! Description
! Default
|-

! colspan="3" style="background-color: #CCCCCC" | General

|-
| '''autosave'''
| When enabled, the game is autosaved.
* 0 = disabled.
* 1 = quick save and quick load buttons are enabled.
* 2 = game automatically saves at 00:00 and all save and load buttons are disabled.
* 3 = same as 2, as well as automatically saving on exit of the game.
| 0
|-
| '''captureMouse'''
| When enabled, the mouse cursor is locked to the window.
| false
|-
| '''changeValueByMouseWheel'''
| The amount to increase/decrease a value when scrolling the mouse wheel over increase/decrease buttons in lists.
| 10
|-
| '''debug'''
| When enabled, provides features to make it easier for developers/contributors to debug their work.
| false
|-
| '''debugUi'''
| When enabled, shows text borders in UI elements to make it easier for developers/translators to debug their work.
| false
|-
| '''FPS'''
|
| 15
|-
| '''fpsCounter'''
| When enabled, shows an FPS Counter on the top-left of the screen.
| false
|-
| '''language'''
| Filename of the language loaded at startup.
| en-US
|-
| '''keyboardMode'''
| Keyboard input mode.
* 0 = Keyboard enabled.
* 1 = Keyboard disabled, type in text boxes with the arrow keys (arcade style).
| 0
|-
| '''key*'''
| (...various options starting with this prefix) Stores the keyboard controls.
|
|-
| '''NewBattle_*'''
| (...various options starting with this prefix) Stores the last-used settings in the ''New Battle'' screen.
|
|-
| '''newSeedOnLoad'''
| When enabled, uses a new seed for the random number generator instead of the one saved to a save file. The game saves the seed of its random number generator to the save files, so normally a shot’s result is the same even if the saved game is reloaded. With a new seed the game re-randomises a shot’s chance of success.
| false
|-
| '''pauseMode'''
| Controls how the game behaves when it loses focus (eg. minimized or alt-tabbed).
* 0,1 = Continue running normally on loss of focus.
* 2 = Slow down the game on loss of focus.
* 3 = Pause completely on loss of focus.
| 0
|-
| '''playIntro'''
| When enabled, plays the intro cinematic on startup.
| true
|-
| '''saveOrder'''
| Controls the order in which saved games are displayed in the save/load game menus.
* 0 Ascending name order, i.e. A to Z.
* 1 Descending name order, i.e. Z to A.
* 2 Ascending date order, i.e. oldest saves first.
* 3 Descending date order, i.e. newest saves first.
| 3
|-

! colspan="3" style="background-color: #CCCCCC" | Display

|-
| '''allowResize'''
| When enabled and the game is in windowed mode, the game resolution can be dynamically resized by changing the window size.
| false
|-
| '''asyncBlit'''
| When enabled, the display surface uses asynchronous updates. This will usually slow down blitting on single CPU machines, but may provide a speed increase on SMP systems.
| true
|-
| '''baseXBattlescape'''
'''baseYBattlescape'''
|
| 320
200
|-
| '''baseXGeoscape'''
'''baseYGeoscape'''
|
| 320
200
|-
| '''baseXResolution'''
'''baseYResolution'''
| The game's base resolution in pixels, you can think of it as the "viewport", so changing this would let you see more of the Geoscape/Battlescape at once.
'''WARNING:''' This feature is experimental and can cause UI and performance problems, as the game is not designed for flexible resolutions.
| 320
200
|-
| '''borderless'''
| When enabled, the game is displayed without a window frame when playing in windowed mode.
| false
|-
| '''displayWidth'''
'''displayHeight'''
| Display resolution in pixels. The game will scale the base resolution to fit this value, so it should be greater than or equal to '''baseXResolution''' x '''baseYResolution.
| 640
400
|-
| '''fullscreen'''
| When enabled, the game will run in fullscreen mode as opposed to windowed mode.
'''NOTE''': The display might become distorted or clipped in fullscreen if your device doesn't support the specified resolution.
| false
|-
| '''maxFrameSkip'''
| Specifies the maximum amount of frames the game can skip rendering.
| 0
|-
| '''windowedModePositionX'''
'''windowedModePositionY'''
| When running in windowed mode, forces the game window to start in the specified position in pixels. Use -1 to have the OS decide the window position.
| -1
-1
|-
| '''useHQXFilter'''
| When enabled, applies a rendering filter that smoothes out diagonal edges, making the game look less pixelated. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions, and '''useOpenGL''' must be disabled.
| false
|-
| '''useScaleFilter'''
| When enabled, passes the game through a software Scale2x filter. This option achieves similar results to '''useHQXFilter''' but with less overhead and slightly less quality. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions, and '''useOpenGL''' must be disabled.
| false
|-
| '''useOpenGL'''
| When enabled, uses OpenGL hardware rendering and enables the following OpenGL options:
| false
|-
| '''checkOpenGLErrors'''
| When enabled, logs all errors returned by OpenGL.
| false
|-
| '''useOpenGLShader'''
| Selects which GLSL rendering filter to apply when the '''useOpenGL''' option is enabled. This option takes a path relative to the OpenXcom Data Folder as an argument. OpenXcom comes packaged with some filters in the ''data\Shaders'' folder which are described earlier in ''Display Filter''.
| Shaders/Openxcom.OpenGL.shader
|-
| '''useOpenGLSmoothing'''
| When enabled, the game will use linear interpolation instead of nearest-neighbour pixel scaling when no shader is specified.
| true
|-
| '''vSyncForOpenGL'''
| When enabled, puts OpenGL into vertical synchronisation mode, ensuring the FPS do not exceed your monitor's refresh rate, preventing tearing and excessive hardware demand, but may cause slower animations.
| true
|-

! colspan="3" style="background-color: #CCCCCC" | Sound

|-
| '''audioBitDepth'''
| Bit depth of the output audio. ''Only change this if you know what you're doing!''
| 16
|-
| '''audioSampleRate'''
| Sample rate (in Hz) of the output audio. ''Only change this if you know what you're doing!''
| 22050
|-
| '''musicVolume'''
| Background music volume (0-128).
| 128
|-
| '''soundVolume'''
| Sound FX volume (0-128).
| 128
|-
| '''mute'''
| When enabled, disables all audio output. Automatically enabled if no audio hardware is detected.
| false
|-

! colspan="3" style="background-color: #CCCCCC" | Geoscape/Basescape

|-
| '''aggressiveRetaliation'''
| When enabled, aliens on any type of mission may detect your base if they are in very close range.
| false
|-
| '''alienContainmentLimitEnforced'''
| When enabled, enforces the limit of live aliens that can be held in each containment facility.
| false
|-
| '''allowAutoSellProduction'''
| When enabled, players can automatically sell manufactured items by right-clicking the Up Arrow on the Quantity in the manufacture screen.
| false
|-
| '''allowBuildingQueue'''
| When enabled, unfinished facilities act as links to the access lift when new facilities are placed, thereby allowing facilities to be "queued" waiting for neighboring facilities to finish.
| false
|-
| '''anytimePsiTraining'''
| When enabled, psi training can be performed at any time, instead of waiting for the end of the month.
| false
|-
| '''canManufactureMoreItemsPerHour'''
| When enabled, allows manufacturing projects to produce more than one item per hour, if the amount of engineers is very large (like in [[TFTD]]).
| false
|-
| '''canSellLiveAliens'''
| When enabled, captured aliens can be sold for cash in the same fashion as alien corpses. Recommended when '''alienContainmentLimitEnforced''' is enabled.
| false
|-
| '''canTransferCraftsWhileAirborne'''
| When enabled, crafts can be transferred between bases while they are OUT (as long as they have enough fuel).
| false
|-
| '''craftLaunchAlways'''
| When enabled, allow crafts to take off without being READY.
| false
|-
| '''customInitialBase'''
| When enabled, allows the player to customize the facility placement of the starting base.
|-
| '''dogfightSpeed'''
|
| 20
|-
| '''geoClockSpeed'''
|
| 80
|-
| '''globeAllRadarsOnBaseBuild'''
| When enabled, all radar ranges will be shown when hovering a valid base location while building a new base.
| true
|-
| '''globeDetail'''
| When enabled, country and city details are shown when zoomed in on the globe.
| true
|-
| '''globeFlightPaths
| When enabled, shows craft flight paths on the globe.
| true
|-
| '''globeRadarLines
| When enabled, the radar ranges of player bases on the globe are shown.
| true
|-
| '''globeScrollDragButton'''
| Scrolls the map when the specified mouse button is held down and dragged.
* 0 None.
* 1 Left mouse button.
* 2 Middle mouse button.
* 3 Right mouse button.
| 2
|-
| '''globeScrollSpeed
| The scrolling speed of the globe.
| 20
|-
| '''globeSeasons'''
| When enabled, the day/night cycle takes into account the Earth's [[:Wikipedia:Axial tilt|axial tilt]] for a more realistic projection of the light.
| false
|-
| '''psiStrengthEval'''
| When enabled, evaluates the psionic strength of all soldiers after the appropriate research has been completed.
| false
|-
| '''spendResearchedItems'''
| When enabled, researching an item spends it.
| false
|-
| '''showFundsOnGeoscape'''
| When enabled, shows your available funds above the time/date on the Geoscape sidebar.
| false
|-

! colspan="3" style="background-color: #CCCCCC" | Battlescape

|-
| '''allowPsionicCapture'''
| When enabled, mind-controlling all the remaining enemy units results in a victory, and they count as live captures.
| false
|-
| '''battleAlienSpeed'''
| Animation speed of alien / civilian units moving on the map.
| 30
|-
| '''battleAutoEnd'''
| When enabled, the turn is automatically ended when all friendly/enemy units are neutralized, therefore ending the mission.
| false
|-
| '''battleConfirmFireMode'''
| When enabled, a second click is required on the same tile to confirm fire orders.
| false
|-
| '''battleEdgeScroll'''
| Sets how to scroll the map.
* 0 None.
* 1 Trigger - scroll map when the left mouse button is held down on a screen edge.
* 2 Auto - scroll map when the cursor is over a screen edge.
| 2
|-
| '''battleExplosionHeight'''
| A coefficient that controls how much vertical power explosions have.
* 0 = Explosions are completely flat, as per the original game.
* 1 = -30 damage units per level (this penalty is in addition to the horizontal penalty of -10 damage per tile).
* 2 = -10 damage units per level.
* 3 = -5 damage units per level.
| 0
|-
| '''battleFireSpeed'''
| Animation speed of bullets after being fired in pixels per frame. Game setting * 2.
| 6
|-
| '''battleHairBleach'''
|
| true
|-
| '''battleInstantGrenade'''
| When enabled, grenades are "hot". This means that when primed to 0 turns, they simply explode on impact, instead of waiting for the end of the turn.
| false
|-
| '''battleNotifyDeath'''
| When enabled, displays a text notification when a soldier dies.
| false
|-
| '''battleNewPreviewPath'''
| When enabled, your first left-click displays the path the selected unit will take, and your second click confirms the move order.
* 0 No preview.
* 1 Display path taken with colored arrows: green - can move and fire; yellow - can move; red - cannot move.
* 2 Display the time units you will have remaining after moving to the destination.
* 3 Display colored arrows and time units remaining.
| 0
|-
| '''battleSmoothCamera'''
| When enabled, the battlescape camera will remain centered on projectiles while in flight.
| false
|-
| '''battleUFOExtenderAccuracy'''
| When enabled, mimics [[UFOextender#Range_Based_Accuracy |UFO Extender's Range based accuracy]], except using stats taken from the weapon itself rather than global config options.
| false
|-
| '''battleScrollSpeed'''
| Map scrolling speed.
| 8
|-
| '''battleScrollType'''
| Map scrolling mode.
* 0 = Trigger Scroll: Hold down the LMB over the edges of the screen to scroll.
* 1 = Auto Scroll: Hover your mouse over the edges of the screen to scroll.
* 2 = Drag Scroll: Hold down MMB and drag to scroll. Recommended for playing windowed.
| 1
|-
| '''battleScrollDragButtion'''
| Controls which mouse button is held down in Drag Scrolling
* 1 = Left Mouse Button.
* 2 = Middle Mouse Button.
* 3 = Right Mouse Button.
* 6... = Other Mouse Buttons.
| 2
|-
| '''battleScrollDragInvert'''
| When enabled, Drag Scrolling moves the camera away from your mouse, rather than moving towards it.
| false
|-
| '''battleScrollDragTimeTolerance'''
| Amount of miliseconds the mouse needs to be pressed to trigger a Drag Scroll.
| 300
|-
| '''battleScrollDragPixelTolerance'''
| Amount of pixels the mouse needs to be moved after pressing to trigger a Drag Scroll.
| 10
|-
| '''battleTooltips'''
| When enabled, hovering the Battlescape buttons displays a tooltip.
| true
|-
| '''battleXcomSpeed'''
| Animation speed of X-COM units moving on the map.
| 30
|-
| '''disableAutoEquip'''
| When enabled, disables auto-equipping of new soldiers before battle.
| false
|-
| '''skipNextTurnScreen'''
| When enabled, the "Next Turn" screens during battle are advanced automatically after a short delay.
| false
|-
| '''showMoreStatsInInventoryView'''
| When enabled, the inventory screen displays extra stats in the top-right corner, such as the weight of equipment the soldier is currently wearing/carrying and their maximum weight before TU reduction sets in, their firing accuracy, reactions and psi stats.
| false
|-
| '''sneakyAI'''
| When enabled, AI avoids exposing themselves to player whenever possible.
| false
|-
| '''strafe'''
| When enabled, holding CTRL allows soldiers to strafe and run, and allows tanks to rotate their turret independently of the chassis.
| false
|-
| '''TFTDDamage'''
| When enabled, weapons will do between 50% and 150% of their rated damage as opposed to UFO:Enemy Unknown's 0% to 200%.
| false
|-
| '''traceAI'''
| Debug feature. When enabled, highlights the paths that enemy units took after their turn.
| false
|-
| '''weaponSelfDestruction'''
| When enabled, weapons dropped by aliens are destroyed unless they are captured alive (similar to the [[Enemy Unknown (EU2012)|new X-COM]]).
| false
|-
|}

== Debug mode ==

''Debug mode'' is a special feature that makes it easier for developers/contributors to test out game features without needing to play a new game from scratch. After setting "debug: true" in the ''options.cfg'' file (see above), you can enable it by pressing ''Ctrl-D'' in-game to access a variety of features:

'''Geoscape''': All research is unlocked, allowing you to easily test all features in the Geoscape without needing to manually unlock them yourself. This doesn't affect your saved game. Regional and Country borders will be displayed.

'''Battlescape''': Whole map is revealed and opening the inventory screen resets TUs, allowing you to easily test out the map and any Battlescape features without being affected by game restrictions.

[[Category:OpenXcom]]

Options (OpenXcom)

2014-04-08T16:28:47Z

Cfailde: Updated battleNewPreviewPath description

[[Image:OpenXcomOptions.png|right|thumb|OpenXcom Options screen]]

OpenXcom has a variety of game settings that can be customized through the Options screen in the Main Menu. These options are global and affect any old or new savegame, and take effect instantly after pressing OK.

* '''Display Resolution:''' Resolution the game is rendered at. Note that the game always renders at 320x200 (original DOS resolution) and resizes to whatever you specify, so for a better picture use a resolution with the same ratio. 640x400 or 640x480 (if you like non-square pixels) are recommended. Use the arrows to scroll through the resolutions supported by your monitor, or click on the numbers to type in your own resolution. If you screw it up, use ''Restore Defaults'' or delete your ''options.cfg'' file (see below) to reset your settings.
* '''Display Mode:''' Display the game in a window or covering the whole screen. Windowed mode is recommended as monitors usually don't properly support OpenXcom's lo-fi nature in fullscreen.
* '''Music Volume:''' The volume of the background music (0 is mute, 1 is lowest, 4 is highest).
* '''SFX Volume:''' The volume of the sound effects (0 is mute, 1 is lowest, 4 is highest).
* '''Language:''' Change the language used to display all the game text.

== Display Filter ==

By default OpenXcom just resizes the screen to fit the resolution, maintaining pixel accuracy as in the original game, but a variety of [[:Wikipedia:Image scaling|image scaling]] filters can be applied to change the image quality or apply smoothing and emulation effects:
* '''Scale''': Smooths out edges, making the game look less pixelated. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions.
* '''HQX''': Similar to '''Scale''', but more accurate and high-quality. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions.
* '''CRT (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''CRT-interlaced (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''CRT-simple (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''Curvature (OpenGL)''': Simulates a rounded display.
* '''dot_n_bloom (OpenGL)''' Applies both a dot grid effect and a bloom effect.
* '''heavybloom (OpenGL)''': Applies a very heavy bloom effect.
* '''HQ2X (OpenGL)''': A double-scale version of '''HQX''', which smoothes pixel edges, but not quite to the extreme of '''HQX'''.
* '''Openxcom (OpenGL)''': Smooths rough edges while maintaining a semi-pixellated feel similar to the original X-Com. (default)
* '''Phosphor-simple (OpenGL)''' Applies a dot grid effect.
* '''Pixellate (OpenGL)''': Default pixel-accurate behaviour, but using OpenGL.
* '''SABR (OpenGL)''': Applies texel-based smoothing to the display.
* '''Scale4xHQ (OpenGL)''': A quadruple-scale version of '''HQX''', which results in a more subtle smoothing of pixel edges.
* '''simplebloom (OpenGL)''': Applies a bloom effect.

== Controls ==

In the ''Controls'' screen you can customize keyboard shortcuts for a variety of functions normally only accessible with the mouse. To change a control, left-click on it and press the new key. To erase a control, right-click it.

Besides the controls listed on the screen, there are also these hardcoded shortcuts:

*'''ALT-ENTER''' – Toggles between windowed and fullscreen mode.
*'''Right-Click''' - Automatically set the min/max on an increase/decrease arrow button.
*'''Scroll Wheel''' - Scroll lists / Zoom globe / Change Battlescape view level.
*'''Back/Forward Buttons''' - (if available) Switch between soldiers on the Battlescape.

== Advanced Options ==

By default OpenXcom is set up for vanilla behavior, but provides a variety of options that allow players to change gameplay features. In the ''Advanced Options'' screen you can customize the most-popular options to your preference, and further options can be found in the Options File described below.

== Custom Music ==

If you don't like or have trouble getting the original X-COM music to work, you can use your own. The game will look for the original gm.cat, delete (or rename to restore it later in case you change your mind) it before using custom music. The formats supported are MIDI, MP3, OGG, MOD and FLAC. Just put it in the [[SOUND]] subfolder of the [[Installing (OpenXcom)#Data Folder|Data folder]] with the same filenames as the original:

{| class="wikitable"
! Original
! PlayStation
! Cydonia's Fall
|-
| GMDEFEND
| Briefing1
| Defend Base
|-
| GMENBASE
| Briefing2
| N/A
|-
| GMGEO1
| Geoscape1
| Geoscape (Part I)
|-
| GMGEO2
| Geoscape2
| Geoscape (Part II)
|-
| GMGEO3*
| Geoscape3
| N/A
|-
| GMGEO4*
| Geoscape4
| N/A
|-
| GMINTER
| Dogfight
| Interception
|-
| GMINTRO1
| N/A
| Intro (Part I)
|-
| GMINTRO2
| N/A
| Intro (Part II)
|-
| GMINTRO3
| N/A
| Intro (Part III)
|-
| GMLOSE
| N/A
| Lose Game
|-
| GMMARS
| Debriefing
| Debriefing
|-
| GMNEWMAR
| Mission Accomplished
| Mars Briefing
|-
| GMSTORY
| Final Briefing
| The Story
|-
| GMTACTIC
| Battlescape1
| Tactical Battle
|-
| GMTACTIC2*
| Battlescape2
| N/A
|-
| GMWIN
| N/A
| Win Game
|}

''*not available in original''

'''WARNING:''' There are some bugs with the audio playback on MP3, primarily on Unix-like systems. If you start experiencing crashes after using custom music, switch to a different music format.

== Options File ==

OpenXcom stores its options in a ''options.cfg'' YAML file stored in the [[Installing (OpenXcom)#User Folder|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>". These include the options shown in the Options screen as well as other advanced options.

'''WARNING:''' Invalid values can cause incorrect behaviour or game crashes. Options that accept true/false are marked by "When enabled", options that accept a range of numbers have this listed in brackets after their description, and options that accept a numeric flag have bullets to describe the functionality of each option.

{| class="wikitable"
! Option
! Description
! Default
|-

! colspan="3" style="background-color: #CCCCCC" | General

|-
| '''autosave'''
| When enabled, the game is autosaved.
* 0 = disabled.
* 1 = quick save and quick load buttons are enabled.
* 2 = game automatically saves at 00:00 and all save and load buttons are disabled.
* 3 = same as 2, as well as automatically saving on exit of the game.
| 0
|-
| '''captureMouse'''
| When enabled, the mouse cursor is locked to the window.
| false
|-
| '''changeValueByMouseWheel'''
| The amount to increase/decrease a value when scrolling the mouse wheel over increase/decrease buttons in lists.
| 10
|-
| '''debug'''
| When enabled, provides features to make it easier for developers/contributors to debug their work.
| false
|-
| '''debugUi'''
| When enabled, shows text borders in UI elements to make it easier for developers/translators to debug their work.
| false
|-
| '''FPS'''
|
| 15
|-
| '''fpsCounter'''
| When enabled, shows an FPS Counter on the top-left of the screen.
| false
|-
| '''language'''
| Filename of the language loaded at startup.
| en-US
|-
| '''keyboardMode'''
| Keyboard input mode.
* 0 = Keyboard enabled.
* 1 = Keyboard disabled, type in text boxes with the arrow keys (arcade style).
| 0
|-
| '''key*'''
| (...various options starting with this prefix) Stores the keyboard controls.
|
|-
| '''NewBattle_*'''
| (...various options starting with this prefix) Stores the last-used settings in the ''New Battle'' screen.
|
|-
| '''pauseMode'''
| Controls how the game behaves when it loses focus (eg. minimized or alt-tabbed).
* 0,1 = Continue running normally on loss of focus.
* 2 = Slow down the game on loss of focus.
* 3 = Pause completely on loss of focus.
| 0
|-
| '''playIntro'''
| When enabled, plays the intro cinematic on startup.
| true
|-
| '''saveOrder'''
| Controls the order in which saved games are displayed in the save/load game menus.
* 0 Ascending name order, i.e. A to Z.
* 1 Descending name order, i.e. Z to A.
* 2 Ascending date order, i.e. oldest saves first.
* 3 Descending date order, i.e. newest saves first.
| 3
|-

! colspan="3" style="background-color: #CCCCCC" | Display

|-
| '''allowResize'''
| When enabled and the game is in windowed mode, the game resolution can be dynamically resized by changing the window size.
| false
|-
| '''asyncBlit'''
| When enabled, the display surface uses asynchronous updates. This will usually slow down blitting on single CPU machines, but may provide a speed increase on SMP systems.
| true
|-
| '''baseXBattlescape'''
'''baseYBattlescape'''
|
| 320
200
|-
| '''baseXGeoscape'''
'''baseYGeoscape'''
|
| 320
200
|-
| '''baseXResolution'''
'''baseYResolution'''
| The game's base resolution in pixels, you can think of it as the "viewport", so changing this would let you see more of the Geoscape/Battlescape at once.
'''WARNING:''' This feature is experimental and can cause UI and performance problems, as the game is not designed for flexible resolutions.
| 320
200
|-
| '''borderless'''
| When enabled, the game is displayed without a window frame when playing in windowed mode.
| false
|-
| '''displayWidth'''
'''displayHeight'''
| Display resolution in pixels. The game will scale the base resolution to fit this value, so it should be greater than or equal to '''baseXResolution''' x '''baseYResolution.
| 640
400
|-
| '''fullscreen'''
| When enabled, the game will run in fullscreen mode as opposed to windowed mode.
'''NOTE''': The display might become distorted or clipped in fullscreen if your device doesn't support the specified resolution.
| false
|-
| '''maxFrameSkip'''
| Specifies the maximum amount of frames the game can skip rendering.
| 0
|-
| '''windowedModePositionX'''
'''windowedModePositionY'''
| When running in windowed mode, forces the game window to start in the specified position in pixels. Use -1 to have the OS decide the window position.
| -1
-1
|-
| '''useHQXFilter'''
| When enabled, applies a rendering filter that smoothes out diagonal edges, making the game look less pixelated. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions, and '''useOpenGL''' must be disabled.
| false
|-
| '''useScaleFilter'''
| When enabled, passes the game through a software Scale2x filter. This option achieves similar results to '''useHQXFilter''' but with less overhead and slightly less quality. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions, and '''useOpenGL''' must be disabled.
| false
|-
| '''useOpenGL'''
| When enabled, uses OpenGL hardware rendering and enables the following OpenGL options:
| false
|-
| '''checkOpenGLErrors'''
| When enabled, logs all errors returned by OpenGL.
| false
|-
| '''useOpenGLShader'''
| Selects which GLSL rendering filter to apply when the '''useOpenGL''' option is enabled. This option takes a path relative to the OpenXcom Data Folder as an argument. OpenXcom comes packaged with some filters in the ''data\Shaders'' folder which are described earlier in ''Display Filter''.
| Shaders/Openxcom.OpenGL.shader
|-
| '''useOpenGLSmoothing'''
| When enabled, the game will use linear interpolation instead of nearest-neighbour pixel scaling when no shader is specified.
| true
|-
| '''vSyncForOpenGL'''
| When enabled, puts OpenGL into vertical synchronisation mode, ensuring the FPS do not exceed your monitor's refresh rate, preventing tearing and excessive hardware demand, but may cause slower animations.
| true
|-

! colspan="3" style="background-color: #CCCCCC" | Sound

|-
| '''audioBitDepth'''
| Bit depth of the output audio. ''Only change this if you know what you're doing!''
| 16
|-
| '''audioSampleRate'''
| Sample rate (in Hz) of the output audio. ''Only change this if you know what you're doing!''
| 22050
|-
| '''musicVolume'''
| Background music volume (0-128).
| 128
|-
| '''soundVolume'''
| Sound FX volume (0-128).
| 128
|-
| '''mute'''
| When enabled, disables all audio output. Automatically enabled if no audio hardware is detected.
| false
|-

! colspan="3" style="background-color: #CCCCCC" | Geoscape/Basescape

|-
| '''aggressiveRetaliation'''
| When enabled, aliens on any type of mission may detect your base if they are in very close range.
| false
|-
| '''alienContainmentLimitEnforced'''
| When enabled, enforces the limit of live aliens that can be held in each containment facility.
| false
|-
| '''allowAutoSellProduction'''
| When enabled, players can automatically sell manufactured items by right-clicking the Up Arrow on the Quantity in the manufacture screen.
| false
|-
| '''allowBuildingQueue'''
| When enabled, unfinished facilities act as links to the access lift when new facilities are placed, thereby allowing facilities to be "queued" waiting for neighboring facilities to finish.
| false
|-
| '''anytimePsiTraining'''
| When enabled, psi training can be performed at any time, instead of waiting for the end of the month.
| false
|-
| '''canManufactureMoreItemsPerHour'''
| When enabled, allows manufacturing projects to produce more than one item per hour, if the amount of engineers is very large (like in [[TFTD]]).
| false
|-
| '''canSellLiveAliens'''
| When enabled, captured aliens can be sold for cash in the same fashion as alien corpses. Recommended when '''alienContainmentLimitEnforced''' is enabled.
| false
|-
| '''canTransferCraftsWhileAirborne'''
| When enabled, crafts can be transferred between bases while they are OUT (as long as they have enough fuel).
| false
|-
| '''craftLaunchAlways'''
| When enabled, allow crafts to take off without being READY.
| false
|-
| '''customInitialBase'''
| When enabled, allows the player to customize the facility placement of the starting base.
|-
| '''dogfightSpeed'''
|
| 20
|-
| '''geoClockSpeed'''
|
| 80
|-
| '''globeAllRadarsOnBaseBuild'''
| When enabled, all radar ranges will be shown when hovering a valid base location while building a new base.
| true
|-
| '''globeDetail'''
| When enabled, country and city details are shown when zoomed in on the globe.
| true
|-
| '''globeFlightPaths
| When enabled, shows craft flight paths on the globe.
| true
|-
| '''globeRadarLines
| When enabled, the radar ranges of player bases on the globe are shown.
| true
|-
| '''globeScrollDragButton'''
| Scrolls the map when the specified mouse button is held down and dragged.
* 0 None.
* 1 Left mouse button.
* 2 Middle mouse button.
* 3 Right mouse button.
| 2
|-
| '''globeScrollSpeed
| The scrolling speed of the globe.
| 20
|-
| '''globeSeasons'''
| When enabled, the day/night cycle takes into account the Earth's [[:Wikipedia:Axial tilt|axial tilt]] for a more realistic projection of the light.
| false
|-
| '''psiStrengthEval'''
| When enabled, evaluates the psionic strength of all soldiers after the appropriate research has been completed.
| false
|-
| '''spendResearchedItems'''
| When enabled, researching an item spends it.
| false
|-
| '''showFundsOnGeoscape'''
| When enabled, shows your available funds above the time/date on the Geoscape sidebar.
| false
|-

! colspan="3" style="background-color: #CCCCCC" | Battlescape

|-
| '''allowPsionicCapture'''
| When enabled, mind-controlling all the remaining enemy units results in a victory, and they count as live captures.
| false
|-
| '''battleAlienSpeed'''
| Animation speed of alien / civilian units moving on the map.
| 30
|-
| '''battleAutoEnd'''
| When enabled, the turn is automatically ended when all friendly/enemy units are neutralized, therefore ending the mission.
| false
|-
| '''battleConfirmFireMode'''
| When enabled, a second click is required on the same tile to confirm fire orders.
| false
|-
| '''battleEdgeScroll'''
| Sets how to scroll the map.
* 0 None.
* 1 Trigger - scroll map when the left mouse button is held down on a screen edge.
* 2 Auto - scroll map when the cursor is over a screen edge.
| 2
|-
| '''battleExplosionHeight'''
| A coefficient that controls how much vertical power explosions have.
* 0 = Explosions are completely flat, as per the original game.
* 1 = -30 damage units per level (this penalty is in addition to the horizontal penalty of -10 damage per tile).
* 2 = -10 damage units per level.
* 3 = -5 damage units per level.
| 0
|-
| '''battleFireSpeed'''
| Animation speed of bullets after being fired in pixels per frame. Game setting * 2.
| 6
|-
| '''battleHairBleach'''
|
| true
|-
| '''battleInstantGrenade'''
| When enabled, grenades are "hot". This means that when primed to 0 turns, they simply explode on impact, instead of waiting for the end of the turn.
| false
|-
| '''battleNotifyDeath'''
| When enabled, displays a text notification when a soldier dies.
| false
|-
| '''battleNewPreviewPath'''
| When enabled, your first left-click displays the path the selected unit will take, and your second click confirms the move order.
* 0 No preview.
* 1 Display path taken with colored arrows: green - can move and fire; yellow - can move; red - cannot move.
* 2 Display the time units you will have remaining after moving to the destination.
* 3 Display colored arrows and time units remaining.
| 0
|-
| '''battleSmoothCamera'''
| When enabled, the battlescape camera will remain centered on projectiles while in flight.
| false
|-
| '''battleUFOExtenderAccuracy'''
| When enabled, mimics [[UFOextender#Range_Based_Accuracy |UFO Extender's Range based accuracy]], except using stats taken from the weapon itself rather than global config options.
| false
|-
| '''battleScrollSpeed'''
| Map scrolling speed.
| 8
|-
| '''battleScrollType'''
| Map scrolling mode.
* 0 = Trigger Scroll: Hold down the LMB over the edges of the screen to scroll.
* 1 = Auto Scroll: Hover your mouse over the edges of the screen to scroll.
* 2 = Drag Scroll: Hold down MMB and drag to scroll. Recommended for playing windowed.
| 1
|-
| '''battleScrollDragButtion'''
| Controls which mouse button is held down in Drag Scrolling
* 1 = Left Mouse Button.
* 2 = Middle Mouse Button.
* 3 = Right Mouse Button.
* 6... = Other Mouse Buttons.
| 2
|-
| '''battleScrollDragInvert'''
| When enabled, Drag Scrolling moves the camera away from your mouse, rather than moving towards it.
| false
|-
| '''battleScrollDragTimeTolerance'''
| Amount of miliseconds the mouse needs to be pressed to trigger a Drag Scroll.
| 300
|-
| '''battleScrollDragPixelTolerance'''
| Amount of pixels the mouse needs to be moved after pressing to trigger a Drag Scroll.
| 10
|-
| '''battleTooltips'''
| When enabled, hovering the Battlescape buttons displays a tooltip.
| true
|-
| '''battleXcomSpeed'''
| Animation speed of X-COM units moving on the map.
| 30
|-
| '''disableAutoEquip'''
| When enabled, disables auto-equipping of new soldiers before battle.
| false
|-
| '''skipNextTurnScreen'''
| When enabled, the "Next Turn" screens during battle are advanced automatically after a short delay.
| false
|-
| '''showMoreStatsInInventoryView'''
| When enabled, the inventory screen displays extra stats in the top-right corner, such as the weight of equipment the soldier is currently wearing/carrying and their maximum weight before TU reduction sets in, their firing accuracy, reactions and psi stats.
| false
|-
| '''sneakyAI'''
| When enabled, AI avoids exposing themselves to player whenever possible.
| false
|-
| '''strafe'''
| When enabled, holding CTRL allows soldiers to strafe and run, and allows tanks to rotate their turret independently of the chassis.
| false
|-
| '''TFTDDamage'''
| When enabled, weapons will do between 50% and 150% of their rated damage as opposed to UFO:Enemy Unknown's 0% to 200%.
| false
|-
| '''traceAI'''
| Debug feature. When enabled, highlights the paths that enemy units took after their turn.
| false
|-
| '''weaponSelfDestruction'''
| When enabled, weapons dropped by aliens are destroyed unless they are captured alive (similar to the [[Enemy Unknown (EU2012)|new X-COM]]).
| false
|-
|}

== Debug mode ==

''Debug mode'' is a special feature that makes it easier for developers/contributors to test out game features without needing to play a new game from scratch. After setting "debug: true" in the ''options.cfg'' file (see above), you can enable it by pressing ''Ctrl-D'' in-game to access a variety of features:

'''Geoscape''': All research is unlocked, allowing you to easily test all features in the Geoscape without needing to manually unlock them yourself. This doesn't affect your saved game. Regional and Country borders will be displayed.

'''Battlescape''': Whole map is revealed and opening the inventory screen resets TUs, allowing you to easily test out the map and any Battlescape features without being affected by game restrictions.

[[Category:OpenXcom]]

Options (OpenXcom)

2014-04-08T15:59:11Z

Cfailde: /* Options File */ Updating battleNewPreviewPath and adding saveOrder

[[Image:OpenXcomOptions.png|right|thumb|OpenXcom Options screen]]

OpenXcom has a variety of game settings that can be customized through the Options screen in the Main Menu. These options are global and affect any old or new savegame, and take effect instantly after pressing OK.

* '''Display Resolution:''' Resolution the game is rendered at. Note that the game always renders at 320x200 (original DOS resolution) and resizes to whatever you specify, so for a better picture use a resolution with the same ratio. 640x400 or 640x480 (if you like non-square pixels) are recommended. Use the arrows to scroll through the resolutions supported by your monitor, or click on the numbers to type in your own resolution. If you screw it up, use ''Restore Defaults'' or delete your ''options.cfg'' file (see below) to reset your settings.
* '''Display Mode:''' Display the game in a window or covering the whole screen. Windowed mode is recommended as monitors usually don't properly support OpenXcom's lo-fi nature in fullscreen.
* '''Music Volume:''' The volume of the background music (0 is mute, 1 is lowest, 4 is highest).
* '''SFX Volume:''' The volume of the sound effects (0 is mute, 1 is lowest, 4 is highest).
* '''Language:''' Change the language used to display all the game text.

== Display Filter ==

By default OpenXcom just resizes the screen to fit the resolution, maintaining pixel accuracy as in the original game, but a variety of [[:Wikipedia:Image scaling|image scaling]] filters can be applied to change the image quality or apply smoothing and emulation effects:
* '''Scale''': Smooths out edges, making the game look less pixelated. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions.
* '''HQX''': Similar to '''Scale''', but more accurate and high-quality. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions.
* '''CRT (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''CRT-interlaced (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''CRT-simple (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''Curvature (OpenGL)''': Simulates a rounded display.
* '''dot_n_bloom (OpenGL)''' Applies both a dot grid effect and a bloom effect.
* '''heavybloom (OpenGL)''': Applies a very heavy bloom effect.
* '''HQ2X (OpenGL)''': A double-scale version of '''HQX''', which smoothes pixel edges, but not quite to the extreme of '''HQX'''.
* '''Openxcom (OpenGL)''': Smooths rough edges while maintaining a semi-pixellated feel similar to the original X-Com. (default)
* '''Phosphor-simple (OpenGL)''' Applies a dot grid effect.
* '''Pixellate (OpenGL)''': Default pixel-accurate behaviour, but using OpenGL.
* '''SABR (OpenGL)''': Applies texel-based smoothing to the display.
* '''Scale4xHQ (OpenGL)''': A quadruple-scale version of '''HQX''', which results in a more subtle smoothing of pixel edges.
* '''simplebloom (OpenGL)''': Applies a bloom effect.

== Controls ==

In the ''Controls'' screen you can customize keyboard shortcuts for a variety of functions normally only accessible with the mouse. To change a control, left-click on it and press the new key. To erase a control, right-click it.

Besides the controls listed on the screen, there are also these hardcoded shortcuts:

*'''ALT-ENTER''' – Toggles between windowed and fullscreen mode.
*'''Right-Click''' - Automatically set the min/max on an increase/decrease arrow button.
*'''Scroll Wheel''' - Scroll lists / Zoom globe / Change Battlescape view level.
*'''Back/Forward Buttons''' - (if available) Switch between soldiers on the Battlescape.

== Advanced Options ==

By default OpenXcom is set up for vanilla behavior, but provides a variety of options that allow players to change gameplay features. In the ''Advanced Options'' screen you can customize the most-popular options to your preference, and further options can be found in the Options File described below.

== Custom Music ==

If you don't like or have trouble getting the original X-COM music to work, you can use your own. The game will look for the original gm.cat, delete (or rename to restore it later in case you change your mind) it before using custom music. The formats supported are MIDI, MP3, OGG, MOD and FLAC. Just put it in the [[SOUND]] subfolder of the [[Installing (OpenXcom)#Data Folder|Data folder]] with the same filenames as the original:

{| class="wikitable"
! Original
! PlayStation
! Cydonia's Fall
|-
| GMDEFEND
| Briefing1
| Defend Base
|-
| GMENBASE
| Briefing2
| N/A
|-
| GMGEO1
| Geoscape1
| Geoscape (Part I)
|-
| GMGEO2
| Geoscape2
| Geoscape (Part II)
|-
| GMGEO3*
| Geoscape3
| N/A
|-
| GMGEO4*
| Geoscape4
| N/A
|-
| GMINTER
| Dogfight
| Interception
|-
| GMINTRO1
| N/A
| Intro (Part I)
|-
| GMINTRO2
| N/A
| Intro (Part II)
|-
| GMINTRO3
| N/A
| Intro (Part III)
|-
| GMLOSE
| N/A
| Lose Game
|-
| GMMARS
| Debriefing
| Debriefing
|-
| GMNEWMAR
| Mission Accomplished
| Mars Briefing
|-
| GMSTORY
| Final Briefing
| The Story
|-
| GMTACTIC
| Battlescape1
| Tactical Battle
|-
| GMTACTIC2*
| Battlescape2
| N/A
|-
| GMWIN
| N/A
| Win Game
|}

''*not available in original''

'''WARNING:''' There are some bugs with the audio playback on MP3, primarily on Unix-like systems. If you start experiencing crashes after using custom music, switch to a different music format.

== Options File ==

OpenXcom stores its options in a ''options.cfg'' YAML file stored in the [[Installing (OpenXcom)#User Folder|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>". These include the options shown in the Options screen as well as other advanced options.

'''WARNING:''' Invalid values can cause incorrect behaviour or game crashes. Options that accept true/false are marked by "When enabled", options that accept a range of numbers have this listed in brackets after their description, and options that accept a numeric flag have bullets to describe the functionality of each option.

{| class="wikitable"
! Option
! Description
! Default
|-

! colspan="3" style="background-color: #CCCCCC" | General

|-
| '''autosave'''
| When enabled, the game is autosaved.
* 0 = disabled.
* 1 = quick save and quick load buttons are enabled.
* 2 = game automatically saves at 00:00 and all save and load buttons are disabled.
* 3 = same as 2, as well as automatically saving on exit of the game.
| 0
|-
| '''captureMouse'''
| When enabled, the mouse cursor is locked to the window.
| false
|-
| '''changeValueByMouseWheel'''
| The amount to increase/decrease a value when scrolling the mouse wheel over increase/decrease buttons in lists.
| 10
|-
| '''debug'''
| When enabled, provides features to make it easier for developers/contributors to debug their work.
| false
|-
| '''debugUi'''
| When enabled, shows text borders in UI elements to make it easier for developers/translators to debug their work.
| false
|-
| '''FPS'''
|
| 15
|-
| '''fpsCounter'''
| When enabled, shows an FPS Counter on the top-left of the screen.
| false
|-
| '''language'''
| Filename of the language loaded at startup.
| en-US
|-
| '''keyboardMode'''
| Keyboard input mode.
* 0 = Keyboard enabled.
* 1 = Keyboard disabled, type in text boxes with the arrow keys (arcade style).
| 0
|-
| '''key*'''
| (...various options starting with this prefix) Stores the keyboard controls.
|
|-
| '''NewBattle_*'''
| (...various options starting with this prefix) Stores the last-used settings in the ''New Battle'' screen.
|
|-
| '''pauseMode'''
| Controls how the game behaves when it loses focus (eg. minimized or alt-tabbed).
* 0,1 = Continue running normally on loss of focus.
* 2 = Slow down the game on loss of focus.
* 3 = Pause completely on loss of focus.
| 0
|-
| '''playIntro'''
| When enabled, plays the intro cinematic on startup.
| true
|-
| '''saveOrder'''
| Controls the order in which saved games are displayed in the save/load game menus.
* 0 Ascending name order, i.e. A to Z.
* 1 Descending name order, i.e. Z to A.
* 2 Ascending date order, i.e. oldest saves first.
* 3 Descending date order, i.e. newest saves first.
| 3
|-

! colspan="3" style="background-color: #CCCCCC" | Display

|-
| '''allowResize'''
| When enabled and the game is in windowed mode, the game resolution can be dynamically resized by changing the window size.
| false
|-
| '''asyncBlit'''
| When enabled, the display surface uses asynchronous updates. This will usually slow down blitting on single CPU machines, but may provide a speed increase on SMP systems.
| true
|-
| '''baseXBattlescape'''
'''baseYBattlescape'''
|
| 320
200
|-
| '''baseXGeoscape'''
'''baseYGeoscape'''
|
| 320
200
|-
| '''baseXResolution'''
'''baseYResolution'''
| The game's base resolution in pixels, you can think of it as the "viewport", so changing this would let you see more of the Geoscape/Battlescape at once.
'''WARNING:''' This feature is experimental and can cause UI and performance problems, as the game is not designed for flexible resolutions.
| 320
200
|-
| '''borderless'''
| When enabled, the game is displayed without a window frame when playing in windowed mode.
| false
|-
| '''displayWidth'''
'''displayHeight'''
| Display resolution in pixels. The game will scale the base resolution to fit this value, so it should be greater than or equal to '''baseXResolution''' x '''baseYResolution.
| 640
400
|-
| '''fullscreen'''
| When enabled, the game will run in fullscreen mode as opposed to windowed mode.
'''NOTE''': The display might become distorted or clipped in fullscreen if your device doesn't support the specified resolution.
| false
|-
| '''maxFrameSkip'''
| Specifies the maximum amount of frames the game can skip rendering.
| 0
|-
| '''windowedModePositionX'''
'''windowedModePositionY'''
| When running in windowed mode, forces the game window to start in the specified position in pixels. Use -1 to have the OS decide the window position.
| -1
-1
|-
| '''useHQXFilter'''
| When enabled, applies a rendering filter that smoothes out diagonal edges, making the game look less pixelated. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions, and '''useOpenGL''' must be disabled.
| false
|-
| '''useScaleFilter'''
| When enabled, passes the game through a software Scale2x filter. This option achieves similar results to '''useHQXFilter''' but with less overhead and slightly less quality. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions, and '''useOpenGL''' must be disabled.
| false
|-
| '''useOpenGL'''
| When enabled, uses OpenGL hardware rendering and enables the following OpenGL options:
| false
|-
| '''checkOpenGLErrors'''
| When enabled, logs all errors returned by OpenGL.
| false
|-
| '''useOpenGLShader'''
| Selects which GLSL rendering filter to apply when the '''useOpenGL''' option is enabled. This option takes a path relative to the OpenXcom Data Folder as an argument. OpenXcom comes packaged with some filters in the ''data\Shaders'' folder which are described earlier in ''Display Filter''.
| Shaders/Openxcom.OpenGL.shader
|-
| '''useOpenGLSmoothing'''
| When enabled, the game will use linear interpolation instead of nearest-neighbour pixel scaling when no shader is specified.
| true
|-
| '''vSyncForOpenGL'''
| When enabled, puts OpenGL into vertical synchronisation mode, ensuring the FPS do not exceed your monitor's refresh rate, preventing tearing and excessive hardware demand, but may cause slower animations.
| true
|-

! colspan="3" style="background-color: #CCCCCC" | Sound

|-
| '''audioBitDepth'''
| Bit depth of the output audio. ''Only change this if you know what you're doing!''
| 16
|-
| '''audioSampleRate'''
| Sample rate (in Hz) of the output audio. ''Only change this if you know what you're doing!''
| 22050
|-
| '''musicVolume'''
| Background music volume (0-128).
| 128
|-
| '''soundVolume'''
| Sound FX volume (0-128).
| 128
|-
| '''mute'''
| When enabled, disables all audio output. Automatically enabled if no audio hardware is detected.
| false
|-

! colspan="3" style="background-color: #CCCCCC" | Geoscape/Basescape

|-
| '''aggressiveRetaliation'''
| When enabled, aliens on any type of mission may detect your base if they are in very close range.
| false
|-
| '''alienContainmentLimitEnforced'''
| When enabled, enforces the limit of live aliens that can be held in each containment facility.
| false
|-
| '''allowAutoSellProduction'''
| When enabled, players can automatically sell manufactured items by right-clicking the Up Arrow on the Quantity in the manufacture screen.
| false
|-
| '''allowBuildingQueue'''
| When enabled, unfinished facilities act as links to the access lift when new facilities are placed, thereby allowing facilities to be "queued" waiting for neighboring facilities to finish.
| false
|-
| '''anytimePsiTraining'''
| When enabled, psi training can be performed at any time, instead of waiting for the end of the month.
| false
|-
| '''canManufactureMoreItemsPerHour'''
| When enabled, allows manufacturing projects to produce more than one item per hour, if the amount of engineers is very large (like in [[TFTD]]).
| false
|-
| '''canSellLiveAliens'''
| When enabled, captured aliens can be sold for cash in the same fashion as alien corpses. Recommended when '''alienContainmentLimitEnforced''' is enabled.
| false
|-
| '''canTransferCraftsWhileAirborne'''
| When enabled, crafts can be transferred between bases while they are OUT (as long as they have enough fuel).
| false
|-
| '''craftLaunchAlways'''
| When enabled, allow crafts to take off without being READY.
| false
|-
| '''customInitialBase'''
| When enabled, allows the player to customize the facility placement of the starting base.
|-
| '''dogfightSpeed'''
|
| 20
|-
| '''geoClockSpeed'''
|
| 80
|-
| '''globeAllRadarsOnBaseBuild'''
| When enabled, all radar ranges will be shown when hovering a valid base location while building a new base.
| true
|-
| '''globeDetail'''
| When enabled, country and city details are shown when zoomed in on the globe.
| true
|-
| '''globeFlightPaths
| When enabled, shows craft flight paths on the globe.
| true
|-
| '''globeRadarLines
| When enabled, the radar ranges of player bases on the globe are shown.
| true
|-
| '''globeScrollDragButton'''
| Scrolls the map when the specified mouse button is held down and dragged.
* 0 None.
* 1 Left mouse button.
* 2 Middle mouse button.
* 3 Right mouse button.
| 2
|-
| '''globeScrollSpeed
| The scrolling speed of the globe.
| 20
|-
| '''globeSeasons'''
| When enabled, the day/night cycle takes into account the Earth's [[:Wikipedia:Axial tilt|axial tilt]] for a more realistic projection of the light.
| false
|-
| '''psiStrengthEval'''
| When enabled, evaluates the psionic strength of all soldiers after the appropriate research has been completed.
| false
|-
| '''spendResearchedItems'''
| When enabled, researching an item spends it.
| false
|-
| '''showFundsOnGeoscape'''
| When enabled, shows your available funds above the time/date on the Geoscape sidebar.
| false
|-

! colspan="3" style="background-color: #CCCCCC" | Battlescape

|-
| '''allowPsionicCapture'''
| When enabled, mind-controlling all the remaining enemy units results in a victory, and they count as live captures.
| false
|-
| '''battleAlienSpeed'''
| Animation speed of alien / civilian units moving on the map.
| 30
|-
| '''battleAutoEnd'''
| When enabled, the turn is automatically ended when all friendly/enemy units are neutralized, therefore ending the mission.
| false
|-
| '''battleConfirmFireMode'''
| When enabled, a second click is required on the same tile to confirm fire orders.
| false
|-
| '''battleEdgeScroll'''
| Sets how to scroll the map.
* 0 None.
* 1 Trigger - scroll map when the left mouse button is held down on a screen edge.
* 2 Auto - scroll map when the cursor is over a screen edge.
| 2
|-
| '''battleExplosionHeight'''
| A coefficient that controls how much vertical power explosions have.
* 0 = Explosions are completely flat, as per the original game.
* 1 = -30 damage units per level (this penalty is in addition to the horizontal penalty of -10 damage per tile).
* 2 = -10 damage units per level.
* 3 = -5 damage units per level.
| 0
|-
| '''battleFireSpeed'''
| Animation speed of bullets after being fired in pixels per frame. Game setting * 2.
| 6
|-
| '''battleHairBleach'''
|
| true
|-
| '''battleInstantGrenade'''
| When enabled, grenades are "hot". This means that when primed to 0 turns, they simply explode on impact, instead of waiting for the end of the turn.
| false
|-
| '''battleNotifyDeath'''
| When enabled, displays a text notification when a soldier dies.
| false
|-
| '''battleNewPreviewPath'''
| When enabled, your first left-click displays the path the selected unit will take, and your second click confirms the move order. The amount the unit can move this turn (according to TUs) is highlighted in green, and the rest is highlighted in red.
* 0 No preview.
* 1 Display path taken with colored arrows.
* 2 Display the time units you will have remaining after moving to the destination.
* 3 Display arrows and time units remaining.
| 0
|-
| '''battleSmoothCamera'''
| When enabled, the battlescape camera will remain centered on projectiles while in flight.
| false
|-
| '''battleUFOExtenderAccuracy'''
| When enabled, mimics [[UFOextender#Range_Based_Accuracy |UFO Extender's Range based accuracy]], except using stats taken from the weapon itself rather than global config options.
| false
|-
| '''battleScrollSpeed'''
| Map scrolling speed.
| 8
|-
| '''battleScrollType'''
| Map scrolling mode.
* 0 = Trigger Scroll: Hold down the LMB over the edges of the screen to scroll.
* 1 = Auto Scroll: Hover your mouse over the edges of the screen to scroll.
* 2 = Drag Scroll: Hold down MMB and drag to scroll. Recommended for playing windowed.
| 1
|-
| '''battleScrollDragButtion'''
| Controls which mouse button is held down in Drag Scrolling
* 1 = Left Mouse Button.
* 2 = Middle Mouse Button.
* 3 = Right Mouse Button.
* 6... = Other Mouse Buttons.
| 2
|-
| '''battleScrollDragInvert'''
| When enabled, Drag Scrolling moves the camera away from your mouse, rather than moving towards it.
| false
|-
| '''battleScrollDragTimeTolerance'''
| Amount of miliseconds the mouse needs to be pressed to trigger a Drag Scroll.
| 300
|-
| '''battleScrollDragPixelTolerance'''
| Amount of pixels the mouse needs to be moved after pressing to trigger a Drag Scroll.
| 10
|-
| '''battleTooltips'''
| When enabled, hovering the Battlescape buttons displays a tooltip.
| true
|-
| '''battleXcomSpeed'''
| Animation speed of X-COM units moving on the map.
| 30
|-
| '''disableAutoEquip'''
| When enabled, disables auto-equipping of new soldiers before battle.
| false
|-
| '''skipNextTurnScreen'''
| When enabled, the "Next Turn" screens during battle are advanced automatically after a short delay.
| false
|-
| '''showMoreStatsInInventoryView'''
| When enabled, the inventory screen displays extra stats in the top-right corner, such as the weight of equipment the soldier is currently wearing/carrying and their maximum weight before TU reduction sets in, their firing accuracy, reactions and psi stats.
| false
|-
| '''sneakyAI'''
| When enabled, AI avoids exposing themselves to player whenever possible.
| false
|-
| '''strafe'''
| When enabled, holding CTRL allows soldiers to strafe and run, and allows tanks to rotate their turret independently of the chassis.
| false
|-
| '''TFTDDamage'''
| When enabled, weapons will do between 50% and 150% of their rated damage as opposed to UFO:Enemy Unknown's 0% to 200%.
| false
|-
| '''traceAI'''
| Debug feature. When enabled, highlights the paths that enemy units took after their turn.
| false
|-
| '''weaponSelfDestruction'''
| When enabled, weapons dropped by aliens are destroyed unless they are captured alive (similar to the [[Enemy Unknown (EU2012)|new X-COM]]).
| false
|-
|}

== Debug mode ==

''Debug mode'' is a special feature that makes it easier for developers/contributors to test out game features without needing to play a new game from scratch. After setting "debug: true" in the ''options.cfg'' file (see above), you can enable it by pressing ''Ctrl-D'' in-game to access a variety of features:

'''Geoscape''': All research is unlocked, allowing you to easily test all features in the Geoscape without needing to manually unlock them yourself. This doesn't affect your saved game. Regional and Country borders will be displayed.

'''Battlescape''': Whole map is revealed and opening the inventory screen resets TUs, allowing you to easily test out the map and any Battlescape features without being affected by game restrictions.

[[Category:OpenXcom]]

Options (OpenXcom)

2014-04-08T13:30:19Z

Cfailde: /* Options File */ Added missing options and updated existing ones.

[[Image:OpenXcomOptions.png|right|thumb|OpenXcom Options screen]]

OpenXcom has a variety of game settings that can be customized through the Options screen in the Main Menu. These options are global and affect any old or new savegame, and take effect instantly after pressing OK.

* '''Display Resolution:''' Resolution the game is rendered at. Note that the game always renders at 320x200 (original DOS resolution) and resizes to whatever you specify, so for a better picture use a resolution with the same ratio. 640x400 or 640x480 (if you like non-square pixels) are recommended. Use the arrows to scroll through the resolutions supported by your monitor, or click on the numbers to type in your own resolution. If you screw it up, use ''Restore Defaults'' or delete your ''options.cfg'' file (see below) to reset your settings.
* '''Display Mode:''' Display the game in a window or covering the whole screen. Windowed mode is recommended as monitors usually don't properly support OpenXcom's lo-fi nature in fullscreen.
* '''Music Volume:''' The volume of the background music (0 is mute, 1 is lowest, 4 is highest).
* '''SFX Volume:''' The volume of the sound effects (0 is mute, 1 is lowest, 4 is highest).
* '''Language:''' Change the language used to display all the game text.

== Display Filter ==

By default OpenXcom just resizes the screen to fit the resolution, maintaining pixel accuracy as in the original game, but a variety of [[:Wikipedia:Image scaling|image scaling]] filters can be applied to change the image quality or apply smoothing and emulation effects:
* '''Scale''': Smooths out edges, making the game look less pixelated. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions.
* '''HQX''': Similar to '''Scale''', but more accurate and high-quality. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions.
* '''CRT (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''CRT-interlaced (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''CRT-simple (OpenGL)''': Mimics a CRT monitor by adding interlaced lines and simulating a rounded display.
* '''Curvature (OpenGL)''': Simulates a rounded display.
* '''dot_n_bloom (OpenGL)''' Applies both a dot grid effect and a bloom effect.
* '''heavybloom (OpenGL)''': Applies a very heavy bloom effect.
* '''HQ2X (OpenGL)''': A double-scale version of '''HQX''', which smoothes pixel edges, but not quite to the extreme of '''HQX'''.
* '''Openxcom (OpenGL)''': Smooths rough edges while maintaining a semi-pixellated feel similar to the original X-Com. (default)
* '''Phosphor-simple (OpenGL)''' Applies a dot grid effect.
* '''Pixellate (OpenGL)''': Default pixel-accurate behaviour, but using OpenGL.
* '''SABR (OpenGL)''': Applies texel-based smoothing to the display.
* '''Scale4xHQ (OpenGL)''': A quadruple-scale version of '''HQX''', which results in a more subtle smoothing of pixel edges.
* '''simplebloom (OpenGL)''': Applies a bloom effect.

== Controls ==

In the ''Controls'' screen you can customize keyboard shortcuts for a variety of functions normally only accessible with the mouse. To change a control, left-click on it and press the new key. To erase a control, right-click it.

Besides the controls listed on the screen, there are also these hardcoded shortcuts:

*'''ALT-ENTER''' – Toggles between windowed and fullscreen mode.
*'''Right-Click''' - Automatically set the min/max on an increase/decrease arrow button.
*'''Scroll Wheel''' - Scroll lists / Zoom globe / Change Battlescape view level.
*'''Back/Forward Buttons''' - (if available) Switch between soldiers on the Battlescape.

== Advanced Options ==

By default OpenXcom is set up for vanilla behavior, but provides a variety of options that allow players to change gameplay features. In the ''Advanced Options'' screen you can customize the most-popular options to your preference, and further options can be found in the Options File described below.

== Custom Music ==

If you don't like or have trouble getting the original X-COM music to work, you can use your own. The game will look for the original gm.cat, delete (or rename to restore it later in case you change your mind) it before using custom music. The formats supported are MIDI, MP3, OGG, MOD and FLAC. Just put it in the [[SOUND]] subfolder of the [[Installing (OpenXcom)#Data Folder|Data folder]] with the same filenames as the original:

{| class="wikitable"
! Original
! PlayStation
! Cydonia's Fall
|-
| GMDEFEND
| Briefing1
| Defend Base
|-
| GMENBASE
| Briefing2
| N/A
|-
| GMGEO1
| Geoscape1
| Geoscape (Part I)
|-
| GMGEO2
| Geoscape2
| Geoscape (Part II)
|-
| GMGEO3*
| Geoscape3
| N/A
|-
| GMGEO4*
| Geoscape4
| N/A
|-
| GMINTER
| Dogfight
| Interception
|-
| GMINTRO1
| N/A
| Intro (Part I)
|-
| GMINTRO2
| N/A
| Intro (Part II)
|-
| GMINTRO3
| N/A
| Intro (Part III)
|-
| GMLOSE
| N/A
| Lose Game
|-
| GMMARS
| Debriefing
| Debriefing
|-
| GMNEWMAR
| Mission Accomplished
| Mars Briefing
|-
| GMSTORY
| Final Briefing
| The Story
|-
| GMTACTIC
| Battlescape1
| Tactical Battle
|-
| GMTACTIC2*
| Battlescape2
| N/A
|-
| GMWIN
| N/A
| Win Game
|}

''*not available in original''

'''WARNING:''' There are some bugs with the audio playback on MP3, primarily on Unix-like systems. If you start experiencing crashes after using custom music, switch to a different music format.

== Options File ==

OpenXcom stores its options in a ''options.cfg'' YAML file stored in the [[Installing (OpenXcom)#User Folder|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>". These include the options shown in the Options screen as well as other advanced options.

'''WARNING:''' Invalid values can cause incorrect behaviour or game crashes. Options that accept true/false are marked by "When enabled", options that accept a range of numbers have this listed in brackets after their description, and options that accept a numeric flag have bullets to describe the functionality of each option.

{| class="wikitable"
! Option
! Description
! Default
|-

! colspan="3" style="background-color: #CCCCCC" | General

|-
| '''autosave'''
| When enabled, the game is autosaved.
* 0 = disabled.
* 1 = quick save and quick load buttons are enabled.
* 2 = game automatically saves at 00:00 and all save and load buttons are disabled.
* 3 = same as 2, as well as automatically saving on exit of the game.
| 0
|-
| '''captureMouse'''
| When enabled, the mouse cursor is locked to the window.
| false
|-
| '''changeValueByMouseWheel'''
| The amount to increase/decrease a value when scrolling the mouse wheel over increase/decrease buttons in lists.
| 10
|-
| '''debug'''
| When enabled, provides features to make it easier for developers/contributors to debug their work.
| false
|-
| '''debugUi'''
| When enabled, shows text borders in UI elements to make it easier for developers/translators to debug their work.
| false
|-
| '''FPS'''
|
| 15
|-
| '''fpsCounter'''
| When enabled, shows an FPS Counter on the top-left of the screen.
| false
|-
| '''language'''
| Filename of the language loaded at startup.
| en-US
|-
| '''keyboardMode'''
| Keyboard input mode.
* 0 = Keyboard enabled.
* 1 = Keyboard disabled, type in text boxes with the arrow keys (arcade style).
| 0
|-
| '''key*'''
| (...various options starting with this prefix) Stores the keyboard controls.
|
|-
| '''NewBattle_*'''
| (...various options starting with this prefix) Stores the last-used settings in the ''New Battle'' screen.
|
|-
| '''pauseMode'''
| Controls how the game behaves when it loses focus (eg. minimized or alt-tabbed).
* 0,1 = Continue running normally on loss of focus.
* 2 = Slow down the game on loss of focus.
* 3 = Pause completely on loss of focus.
| 0
|-
| '''playIntro'''
| When enabled, plays the intro cinematic on startup.
| true
|-

! colspan="3" style="background-color: #CCCCCC" | Display

|-
| '''allowResize'''
| When enabled and the game is in windowed mode, the game resolution can be dynamically resized by changing the window size.
| false
|-
| '''asyncBlit'''
| When enabled, the display surface uses asynchronous updates. This will usually slow down blitting on single CPU machines, but may provide a speed increase on SMP systems.
| true
|-
| '''baseXBattlescape'''
'''baseYBattlescape'''
|
| 320
200
|-
| '''baseXGeoscape'''
'''baseYGeoscape'''
|
| 320
200
|-
| '''baseXResolution'''
'''baseYResolution'''
| The game's base resolution in pixels, you can think of it as the "viewport", so changing this would let you see more of the Geoscape/Battlescape at once.
'''WARNING:''' This feature is experimental and can cause UI and performance problems, as the game is not designed for flexible resolutions.
| 320
200
|-
| '''borderless'''
| When enabled, the game is displayed without a window frame when playing in windowed mode.
| false
|-
| '''displayWidth'''
'''displayHeight'''
| Display resolution in pixels. The game will scale the base resolution to fit this value, so it should be greater than or equal to '''baseXResolution''' x '''baseYResolution.
| 640
400
|-
| '''fullscreen'''
| When enabled, the game will run in fullscreen mode as opposed to windowed mode.
'''NOTE''': The display might become distorted or clipped in fullscreen if your device doesn't support the specified resolution.
| false
|-
| '''maxFrameSkip'''
| Specifies the maximum amount of frames the game can skip rendering.
| 0
|-
| '''windowedModePositionX'''
'''windowedModePositionY'''
| When running in windowed mode, forces the game window to start in the specified position in pixels. Use -1 to have the OS decide the window position.
| -1
-1
|-
| '''useHQXFilter'''
| When enabled, applies a rendering filter that smoothes out diagonal edges, making the game look less pixelated. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions, and '''useOpenGL''' must be disabled.
| false
|-
| '''useScaleFilter'''
| When enabled, passes the game through a software Scale2x filter. This option achieves similar results to '''useHQXFilter''' but with less overhead and slightly less quality. This setting is only compatible with 320x200, 640x400 and 960x600 resolutions, and '''useOpenGL''' must be disabled.
| false
|-
| '''useOpenGL'''
| When enabled, uses OpenGL hardware rendering and enables the following OpenGL options:
| false
|-
| '''checkOpenGLErrors'''
| When enabled, logs all errors returned by OpenGL.
| false
|-
| '''useOpenGLShader'''
| Selects which GLSL rendering filter to apply when the '''useOpenGL''' option is enabled. This option takes a path relative to the OpenXcom Data Folder as an argument. OpenXcom comes packaged with some filters in the ''data\Shaders'' folder which are described earlier in ''Display Filter''.
| Shaders/Openxcom.OpenGL.shader
|-
| '''useOpenGLSmoothing'''
| When enabled, the game will use linear interpolation instead of nearest-neighbour pixel scaling when no shader is specified.
| true
|-
| '''vSyncForOpenGL'''
| When enabled, puts OpenGL into vertical synchronisation mode, ensuring the FPS do not exceed your monitor's refresh rate, preventing tearing and excessive hardware demand, but may cause slower animations.
| true
|-

! colspan="3" style="background-color: #CCCCCC" | Sound

|-
| '''audioBitDepth'''
| Bit depth of the output audio. ''Only change this if you know what you're doing!''
| 16
|-
| '''audioSampleRate'''
| Sample rate (in Hz) of the output audio. ''Only change this if you know what you're doing!''
| 22050
|-
| '''musicVolume'''
| Background music volume (0-128).
| 128
|-
| '''soundVolume'''
| Sound FX volume (0-128).
| 128
|-
| '''mute'''
| When enabled, disables all audio output. Automatically enabled if no audio hardware is detected.
| false
|-

! colspan="3" style="background-color: #CCCCCC" | Geoscape/Basescape

|-
| '''aggressiveRetaliation'''
| When enabled, aliens on any type of mission may detect your base if they are in very close range.
| false
|-
| '''alienContainmentLimitEnforced'''
| When enabled, enforces the limit of live aliens that can be held in each containment facility.
| false
|-
| '''allowAutoSellProduction'''
| When enabled, players can automatically sell manufactured items by right-clicking the Up Arrow on the Quantity in the manufacture screen.
| false
|-
| '''allowBuildingQueue'''
| When enabled, unfinished facilities act as links to the access lift when new facilities are placed, thereby allowing facilities to be "queued" waiting for neighboring facilities to finish.
| false
|-
| '''anytimePsiTraining'''
| When enabled, psi training can be performed at any time, instead of waiting for the end of the month.
| false
|-
| '''canManufactureMoreItemsPerHour'''
| When enabled, allows manufacturing projects to produce more than one item per hour, if the amount of engineers is very large (like in [[TFTD]]).
| false
|-
| '''canSellLiveAliens'''
| When enabled, captured aliens can be sold for cash in the same fashion as alien corpses. Recommended when '''alienContainmentLimitEnforced''' is enabled.
| false
|-
| '''canTransferCraftsWhileAirborne'''
| When enabled, crafts can be transferred between bases while they are OUT (as long as they have enough fuel).
| false
|-
| '''craftLaunchAlways'''
| When enabled, allow crafts to take off without being READY.
| false
|-
| '''customInitialBase'''
| When enabled, allows the player to customize the facility placement of the starting base.
|-
| '''dogfightSpeed'''
|
| 20
|-
| '''geoClockSpeed'''
|
| 80
|-
| '''globeAllRadarsOnBaseBuild'''
| When enabled, all radar ranges will be shown when hovering a valid base location while building a new base.
| true
|-
| '''globeDetail'''
| When enabled, country and city details are shown when zoomed in on the globe.
| true
|-
| '''globeFlightPaths
| When enabled, shows craft flight paths on the globe.
| true
|-
| '''globeRadarLines
| When enabled, the radar ranges of player bases on the globe are shown.
| true
|-
| '''globeScrollDragButton'''
| Scrolls the map when the specified mouse button is held down and dragged.
* 0 None.
* 1 Left mouse button.
* 2 Middle mouse button.
* 3 Right mouse button.
| 2
|-
| '''globeScrollSpeed
| The scrolling speed of the globe.
| 20
|-
| '''globeSeasons'''
| When enabled, the day/night cycle takes into account the Earth's [[:Wikipedia:Axial tilt|axial tilt]] for a more realistic projection of the light.
| false
|-
| '''psiStrengthEval'''
| When enabled, evaluates the psionic strength of all soldiers after the appropriate research has been completed.
| false
|-
| '''spendResearchedItems'''
| When enabled, researching an item spends it.
| false
|-
| '''showFundsOnGeoscape'''
| When enabled, shows your available funds above the time/date on the Geoscape sidebar.
| false
|-

! colspan="3" style="background-color: #CCCCCC" | Battlescape

|-
| '''allowPsionicCapture'''
| When enabled, mind-controlling all the remaining enemy units results in a victory, and they count as live captures.
| false
|-
| '''battleAlienSpeed'''
| Animation speed of alien / civilian units moving on the map.
| 30
|-
| '''battleAutoEnd'''
| When enabled, the turn is automatically ended when all friendly/enemy units are neutralized, therefore ending the mission.
| false
|-
| '''battleConfirmFireMode'''
| When enabled, a second click is required on the same tile to confirm fire orders.
| false
|-
| '''battleEdgeScroll'''
| Sets how to scroll the map.
* 0 None.
* 1 Trigger - scroll map when the left mouse button is held down on a screen edge.
* 2 Auto - scroll map when the cursor is over a screen edge.
| 2
|-
| '''battleExplosionHeight'''
| A coefficient that controls how much vertical power explosions have.
* 0 = Explosions are completely flat, as per the original game.
* 1 = -30 damage units per level (this penalty is in addition to the horizontal penalty of -10 damage per tile).
* 2 = -10 damage units per level.
* 3 = -5 damage units per level.
| 0
|-
| '''battleFireSpeed'''
| Animation speed of bullets after being fired in pixels per frame. Game setting * 2.
| 6
|-
| '''battleHairBleach'''
|
| true
|-
| '''battleInstantGrenade'''
| When enabled, grenades are "hot". This means that when primed to 0 turns, they simply explode on impact, instead of waiting for the end of the turn.
| false
|-
| '''battleNotifyDeath'''
| When enabled, displays a text notification when a soldier dies.
| false
|-
| '''battleNewPreviewPath'''
| When enabled, your first left-click displays the path the selected unit will take, and your second click confirms the move order. The amount the unit can move this turn (according to TUs) is highlighted in green, and the rest is highlighted in red.
| false
|-
| '''battleSmoothCamera'''
| When enabled, the battlescape camera will remain centered on projectiles while in flight.
| false
|-
| '''battleUFOExtenderAccuracy'''
| When enabled, mimics [[UFOextender#Range_Based_Accuracy |UFO Extender's Range based accuracy]], except using stats taken from the weapon itself rather than global config options.
| false
|-
| '''battleScrollSpeed'''
| Map scrolling speed.
| 8
|-
| '''battleScrollType'''
| Map scrolling mode.
* 0 = Trigger Scroll: Hold down the LMB over the edges of the screen to scroll.
* 1 = Auto Scroll: Hover your mouse over the edges of the screen to scroll.
* 2 = Drag Scroll: Hold down MMB and drag to scroll. Recommended for playing windowed.
| 1
|-
| '''battleScrollDragButtion'''
| Controls which mouse button is held down in Drag Scrolling
* 1 = Left Mouse Button.
* 2 = Middle Mouse Button.
* 3 = Right Mouse Button.
* 6... = Other Mouse Buttons.
| 2
|-
| '''battleScrollDragInvert'''
| When enabled, Drag Scrolling moves the camera away from your mouse, rather than moving towards it.
| false
|-
| '''battleScrollDragTimeTolerance'''
| Amount of miliseconds the mouse needs to be pressed to trigger a Drag Scroll.
| 300
|-
| '''battleScrollDragPixelTolerance'''
| Amount of pixels the mouse needs to be moved after pressing to trigger a Drag Scroll.
| 10
|-
| '''battleTooltips'''
| When enabled, hovering the Battlescape buttons displays a tooltip.
| true
|-
| '''battleXcomSpeed'''
| Animation speed of X-COM units moving on the map.
| 30
|-
| '''disableAutoEquip'''
| When enabled, disables auto-equipping of new soldiers before battle.
| false
|-
| '''skipNextTurnScreen'''
| When enabled, the "Next Turn" screens during battle are advanced automatically after a short delay.
| false
|-
| '''showMoreStatsInInventoryView'''
| When enabled, the inventory screen displays extra stats in the top-right corner, such as the weight of equipment the soldier is currently wearing/carrying and their maximum weight before TU reduction sets in, their firing accuracy, reactions and psi stats.
| false
|-
| '''sneakyAI'''
| When enabled, AI avoids exposing themselves to player whenever possible.
| false
|-
| '''strafe'''
| When enabled, holding CTRL allows soldiers to strafe and run, and allows tanks to rotate their turret independently of the chassis.
| false
|-
| '''TFTDDamage'''
| When enabled, weapons will do between 50% and 150% of their rated damage as opposed to UFO:Enemy Unknown's 0% to 200%.
| false
|-
| '''traceAI'''
| Debug feature. When enabled, highlights the paths that enemy units took after their turn.
| false
|-
| '''weaponSelfDestruction'''
| When enabled, weapons dropped by aliens are destroyed unless they are captured alive (similar to the [[Enemy Unknown (EU2012)|new X-COM]]).
| false
|-
|}

== Debug mode ==

''Debug mode'' is a special feature that makes it easier for developers/contributors to test out game features without needing to play a new game from scratch. After setting "debug: true" in the ''options.cfg'' file (see above), you can enable it by pressing ''Ctrl-D'' in-game to access a variety of features:

'''Geoscape''': All research is unlocked, allowing you to easily test all features in the Geoscape without needing to manually unlock them yourself. This doesn't affect your saved game. Regional and Country borders will be displayed.

'''Battlescape''': Whole map is revealed and opening the inventory screen resets TUs, allowing you to easily test out the map and any Battlescape features without being affected by game restrictions.

[[Category:OpenXcom]]

Compiling with Make (OpenXcom)

2013-08-31T11:17:29Z

Cfailde: proofread

== Required packages ==
* [http://git-scm.com/ git] (git)
* [http://www.libsdl.org/ SDL] (libsdl1.2-dev)
* [http://www.libsdl.org/projects/SDL_mixer/ SDL_mixer] (libsdl-mixer1.2-dev)
* [http://www.libsdl.org/projects/SDL_image/ SDL_image] (libsdl-image1.2-dev)
* [http://www.ferzkopp.net/joomla/content/view/19/14/ SDL_gfx] (libsdl-gfx1.2-dev), version 2.0.22 or later
* [http://code.google.com/p/yaml-cpp/ yaml-cpp] (libyaml-cpp-dev), version '''0.5.1 or later'''

Check the library websites if you can't find them with your distribution's package manager.

'''Don't forget to copy the X-Com resources to your ''bin'' folder as shown in [[Installing (OpenXcom)|Installing]].'''

== Commands ==

# Open up a terminal.
# Type '''git clone <repository url>''' (the official one or your own fork) to get the latest code.
# Go into the '''src/''' folder inside the repository you just pulled and rename '''Makefile.simple''' to just '''Makefile'''.
# Edit the '''Makefile''' in case there are any settings you need to change for your particular platform.
# Type '''make''' to compile all the code.
# Go to the '''bin/''' folder and run '''./openxcom'''.
# In the future, you can stay up to date by using '''git pull'''.

[[Category:OpenXcom]]

Compiling with CMake (OpenXcom)

2013-08-31T11:11:38Z

Cfailde: typo

== Before building ==
In addition to the OpenXcom [[Compiling (OpenXcom)#Dependencies |dependencies]], you will need CMake version 2.8.0 or later.

CMake can be used to build OpenXcom with differents tools. So far only the Makefile and Visual Studio have been tried. Other Generators (Xcode/Code blocks, ...) might work, but if you choose to use them, we currently have no way to make sure that they work. If broken, patches are welcome to make them work.

Note : Once a project has been generated, you don't need to regenerate it after updating the source. CMake will automatically check for modifications and regenerate the project for you.

Source dir/build dir: CMake allows you to separate the source directory (where the source resides) from the binary directory (where the project is generated). This allows you to always have a clean source directory (no clutter left from builds). The source and binary directories can be the same, but it's generally recommended to separate them.

== Generate a build project ==

'''Using CMake GUI tool'''
*Launch the CMake configuration tools. First specify the path to the OpenXcom source tree.
*Then specify where the OpenXcom project should be generated.
*Click on configure. The first time, CMake will ask you which kind of build tool you wish to use.
*Now CMake will analyze your system and once finished, you will be presented with a list of options. If all is fine for you, then click on generate.

'''Using CMake interactive command line tools'''

ccmake is a command line tools which allows you to configure the build interactively. You can launch it with:
cd "openxcom build dir" &&
ccmake -G 'Generator name' "path to openxcom source tree"
Generator name, is the name of the build system you wish to use. You can see possible values with:
cmake help
If omitted, cmake will default to 'Unix Makefile'. Note that this needed only the first time you generate the project.

As with the GUI, tweak the options as needed and then configure the project before generating it.

'''Using CMake command line tools'''
cd "openxcom build dir" &&
cmake -G 'Generator name' -DOPTION_NAME=OPTION_VALUE "path to openxcom source tree"
You can check options value with:
cmake -L
To change the value of an option:
cmake -DOPTION_NAME=OPTION_VALUE "path to openxcom source tree"

Once the project is generated, you can use it as you would have done without using CMake.

[[Category:OpenXcom]]

Compiling with CMake (OpenXcom)

2013-08-31T08:11:15Z

Cfailde: proofread

== Before building ==
In addition to the OpenXcom dependencies [[Compiling (OpenXcom)#Dependencies |dependencies]], you will need CMake version 2.8.0 or later.

CMake can be used to build OpenXcom with differents tools. So far only the Makefile and Visual Studio have been tried. Other Generators (Xcode/Code blocks, ...) might work, but if you choose to use them, we currently have no way to make sure that they work. If broken, patches are welcome to make them work.

Note : Once a project has been generated, you don't need to regenerate it after updating the source. CMake will automatically check for modifications and regenerate the project for you.

Source dir/build dir: CMake allows you to separate the source directory (where the source resides) from the binary directory (where the project is generated). This allows you to always have a clean source directory (no clutter left from builds). The source and binary directories can be the same, but it's generally recommended to separate them.

== Generate a build project ==

'''Using CMake GUI tool'''
*Launch the CMake configuration tools. First specify the path to the OpenXcom source tree.
*Then specify where the OpenXcom project should be generated.
*Click on configure. The first time, CMake will ask you which kind of build tool you wish to use.
*Now CMake will analyze your system and once finished, you will be presented with a list of options. If all is fine for you, then click on generate.

'''Using CMake interactive command line tools'''

ccmake is a command line tools which allows you to configure the build interactively. You can launch it with:
cd "openxcom build dir" &&
ccmake -G 'Generator name' "path to openxcom source tree"
Generator name, is the name of the build system you wish to use. You can see possible values with:
cmake help
If omitted, cmake will default to 'Unix Makefile'. Note that this needed only the first time you generate the project.

As with the GUI, tweak the options as needed and then configure the project before generating it.

'''Using CMake command line tools'''
cd "openxcom build dir" &&
cmake -G 'Generator name' -DOPTION_NAME=OPTION_VALUE "path to openxcom source tree"
You can check options value with:
cmake -L
To change the value of an option:
cmake -DOPTION_NAME=OPTION_VALUE "path to openxcom source tree"

Once the project is generated, you can use it as you would have done without using CMake.

[[Category:OpenXcom]]

Compiling with CMake (OpenXcom)

2013-08-31T08:07:01Z

Cfailde: proofread

== Before building ==
In addition to the OpenXcom dependencies [[Compiling (OpenXcom)#Dependencies |dependencies]], you will need CMake version 2.8.0 or later.

CMake can be used to build OpenXcom with differents tools. So far only the Makefile and Visual Studio have been tried. Other Generators (Xcode/Code blocks, ...) might work, but if you choose to use them, we have currently no way to make sure that they work. If broken, patches are welcome to make them work.

Note : Once a project has been generated, you don't need to regenerate it after updating the source. CMake will automatically check for modifications and regenerate the project for you.

Source dir/build dir: CMake allows you to separate the source directory (where the source resides) from the binary directory (where the project is generated). This allows you to always have a clean source directory (no clutter left from builds). The source and binary directories can be the same, but it's generally recommended to separate them.

== Generate a build project ==

'''Using CMake GUI tool'''
*Launch the CMake configuration tools. First specify the path to the OpenXcom source tree.
*Then specify where the OpenXcom project should be generated.
*Click on configure. The first time, CMake will ask you which kind of build tool you wish to use.
*Now CMake will analyze your system and once finished, you will be presented with a list of options. If all is fine for you, then click on generate.

'''Using CMake interactive command line tools'''

ccmake is a command line tools which allows you to configure the build interactively. You can launch it with:
cd "openxcom build dir" &&
ccmake -G 'Generator name' "path to openxcom source tree"
Generator name, is the name of the build system you wish to use. You can see possible values with:
cmake help
If omitted, cmake will default to 'Unix Makefile'. Note that this needed only the first time you generate the project.

As with the GUI, tweak the options as needed and then configure the project before generating it.

'''Using CMake command line tools'''
cd "openxcom build dir" &&
cmake -G 'Generator name' -DOPTION_NAME=OPTION_VALUE "path to openxcom source tree"
You can check options value with:
cmake -L
To change the value of an option:
cmake -DOPTION_NAME=OPTION_VALUE "path to openxcom source tree"

Once the project is generated, you can use it as you would have done without using CMake.

[[Category:OpenXcom]]

Compiling with MinGW (OpenXcom)

2013-08-30T10:40:42Z

Cfailde: /* Set up yaml-cpp */ Proofread

== Compiling on Ubuntu 12.10 or 12.04LTS ==

=== Install the cross-compiler ===

`apt-get install g++-mingw-w64-i686`

This is the compiler targeting Win32/x86. If you want to build a 64-bit binary, you're on your own for libraries.

=== Grab the source ===

e.g., `git clone https://github.com/SupSuper/OpenXcom.git`

Don't have git installed? Install it with `apt-get install git`.

=== Download the prerequisite libraries ===

Building all the prerequisites from source is a good way to waste a day of your life. Some of them are availalbe in the stock package repositries, such as libsdl and libogg, but the majority are not. I recommend downloading [http://bumba.net/~hmaon/oxc/OXC-mingw32-cross-tools.tar.xz the tarball of static libraries I've compiled].

Supposing that you've downloaded the file to ~/Downloads, install the contents with the following commands: `cd / ; tar xvJf ~/Downloads/OXC-mingw32-cross-tools.tar.xz`. This will place a bunch of files in /usr/local/cross-tools/i386-mingw32.

This fileset includes a 64-bit pkg-config binary. If you need a 32-bit one, build it with the following steps:
: apt-get source pkg-config
: cd pkg-config-*
: ./configure --prefix=/usr/local/cross-tools/i386-mingw32
: make
: sudo make install

=== Get the Makefile and make ===

[http://bumba.net/~hmaon/oxc/Makefile.mingw-hmaon Download my Makefile.] It's based on Makefile.simple and Michal's gitbuilder file. Place the file in OpenXcom/src and `make`!

Note: -lws2_32 is only needed for ntohl(), used by the FLAC library iirc.

== Compiling 32bits on Windows ==

Here comes a way to build OpenXcom in a Windows environment having installed only MinGW (no MSYS, no bash, no sh, no Visual IDE or compiler). There could be others way to do, this is only an example. Some directories names will change to match the libraries versions, just adapt the paths.

=== Install MinGW32 ===

See the [http://www.mingw.org/wiki/InstallationHOWTOforMinGW MinGW website].
Install at least C compiler, C++ compiler and GNU make.

=== Set up your project directory with SDL ===

Choose your project directory. Let's call it <project>.

On [http://www.libsdl.org/index.php SDL website] download SDL 1.2 win32 development library for Mingw32.
Extract it in <project> keeping directory hierarchy, you should get it in a directory such as <project>\SDL-1.2.15.

On [http://www.libsdl.org/projects/SDL_mixer/ SDL_mixer website] download SDL_mixer 1.2 source and SDL_mixer 1.2 Win32 32bits binaries. Extract the source in <project>, you should get it in a directory such as <project>\SDL_mixer-1.2.12. Create a <project>\SDL_mixer-1.2.12\bin directory and extract the binaries here.

On [http://www.libsdl.org/projects/SDL_image/ SDL_image website] download SDL_image 1.2 source and SDL_image 1.2 Win32 32bits binaries. Extract the source in <project>, you should get it in a directory such as <project>\SDL_image-1.2.12. Create a <project>\SDL_image-1.2.12\bin directory and extract the binaries here.

=== Set up SDL_gfx ===

On [http://www.ferzkopp.net/joomla/content/view/19/14/ SDL_gfx website] download last SDL_gfx source and extract it in <project>. You should get it in a directory such as <project>\SDL_gfx-2.0.24. Go to Other builds subdirectory and extract Makefile from mingw32.zip in the <project>\SDL_gfx-2.0.24 directory. Edit the Makefile to modify it to have:

CFLAGS = -O3 -march=athlon-xp -mmmx -msse -m3dnow -DBUILD_DLL -DWIN32 -I..\SDL-1.2.15\include\SDL
LIBS = -L..\SDL-1.2.15\lib -lSDL

OBJS = SDL_framerate.o SDL_gfxBlitFunc.o SDL_gfxPrimitives.o SDL_imageFilter.o SDL_rotozoom.o

Then run in the <project>\SDL_gfx-2.0.24 directory:

mingw32-make SDL_gfx.dll

You should get a <project>\SDL_gfx-2.0.24\SDL_gfx.dll file.

=== Set up yaml-cpp ===

From the [http://code.google.com/p/yaml-cpp/ yaml-cpp website] download a yaml-cpp source higher than 0.5.0, such as 0.5.1.
From the [http://www.cmake.org/ CMake website] download the CMake Windows zip binaries distribution.
From the [http://www.boost.org/ boost website] download the current release.
Extract the three archives in <project>; you should get directories such as <project>\yaml-cpp-0.5.1, <project>\cmake-2.8.11.2-win32-x86 and <project>\boost_1_54_0

Go to the <project>\yaml-cpp-0.5.1 directory and run the following commands:

set Path=%Path%;<project>\cmake-2.8.11.2-win32-x86\bin
mkdir build
cd build
cmake -G "MinGW Makefiles" -DBUILD_SHARED_LIBS=OFF -DBoost_INCLUDE_DIR=<project>\boost_1_54_0 ..
mingw32-make

This should build a static library <project>\yaml-cpp-0.5.1\build\libyaml-cpp.a.
There are problems [http://stackoverflow.com/questions/18390694/undefined-reference-linking-yaml-cpp-program-with-mingw-w64-cmake building a dynamix library] with the 0.5.1 version, but this could work with later versions.

Thankfully yaml-cpp does not need boost to build (it only uses the header files) because boost does not support MinGW compiling.

=== Build and run OpenXcom ===

Download the last available source and extract it in <project> directory, you should get a <project>\OpenXcom-master directory.
Copy original game directories in <project>\OpenXcom-master\bin\data directory.
Create a <project>\OpenXcom-master\makefile such as this one:

PROG=OpenXCom

MINGW=

SRC=$(wildcard src/*.cpp src/*/*.cpp src/*/*/*.cpp)
OBJRES=src\$(PROG)_res.o
OBJ=$(OBJRES) $(SRC:.cpp=.o)
BIN=bin\$(PROG).exe
RES=src\$(PROG).rc src\resource.h src\version.h res\windows\openxcom.ico

WINVER=0x0400
CXX=$(MINGW)g++
CXXFLAGS=-DWINVER=$(WINVER) -I..\SDL-1.2.15\include\SDL -I..\SDL_mixer-1.2.12 -I..\SDL_image-1.2.12 -I..\SDL_gfx-2.0.24
-I..\yaml-cpp-0.5.1\include -I..\boost_1_54_0 -Wall -Wextra -Wno-unused-function -O2
LDFLAGS=-L..\SDL-1.2.15\lib -L..\yaml-cpp-0.5.1\build -lshlwapi -lmingw32 -lopengl32 -lSDLmain ..\SDL-1.2.15\bin\SDL.dll
..\SDL_mixer-1.2.12\bin\SDL_mixer.dll ..\SDL_image-1.2.12\bin\SDL_image.dll ..\SDL_gfx-2.0.24\bin\SDL_gfx.dll -lyaml-cpp
-mwindows
RC=$(MINGW)windres
RFLAGS=

.PHONY:all compile depends mrproper clean rebuild

all:compile

compile:$(BIN)

depends:
AppDep -n -l "# Dependencies" makefile
for %%i in ($(SRC:.cpp=)) do $(CXX) $(CXXFLAGS) -MM "%%i.cpp" -MT "%%i.o" >> makefile

$(BIN):$(OBJ)
$(CXX) $(CXXFLAGS) -o $(BIN) $(OBJ) $(LDFLAGS)

$(OBJRES):$(RES)
$(RC) $(RFLAGS) -o $@ $<

%.o:%.cpp
$(CXX) $(CXXFLAGS) -o $@ -c $<

mrproper:clean
for %%i in ($(BIN)) do if exist "%%~fi" del "%%~fi"

clean:
for %%i in ($(OBJ)) do if exist "%%~fi" del "%%~fi"

rebuild:mrproper all

You can also try to produce your makefile with CMake rather than using this example.

Fill MINGW variable if you have several MinGW instances (such as a 32bits one and a 64bits one).
Consider adding "-g -D_DEBUG" to CXXFLAGS variable to generate debug information.

AppDep utility can be downloaded [http://julien.darthenay.free.fr/progcmingw.php here].
If you don't want to use it, just add a #Dependencies line at the end of your makefile, remove the AppDep call, and clear all lines after #Dependencies before using make depends.

Go to <project>\OpenXcom-master and run:

mingw32-make depends
mingw32-make all

The file <project>\OpenXcom-master\bin\OpenXcom.exe should be produced.
If windres fails because of null characters, convert src\resource.h and src\OpenXcom.rc from UTF-16LE to ANSI.

To run the game, use the following commands in the same directory:

set Path=%Path;<project>\SDL-1.2.15\bin;<project>\SDL_mixer-1.2.12\bin;<project>\SDL_image-1.2.12\bin;<project>\SDL_gfx-2.0.24\bin
bin\OpenXcom.exe -user <your name>

== MXE ==
Michal uses a different setup for his own builds and gitbuilder, based on [http://mxe.cc/ MXE]. I haven't tried MXE myself but supposedly its compiler rejects the -msse2 flag. On the other hand, it looks like it'll build all the libraries for you!

[[Category:OpenXcom]]

Compiling (OpenXcom)

2013-08-28T20:23:21Z

Cfailde: /* Dependencies */ updated YAML version

The OpenXcom codebase is hosted on [https://github.com/SupSuper/OpenXcom Github], and you can grab the latest source with any Git client from: <code>https://github.com/SupSuper/OpenXcom.git</code>

If you're a Github user you might wanna [http://help.github.com/forking use a fork] instead so you can have your own remote repository (you can't push to the official OpenXcom repository without permission) and easily send in pull requests.

OpenXcom is a cross-platform game so it's possible to compile it on a variety of systems and project files for all the popular IDEs are included. There's also a [http://openxcom.org/docs/html/ Doxygen documentation] available.

'''Don't forget to copy the X-Com resources to your ''bin'' folder as shown in [[Installing (OpenXcom)|Installing]].'''

== Dependencies ==

OpenXcom requires the following libraries to compile:

* [http://www.libsdl.org/ SDL] (libsdl1.2)
* [http://www.libsdl.org/projects/SDL_mixer/ SDL_mixer] (libsdl-mixer1.2)
* [http://www.libsdl.org/projects/SDL_image/ SDL_image] (libsdl-image1.2)
* [http://www.ferzkopp.net/joomla/content/view/19/14/ SDL_gfx] (libsdl-gfx1.2), version 2.0.22 or later
* [http://code.google.com/p/yaml-cpp/ yaml-cpp], version 0.5.1

== Windows ==

* [[Compiling with Microsoft Visual C++ (OpenXcom)|Compiling with Microsoft Visual C++]]
* [[Compiling with MinGW (OpenXcom)|Compiling with MinGW]]
* [[Compiling with Cygwin (OpenXcom)|Compiling with Cygwin]]

== Mac OS X ==

* [[Compiling with Xcode (OpenXcom)|Compiling with Xcode]]
* [[Compiling with brew (OpenXcom)|Compiling with brew]]

== Linux/BSD ==

* [[Compiling with Make (OpenXcom)|Compiling with Make]]
* [[Compiling with Autotools (OpenXcom)|Compiling with Autotools]]

== Misc. ==

* [[Compiling with Code::Blocks (OpenXcom)|Compiling with Code::Blocks]]
* [[Compiling with Eclipse (OpenXcom)|Compiling with Eclipse]]
* [[Compiling with CMake (OpenXcom)|Compiling with CMake]]
* [[Compiling for Dingoo (OpenXcom)|Compiling for Dingoo]]

[[Category:OpenXcom]]

Exploiting Mind Control

2013-08-20T10:32:10Z

Cfailde: /* Resurrect Zombified Agents */ it's -> its

'''THIS PAGE IS UNDER CONSTRUCTION'''

=Mind Control Madness=
==Civilian Traitors==
Whenever you mind control another unit, it automatically returns to the alien side at the end of the aliens' turn. This is true even if you mind control a [[Civilian]].
While saving civilians leads to higher scores, "removing" them from play in this way, then killing them off as aliens removes the risk of a score penalty that would result if the civilians were killed by the aliens.

==Resurrect Zombified Agents==
also known as: '''Permanent Control of a Chryssalid/Tentaculat'''

To 'rescue' your zombified agent you must [[mind control]]/[[molecular control]] its [[zombie]] form, then shoot it to make it hatch.
The chrysallid/tentaculat that just hatched will appear to be hostile, but don't kill it. Next turn, and for the rest of the mission, it will be controlled by you without additional psionic actions. A chryssalid/tentaculat that is under your permanent control still gains experience as if it had never been zombified before this and you can do with it as a normal soldier. However, you may not look at its rank as this causes the game to crash. Sometimes the weapon it has will disappear but this can be solved by going into its inventory and picking it up and putting it back in the hand it was in.

If one of your agents got zombified, and you use this trick, you can 'recover' the agent if the chrysallid/tentaculat version of the soldier survives until the end of the mission. The resurrected agent will be back at base. You don't need to create new armor for a 'rescued' agent even though they have been 'killed'.

If your pet chrysallid/tentaculat happens to get zombified, just repeat the steps to gaining permanent control. This action effectively regenerates your pet's health.

However, each time this happens, you lose morale and the counter for the number of X-Com soldiers lost on that mission increases as if it were a different soldier being killed. So you may go in with 10 soldiers, but leave with 10 and -5 casualties. You could use this exploit to turn most of your troops into super soldiers but your morale will suffer so much that your psionic/molecular control troops may panic or go berserk if you push it too far. This could end up with you having very few troops under your control and more aliens that you could shake a stick at after you.

This exploit can also be used when civilians get zombified. And, since the terror units have many TU, they make excellent scouts. You could give your pet alien a weapon, but they have terrible throwing and accuracy skills. They do, however, have incredible reactions which makes them deadly if you post them right at the side of a door to shoot anything that comes through. However, if you give your pet a primed high explosive and send them off to scout, they will drop it when they die resulting in an explosion that kills everything in the area (or at least knocks off a good chunk of their health). Zombified civilians cannot be 'drafted' as new soldiers or replace any soldiers killed during the mission.

IMHO, the BEST use of your pet is to use the Alien Inventory exploit and give it a Stun Rod or a Heavy Plasma with a Stun Rod in it. With its rather insane TU, it can pretty much run up to and stun or kill anything it can see, assuming it isn't killed in mid-sprint. Alternatively, give it a med-kit, since those use a fixed 10 TU per use, and your pet has a LOT of TU, it can become the best doctor in the game... provided your patient is on the ground and not on top of your ship.

==My Pet Alien==
Any alien can be your agent's personal escort. Just remember to mind control the alien every turn. When there are large terrorists on a mission, you'll notice that they take up four squares. Each square has its own stats. If you mind control one quadrant, the other three quadrants still stay under alien control.

If you move the large alien, there is a good chance that it will SHOOT ITSELF (if it can) via reaction fire! If the large alien does not shoot itself, you can use up its TU to fire on hostiles, or use it to scout. Once the TU are used up, mind control another quadrant to keep using this alien. You can do this four times.

Alternatively, you can target the other quadrants of the alien and make the terror unit shoot itself. This is a worthwhile tactic to use on Cyberdiscs and Sectopods.
Cyberdiscs explode on death, while the Sectopod has a Laser Auto Shot which can dish out a maximum of 300 points of damage each shot.

The best use of mind control: scout. If you see someone holding a [[Blaster Launcher]], mind control it and fire, then drop the weapon, rendering a bunch of aliens dead and one harmless if you're lucky.

==Access the Alien Inventory Screen==
When an alien is mind controlled, you can't directly see their inventory by clicking the inventory button. However, if you switch to a human soldier, and check their inventory, you can use the arrows in the top corner to cycle through '''all''' units.

'''WARNING''' There is a critical bug which is connected to this exploit. Read about it here: [[Known_Bugs#Alien_Inventory_Stacking_Bug| Alien Inventory Stacking Bug]]

<br> Use this exploit to change their inventory. You can give them weapons (eg: for [[Reaction Training]]), live grenades, or anything else. Remember to mind control them each turn if you use them as mules.

==Exponential Mind Control==
Any creature with psionic skill can use a [[Psi-Amp|psionic amplifier]].
Therefore, you can take control of (e.g.) an Ethereal and then toss it a psi-amp, use the [[Exploits#Access_the_Alien_Inventory_Screen|alien inventory exploit]], and have him pick it up.
Then you can use the Ethereal's psionic talents to take over other aliens. With the right application of psi-amp relay tosses and mind control, this can have an exponential effect of complete control of all the aliens in the very first turn.

It is even easier to use several high-level Psi troops (80+ Psi Strength & Skill), each with their own Psi-Amp, to create chains of aliens extending across the entire map; each new alien discovered and controlled becomes the forwardmost scout while your troops remain safely at the back of the chain (or even in the transport).
This is easily the single most imbalancing tactic in the game, short of hacking the game files.

==Zombie's Permanent Control of Aliens via Stunning==

* Mindcontrol any 1x1-sized alien, except Zombies (as these can't be awakened once unconscious).
* Stun that alien. Stun Bombs from the Small Launcher are the preferred method, because the stun rod depends on alien status to function. (On Windows Version, you can´t use the Stun Rod on friendly units).
* Revive the alien. You can either wait until the alien recovers on it's own, or use stimulant shots from a Medi-Kit to speed things along.
* Wait until the start of your next round. After the alien wakes up, it will appear as alien, but this lasts just for your present turn.

That's it, the alien should now be under permanent X-COM control. You can do anything with an X-COM alien as you can with a normal soldier: Directly access the aliens inventory screen without scrolling through all your guys first.
Arm it and send it in as a advance scout into UFOs. In all practicality, they are yours to do with as you please.

==Invincible Strategy & Four-quadrant Aliens==
Getting your first soldier with 90+ psionic strength and a Psi-Amp, pretty much guarantees a win even on superhuman difficulty. Train this soldier in the Lab and by using all their TUs on mind control every tactical turn. He/she will soon have seemingly 100% chance in controlling every kind of alien there is, at whatever difficulty level, at whatever distance. As you gather more 90+ psi strength soldiers, the game becomes absurd. You can control every single alien in an undamaged battleship/alien base in the same turn. Just push alien pets forward to find more potential pets. Make sure your "chain of command" won't break in next turn by having an alien around every corner to link up your extended line-of-sight next turn.

Controlling four-square aliens requires special care. The top quadrant grants main control, no matter which way it's facing. For those without guns (reapers), the top quadrant is all you need to control. For large terrorists with guns, controlling the top quadrant means the other three quadrants can still reaction fire on you, or reaction fire on itself. However, they will not reaction fire on themselves if you turn them. Of course, you can always kill them just by moving it around.

When using these terrorists to train your firing accuracy, make sure you deplete the terrorists' TUs AFTER you control all four quadrants. You can then use them for firing practice safely.

Mind controlling each additional quadrant also "re-fills" it's TUs. For example, you can run the reaper halfway across the map, control another quadrant, and regain all it's spent TUs.

[[Category:Oddities and bugs]]
[[Category:Enemy Unknown/UFO Defense]]

Stun Rod

2013-06-17T20:14:19Z

Cfailde: /* Tips */ it's -> its

The stun rod is a melee weapon used to shock enemies unconscious. It is the most reliable form of stunning enemies until the advent of the [[Small Launcher]]. The stun rod does not require ammunition and can be used as many times as necessary.

To use a stun rod the soldier wielding it has to be adjacent to the alien and facing the target. It's very dangerous to use early in the game when you have low TU soldiers with bad armor. But it's the only practical means to capture an alien Navigator or Sectoid Leader/Commander as early as possible, so it is an important piece of equipment.

This weapon appears in ''[[X-COM|UFO: Enemy Unknown]]''. For the ''[[TFTD|Terror from the Deep]]'' equivalent, refer to the [[Thermal Tazer]].

== Stats ==
<table><tr><td>[[Image:BIGOBS26.GIF|left|64 px]]</td><td>
*Power: 65 Stun
*Size: 3 high x 1 wide
*Weight: 6
*TUs:
**Stun: 30% (Accuracy 100%)
*[[Buying/Selling/Transferring#Non-Manufacturable_Prices|Cost]]: $1,260
*Sell Price: $945</td></tr></table>

While technically a two handed weapon, the stun rod is guaranteed to hit your target regardless as to whether the other hand is free so long as you are standing directly beside your enemy, and facing them.

== Recommendations ==
Buy these the day before your alien containment facility is finished, then equip them en-masse to your recruits. The loss of a soldier or two is little compared to being able to unlock psionics or the hyperwave decoder. These stun-troopers work best in conjunction with a high-ranking rear commander to help lower losses. The mind probe is ultimately unnecessary for determining ranks for leaders tend to stay in the command room and navigators near the navigation systems; henchmen can easily be dealt with using spotter-sniper tactics until reaching the ufo itself, where near-suicidal waves of expendable troops work wonders. This weapon combines well with the laser pistol or grenades.

== Usage notes ==
The following lists how many times a soldier can fire the gun by shot type continuously in any given round and the remaining percentage of any left over TUs that cannot be spent as a shot.

* Stun: 3 zaps, 10% Remaining TUs

== Tips ==
* Remember aliens you [[stun]] for research purposes will die unless brought back to an [[Alien Containment]] facility (and you won't get score for 'aliens killed' and 'alien corpses recovered' for them neither!)

* A Stun Rod will not work on X-COM-controlled units, so you cannot use them against soldiers which have gone berserk, alas. They will also not work on aliens presently under X-COM [[Mind Control]] -- though they will work against X-COM soldiers under alien Mind Control.

* Melee attacks will not attract opportunity fire - as long as you don't try to perform an action that will attract opportunity fire immediately afterwards while in full view of the alien you zapped.

* Try to approach from behind.

* Early in the game, put this weapon on your more expendable soldiers - there's a good chance they will die! It's a good idea to carry a pistol in the other hand as a backup. The pistol can also be used to slightly damage a unit before/after a capture attempt.

* Aliens who have been in smoke for some time will not be any easier to stun, since enemy-controlled units do not take stun damage from smoke.

* You can use stun rod as a support weapon for stronger soldiers who use HE ammo (with heavy cannon/auto cannon) - if you stumble upon an alien a square away while opening a door or falling down a hole, you'd likely get yourself caught in splash damage of your explosive ammo if you shoot. Taking them out with the stun rod is way safer and thanks to minimal TU cost it's often preferred to all other weapons including pistols. (then you can kill the unconscious alien from a safe distance shooting at the ground.)

* The easiest place to get a [[Navigator]] before you can use a [[Mind Probe]] is inside a [[Large Scout]]. Usually 1 or 2 hang around inside near the [[UFO Navigation]], and it's comparatively safe to go through a door and stun one. The alien inside the central room is normally an [[Engineer]] and carries a [[Small Launcher]] on higher difficulties / mid-game; this can be used to your advantage.

* Setting an alien on fire can make capturing it slightly easier. It lowers their [[health]] and [[Firing Accuracy|firing accuracy]] each turn they BBQ, making them safer to approach and easier to stun. Finally, they tend to waste all their TUs running away from the fire. The fire will be put out when the alien falls unconscious.

* Be very wary concerning stun rods and elevation. Even though you may look like you're almost level with the target, you may have to kneel on a slight slope in order to strike an alien that's on lower flat ground - sectoids, for example.

* Terror missions: Civilians stunned by use of the stun rod (or any method) do not cause a plus or minus to points at the end of the mission. If they wake up, they will [[Why civilians go rogue|appear as aliens]], but civilians have a victory point value of 0. This is especially useful in Snakeman terror missions, because every stunned civilian is one less potential Chryssalid.

* Stun is a useful tool to take down Cyberdiscs in close quarters as this terror unit will not go through its auto-destruct sequence if poked.

* How much stun is applied with the Stun Rod relies on the armor rating on the target. Too much armor and the Stun Rod is rendered useless. This is especially true for non-Beginner [[Sectopod]]s whose front and side armor are too great. Pokes to the back plates still work, but only 30% of the time will the stun be high enough to penetrate.

==Activating melee attacks for other items==
Every item in the game has a melee weapon rating, however the melee attack command has been disabled for all items but the stun rod. One unusual work-around is to stack the stun rod on top of another item in one of your hand slots. This has the effect of displaying the stun rod as the active weapon and hiding the ammo counter. However, when the attack menu is brought up, the stun command will now show that it requires 50% of your [[Time Units]] to use and you will also get the firing commands for the stacked weapon.

Do not be fooled however by the now more expensive stun command as this new attack is deadly and will kill its target. The strength of the attack differs based on different objects, so you will have to experiment to find a good combination, as not all weapons have the same melee strength. Some do nothing, while others will kill a healthy [[superhuman]] [[sectopod]] in one hit. Try guns, grenades and even corpses if you're desperate.<br>

See [[Item Stacking Bug]] for instructions on item stacking.

==See also==
{{Equipment (UFO Defense) Navbar}}
[[Category:Equipment (EU)]]
[[Category: Tactics]]

Avenger

2013-04-15T21:57:15Z

Cfailde: typos

[[Image:UP001.gif|right|Avenger - Ultimate Craft]]
The '''Avenger''' is the ultimate replication of Alien technology. It is both the best troop transporter and best interceptor available in the game.

This craft appears in ''[[X-COM|UFO: Enemy Unknown]]''. For the ''[[TFTD|Terror from the Deep]]'' equivalent, refer to the [[Leviathan]].

==How to use it==

The Avenger is the fastest craft available to [[X-COM]], capable of reaching any point on earth within three hours and intercepting any UFO. With enough fuel for ten hours of flight, it can still patrol a bit and/or follow UFOs around. It has a very large damage capacity. When armed with dual [[Plasma Beam]]s, the Avenger is the only craft available to X-COM that can reliably intercept an alien battleship single-handedly without risk of complete destruction - if necessary, though is not recommended as will become apparent shortly.

It has sufficient room to carry 26 [[soldiers]] (or a mix of soldiers and up to four [[Heavy Weapons Platforms]]). Due to the 80 item limit, 26 soldiers will cause difficulties in inventory juggling. To get around this, bring some HWPs , don't fill the Avenger to full capacity, or get your unarmed troops to pick up weapons off fallen enemies.

The Avenger is unfortunately expensive and takes a long time to build. Many players find it easier to employ cheaper or more readily available ships and have only a few Avengers to supplement them in times of great need.

There is a common misconception that an Avenger will be in the repairshop for longer than other craft. This is mostly untrue. An Avenger that received 400 damage will take exactly the same time to repair as a Firestorm that takes 400 damage. Admittedly, if you Firestorm is destroyed, you do not have to repair it at all, but losing a ship and letting the battleship complete its mission seems silly, it would have been better not to engage it at all in that case.

The Avenger's high hit points frequently trick inexperienced commanders into making an Avenger solo a Battleship. A Plasma Beam armed Avenger will always beat a Battleship, since it has many more Health than a Firestorm. However, even though the damage might look small, it actually took the same amount of damage as a Firestorm would have, the only difference being the Firestorm might have been destroyed, but the Avenger always survives, albeit with several hundred damage received. Since damage is repaired at the same rate as other aircraft at 1 hitpoint per hour, a very badly damaged Avenger could be in repair for over a month.

Therefore, when engaging a [[Battleship]], it is more or less imperative to send in multiple Avengers at once. The best is to ALWAYS send in four Avengers at once. Firstly,this will bring it down quicker. The faster it is shot down, the less return fire will be received. Every additional Avenger, or any other ship armed with plasma beams, that join the dogfight will potentially reduce the length of battle to one half, one third or one quarter of the length of a normal air skirmish respectively. Secondly, it has been unconfirmed that enemy UFOs have a fixed firing rate, which is distributed among all intercept craft. However, be warned that the UFOs will attempt to concentrate fire on your intercept craft one by one!!! To be precise, when clicking the Aggresive Attack button in order of Top Left, Top Right, Bottom Left, Bottom Right, the Battleship was observed to fire almost exclusively at the Top Left ship, once that was destroyed, the Top Right, then Bottom Left, then Bottom Right.

To summarise, damage received seem to indicate an average result of:
1 Avenger, solo, receives 740 damage (1 free shot from Battleship as you close in + 7 more shots)
4 Avengers, simultaneous, receive damage distribution of 150, 60, 50, 0 based on which ship attacks first.
Where 1 point of damage = 1 hour being repaired.

Note that intercepting with 4 avengers at once uses up 4 times as much Elerium as intercepting with 1 avenger.
Also note that, if you have a very large workshop base, it is faster to just send in 1 Avenger to solo, then decommission it upon return. Just replace the Plasma Beams with Stingray Launchers and sell your Avenger. Manufacture a new Avenger to replace it... this will take only 6.5 days using 250 engineers working in 6 workshops. Expensive (3.5 million per Avenger), but time saving.

Due to its acceleration and speed, the Avenger is the most fuel efficient Hybrid craft. Despite its size, the Avenger uses Elerium fuel at the same 1 per 10 minute rate as the Firestorm and Lightning, however it will reach its destinations much faster and return faster, thus it uses less fuel overall. This acceleration and top speed also make it the best craft to hunt down and engage UFOs.
However, as with any elerium fueled aircraft, an Avenger has very limited fuel capacity, and shares the same [[Known Bugs#Elerium-fueled Craft Bug|design flaw]] as the [[Firestorm]] and the [[Lightning]] that forces it to return to base after depleting half of its fuel, cutting its air time even further. This makes it unsuitable (and the fact that it uses Elerium as fuel makes it very costly) for general patrol or for hunting potential alien base locations. The Interceptor or Skyranger are better suited to this task.

==Battlescape Graphics==
<gallery widths="175">
Image:AVENGER-L0.PNG|Avenger Level 0
Image:AVENGER-L1.PNG|Avenger Level 1
Image:AVENGER-L2.PNG|Avenger Level 2
</gallery>

== Special Requirements ==
The "Avenger" craft is fueled by [[Elerium-115]]. Before [[manufacturing]] this craft, ensure that you have sufficient stocks of Elerium in your [[General_Stores|general stores]].

While airborne, the Avenger consumes 1 fuel unit (1/5th unit of [[Elerium-115]], 1.66% total fuel) every ten minutes, regardless of the speed of the craft. The Avenger has a maximum (radial) range of 27,000 nautical miles, while being airborne for 5 hours. Its maximum (distance) range is 54,000 nautical miles for a total fly time of 10 hours. Patrolling has no effect on fuel consumption.

One Avenger requires 12 units of Elerium for refueling. When refueling, the Avenger receives 8.33% more fuel (one unit of Elerium) every half hour, on the half hour. So it can take up to six hours to refuel, and will be finished fueling precisely on the turn of a half hour.

If Plasma Beams have been fired, it will take 3 hours to re-arm, regardless of how many PB shots were used. At the turn of the first hour after refueling (measured by hour on the clock, straight up), your left Plasma Beam goes to 100 ammo. Turn of second hour, right one goes to 100. Turn of third hour: Craft drops out of REARMING status and is ready to fly. Even if your craft has not fired (ammo=100), it will still wait until the next hour (straight up) going through that last REARM phase after refueling.

Avengers are repaired at the rate of 2% damage per day. Thus it can take e.g. THIRTY DAYS to fix a 60% damaged Avenger. A Firestorm would recover from 60% in just over 12 days (4.8%%/day). However, what's really happening here is that they both repair exactly the same ''Damage Capacity'' (i.e., "hit points") per day... 2% of 1200 equals 24/day for Avenger, and 4.8% of 500 equals 24/day for Firestorm. In fact, 60% damage to an Avenger is 720 damage, which would have utterly destroyed a Firestorm, leaving nothing to repair. 60% damage for a Firestorm is only 300. So, comparing damage % between an Avenger and Firestorm is just being silly... UFOs do damage in damage capacity points, not in percentage terms. The correct analysis is to compare a Firestorm which receives 300 damage to an Avenger which receives 300 damage... and the result is that they both spend the exact same time in the workshop. The only difference is when a Battleship manages to inflict over 499 points of damage in which case the Avenger spends a long time being repaired, and in the Firestorm's case, you would have to manufacture a new Firestorm and 2 Plasma Beams.

Service is done in this order: [[Repairs]], [[refueling]], [[rearming]]. If you transfer an Avenger between bases, it will still need refueling and rearming when it arrives even though 12+ hours have passed (if it needed them before it left).

== Vital Statistics ==
<table>
<tr><td>Maximum Speed:</td><td>5,400</td></tr>
<tr><td>Acceleration:</td><td>10</td></tr>
<tr><td>Fuel Capacity:</td><td>60</td></tr>
<tr><td>Weapon Pods:</td><td>2</td></tr>
<tr><td>Damage Capacity:</td><td>1,200</td></tr>
<tr><td>Cargo Space:</td><td>26</td></tr>
<tr><td>[[:Category:Heavy Weapons Platforms|HWP]] Capacity:</td><td>4</td></tr>
<tr><td>Work Space Required:</td><td>36</td></tr>
</table>

== See Also ==
{{Craft Navbar}}

[[Category: Research (EU)]][[Category:X-COM Craft (EU)]]

Alien Weapon Loadouts

2013-02-23T10:27:43Z

Cfailde: typo

<table {{StdCenterTable}}>
<tr><td width="120"></td><td width="30"><b>1E</b></td><td width="30"><b>2E</b></td><td width="30"><b>3E</b></td><td width="30"><b>4E</b></td><td width="30"><b>5E</b></td><td width="30"><b>1M</b></td><td width="30"><b>2M</b></td><td width="30"><b>3M</b></td><td width="30"><b>4M</b></td><td width="30"><b>5M</b></td><td width="30"><b>1L</b></td><td width="30"><b>2L</b></td><td width="30"><b>3L</b></td><td width="30"><b>4L</b></td><td width="30"><b>5L</b></td></tr>
<tr {{StdDescTable_Heading}}><th colspan="16">Small Scout</th></tr>
<tr><td align="left">Soldier</td><td>PP</td><td>PPC</td><td>PPC</td><td>MP</td><td>0</td><td>PR</td><td>PRC</td><td><div style="color:red;">PPC</div></td><td>MP</td><td>0</td><td>HP</td><td>HPC</td><td>MP</td><td>0</td><td>0</td></tr>
<tr {{StdDescTable_Heading}}><th colspan="16">Medium Scout</th></tr>
<tr><td align="left">Soldier</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>0</td><td>0</td></tr>
<tr><td align="left">Navigator</td><td>PP</td><td>PPC</td><td>MP</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>0</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>0</td><td>0</td><td>0</td></tr>
<tr {{StdDescTable_Heading}}><th colspan="16">Large Scout</th></tr>
<tr><td align="left">Soldier</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>HPC</td><td>0</td><td>0</td></tr>
<tr><td align="left">Navigator</td><td>PP</td><td>PPC</td><td>MP</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Engineer</td><td>PP</td><td>PPC</td><td>MP</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>MP</td><td>PRC</td><td>0</td><td>SL</td><td>SB</td><td>SB</td><td>SB</td><td>0</td></tr>
<tr {{StdDescTable_Heading}}><th colspan="16">Harvester</th></tr>
<tr><td align="left">Soldier</td><td>PP</td><td>PPC</td><td>0</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>0</td><td>0</td></tr>
<tr><td align="left">Navigator</td><td>PP</td><td>PPC</td><td>0</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>AG</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>HPC</td><td>0</td><td>0</td></tr>
<tr><td align="left">Medic</td><td>SL</td><td>SB</td><td>SB</td><td>SB</td><td>0</td><td>SL</td><td>SB</td><td>SB</td><td>SB</td><td>0</td><td>SL</td><td>SB</td><td>SB</td><td>SB</td><td>SB</td></tr>
<tr><td align="left">Engineer</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>0</td><td>0</td><td>0</td></tr>
<tr><td align="left">Leader</td><td>PP</td><td>PPC</td><td>AG</td><td>PPC</td><td>0</td><td>PR</td><td>PRC</td><td>AG</td><td>PRC</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>AG</td><td>HPC</td></tr>
<tr {{StdDescTable_Heading}}><th colspan="16">Abductor</th></tr>
<tr><td align="left">Soldier</td><td>PP</td><td>PPC</td><td>0</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Navigator</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Medic</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>AG</td><td>PRC</td><td>0</td><td>HP</td><td>HPC</td><td>HPC</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Engineer</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Leader</td><td><div style="color:red;">PRC</div></td><td><div style="color:red;">PP</div></td><td><div style="color:red;">PP</div></td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr {{StdDescTable_Heading}}><th colspan="16">Terror Ship</th></tr>
<tr><td align="left">Soldier</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>AG</td><td>PRC</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Navigator</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>HPC</td><td>0</td><td>0</td></tr>
<tr><td align="left">Medic</td><td>PP</td><td>PPC</td><td>AG</td><td>PPC</td><td>0</td><td>PR</td><td>PRC</td><td>AG</td><td>PRC</td><td>0</td><td>SL</td><td>SB</td><td>SB</td><td>SB</td><td>0</td></tr>
<tr><td align="left">Engineer</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Leader</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Terrorist 1</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td></tr>
<tr><td align="left">Terrorist 2</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td></tr>
<tr {{StdDescTable_Heading}}><th colspan="16">Battleship</th></tr>
<tr><td align="left">Soldier</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Navigator</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Medic</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>SL</td><td>SB</td><td>SB</td><td>SB</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Engineer</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>BL</td><td>BB</td><td>BB</td><td>BB</td><td>BB</td></tr>
<tr><td align="left">Leader</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td><td>BL</td><td>BB</td><td>BB</td><td>BB</td><td>BB</td></tr>
<tr><td align="left">Commander</td><td>HP</td><td>HPC</td><td>AG</td><td>AG</td><td>HPC</td><td>HP</td><td>HPC</td><td>AG</td><td>AG</td><td>HPC</td><td>BL</td><td>BB</td><td>BB</td><td>BB</td><td>BB</td></tr>
<tr><td align="left">Terrorist 1</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td></tr>
<tr><td align="left">Terrorist 2</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td></tr>
<tr {{StdDescTable_Heading}}><th colspan="16">Supply Ship</th></tr>
<tr><td align="left">Soldier</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Navigator</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Medic</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>SL</td><td>SB</td><td>SB</td><td>SB</td><td>0</td></tr>
<tr><td align="left">Engineer</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Leader</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr {{StdDescTable_Heading}}><th colspan="16">Base Missions</th></tr>
<tr><td align="left">Terrorist 1</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td></tr>
<tr><td align="left">Terrorist 2</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td></tr>
<tr><td align="left">Soldier</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Navigator</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Medic</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>SL</td><td>SB</td><td>SB</td><td>SB</td><td>0</td></tr>
<tr><td align="left">Engineer</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>BL</td><td>BB</td><td>BB</td><td>BB</td><td>BB</td></tr>
<tr><td align="left">Leader</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td><td>BL</td><td>BB</td><td>BB</td><td>BB</td><td>BB</td></tr>
<tr><td align="left">Commander</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr {{StdDescTable_Heading}}><th colspan="16">Mars 1</th></tr>
<tr><td align="left">Sect. Soldiers</td><td>PP</td><td>PPC</td><td>0</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>0</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>0</td><td>0</td></tr>
<tr><td align="left">Sect. Leaders</td><td>PP</td><td>PPC</td><td>0</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>0</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>0</td><td>0</td></tr>
<tr><td align="left">Sect. Comm.</td><td>PP</td><td>PPC</td><td>0</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>0</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>0</td><td>0</td></tr>
<tr><td align="left">Cyberdiscs</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td></tr>
<tr {{StdDescTable_Heading}}><th colspan="16">Mars 2</th></tr>
<tr><td align="left">Eth. Soldiers</td><td>BL</td><td>BB</td><td>BB</td><td>BB</td><td>BB</td><td>BL</td><td>BB</td><td>BB</td><td>BB</td><td>BB</td><td>BL</td><td>BB</td><td>BB</td><td>BB</td><td>BB</td></tr>
<tr><td align="left">Eth. Leaders</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Eth. Comm.</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Chryssalids</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td></tr>
<tr><td align="left">Silacoids</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td></tr>
<tr><td align="left">Celatids</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td></tr>
<tr><td align="left">Sectopods</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td></tr>
</table><br>

'''Table Key'''
:<div style="color:red;">Red entries indicate an error in loadout.</div>

:<b>E</b>=Early
:<b>M</b>=Middle
:<b>L</b>=Late

:'''PP''' = Plasma Pistol
:'''PPC''' = Plasma Pistol Clip
:'''PR''' = Plasma Rifle
:'''PRC''' = Plasma Rifle Clip
:'''HP''' = Heavy Plasma
:'''HPC''' = Heavy Plasma Clip
:'''SL''' = Small Launcher
:'''SB''' = Stun Bomb
:'''BL''' = Blaster Launcher
:'''BB''' = Blaster Bomb
:'''AG''' = Alien Grenade
:'''MP''' = Mind Probe

(all weapons start loaded)

DOS v1.4 data starts at byte 367014 in [[GEOSCAPE.EXE]]; entries are 21 bytes and correspond to the following (borrowed from [[User:Zombie|Zombie]]'s post [http://www.strategycore.co.uk/forums/Alien-Loadouts-Of-Weapons-t6441.html&view=findpost&p=77795#entry77795 here]):
:'''00''': Mission type (starts from 05 = Small Scout; goes to 15 (x0F) for Mars 2)
:'''01''': Alien rank
:'''02''': Base number of aliens on Beginner / Experienced
:'''03''': Base number of aliens on Superhuman (Veteran / Genius is the average of these two)
:'''04''': A random number from 0 to this number will be added to the above number of aliens
:'''05''': Unknown
:'''06-10''' (x06-x0A): Early game loadout
:'''11-15''' (x0B-x0F): Mid game loadout
:'''16-20''' (x10-x14): Late game loadout

NOTE!!! : Certain aliens are restricted from being certain ranks. For instance, Mutons are not allowed to be Medics, Leaders or Commanders. What will happen is that the game assigns a certain number of each type of rank normally assigned to each UFO, based on difficulty. These aliens will then be outfitted based on this INITIAL rank... so a few mutons on a supply ship will be destinied to become medics, and will be equipped with Small Launchers. BUT, these medic wannabes are then demoted back to Soldier, but will hang onto the Medic loadout. (similiarly, those muton soldiers carrying blaster launchers used to be leader/commander material)

----

These loadouts are useful to know, ESPECIALLY once you have psi, OR if you happen to get lucky and make the enemy forces panic... knowing which enemies can carry grenades, and which enemies do not carry grenades makes a lot of difference sometimes! An alien with its hands empty and standing on a Blaster Launcher or Small Launcher can be given low priority... shoot the more dangerous aliens first. However, a Heavy Plasma toting alien that dropped its weapons is HIGHLY dangerous, since it has just finished panicking, has gained 15 morale and has nothing in its armament except for an alien grenade... BOOM.

Also makes it much easier to capture that alien rank you were looking for! No more mind probing needed, just spot the alien carrying the Blaster Launcher!

Alien Weapon Loadouts

2013-02-23T10:26:36Z

Cfailde: grammar

<table {{StdCenterTable}}>
<tr><td width="120"></td><td width="30"><b>1E</b></td><td width="30"><b>2E</b></td><td width="30"><b>3E</b></td><td width="30"><b>4E</b></td><td width="30"><b>5E</b></td><td width="30"><b>1M</b></td><td width="30"><b>2M</b></td><td width="30"><b>3M</b></td><td width="30"><b>4M</b></td><td width="30"><b>5M</b></td><td width="30"><b>1L</b></td><td width="30"><b>2L</b></td><td width="30"><b>3L</b></td><td width="30"><b>4L</b></td><td width="30"><b>5L</b></td></tr>
<tr {{StdDescTable_Heading}}><th colspan="16">Small Scout</th></tr>
<tr><td align="left">Soldier</td><td>PP</td><td>PPC</td><td>PPC</td><td>MP</td><td>0</td><td>PR</td><td>PRC</td><td><div style="color:red;">PPC</div></td><td>MP</td><td>0</td><td>HP</td><td>HPC</td><td>MP</td><td>0</td><td>0</td></tr>
<tr {{StdDescTable_Heading}}><th colspan="16">Medium Scout</th></tr>
<tr><td align="left">Soldier</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>0</td><td>0</td></tr>
<tr><td align="left">Navigator</td><td>PP</td><td>PPC</td><td>MP</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>0</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>0</td><td>0</td><td>0</td></tr>
<tr {{StdDescTable_Heading}}><th colspan="16">Large Scout</th></tr>
<tr><td align="left">Soldier</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>HPC</td><td>0</td><td>0</td></tr>
<tr><td align="left">Navigator</td><td>PP</td><td>PPC</td><td>MP</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Engineer</td><td>PP</td><td>PPC</td><td>MP</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>MP</td><td>PRC</td><td>0</td><td>SL</td><td>SB</td><td>SB</td><td>SB</td><td>0</td></tr>
<tr {{StdDescTable_Heading}}><th colspan="16">Harvester</th></tr>
<tr><td align="left">Soldier</td><td>PP</td><td>PPC</td><td>0</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>0</td><td>0</td></tr>
<tr><td align="left">Navigator</td><td>PP</td><td>PPC</td><td>0</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>AG</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>HPC</td><td>0</td><td>0</td></tr>
<tr><td align="left">Medic</td><td>SL</td><td>SB</td><td>SB</td><td>SB</td><td>0</td><td>SL</td><td>SB</td><td>SB</td><td>SB</td><td>0</td><td>SL</td><td>SB</td><td>SB</td><td>SB</td><td>SB</td></tr>
<tr><td align="left">Engineer</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>0</td><td>0</td><td>0</td></tr>
<tr><td align="left">Leader</td><td>PP</td><td>PPC</td><td>AG</td><td>PPC</td><td>0</td><td>PR</td><td>PRC</td><td>AG</td><td>PRC</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>AG</td><td>HPC</td></tr>
<tr {{StdDescTable_Heading}}><th colspan="16">Abductor</th></tr>
<tr><td align="left">Soldier</td><td>PP</td><td>PPC</td><td>0</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Navigator</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Medic</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>AG</td><td>PRC</td><td>0</td><td>HP</td><td>HPC</td><td>HPC</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Engineer</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Leader</td><td><div style="color:red;">PRC</div></td><td><div style="color:red;">PP</div></td><td><div style="color:red;">PP</div></td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr {{StdDescTable_Heading}}><th colspan="16">Terror Ship</th></tr>
<tr><td align="left">Soldier</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>AG</td><td>PRC</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Navigator</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>HPC</td><td>0</td><td>0</td></tr>
<tr><td align="left">Medic</td><td>PP</td><td>PPC</td><td>AG</td><td>PPC</td><td>0</td><td>PR</td><td>PRC</td><td>AG</td><td>PRC</td><td>0</td><td>SL</td><td>SB</td><td>SB</td><td>SB</td><td>0</td></tr>
<tr><td align="left">Engineer</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Leader</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Terrorist 1</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td></tr>
<tr><td align="left">Terrorist 2</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td></tr>
<tr {{StdDescTable_Heading}}><th colspan="16">Battleship</th></tr>
<tr><td align="left">Soldier</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Navigator</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Medic</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>SL</td><td>SB</td><td>SB</td><td>SB</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Engineer</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>BL</td><td>BB</td><td>BB</td><td>BB</td><td>BB</td></tr>
<tr><td align="left">Leader</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td><td>BL</td><td>BB</td><td>BB</td><td>BB</td><td>BB</td></tr>
<tr><td align="left">Commander</td><td>HP</td><td>HPC</td><td>AG</td><td>AG</td><td>HPC</td><td>HP</td><td>HPC</td><td>AG</td><td>AG</td><td>HPC</td><td>BL</td><td>BB</td><td>BB</td><td>BB</td><td>BB</td></tr>
<tr><td align="left">Terrorist 1</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td></tr>
<tr><td align="left">Terrorist 2</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td></tr>
<tr {{StdDescTable_Heading}}><th colspan="16">Supply Ship</th></tr>
<tr><td align="left">Soldier</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Navigator</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Medic</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>SL</td><td>SB</td><td>SB</td><td>SB</td><td>0</td></tr>
<tr><td align="left">Engineer</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Leader</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr {{StdDescTable_Heading}}><th colspan="16">Base Missions</th></tr>
<tr><td align="left">Terrorist 1</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td></tr>
<tr><td align="left">Terrorist 2</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td></tr>
<tr><td align="left">Soldier</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Navigator</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Medic</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>SL</td><td>SB</td><td>SB</td><td>SB</td><td>0</td></tr>
<tr><td align="left">Engineer</td><td>PP</td><td>PPC</td><td>PPC</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>BL</td><td>BB</td><td>BB</td><td>BB</td><td>BB</td></tr>
<tr><td align="left">Leader</td><td>PR</td><td>PRC</td><td>PRC</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td><td>BL</td><td>BB</td><td>BB</td><td>BB</td><td>BB</td></tr>
<tr><td align="left">Commander</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr {{StdDescTable_Heading}}><th colspan="16">Mars 1</th></tr>
<tr><td align="left">Sect. Soldiers</td><td>PP</td><td>PPC</td><td>0</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>0</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>0</td><td>0</td></tr>
<tr><td align="left">Sect. Leaders</td><td>PP</td><td>PPC</td><td>0</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>0</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>0</td><td>0</td></tr>
<tr><td align="left">Sect. Comm.</td><td>PP</td><td>PPC</td><td>0</td><td>0</td><td>0</td><td>PR</td><td>PRC</td><td>0</td><td>0</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>0</td><td>0</td></tr>
<tr><td align="left">Cyberdiscs</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td></tr>
<tr {{StdDescTable_Heading}}><th colspan="16">Mars 2</th></tr>
<tr><td align="left">Eth. Soldiers</td><td>BL</td><td>BB</td><td>BB</td><td>BB</td><td>BB</td><td>BL</td><td>BB</td><td>BB</td><td>BB</td><td>BB</td><td>BL</td><td>BB</td><td>BB</td><td>BB</td><td>BB</td></tr>
<tr><td align="left">Eth. Leaders</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Eth. Comm.</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td><td>HP</td><td>HPC</td><td>AG</td><td>HPC</td><td>0</td></tr>
<tr><td align="left">Chryssalids</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td></tr>
<tr><td align="left">Silacoids</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td></tr>
<tr><td align="left">Celatids</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td></tr>
<tr><td align="left">Sectopods</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td><td>0</td></tr>
</table><br>

'''Table Key'''
:<div style="color:red;">Red entries indicate an error in loadout.</div>

:<b>E</b>=Early
:<b>M</b>=Middle
:<b>L</b>=Late

:'''PP''' = Plasma Pistol
:'''PPC''' = Plasma Pistol Clip
:'''PR''' = Plasma Rifle
:'''PRC''' = Plasma Rifle Clip
:'''HP''' = Heavy Plasma
:'''HPC''' = Heavy Plasma Clip
:'''SL''' = Small Launcher
:'''SB''' = Stun Bomb
:'''BL''' = Blaster Launcher
:'''BB''' = Blaster Bomb
:'''AG''' = Alien Grenade
:'''MP''' = Mind Probe

(all weapons start loaded)

DOS v1.4 data starts at byte 367014 in [[GEOSCAPE.EXE]]; entries are 21 bytes and correspond to the following (borrowed from [[User:Zombie|Zombie]]'s post [http://www.strategycore.co.uk/forums/Alien-Loadouts-Of-Weapons-t6441.html&view=findpost&p=77795#entry77795 here]):
:'''00''': Mission type (starts from 05 = Small Scout; goes to 15 (x0F) for Mars 2)
:'''01''': Alien rank
:'''02''': Base number of aliens on Beginner / Experienced
:'''03''': Base number of aliens on Superhuman (Veteran / Genius is the average of these two)
:'''04''': A random number from 0 to this number will be added to the above number of aliens
:'''05''': Unknown
:'''06-10''' (x06-x0A): Early game loadout
:'''11-15''' (x0B-x0F): Mid game loadout
:'''16-20''' (x10-x14): Late game loadout

NOTE!!! : Certain aliens are restricted from being certain ranks. For instance, Mutons are not allowed to be Medics, Leaders or Commanders. What will happen is that the game assigns a certain number of each type of rank normally assigned to each UFO, based on difficulty. These aliens will then be outfitted based on this INITIAL rank... so a few mutons on a supply ship will be destinied to become medics, and will be equipped with Small Launchers. BUT, these medic wannabes are then demoted back to Soldier, but will hang onto the Medic loadout. (similiarly, those muton soldiers carrying blaster launchers used to be leader/commander material)

----

These loadouts are useful to know, ESPECIALLY once you have psi, OR if you happen to get lucky and make the enemy forces panic... knowing which enemies can carry grenades, and which enemies do not carry grenades makes a lot of difference sometimes! An alien with its hands empty and standing on a Blaster Launcher or Small Launcher can be given low priority... shoot the more dangerous aliens first. However, a Heavy Plasma toting alien that dropped its weapons is HIGHLY dangerous, since it has just finished panicking, has gained 15 morale and has nothing in its armament except for an alien grenade... BOOM.

Also makes it much easier to capture that alien rank you were looking for! No more mind probind needed, just spot the alien carrying the Blaster Launcher!

Rulesets (OpenXcom)

2013-02-23T10:09:34Z

Cfailde: grammar and spelling

OpenXcom exposes its inner workings to users and modders in the form of a YAML text file called a ruleset (*.rul). These text files contain 'rules' that describe a wide variety of the game's behavior. Although rulesets can be edited with any text editor, such as Notepad, it is much easier to use a YAML editor.

__TOC__

==What is a ruleset?==
Naturally a ruleset is composed of rules, or groups of rules. Each rule describes a single thing about the game. A rule might describe what research projects become available after researching laser weapons, how much damage a pistol clip does, or the max flight speed of a Terror Ship. Rulesets are in YAML text files.

==Viewing and Editing Rulesets (YAML)==
Editing YAML is about as hard as editing an *.ini config file, though slightly more involved.

===Instructions for Nerds===
You can open any rulesets (or savegame files) in Notepad++ and select Language>YAML. Alternatively you could conjure up a Google search. There are YAML plugins for Visual Studio and Eclipse.

===Instructions for Noobs===
* Install Notepad++ or if you are on a Mac then get TextWrangler. If you are on Linux and you cannot find a YAML editor...
* Go to OpenXcom\Data\Ruleset and open a/the *.rul file. That means a file that ends with .rul; you may have to unhide filename extensions.
* In Notepad++ click Language>YAML. Otherwise if your editor does not let you collapse sections of the ruleset, try renaming the file to something that ends with .yml, as your editor may not recognize it as YAML.
* It should be pretty obvious how to change stuff at this point. You may want to make a backup before editing anything though.
* For further information there are plenty of sites that help explain YAML files; just search for .yml or YAML instead of ruleset, as rulesets are specific to OpenXcom whereas YAML is much more widely used.

====Note====
You should be able to use the vertical bar on the left of the editor to collapse regions of the rulesets file that you are not interested in. If not, then something is wrong. That is OK though if you do not mind scrolling past literally thousands of lines to get to the rules near the bottom.

====Your First Edit (Cheat)====
At the very top of the file you will see where the facilities list starts followed by a list of facilities and various attributes about them. Locate the living quarters facility and change the number next to "Personnel:" from 50 to however many people you think should actually be able to live in a living quarters (maybe 2000). Congratulations, you have just modded OpenXcom's living quarters to hold more people. Do not forget to save.

Interface Features (OpenXcom)

2013-02-23T09:39:46Z

Cfailde: typo

OpenXcom contains a whole lot of additional interface features, and more are being added all the time. This page is an attempt to list them all.
Eventually, most of these will be re-mappable via in-game menu or config file, but for now most are hardcoded. [[User:Moriarty|Moriarty]] 15:00, 7 February 2013 (EST)

== Geoscape ==
* mouse wheel: change zoom level
* radar range can be displayed for bases and craft. default toggle is "r" key
* in dogfight, craft weapons can be disabled/enabled by clicking on them

== Battlescape ==
* pre-mission equip screen: right-click grenades to prime before combat
* mouse wheel forward/back: change viewing level up/down
* mouse forward/back buttons (where present): switch to next/previous soldier
* tab/shift: switch to next/previous soldier (also in equip screen and pre-mission equip screen)
* right-click on a door when standing in front of it opens the door (like in TFTD)
* right-click to cancel a unit walking




== Basescape ==
* when assigning personnel for research or manufacturing, right-click the up/down arrow to set amount to maximum/zero
* when manufacturing, right-click on "Total to Produce" up/down arrow to set amount to 999 or 1, respectively
* in the lists for "Transfer", "Purchase/Recruit" and "Sell/Sack", use mouse wheel to scroll through the list, and right-click up/down arrow to set amount to maximum/zero
* in the list of soldiers on a transport craft, you can re-arrange the soldiers by clicking on the arrows. if you right-click an arrow, the soldier is moved all the way to the extreme end of the list
[[Category:OpenXcom]]

Alien Base

2010-09-12T13:55:51Z

Cfailde: /* Notes */ it's -> its

[[Image:Alien Base Mission.png|thumb|right|Alien Base mission type.]]Aliens will construct secret underground bases in remote locations. After some initial reconnaissance flights some intense [[UFOs|UFO]] activity will occur as the base is being built. These bases are known to contain experimental labs for human abductees, and supplies for further activity in the region. The presence of Alien bases will generate a large amount of reported Alien activity without the presence of UFOs. In order to locate a base, an [[Craft|X-COM craft]] must patrol an area for a few hours to stand some chance of detection. An [[Alien Base Assault]] will remove the threat but should never be taken lightly.

If successful the aliens will [[Scoring#Alien_Scoring|score]] 50 points, and an extra 5 points per day which is eventually subtracted from your score. Alien Bases add significantly to the Alien [[score]] when they are constructed and between that and the much higher UFO activity present will have neighbouring countries in particular very agitated, possibly leading to them reducing or withdrawing funding. As such Alien Bases in key areas will need to be dealt with somehow, while Bases in remote locations might well not be so critical to target for action immediately. <br clear="all">

There is no limit to the number of alien bases that can be built, but there is a limit as to how many can exist on the globe at the same time. Only fifty Geoscape Tokens (bases, waypoints, ships, etc) that can exist on the globe at any given time, and because you have to share this space with pretty much everything that you can interact with on the Geoscape, you can only have as many Alien bases as there are unused slots.

Note: UFO flight pattern investigation has found that the base is placed as soon as the battleship arrives in the atmosphere, so if it shows, the aliens have a base.

==Locating an Alien Base==
Alien bases do not show up on the Geoscape by default, they are hidden until you find them. To locate one, an X-COM [[craft]] must patrol in its vicinity for a short time. Also, X-COM agents may report a base location to you at the beginning of the month, but that shouldn't be relied upon.

There are several clues that indicate the presence of an alien base:
*A large UFO performing an Alien Base mission may indicate the creation of a base, or a preliminary scouting mission. Several UFOS running alien base missions simultaneously indicate the construction of a base, and the base may be built even if you [[UFO Interception|interdict]] all of those UFOs. See: [[Alien Missions]]
*An [[Alien Supply]] mission will always land directly on top of a base; patrol the location until you find it.
*For each nation that the aliens enter a [[pact]] with, they will also build a base somewhere in that nation's region-- but not necessarily within that nation's borders.
*Check your graphs for UFO activity by region. A spike of UFO activity in a given region probably indicates the construction of a base there.
*Alien bases are numbered by generation, not by detection. If you already have destroyed 3 alien bases before discovering "alien base 5" you should continue your search to find number 4.

==Goal==

There are 2 ways of destroying the base:

* Destroying the contents of the room on the second floor of the Command Center renders the base destroyed for all intents of a base assault. Specifically, you must destroy all 16 sections of the 4 purple octagonal tables (normally these are UFO Navigations). A single [[Blaster Bomb]] to the upper level will usually set off a chain reaction: if you hear 16 explosions in a row, you're all set. If you abort the mission after destroying the Command Center, the mission will end and the base will be destroyed. Be sure to move all your troops onto the green tiles in the "exit areas" on the upper level. Any troops not on a green tile (including those on the red lift tiles in the exit rooms) will be counted as MIA.
It is often much easier to infiltrate the Command Center by shooting through its walls (and ceiling) than by entering it via its doors and access lift. See [[Destroying Terrain#UFO walls]] for more details.

* Kill all the aliens. This method will of course give greater rewards, but is sometimes more difficult to achieve. Especially in the case of Chryssalids, Sectopods and Cyberdisks hiding in obscure distant closets, waiting to ambush your troops as you search for the last remaining stragglers.

== Recoverable Components ==

The components that can be recovered from an alien base varies, dependent on what modules are used in its layout (see [[Alien Base Terrain]]). Most of the recovery value from an alien base assault will come from recovered alien armaments. See [[UFO Recovery Values#Alien Base Assaults]] for more details.

==Alien Deployment==
<table {{StdCenterTable}}>
<tr {{StdDescTable_Heading}}><th align="left">Rank</th>
<th>Beg./Exp.</th>
<th>Vet./Gen.</th>
<th>Super.</th></tr>
<tr><td align="left">Soldiers</td><td>5-9</td><td>6-10</td><td>7-11</td></tr>
<tr><td align="left">Navigators*</td><td>1</td><td>1</td><td>2</td></tr>
<tr><td align="left">Medics* **</td><td>1</td><td>1</td><td>1</td></tr>
<tr><td align="left">Engineers*</td><td>1</td><td>1</td><td>2</td></tr>
<tr><td align="left">Leaders***</td><td>2</td><td>3</td><td>4</td></tr>
<tr><td align="left">Commanders***</td><td>1</td><td>1</td><td>1</td></tr>
<tr><td align="left">Terrorists</td><td>1-3</td><td>3-5</td><td>5-7</td></tr>
<tr><th>Totals</th><td>12-18</td><td>16-22</td><td>22-28</td></tr>
</table><br />

<nowiki>*</nowiki>Ethereals use Ethereal Leaders in place of Navigators, Medics, and Engineers.<br>
<nowiki>**</nowiki>Snakemen use Snakeman Soldiers in place of Medics.<br>
<nowiki>***</nowiki>Mutons use Muton Soldiers in place of Leaders and Commanders.

==Smash And Grab==
Alien bases can be a very quick and dirty (dangerous) way to get [[Elerium-115|Elerium]], using what we call the "smash and grab" mission. Raid them by seeking out the storage room with power units. Destroy the power units without using explosives, and pick up the purple Elerium canisters that were underneath. Boogie back to the entry lift, and abort the mission. You get the Elerium and the base is not destroyed. This means you can raid as often as you dare. Consider grabbing a few pieces of alien equipment on your retreat to replenish any spent equipment during the raid, and perhaps if you are lucky enough to knock out a high ranking alien, drag it back to the entrance to have it abducted.

'''Note''': Raiding the supply [[Supply ship]]s for a base rather then the base itself may be much more profitable. A base populated by docile aliens (floaters) in a convenient terrain (flat ice, flat desert) will have an easy to grab supply ships. The constant 150 - 900 elerium/month are well worth the 150 points penalty for letting the base exist.

If you want to do repeated Smash And Grabs on the same base, you must not destroy the base Control Center, and you must leave at least one alien alive in the base.

One tip is to knock out an alien, bring it somewhere safe where you can watch over it (such as the small storage rooms with the small grav-lift), then revive it with a [[Medi-Kit]]. Proceed to wipe out the rest of the aliens, but do not damage the command consoles in the command centre. As soon as the base is neutralized, initiate a recovery mission and gather as much equipment (and corpses, if you're really stretched for cash) in the green entrance pads before aborting the mission. Though this may seem time consuming, it does allow you to reap the rewards of a normal successful mission.

The mission will be counted as a technical failure, but that's nothing to worry about, as the activity points, loot and experience will tell you otherwise.

Many (or most?) alien bases will ''not'' have power units, or any Elerium. Recent research has shown that attacking a base's [[Supply ship|Supply Ships]] is likely to be more profitable (and less dangerous) than attacking the base itself, and a more reliable source of Elerium. See [[UFO Recovery Values#Alien Base Assaults]] for more details.

== Alien Base Tactics ==

=== Camper Strategy ===

The "camper" strategy exploits two quirks of the game: aliens cannot fire conventional weapons up or down through lift tiles, and will fall prey to the "[[Known Bugs#Collectors Edition Blaster Bomb Bug|Vertical Waypoint Bug]]". When the aliens attempt to fire [[Blaster Bomb]]s up the lift shaft, this bug will cause the bomb to travel south, not up, keeping your troops safe on the upper level. The vertical waypont bug only exists in the "Collector's Edition" (Windows) version of X-COM; the camper strategy cannot be safely used in any other version of the game.

Note that when your starting point is in the far south of the map this is not entirely safe. The aliens have about 10-20 shots of blaster bombs. Those are able to destroy even the earth terrain behind the base walls made of alien alloys. After 2 shots the alloys at the south wall of the lower level of the starting point are destroyed and the aliens begin to "dig" a new hallway. If this hallway reaches the edge of the map the blaster bombs following will fly off the map and then reappear on their next waypoint, which is located on the unit blocking the north west tile of the elevator. The result is obviosly the death of almost all of your units in that area and the destruction of any items located there. If your other starting point is for some reason not suitable for camping strategy (for example because no aliens are passing it or being located in the far south, too) abort the mission and try again.

To use the camper strategy, have all your troops retreat to the upper level of the access lifts (the green-tiled rooms). Position a soldier on each square of the lift on the upper level so aliens cannot use the lift to come up (this requires a minimum of 8 [[soldiers]] or 2 [[HWP]]s). The simplest thing to do is then wait until turn 20+, when all the aliens will exit their own encampments and mass on the lift squares below you. You can then shoot them. To reduce the chance of your troops accidentally shooting each other, have them only shoot at aliens located directly beneath them.

Camper tactics can also be used on other lifts found within an alien base, with varying degrees of effectiveness. Rooms which have only one entrance (including the control room) are best, as you do not have to guard your back. However, these rooms are dangerous to approach and clear of aliens in the first place.

Camping cannot be used in [[Sectoid]] or [[Ethereal]] bases unless your troops have extremely high [[Psionic Strength]] and are able to completely withstand [[Psionic]] attacks (especially [[Mind Control]]).

==== Camp and Scout ====

Instead of waiting, you can also choose to send a scout down the lift every turn. Have the scout turn in place to survey the immediate area; if any aliens are spotted, you can send other troops down to shoot or grenade them. Depending on how many [[TUs]] the alien(s) have left, your scout may get fired upon when descending the lift, or the other soldiers when firing upon the aliens. Dropping a [[Smoke Grenade]] in the center of the lower lift room can reduce the number of aliens that can see your troops while they scout.

If the coast is clear, you may wish to have soldiers retrieve nearby corpses or alien gear, so as to prevent them from being destroyed if a Blaster Bomb is set off in the room. You may come under fire from aliens that were not initially visible, however, and it is easy to miscalculate how many TUs are needed to retrieve items and return to the upper room.

==== Camp and Grab ====

After killing several aliens, most of the surviving aliens will panic. If you wish to use camper tactics during a "Smash and Grab" mission, it is easy to approach one of these survivors, stun him, drag him up the lift and use a [[Medi-Kit]] to revive him (don't use a [[Terror Units|Terror Unit]], as they have in-built weapons). You can then kill any remaining aliens you see and collect Elerium and whatever other goodies you wish.

==== The Perfect Base for Farming ====

All of the above leads to the conclusion that alien bases can be used for farming to pursue several goals: Collecting aliens, weaponry or ammunition, earning money, getting elerium, improving the monthly rating or for training soldiers (especially psionics).
As mentioned above [[Sectoid]] or [[Ethereal]] bases are not suitable.
Since [[Chryssalid]]s are both annoying and dangerous, [[Snakeman]] bases should be avoided.
This leaves [[Floater]] and [[Muton]] bases.
Since Mutons are very vulnerable to [[Psionic]] attacks they should be preferred.
They have another vital advantage: Since Mutons do not have leaders or [[Commander (Alien Rank)|Commanders]] there will be no units spawning with [[Blaster Launcher]]s in the command center. This ensures the aliens will not destroy their base (and your precious farming ground with it) by themselves.
Additionally, Muton bases are home to [[Silacoid]]s, which are tailor-made for [[Silacoid#Reactions_Training|Reactions training]].

Another point to consider is the location of the base on the [[Geoscape]]. One could easily think this is not important, but it is in fact. [[Alien Supply]] missions are ALWAYS within the same time window of the day. This means that raiding [[Supply ship|Supply Ships]] and getting all the weaponry and 150 units of [[Elerium]] from them is much easier when the base is located in an area where this time of the day brings daylight.
For [[UFO Ground Assault|UFO ground assaults]] the third factor is the kind of [[Terrain]] the base has been built in.

Conclusion: The perfect alien base for farming is:

- A [[Muton]] base

- Located in the area east of Germany and west of or in New Zealand (in this area anywhere between Arctic and Antarctic)

- Located in an area of your favourite [[Terrain]] for ground combat

If you plan to raid the landing Supply Ships, [[Floater]] and [[Snakeman]] bases will be perfectly fine, since you do not have to worry about terror units.

=== Mind Control Strategy ===

Once you have a large number of psi-talented troops, it is easy to win all combats with ease: Mind Control one alien, have it seek out others, then Mind Control any aliens it spots, and have them explore further. Disarm them, then line them up for slaughter.

==Notes==
*Somebody turned the lights out. Alien bases are dim, but your soldiers can still see pretty far without electroflares.
*Remember those [[Proximity Grenade]]s; you can't guard every intersection. (unfortunatly, a Chryssalid will almost unfailingly get blown up, shrug it off, and run up to perform its zombifying ways on your troops)
*The alien base will be staffed by the same race of aliens that ran the "alien base" or "alien infiltration" UFO mission that set the base up, and the aliens that run the "alien supply" missions to that base. See [[Alien Missions]] for more detail. They will have their associated terror units there.
*Alien bases populated with Snakemen deserve special caution. The high mobility of the [[Chryssalid]] makes it especially dangerous here -- it can run around three corners and still have enough time to infect your troops.
*The Alien Base Commander and a couple leaders will usually -- but not always -- be hanging around the Control Center. Expect some of them to have blaster launchers in the mid-to-late missions.
*Alien Engineers hang out around the Storage Loft sections. Many of them will be armed with blasters as well.
*Don't linger long in the rooms beneath the access lifts, and stay spread out at all times. There WILL be aliens with blaster bombs here, and they will be happy to use them on any clusters of your troops.
*If you are trying to capture a [[Commander]], be aware that before entering the inner door of the command center, if the commander and leaders are not killed or incapacitated before the end of the turn where the door is opened, they may fire their blaster launchers and kill themselves accidentally. Or, worse, they might fire their blaster launchers CORRECTLY, and kill off your entire squad.
*Also be aware that bases staffed by [[Muton]]s will never have a Commander; Mutons can only be Soldiers, Engineers, or Navigators. Just like the Battleship, you still have to contend with Engineers and Navigators armed with Blaster Launchers, though.
*Feel free to throw explosives around to open up the terrain, especially in those garden areas. It's your enemy's base, after all.

==See Also==
[[Alien Base Terrain]]

{{Mission Types Navbar}}

{{Alien Missions Navbar}}
[[Category:Missions]]
[[Category:Tactics]]
[[Category:Research (EU)]]

Known Bugs

2010-09-12T11:00:39Z

Cfailde: /* Unconscious Units are items */ it's -> its

== Game Destroying Bugs ==

These are the list of the worst bugs of them all, because they can render your entire game unplayable. Until a fix/ workaround is found, these bugs result in your entire X-com campaign being scuttled:
* [[Minimized interceptor bug]]
* [[Big text bug]]

== Base Construction Bugs ==

=== Base Disjoint Bug ===
Base facilities built along the right or bottom edges of the base building area may end up being cut off from each other by dirt walls, a bug in the routine meant to keep soldiers from accidentally exiting the map edges during [[Base Defense]] missions. The dirt walls can be knocked down by Blaster Bombs or excessive amount of heavy plasma fire during combat but are otherwise unbreakable.

[[image:bdb.gif|center|Base Disjoint Bug]]

The walls marked in white are removed if there is an adjacent module. All green modules are not affected while the yellow modules are. The red module will be sealed off completely if anything smaller than a hangar is placed here at any given time.

[[XcomUtil]] works around this problem by stripping out the walls entirely in all the base modules.

The bug can be profitable if the hangars and the lift are accessible only through in these areas - you can gather and supply all your soldiers heavily without aliens interfering, then knock a hole in the wall and cover the area with explosives and blaster launcher fire.

===Displayed Base Maintenance Costs===
Although X-COM charges the right monthly fees for base modules, the maintenance fee displayed ''in the base info screen'' is always wrong. The displayed number is actually based on the placement within the base grid, '''not''' the price displayed in the in-game UFOpaedia. However, at the end of the month, the right fee is deducted. For more information, see [[Base_Facilities#Displayed_Base_Maintenance_Cost_Bug]]. The Geo finance Graph shows a correct maintenance summary ([[LIGLOB.DAT]], updated once a month). Also see the next section.

===Paying For Dirt===
If you take down any facility in any base that you own and leave bare dirt, then you will continue to pay maintenance on it. But not at the old rate of whatever the facility cost per month, filling the hole back with dirt means it needs special attention at all times by specialists. In fact for every square of dirt you have that used to be a facility you will pay 80k per month. Thats 320k per hangar you take down. There are only two known ways to stop paying this premium - if you completely dismantle the base you stop paying any money for it, or if you build over all the spaces that you have vacated. In fact as soon as you start building the new facility you stop paying the premium, as well as not having to pay the cost of the new facility until it is complete.

If you start a facility and change your mind before it is complete, after the time when it would have completed you will start paying this 80k premium on that land as well.

===Base Facility Dismantle-Construction Crash===
In the Collectors Edition version, dismantling a facility while its construction is in progress can cause a crash when a second facility on another base square completes its construction. To work around this, dismantle a facility only after its construction is complete. If you have already dismantled such a facility, build something like a general stores on the same square to avoid the crash. It is not known if this crash happens intermittently or always, or if it happens on most versions of the game or just the Collectors Edition.

===Radar Stacking===
Despite the "Short Range" and "Long Range" detection bars displayed on each base's Information screen, only one radar of each type will be used at each base. Building additional radars of the same type will have no effect. One short and one long are useful until the [[Hyper-wave Decoder|Hyper-Wave Decoder]] makes both of them obsolete.

===Phantom Radar===
When you dismantle detection equipment such as a radar or hyperwave detector, the related detection ability of the base does not decrease until a new facility of some kind is built in that base. Until a new facility is completes building at that base, the base continues to use this "phantom radar".

This bug allows you to "upgrade in place", for example building a new Hyper-Wave Decoder over the top of an existing Large Radar, and retaining the detection capability of the Large Radar until the Hyper-Wave Decoder completes building. (Unless something else completes building first).

===Fixes for Base Construction Bugs===

As mentioned above, [[XcomUtil]] prevents the Base Disjoint bug (crudely). The [[User:Spike#Base_Fixer|BaseFixer]] utility corrects the Paying for Dirt, Phantom Radar, and Radar Stacking bugs. BaseFixer can be used manually on saved game files, or automatically via XcomUtil's hook mechanism.

==Geoscape Bugs==

===First Radar Detection Data bug===
When a UFO is detected by a radar, you get certain data on it depending on the type of radar that detected it. If the UFO later enters the range of another radar while staying in the range of the first, you will continue to get the initial data given, even if the new radar is more powerful than the first! So if you detect a craft with a [[Small Radar System]], then the UFO moves into the range of a [[Hyper-wave Decoder]], clicking on the UFO will only give you the data as if the Small Radar detected it, so long as it remains in the Small Radar range! In effect, the data you get about a UFO is determined when you first detect it, and not changed after that until you lose detection on the craft with the radar that first detected it.

This bug most commonly shows up when a UFO is first detected by a patrolling aircraft and then remains in the range of the aircraft while also entering the range of a Hyper-Wave Decoder.

=== Minimized Interceptor Bug ===
One fairly consistent cause of crashes is saving the geoscape game during a UFO standoff, with a [[UFO Interception]] window minimized to an icon. The next mission after that point will likely dump you to the green text screen, and perhaps an earlier battlescape mission instead of the proper one. What it seems to do is zoom back out of the combat too far when the fight is over, eventually causing the crash once it has gone a couple of steps further than it normally allows you.

'''Solution:''' Open up [[UIGLOB.DAT]] in a hex editor. Change hex offset 0x06 to 00. This will reset the number of minimized interceptor windows to zero. Your interceptor unit can be selected to either return to base or continue on to complete its ground assault mission. ''NOTE: Make sure to back up your save game before editing it.''

''-- I was able to recover from this state by quickly sending in another interceptor ([[Firestorm]]) to take over, which allowed my first interceptor ([[Avenger]]) to break off and go home without crashing the game again. After the shootdown I overwrote the buggy savegame. --[[User:JellyfishGreen|JellyfishGreen]] 03:11, 22 Aug 2005 (PDT)''

''This happened to me also. I fixed it by replacing "[[UIGLOB.DAT]]" in the save folder with the same file from another saved game (from the same campaign a month earlier) [[User:bylund|bylund]] 00:15, January 12, 2007 (GMT+01)''

=== Interceptions: Last Shot Always Misses ===
When using Cautious attack when [[UFO Interception|intercepting a UFO]], your craft will stay at the maximum range of your longest-range weapon. When using Standard attack, your craft will stay at the maximum range of your shortest-range weapon. (Usually players use two weapons of the same type, so Cautious and Standard attack will behave the same in this regard.)

As soon as the craft fires its last shot (expending all its ammo), it will drop back to "Standoff" range (70km). This will make it appear that the UFO has backed away while the last missile(s) are in-flight, causing them to miss.

In order to hit a UFO with your last salvo of missiles (Stingrays, Avalanches, or Fusion Balls), you must switch to "Aggressive" attack before the last salvo reaches the UFO. This will cause your craft to close in with the UFO, allowing the missiles to be in range when they reach the UFO. However, Aggressive attacks will also bring you within range of the UFO's weapons, so you should hit the "Disengage" button as soon as the last salvo hits.

===Elerium-fueled Craft Bug===
A [[Skyranger]] or [[Interceptor]], once dispatched, will return to base when its fuel supply has dropped to a level that it will only have just enough fuel to return to base. Craft fueled by Elerium-115, however, will always report the "Low Fuel" message as soon at the fuel supply is 50% depleted, no matter where they are on the globe. This significantly shortens the already minute time that a [[Firestorm]], [[Lightning]], or [[Avenger]] can be dispatched to patrol.

===Floater Medic Research Bug===
Every single time a Floater Medic is found and researched, the game crashes after it is interrogated! I [[muton commander]] used a hack system to view the alien's profile, and it was a Commander with no race attached. This is probably the cause, but I have no explaination for why this situation occurs.

== Battlescape Bugs ==

=== Faulty Large Units ===
If you move a tank off a northward facing ledge, the rest of the tank will sink into a wall (if there is one), and cause the tank to get stuck. This won't happen if the tank moves off a south facing ledge as the primary quarter will fall after the rest of the tank. Aliens can also get stuck this way.

Another, potentially annoying bug occurs when a large unit's graphics become messed up. During a base defense mission, a rocket tank may end up looking like 4 silacoids bunched together.

===Unconscious Units are items===
This is actually an intentional programming choice... but it leads to several consequences which are bugs.

Firstly, any unconscious unit can be killed instantly by even a weak explosion, like being nearby an exploding AC-HE shell... even a Muton with 125 Health or an X-com agent in Flying Armor whose high armor ratings normally make him immune to AC-HE damage.
Secondly, no experience is gained for killing enemies in this manner.

You can prevent an unconscious unit's death from an explosion by picking it up... if a blaster bomb strikes the carrier and kills him, the unconscious unit will safely fall to the floor, unharmed.

Unlike a conscious unit (not wearing x-com armor), an unconscious unit can laze about in the middle of a fire without taking damage, since a UNIT standing in fire takes damage, but an unconscious unit is an item, which all ignore fire.

Forcing an MCed alien to pick up an unconscious X-com agent and carry him in its right hand can cause weird things to occur when you release the mind control. I think the game might crash when the alien tries to shove the agent into its magic pocket.

If a non-flying unconscious unit wakes up while being carried by a flying unit, it will gain some sort of temporary hover ability. (I once placed an unconscious Chryssalid in my flying agent's backpack. A few turns later, some growls and screams were heard from overhead.)

Save space! Each conscious unit takes up 1 tile (4 tiles for large units). An unconscious unit does not use up the tile... this might conceivably be useful if you wanted to abort a mission, but several panicked units were preventing other agents from boarding the skyranger...
X-com agents refuse to ride piggyback or be picked up while conscious. So, if you want a non-flying unit to reach an 2nd floor place with no stairs or elevator, you will have to knock him out, then either throw him up, or have a flying unit pick him up and drop him... and presumably administer stimulant.

This also leads to the INVISIBLE UNIT glitch. Frequently happens during Base Defence missions, since the item table is usually maxed out. Basically, the item table is so full that killed units do not leave corpses. However, this also means that unconscious units do not turn into the Unconscious Unit item. The KOed unit will disappear from sight, but will still be visible as a red number and as a blue/yellow dot on overhead map. Since the unit is still a unit and not an item, you will be able to shoot it with projectile weapons and kill it. ALSO, this method enables you to raise any unit's stun bar all the way to 255, since you can still increase the stun meter, despite them already being unconscious.

===Funky Fire===
If a unit (alien or friendly) is on fire or standing in flames, an [[Incendiary]] explosion ''anywhere else on the map'' will do a small amount of damage to it, even if you just shoot an IC round at a random patch of ground.

Similarly, if a unit (friendly units only) is standing in smoke when an incendiary explodes, it will take stun damage. This makes the combination of incendiary munitions and smoke quite hazardous until such time as all troops are armored.

There is a [[Talk:Incendiary#Incendiary_Bug|working hypothesis]] for the cause of this bug, which is that each and every Incendiary explosion triggers "end of turn processing" for Smoke and Fire - including fire damage, stun damage from smoke, fire spreading checks, and possibly "catch on fire" checks for units in fire.

Note that X-Com units wearing any kind of armor are immune to fire damage and IC-induced stun damage. Xcom HWPs are immune to stun, but take 40% damage from Incendiaries and WILL get killed quite efficiently by funky fire.

=== Collectors Edition Blaster Bomb Bug ===
In the Collectors Edition of UFO, the [[Blaster Launcher]] has a bug that prevents it from going up or down on the same tile. Or in other words, you cannot change the elevation of the missile vertically on the same tile.

Instead of flying down (or up) to the next waypoint, it will instead fly directly to the south at the pivot waypoint. Relative to the screen, this would be the lower left side of the screen.

This does not happen if you plot the waypoints at an angle. Or, if the blaster bomb flies right off the map, it will reappear at the proper waypoint as long as there are additional waypoints placed after the vertical move.

This bug also applies to the [[Disruptor Pulse Launcher]] in TFTD.

===Blaster Launcher Dud Shells Bug===

Shots which have only one waypoint, or explode before reaching their first waypoint, leave the Blaster Launcher showing 0 rounds, but still containing a dud shell which must be unloaded before the launcher can be reloaded. On earlier versions of the game (pre-Win CE) this also happens with reaction fire, and with 1-waypoint shots that fly off the map.

=== The trouble with Mines in General ===

Proximity mines are strangely implemented in UFO and TFTD. While they behave as you would expect them to half of the time, the mines do not behave like conventional weapons.

First, experience attribution is awarded to the person that sets off the mine.

Secondly, the armed states for [[Proximity Grenade]]s in both UFO and TFTD are NOT stored in save games. If a proximity grenade is primed, then the game is saved and reloaded, the grenade will not only not go off as it should, but the "Prime Grenade" action will still be absent, so it's impossible to re-arm it.

=== Grenade Timer Behaviour ===

Primed grenades will not explode when it's in your inventory when the timer runs out. It will only detonate when it's on the ground. If your soldier falls unconscious or gets killed, the grenade will be counted as being on the ground. Then it will blow up, likely taking out your gear and body. This 'feature' allows for the hot potato or [[Grenade Relay]] strategy which is fairly unique to X-COM where a live grenade well past its use-by date can be passed from squad member to squad member. It could also be used against Chryssalids:
* Soldier is turned into a Zombie.
* Equipment is dropped to the ground.
* First grenade goes off, killing the Zombie (and the offending Chryssalid, if it's still around).
* Second grenade goes off, killing the newly hatched Chryssalid. (<i>Zaimoni: assuming the second grenade is <b>around</b> to explode. Reportedly works better in TFTD.</i>)

So when you enter an area with high risk of Chryssalid attacks (terror site or Terror ship/Battleship crash site), have every soldier arm a grenade which serves as a dead man's switch to eliminate Chryssalids. You lose a soldier or two, but the aliens don't gain anything and there's one less candidate for zombification (and, if you are lucky, one less Chryssalid if it was around the victim when the grenades exploded).

For a more a detailed explanation on detonation conditions, see [[Understanding Grenades]].

=== Mountain Map ===
Due to a bug in the way this tileset was created, when you shoot the ground, it doesn't burn up - it turns into a tree stump.

Because the stump is on object, as opposed to actual ground, any objects that were in the tile already (for example, UFO hulls or the landing gear of your craft) get replaced by these stumps, making it seem as if they were destroyed.

Tree stumps don't take much damage, so they often get burnt up immediately if an explosive goes off, leaving nothing but burnt ground behind. It is easier to view the effects of this bug by shooting the ground instead.

For more details, see [[Explosions#Mile-High_Madness|Mountain Madness]].

=== What just exploded? ===
In some versions of the game, a bug allows an armed proximity mine to transfer its properties to some other item in the next mission, which then may explode unexpectedly. (If the item is left on the floor of the XCOM craft, it will explode as you walk past it.) This problem can be rectified by reloading the game -- as a precaution, save before you move your first soldier.

=== Door jam ===
If a door is open when a game is saved on the Battlescape and that game is subsequently restored, the door will remain open for the remainder of that mission.

===Mind Controlled Soldiers go MIA===
If you complete a mission while a [[soldier]] is currently [[Mind Control]]led he will be listed as MIA at the end of the combat. This is quite an easy bug to fall into as on any [[Sectoid]] or [[Ethereal]] mission the only, or most powerful, psionic aliens will usually be holed up in the bridge or command centre.

===Mind Controlled Aliens Count as MIA if you Abort===
If you happen to abort a mission with any Mind-Controlled aliens under your control, who are NOT in the dropship, the computer tallies them up as "X-COM Operatives Missing In Action." Thus, every Mind Controlled alien left behind when you dust off is -20 points to your score! If you're leaving anyways, avoid this by bringing them back to the ship or mowing them down on the way back to the ship.

In the Playstation version of the game, any aliens under Mind Control at missions end are considered captured and hence, this bug is not a factor.

===20 Proximity Grenade Limit===

The array used to denote armed [[Proximity Grenade]]s is limited to 20 entries, meaning you are limited to 20 active mines at a time. The 21st and subsequent Proximity grenades can be primed like normal and will give appropriate messages, but they will not detonate even when the normal trigger conditions are met. Note that Proximity Mines that have detonated or otherwise been destroyed are removed from the array, freeing up positions; the limit is 20 ACTIVE Proximity Grenades at one time. In normal gameplay, this is probably not a restriction, in light of the [[Known_Bugs#80-Item_Limit|80 Item Limit]], since you'd need to have more than 1/4th of the cargo space in the dropship filled with Proximity Grenades.

===Base Defense Elerium bug===

On DOS versions of UFO Defense, Elerium pods may spawn as items from the base stockpile during a Base Defense bug. Each pod represents 50 units of Elerium and will be normally collected after the mission, same as any other item such as Heavy Lasers or Blaster Bombs. HOWEVER. The program will potentially generate 1 elerium POD for every 1 UNIT of elerium in your inventory. Thus, if you had only 10 lasers and 50 Elerium listed in your Sell screen, you would see 10 lasers and 50 Elerium Crystals in your Soldier Equip Screen, which would translate to 50 Elerium pods and 10 lasers scattered around your base. This equals 2500 Elerium, BTW. You basically have the potential to multiply your elerium stocks by 50 times.

===Berserk HWP crashes the game===

Admittedly, this is unlikely to arise under normal play. But, anyhow, your HWPs can only lose morale by killing friendly units. Not much for each unit killed, either. Anyhow, a berserk HWP will crash the game. (except for the Hovertank/Launcher, which does not fire when it goes berserk.)
Likewise, if you MC a cyberdisc or Sectopod and have it kills lots of aliens, it'll go berserk and crash the game. The error happens because of an oversight from the developers: the built-in weapons of HWP are handled differently from handed weapons, no OBDATA.DAT entries exist for them. The berserk code will try to access the nonexistent entry, resulting in a crash. The Celatid has yet to be tested.

===Limited Unit Slots - Battlescape Crash===

This tends to arise during Base Defence Missions. The game is was designed to be limited to 40 soldiers/hovertanks and XXXX aliens for a total of XXXX . Having a full complement of soldiers during a Superhuman difficulty base defence will max out these limits. Thus when either side starts playing around with mind control too much, something goes wrong causing the entire game to crash.
It might also be something to do with maximum items on the battlescape.
In any case, the workaround seems to be killing aliens and destroying items on the battlescape... doesn't always work, but it seems to help.
You might want to make several in-battle saves for these situations, even if you normally play Ironman mode.

== Character Inventory Bugs ==

=== Alien Inventory Stacking Bug ===

'''WARNING:''' When examining an Alien's inventory (via an Exploit), you will see that sometimes the alien will stack multiple items of equipment on the same slot - its right leg. It's not always obvious that there are multiple objects in the slot until you 'pick up' the first object and can see other objects still in the slot.
Before you remove an item from the Alien's right leg, make sure you have enough time units to place it somewhere else. If you run out of time units, you will likely have to force a quit and cannot save your game. It '''may''' be possible to move the item to the left leg slot for 0 TUs, '''if''' the item will fit in that slot. If not, you will have to terminate the game. (Press ALT-TAB to get to any other window, then CTRL-ALT-DEL to bring up Task Manager, and then terminate the process that corresponds to the game).

=== XComUtil Inventory Stacking Bug ===

A problem similar to the Alien Inventory Stacking Bug can also occur for X-COM Soldiers, when using XComUtil. The algorithm used to assign weapons in XComUtil MUST assign all weapons to troops, so if there are more weapons than soldiers, excess weapons are stacked onto the leg slot of the first soldier in the dropship. This was a deliberate choice by Scott Jones to make this encumbrance obvious to the player. This can be readily corrected in the "equip soldiers" screen before a mission. Else, see "Alien Inventory Bug", above.

=== Item-stacking Bug ===
It is possible to put more than one item in a given spot. When an item is stacked with a [[Stun Rod]], this can make it possible for X-COM soldiers to perform "melee" attacks. See [[Item Stacking Bug]] for more details.

===Carrying Unconscious Units===
If one of your soldiers is carrying an unconscious unit in their hands and the unit either wakes up from stun or dies, they will be removed from the Inventory display, but will still appear to be in the carrying soldier's hands in the Battlescape. Clicking on the phantom body in the Battlescape will crash the game!
This error can be easily cleared by switching to the Inventory screen and moving another item into the hand that used to be carrying the body. Even swapping the gun to the other hand will do. Refer to : [[Unconscious#Bug|Unconscious]].

===Disappearing Ammo===
Partially-used clips in alien or X-COM weapons disappear at the end of a mission. This dictates that you should try to use clips that are not full. However, in DOS versions of the game, you can unload used clips to recover them as full clips with the tradeoff of all loaded clips (used or otherwise) will count as spent and disappear (this shouldn't seem to be a problem, until you start using blasters and will find that you're running out of ammo fast). You can also use [[XcomUtil]] to recover partially used clips. Even when used clips are discarded, you will still get credit ([[Scoring|score]]) at the end of missions for recovering them.

When aborting a mission, any full clips loaded in any alien weapons brought back to the transport/access lift will not be recovered unless the clips are unloaded first. This includes [[Blaster Bomb]]s and [[Stun Bomb]]s.

===Weightless Loaded Ammo===

Ammo that is already loaded into a weapon at the start of a mission does not count towards a soldier's Encumbrance. If the weapon is subsequently unloaded and reloaded during the mission, the soldiers encumbrance will increase. This would only be noticed if the unloaded clip was not discarded (e.g. because it was not fully empty). This is due to a bug in the game's weight calculation routine that was uncovered (but not caused) by Seb76's inventory screen improvements.

=== Equip Phase Ammo Load Error ===

It looks like the game routine for placing ammo into weapons at the beginning of the equip phase does not correctly set all values. It should set the ammo as loaded into the weapon, the weapon as being held by the soldier, and the map position of the weapon and the ammo as the same as the soldier. Looks like it does not do one or more of these things. Whatever values the game doesn't set, do get set if you manually load or reload the weapon, either during the equip phase, or during the game.

Probably the only impact of this bug is that XComUtil can't detect the fact that the ammo is loaded into the weapon, for the purpose of AutoCombat. It might have other subtle effects on any utilities that deal with equipping soldiers. [[User:Spike|Spike]] 20:03, 11 March 2010 (EST)

Specifically, the game's auto-equip functions at the beginning of the equip phase fail to set offset 0x04 of the [[OBPOS.DAT]] record to point to the soldier who owns the ammo. These functions leave the value = 0xff, which implies "on the ground". They also leave the ammo location as being the equipment pile, rather than the location of the soldier. The other values are set correctly. Manually loading ammo into a weapon, during the equip phase or during combat, correctly sets all values. The ownership points to the soldier and the location to the soldier's location. [[User:Spike|Spike]] 20:03, 12 March 2010 (EST)

== Storage and Transfer Bugs ==

=== 80-item Limit ===
When loading up your Avenger for a massive UFO assault or arming soldiers for a [[Base Defense]] from your overflowing stores, you will likely hit this limit.

You only get a max of 80 items, and you don't get to choose which ones, so you may end up with 80 clips and no rifles for the base defense.

The solution is timely housekeeping. Sell off your spare personal equipment. See our handy [[Spring Cleaning Tips]], and also [[Managing the Item Limit]] for ideas.

Another bug concerning this limit happens when there are unresearched (alien) items in your stores during a base defense mission. Even though the item cannot be used during the mission, the game still allows you to equip your soldiers with them. This rarely happens as the alien items are very low on the item list, but if your base is lean and mean with under 80 items total, everything will spawn regardless of research.

===Sticky Craft Transfer Fee glitch===
As pointed out by [[User:Zombie|Zombie]] and [[User:Danial|Danial]], transferring any craft causes '''''all subsequent transfers to have that cost added to it''''', for as long as the craft is in transit. Additional craft in transit will add additional fees. (This has also been called the Exponential Transfer Fee bug, although it's actually additive, not exponential.)

Example (all numbers are only approximations):
<u>Cost of pistol transfer (↔ = to or from)</U>
EU ↔ USA 80
EU ↔ Asia 100
USA ↔ Asia 120

<u>Cost of craft transfer</U>
EU ↔ USA 1600 ''Notice how transfer fees always work as relative percents,
EU ↔ Asia 2000 ''probably on a distance-based formula
USA ↔ Asia 2400

<u>Cost to transfer '''pistol''', after transferring craft from EU to Asia for $2000</U>
EU ↔ USA 1680 (80+1600)
EU ↔ Asia 2100 (100+2000)
USA ↔ Asia 2520 (120+2400)

The cost of the craft transfer "sticks" to '''all''' subsequent transfers, until the craft arrives - although it acts on a proportionate basis, which is probably distance related.

Unfortunately, this cost is '''additive'''. That is to say, if you transferred a second craft from EU to Asia while the first was still in transit, it would cost $4000 ($2000 plus $2000 - it too suffers from the glitch!), it would then cost e.g. $4100 to transfer a pistol from EU to Asia. Having even more craft in transit would add even more fees.

This only appears to happen with aircraft, although it does happen for them all. So try to transfer aircraft individually, and not transfer anything else while you do - assuming you aren't awash in money. (The bug will cost you in the low thousands of dollars per craft being transferred.)

A related problem is that, if you are in the Transfer screen, start to transfer a craft, and then cancel because you remembered you wanted to send something else first - if you then try to Transfer something on that same screen, ''it will still get the sticky craft fee added''. Try it and see. You have to back up out to the main Base screen and hit Transfer again, to get rid of the sticky fee from a canceled craft transfer.

===Fuel dump on transfer===
Transferring a craft with 100% fuel will dump it somewhere along the way.
When it arrives at its destination, its fuel gauge will read empty (ie: 0% FUEL), but it will be listed as ready. If you launch your craft for a mission (any mission will do) its fuel gauge will still read empty.
<br>
This can be [[ExploitsA#Infinite_Fuel|exploited]], but it is very annoying if you want to quickly turn around a troop transport for another mission.
<br>
You can force a refuel by sending out the craft and immediately recalling it back to base.

===Transfer Limit cash eater===
Only 100 items can be in transit at a time. (Here, a transfer of e.g. 200 Elerium counts as one "item". Also, all soldiers are counted individually.) If you go over the limit, you will get a warning that there is no more transport capacity. If you STILL try to transport something after getting the warning, the item will stay where it is, but the transportation cost still gets deducted. Bad if you're shuffling expensive aircraft. The extra cost isn't that bad. Recovering just one alien weapon will likely cover the money you will lose to this bug over the course of a game.

{| {{stdTable}} width = "80%" align = "center"
|- {{stdTable Heading}}
| Tip
|-
| To Clarify what constitutes an item in the transfer screen, think of them as batches of X amount. For example, if you transfer 200 alien alloys now, and then decide to transfer another 50 alloys later, this will count as two items in transit. Now, when you look at your transfers, you'll now have two items. Two batches of alien alloys, one with 200 units and the other with 50 units.
|}

=== Transfer crash ===
If you transfer something to another base the game crashes right after acknowledging the transfer price.

Solution: Start UFO, select English language, finish your transfer, save game, restart with your normal language settings (http://www.xcomufo.com/x1faq.html)

===Purchase Limit===
The purchase limit for any item you buy via the purchase screen is 255 per line item, because it is a one-byte field. However, the impact of this bug is small, for if you have space remaining in your 100-item transfer queue, you can immediately order another 255 of said item as another line item.

===Storage Limit===
You can not store more than 9,999 of any one item in the general stores at a specific base at one time. However, this will likely only happen with [[Alien Alloys]] or [[Elerium-115]].
Still, consider yourself warned. If you're coming close to the limit, consider transferring the extra to other bases or even selling it, as any extra collected beyond the limit will 'disappear' and be wasted.

===Exceeding Storage Limits===

The storage capacity of a base is normally limited by the capacity of the General Stores. However this can be exceeded in a number of ways:

* By exploiting some of the Base Storage Anomalies (see below)
* By storing surplus equipment in transport aircraft (up to the 80 item limit). Note that if both the aircraft and the base are full, you can no longer move equipment between the aircraft and base (in either direction).
* Anything manufactured at the base will be stored there regardless of the base's General Stores capacity.
* Anything captured on a mission by an aircraft operating from the base will be stored at the base, regardless of the base's General Stores capacity.

These could perhaps be considered minor exploits.

===Base Storage Anomalies===

There are some quirks in how the game calculates, and displays, base storage capacity used and available. These quirks are not all consistent with each other, which leads to some strange behaviour. A typical example would be moving a set of items out of Stores, immediately trying to put the exact same set of items back into Stores, and this failing due to "insufficient space". A more detailed discussion is in [[Talk:Base Stores#Base Stores Anomalies]].

== Soldier Limits and Recruiting Bugs ==

=== Soldier Recruiting Limit ===

There is a hard limit in the game of 250 X-COM soldiers in total across all bases (not 250 per base).

The error message that pops up when you try to hire more is:

"NO MORE SOLDIERS ALLOWED"

"You have already recruited the maximum number of soldiers."

=== Soldier Recruiting Bugs ===

Also there are 3 bugs related to recruiting soldiers:

* You still get charged for Soldiers you try to purchase above the No More Soldiers limit.
* The error message that appears when you hire too many soldiers must be dismissed (click OK) once for each soldier over the limit, i.e. up to 255 times.
* You get also charged for Soldiers you try to purchase above the Transfer Limit (100 at a time).

=== Soldier Battlescape Limit ===

In the Battlescape, there is a limit of 40 X-COM soldiers that can participate in any battle. Tanks/HWPs each count as 4 soldiers against this limit. Unless you use custom-modified aircraft, you will only see this limit in a Base Defence mission. In a Base Defence mission, all tanks/HWPs will be deployed first, in preference to soldiers.

== Manufacturing and Research Bugs ==

=== Cancel Manufacturing Bug ===

If you start a project with 1 or more items to build, the required cash (and any materials) for the first item will instantly be taken from you. If you cancel the project before the job is done, or reduce the number of items to produce, you will still not be refunded the initial costs of the first item.

(Possibly this is exactly the behaviour the designers intended, and not a bug at all.)

=== Zero Unit Manufacturing Exploit ===

If you start a manufacturing project with zero items to build, close the screen, and then go back to assign staff and a non-zero build amount later, the first item is built for free. If you only build one item at a time, you can build them all for free. Obviously, this is cheating. It's also a bit tedious. It might be excusable if you're really short of money.

=== Research Rollover ===

Whenever research completes, you are given the opportunity to re-allocate your scientists' efforts onto a new topic. If the new topic is after the topic that you have just completed (further down toward the bottom of the screen), the new effort of the scientists you allocate is applied immediately, on the same day - even though they were just working on the previous project that completed.

If you have enough scientists available to complete the new project in one day, this process can be repeated indefinitely, to complete multiple topics in one day. Each new research topic must be further down the list than the previous research topic, or the bug/exploit does not work.

By the way, this means that you should not worry about "wasted" research effort due to allocating too many scientists to a project on its last day. The chances are you will gain more free research from this bug than you will lose from "wasted" research effort.

=== TFTD Research Tree Bug Avoidance Guide ===
TFTD's research problems are more of a logical design flaw than a true bug, caused by trying to make the research tree more complicated than X-Com UFO.
They can be a pain when you research the wrong thing at the wrong time.

A variation of NKF's [[TRTBAG | TFTD Research Tree Bug Avoidance Guide]] will be forthcoming - free time permitting.

For now:

*ONLY research Deep One Terrorist AFTER you have completed Plastic Aqua Armor and Ion Beam Accelerators.
*You MUST have at least one "Sub Construction" in storage before completing research on Zrbite and/or Transmission Resolver.
*NEVER research the Tasoth Commander. There's no reason to - and as of the last patch, they should no longer appear on the research list. They can block the T'Leth research.
*DO NOT research M.C. Lab unless you have AT LEAST one MC Reader in storage.
*NEVER sell all of your Sonic Pistol Clips before researching it first. If you were to research the Sonic Pistol, the aliens immediately stop using that weapon (and thus, clip) so you will be unable to continue in the Sonic line of research.
Any of the above (other than the MC reader) would make it impossible to finish the game.

=== Overcrowded Engineers And Scientists ===
In the Dos version (probably the others as well) if you hire more than 255 engineers in a single base, the number of engineers in the base will read a negative number once the 257th engineer arrives. Any Engineers engaged in projects will continue to work on them, but if you cancel the project you will lose engineers until you have lost 255 of them.
This bug also affects scientists. It may be exploitable to pay a negative salary at the end of the month.

If you hire exactly 256 scientists or engineers, the total rolls over to zero. You pay zero salaries, and the resulting free Manufacturing / Research is limited only by the capacity of your Factories / Laboratories. Also works in TFTD.
<br>
NOTE: you need to make sure that not all of their projects finish at the same time.
Otherwise, you would be stuck with 0 'available' workers/scientists, i.e. unable to assign them to a new project.

===Manufacturing Limit Bug===
The number of hours remaining on a [[Manufacturing_Profitability#Profit_tables|manufacturing project]] is stored in a two-byte integer. If you build enough items that the total number of Engineer Hours required for construction is above 65535 hours, it will wrap around to 0 hours and display from there. Typically this drastically understates the amount of time that will be spent working on the items, but strictly speaking, it only subtracts 65k hours (so a huge project like 120k hours would still show ~55k hours' worth of Engineer time needed).

This bug is not dependent on the number of engineers assigned to the project; it is a function of the number of engineer hours needed. You will most likely run into it when trying to build 2 Avengers at the same time or when queuing up large orders of items in bulk, such as armor or Laser Cannons. As a practical example, the number of Avengers needed to trigger the bug is 2. The number of Laser Cannons is 219. Toggle back and forth between 218 and 219 laser cannons at the beginning of a project to see the effects.

It is known with certainty that this exists as a display issue - the screen will say you need less time than you should when you go over 65536 Engineer hours. [[User:Arrow Quivershaft|Arrow Quivershaft]] is also sure he's seen it eat an Avenger... he ordered two but only got one, even though it took the time, and cost the money, for two. He's tried to replicate this and hasn't been able to, however. So it clearly is at least a superficial display issue, and may be more than that ... possibly dependent on even something else. In any event, keep an eye on projects with more than 65k Engineer hours (and report back here!)... or just avoid going that high.

===Manufacturing Completion Time Display Bug===

If you start a new manufacturing project at 00:01, and the screen displays a completion time of 5 hours, you might expect the work to complete at 05:00 or 05:01. In fact it will complete at 06:00, one hour longer than indicated.

The reason for this bug is that the time left to complete a project is decremented by the game by one hour, every hour, on the hour(XX:00).

This display behaviour is consistent with what is shown while manufacturing is in progress. For example, if time remaining is shown as 0 hours, the work will complete at the beginning of the ''next'' hour. In effect, the displayed number is the integer-truncated form of the real time remaining. In the first example given above, the real time to completion is 5 hrs 59 min, misleadingly truncated to 5 hrs.

===Manufacturing Rate Interruption Loss===

In addition, as a result of integer truncation (see previous bug, Manufacturing Completion Time Display Bug), every time production stops, you lose an hour of manufacturing. Therefore, for most efficient production, manufacture in large batches (or increase batches while they are still in progress) to keep manufacturing as continuous as possible.

===Manufacturing Rate Limit===

There is a maximum production rate of one unit of any given type per hour per base. For example, though Alien Alloys / Aqua Plastics require 100 Engineer/Technician Hours per unit, even with 250 Engineers/Technicians you can only produce 1 unit per hour.

===Manufacturing Rate Limit Bug (TFTD)===

In UFO Enemy Unknown, the Manufacturing Rate Limit is just an irritant. The game prevents you from allocating more Engineers than is useful. In Terror From The Deep, there is no such safeguard. If you allocate more Technicians than are required to produce 1 unit per hour, the excess effort is just silently wasted. The unproductive Technicians are no doubt wasting their time playing retro computer games on their engineering workstations.

===HWP Fusion Bomb Ammo Cost Bug===

The HWP Fusion Bomb ammunition type, and its TFTD equivalent the ammunition for the SWS PWT/Displacer, appear to have the wrong manufacturing costs.
The vehicle version is ''less'' portable and ''less'' powerful than the personal version (Blaster Bomb), ''less'' capable than the craft version (Fusion Bomb) - and costs ''more'' than either of the others in total cash and in materials. In particular, it makes no sense that the small missiles on the HWP/SWS use up ''more'' of both Elerium/Zrbite and Alien Alloys/Aqua Plastics than the Craft version.

To correct this error, the craft round should have the higher base price, ''and'' the material requirements that are currently assigned to the SWS/HWP round. (It's debatable whether the SWS/HWP rounds should be more expensive than the man-carried rounds.) More discussion is on the talk page of this article.

== Other Bugs ==

=== Difficulty Bug ===
The DOS version had a problem where no matter what difficulty level you chose, you were actually playing at "Beginner" level. Because of one or two incorrectly set bytes in all dos versions of the game( 1.0 through to 1.4), no matter what difficulty was selected, the difficulty bug would reset to beginner at the end of the first mission. [[XcomUtil]] corrects this problem, as does the Collectors Edition Windows port (also commonly known as UFO Gold or CE).

[http://tvtropes.org/pmwiki/pmwiki.php/Main/X-COM This TVTropes] page has been known to state that due to the bug, players asked the developers to increase game difficulty. The rumour goes that a new bug was supposedly introduced as a result, where TFTD's difficulty would reset to Superhuman instead of Beginner. The facts of the matter are that, while the overall difficulty of the game ''was'' increased, TFTD does manage to correctly keep track of which specific mode you're supposed to be playing in.

=== Big Text Bug ===
There are a few bugs in XCOM, especially early versions, that can build up and make the game unstable enough that it crashes and prints out a screen full of green 40-column text, essentially debug or memory dump information useless to you.

You can also forced a crash by pressing CTRL-C at the start of a new game (DOS only). If you don't have any missions automatically saved within the [[Game_Files#Missdat_Files|MISSDAT]] folder, you will get this big text to appear. Typically it is green for Enemy Unknown, and blue for Terror From The Deep. Other colours have been observed such as pink, purple, brown and yellow.

In the dos version, the text that you see is simply a memory dump in mode-13h (the 320x200x256 colour screen resolution) and the text colour is based off the changes to the palette that the game made. The batch file coordinating the two main programs [[Geoscape]] and [[Battlescape]] often succeeds in soldiering on after a crash. In the Windows version of the game, the game simply crashes back to the desktop, unless you're using the [[XcomUtil]] split executable variant (which uses a batchfile).

Some things which will tend to cause this problem:
* Overzealous use of Psi

At least some of the instability crashes can be fixed by replacing the DOS/4GW dos extender with a later version from another DOS game.

[http://syndicate.lubie.org/synd/html/synd_patches.php One of these], for example. Link to Syndicate fansite, instructions included.

=== Cash Rollover Bug ===

When your cash balance goes over $2,147,483,647, it will rollover and become $-2,147,483,647. Which means your game is done for, unless you use an editor. Fortunately, by the time you accumulate this much cash, you have usually completed all necessary research to win the game.

=== UFOPaedia Craft Weapon Hit Probability Bug ===

There is a bug in the in-game UFOPaedia. It mistakenly reads the damage value field when reporting the hit chance for a craft weapon. Hence:

* Cannon shows 10% not 25%
* Avalanche shows 100% not 80%
* Laser Cannon shows 70% not 35%
* Plasma Beam shows 140% not 50%
* Fusion Ball shows 230% (!!!) not 100%

Possibly the reason this bug was missed during testing is that the first weapon in the data files, Stingray, actually does have Damage equal to its hit probability.

=== Losing My Favourite Game ===

There is a check whether the "Has X-com received a financial warning?" flag has been raised. If no, a warning is issued and the flag is raised. If yes, then the game ends, and the flag is lowered. HOWEVER, this flag is erronously not connected to any particular savegame, it is global across all savegames. This allows strange results when saving and loading games.

== See Also ==

=== [[Known Bugs (TFTD)]] ===
For bugs that '''only''' affect X-COM: Terror From The Deep.

[[Category: Oddities and bugs]]

Known Bugs

2010-09-12T10:59:55Z

Cfailde: /* Elerium-fueled Craft Bug */ it's -> its

== Game Destroying Bugs ==

These are the list of the worst bugs of them all, because they can render your entire game unplayable. Until a fix/ workaround is found, these bugs result in your entire X-com campaign being scuttled:
* [[Minimized interceptor bug]]
* [[Big text bug]]

== Base Construction Bugs ==

=== Base Disjoint Bug ===
Base facilities built along the right or bottom edges of the base building area may end up being cut off from each other by dirt walls, a bug in the routine meant to keep soldiers from accidentally exiting the map edges during [[Base Defense]] missions. The dirt walls can be knocked down by Blaster Bombs or excessive amount of heavy plasma fire during combat but are otherwise unbreakable.

[[image:bdb.gif|center|Base Disjoint Bug]]

The walls marked in white are removed if there is an adjacent module. All green modules are not affected while the yellow modules are. The red module will be sealed off completely if anything smaller than a hangar is placed here at any given time.

[[XcomUtil]] works around this problem by stripping out the walls entirely in all the base modules.

The bug can be profitable if the hangars and the lift are accessible only through in these areas - you can gather and supply all your soldiers heavily without aliens interfering, then knock a hole in the wall and cover the area with explosives and blaster launcher fire.

===Displayed Base Maintenance Costs===
Although X-COM charges the right monthly fees for base modules, the maintenance fee displayed ''in the base info screen'' is always wrong. The displayed number is actually based on the placement within the base grid, '''not''' the price displayed in the in-game UFOpaedia. However, at the end of the month, the right fee is deducted. For more information, see [[Base_Facilities#Displayed_Base_Maintenance_Cost_Bug]]. The Geo finance Graph shows a correct maintenance summary ([[LIGLOB.DAT]], updated once a month). Also see the next section.

===Paying For Dirt===
If you take down any facility in any base that you own and leave bare dirt, then you will continue to pay maintenance on it. But not at the old rate of whatever the facility cost per month, filling the hole back with dirt means it needs special attention at all times by specialists. In fact for every square of dirt you have that used to be a facility you will pay 80k per month. Thats 320k per hangar you take down. There are only two known ways to stop paying this premium - if you completely dismantle the base you stop paying any money for it, or if you build over all the spaces that you have vacated. In fact as soon as you start building the new facility you stop paying the premium, as well as not having to pay the cost of the new facility until it is complete.

If you start a facility and change your mind before it is complete, after the time when it would have completed you will start paying this 80k premium on that land as well.

===Base Facility Dismantle-Construction Crash===
In the Collectors Edition version, dismantling a facility while its construction is in progress can cause a crash when a second facility on another base square completes its construction. To work around this, dismantle a facility only after its construction is complete. If you have already dismantled such a facility, build something like a general stores on the same square to avoid the crash. It is not known if this crash happens intermittently or always, or if it happens on most versions of the game or just the Collectors Edition.

===Radar Stacking===
Despite the "Short Range" and "Long Range" detection bars displayed on each base's Information screen, only one radar of each type will be used at each base. Building additional radars of the same type will have no effect. One short and one long are useful until the [[Hyper-wave Decoder|Hyper-Wave Decoder]] makes both of them obsolete.

===Phantom Radar===
When you dismantle detection equipment such as a radar or hyperwave detector, the related detection ability of the base does not decrease until a new facility of some kind is built in that base. Until a new facility is completes building at that base, the base continues to use this "phantom radar".

This bug allows you to "upgrade in place", for example building a new Hyper-Wave Decoder over the top of an existing Large Radar, and retaining the detection capability of the Large Radar until the Hyper-Wave Decoder completes building. (Unless something else completes building first).

===Fixes for Base Construction Bugs===

As mentioned above, [[XcomUtil]] prevents the Base Disjoint bug (crudely). The [[User:Spike#Base_Fixer|BaseFixer]] utility corrects the Paying for Dirt, Phantom Radar, and Radar Stacking bugs. BaseFixer can be used manually on saved game files, or automatically via XcomUtil's hook mechanism.

==Geoscape Bugs==

===First Radar Detection Data bug===
When a UFO is detected by a radar, you get certain data on it depending on the type of radar that detected it. If the UFO later enters the range of another radar while staying in the range of the first, you will continue to get the initial data given, even if the new radar is more powerful than the first! So if you detect a craft with a [[Small Radar System]], then the UFO moves into the range of a [[Hyper-wave Decoder]], clicking on the UFO will only give you the data as if the Small Radar detected it, so long as it remains in the Small Radar range! In effect, the data you get about a UFO is determined when you first detect it, and not changed after that until you lose detection on the craft with the radar that first detected it.

This bug most commonly shows up when a UFO is first detected by a patrolling aircraft and then remains in the range of the aircraft while also entering the range of a Hyper-Wave Decoder.

=== Minimized Interceptor Bug ===
One fairly consistent cause of crashes is saving the geoscape game during a UFO standoff, with a [[UFO Interception]] window minimized to an icon. The next mission after that point will likely dump you to the green text screen, and perhaps an earlier battlescape mission instead of the proper one. What it seems to do is zoom back out of the combat too far when the fight is over, eventually causing the crash once it has gone a couple of steps further than it normally allows you.

'''Solution:''' Open up [[UIGLOB.DAT]] in a hex editor. Change hex offset 0x06 to 00. This will reset the number of minimized interceptor windows to zero. Your interceptor unit can be selected to either return to base or continue on to complete its ground assault mission. ''NOTE: Make sure to back up your save game before editing it.''

''-- I was able to recover from this state by quickly sending in another interceptor ([[Firestorm]]) to take over, which allowed my first interceptor ([[Avenger]]) to break off and go home without crashing the game again. After the shootdown I overwrote the buggy savegame. --[[User:JellyfishGreen|JellyfishGreen]] 03:11, 22 Aug 2005 (PDT)''

''This happened to me also. I fixed it by replacing "[[UIGLOB.DAT]]" in the save folder with the same file from another saved game (from the same campaign a month earlier) [[User:bylund|bylund]] 00:15, January 12, 2007 (GMT+01)''

=== Interceptions: Last Shot Always Misses ===
When using Cautious attack when [[UFO Interception|intercepting a UFO]], your craft will stay at the maximum range of your longest-range weapon. When using Standard attack, your craft will stay at the maximum range of your shortest-range weapon. (Usually players use two weapons of the same type, so Cautious and Standard attack will behave the same in this regard.)

As soon as the craft fires its last shot (expending all its ammo), it will drop back to "Standoff" range (70km). This will make it appear that the UFO has backed away while the last missile(s) are in-flight, causing them to miss.

In order to hit a UFO with your last salvo of missiles (Stingrays, Avalanches, or Fusion Balls), you must switch to "Aggressive" attack before the last salvo reaches the UFO. This will cause your craft to close in with the UFO, allowing the missiles to be in range when they reach the UFO. However, Aggressive attacks will also bring you within range of the UFO's weapons, so you should hit the "Disengage" button as soon as the last salvo hits.

===Elerium-fueled Craft Bug===
A [[Skyranger]] or [[Interceptor]], once dispatched, will return to base when its fuel supply has dropped to a level that it will only have just enough fuel to return to base. Craft fueled by Elerium-115, however, will always report the "Low Fuel" message as soon at the fuel supply is 50% depleted, no matter where they are on the globe. This significantly shortens the already minute time that a [[Firestorm]], [[Lightning]], or [[Avenger]] can be dispatched to patrol.

===Floater Medic Research Bug===
Every single time a Floater Medic is found and researched, the game crashes after it is interrogated! I [[muton commander]] used a hack system to view the alien's profile, and it was a Commander with no race attached. This is probably the cause, but I have no explaination for why this situation occurs.

== Battlescape Bugs ==

=== Faulty Large Units ===
If you move a tank off a northward facing ledge, the rest of the tank will sink into a wall (if there is one), and cause the tank to get stuck. This won't happen if the tank moves off a south facing ledge as the primary quarter will fall after the rest of the tank. Aliens can also get stuck this way.

Another, potentially annoying bug occurs when a large unit's graphics become messed up. During a base defense mission, a rocket tank may end up looking like 4 silacoids bunched together.

===Unconscious Units are items===
This is actually an intentional programming choice... but it leads to several consequences which are bugs.

Firstly, any unconscious unit can be killed instantly by even a weak explosion, like being nearby an exploding AC-HE shell... even a Muton with 125 Health or an X-com agent in Flying Armor whose high armor ratings normally make him immune to AC-HE damage.
Secondly, no experience is gained for killing enemies in this manner.

You can prevent an unconscious unit's death from an explosion by picking it up... if a blaster bomb strikes the carrier and kills him, the unconscious unit will safely fall to the floor, unharmed.

Unlike a conscious unit (not wearing x-com armor), an unconscious unit can laze about in the middle of a fire without taking damage, since a UNIT standing in fire takes damage, but an unconscious unit is an item, which all ignore fire.

Forcing an MCed alien to pick up an unconscious X-com agent and carry him in it's right hand can cause weird things to occur when you release the mind control. I think the game might crash when the alien tries to shove the agent into it's magic pocket.

If a non-flying unconscious unit wakes up while being carried by a flying unit, it will gain some sort of temporary hover ability. (I once placed an unconscious Chryssalid in my flying agent's backpack. A few turns later, some growls and screams were heard from overhead.)

Save space! Each conscious unit takes up 1 tile (4 tiles for large units). An unconscious unit does not use up the tile... this might conceivably be useful if you wanted to abort a mission, but several panicked units were preventing other agents from boarding the skyranger...
X-com agents refuse to ride piggyback or be picked up while conscious. So, if you want a non-flying unit to reach an 2nd floor place with no stairs or elevator, you will have to knock him out, then either throw him up, or have a flying unit pick him up and drop him... and presumably administer stimulant.

This also leads to the INVISIBLE UNIT glitch. Frequently happens during Base Defence missions, since the item table is usually maxed out. Basically, the item table is so full that killed units do not leave corpses. However, this also means that unconscious units do not turn into the Unconscious Unit item. The KOed unit will disappear from sight, but will still be visible as a red number and as a blue/yellow dot on overhead map. Since the unit is still a unit and not an item, you will be able to shoot it with projectile weapons and kill it. ALSO, this method enables you to raise any unit's stun bar all the way to 255, since you can still increase the stun meter, despite them already being unconscious.

===Funky Fire===
If a unit (alien or friendly) is on fire or standing in flames, an [[Incendiary]] explosion ''anywhere else on the map'' will do a small amount of damage to it, even if you just shoot an IC round at a random patch of ground.

Similarly, if a unit (friendly units only) is standing in smoke when an incendiary explodes, it will take stun damage. This makes the combination of incendiary munitions and smoke quite hazardous until such time as all troops are armored.

There is a [[Talk:Incendiary#Incendiary_Bug|working hypothesis]] for the cause of this bug, which is that each and every Incendiary explosion triggers "end of turn processing" for Smoke and Fire - including fire damage, stun damage from smoke, fire spreading checks, and possibly "catch on fire" checks for units in fire.

Note that X-Com units wearing any kind of armor are immune to fire damage and IC-induced stun damage. Xcom HWPs are immune to stun, but take 40% damage from Incendiaries and WILL get killed quite efficiently by funky fire.

=== Collectors Edition Blaster Bomb Bug ===
In the Collectors Edition of UFO, the [[Blaster Launcher]] has a bug that prevents it from going up or down on the same tile. Or in other words, you cannot change the elevation of the missile vertically on the same tile.

Instead of flying down (or up) to the next waypoint, it will instead fly directly to the south at the pivot waypoint. Relative to the screen, this would be the lower left side of the screen.

This does not happen if you plot the waypoints at an angle. Or, if the blaster bomb flies right off the map, it will reappear at the proper waypoint as long as there are additional waypoints placed after the vertical move.

This bug also applies to the [[Disruptor Pulse Launcher]] in TFTD.

===Blaster Launcher Dud Shells Bug===

Shots which have only one waypoint, or explode before reaching their first waypoint, leave the Blaster Launcher showing 0 rounds, but still containing a dud shell which must be unloaded before the launcher can be reloaded. On earlier versions of the game (pre-Win CE) this also happens with reaction fire, and with 1-waypoint shots that fly off the map.

=== The trouble with Mines in General ===

Proximity mines are strangely implemented in UFO and TFTD. While they behave as you would expect them to half of the time, the mines do not behave like conventional weapons.

First, experience attribution is awarded to the person that sets off the mine.

Secondly, the armed states for [[Proximity Grenade]]s in both UFO and TFTD are NOT stored in save games. If a proximity grenade is primed, then the game is saved and reloaded, the grenade will not only not go off as it should, but the "Prime Grenade" action will still be absent, so it's impossible to re-arm it.

=== Grenade Timer Behaviour ===

Primed grenades will not explode when it's in your inventory when the timer runs out. It will only detonate when it's on the ground. If your soldier falls unconscious or gets killed, the grenade will be counted as being on the ground. Then it will blow up, likely taking out your gear and body. This 'feature' allows for the hot potato or [[Grenade Relay]] strategy which is fairly unique to X-COM where a live grenade well past its use-by date can be passed from squad member to squad member. It could also be used against Chryssalids:
* Soldier is turned into a Zombie.
* Equipment is dropped to the ground.
* First grenade goes off, killing the Zombie (and the offending Chryssalid, if it's still around).
* Second grenade goes off, killing the newly hatched Chryssalid. (<i>Zaimoni: assuming the second grenade is <b>around</b> to explode. Reportedly works better in TFTD.</i>)

So when you enter an area with high risk of Chryssalid attacks (terror site or Terror ship/Battleship crash site), have every soldier arm a grenade which serves as a dead man's switch to eliminate Chryssalids. You lose a soldier or two, but the aliens don't gain anything and there's one less candidate for zombification (and, if you are lucky, one less Chryssalid if it was around the victim when the grenades exploded).

For a more a detailed explanation on detonation conditions, see [[Understanding Grenades]].

=== Mountain Map ===
Due to a bug in the way this tileset was created, when you shoot the ground, it doesn't burn up - it turns into a tree stump.

Because the stump is on object, as opposed to actual ground, any objects that were in the tile already (for example, UFO hulls or the landing gear of your craft) get replaced by these stumps, making it seem as if they were destroyed.

Tree stumps don't take much damage, so they often get burnt up immediately if an explosive goes off, leaving nothing but burnt ground behind. It is easier to view the effects of this bug by shooting the ground instead.

For more details, see [[Explosions#Mile-High_Madness|Mountain Madness]].

=== What just exploded? ===
In some versions of the game, a bug allows an armed proximity mine to transfer its properties to some other item in the next mission, which then may explode unexpectedly. (If the item is left on the floor of the XCOM craft, it will explode as you walk past it.) This problem can be rectified by reloading the game -- as a precaution, save before you move your first soldier.

=== Door jam ===
If a door is open when a game is saved on the Battlescape and that game is subsequently restored, the door will remain open for the remainder of that mission.

===Mind Controlled Soldiers go MIA===
If you complete a mission while a [[soldier]] is currently [[Mind Control]]led he will be listed as MIA at the end of the combat. This is quite an easy bug to fall into as on any [[Sectoid]] or [[Ethereal]] mission the only, or most powerful, psionic aliens will usually be holed up in the bridge or command centre.

===Mind Controlled Aliens Count as MIA if you Abort===
If you happen to abort a mission with any Mind-Controlled aliens under your control, who are NOT in the dropship, the computer tallies them up as "X-COM Operatives Missing In Action." Thus, every Mind Controlled alien left behind when you dust off is -20 points to your score! If you're leaving anyways, avoid this by bringing them back to the ship or mowing them down on the way back to the ship.

In the Playstation version of the game, any aliens under Mind Control at missions end are considered captured and hence, this bug is not a factor.

===20 Proximity Grenade Limit===

The array used to denote armed [[Proximity Grenade]]s is limited to 20 entries, meaning you are limited to 20 active mines at a time. The 21st and subsequent Proximity grenades can be primed like normal and will give appropriate messages, but they will not detonate even when the normal trigger conditions are met. Note that Proximity Mines that have detonated or otherwise been destroyed are removed from the array, freeing up positions; the limit is 20 ACTIVE Proximity Grenades at one time. In normal gameplay, this is probably not a restriction, in light of the [[Known_Bugs#80-Item_Limit|80 Item Limit]], since you'd need to have more than 1/4th of the cargo space in the dropship filled with Proximity Grenades.

===Base Defense Elerium bug===

On DOS versions of UFO Defense, Elerium pods may spawn as items from the base stockpile during a Base Defense bug. Each pod represents 50 units of Elerium and will be normally collected after the mission, same as any other item such as Heavy Lasers or Blaster Bombs. HOWEVER. The program will potentially generate 1 elerium POD for every 1 UNIT of elerium in your inventory. Thus, if you had only 10 lasers and 50 Elerium listed in your Sell screen, you would see 10 lasers and 50 Elerium Crystals in your Soldier Equip Screen, which would translate to 50 Elerium pods and 10 lasers scattered around your base. This equals 2500 Elerium, BTW. You basically have the potential to multiply your elerium stocks by 50 times.

===Berserk HWP crashes the game===

Admittedly, this is unlikely to arise under normal play. But, anyhow, your HWPs can only lose morale by killing friendly units. Not much for each unit killed, either. Anyhow, a berserk HWP will crash the game. (except for the Hovertank/Launcher, which does not fire when it goes berserk.)
Likewise, if you MC a cyberdisc or Sectopod and have it kills lots of aliens, it'll go berserk and crash the game. The error happens because of an oversight from the developers: the built-in weapons of HWP are handled differently from handed weapons, no OBDATA.DAT entries exist for them. The berserk code will try to access the nonexistent entry, resulting in a crash. The Celatid has yet to be tested.

===Limited Unit Slots - Battlescape Crash===

This tends to arise during Base Defence Missions. The game is was designed to be limited to 40 soldiers/hovertanks and XXXX aliens for a total of XXXX . Having a full complement of soldiers during a Superhuman difficulty base defence will max out these limits. Thus when either side starts playing around with mind control too much, something goes wrong causing the entire game to crash.
It might also be something to do with maximum items on the battlescape.
In any case, the workaround seems to be killing aliens and destroying items on the battlescape... doesn't always work, but it seems to help.
You might want to make several in-battle saves for these situations, even if you normally play Ironman mode.

== Character Inventory Bugs ==

=== Alien Inventory Stacking Bug ===

'''WARNING:''' When examining an Alien's inventory (via an Exploit), you will see that sometimes the alien will stack multiple items of equipment on the same slot - its right leg. It's not always obvious that there are multiple objects in the slot until you 'pick up' the first object and can see other objects still in the slot.
Before you remove an item from the Alien's right leg, make sure you have enough time units to place it somewhere else. If you run out of time units, you will likely have to force a quit and cannot save your game. It '''may''' be possible to move the item to the left leg slot for 0 TUs, '''if''' the item will fit in that slot. If not, you will have to terminate the game. (Press ALT-TAB to get to any other window, then CTRL-ALT-DEL to bring up Task Manager, and then terminate the process that corresponds to the game).

=== XComUtil Inventory Stacking Bug ===

A problem similar to the Alien Inventory Stacking Bug can also occur for X-COM Soldiers, when using XComUtil. The algorithm used to assign weapons in XComUtil MUST assign all weapons to troops, so if there are more weapons than soldiers, excess weapons are stacked onto the leg slot of the first soldier in the dropship. This was a deliberate choice by Scott Jones to make this encumbrance obvious to the player. This can be readily corrected in the "equip soldiers" screen before a mission. Else, see "Alien Inventory Bug", above.

=== Item-stacking Bug ===
It is possible to put more than one item in a given spot. When an item is stacked with a [[Stun Rod]], this can make it possible for X-COM soldiers to perform "melee" attacks. See [[Item Stacking Bug]] for more details.

===Carrying Unconscious Units===
If one of your soldiers is carrying an unconscious unit in their hands and the unit either wakes up from stun or dies, they will be removed from the Inventory display, but will still appear to be in the carrying soldier's hands in the Battlescape. Clicking on the phantom body in the Battlescape will crash the game!
This error can be easily cleared by switching to the Inventory screen and moving another item into the hand that used to be carrying the body. Even swapping the gun to the other hand will do. Refer to : [[Unconscious#Bug|Unconscious]].

===Disappearing Ammo===
Partially-used clips in alien or X-COM weapons disappear at the end of a mission. This dictates that you should try to use clips that are not full. However, in DOS versions of the game, you can unload used clips to recover them as full clips with the tradeoff of all loaded clips (used or otherwise) will count as spent and disappear (this shouldn't seem to be a problem, until you start using blasters and will find that you're running out of ammo fast). You can also use [[XcomUtil]] to recover partially used clips. Even when used clips are discarded, you will still get credit ([[Scoring|score]]) at the end of missions for recovering them.

When aborting a mission, any full clips loaded in any alien weapons brought back to the transport/access lift will not be recovered unless the clips are unloaded first. This includes [[Blaster Bomb]]s and [[Stun Bomb]]s.

===Weightless Loaded Ammo===

Ammo that is already loaded into a weapon at the start of a mission does not count towards a soldier's Encumbrance. If the weapon is subsequently unloaded and reloaded during the mission, the soldiers encumbrance will increase. This would only be noticed if the unloaded clip was not discarded (e.g. because it was not fully empty). This is due to a bug in the game's weight calculation routine that was uncovered (but not caused) by Seb76's inventory screen improvements.

=== Equip Phase Ammo Load Error ===

It looks like the game routine for placing ammo into weapons at the beginning of the equip phase does not correctly set all values. It should set the ammo as loaded into the weapon, the weapon as being held by the soldier, and the map position of the weapon and the ammo as the same as the soldier. Looks like it does not do one or more of these things. Whatever values the game doesn't set, do get set if you manually load or reload the weapon, either during the equip phase, or during the game.

Probably the only impact of this bug is that XComUtil can't detect the fact that the ammo is loaded into the weapon, for the purpose of AutoCombat. It might have other subtle effects on any utilities that deal with equipping soldiers. [[User:Spike|Spike]] 20:03, 11 March 2010 (EST)

Specifically, the game's auto-equip functions at the beginning of the equip phase fail to set offset 0x04 of the [[OBPOS.DAT]] record to point to the soldier who owns the ammo. These functions leave the value = 0xff, which implies "on the ground". They also leave the ammo location as being the equipment pile, rather than the location of the soldier. The other values are set correctly. Manually loading ammo into a weapon, during the equip phase or during combat, correctly sets all values. The ownership points to the soldier and the location to the soldier's location. [[User:Spike|Spike]] 20:03, 12 March 2010 (EST)

== Storage and Transfer Bugs ==

=== 80-item Limit ===
When loading up your Avenger for a massive UFO assault or arming soldiers for a [[Base Defense]] from your overflowing stores, you will likely hit this limit.

You only get a max of 80 items, and you don't get to choose which ones, so you may end up with 80 clips and no rifles for the base defense.

The solution is timely housekeeping. Sell off your spare personal equipment. See our handy [[Spring Cleaning Tips]], and also [[Managing the Item Limit]] for ideas.

Another bug concerning this limit happens when there are unresearched (alien) items in your stores during a base defense mission. Even though the item cannot be used during the mission, the game still allows you to equip your soldiers with them. This rarely happens as the alien items are very low on the item list, but if your base is lean and mean with under 80 items total, everything will spawn regardless of research.

===Sticky Craft Transfer Fee glitch===
As pointed out by [[User:Zombie|Zombie]] and [[User:Danial|Danial]], transferring any craft causes '''''all subsequent transfers to have that cost added to it''''', for as long as the craft is in transit. Additional craft in transit will add additional fees. (This has also been called the Exponential Transfer Fee bug, although it's actually additive, not exponential.)

Example (all numbers are only approximations):
<u>Cost of pistol transfer (↔ = to or from)</U>
EU ↔ USA 80
EU ↔ Asia 100
USA ↔ Asia 120

<u>Cost of craft transfer</U>
EU ↔ USA 1600 ''Notice how transfer fees always work as relative percents,
EU ↔ Asia 2000 ''probably on a distance-based formula
USA ↔ Asia 2400

<u>Cost to transfer '''pistol''', after transferring craft from EU to Asia for $2000</U>
EU ↔ USA 1680 (80+1600)
EU ↔ Asia 2100 (100+2000)
USA ↔ Asia 2520 (120+2400)

The cost of the craft transfer "sticks" to '''all''' subsequent transfers, until the craft arrives - although it acts on a proportionate basis, which is probably distance related.

Unfortunately, this cost is '''additive'''. That is to say, if you transferred a second craft from EU to Asia while the first was still in transit, it would cost $4000 ($2000 plus $2000 - it too suffers from the glitch!), it would then cost e.g. $4100 to transfer a pistol from EU to Asia. Having even more craft in transit would add even more fees.

This only appears to happen with aircraft, although it does happen for them all. So try to transfer aircraft individually, and not transfer anything else while you do - assuming you aren't awash in money. (The bug will cost you in the low thousands of dollars per craft being transferred.)

A related problem is that, if you are in the Transfer screen, start to transfer a craft, and then cancel because you remembered you wanted to send something else first - if you then try to Transfer something on that same screen, ''it will still get the sticky craft fee added''. Try it and see. You have to back up out to the main Base screen and hit Transfer again, to get rid of the sticky fee from a canceled craft transfer.

===Fuel dump on transfer===
Transferring a craft with 100% fuel will dump it somewhere along the way.
When it arrives at its destination, its fuel gauge will read empty (ie: 0% FUEL), but it will be listed as ready. If you launch your craft for a mission (any mission will do) its fuel gauge will still read empty.
<br>
This can be [[ExploitsA#Infinite_Fuel|exploited]], but it is very annoying if you want to quickly turn around a troop transport for another mission.
<br>
You can force a refuel by sending out the craft and immediately recalling it back to base.

===Transfer Limit cash eater===
Only 100 items can be in transit at a time. (Here, a transfer of e.g. 200 Elerium counts as one "item". Also, all soldiers are counted individually.) If you go over the limit, you will get a warning that there is no more transport capacity. If you STILL try to transport something after getting the warning, the item will stay where it is, but the transportation cost still gets deducted. Bad if you're shuffling expensive aircraft. The extra cost isn't that bad. Recovering just one alien weapon will likely cover the money you will lose to this bug over the course of a game.

{| {{stdTable}} width = "80%" align = "center"
|- {{stdTable Heading}}
| Tip
|-
| To Clarify what constitutes an item in the transfer screen, think of them as batches of X amount. For example, if you transfer 200 alien alloys now, and then decide to transfer another 50 alloys later, this will count as two items in transit. Now, when you look at your transfers, you'll now have two items. Two batches of alien alloys, one with 200 units and the other with 50 units.
|}

=== Transfer crash ===
If you transfer something to another base the game crashes right after acknowledging the transfer price.

Solution: Start UFO, select English language, finish your transfer, save game, restart with your normal language settings (http://www.xcomufo.com/x1faq.html)

===Purchase Limit===
The purchase limit for any item you buy via the purchase screen is 255 per line item, because it is a one-byte field. However, the impact of this bug is small, for if you have space remaining in your 100-item transfer queue, you can immediately order another 255 of said item as another line item.

===Storage Limit===
You can not store more than 9,999 of any one item in the general stores at a specific base at one time. However, this will likely only happen with [[Alien Alloys]] or [[Elerium-115]].
Still, consider yourself warned. If you're coming close to the limit, consider transferring the extra to other bases or even selling it, as any extra collected beyond the limit will 'disappear' and be wasted.

===Exceeding Storage Limits===

The storage capacity of a base is normally limited by the capacity of the General Stores. However this can be exceeded in a number of ways:

* By exploiting some of the Base Storage Anomalies (see below)
* By storing surplus equipment in transport aircraft (up to the 80 item limit). Note that if both the aircraft and the base are full, you can no longer move equipment between the aircraft and base (in either direction).
* Anything manufactured at the base will be stored there regardless of the base's General Stores capacity.
* Anything captured on a mission by an aircraft operating from the base will be stored at the base, regardless of the base's General Stores capacity.

These could perhaps be considered minor exploits.

===Base Storage Anomalies===

There are some quirks in how the game calculates, and displays, base storage capacity used and available. These quirks are not all consistent with each other, which leads to some strange behaviour. A typical example would be moving a set of items out of Stores, immediately trying to put the exact same set of items back into Stores, and this failing due to "insufficient space". A more detailed discussion is in [[Talk:Base Stores#Base Stores Anomalies]].

== Soldier Limits and Recruiting Bugs ==

=== Soldier Recruiting Limit ===

There is a hard limit in the game of 250 X-COM soldiers in total across all bases (not 250 per base).

The error message that pops up when you try to hire more is:

"NO MORE SOLDIERS ALLOWED"

"You have already recruited the maximum number of soldiers."

=== Soldier Recruiting Bugs ===

Also there are 3 bugs related to recruiting soldiers:

* You still get charged for Soldiers you try to purchase above the No More Soldiers limit.
* The error message that appears when you hire too many soldiers must be dismissed (click OK) once for each soldier over the limit, i.e. up to 255 times.
* You get also charged for Soldiers you try to purchase above the Transfer Limit (100 at a time).

=== Soldier Battlescape Limit ===

In the Battlescape, there is a limit of 40 X-COM soldiers that can participate in any battle. Tanks/HWPs each count as 4 soldiers against this limit. Unless you use custom-modified aircraft, you will only see this limit in a Base Defence mission. In a Base Defence mission, all tanks/HWPs will be deployed first, in preference to soldiers.

== Manufacturing and Research Bugs ==

=== Cancel Manufacturing Bug ===

If you start a project with 1 or more items to build, the required cash (and any materials) for the first item will instantly be taken from you. If you cancel the project before the job is done, or reduce the number of items to produce, you will still not be refunded the initial costs of the first item.

(Possibly this is exactly the behaviour the designers intended, and not a bug at all.)

=== Zero Unit Manufacturing Exploit ===

If you start a manufacturing project with zero items to build, close the screen, and then go back to assign staff and a non-zero build amount later, the first item is built for free. If you only build one item at a time, you can build them all for free. Obviously, this is cheating. It's also a bit tedious. It might be excusable if you're really short of money.

=== Research Rollover ===

Whenever research completes, you are given the opportunity to re-allocate your scientists' efforts onto a new topic. If the new topic is after the topic that you have just completed (further down toward the bottom of the screen), the new effort of the scientists you allocate is applied immediately, on the same day - even though they were just working on the previous project that completed.

If you have enough scientists available to complete the new project in one day, this process can be repeated indefinitely, to complete multiple topics in one day. Each new research topic must be further down the list than the previous research topic, or the bug/exploit does not work.

By the way, this means that you should not worry about "wasted" research effort due to allocating too many scientists to a project on its last day. The chances are you will gain more free research from this bug than you will lose from "wasted" research effort.

=== TFTD Research Tree Bug Avoidance Guide ===
TFTD's research problems are more of a logical design flaw than a true bug, caused by trying to make the research tree more complicated than X-Com UFO.
They can be a pain when you research the wrong thing at the wrong time.

A variation of NKF's [[TRTBAG | TFTD Research Tree Bug Avoidance Guide]] will be forthcoming - free time permitting.

For now:

*ONLY research Deep One Terrorist AFTER you have completed Plastic Aqua Armor and Ion Beam Accelerators.
*You MUST have at least one "Sub Construction" in storage before completing research on Zrbite and/or Transmission Resolver.
*NEVER research the Tasoth Commander. There's no reason to - and as of the last patch, they should no longer appear on the research list. They can block the T'Leth research.
*DO NOT research M.C. Lab unless you have AT LEAST one MC Reader in storage.
*NEVER sell all of your Sonic Pistol Clips before researching it first. If you were to research the Sonic Pistol, the aliens immediately stop using that weapon (and thus, clip) so you will be unable to continue in the Sonic line of research.
Any of the above (other than the MC reader) would make it impossible to finish the game.

=== Overcrowded Engineers And Scientists ===
In the Dos version (probably the others as well) if you hire more than 255 engineers in a single base, the number of engineers in the base will read a negative number once the 257th engineer arrives. Any Engineers engaged in projects will continue to work on them, but if you cancel the project you will lose engineers until you have lost 255 of them.
This bug also affects scientists. It may be exploitable to pay a negative salary at the end of the month.

If you hire exactly 256 scientists or engineers, the total rolls over to zero. You pay zero salaries, and the resulting free Manufacturing / Research is limited only by the capacity of your Factories / Laboratories. Also works in TFTD.
<br>
NOTE: you need to make sure that not all of their projects finish at the same time.
Otherwise, you would be stuck with 0 'available' workers/scientists, i.e. unable to assign them to a new project.

===Manufacturing Limit Bug===
The number of hours remaining on a [[Manufacturing_Profitability#Profit_tables|manufacturing project]] is stored in a two-byte integer. If you build enough items that the total number of Engineer Hours required for construction is above 65535 hours, it will wrap around to 0 hours and display from there. Typically this drastically understates the amount of time that will be spent working on the items, but strictly speaking, it only subtracts 65k hours (so a huge project like 120k hours would still show ~55k hours' worth of Engineer time needed).

This bug is not dependent on the number of engineers assigned to the project; it is a function of the number of engineer hours needed. You will most likely run into it when trying to build 2 Avengers at the same time or when queuing up large orders of items in bulk, such as armor or Laser Cannons. As a practical example, the number of Avengers needed to trigger the bug is 2. The number of Laser Cannons is 219. Toggle back and forth between 218 and 219 laser cannons at the beginning of a project to see the effects.

It is known with certainty that this exists as a display issue - the screen will say you need less time than you should when you go over 65536 Engineer hours. [[User:Arrow Quivershaft|Arrow Quivershaft]] is also sure he's seen it eat an Avenger... he ordered two but only got one, even though it took the time, and cost the money, for two. He's tried to replicate this and hasn't been able to, however. So it clearly is at least a superficial display issue, and may be more than that ... possibly dependent on even something else. In any event, keep an eye on projects with more than 65k Engineer hours (and report back here!)... or just avoid going that high.

===Manufacturing Completion Time Display Bug===

If you start a new manufacturing project at 00:01, and the screen displays a completion time of 5 hours, you might expect the work to complete at 05:00 or 05:01. In fact it will complete at 06:00, one hour longer than indicated.

The reason for this bug is that the time left to complete a project is decremented by the game by one hour, every hour, on the hour(XX:00).

This display behaviour is consistent with what is shown while manufacturing is in progress. For example, if time remaining is shown as 0 hours, the work will complete at the beginning of the ''next'' hour. In effect, the displayed number is the integer-truncated form of the real time remaining. In the first example given above, the real time to completion is 5 hrs 59 min, misleadingly truncated to 5 hrs.

===Manufacturing Rate Interruption Loss===

In addition, as a result of integer truncation (see previous bug, Manufacturing Completion Time Display Bug), every time production stops, you lose an hour of manufacturing. Therefore, for most efficient production, manufacture in large batches (or increase batches while they are still in progress) to keep manufacturing as continuous as possible.

===Manufacturing Rate Limit===

There is a maximum production rate of one unit of any given type per hour per base. For example, though Alien Alloys / Aqua Plastics require 100 Engineer/Technician Hours per unit, even with 250 Engineers/Technicians you can only produce 1 unit per hour.

===Manufacturing Rate Limit Bug (TFTD)===

In UFO Enemy Unknown, the Manufacturing Rate Limit is just an irritant. The game prevents you from allocating more Engineers than is useful. In Terror From The Deep, there is no such safeguard. If you allocate more Technicians than are required to produce 1 unit per hour, the excess effort is just silently wasted. The unproductive Technicians are no doubt wasting their time playing retro computer games on their engineering workstations.

===HWP Fusion Bomb Ammo Cost Bug===

The HWP Fusion Bomb ammunition type, and its TFTD equivalent the ammunition for the SWS PWT/Displacer, appear to have the wrong manufacturing costs.
The vehicle version is ''less'' portable and ''less'' powerful than the personal version (Blaster Bomb), ''less'' capable than the craft version (Fusion Bomb) - and costs ''more'' than either of the others in total cash and in materials. In particular, it makes no sense that the small missiles on the HWP/SWS use up ''more'' of both Elerium/Zrbite and Alien Alloys/Aqua Plastics than the Craft version.

To correct this error, the craft round should have the higher base price, ''and'' the material requirements that are currently assigned to the SWS/HWP round. (It's debatable whether the SWS/HWP rounds should be more expensive than the man-carried rounds.) More discussion is on the talk page of this article.

== Other Bugs ==

=== Difficulty Bug ===
The DOS version had a problem where no matter what difficulty level you chose, you were actually playing at "Beginner" level. Because of one or two incorrectly set bytes in all dos versions of the game( 1.0 through to 1.4), no matter what difficulty was selected, the difficulty bug would reset to beginner at the end of the first mission. [[XcomUtil]] corrects this problem, as does the Collectors Edition Windows port (also commonly known as UFO Gold or CE).

[http://tvtropes.org/pmwiki/pmwiki.php/Main/X-COM This TVTropes] page has been known to state that due to the bug, players asked the developers to increase game difficulty. The rumour goes that a new bug was supposedly introduced as a result, where TFTD's difficulty would reset to Superhuman instead of Beginner. The facts of the matter are that, while the overall difficulty of the game ''was'' increased, TFTD does manage to correctly keep track of which specific mode you're supposed to be playing in.

=== Big Text Bug ===
There are a few bugs in XCOM, especially early versions, that can build up and make the game unstable enough that it crashes and prints out a screen full of green 40-column text, essentially debug or memory dump information useless to you.

You can also forced a crash by pressing CTRL-C at the start of a new game (DOS only). If you don't have any missions automatically saved within the [[Game_Files#Missdat_Files|MISSDAT]] folder, you will get this big text to appear. Typically it is green for Enemy Unknown, and blue for Terror From The Deep. Other colours have been observed such as pink, purple, brown and yellow.

In the dos version, the text that you see is simply a memory dump in mode-13h (the 320x200x256 colour screen resolution) and the text colour is based off the changes to the palette that the game made. The batch file coordinating the two main programs [[Geoscape]] and [[Battlescape]] often succeeds in soldiering on after a crash. In the Windows version of the game, the game simply crashes back to the desktop, unless you're using the [[XcomUtil]] split executable variant (which uses a batchfile).

Some things which will tend to cause this problem:
* Overzealous use of Psi

At least some of the instability crashes can be fixed by replacing the DOS/4GW dos extender with a later version from another DOS game.

[http://syndicate.lubie.org/synd/html/synd_patches.php One of these], for example. Link to Syndicate fansite, instructions included.

=== Cash Rollover Bug ===

When your cash balance goes over $2,147,483,647, it will rollover and become $-2,147,483,647. Which means your game is done for, unless you use an editor. Fortunately, by the time you accumulate this much cash, you have usually completed all necessary research to win the game.

=== UFOPaedia Craft Weapon Hit Probability Bug ===

There is a bug in the in-game UFOPaedia. It mistakenly reads the damage value field when reporting the hit chance for a craft weapon. Hence:

* Cannon shows 10% not 25%
* Avalanche shows 100% not 80%
* Laser Cannon shows 70% not 35%
* Plasma Beam shows 140% not 50%
* Fusion Ball shows 230% (!!!) not 100%

Possibly the reason this bug was missed during testing is that the first weapon in the data files, Stingray, actually does have Damage equal to its hit probability.

=== Losing My Favourite Game ===

There is a check whether the "Has X-com received a financial warning?" flag has been raised. If no, a warning is issued and the flag is raised. If yes, then the game ends, and the flag is lowered. HOWEVER, this flag is erronously not connected to any particular savegame, it is global across all savegames. This allows strange results when saving and loading games.

== See Also ==

=== [[Known Bugs (TFTD)]] ===
For bugs that '''only''' affect X-COM: Terror From The Deep.

[[Category: Oddities and bugs]]