Installing (OpenXcom)

2013-05-17T14:11:57Z

KTOTwHL8CQ1jJldT: Fixed path to support folder

'''OpenXcom requires a vanilla version of the original [[X-COM]] resources.''' This includes:

* DOS Version 1.4: You can check if you have the correct version if it contains a "SOUND\GM.CAT" file.
* Windows Version / Collector's Edition.
* Steam Version: You can find the game folder in "Steam\steamapps\common\xcom ufo defense\XCOM".

'''Do not''' use modded versions (eg. [[XcomUtil]]) as they may cause bugs and crashes.

Just copy the game subfolders (GEODATA, GEOGRAPH, MAPS, ROUTES, SOUND, TERRAIN, UFOGRAPH, UFOINTRO, UNITS) to OpenXcom's Data folder (usually the "data" subfolder).

== Windows ==

The installer will automatically detect Steam installations and take care of the resource copying for you, just follow the instructions.

If installing manually, copy the resources to the '''data''' subfolder.

== Mac OS X ==

Copy the resources to the application's '''data''' resource (right click the application > Show Package Contents > Contents > Resources > data).

== Unix-like ==

OpenXcom requires the following libraries:

* [http://www.libsdl.org/ SDL] (libsdl1.2)
* [http://www.libsdl.org/projects/SDL_mixer/ SDL_mixer] (libsdl-mixer1.2)
* [http://www.ferzkopp.net/joomla/content/view/19/14/ SDL_gfx] (libsdl-gfx1.2), version 2.0.22 or later
* [http://www.libsdl.org/projects/SDL_image/ SDL_image] (libsdl-image1.2)
* [http://timidity.sourceforge.net/ TiMidity++] (timidity), if you need MIDI playback
* [http://code.google.com/p/yaml-cpp/ yaml-cpp] (libyaml-cpp0.3), version 0.3.0 or older

Check your distribution's package manager or the library website on how to install them.

If installing through a package manager, you should copy the resources to '''/usr/share/openxcom/data''', otherwise the '''data''' subfolder is preferred.

== Data Folder ==

In most cases the OpenXcom data is in the '''data''' subfolder, but it will also look in one of the following paths.

You can also specify your own path by passing the command-line argument "-data <data path>". The X-COM and OpenXcom data can be in different folders.

* <game directory>\data

=== Windows ===
* C:\Documents and Settings\<user>\My Documents\OpenXcom\data
* C:\Users\<user>\Documents\OpenXcom\data

=== Mac OS X ===
* <application resources>\data (Mac OS X)
* ~/Library/Application Support/OpenXcom/data (Mac OS X)

=== Unix-like ===
* $XDG_DATA_HOME/openxcom/data (Linux)
* $XDG_DATA_DIRS/openxcom/data (Linux)

== User Folder ==
OpenXcom automatically creates a User folder with all the screenshots, savegames and options in one of the following paths.

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

* <game directory>\user\

=== Windows ===
* C:\Documents and Settings\<user>\My Documents\OpenXcom
* C:\Users\<user>\Documents\OpenXcom

=== Mac OS X ===
* ~/Library/Application Support/OpenXcom

=== Unix-like ===
* $XDG_DATA_HOME/openxcom (usually ~/.local/share/openxcom/data/)
* $XDG_CONFIG_HOME/openxcom (usually /usr/share/openxcom/data/:/usr/local/share/openxcom/data/)

== Log file ==

In case you experience any problems or errors during the initial game loading/startup, these will be shown and logged in ''openxcom.log'' in the User Folder. Make sure you installed everything correctly as instructed, and if you still experience problems, check the [http://openxcom.org/forum/ forums].

== Portable Installations ==

To make a portable version of OpenXcom, just put all the files in the same folder, with a '''data''' subfolder for the resources and a '''user''' subfolder for your saves and settings.

[[Category:OpenXcom]]

UFOpaedia - User contributions [en]

Installing (OpenXcom)