UFOpaedia - User contributions [en]

Compiling with Microsoft Visual C++ (OpenXcom)

2015-05-29T10:18:02Z

RaTcHeT302:

==Setting up==

# Download [https://windows.github.com/ GitHub for Windows].
# Download the source code from [https://github.com/SupSuper/OpenXcom here], by pushing '''Clone in Desktop'''.
# Download and install [http://store.steampowered.com/app/7760/ X-COM: UFO Defense].
# Navigate to '''<path-to-game>\XCOM\''' and copy the following folders.
<pre>
GEODATA
GEOGRAPH
ROUTES
MAPS
SOUND
TERRAIN
UFOGRAPH
UFOINTRO
UNITS
</pre>
5. Navigate to '''<path-to-repo>\OpenXcom\bin\UFO''' and paste the folders in there.

==Compiling (x32 Release)==
# Download and install Visual Studio. A free version is available [http://www.visualstudio.com/en-us/products/visual-studio-express-vs.aspx here].
# Download the following dependencies for the appropiate version of Visual Studio.
* [http://openxcom.org/download/dev/openxcom-deps-win-vc2010.zip Visual C++ 2010]
* [http://openxcom.org/download/dev/openxcom-deps-win-vc2013.zip Visual C++ 2013]
3. Extract the archive's contents to '''<path-to-repo>\OpenXcom\'''
 
4. Navigate to '''<path-to-repo>\OpenXcom\src''' and open '''OpenXcom.2010.sln'''.
 
5. Compile the project by right clicking on '''OpenXcom''' and selecting '''Build'''. Upgrading the project may be needed on newer versions of Visual Studio.
 
6. Navigate to '''<path-to-repo>\OpenXcom\bin''' then copy all the '''DLLs''' from '''<path-to-repo>\OpenXcom\bin\Win32''' to '''<path-to-repo>\OpenXcom\bin\Win32\Release'''
 
7. Move the '''common''', '''UFO''' and '''standard''' folders from '''<path-to-repo>\OpenXcom\bin''' to '''<path-to-repo>\OpenXcom\bin\Win32\Release'''

* Certain anti-viruses such as Avast may stop the project from building. Add the OpenXcom folder as an expection.
* See the [http://msdn.microsoft.com/library/dd831853.aspx Visual Studio Documentation] for more information on the IDE.

==Issues fixed==
===Failed To Load Palette===
Copy the X-Com resources to your '''bin''' folder, see [[Installing (OpenXcom)|Installing]] for more details.

===afxres.h not found===
Remove '''resource.h''' and '''OpenXcom.rc''' from the project.

===MSVCR100.DLL not found===
Install these [http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=5555 files].

===Platform 'x64' cannot be found===
Compile as Win32.

[[Category:OpenXcom]]

Compiling with Microsoft Visual C++ (OpenXcom)

2015-05-29T10:15:30Z

RaTcHeT302:

===Setting up===
# Download [https://windows.github.com/ GitHub for Windows].
# Download the source code from [https://github.com/SupSuper/OpenXcom here], by pushing '''Clone in Desktop'''.
# Download and install [http://store.steampowered.com/app/7760/ X-COM: UFO Defense].
# Navigate to '''<path-to-game>\XCOM\''' and copy the following folders.
<pre>
GEODATA
GEOGRAPH
ROUTES
MAPS
SOUND
TERRAIN
UFOGRAPH
UFOINTRO
UNITS
</pre>
5. Navigate to '''<path-to-repo>\OpenXcom\bin\UFO''' and paste the folders in there.

===Compiling (x32 Release)===
# Download and install Visual Studio. A free version is available [http://www.visualstudio.com/en-us/products/visual-studio-express-vs.aspx here].
# Download the following dependencies for the appropiate version of Visual Studio.
* [http://openxcom.org/download/dev/openxcom-deps-win-vc2010.zip Visual C++ 2010]
* [http://openxcom.org/download/dev/openxcom-deps-win-vc2013.zip Visual C++ 2013]
3. Extract the archive's contents to '''<path-to-repo>\OpenXcom\'''
 
4. Navigate to '''<path-to-repo>\OpenXcom\src''' and open '''OpenXcom.2010.sln'''.
 
5. Compile the project by right clicking on '''OpenXcom''' and selecting '''Build'''. Upgrading the project may be needed on newer versions of Visual Studio.
 
6. Navigate to '''<path-to-repo>\OpenXcom\bin''' then copy all the '''DLLs''' from '''<path-to-repo>\OpenXcom\bin\Win32''' to '''<path-to-repo>\OpenXcom\bin\Win32\Release'''
 
7. Move the '''common''', '''UFO''' and '''standard''' folders to '''<path-to-repo>\OpenXcom\bin\Win32\Release'''

* Certain anti-viruses such as Avast may stop the project from building. Add the OpenXcom folder as an expection.
* See the [http://msdn.microsoft.com/library/dd831853.aspx Visual Studio Documentation] for more information on the IDE.

==Issues fixed==
===Failed To Load Palette===
Copy the X-Com resources to your '''bin''' folder, see [[Installing (OpenXcom)|Installing]] for more details.

===afxres.h not found===
Remove '''resource.h''' and '''OpenXcom.rc''' from the project.

===MSVCR100.DLL not found===
Install these [http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=5555 files].

===Platform 'x64' cannot be found===
Compile as Win32.

[[Category:OpenXcom]]

Compiling with Microsoft Visual C++ (OpenXcom)

2015-05-28T16:47:48Z

RaTcHeT302: /* Issues fixed */

===Setting up===
# Download [https://windows.github.com/ GitHub for Windows].
# Download the source code from [https://github.com/SupSuper/OpenXcom here], by pushing '''Clone in Desktop'''.
# Download and install [http://store.steampowered.com/app/7760/ X-COM: UFO Defense].
# Navigate to '''<path-to-game>\XCOM\''' and copy the following folders.
<pre>
GEODATA
GEOGRAPH
ROUTES
MAPS
SOUND
TERRAIN
UFOGRAPH
UFOINTRO
UNITS
</pre>
5. Navigate to '''<path-to-repo>\OpenXcom\bin\UFO''' and paste the folders in there.

===Compiling===
# Download and install Visual Studio. A free version is available [http://www.visualstudio.com/en-us/products/visual-studio-express-vs.aspx here].
# Download the following dependencies for the appropiate version of Visual Studio.
* [http://openxcom.org/download/dev/openxcom-deps-win-vc2010.zip Visual C++ 2010]
* [http://openxcom.org/download/dev/openxcom-deps-win-vc2013.zip Visual C++ 2013]
3. Extract the archive's contents to '''<path-to-repo>\OpenXcom\'''
 
4. Navigate to '''<path-to-repo>\OpenXcom\src''' and open '''OpenXcom.2010.sln'''.

 
5. Compile and run the project by pressing the '''Start Debugging''' button with a green arrow on the top toolbar.
 
6. Navigate to '''<path-to-repo>\OpenXcom\bin''', depending on which platform the game was built, either open the '''Win32''' or '''x64''' folder.
 
7. Copy all the '''DLLs''' from either the '''Win32''' or '''x64''' folder to '''<path-to-repo>\OpenXcom\bin'''
 
8. Navigate to '''<path-to-repo>\OpenXcom\bin''', open the desired platform folder, open the '''Release''' or '''Debug''' folder and copy '''OpenXcom.exe''' to '''<path-to-repo>\OpenXcom\bin'''

* Certain anti-viruses such as Avast may stop the project from building. Add the OpenXcom folder as an expection.
* See the [http://msdn.microsoft.com/library/dd831853.aspx Visual Studio Documentation] for more information on the IDE.

==Issues fixed==
===Failed To Load Palette===
Copy the X-Com resources to your '''bin''' folder, see [[Installing (OpenXcom)|Installing]] for more details.

===afxres.h not found===
Remove '''resource.h''' and '''OpenXcom.rc''' from the project.

===MSVCR100.DLL not found===
Install these [http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=5555 files].

===Platform 'x64' cannot be found===
Compile as Win32.

[[Category:OpenXcom]]

Compiling with Microsoft Visual C++ (OpenXcom)

2015-05-28T16:43:10Z

RaTcHeT302: /* Compiling */

===Setting up===
# Download [https://windows.github.com/ GitHub for Windows].
# Download the source code from [https://github.com/SupSuper/OpenXcom here], by pushing '''Clone in Desktop'''.
# Download and install [http://store.steampowered.com/app/7760/ X-COM: UFO Defense].
# Navigate to '''<path-to-game>\XCOM\''' and copy the following folders.
<pre>
GEODATA
GEOGRAPH
ROUTES
MAPS
SOUND
TERRAIN
UFOGRAPH
UFOINTRO
UNITS
</pre>
5. Navigate to '''<path-to-repo>\OpenXcom\bin\UFO''' and paste the folders in there.

===Compiling===
# Download and install Visual Studio. A free version is available [http://www.visualstudio.com/en-us/products/visual-studio-express-vs.aspx here].
# Download the following dependencies for the appropiate version of Visual Studio.
* [http://openxcom.org/download/dev/openxcom-deps-win-vc2010.zip Visual C++ 2010]
* [http://openxcom.org/download/dev/openxcom-deps-win-vc2013.zip Visual C++ 2013]
3. Extract the archive's contents to '''<path-to-repo>\OpenXcom\'''
 
4. Navigate to '''<path-to-repo>\OpenXcom\src''' and open '''OpenXcom.2010.sln'''.

 
5. Compile and run the project by pressing the '''Start Debugging''' button with a green arrow on the top toolbar.
 
6. Navigate to '''<path-to-repo>\OpenXcom\bin''', depending on which platform the game was built, either open the '''Win32''' or '''x64''' folder.
 
7. Copy all the '''DLLs''' from either the '''Win32''' or '''x64''' folder to '''<path-to-repo>\OpenXcom\bin'''
 
8. Navigate to '''<path-to-repo>\OpenXcom\bin''', open the desired platform folder, open the '''Release''' or '''Debug''' folder and copy '''OpenXcom.exe''' to '''<path-to-repo>\OpenXcom\bin'''

* Certain anti-viruses such as Avast may stop the project from building. Add the OpenXcom folder as an expection.
* See the [http://msdn.microsoft.com/library/dd831853.aspx Visual Studio Documentation] for more information on the IDE.

==Issues fixed==
===Failed To Load Palette===
Copy the X-Com resources to your '''bin''' folder, see [[Installing (OpenXcom)|Installing]] for more details.

===afxres.h not found===
Remove '''resource.h''' and '''OpenXcom.rc''' from the project.

===MSVCR100.DLL not found===
A: You're using the pre-built dependencies with an old Visual C++ version so you need to install the [http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=5555 VC++ 2010 Redist].

===Platform 'x64' cannot be found===
Compile as Win32.

[[Category:OpenXcom]]

Compiling with Microsoft Visual C++ (OpenXcom)

2015-05-28T16:32:58Z

RaTcHeT302:

===Setting up===
# Download [https://windows.github.com/ GitHub for Windows].
# Download the source code from [https://github.com/SupSuper/OpenXcom here], by pushing '''Clone in Desktop'''.
# Download and install [http://store.steampowered.com/app/7760/ X-COM: UFO Defense].
# Navigate to '''<path-to-game>\XCOM\''' and copy the following folders.
<pre>
GEODATA
GEOGRAPH
ROUTES
MAPS
SOUND
TERRAIN
UFOGRAPH
UFOINTRO
UNITS
</pre>
5. Navigate to '''<path-to-repo>\OpenXcom\bin\UFO''' and paste the folders in there.

===Compiling===
# Download and install Visual Studio. A free version is available [http://www.visualstudio.com/en-us/products/visual-studio-express-vs.aspx here].
# Download the following dependencies for the appropiate version of Visual Studio.
* [http://openxcom.org/download/dev/openxcom-deps-win-vc2010.zip Visual C++ 2010]
* [http://openxcom.org/download/dev/openxcom-deps-win-vc2013.zip Visual C++ 2013]
3. Extract the files to '''<path-to-repo>\OpenXcom\'''
 
4. Navigate to '''<path-to-repo>\OpenXcom\src''' and open '''OpenXcom.2010.sln'''.

 
5. Compile and run the project by pressing the '''Start Debugging''' button with a green arrow on the top toolbar.
 
6. Navigate to '''<path-to-repo>\OpenXcom\bin''', depending on which platform the game was built, either open the '''Win32''' or '''x64''' folder.
 
7. Copy all the '''DLLs''' from either the '''Win32''' or '''x64''' folder to '''<path-to-repo>\OpenXcom\bin'''
 
8. Navigate to '''<path-to-repo>\OpenXcom\bin''', open the desired platform folder, open the '''Release''' or '''Debug''' folder and copy '''OpenXcom.exe''' to '''<path-to-repo>\OpenXcom\bin'''

* Certain anti-viruses such as Avast may stop the project from building. Add the OpenXcom folder as an expection.
* See the [http://msdn.microsoft.com/library/dd831853.aspx Visual Studio Documentation] for more information on the IDE.

==Issues fixed==
===Failed To Load Palette===
Copy the X-Com resources to your '''bin''' folder, see [[Installing (OpenXcom)|Installing]] for more details.

===afxres.h not found===
Remove '''resource.h''' and '''OpenXcom.rc''' from the project.

===MSVCR100.DLL not found===
A: You're using the pre-built dependencies with an old Visual C++ version so you need to install the [http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=5555 VC++ 2010 Redist].

===Platform 'x64' cannot be found===
Compile as Win32.

[[Category:OpenXcom]]

Compiling with Microsoft Visual C++ (OpenXcom)

2015-05-28T16:30:47Z

RaTcHeT302: This looks really ugly, but I hope it makes things easier.

===Setting up===
# Download [https://windows.github.com/ GitHub for Windows].
# Download the source code from [https://github.com/SupSuper/OpenXcom here], by pushing '''Clone in Desktop'''.
# Download and install [http://store.steampowered.com/app/7760/ X-COM: UFO Defense].
# Navigate to '''<path-to-game>\XCOM\''' and copy the following folders.
<pre>
GEODATA
GEOGRAPH
ROUTES
MAPS
SOUND
TERRAIN
UFOGRAPH
UFOINTRO
UNITS
</pre>
5. Navigate to '''<path-to-repo>\OpenXcom\bin\UFO''' and paste the folders in there.

===Compiling===
# Download and install Visual Studio. A free version is available [http://www.visualstudio.com/en-us/products/visual-studio-express-vs.aspx here].
# Download the following dependencies for the appropiate version of Visual Studio.
* [http://openxcom.org/download/dev/openxcom-deps-win-vc2010.zip Visual C++ 2010]
* [http://openxcom.org/download/dev/openxcom-deps-win-vc2013.zip Visual C++ 2013]
3. Extract the files to '''<path-to-repo>\OpenXcom\'''
4. Navigate to '''<path-to-repo>\OpenXcom\src''' and open '''OpenXcom.2010.sln'''.

5. Compile and run the project by pressing the '''Start Debugging''' button with a green arrow on the top toolbar.
6. Navigate to '''<path-to-repo>\OpenXcom\bin''', depending on which platform the game was built, either open the '''Win32''' or '''x64''' folder.
7. Copy all the '''DLLs''' from either the '''Win32''' or '''x64''' folder to '''<path-to-repo>\OpenXcom\bin'''
8. Navigate to '''<path-to-repo>\OpenXcom\bin''', open the desired platform folder, open the '''Release''' or '''Debug''' folder and copy '''OpenXcom.exe''' to '''<path-to-repo>\OpenXcom\bin'''

* Certain anti-viruses such as Avast may stop the project from building. Add the OpenXcom folder as an expection.
* See the [http://msdn.microsoft.com/library/dd831853.aspx Visual Studio Documentation] for more information on the IDE.

==Issues fixed==
===Failed To Load Palette===
Copy the X-Com resources to your '''bin''' folder, see [[Installing (OpenXcom)|Installing]] for more details.

===afxres.h not found===
Remove '''resource.h''' and '''OpenXcom.rc''' from the project.

===MSVCR100.DLL not found===
A: You're using the pre-built dependencies with an old Visual C++ version so you need to install the [http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=5555 VC++ 2010 Redist].

===Platform 'x64' cannot be found===
Compile as Win32.

[[Category:OpenXcom]]

Compiling with Microsoft Visual C++ (OpenXcom)

2015-05-28T16:15:35Z

RaTcHeT302:

===Setting up===
# Download [https://windows.github.com/ GitHub for Windows].
# Download the source code from [https://github.com/SupSuper/OpenXcom here], by pushing '''Clone in Desktop'''.

===Compiling===
# Download and install Visual Studio. A free version is available [http://www.visualstudio.com/en-us/products/visual-studio-express-vs.aspx here].
# Download the following dependencies for the appropiate version of Visual Studio.
* [http://openxcom.org/download/dev/openxcom-deps-win-vc2010.zip Visual C++ 2010]
* [http://openxcom.org/download/dev/openxcom-deps-win-vc2013.zip Visual C++ 2013]
# Extract the files to '''<path-to-repo>\OpenXcom\'''
# Navigate to '''<path-to-repo>\OpenXcom\src''' and open '''OpenXcom.2010.sln'''.

# Compile and run the project by pressing the '''Start Debugging''' button with a green arrow on the top toolbar.

* Certain anti-viruses such as Avast may stop the project from building. Add the OpenXcom folder as an expection.
* See the [http://msdn.microsoft.com/library/dd831853.aspx Visual Studio Documentation] for more information on the IDE.

==Issues fixed==
===Failed To Load Palette===
Copy the X-Com resources to your '''bin''' folder, see [[Installing (OpenXcom)|Installing]] for more details.

===afxres.h not found===
Remove '''resource.h''' and '''OpenXcom.rc''' from the project.

===MSVCR100.DLL not found===
A: You're using the pre-built dependencies with an old Visual C++ version so you need to install the [http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=5555 VC++ 2010 Redist].

===Platform 'x64' cannot be found===
Compile as Win32.

[[Category:OpenXcom]]

Compiling with Microsoft Visual C++ (OpenXcom)

2015-05-28T15:52:37Z

RaTcHeT302: Microsoft Visual Studio is only on Windows, duh.

===Setting up===
# Download [https://windows.github.com/ GitHub for Windows].
# Download the source code from [https://github.com/SupSuper/OpenXcom here], by pushing '''Clone in Desktop'''.

===Compiling===
# Download and install Visual Studio. A free version is available [http://www.visualstudio.com/en-us/products/visual-studio-express-vs.aspx here].
# Download the following dependencies for the appropiate version of Visual Studio.
* [http://openxcom.org/download/dev/openxcom-deps-win-vc2010.zip Visual C++ 2010]
* [http://openxcom.org/download/dev/openxcom-deps-win-vc2013.zip Visual C++ 2013]
# Extract the files to '''<path-to-repo>\OpenXcom\'''
# Navigate to '''<path-to-repo>\OpenXcom\src''' and open '''OpenXcom.2010.sln'''.

# Compile and run the project by pressing the '''Start Debugging''' button with a green arrow on the top toolbar.

* Certain anti-viruses such as Avast may stop the project from building. Add the OpenXcom folder as an expection.
* See the [http://msdn.microsoft.com/library/dd831853.aspx Visual Studio Documentation] for more information on the IDE.

== FAQ ==

'''Q: I get a Failed To Load Palette error.''' 
A: Copy the X-Com resources to your '''bin''' folder, see [[Installing (OpenXcom)|Installing]] for more details.

'''Q: I get an error about afxres.h not being found.''' 
A: You're using a Visual C++ Express Edition which doesn't support Resource files, just remove '''resource.h''' and '''OpenXcom.rc''' from the project.

'''Q: I get an error about MSVCR100.DLL not being found.''' 
A: You're using the pre-built dependencies with an old Visual C++ version so you need to install the [http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=5555 VC++ 2010 Redist].

'''Q: I get a warning about Platform 'x64' cannot be found.''' 
A: You're using a Visual C++ Express Edition which doesn't support x64 builds, but you can still compile for Win32.

[[Category:OpenXcom]]

Compiling with Microsoft Visual C++ (OpenXcom)

2015-05-28T15:32:57Z

RaTcHeT302:

==Windows==
===Setting up===
# Download [https://windows.github.com/ GitHub for Windows].
# Download the source code from [https://github.com/SupSuper/OpenXcom here], by pushing '''Clone in Desktop'''.

===Compiling===
# Download and install Visual Studio. A free version is available [http://www.visualstudio.com/en-us/products/visual-studio-express-vs.aspx here].
# Download the following dependencies for the appropiate version of Visual Studio.
* [http://openxcom.org/download/dev/openxcom-deps-win-vc2010.zip Visual C++ 2010]
* [http://openxcom.org/download/dev/openxcom-deps-win-vc2013.zip Visual C++ 2013]
# Extract the files to '''<path-to-repo>\OpenXcom\'''
# Navigate to '''<path-to-repo>\OpenXcom\src''' and open '''OpenXcom.2010.sln'''.

# Compile and run the project by pressing the '''Start Debugging''' button with a green arrow on the top toolbar.

* Certain anti-viruses such as Avast may stop the project from building. Add the OpenXcom folder as an expection.
* See the [http://msdn.microsoft.com/library/dd831853.aspx Visual Studio Documentation] for more information on the IDE.

== FAQ ==

'''Q: I get a Failed To Load Palette error.''' 
A: Copy the X-Com resources to your '''bin''' folder, see [[Installing (OpenXcom)|Installing]] for more details.

'''Q: I get an error about afxres.h not being found.''' 
A: You're using a Visual C++ Express Edition which doesn't support Resource files, just remove '''resource.h''' and '''OpenXcom.rc''' from the project.

'''Q: I get an error about MSVCR100.DLL not being found.''' 
A: You're using the pre-built dependencies with an old Visual C++ version so you need to install the [http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=5555 VC++ 2010 Redist].

'''Q: I get a warning about Platform 'x64' cannot be found.''' 
A: You're using a Visual C++ Express Edition which doesn't support x64 builds, but you can still compile for Win32.

[[Category:OpenXcom]]

Installing (OpenXcom)

2015-05-27T17:42:11Z

RaTcHeT302: This wiki could use some fixboxes, similar to PCGamingWiki. This documentation seems a bit messy, everything could be shorter and a bit more to the point.

'''OpenXcom requires a vanilla version of the original [[X-COM]] resources.''' This can be any one of:

* 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")

Make sure your copy has the [http://openxcom.org/index.php/downloads-extras/ latest patch]. '''Do not''' use modded versions (eg. [[XcomUtil]]) as they may cause bugs and crashes.

== Instructions ==

In the instructions below, we refer to three different folders a lot: the "data" folder, the "user" folder, and the "config" folder. See [https://github.com/SupSuper/OpenXcom#directory-locations here] for directory definitions and where they are located on your operating system.

=== All platforms ===

Copy the original resources (specifically the GEODATA, GEOGRAPH, MAPS, ROUTES, SOUND, TERRAIN, UFOGRAPH, UFOINTRO, and UNITS subfolders) to OpenXcom's [https://github.com/SupSuper/OpenXcom#directory-locations Data folder] for version 1.0 or to the UFO folder in the [https://github.com/SupSuper/OpenXcom#directory-locations User folder] for the nightly. If using the nightly, you can alternately/additionally copy in Terror From the Deep files to the TFTD folder in your User folder to prepare for when the TFTD OpenXcom ruleset is released. '''Do not''' just drag/copy your whole X-COM folder into the Data folder, it won't work. For version 1.0 it should end up like this:

* data
** '''GEODATA'''
** '''GEOGRAPH'''
** Language
** '''MAPS'''
** Resources
** '''ROUTES'''
** Ruleset
** Shaders
** SoldierName
** '''SOUND'''
** '''TERRAIN'''
** '''UFOGRAPH'''
** '''UFOINTRO'''
** '''UNITS'''

and for the nightly it should look like this:

* '''UFO'''
** '''GEODATA'''
** '''GEOGRAPH'''
** '''MAPS'''
** '''ROUTES'''
** Shaders
** '''SOUND'''
** '''TERRAIN'''
** '''UFOGRAPH'''
** '''UFOINTRO'''
** '''UNITS'''

If you do this incorrectly, you'll get an error about "X not found". For more specific instructions, check your platform below.

==== Video tutorial ====

A video tutorial that covers the installation of milestone version 1.0 [http://www.youtube.com/watch?v=rNneKAwvjoU is available here] (courtesy of [http://www.youtube.com/channel/UCHymw9FSZqharCpMW-WiiHg Ivan Dogovich]). Though recorded for the Windows platform, check it out if you have doubts about a particular step during the installation.

A video tutorial for installing the nightly [http://www.youtube.com/watch?v=tusc0G5xxns is available here]. It also demonstrates how to install [http://www.openxcom.com/mod/final-mod-pack The Final Modpack] (a popular mod).

=== Windows ===

The installer will automatically detect Steam installations, patch the game and copy the original data for you, just follow the instructions.

=== Mac OS X ===

Copy the resources to the application's '''data''' resource (right click the application > Show Package Contents > Contents > Resources > data) for version 1.0 or the UFO and/or TFTD resources for the nightly.

=== 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://code.google.com/p/yaml-cpp/ yaml-cpp] (libyaml-cpp), version 0.5.1 (0.5.2 an later has issues)

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

Copy game resources to the appropriate [https://github.com/SupSuper/OpenXcom#linux folder locations].

=== Portable ===

To make a portable version of OpenXcom, just put all the files in the game folder, with a '''data''' (1.0) or '''UFO''' (nightly) subfolder for the resources and a '''user''' subfolder for your saves and settings (you may need to delete your old User Folder so the game doesn't use it instead).

== 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 [https://github.com/SupSuper/OpenXcom#directory-locations User Folder]. Make sure you installed everything correctly as instructed, and if you still experience problems, check the [http://openxcom.org/forum/ forums].

[[Category:OpenXcom]]